From owner-freebsd-doc@FreeBSD.ORG  Sun Jul 18 13:21:46 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: by hub.freebsd.org (Postfix, from userid 815)
	id D141516A4CF; Sun, 18 Jul 2004 13:21:46 +0000 (GMT)
Date: Sun, 18 Jul 2004 13:21:46 +0000
From: Murray Stokely <murray@FreeBSD.org>
To: Marc Fonvieille <blackend@FreeBSD.org>
Message-ID: <20040718132146.GA83265@hub.freebsd.org>
References: <20040713074042.GA5126@abigail.blackend.org>
	<20040713170624.GU29928@submonkey.net>
	<20040713181500.GA10935@abigail.blackend.org>
	<20040715071709.GB55440@hub.freebsd.org>
	<20040715073027.GA725@zaphod.nitro.dk>
	<20040715083333.GA62713@hub.freebsd.org>
	<20040718100224.GA84500@abigail.blackend.org>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20040718100224.GA84500@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
cc: "Simon L. Nielsen" <simon@FreeBSD.org>
Subject: Re: Mouseover definitions for acronyms (was 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: Sun, 18 Jul 2004 13:21:46 -0000

On Sun, Jul 18, 2004 at 12:02:25PM +0200, Marc Fonvieille wrote:
> Well for me "it looks weird", I mean I see too much dotted underlines :)
> just look at the 23.4.2 section for example... or some titles.  Many
> different acronyms in one text could lead to something "difficult" to
> read.
> I think rendering the first three ones should be enough, if one needs to
> know the meaning of NIS, it's at the beginning of the text not at the
> end.

Agreed.

> Now an "innocent" question: if we use first four acronyms (1 for the
> glossary, the rest for the mouseover thing), do we need to tag the
> remaining ones (with an entity or <acronym> tags)?  I'm thinking about a
> section not a whole chapter.

We could handle this in either the stylesheets or in the SGML files.
I personally think that there is no need to add the <acronym> tags
throughout the chapter -- just the first four will suffice.

     - Murray