cvs commit: doc/share/sgml freebsd.ent

[Daniel Harris]

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

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 
than is worth eliminating having to type an acronym out once per piece 
of documentation.

-- 
Daniel Harris