<div>On 10/05/07, Matthew East <<a href="mailto:mdke@ubuntu.com">mdke@ubuntu.com</a>> wrote:<blockquote class="gmail_quote" style="border-left: 1px solid rgb(204, 204, 204); margin: 0pt 0pt 0pt 0.8ex; padding-left: 1ex;"> -----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Hi, * Will Simpson: > > > On 5/9/07, *Philip Wyett* <<a href="mailto:philip.wyett@gmail.com">philip.wyett@gmail.com</a> > <mailto: <a href="mailto:philip.wyett@gmail.com">philip.wyett@gmail.com</a>>> 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</blockquote><div> 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 </div> </div>