[PATCH] Adding <acronym> elements to wlan Handbook section

Giorgos Keramidas keramida at freebsd.org
Wed Dec 10 21:21:48 UTC 2008


On Wed, 10 Dec 2008 23:12:17 +0200, Manolis Kiagias <sonic2000gr at gmail.com> 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 <acronym> 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:
>
> <acronym role="Wired Equivalent Privacy">WEP</acronym>
>
> 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. :)



More information about the freebsd-doc mailing list