Date: Mon, 24 Jun 2013 10:00:18 +0900 (JST) From: Hiroki Sato <hrs@FreeBSD.org> To: wblock@FreeBSD.org Cc: svn-doc-head@FreeBSD.org, svn-doc-all@FreeBSD.org, doc-committers@FreeBSD.org Subject: Re: svn commit: r41999 - head/en_US.ISO8859-1/books/fdp-primer/writing-style Message-ID: <20130624.100018.1908369837183849691.hrs@allbsd.org> In-Reply-To: <201306220227.r5M2RYNg041141@svn.freebsd.org> References: <201306220227.r5M2RYNg041141@svn.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
----Security_Multipart(Mon_Jun_24_10_00_18_2013_775)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Warren Block <wblock@FreeBSD.org> wrote in <201306220227.r5M2RYNg041141@svn.freebsd.org>: wb> Author: wblock wb> Date: Sat Jun 22 02:27:34 2013 wb> New Revision: 41999 wb> URL: http://svnweb.freebsd.org/changeset/doc/41999 wb> 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> wb> Modified: wb> head/en_US.ISO8859-1/books/fdp-primer/writing-style/chapter.xml wb> 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 ----Security_Multipart(Mon_Jun_24_10_00_18_2013_775)-- Content-Type: application/pgp-signature Content-Transfer-Encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.13 (FreeBSD) iEYEABECAAYFAlHHmiIACgkQTyzT2CeTzy3q9wCeNStNsWRG3KyTFwJi1rMhlp5u F2wAoIMvGYj2Xq5OyQ7Joef8kljrWRel =bNmH -----END PGP SIGNATURE----- ----Security_Multipart(Mon_Jun_24_10_00_18_2013_775)----
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20130624.100018.1908369837183849691.hrs>