From owner-freebsd-doc@FreeBSD.ORG  Thu Jul 15 07:17:09 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 815)
	id 4068116A4CF; Thu, 15 Jul 2004 07:17:09 +0000 (GMT)
Date: Thu, 15 Jul 2004 07:17:09 +0000
From: Murray Stokely <murray@FreeBSD.org>
To: Marc Fonvieille <blackend@FreeBSD.org>
Message-ID: <20040715071709.GB55440@hub.freebsd.org>
References: <20040713074042.GA5126@abigail.blackend.org>
	<20040713170624.GU29928@submonkey.net>
	<20040713181500.GA10935@abigail.blackend.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20040713181500.GA10935@abigail.blackend.org>
User-Agent: Mutt/1.4.1i
X-GPG-Key-ID: 1024D/0E451F7D
X-GPG-Key-Fingerprint: E2CA 411D DD44 53FD BB4B  3CB5 B4D7 10A2 0E45 1F7D
cc: Ceri Davies <ceri@FreeBSD.org>
cc: doc@FreeBSD.org
Subject: Re: RFC: initialisms and FDP
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.1
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Thu, 15 Jul 2004 07:17:09 -0000

On Tue, Jul 13, 2004 at 08:15:00PM +0200, Marc Fonvieille wrote:
> You're right, I did not read carefully last commits.  However Murray's
> commit helps me to "bounce" on something I discreetly mentioned:
> NTP, SMTP, TCP etc... should be tagged (I mean replaced with an entity) ?
> What will be considered as an acronym?  Everything or just some terms?

I marked up the NIS in that chapter mainly because NFS was already
done and it just wasn't consistent, then after I got to about the 30th
occurrence and realized I wasn't nearly finished with the file I
created the &nis; entity.

It would be really nice if we had some applications of all these
<acronym> tags before spamming our SGML files with them.  I think it
would be really cool if we had a mouse over rule for the HTML output
to display the expanded form of the abbreviation.  Also, the first
occurence in a file could point to the glossary as was mentioned.
Until we have some kind of application, I don't want to spend any time
adding <acronym> tags.

How are mouseover's defined these days?  Is this standardized in CSS2
or only a Javascript thing?  If it's in CSS2, then we could write some
simple xsl code to make a pass through the docs and output some rules
to append to docbook.css during the build.

   - Murray