W3C home > Mailing lists > Public > public-html-bugzilla@w3.org > March 2011

[Bug 12246] New: Say 'the/a BOM character' througout - there isn't different 'BOMs' (plural)

From: <bugzilla@jessica.w3.org>
Date: Sat, 05 Mar 2011 04:53:05 +0000
To: public-html-bugzilla@w3.org
Message-ID: <bug-12246-2486@http.www.w3.org/Bugs/Public/>

           Summary: Say 'the/a BOM character' througout - there isn't
                    different 'BOMs' (plural)
           Product: HTML WG
           Version: unspecified
          Platform: All
               URL: http://dev.w3.org/html5/spec/parsing#determining-the-c
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: HTML5 spec (editor: Ian Hickson)
        AssignedTo: ian@hixie.ch
        ReportedBy: xn--mlform-iua@xn--mlform-iua.no
         QAContact: public-html-bugzilla@w3.org
                CC: mike@w3.org, public-html-wg-issue-tracking@w3.org,

' Determining the character encoding'  and '4.3.1 The script element'
both says:

]] This step looks for Unicode Byte Order Marks (BOMs). [[

Nearly every other place where the BOM is referred to, the spec says "a Byte
Order Mark character".  
(E.g. http://dev.w3.org/html5/spec/offline#writing-cache-manifests  ]]a U+FEFF
BYTE ORDER MARK (BOM) character[[

Please use the same/similar expression here. Also, it is misleadiong to use the
plural form, because although it can be encoded in at least 3 ways,  there is
only one Byte Order Mark character.  

Hence, please change the above quote into roughly this:

    ]] This step looks for the Unicode Byte Order Mark (BOM) character. [[

Likewise, the ' Character encodings' section currently reads:

]] When a user agent is to use the UTF-16 encoding but no BOM has been found,
user agents must default to UTF-16LE. [[

Again 'no BOM' is not as clear as if you said 'but the BOM has not been found". 

Likewise in Specifying the document's character encoding, it says:

]] If an HTML document does not start with a BOM, [[

Please say "a BOM character" or (as I would prefer) "the BOM character".

Configure bugmail: http://www.w3.org/Bugs/Public/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA contact for the bug.
Received on Saturday, 5 March 2011 04:53:07 UTC

This archive was generated by hypermail 2.3.1 : Wednesday, 7 January 2015 16:31:06 UTC