Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 15 Jul 2004 21:00:48 +0200
From:      "Simon L. Nielsen" <simon@FreeBSD.org>
To:        Daniel Harris <dh@askdh.com>
Cc:        cvs-doc@freebsd.org
Subject:   Re: cvs commit: doc/share/sgml freebsd.ent
Message-ID:  <20040715190047.GB756@zaphod.nitro.dk>
In-Reply-To: <8024E9F2-D677-11D8-AAE9-000A95B14342@askdh.com>
References:  <200407150822.i6F8MJpq045751@repoman.freebsd.org> <20040715082621.GG1683@unixpages.org> <20040715110005.1330db2e@localhost.pittgoth.com> <8024E9F2-D677-11D8-AAE9-000A95B14342@askdh.com>

next in thread | previous in thread | raw e-mail | index | archive | help

--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--



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20040715190047.GB756>