Re: Editorial comments on draft-4646bis-12
Addison Phillips <addison <at> yahoo-inc.com>
2008-03-16 01:52:27 GMT
Editor hat on; responses follow.
>
>
> Section 2, introduction:
>
> The space after the comma in the passage "primary for human
> communication,such as" has been deleted. Please add it back.
Done.
>
>
> Section 2.1, 2nd paragraph:
>
> The last sentence mentions "the subtag registry" before it has actually
> been defined or described anywhere. I suggest adding a reference to
> Section 3, or at the very least making the reference a bit more formal:
>
> "Thus, a parser need not have an up-to-date copy (or any copy at all) of
> the IANA Language Subtag Registry to perform most searching and matching
> operations."
Done, although I edited the sentence somewhat in order to address this
issue. It now reads:
--
Thus, a parser need not have a list of valid tags or subtags (such as a
copy of some version of the IANA Language Subtag Registry) in order to
perform common searching and matching operations.
--
I admit to some pain removing the pithy "or any copy at all".
>
>
> Section 2.2.4:
>
> This section should have all remaining references to "ISO 3166" changed
> to "ISO 3166-1", in keeping with the recent change made in the ABNF.
> For example, the passages in Section 2.2.4, item 3 about "ISO 3166
> alpha-2 codes" could be misinterpreted or deliberately twisted to refer
> to ISO 3166-2 alpha-2 code elements such as "OR". I would actually
> recommend searching the entire document for "ISO 3166" and changing each
> instance to "ISO 3166-1" unless the result would be simply wrong.
Done. I did a search-and-replace. Note that a few instances of naked
"ISO 3166" remain. These are all references to ISO 3166 as a standards
body or in general. When in doubt, I made it ISO 3166-1.
>
>
> Section 3.1.6, 2nd paragraph from the end:
>
> This section continues to state: "The field 'Preferred-Value' MUST NOT
> be modified once created in the registry." While AFAIK there was no
> declared consensus to change this, I was quite sure there was popular
> support for making this field mutable, so that users of the Registry
> would not have to follow a sequence of P-V's, say from "i-hak" to
> "zh-hakka" to "hak". I had been delaying the release of
> draft-4645bis-05 in anticipation of this change, but seeing none, I will
> go ahead and release the draft with the same P-V's as before. (Q: Why a
> new draft-4645bis? A: Because the ISO 639-3 code lists have changed.)
(editor hat off) I think a declaration from the chairs on this item is
in order. I thought it was at or near consensus myself.
(retrieves editor's hat)
>
>
> Section 4.2, 3rd paragraph, just before bullet points:
>
> Change spelling of "very" to "vary".
Done.
>
>
> Section 8, 29th bullet point (6th from the end):
>
> The reference to RFC 4324 looks erroneous, and probably should be RFC
> 5234.
It's a typo. Fixed. Also: replaced with an <xref> so that it'll stay fixed.
>
>
> Section 9 generally:
>
> I was surprised to see RFC 4645, which pertained to RFC 4646, listed as
> a normative reference while draft-4645bis, which pertains to the present
> draft, is only listed as informative. I think this is because Section
> 2.2.4, item 3 (E) makes reference to RFC 4645, and that item has not
> been changed since it appeared in RFC 4646.
Actually, this is deliberate and probably NOT an error. RFC 4645 did, in
fact, define the list in question. There is a reference to the document
in normative language in Section 2.2.4, item 3, subitem E.
All references to 4645bis (aka "registry-update") are informative in
that the document plays no role in any of the normative language of
4646bis. I suppose a case could be made that instructions to IANA on
where to get the updated registry would be normative, though.
Incidentally, RFC 4645 was an *informative* reference to RFC 4646. It
was promoted because normative language was added in this version
requiring a look at the list in 4645 in that one very special case.
>
>
> Section 9.1, 17th item (2nd from the end):
>
> Change spelling of "Freitag" to "Freytag". If Asmus were on the list, I
> would leave it up to him to correct the spelling or form of his name,
> but I don't think he is.
Done.
>
>
> Section 9.2, 9th item (5th from the end):
>
> Change month "12" to "December". Perhaps surprisingly, the rfc2xml tool
> doesn't automatically substitute month names when a numeric month and no
> day are given. Perhaps one day...
Done.
--
--
Addison Phillips
Globalization Architect -- Yahoo! Inc.
Chair -- W3C Internationalization Core WG
Internationalization is an architecture.
It is not a feature.