From owner-freebsd-doc@FreeBSD.ORG Fri Dec 12 02:51:22 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 9A35D1065672 for ; Fri, 12 Dec 2008 02:51:22 +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 EA0348FC25 for ; Fri, 12 Dec 2008 02:51:21 +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 mBC2pCc0032167 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Fri, 12 Dec 2008 04:51:17 +0200 Received: from kobe.laptop (kobe.laptop [127.0.0.1]) by kobe.laptop (8.14.3/8.14.3) with ESMTP id mBC2pBL1005699; Fri, 12 Dec 2008 04:51:11 +0200 (EET) (envelope-from keramida@freebsd.org) Received: (from keramida@localhost) by kobe.laptop (8.14.3/8.14.3/Submit) id mBC2pBLe005698; Fri, 12 Dec 2008 04:51:11 +0200 (EET) (envelope-from keramida@freebsd.org) From: Giorgos Keramidas To: Manolis Kiagias References: <871vwfn418.fsf@kobe.laptop> <2a7894eb0812101310v2123a452q26b0e07630e7f209@mail.gmail.com> <878wqnafso.fsf@kobe.laptop> <2a7894eb0812101322o77b12fc9k8208f83d62481ad3@mail.gmail.com> <49403656.4020303@gmail.com> Date: Fri, 12 Dec 2008 04:51:11 +0200 In-Reply-To: <49403656.4020303@gmail.com> (Manolis Kiagias's message of "Wed, 10 Dec 2008 23:36:22 +0200") Message-ID: <8763lq14yo.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: mBC2pCc0032167 X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (not cached, score=-4.295, 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: Fri, 12 Dec 2008 02:51:22 -0000 On Wed, 10 Dec 2008 23:36:22 +0200, Manolis Kiagias wrote: > 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 That looks good. I've started pushing to hg.hellug.gr some commits that add this sort of role="" attribute to the wlan section :-) Manolis, I have a question that is mostly a style issue though. There are some compound acronyms in the wlan section, i.e. "WPA-TLS". Would you prefer a separate for "WPA" and "TLS" like WPA-TLS or a single element like WPA-TLS The first seems more logical, and it would fit nicely with the set of acronym entities (acronyms.ent) I proposed in another email of the thread (eg. we won't have to introduce a new, special entity for &acronym.wlan.wpa-tls; but we can reuse the WPA and TLS entities). I am not sure if it would result in aesthetically pleasing output when the dotted underlines appear in separate words though.