From owner-freebsd-doc@FreeBSD.ORG Mon Jan 2 11:15:25 2006 Return-Path: X-Original-To: freebsd-doc@FreeBSD.org Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 930DA16A41F; Mon, 2 Jan 2006 11:15:25 +0000 (GMT) (envelope-from simon@eddie.nitro.dk) Received: from eddie.nitro.dk (zarniwoop.nitro.dk [83.92.207.38]) by mx1.FreeBSD.org (Postfix) with ESMTP id E454943D5A; Mon, 2 Jan 2006 11:15:22 +0000 (GMT) (envelope-from simon@eddie.nitro.dk) Received: by eddie.nitro.dk (Postfix, from userid 1000) id 6BC22119C4F; Mon, 2 Jan 2006 12:15:16 +0100 (CET) Date: Mon, 2 Jan 2006 12:15:16 +0100 From: "Simon L. Nielsen" To: Xin LI Message-ID: <20060102111515.GB80845@eddie.nitro.dk> References: <20060102101644.GA53576@hub.freebsd.org> <20060102105647.GA80845@eddie.nitro.dk> <20060102110553.GA57646@hub.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="/NkBOFFp2J2Af1nK" Content-Disposition: inline In-Reply-To: <20060102110553.GA57646@hub.freebsd.org> User-Agent: Mutt/1.5.11 Cc: freebsd-doc@FreeBSD.org Subject: Re: [PATCH FOR REVIEW] doc/en_US.ISO8859-1/books SGML cleanup X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 02 Jan 2006 11:15:25 -0000 --/NkBOFFp2J2Af1nK Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2006.01.02 11:05:53 +0000, Xin LI wrote: > Hi, Simon, >=20 > On Mon, Jan 02, 2006 at 11:56:48AM +0100, Simon L. Nielsen wrote: > > > http://people.freebsd.org/~delphij/for_review/patch-books > > >=20 > > > Look appropriate? The primary change is to escape >, <, and &, plus > > > adding some "'s for attributes. > >=20 > > I haven't done a complete review but, you replaced some text with > > entities which aren't needed, since the document is ISO8859-1 so > > e.g. a "?" (AKA ø) is perfectly valid. E.g. > >=20 > > - * Converted to 5.X by S?ren (Xride) Straarup > > + * Converted to 5.X by Søren (Xride) Straarup >=20 > I agree, but since our documentation is going to be translated into > various languages, I would suggest that we always escape these > characters, for the master (English) edition, which will make our > (especially Chinese, Japanese and Korean translation teams) life a lot > easier, because these characters would be misinterpreted to unreadable > stuff by poorly written editors, and we do not need to re-escape > these in translated versions, thus avoids mistakes. OK, I hadn't thought about that. Since there is a valid reason for using the entities it's fine with me. --=20 Simon L. Nielsen --/NkBOFFp2J2Af1nK Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.2 (FreeBSD) iD8DBQFDuQtDh9pcDSc1mlERArw8AJ960mvQ6kFUcseZaSpUprtt6zzfJgCeKNYG yYfRH+UpCHzgBB0KpnZPAoU= =VpmH -----END PGP SIGNATURE----- --/NkBOFFp2J2Af1nK--