Gentoo Archives: gentoo-dev

From: "Michał Górny" <mgorny@g.o>
To: gentoo-dev@l.g.o
Cc: "Michał Górny" <mgorny@g.o>
Subject: [gentoo-dev] [PATCH 4/4] glep-0074: Specify newline convention
Date: Thu, 08 Sep 2022 08:34:28
Message-Id: 20220908083303.4793-5-mgorny@gentoo.org
In Reply to: [gentoo-dev] [PATCH 0/4] glep-0074: Clarifications by "Michał Górny"
1 Signed-off-by: Michał Górny <mgorny@g.o>
2 ---
3 glep-0074.rst | 17 +++++++++++++++--
4 1 file changed, 15 insertions(+), 2 deletions(-)
5
6 diff --git a/glep-0074.rst b/glep-0074.rst
7 index ff8002f..a65a7e7 100644
8 --- a/glep-0074.rst
9 +++ b/glep-0074.rst
10 @@ -6,7 +6,7 @@ Author: Michał Górny <mgorny@g.o>,
11 Ulrich Müller <ulm@g.o>
12 Type: Standards Track
13 Status: Final
14 -Version: 1.1
15 +Version: 1.2
16 Created: 2017-10-21
17 Last-Modified: 2022-09-08
18 Post-History: 2017-10-26, 2017-11-16, 2018-02-08, 2022-09-08
19 @@ -79,7 +79,10 @@ are relative to the directory containing the Manifest file. The paths
20 must not reference the parent directory (``..``). Forward slash (``/``)
21 is used as path component separator.
22
23 -The Manifest files use UTF-8 encoding.
24 +The Manifest files use UTF-8 encoding. Line feed (``U+000A``) character
25 +is used to separate lines. For best compatibility, empty lines and any
26 +additional whitespace, including the carriage return character
27 +(``U+000D``) should be ignored by the implementation.
28
29
30 Manifest file locations and nesting
31 @@ -516,6 +519,16 @@ information to perform the verification following all the rules specific
32 to the Gentoo repository.
33
34
35 +Newline convention
36 +------------------
37 +Prior to version 1.2, the specification did not indicate the encoding
38 +to be used for newlines. Since the format is primarily used on Gentoo
39 +Linux systems, this has been changed to follow the Unix convention
40 +of using the line feed character. However, for best interoperability
41 +implementation should be prepared to treat superfluous carriage return
42 +characters as whitespace and ignore them.
43 +
44 +
45 Tree design
46 -----------
47
48 --
49 2.37.3

Replies