Preferred GUI menu navigation representation
mdke at ubuntu.com
Thu May 10 06:24:22 UTC 2007
-----BEGIN PGP SIGNED MESSAGE-----
* 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;
> <para>The terminal can be found and started at &terminal;</para>
> 2. <menuchoice> etc.
> <para>The terminal can be found and started at
> Yours thoughts and preferences would be welcome.
> 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!
gnupg pub 1024D/0E6B06FF
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
-----END PGP SIGNATURE-----
More information about the ubuntu-doc