[Bug 204885] [patch] FDP, chapter 7.5: wrong informations about XML comments

[bugzilla-noreply at freebsd.org]

https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=204885

            Bug ID: 204885
           Summary: [patch] FDP, chapter 7.5: wrong informations about XML
                    comments
           Product: Documentation
           Version: Latest
          Hardware: Any
                OS: Any
            Status: New
          Keywords: patch
          Severity: Affects Many People
          Priority: ---
         Component: Documentation
          Assignee: freebsd-doc at FreeBSD.org
          Reporter: andipersti at gmail.com
          Keywords: patch

Created attachment 163635
  --> https://bugs.freebsd.org/bugzilla/attachment.cgi?id=163635&action=edit
Rewrite of the XML comments section in FDP

There are two serious problems in section 7.5 (XML comments) in the FDP (see
also http://www.w3.org/TR/2006/REC-xml11-20060816/#sec-comments):

1) 'The delimiter for XML comments is the string "--" ...'. This is wrong. An
XML comment starts with the string "<!--" and ends with the string "-->".

2) The fourth example in "Example 7.6" is wrong. It is not a valid XML comment
because an XML comment must not contain the string "--".

I suggest a complete rewrite of that section.

-- 
You are receiving this mail because:
You are the assignee for the bug.