Date: Mon, 8 Sep 2003 09:19:13 -0700 From: "Bruce A. Mah" <bmah@freebsd.org> To: "Simon L. Nielsen" <simon@freebsd.org> 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 Message-ID: <20030908161913.GA22709@intruder.kitchenlab.org> In-Reply-To: <200309081453.h88Er29F069868@repoman.freebsd.org> References: <200309081453.h88Er29F069868@repoman.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
--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 <filename>sparc64</filename> directory". Does this become the (completely incorrect) "look in the <filename>&sparc64;</filename> 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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030908161913.GA22709>