summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMichał Górny <mgorny@gentoo.org>2022-09-08 10:29:30 +0200
committerMichał Górny <mgorny@gentoo.org>2022-09-08 13:14:35 +0200
commit75a16a8fdc2600dd22e456a29202a3e8fad4ad6f (patch)
treeed3fa886e212aa7f396a72c99663ea6cd473aa09
parentglep-0074: Inline Manifest format description (diff)
downloadglep-75a16a8fdc2600dd22e456a29202a3e8fad4ad6f.tar.gz
glep-75a16a8fdc2600dd22e456a29202a3e8fad4ad6f.tar.bz2
glep-75a16a8fdc2600dd22e456a29202a3e8fad4ad6f.zip
glep-0074: Specify newline convention
Signed-off-by: Michał Górny <mgorny@gentoo.org>
-rw-r--r--glep-0074.rst18
1 files changed, 16 insertions, 2 deletions
diff --git a/glep-0074.rst b/glep-0074.rst
index 677bf35..182a871 100644
--- a/glep-0074.rst
+++ b/glep-0074.rst
@@ -6,7 +6,7 @@ Author: Michał Górny <mgorny@gentoo.org>,
Ulrich Müller <ulm@gentoo.org>
Type: Standards Track
Status: Final
-Version: 1.1
+Version: 1.2
Created: 2017-10-21
Last-Modified: 2022-09-08
Post-History: 2017-10-26, 2017-11-16, 2018-02-08, 2022-09-08
@@ -79,7 +79,10 @@ are relative to the directory containing the Manifest file. The paths
must not reference the parent directory (``..``). Forward slash (``/``)
is used as path component separator.
-The Manifest files use UTF-8 encoding.
+The Manifest files use UTF-8 encoding. Line feed (``U+000A``) is used
+to separate lines. For best compatibility, empty lines and any
+additional whitespace, including the carriage return character
+(``U+000D``) should be ignored by the implementation.
Manifest file locations and nesting
@@ -516,6 +519,17 @@ information to perform the verification following all the rules specific
to the Gentoo repository.
+Newline convention
+------------------
+
+Prior to version 1.2, the specification did not indicate the encoding
+to be used for newlines. Since the format is primarily used on Gentoo
+Linux systems, this has been changed to follow the Unix convention
+of using the line feed character. However, for best interoperability
+the implementation should be prepared to treat superfluous carriage
+return characters as whitespace and ignore them.
+
+
Tree design
-----------