From owner-freebsd-doc Wed Aug 23 13:29:16 2000 Delivered-To: freebsd-doc@freebsd.org Received: from services.BSDI.COM (services.BSDI.COM [207.174.116.2]) by hub.freebsd.org (Postfix) with ESMTP id 50B5437B424; Wed, 23 Aug 2000 13:29:04 -0700 (PDT) Received: from forge.BSDI.COM (dgl@forge.BSDI.COM [207.174.118.24]) by services.BSDI.COM (8.9.3/8.9.3) with ESMTP id OAA01384; Wed, 23 Aug 2000 14:29:02 -0600 (MDT) Received: (from dgl@localhost) by forge.BSDI.COM (8.9.3/8.9.0) id OAA25290; Wed, 23 Aug 2000 14:29:02 -0600 (MDT) Date: Wed, 23 Aug 2000 14:29:02 -0600 From: Deborah Greenberg Lidl To: Mark Ovens Cc: Rasmus Kaj , doc@FreeBSD.ORG Subject: Re: tag in the docs Message-ID: <20000823142901.B25008@bsdi.com> References: <20000820131444.C254@parish> <84u2ccdlfn.fsf@frodo.sickla.raditex.se> <20000823190427.B254@parish> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <20000823190427.B254@parish>; from marko@FreeBSD.ORG on Wed, Aug 23, 2000 at 07:04:27PM +0100 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Wed, Aug 23, 2000 at 07:04:27PM +0100, Mark Ovens said: > On Wed, Aug 23, 2000 at 05:52:28PM +0200, Rasmus Kaj wrote: > > >>>>> "MO" == Mark Ovens writes: > > > > MO> In the Programmers Tools tutorial there are several uses of the > > MO> tag but it appears not to work: > > > > MO> MS-DOS > > > > MO> appears in the doc as: > > > > MO> MS-DOS&trade > > > > I'm assuming here that you're talking about generating HTML. Correct > > me if I'm wrong. > > You are correct. The problem is with the browser. Navigator does not recognize ™ as valid. View the tutorial -- or any code using ™ -- in Internet Explorer, Lynx, or an editor like HotMetal PRO. Those tools all render ™ in an expected fashion like (TM) or a superscripted TM. However, Navigator does recognize ™ and renders it as [tm]. Lynx renders this code as (TM) and Internet Explorer renders it as a superscripted TM. To fix the DSSSL stylesheets, modify html/dbinline.dsl to use the code: 245c245 < (make entity-ref name: "trade"))))) --- > (make entity-ref name: "#8482"))))) This displays as expected in Navigator 4.74, Internet Explorer 5.0, and Lynx 2.8.2rel1. The W3C recommendation for character entity references in HTML 4 recognizes trade for 8482. Thus, I would argue that Navigator is broken and should be fixed. However, being practical, one could modify the freebsd.dsl stylesheet to use 8482. > > MO> Also, shouldn't we really acknowledge trademarks, either by using the > > MO> "(TM)" symbol with each instance [ ... ] > > > > This would be what happens now, right? > > It was only in the Programming Guide; I couldn't find the trademark > tag used anywhere else although trademarked words are used. > > Anyway, I changed (and committed) the Programmers Guide by removing > the tag so, although I believe we should use it, it now looks correct > in the HTML (Netscape) and is consistent with the rest of the docs. Technically, to protect the tradmarks, you do want to acknowledge trademarks every time they're used. Practically, that tends to make the page or screen look like it's been peppered with bugs from all of the (R), (TM), and (SM) marks. What I usually do is mark trademarks for my products on the cover / main screen / title page. Everything else gets acknowledged in the footnote of the article, the legal notices page of the book, or an appendix of the book. Sometimes it's the blanket "All other brand or product names are or may be trademarks of, and are used to identify products and services of, their respective owners." Other times, I acknowledge the trademark and it's owner by name. Fortunately, FreeBSD is a registered trademark, and all of the browsers seem to recognize ® :-) Cheers, Debbie -- Deborah Greenberg Lidl Toll free: 1.888.849.BSDi dgl@bsdi.com BSDi Phone: 1.301.765.7945 http://www.bsdi.com Fax: 1.301.765.7946 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message