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

classic Classic list List threaded Threaded
4 messages Options
Reply | Threaded
Open this post in threaded view
|

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

bugzilla-noreply
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: [hidden email]
          Reporter: [hidden email]
          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.
_______________________________________________
[hidden email] mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[hidden email]"
Reply | Threaded
Open this post in threaded view
|

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

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

--- Comment #1 from [hidden email] ---
A commit references this bug:

Author: gabor
Date: Thu Sep  8 14:40:04 UTC 2016
New revision: 49372
URL: https://svnweb.freebsd.org/changeset/doc/49372

Log:
  - Update and simplify section on comments according to the XML standard
    (this section still reflected some old SGML constructs).

  PR:           204885
  Submitted by: Andreas Perstinger <[hidden email]>

Changes:
  head/en_US.ISO8859-1/books/fdp-primer/xml-primer/chapter.xml

--
You are receiving this mail because:
You are the assignee for the bug.
_______________________________________________
[hidden email] mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[hidden email]"
Reply | Threaded
Open this post in threaded view
|

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

bugzilla-noreply
In reply to this post by bugzilla-noreply
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=204885

Gabor Kovesdan <[hidden email]> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
         Resolution|---                         |FIXED
             Status|New                         |Closed
                 CC|                            |[hidden email]

--- Comment #2 from Gabor Kovesdan <[hidden email]> ---
Committed, thanks!

--
You are receiving this mail because:
You are the assignee for the bug.
_______________________________________________
[hidden email] mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[hidden email]"
Reply | Threaded
Open this post in threaded view
|

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

bugzilla-noreply
In reply to this post by bugzilla-noreply
https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=204885

Gabor Kovesdan <[hidden email]> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
           Assignee|[hidden email]     |[hidden email]

--
You are receiving this mail because:
You are the assignee for the bug.
_______________________________________________
[hidden email] mailing list
https://lists.freebsd.org/mailman/listinfo/freebsd-doc
To unsubscribe, send any mail to "[hidden email]"