Preferred GUI menu navigation representation

[Matthew East]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Hi,

* Will Simpson:
> 
> 
> On 5/9/07, *Philip Wyett* <philip.wyett at gmail.com
> <mailto:philip.wyett at gmail.com>> wrote:
> 
>     Hi all,
> 
>     Is there a preferred method for indicating menu navigation in the
>     xml docs?
> 
>     Two popular methods are e.g for navigation to 'Applications ->
>     Accessories -> Terminal' are:
> 
>     1. &terminal;
> 
>     e.g.
> 
>     <para>The terminal can be found and started at &terminal;</para>
> 
>     2. <menuchoice> etc.
> 
>     e.g.
> 
>     <para>The terminal can be found and started at
>         <menuchoice>
>           <guimenu>Applications</guimenu>
>           <guisubmenu>Accessories</guisubmenu>
>           <guimenuitem>Terminal</guimenuitem>
>         </menuchoice>
>     </para>
> 
>     Yours thoughts and preferences would be welcome.
> 
>     Regards
> 
>     Phil
> 
> 
> The first method is preferred. The &terminal; refers to a section in the
> file ../../lib/gnome-menus-C.ent. This file contains all or most of the
> menu mappings in Ubuntu. This is done so if an item is moved from one
> menu to another the change is trivial. Otherwise every instance of a
> reference to the menu item would have to searched for an changed.

That's right. If there is an entity defined in gnome-menus-C.ent, then
we should use it.

Note that in the end, the methods are in fact the same, because the
entity in the first method simply expands to the <menuchoice> expression
you've cited in the second method, if that makes sense!

Matt
- --
http://www.mdke.org
gnupg pub 1024D/0E6B06FF
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iD8DBQFGQrqWtSaF0w5rBv8RAmgrAJ9MJhqqlRGK6e+DPoGRzd2Y4w4MqgCfRPsK
QXQwUzvOJwrN6f1n/v0enoU=
=Qch3
-----END PGP SIGNATURE-----