From owner-freebsd-doc@FreeBSD.ORG  Fri Dec 12 09:04:51 2008
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: doc@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 752E01065673
	for <doc@freebsd.org>; Fri, 12 Dec 2008 09:04:51 +0000 (UTC)
	(envelope-from keramida@freebsd.org)
Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36])
	by mx1.freebsd.org (Postfix) with ESMTP id DC35E8FC13
	for <doc@freebsd.org>; Fri, 12 Dec 2008 09:04:50 +0000 (UTC)
	(envelope-from keramida@freebsd.org)
Received: from kobe.laptop (adsl179-214.kln.forthnet.gr [77.49.0.214])
	(authenticated bits=128)
	by igloo.linux.gr (8.14.3/8.14.3/Debian-5) with ESMTP id mBC94grB021911
	(version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT);
	Fri, 12 Dec 2008 11:04:48 +0200
Received: from kobe.laptop (kobe.laptop [127.0.0.1])
	by kobe.laptop (8.14.3/8.14.3) with ESMTP id mBC94g34013994;
	Fri, 12 Dec 2008 11:04:42 +0200 (EET)
	(envelope-from keramida@freebsd.org)
Received: (from keramida@localhost)
	by kobe.laptop (8.14.3/8.14.3/Submit) id mBC94ghO013993;
	Fri, 12 Dec 2008 11:04:42 +0200 (EET)
	(envelope-from keramida@freebsd.org)
From: Giorgos Keramidas <keramida@freebsd.org>
To: "Rene Ladan" <r.c.ladan@gmail.com>
References: <871vwfn418.fsf@kobe.laptop>
	<2a7894eb0812101310v2123a452q26b0e07630e7f209@mail.gmail.com>
	<878wqnafso.fsf@kobe.laptop>
	<2a7894eb0812101322o77b12fc9k8208f83d62481ad3@mail.gmail.com>
	<87k5a63z2d.fsf@kobe.laptop>
	<e890cae60812112351h226d57fja3c481c56d7f4a7b@mail.gmail.com>
Date: Fri, 12 Dec 2008 11:04:41 +0200
In-Reply-To: <e890cae60812112351h226d57fja3c481c56d7f4a7b@mail.gmail.com>
	(Rene Ladan's message of "Fri, 12 Dec 2008 08:51:07 +0100")
Message-ID: <871vwdahna.fsf@kobe.laptop>
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/23.0.60 (berkeley-unix)
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-MailScanner-ID: mBC94grB021911
X-Hellug-MailScanner: Found to be clean
X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached,
	score=-4.294, required 5, autolearn=not spam, ALL_TRUSTED -1.80,
	AWL 0.10, BAYES_00 -2.60)
X-Hellug-MailScanner-From: keramida@freebsd.org
X-Spam-Status: No
Cc: doc@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: Fri, 12 Dec 2008 09:04:51 -0000

On Fri, 12 Dec 2008 08:51:07 +0100, "Rene Ladan" <r.c.ladan@gmail.com> wrote:
> I am in favour of the full expansion, so that you can write
>
> <para>Using &acronym.wlan.wep; encryption is not really safe anymore,
>   but a lot of people use it anyway.</para>
>
> This form is shorter and we don't have to write the word "acronym"
> three times.
>
> Maybe the acronyms can link to the glossary of the Handbook as well?

That's an interesting idea :-)

On Fri, 12 Dec 2008 09:58:28 +0100, Gabor PALI <pgj@FreeBSD.org> wrote:
> Maybe you can have different versions in the .ent file, like you did
> in case of mailing lists (defer the design decisions :)):
>
> <!ENTITY acronym.wlan.wep '<acronym role="Wired Equivalent Privacy">WEP</acronym>'>
> <!ENTITY acronym.wlan.wep.name '<acronym>WEP</acronym>'>

Heh, cool!  I'll try to update the patch to include entities like this.

Thank you both for the ideas.