From owner-cvs-doc@FreeBSD.ORG Thu Jul 15 19:00:51 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 209E116A4CE; Thu, 15 Jul 2004 19:00:51 +0000 (GMT) Received: from zaphod.nitro.dk (port324.ds1-khk.adsl.cybercity.dk [212.242.113.79]) by mx1.FreeBSD.org (Postfix) with ESMTP id 61FE643D49; Thu, 15 Jul 2004 19:00:50 +0000 (GMT) (envelope-from simon@zaphod.nitro.dk) Received: by zaphod.nitro.dk (Postfix, from userid 3000) id 51852119B9; Thu, 15 Jul 2004 21:00:48 +0200 (CEST) Date: Thu, 15 Jul 2004 21:00:48 +0200 From: "Simon L. Nielsen" To: Daniel Harris Message-ID: <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> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="lrZ03NoBR/3+SXJZ" Content-Disposition: inline In-Reply-To: <8024E9F2-D677-11D8-AAE9-000A95B14342@askdh.com> User-Agent: Mutt/1.5.6i cc: chris@unixpages.org cc: Tom Rhodes cc: murray@freebsd.org cc: doc-committers@freebsd.org cc: cvs-doc@freebsd.org 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 19:00:51 -0000 --lrZ03NoBR/3+SXJZ Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On 2004.07.15 11:56:14 -0400, Daniel Harris wrote: >=20 > 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=20 > >>>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.... ;-) > >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 :-). > 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... --=20 Simon L. Nielsen FreeBSD Documentation Team --lrZ03NoBR/3+SXJZ Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.4 (FreeBSD) iD8DBQFA9tRfh9pcDSc1mlERAlxWAJ99nrxNQmT816PlXZ0hU0+JpVQGOgCgrrx8 TQ6lBOwGGcGgBBzgFIrFLQI= =yr5c -----END PGP SIGNATURE----- --lrZ03NoBR/3+SXJZ--