From owner-freebsd-doc@FreeBSD.ORG Wed Dec 10 21:21:48 2008 Return-Path: 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 DD5381065672 for ; Wed, 10 Dec 2008 21:21:48 +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 538DB8FC12 for ; Wed, 10 Dec 2008 21:21:48 +0000 (UTC) (envelope-from keramida@freebsd.org) Received: from kobe.laptop (adsl22-219.kln.forthnet.gr [77.49.149.219]) (authenticated bits=128) by igloo.linux.gr (8.14.3/8.14.3/Debian-5) with ESMTP id mBALLcQB004062 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 10 Dec 2008 23:21:43 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id mBALLcd7006800; Wed, 10 Dec 2008 23:21:38 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id mBALLcli006799; Wed, 10 Dec 2008 23:21:38 +0200 (EET) (envelope-from keramida@freebsd.org) From: Giorgos Keramidas To: Manolis Kiagias References: <871vwfn418.fsf@kobe.laptop> <494030B1.2080001@gmail.com> Date: Wed, 10 Dec 2008 23:21:37 +0200 In-Reply-To: <494030B1.2080001@gmail.com> (Manolis Kiagias's message of "Wed, 10 Dec 2008 23:12:17 +0200") Message-ID: <874p1bafq6.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: mBALLcQB004062 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-4.304, 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: freebsd-doc@freebsd.org Subject: Re: [PATCH] Adding elements to wlan Handbook section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 10 Dec 2008 21:21:48 -0000 On Wed, 10 Dec 2008 23:12:17 +0200, Manolis Kiagias wrote: > Giorgos Keramidas wrote: >> The wireless networking section is one of those I've been translating >> lately, and I noticed that it includes *many* acronyms (AP, BSS, SSID, >> IBSS, WPA, WEP, PSK, TKIP, and so on). The acronyms are practically >> everywhere, so adding tags to them directly into CVS may not >> be a very gentle thing to do. >> >> So here it is, in diff format for your pleasure. Does anyone have >> objections to the patch attached below? >> >> [NOTE: I haven't wrapped any lines, to keep the patch more readable, but >> I know already that some of the touched lines may need a bit of wrap & >> filling after the patch goes in.] > > No objection here, but just an idea: It is also possible to use > something like: > > WEP > > when this is rendered in HTML, the text in "role" appears on > mouse-over (what most would call a tool tip). Maybe we could use this > the first time the acronym is used (except if it is already expanded > in the preceeding text of course). That sounds nice. I'll try to see where it would fit in our DSSSL formatting code, because we don't (normally) write the fully expanded form of acronyms in the SGML source now. :)