cvs commit: doc/share/sgml freebsd.ent

Tom Rhodes trhodes at FreeBSD.org
Thu Jul 15 14:27:06 PDT 2004


On Thu, 15 Jul 2004 21:00:48 +0200
"Simon L. Nielsen" <simon at FreeBSD.org> 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


More information about the cvs-doc mailing list