Uploaded image for project: 'Technical Advisory Board'
  1. Technical Advisory Board
  2. TAB-1183

3. Identifying DocBook Documents and Schemas mixed Normative and Non-Normative text

    XMLWordPrintable

    Details

    • Type: Bug
    • Status: New
    • Priority: Major
    • Resolution: Unresolved
    • Affects Version/s: DocBook 5.1
    • Fix Version/s: None
    • Component/s: Public reviews
    • Labels:
      None
    • Environment:

      Normative

    • Proposal:
      Hide

      Put the first paragraph into a note and make the second sentence the lone normative content in this section.

      Show
      Put the first paragraph into a note and make the second sentence the lone normative content in this section.

      Description

      3. Identifying DocBook Documents and Schemas reads:

      Historically, when DocBook was defined by a DTD, DocBook documents could be identified by the presence of standard public and/or system identifiers in the document type declaration. RELAX NG, the normative schema language for DocBook V5.0, does not provide any equivalent mechanism.

      For systems that can make use of public identifiers, e.g., systems where the informative DTD is being used, the following public identifier should be used for DocBook V5.1: “-//OASIS//DTD DocBook V5.1//EN//XML”.

      The first paragraph is clearly non-normative and should be a note.

      The second paragraph expresses a normative requirement and should appear as normative text.

        Attachments

          Activity

            People

            • Assignee:
              Unassigned
              Reporter:
              patrick Patrick Durusau
            • Watchers:
              1 Start watching this issue

              Dates

              • Created:
                Updated: