From owner-freebsd-doc@FreeBSD.ORG  Sun Jul 18 10:02:28 2004
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP
	id E18D616A4CE; Sun, 18 Jul 2004 10:02:28 +0000 (GMT)
Received: from abigail.blackend.org (blackend.org [212.11.35.229])
	by mx1.FreeBSD.org (Postfix) with ESMTP
	id CF7B143D41; Sun, 18 Jul 2004 10:02:27 +0000 (GMT)
	(envelope-from marc@blackend.org)
Received: from abigail.blackend.org (localhost [127.0.0.1])
	i6IA2PbZ084959;	Sun, 18 Jul 2004 12:02:25 +0200 (CEST)
	(envelope-from marc@abigail.blackend.org)
Received: (from marc@localhost)
	by abigail.blackend.org (8.12.11/8.12.11/Submit) id i6IA2PBi084958;
	Sun, 18 Jul 2004 12:02:25 +0200 (CEST)
	(envelope-from marc)
Date: Sun, 18 Jul 2004 12:02:25 +0200
From: Marc Fonvieille <blackend@FreeBSD.org>
To: Murray Stokely <murray@FreeBSD.org>
Message-ID: <20040718100224.GA84500@abigail.blackend.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>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20040715083333.GA62713@hub.freebsd.org>
User-Agent: Mutt/1.4.2.1i
X-Useless-Header: blackend.org
X-Operating-System: FreeBSD 4.10-PRERELEASE
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 10:02:29 -0000

On Thu, Jul 15, 2004 at 08:33:33AM +0000, Murray Stokely wrote:
> Ok this is working now.  Thanks to Simon for explaining how to do the
> mouseovers in HTML4.  I think that the little dotted underlines will
> get distracting in a chapter filled with acronyms.
> 
> For the advanced networking chapter anyway, it might look best if the
> first occurence of an acronym is rendered with a link to the glossary,
> and the first three are rendered with the mouseover.
> 
> I'm not really sure, it's largely up to individual sense of
> aesthetic.  What do others think?
> 
[...]

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.

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.

Marc