Re: GUADEC: longish account of things discussed

[Federico Mena Quintero <federico helixcode com>]

>  	o As well as indexing, the issue of the glossary came up 
>      again. With caveats, there was some support for this. I must admit 
>      to bias: I think it would be super-cool if things that are marked
>      as <glossterm> and are being mentioned in the right hand pane
>      had the glossary definitions in the left-hand pane. Dan Muet raised
>      the problem of consistency: if there was a glossary being written
>      as a separate document, then constantly having to check that all
>      the time would rapidly become a pain. Also, what happens if you
>      have a word like "root" in there, which might be "root directory"
>      for one doc, "root as UID 0" in another, and the "root window" in
>      another? Nautilus would need a way of knowing which to refer to.

You can "normalize" <glossterm> entries with the BaseForm attribute.
This lets you write something like

	<para>
	  If you click the right mouse button on a window, you will
	  get a context-sensitive menu.  If the window you click on is
	  the <glossterm baseform="root window">root</a>, you will get
	  the desktop menu.  If the user is logged in as 
	  <glossterm baseform="root user">root</a>, then he will be
	  able to do very dangerous things.
	</para>

  Federico