cvs commit: doc/en_US.ISO8859-1/books/handbook/preface preface.sgml

[Giorgos Keramidas]

On Mon, 17 Nov 2008 13:45:56 +0200, Manolis Kiagias <sonicy at otenet.gr> wrote:
> Gabor PALI wrote:
>> I am thinking of a &dtrace; entity that resolves to the text "DTrace",
>> as in case of &sun; or &solaris;.  It would help to eliminate these
>> spelling mistakes, that is why it popped to my mind.  It is just a
>> suggestion, though.
>
> Not sure if there is a policy somewhere for this stuff. We don't seem to
> have many entities of this type, xorg comes to mind but a quick look at
> freebsd.ent does not reveal much else that resembles it.

When there are special rules of capitalization, it's a bit easier to
type &dtrace; than spend a bit of time to grep through the docs to look
for ``established tradition''.  I would probably prefer something like a
&dtrace; entity.

If it is a registered symbol or a trademark of Sun, it may even make
sense to add it to `doc/share/trademarks.ent' to take advantage of the
DSSSL-magic that add a (TM) marker to the first instance of the
"DTrace&trade;" string.