changeset 170:0f34be604716

Version and encoding metadata now file "/version/" and "/encoding/" as leftmost field
author Franz Glasner <hg@dom66.de>
date Fri, 31 Aug 2018 21:56:29 +0200
parents 7b76125fe80c
children cdf1c345ed2c
files extensions/timestamps.py
diffstat 1 files changed, 6 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/extensions/timestamps.py	Fri Aug 31 19:35:24 2018 +0200
+++ b/extensions/timestamps.py	Fri Aug 31 21:56:29 2018 +0200
@@ -34,9 +34,13 @@
 
       lines starting with: ``#`` to CR and/or LF
 
-  * first non-comment line: :version: VERSION
+  * first non-comment line: /version/ VERSION
 
-  * optional second non-comment line: :encoding: ENCODING
+    .. note:: Files with leading slashes are not allowed -- they would be
+              absolute files. So this syntax does not conflict with some
+              very exotic path names.
+
+  * optional second non-comment line: /encoding/ ENCODING
 
   * timestamp in ISOFORMAT (``YYYY-MM-DDTHH:MM:SS.mmmmmm+HH:MM``)