Preferred GUI menu navigation representation
philip.wyett at gmail.com
Thu May 10 06:40:48 UTC 2007
On 10/05/07, Matthew East <mdke at ubuntu.com> wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
> * 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!
Yes it does make sense. Having a look at the gnome-menus-C.ent to have a
look whats what, these are essentially define macros.
Thanks for the confirmation. I can now push on with what I was looking at
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the ubuntu-doc