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

[Simon L. Nielsen]

On 2003.08.03 15:10:17 -0700, Murray Stokely wrote:
> On Sat, Aug 02, 2003 at 10:41:16PM +0200, Simon L. Nielsen wrote:
> > I'm currently finishing off a large patch (5800 lines patch and still
> > counting) to add trademark information to the entire doc/ tree, so
> > please hold any trademark changes until it has been committed.
> 
> I think it would be better to make these changes in more frequent
> batches.  There's no need to hold off for one big mega-patch that will
> just make it harder to review.

OK, the main reason for one large patch/commit was mainly to avoid a lot
of small commit messeages which was more or less the same change for
different parts of doc/en_US.ISO8859-1/...

> Also, I think it's very easy to go overboard with this and by batching
> it up all at once you don't give us the opportunity to tell you to
> slow down.

Fair enough.  I also have no problem with getting more eyes on the
changes before commit, if anyone is interested.

> Please review common books by O'Reilly and others before adding a
> trademark on every instance of the word Linux or NetBSD, for example,
> which is certainly not necessary.

I have only added trademarks for companies/organizations which use
trademark marks (r/tm) themself, and/or have an explicit trademark
policy on their website.

Speficially I haven't added any trademark symbols for Linux and NetBSD.
For Linux I just added acknowledgment of the trademarks in the legal
section.  For NetBSD I havn't added anything since I noticed, after the
www trademark patches, that 'NetBSD' is in fact not an active registered
trademark (it's still being processed by USPTO) and it's not even
mentioned on www.NetBSD.org.

Actually the O'Reilly books I have dosn't use (r)/(tm) marks (from a
quick check) but state on the 'legal' page : 'Many of the designations
used by manufactureres and sellers to distinguish their products are
claimed as trademarks.  Where those designations appear in the book,
and O'Reilly & Associates, Inc. was aware of a trademark clain, the
designators have been printed in caps or initial caps.' (this was from
my paper edition of Mastering Regular Expressions).  It also states '...
The Java(tm) Series is a trademark of O'Reily & Associates.' with a
proper (tm) symbol, but the first reference to Java in the book does not
use a trademark symbol...

That doesn't comply with most of the company trademark policies I have
seen, at least as I read them, but I have no idea if companies are
actually allowed to make those requirement under current trademark laws.

> When we introduce a product for the first time in the Handbook, we
> definitely want a trademark symbol.  Other instances are more
> debatable.  If we really have to add 5800 trademark signs, then it's
> almost certainly preferable to just use a more generic word.

I should have ben more explicit about the numbers, sorry about that.
The patch (i.e. 'cvs diff | wc -l') is 5800 lines. With a bit if
grepping it looks like actually 960 lines are changes, which includes
'<legalnotice' sections in all the articles and similar "support"
changes which are not addition of (r)/(tm).

Most (r)/(tm) additions are explicit references to products which can't
really be changed, though some more "generic" are UNIX and i386 (which
Intel claim as a non registered trademark).  Some of these more generic
references might be replaced with other non trademark terms later.

The best to handle all the trademarks IMO would be to mark up all
trademarks with <trademark> tags and then make the stylesheets
determince when to print (r)/(rm) symbols (e.g. first occurrence in
ps/pdf/html and first occournce per page for html-split).  I don't know
if that's posssible, since I have very little experince with the dsssl
stylesheets.

-- 
Simon L. Nielsen
FreeBSD Documentation Team
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
Url : http://lists.freebsd.org/pipermail/cvs-doc/attachments/20030804/b58b105b/attachment.bin