From owner-svn-doc-all@FreeBSD.ORG Mon Jun 24 01:00:42 2013 Return-Path: Delivered-To: svn-doc-all@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 1845C1E4; Mon, 24 Jun 2013 01:00:42 +0000 (UTC) (envelope-from hrs@FreeBSD.org) Received: from mail.allbsd.org (gatekeeper.allbsd.org [IPv6:2001:2f0:104:e001::32]) by mx1.freebsd.org (Postfix) with ESMTP id F305F15FD; Mon, 24 Jun 2013 01:00:40 +0000 (UTC) Received: from alph.d.allbsd.org (p3086-ipbf906funabasi.chiba.ocn.ne.jp [122.26.46.86]) (authenticated bits=128) by mail.allbsd.org (8.14.5/8.14.5) with ESMTP id r5O10MlE049901 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NO); Mon, 24 Jun 2013 10:00:32 +0900 (JST) (envelope-from hrs@FreeBSD.org) Received: from localhost (localhost [127.0.0.1]) (authenticated bits=0) by alph.d.allbsd.org (8.14.5/8.14.5) with ESMTP id r5O10LWj045511; Mon, 24 Jun 2013 10:00:22 +0900 (JST) (envelope-from hrs@FreeBSD.org) Date: Mon, 24 Jun 2013 10:00:18 +0900 (JST) Message-Id: <20130624.100018.1908369837183849691.hrs@allbsd.org> To: wblock@FreeBSD.org Subject: Re: svn commit: r41999 - head/en_US.ISO8859-1/books/fdp-primer/writing-style From: Hiroki Sato In-Reply-To: <201306220227.r5M2RYNg041141@svn.freebsd.org> References: <201306220227.r5M2RYNg041141@svn.freebsd.org> X-PGPkey-fingerprint: BDB3 443F A5DD B3D0 A530 FFD7 4F2C D3D8 2793 CF2D X-Mailer: Mew version 6.5 on Emacs 24.3 / Mule 6.0 (HANACHIRUSATO) Mime-Version: 1.0 Content-Type: Multipart/Signed; protocol="application/pgp-signature"; micalg=pgp-sha1; boundary="--Security_Multipart(Mon_Jun_24_10_00_18_2013_775)--" Content-Transfer-Encoding: 7bit X-Virus-Scanned: clamav-milter 0.97.4 at gatekeeper.allbsd.org X-Virus-Status: Clean X-Greylist: Sender succeeded SMTP AUTH, not delayed by milter-greylist-4.2.7 (mail.allbsd.org [133.31.130.32]); Mon, 24 Jun 2013 10:00:33 +0900 (JST) X-Spam-Status: No, score=-89.5 required=13.0 tests=CONTENT_TYPE_PRESENT, DIRECTOCNDYN,DYN_PBL,ONLY1HOPDIRECT,RCVD_IN_PBL,SAMEHELOBY2HOP, USER_IN_WHITELIST autolearn=no version=3.3.2 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on gatekeeper.allbsd.org Cc: svn-doc-head@FreeBSD.org, svn-doc-all@FreeBSD.org, doc-committers@FreeBSD.org X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 24 Jun 2013 01:00:42 -0000 ----Security_Multipart(Mon_Jun_24_10_00_18_2013_775)-- Content-Type: Text/Plain; charset=us-ascii Content-Transfer-Encoding: 7bit Warren Block 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 … wb> wb> CD-ROM wb> - CD-ROM]]> wb> + <acronym>CD-ROM</acronym> Please use acronym here like the following. It will be replaced with after DocBook 5.0 migration, but <foo> should be avoided. - <acronym>CD-ROM</acronym> + acronymCD-ROMacronym 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)----