Is it OK to put comments before the XML declaration in an XML file?
<!-- Is this bad to do? --> <?xml version="1.0" encoding="utf-8"?> <someElement />
Syntax. A comment starts with <! -- and ends with -->. You can add textual notes as comments between the characters.
Rules for adding XML commentsDon't use a comment before an XML declaration. You can use a comment anywhere in XML document except within attribute value. Don't nest a comment inside the other comment.
Allows notes and other human readable comments to be included within an XML file. XML Parsers should ignore XML comments. Some constrains govern where comments may be placed with an XML file.
The correct order is: version, encoding and standalone. Either single or double quotes may be used.
No, it's not OK.
Appendix F of the XML spec says:
Because each XML entity not accompanied by external encoding information and not in UTF-8 or UTF-16 encoding must begin with an XML encoding declaration, in which the first characters must be '< ?xml', any conforming processor can detect, after two to four octets of input, which of the following cases apply.
Ah, but, section F is non-normative, you say.
Well, section 2.1 gives the production for a well-formed XML document, thus:
[1] document ::= prolog element Misc*
...and in section 2.8 we get the production for "prolog":
[22] prolog ::= XMLDecl? Misc* (doctypedecl Misc*)? [23] XMLDecl ::= '<?xml' VersionInfo EncodingDecl? SDDecl? S? '?>'
So, you can omit the < ?xml declaration, but you can't prefix it with anything.
(Incidentally, "Misc" is the category that comments fall into).
If you love us? You can donate to us via Paypal or buy me a coffee so we can maintain and grow! Thank you!
Donate Us With