Preferred GUI menu navigation representation

[Philip Wyett]

On 10/05/07, Matthew East <mdke at ubuntu.com> wrote:
>
> -----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


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
doing.

Regards

Phil
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20070510/24b817f1/attachment.html>