From owner-freebsd-doc@FreeBSD.ORG Mon Sep 8 09:19:16 2003 Return-Path: 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 2DDFB16A4BF; Mon, 8 Sep 2003 09:19:16 -0700 (PDT) Received: from eth0.a.smtp.sonic.net (eth0.a.smtp.sonic.net [64.142.16.244]) by mx1.FreeBSD.org (Postfix) with ESMTP id D9C3C43FEC; Mon, 8 Sep 2003 09:19:14 -0700 (PDT) (envelope-from bmah@intruder.kitchenlab.org) Received: from intruder.kitchenlab.org (adsl-64-142-29-77.sonic.net [64.142.29.77]) by eth0.a.smtp.sonic.net (8.12.9/8.12.7) with ESMTP id h88GJEub030766 (version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=NO); Mon, 8 Sep 2003 09:19:14 -0700 Received: from intruder.kitchenlab.org (bmah@localhost [127.0.0.1]) h88GJDYe024482; Mon, 8 Sep 2003 09:19:13 -0700 (PDT) (envelope-from bmah@intruder.kitchenlab.org) Received: (from bmah@localhost) by intruder.kitchenlab.org (8.12.9/8.12.9/Submit) id h88GJDgC024481; Mon, 8 Sep 2003 09:19:13 -0700 (PDT) (envelope-from bmah) Date: Mon, 8 Sep 2003 09:19:13 -0700 From: "Bruce A. Mah" To: "Simon L. Nielsen" Message-ID: <20030908161913.GA22709@intruder.kitchenlab.org> References: <200309081453.h88Er29F069868@repoman.freebsd.org> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="DocE+STaALJfprDB" Content-Disposition: inline In-Reply-To: <200309081453.h88Er29F069868@repoman.freebsd.org> User-Agent: Mutt/1.4.1i X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-url: http://www.employees.org/~bmah/ cc: freebsd-doc@freebsd.org Subject: Re: cvs commit: src/release/doc/en_US.ISO8859-1/early-adopter article.sgml src/release/doc/en_US.ISO8859-1/errata article.sgml src/release/doc/en_US.ISO8859-1/readme article.sgml X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 08 Sep 2003 16:19:16 -0000 --DocE+STaALJfprDB Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable If memory serves me right, Simon L. Nielsen wrote: > simon 2003/09/08 07:53:02 PDT >=20 > FreeBSD src repository (doc committer) >=20 > Modified files: > release/doc/en_US.ISO8859-1/early-adopter article.sgml=20 > release/doc/en_US.ISO8859-1/errata article.sgml=20 > release/doc/en_US.ISO8859-1/readme article.sgml=20 > Log: > - Use trademark entities. > - Add trademark attributions. > - Don't join trademarks with other words, e.g. using hyphens. I noticed a couple of trademark entities that looked a little odd, specifically where we refer to the name of a FreeBSD architecture. For example, the first sentence of the "Late-Breaking News" section of the errata used to read (roughly): "ipfw(4) should work correctly on strict-alignment 64-architectures such as alpha and sparc64." Now it reads: "ipfw(4) should work correctly on strict-alignment 64-architectures such as alpha and Sparc64(R)." The problem is that "Sparc64(R)" or "Sparc64" is not what we call the platform, it's "sparc64". (Think of "/usr/src/sys/sparc64".) In my mind, the use of "sparc64" above is just one step away from a filename, even though I never marked it up as such. I think there was a use of "i386" that was similar. It's not clear to me what's the right thing here. A more clear-cut case: What if I have some text that says "look in the sparc64 directory". Does this become the (completely incorrect) "look in the &sparc64; directory"? (I have absolutely no problems at all with using the trademark entities in cases where it's unlikely that a reader could interpret a term as a filename.) No criticism intended, this is good work. I'm just trying to wrap my mind around it, as well as figure out all the implications of these changes. Thanks, Bruce. --DocE+STaALJfprDB Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.2 (FreeBSD) iD8DBQE/XKwB2MoxcVugUsMRAqeRAJ9bxICAlT9/vqrMu7evmf0Pg895FgCgp0p8 lJTRwxbkV0ijo0PNL2hHGoc= =HKgl -----END PGP SIGNATURE----- --DocE+STaALJfprDB--