cvs commit: doc/share/sgml freebsd.ent
Simon L. Nielsen
simon at FreeBSD.org
Thu Jul 15 12:00:51 PDT 2004
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.... ;-)
> >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...
--
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/20040715/1225081f/attachment.bin
More information about the cvs-doc
mailing list