Handbook Acronyms

Ceri Davies ceri at FreeBSD.org
Tue Jul 13 16:52:33 UTC 2004


On Mon, Jul 12, 2004 at 05:31:25PM -0600, Warren Block wrote:
> In most books, the first use of an acronym or term is defined.  With the 
> Handbook, that is probably not very helpful, since most users will not 
> read it straight through and may miss the definition.
> 
> A glossary would help, particularly for HTML, where the definition is 
> just a link away.  This fails on paper versions of the Handbook, though.
> 
> Ideally, the first use of a glossary term in a chapter would have a 
> short definition:
> 
>     With NFS (Network File System), files may be...
> 
> In the HTML version, the entire "NFS (Network File System)" would be a 
> link to the glossary.  Later references and links would just be "NFS".
> 
> If every acronym is defined in the glossary, is it possible to generate 
> the link and definition the first time an acronym is used in a chapter?

Yes, and that's the plan at the moment.

Ceri
-- 
It is not tinfoil, it is my new skin.  I am a robot.
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: not available
URL: <http://lists.freebsd.org/pipermail/freebsd-doc/attachments/20040713/462d4b24/attachment.sig>


More information about the freebsd-doc mailing list