Date: Fri, 12 Dec 2008 07:28:52 +0200 From: Manolis Kiagias <sonic2000gr@gmail.com> To: Giorgos Keramidas <keramida@freebsd.org> Cc: freebsd-doc@freebsd.org Subject: Re: [PATCH] Adding <acronym> elements to wlan Handbook section Message-ID: <4941F694.3040600@gmail.com> In-Reply-To: <8763lq14yo.fsf@kobe.laptop> References: <871vwfn418.fsf@kobe.laptop> <2a7894eb0812101310v2123a452q26b0e07630e7f209@mail.gmail.com> <878wqnafso.fsf@kobe.laptop> <2a7894eb0812101322o77b12fc9k8208f83d62481ad3@mail.gmail.com> <49403656.4020303@gmail.com> <8763lq14yo.fsf@kobe.laptop>
next in thread | previous in thread | raw e-mail | index | archive | help
Giorgos Keramidas wrote: > 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. > > > I agree that the first seems more logical and more effective as the entities can be reused. However the difference is really very small, so go along with the one you prefer. As for the dotted lines, they are so subtle anyway that it won't make much of a difference if they appear in separate words.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?4941F694.3040600>