1 |
Ciaran McCreesh posted <20051101015125.1cc45eb4@××××××××.home>, excerpted |
2 |
below, on Tue, 01 Nov 2005 01:51:25 +0000: |
3 |
|
4 |
> ``Version:`` |
5 |
> Initially 1. Incremented every time a non-trivial change is made. |
6 |
> Changes which require a re-read of the news item should instead use a |
7 |
> new news item file. |
8 |
|
9 |
Very good work! |
10 |
|
11 |
This "Version" field calls to mind the MIMEVersion spec, and the ebuild |
12 |
version proposal, only here it's apparently used for news-item version. |
13 |
|
14 |
I'd suggest we preemptively incorporate an ENewsVersion or similar field |
15 |
as well, to be 1.0, with this proposal, but should the format ever need |
16 |
changed, that would allow for a format version 1.1 or 2.0 or whatever. As |
17 |
the GLEP suggests that future GLEPs may add new headers, this would allow |
18 |
them to update this version field as necessary, presumably using the |
19 |
familiar minor version = backward compatible, major version if not |
20 |
backward compatible, versioning scheme. |
21 |
|
22 |
You are very good at laying everything out in a just so spec, so I'll |
23 |
leave it to you to provide specific wording. =8^) |
24 |
|
25 |
One other niggle. The encoding is specified as UTF-8, but then the format |
26 |
is specified as RFC-822 (7-bit ASCII, pre-i18n) compatible. I'm not up |
27 |
on i18n specs, but presumably there's a newer RFC that specifies how |
28 |
internationalized internet messages are handled in an RFC-822 backward |
29 |
compatible way? If so, it may make more sense to reference that specific |
30 |
RFC, which presumably deals with UTF-8 instead of specifying 7-bit ASCII |
31 |
as does 822. Alternatively, MIME/Quoted-printable could be specified, |
32 |
which would allow for escaped 8-bit chars, as I'd /assume/ UTF-8 |
33 |
requires, given the -8. (I /said/ I'm not up on that!) |
34 |
|
35 |
-- |
36 |
Duncan - List replies preferred. No HTML msgs. |
37 |
"Every nonfree program has a lord, a master -- |
38 |
and if you use the program, he is your master." Richard Stallman in |
39 |
http://www.linuxdevcenter.com/pub/a/linux/2004/12/22/rms_interview.html |
40 |
|
41 |
|
42 |
-- |
43 |
gentoo-dev@g.o mailing list |