From owner-cvs-doc@FreeBSD.ORG Thu Jul 15 21:27:06 2004 Return-Path: Delivered-To: cvs-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 5BEF116A4CE; Thu, 15 Jul 2004 21:27:06 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id B236D43D1D; Thu, 15 Jul 2004 21:27:05 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost.pittgoth.com (acs-24-154-239-141.zoominternet.net [24.154.239.141]) (authenticated bits=0) by pittgoth.com (8.12.11/8.12.11) with ESMTP id i6FLR16g065873 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Thu, 15 Jul 2004 17:27:02 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Thu, 15 Jul 2004 17:27:34 -0400 From: Tom Rhodes To: "Simon L. Nielsen" Message-Id: <20040715172734.4d843a91@localhost.pittgoth.com> In-Reply-To: <20040715190047.GB756@zaphod.nitro.dk> References: <200407150822.i6F8MJpq045751@repoman.freebsd.org> <20040715082621.GG1683@unixpages.org> <20040715110005.1330db2e@localhost.pittgoth.com> <8024E9F2-D677-11D8-AAE9-000A95B14342@askdh.com> <20040715190047.GB756@zaphod.nitro.dk> X-Mailer: Sylpheed-Claws 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: chris@unixpages.org cc: doc-committers@FreeBSD.org cc: murray@FreeBSD.org cc: cvs-doc@FreeBSD.org cc: Daniel Harris Subject: Re: cvs commit: doc/share/sgml freebsd.ent X-BeenThere: cvs-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the doc and www trees List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 15 Jul 2004 21:27:06 -0000 On Thu, 15 Jul 2004 21:00:48 +0200 "Simon L. Nielsen" wrote: > On 2004.07.15 11:56:14 -0400, Daniel Harris wrote: > > > > On Jul 15, 2004, at 11:00 AM, Tom Rhodes wrote: > > >>On Thu, Jul 15, 2004 at 08:22:19AM +0000, Murray Stokely wrote: > > >>> Modified files: > > >>> share/sgml freebsd.ent > > >>> Log: > > >>> Add a role attribute to the NIS acronym so that we can render HTML > > >>> that displays a mouseover with the full text 'Network Information > > >>> System'. This is a proof of concept. Stylesheet support coming > > >>>next. > > >Will it work if I move my mouse on the printed pages? Now that > > Well, it could work. You just need to be in the right state of mind > first.... ;-) Oh that doesn't work; usually after that state of mind it's rotating bedrooms, talking computers, and a mouthy dumpster that just has to pick a fight with you. And you fight if even though you know it's going to kick your ass because he has before ... > > > >would be something! Otherwise, this is a nice idea but it > > >provides nothing for printed output. Should we continue to > > >mark things up with full text for first acronym use? > > > > As some browsers don't support this either, this should probably be > > considered an addition and not a replacement to using full text on > > first reference. > > That's a valid point - but that could also be handled by the DSSSL > stylesheet if we want... > > > On paper, it would be ungainly to have full text in parentheses after > > each use of a frequently-used acronym anyway, and hacking stylesheets > > to do so only on first reference, if possible, strikes me as more work > > It possible and much of the work can be done by using copy/paste on > the code that makes sure that (r)/(tm) marks are only shown once per > page. If we decide it's the way to go, I would even be dumb enough > volunteer to implement it :-). Don't let me stand in the way of your commit. > > > than is worth eliminating having to type an acronym out once per piece > > of documentation. > > But how do you know if it is the first time? You know when you write > it, but later someone uses the acronym again earlier in the > article/book and then it's not the first occurence any more... Well, grep and it's '-n' option is your friend. -- Tom Rhodes