Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 28 Nov 2015 18:42:29 +0000
From:      bugzilla-noreply@freebsd.org
To:        freebsd-doc@FreeBSD.org
Subject:   [Bug 204885] [patch] FDP, chapter 7.5: wrong informations about XML comments
Message-ID:  <bug-204885-9@https.bugs.freebsd.org/bugzilla/>

next in thread | raw e-mail | index | archive | help
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@FreeBSD.org
          Reporter: andipersti@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.



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?bug-204885-9>