#36 TDG: Patch for chapter 4 of TDG

closed-fixed
nobody
5
2005-11-16
2002-08-14
John Daily
No

* Use CDATA sections in screen and programlisting
blocks containing sample
SGML and XML code.
* Put quotes around attribute values in one sample
block. Some of the
attributes are attached to <xref> tags; so far as I
know, there is no way
to represent an <xref> that is legal in both DocBook
SGML and XML, so I
left them SGML-compliant (without a closing /).
* Update the Emacs comments at the end of the document.

I expect to make more changes to chapter 4 later; I'll
attach
a revised patch to this report (assuming it hasn't been
applied).

Discussion

  • John Daily
    John Daily
    2002-08-14

    Patch for chapter 4 of TDG

     
    Attachments
  • John Daily
    John Daily
    2002-08-14

    Revised patch for chapter 4

     
    Attachments
  • John Daily
    John Daily
    2002-08-14

    Logged In: YES
    user_id=421263

    Here is a revised patch to wrap more programlistings in
    CDATA and
    make further markup changes. The original patch should be
    discarded.

    Revised changelog:

    * Use CDATA sections in screen and programlisting blocks
    containing sample
    SGML and XML code.
    * Put quotes around attribute values in one sample block.
    Some of the
    attributes are attached to <xref> tags; so far as I know,
    there is no way
    to represent an <xref> that is legal in both DocBook SGML
    and XML, so I
    left them SGML-compliant (without a closing /).
    * Replace XML with &XML; when not in index terms, and SGML
    with &SGML;.
    This only affects latter parts of the chapter; older
    portions already use
    those entities.
    * Replace <literal> with tags such as sgmltag, varname, and
    parameter.
    * Update the Emacs comments at the end of the document.

     
  • John Daily
    John Daily
    2002-08-15

    3rd version of patch

     
    Attachments
  • John Daily
    John Daily
    2002-08-15

    Logged In: YES
    user_id=421263

    I'm attaching yet another revision of the patch. Updated
    changelog:

    * Use CDATA sections in screen and programlisting blocks
    containing sample
    SGML and XML code.
    * Put quotes around attribute values in one sample block.
    Some of the
    attributes are attached to <xref> tags; so far as I know,
    there is no way
    to represent an <xref> that is legal in both DocBook SGML
    and XML, so I
    left them SGML-compliant (without a closing /).
    * Replace XML with &XML; when not in index terms, and SGML
    with &SGML;.
    This only affects latter parts of the chapter; older
    portions already use
    those entities.
    * Replace <literal> with tags such as sgmltag, varname, and
    parameter.
    * Update the Emacs comments at the end of the document.
    * Replace “/” pairs with <quote> tags.
    * Eliminate “/” entities used following an
    <xref>; this
    may be an outdated stylesheet workaround.
    * Replace a quoted reference to a section with an <xref>
    (Scheme).

     
  • Norman Walsh
    Norman Walsh
    2002-12-29

    Logged In: YES
    user_id=81663

    Fixed in CVS.

     
  • Norman Walsh
    Norman Walsh
    2002-12-29

    • status: open --> closed-fixed
     
    • summary: Patch for chapter 4 of TDG --> TDG: Patch for chapter 4 of TDG
     
    • labels: --> DocBook: The Definitive Guide