svn commit: r41999 - head/en_US.ISO8859-1/books/fdp-primer/writing-style

Hiroki Sato hrs at
Mon Jun 24 01:00:42 UTC 2013

Warren Block <wblock at> wrote
  in <201306220227.r5M2RYNg041141 at>:

wb> Author: wblock
wb> Date: Sat Jun 22 02:27:34 2013
wb> New Revision: 41999
wb> URL:
wb> Log:
wb>   Improve the word list markup with brackets instead of CDATA, and add a
wb>   non-breaking space to the Ports Collection example.
wb> Modified:
wb>   head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml
wb> Modified: head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml
wb> ==============================================================================
wb> --- head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml	Fri Jun 21 21:41:48 2013	(r41998)
wb> +++ head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml	Sat Jun 22 02:27:34 2013	(r41999)
wb> @@ -496,12 +496,12 @@ GB.  Hardware compression …</lite
wb>  	<tbody>
wb>  	  <row>
wb>  	    <entry>CD-ROM</entry>
wb> -	    <entry><literal><![CDATA[<acronym>CD-ROM</acronym>]]></literal></entry>
wb> +	    <entry><literal><acronym>CD-ROM</acronym></literal></entry>

 Please use <sgmltag>acronym</sgmltag> here like the following.  It
 will be replaced with <tag> after DocBook 5.0 migration, but
 <foo> should be avoided.

-	    <entry><literal><acronym>CD-ROM</acronym></literal></entry>
+	    <entry><sgmltag class="starttag">acronym</sgmltag><literal>CD-ROM</literal><sgmltag class="endtag">acronym</sgmltag></entry>

 It is good to avoid CDATA section whenever possible.

-- Hiroki
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 196 bytes
Desc: not available
URL: <>

More information about the svn-doc-all mailing list