Gentoo Archives: gentoo-project

From: "Michał Górny" <mgorny@g.o>
To: gentoo-project@l.g.o
Cc: "Michał Górny" <mgorny@g.o>
Subject: [gentoo-project] [PATCH 03/18] glep-0001: Restore most of old GLEP headers
Date: Thu, 14 Sep 2017 19:03:52
Message-Id: 20170914190326.12168-4-mgorny@gentoo.org
In Reply to: [gentoo-project] [RFC] GLEP 1/2 updates for the new old-school GLEP workflow by "Michał Górny"
1 Remove most of the headers that were lost while migrating the GLEPs
2 to Wiki, with the exception of Discussions-To that seems to have
3 no value for the GLEP workflow. Some of the headers will be subject
4 to refactoring the commits following.
5 ---
6 glep-0001.txt | 21 ++++++++++++++++++---
7 1 file changed, 18 insertions(+), 3 deletions(-)
8
9 diff --git a/glep-0001.txt b/glep-0001.txt
10 index 257fd02..75bed31 100644
11 --- a/glep-0001.txt
12 +++ b/glep-0001.txt
13 @@ -228,13 +228,19 @@ header preamble. The headers must appear in the following order. Headers
14 marked with "*" are optional. All other headers are required. ::
15
16 GLEP: <glep number>
17 + Version: <cvs version string>
18 + Last-Modified: <cvs date string>
19 Title: <glep title>
20 Author: <list of authors' real names and optionally, email addrs>
21 Status: <Draft | Active | Accepted | Deferred | Rejected |
22 Final | Replaced>
23 Type: <Informational | Standards Track>
24 + * Content-Type: <text/x-rst>
25 + Created: <date created on, in dd-mmm-yyyy format>
26 + Post-History: <dates of postings to mailing lists>
27 * Requires: <glep numbers>
28 * Replaces: <glep number>
29 + * Replaced-By: <glep number>
30
31 The Author header lists the names, and optionally the email addresses
32 of all the authors/owners of the GLEP. Anybody who submits changes to
33 @@ -255,12 +261,21 @@ following RFC 2822 continuation line conventions.
34 The Type header specifies the type of GLEP: Informational or Standards
35 Track.
36
37 +The format of a GLEP is specified with a Content-Type header, which
38 +must be "text/x-rst" for ReStructuredText GLEPs (see GLEP 2 [#GLEP2]_).
39 +
40 +The Created header records the date that the GLEP was assigned a number, while
41 +Post-History is used to record the dates of when new versions of the GLEP are
42 +posted to gentoo-dev. Both headers should be in dd-mmm-yyyy format, e.g.
43 +14-Aug-2001.
44 +
45 GLEPs may have a Requires header, indicating the GLEP numbers that this GLEP
46 depends on.
47
48 -A GLEP may have a Replaces header, which indicates that this GLEP supersedes
49 -a previous one. This header should contain the number of the GLEP that this
50 -one renders obsolete.
51 +GLEPs may also have a Replaced-By header indicating that a GLEP has been
52 +rendered obsolete by a later document; the value is the number of the GLEP
53 +that replaces the current document. The newer GLEP must have a Replaces
54 +header containing the number of the GLEP that it rendered obsolete.
55
56
57 Reporting GLEP Bugs, or Submitting GLEP Updates
58 --
59 2.14.1

Replies