Gentoo Archives: gentoo-dev

From: Ulrich Mueller <ulm@g.o>
To: "Michał Górny" <mgorny@g.o>
Cc: gentoo-dev@l.g.o
Subject: Re: [gentoo-dev] [PATCH 4/4] glep-0074: Specify newline convention
Date: Thu, 08 Sep 2022 09:47:18
Message-Id: w6gsfl2urj9.fsf@kph.uni-mainz.de
In Reply to: [gentoo-dev] [PATCH 4/4] glep-0074: Specify newline convention by "Michał Górny"
1 >>>>> On Thu, 08 Sep 2022, Michał Górny wrote:
2
3 > -The Manifest files use UTF-8 encoding.
4 > +The Manifest files use UTF-8 encoding. Line feed (``U+000A``) character
5 > +is used to separate lines. For best compatibility, empty lines and any
6 > +additional whitespace, including the carriage return character
7 > +(``U+000D``) should be ignored by the implementation.
8
9 Either "Line feed (``U+000A``) is used ..." or "The line feed
10 (``U+000A``) character is used ..."
11
12 > +Newline convention
13 > +------------------
14
15 Please insert a blank line here.
16
17 > +Prior to version 1.2, the specification did not indicate the encoding
18 > +to be used for newlines. Since the format is primarily used on Gentoo
19 > +Linux systems, this has been changed to follow the Unix convention
20 > +of using the line feed character. However, for best interoperability
21 > +implementation should be prepared to treat superfluous carriage return
22
23 s/implementation/the implementation/
24
25 > +characters as whitespace and ignore them.
26
27 Also I notice that you use double space after full stop in the first
28 paragraph above but a single space in the second paragraph. This should
29 be consistent throughout the GLEP.