Date: Fri, 12 Dec 2008 04:51:11 +0200 From: Giorgos Keramidas <keramida@freebsd.org> To: Manolis Kiagias <sonic2000gr@gmail.com> Cc: freebsd-doc@freebsd.org Subject: Re: [PATCH] Adding <acronym> elements to wlan Handbook section Message-ID: <8763lq14yo.fsf@kobe.laptop> In-Reply-To: <49403656.4020303@gmail.com> (Manolis Kiagias's message of "Wed, 10 Dec 2008 23:36:22 %2B0200") References: <871vwfn418.fsf@kobe.laptop> <2a7894eb0812101310v2123a452q26b0e07630e7f209@mail.gmail.com> <878wqnafso.fsf@kobe.laptop> <2a7894eb0812101322o77b12fc9k8208f83d62481ad3@mail.gmail.com> <49403656.4020303@gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
On Wed, 10 Dec 2008 23:36:22 +0200, Manolis Kiagias <sonic2000gr@gmail.com> 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 <acronym> for "WPA" and "TLS" like <acronym role="Wi-Fi Protected Access">WPA</acronym>-<acronym role="Transport Layer Security">TLS</acronym> or a single element like <acronym role="Wi-Fi Protected Access / Transport Layer Security">WPA-TLS</acronym> 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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?8763lq14yo.fsf>