From owner-freebsd-doc@FreeBSD.ORG  Wed Dec 10 21:36:26 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 44716106564A
	for <freebsd-doc@freebsd.org>; Wed, 10 Dec 2008 21:36:26 +0000 (UTC)
	(envelope-from sonic2000gr@gmail.com)
Received: from ug-out-1314.google.com (ug-out-1314.google.com [66.249.92.171])
	by mx1.freebsd.org (Postfix) with ESMTP id C32658FC18
	for <freebsd-doc@freebsd.org>; Wed, 10 Dec 2008 21:36:25 +0000 (UTC)
	(envelope-from sonic2000gr@gmail.com)
Received: by ug-out-1314.google.com with SMTP id 30so155936ugs.39
	for <freebsd-doc@freebsd.org>; Wed, 10 Dec 2008 13:36:24 -0800 (PST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma;
	h=domainkey-signature:received:received:message-id:date:from
	:user-agent:mime-version:to:cc:subject:references:in-reply-to
	:content-type:content-transfer-encoding;
	bh=YJ4t6tKBT9KxACuMvGPJMoLrQpgA3+EMQPROnO44GuA=;
	b=hOUsX++IaheRWSzw+pwrypS4kkOW3oKFrv24yKuSsB+k/RPlpMWvTSd1zw8+4aSgFs
	LRAGqnrbyHB6LZOcNDgA56gTs4/G+uGmdP/HxmMBEk9oC3MJRIQf4fiBQTkOT0rI9S3A
	RhHLNmBzwfbW75BLDLOYZDkp4hp/upkp7lPgQ=
DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma;
	h=message-id:date:from:user-agent:mime-version:to:cc:subject
	:references:in-reply-to:content-type:content-transfer-encoding;
	b=ro1A5BAW8T3f1F7QyduqFy+S2BDAvgbNGTKNpVHTsfqkIiz2g8Zp2Lo5uHnplQ9iaj
	fXSZMMXLF0zYRUCHEdULZiBORiSXSjbuoj8Q949y1lqoMAiC9thWakDrbE5JSyNAdTfK
	Hn6NEGdSskQ355vrU1r15caMrik3JOV0HbreA=
Received: by 10.66.250.1 with SMTP id x1mr4461482ugh.4.1228944984637;
	Wed, 10 Dec 2008 13:36:24 -0800 (PST)
Received: from atlantis.dyndns.org (athedsl-4448612.home.otenet.gr
	[79.129.209.84])
	by mx.google.com with ESMTPS id b39sm14518117ugf.38.2008.12.10.13.36.23
	(version=TLSv1/SSLv3 cipher=RC4-MD5);
	Wed, 10 Dec 2008 13:36:24 -0800 (PST)
Message-ID: <49403656.4020303@gmail.com>
Date: Wed, 10 Dec 2008 23:36:22 +0200
From: Manolis Kiagias <sonic2000gr@gmail.com>
User-Agent: Thunderbird 2.0.0.17 (X11/20081011)
MIME-Version: 1.0
To: Murray Stokely <murray@stokely.org>
References: <871vwfn418.fsf@kobe.laptop>	<2a7894eb0812101310v2123a452q26b0e07630e7f209@mail.gmail.com>	<878wqnafso.fsf@kobe.laptop>
	<2a7894eb0812101322o77b12fc9k8208f83d62481ad3@mail.gmail.com>
In-Reply-To: <2a7894eb0812101322o77b12fc9k8208f83d62481ad3@mail.gmail.com>
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 7bit
Cc: freebsd-doc@freebsd.org, Giorgos Keramidas <keramida@freebsd.org>
Subject: Re: [PATCH] Adding <acronym> elements to wlan Handbook section
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
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: Wed, 10 Dec 2008 21:36:26 -0000

Murray Stokely wrote:
> In that case this looks great to me.  I agree with Manolis that adding
> the role="definition" for the first instance of each acronym is
> helpful.  I really thought we were already doing this in parts of the
> Handbook, but I may be misremembering.
>
>            - Murray
>
>   

I've seen it in the Handbook, but in very few parts. It is also rendered
very nicely, and is not at all distracting. (A lightweight, dotted
underline). See here for an example:

http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-ftp.html