User guide update, phase 1

1 files changed, 360 insertions, 1681 deletions

diff --git a/gnome2-user-guide/C/goseditmainmenu.xml b/gnome2-user-guide/C/goseditmainmenu.xml
index 2d53d73..a8cc63b 100644
--- a/gnome2-user-guide/C/goseditmainmenu.xml
+++ b/gnome2-user-guide/C/goseditmainmenu.xml
@@ -1,1682 +1,361 @@
-<chapter id="goseditmainmenu-1"> 

-  <title>Working With Menus</title> 

-  <highlights>

-	 <para>This chapter describes how to use menus in the desktop.</para>

-  </highlights>

-  <sect1 id="goseditmainmenu-2"> 

-	 <title>Introduction to Menus</title> 

-	 <indexterm>

-		<primary>menus</primary>

-		<secondary>introduction</secondary>

-	 </indexterm>

-	 <para>You can access all desktop functions through menus. The default

-		panels contain menus, so you can use a combination of menus and panels to

-		perform your tasks. </para>

-	 <para>You can perform various actions on your menus, such as display the

-		menu as a window and copy menu items to panels.</para>

-	 <para>You can access the following menus from the desktop:</para>

-	 <itemizedlist>

-		<listitem> 

-		  <para>

-			 <guimenu>Global Menu</guimenu>: The 

-			 <guimenu>Global Menu</guimenu> is your primary menu. You can access

-			 almost all of the applications, commands, and configuration options on your

-			 desktop from the 

-			 <guimenu>Global Menu</guimenu>. </para>

-		</listitem>

-		<listitem>

-		  <para>

-			 <guimenu>Main Menu</guimenu>: The 

-			 <guimenu>Main Menu</guimenu> is a customized 

-			 <guimenu>Global Menu</guimenu>. You can have many 

-			 <guimenu> Main Menu</guimenu> buttons in your panels. The structure

-			 of the menus can be different in each 

-			 <guimenu>Main Menu</guimenu>.</para>

-		</listitem> 

-		<listitem>

-		  <para>System menus: System menus contain the standard applications and

-			 standard applets that you can use on your desktop.</para>

-		</listitem>

-		<listitem> 

-		  <para>

-			 <guimenu>Favorites</guimenu> menu: You can add items that you use

-			 frequently to your 

-			 <guimenu> Favorites</guimenu> menu, and organize the items into

-			 submenus.</para> 

-		</listitem>

-		<listitem>

-		  <para>Custom menus: A custom menu is a menu that you create.</para>

-		</listitem>

-	 </itemizedlist>

-	 <para>You can also open menus from the desktop background. The 

-		<guimenu>Root </guimenu> menu enables you to navigate between windows and

-		workspaces. For information on the 

-		<guimenu>Root</guimenu> menu, see Working With Windows. The 

-		<guimenu>Desktop Background</guimenu> menu enables you to perform desktop

-		background-related tasks. For information on the 

-		<guimenu>Desktop Background </guimenu> menu, see Using the Nautilus

-		Desktop.</para>

-	 <para>All of these menus provide you with multiple ways to perform your

-		tasks, and enable you to work in the way that you prefer.</para> 

-  </sect1>

-  <sect1 id="goseditmainmenu-5"> 

-	 <title>Menu Features</title> 

-	 <indexterm>

-		<primary>menus</primary>

-		<secondary>features</secondary>

-	 </indexterm>

-	 <para>Menus have standard features that you can use to perform actions on

-		the menus. This section describes the structure of menus and the standard

-		features of menus.</para>

-	 <para><xref linkend="goseditmainmenu-FIG-37"/> shows a typical menu.</para>

-	 <figure id="goseditmainmenu-FIG-37"> 

-		<title>Typical Menu</title> 

-		<screenshot>

-		  <screeninfo>Annotated screenshot of a typical menu</screeninfo> 

-		  <mediaobject>

-			 <imageobject><imagedata fileref="figures/typical_anno_menu.png"

-				format="PNG"/> 

-			 </imageobject>

-			 <textobject>

-				<phrase>Annotated screenshot of a typical menu</phrase> 

-			 </textobject>

-		  </mediaobject>

-		</screenshot>

-	 </figure>

-	 <para><xref linkend="goseditmainmenu-TBL-28"/> describes the features of

-		menus. </para> 

-	 <table frame="topbot" id="goseditmainmenu-TBL-28"> 

-	 <title>Menu Features</title> 

-	 <tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="25.79*"/><colspec

-		colwidth="74.21*"/> 

-		<thead> 

-		  <row rowsep="1"> 

-			 <entry>

-				<para>Feature</para></entry> 

-			 <entry>

-				<para>Description </para></entry> 

-		  </row> 

-		</thead> 

-		<tbody> 

-		  <row> 

-			 <entry>

-				<para>Tear-off icon</para></entry> 

-			 <entry>

-				<para>The tear-off icon is a thin dashed line at the top of the

-				  menu. To change a menu into a separate window on your desktop, click on the

-				  tear-off icon. The menu window remains on your desktop, even if you point to

-				  another location on your desktop.</para></entry> 

-		  </row> 

-		  <row> 

-			 <entry>

-				<para>Menu title</para></entry> 

-			 <entry>

-				<para>The name of the menu. The menu title is at the top of the

-				  menu, followed by a separator line. You can right-click on the menu title to

-				  open a popup menu. The popup menu enables you to add the menu to a panel or to

-				  the 

-				  <guimenu>Favorites</guimenu> menu. </para></entry> 

-		  </row> 

-		  <row> 

-			 <entry>

-				<para>Menu items </para></entry> 

-			 <entry>

-				<para>Menus can contain the following items: </para>

-				<itemizedlist> 

-				  <listitem>

-					 <para>Submenus</para>

-				  </listitem>

-				  <listitem>

-					 <para>Launchers</para> 

-				  </listitem>

-				  <listitem>

-					 <para>Applets</para>

-				  </listitem>

-				</itemizedlist>

-				<para>An arrow to the right of an item in a menu indicates that the

-				  item is a submenu. When you point to the submenu, the submenu opens and you can

-				  choose items from the submenu.</para>

-				<para>When you choose a launcher, the launcher starts an

-				  application or runs a command. When you choose an applet from a menu, the

-				  applet is added to a panel.</para>

-				<para>You can right-click on a launcher or applet to open a popup

-				  menu. The popup menu enables you to add the item to a panel or to the 

-				  <guimenu>Favorites</guimenu> menu. For more information on the

-				  popup menu, see <xref linkend="goseditmainmenu-11"/>. </para></entry> 

-		  </row> 

-		</tbody> 

-	 </tgroup> 

-	 </table> 

-	 <para>You can specify global preferences for all menus in the <application>

-		Control Center</application>. For example, you can select an option to display

-		large icons in your menus.</para>

-	 <para>You can change the GNOME system settings for menu in the

-		<application> Panel</application> capplet. The system settings for menus are

-		displayed in the 

-		<guilabel>Menu</guilabel> tabbed section. You can also change the theme

-		for your session to change how all your menus look. You can change the theme in

-		the <application>Theme Selector</application> capplet.</para>

-	 <sect2 id="goseditmainmenu-11"> 

-		<title>Menu Item Popup Menus</title> 

-		<para>Menu items have an associated popup menu that enables you to add

-		  the item to your panels and to your 

-		  <guimenu>Favorites</guimenu> menu. When you right-click on the title of

-		  an item in a menu, the popup menu for the menu, launcher, or applet opens. This

-		  menu is different for menus, launchers, and applets. </para>

-		<para>You can use the popup menu to perform the following tasks: </para>

-		<itemizedlist>

-		  <listitem>

-			 <para>Add menus, launchers, and applets to panels. You can add a menu

-				as a menu object or as a drawer object. </para>

-		  </listitem>

-		  <listitem>

-			 <para>Add submenus, launchers, and applets to your 

-				<guimenu>Favorites </guimenu> menu.</para>

-		  </listitem>

-		  <listitem>

-			 <para>Remove submenus, launchers, and applets from your 

-				<guimenu> Favorites</guimenu> menu. </para> 

-		  </listitem>

-		  <listitem>

-			 <para>Change the properties of submenus, launchers, and applets in

-				your 

-				<guimenu>Favorites</guimenu> menu.</para>

-		  </listitem>

-		</itemizedlist> 

-		<para>Some items in the popup menu might not be available to you. Your

-		  user privileges determine which items are available. For example, if you do not

-		  have system administrator privileges, you can not modify the properties of the 

-		  <guimenu>Programs</guimenu> menu. </para>

-		<para><xref linkend="goseditmainmenu-FIG-38"/> shows the popup menu when

-		  you right-click on a submenu title. </para>

-		<figure id="goseditmainmenu-FIG-38"> 

-		  <title>Submenu Popup Menu</title> 

-		  <screenshot>

-			 <screeninfo>Screenshot of a submenu popup menu</screeninfo>

-			 <mediaobject> 

-				<imageobject><imagedata fileref="figures/submenu_popup.png"

-				  format="PNG"/>

-				</imageobject> 

-				<textobject>

-				  <phrase>Screenshot of a submenu popup menu</phrase>

-				</textobject> 

-			 </mediaobject>

-		  </screenshot>

-		</figure>

-		<para><xref linkend="goseditmainmenu-TBL-29"/> describes the items on

-		  submenu popup menus.</para> 

-		<table frame="topbot" id="goseditmainmenu-TBL-29"> 

-		<title>Items on Submenu Popup Menus</title> 

-		<tgroup cols="2" colsep="0" rowsep="0"><colspec

-		  colwidth="47.36*"/><colspec colwidth="52.64*"/> 

-		  <thead> 

-			 <row rowsep="1"> 

-				<entry>

-				  <para>Item</para></entry> 

-				<entry>

-				  <para>Description</para></entry> 

-			 </row> 

-		  </thead> 

-		  <tbody> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Add this as drawer to

-						panel</guimenuitem></para></entry> 

-				<entry>

-				  <para>Adds the submenu as a drawer to the panel from which you

-					 open the menu.</para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Add this as menu to

-						panel</guimenuitem></para></entry> 

-				<entry>

-				  <para>Adds the submenu as a menu object to the panel from which

-					 you open the menu.</para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Add this to Favorites

-						menu</guimenuitem></para></entry> 

-				<entry>

-				  <para>Adds the submenu to the 

-					 <guimenu>Favorites</guimenu> menu. </para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Add new item to this

-						menu</guimenuitem></para></entry> 

-				<entry>

-				  <para>Enables you to add an item to the submenu.</para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Properties</guimenuitem></para></entry> 

-				<entry>

-				  <para> Displays a dialog that enables you to edit the 

-					 <guilabel>Name</guilabel> and 

-					 <guilabel> Comment</guilabel> of the submenu.</para></entry> 

-			 </row> 

-		  </tbody> 

-		</tgroup> 

-		</table> 

-		<para><xref linkend="goseditmainmenu-FIG-39"/> shows the popup menu when

-		  you right-click on a launcher.</para>

-		<figure id="goseditmainmenu-FIG-39"> 

-		  <title>Launcher Popup Menu</title> 

-		  <screenshot>

-			 <screeninfo>Screenshot of a launcher popup menu</screeninfo>

-			 <mediaobject> 

-				<imageobject><imagedata fileref="figures/launcher_popup.png"

-				  format="PNG"/>

-				</imageobject> 

-				<textobject>

-				  <phrase>Screenshot of a launcher popup menu</phrase>

-				</textobject> 

-			 </mediaobject>

-		  </screenshot>

-		</figure>

-		<para><xref linkend="goseditmainmenu-TBL-30"/> describes the items on

-		  launcher popup menus.</para> 

-		<table frame="topbot" id="goseditmainmenu-TBL-30"> 

-		<title>Items on Launcher Popup Menus</title> 

-		<tgroup cols="2" colsep="0" rowsep="0"><colspec

-		  colwidth="42.71*"/><colspec colwidth="57.29*"/> 

-		  <thead> 

-			 <row rowsep="1"> 

-				<entry>

-				  <para>Item</para></entry> 

-				<entry>

-				  <para>Description</para></entry> 

-			 </row> 

-		  </thead> 

-		  <tbody> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Add this launcher to

-						panel</guimenuitem></para></entry> 

-				<entry>

-				  <para>Adds the launcher to the panel from which you open the

-					 menu. </para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Add this to Favorites

-						menu</guimenuitem></para></entry> 

-				<entry>

-				  <para>Adds the launcher to the 

-					 <guimenu>Favorites</guimenu> menu. </para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Remove this item</guimenuitem></para></entry> 

-				<entry>

-				  <para>Removes the launcher from the submenu.</para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Put into run dialog</guimenuitem></para></entry> 

-				<entry>

-				  <para>Displays the 

-					 <guilabel>Run Program</guilabel> dialog and puts the command

-					 from the 

-					 <guilabel>Command</guilabel> field of the launcher into the

-					 command field on 

-					 <guilabel>Run Program</guilabel> dialog. </para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Properties</guimenuitem></para></entry> 

-				<entry>

-				  <para> Displays a dialog that enables you to edit the properties

-					 of the launcher. </para></entry> 

-			 </row> 

-		  </tbody> 

-		</tgroup> 

-		</table> 

-		<para><xref linkend="goseditmainmenu-FIG-40"/> shows the popup menu when

-		  you right-click on an applet. </para>

-		<figure id="goseditmainmenu-FIG-40"> 

-		  <title>Popup Menu for Applet Menu Item</title> 

-		  <screenshot>

-			 <screeninfo>Screenshot of a popup menu for an applet menu item

-				</screeninfo> 

-			 <mediaobject>

-				<imageobject><imagedata fileref="figures/applet_popup.png"

-				  format="PNG"/> 

-				</imageobject>

-				<textobject>

-				  <phrase>Screenshot of a popup menu for an applet menu item

-					 </phrase>

-				</textobject>

-			 </mediaobject>

-		  </screenshot>

-		</figure>

 
-		<para><xref linkend="goseditmainmenu-TBL-31"/> describes the items on

-		  applet popup menus.</para> 

-		<table frame="topbot" id="goseditmainmenu-TBL-31"> 

-		<title>Items on Popup Menu for Applet Menu Items</title> 

-		<tgroup cols="2" colsep="0" rowsep="0"><colspec

-		  colwidth="34.34*"/><colspec colwidth="65.66*"/> 

-		  <thead> 

-			 <row rowsep="1"> 

-				<entry>

-				  <para>Item</para></entry> 

-				<entry>

-				  <para>Description</para></entry> 

-			 </row> 

-		  </thead> 

-		  <tbody> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Add this applet as a launcher to

-						panel</guimenuitem></para></entry> 

-				<entry>

-				  <para>Adds the launcher to the panel from which you open the

-					 menu. </para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Remove this item</guimenuitem></para></entry> 

-				<entry>

-				  <para>Removes the applet from the submenu. </para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>

-					 <guimenuitem>Properties</guimenuitem></para></entry> 

-				<entry>

-				  <para> Displays a dialog that enables you to edit the properties

-					 of the applet.</para></entry> 

-			 </row> 

-		  </tbody> 

-		</tgroup> 

-		</table> 

-	 </sect2>

-  </sect1>

-  <sect1 id="goseditmainmenu-7"> 

-	 <title>Global Menu</title> 

-	 <indexterm>

-		<primary>menus</primary>

-		<secondary>Global Menu</secondary>

-	 </indexterm>

-	 <screenshot>

-		<screeninfo>Screenshot of the Global Menu</screeninfo>

-		<mediaobject> 

-		  <imageobject><imagedata fileref="figures/open_main_menu.png" format="PNG"/>

-		  </imageobject> 

-		  <textobject>

-			 <phrase>Screenshot of the Global Menu</phrase>

-		  </textobject>

-		</mediaobject> 

-	 </screenshot>

-	 <para>The 

-		<guimenu>Global Menu</guimenu> is your primary menu. You can access

-		almost all of the standard applications, commands, and configuration options on

-		your desktop from the 

-		<guimenu>Global Menu</guimenu>. </para> 

-	 <para>The 

-		<guimenu>Global Menu</guimenu> provides the following top-level menus and

-		special menu items: </para>

-	 <itemizedlist>

-		<listitem> 

-		  <para>

-			 <guimenu>Programs</guimenu>: Contains all applications and

-			 configuration tools. This menu also includes the file manager and <application>

-			 GNOME Help Browser</application>.</para>

-		</listitem>

-		<listitem>

-		  <para>

-			 <guimenu>Favorites</guimenu>: You can add items that you use

-			 frequently to your 

-			 <guimenu>Favorites</guimenu> menu, and organize the items into

-			 submenus.</para>

-		</listitem>

-		<listitem>

-		  <para>

-			 <guimenu>Applets</guimenu>: Contains all applets that are installed

-			 on your system.</para>

-		</listitem> 

-		<listitem>

-		  <para>

-			 <guimenuitem>Run</guimenuitem> launcher: Displays the 

-			 <guilabel> Run Program</guilabel> dialog. </para>

-		</listitem>

-		<listitem>

-		  <para>

-			 <guimenu>Panel</guimenu>: Contains all commands that relate to

-			 panels.</para>

-		</listitem>

-		<listitem>

-		  <para>

-			 <guimenu>Desktop</guimenu>: Contains the 

-			 <guimenuitem>Lock screen</guimenuitem> and 

-			 <guimenuitem>Log out</guimenuitem> menu items. By default, the items

-			 in the 

-			 <guimenu>Desktop</guimenu> menu are at the top level of the 

-			 <guimenu>Global Menu</guimenu>. </para>

-		</listitem> 

-	 </itemizedlist>

-	 <para>You can customize the 

-		<guimenu>Global Menu</guimenu> to help you work more efficiently. You can

-		modify which menus are displayed on the 

-		<guimenu> Global Menu</guimenu>, and how the menus are displayed on the 

-		<guimenu>Global Menu</guimenu>. For example you can select to display all

-		the items in the 

-		<guimenu> Programs</guimenu> menu at the top level of the 

-		<guimenu>Global Menu</guimenu>. You can customize the 

-		<guimenu>Global Menu</guimenu> in the <application> Panel</application>

-		capplet. </para>

-	 <para>You can add 

-		<guimenu>Global Menu</guimenu> buttons to your panels. By default, the 

-		<guimenu>Global Menu</guimenu> is represented on panels by a stylized

-		footprint icon, as follows:</para>

-	 <screenshot>

-		<screeninfo>Screenshot of the Global Menu icon</screeninfo>

-		<mediaobject>

-		  <imageobject><imagedata fileref="figures/footprint_icon.png" format="PNG"/>

-		  </imageobject>

-		  <textobject>

-			 <phrase>Screenshot of the Global Menu icon</phrase>

-		  </textobject>

-		</mediaobject>

-	 </screenshot>

-	 <sect2 id="goseditmainmenu-15"> 

-		<title>To Open the Global Menu</title> 

-		<para>You can open the 

-		  <guimenu>Global Menu</guimenu> in the following ways: </para>

-		<itemizedlist>

-		  <listitem>

-			 <para>From a panel with a 

-				<guimenu>Global Menu</guimenu></para>

-			 <para>Click on the 

-				<guimenu>Global Menu</guimenu>. </para> 

-		  </listitem>

-		  <listitem>

-			 <para>From any panel</para>

-			 <para>To open the 

-				<guimenu>Global Menu</guimenu> from a panel right-click on a vacant

-				space in the panel. If there is no vacant space in the panel, right-click on

-				one of the hide buttons. </para> 

-			 <para>If you want to use the 

-				<guimenu>Global Menu</guimenu> to perform actions on a panel, you

-				must open the 

-				<guimenu>Global Menu</guimenu> from that panel. You can use the 

-				<guimenu>Global Menu</guimenu> to perform the following actions on

-				a panel: 

-				<itemizedlist>

-				  <listitem>

-					 <para>Add an item to the panel</para> 

-				  </listitem>

-				  <listitem>

-					 <para>Modify the properties of the panel</para>

-				  </listitem> 

-				  <listitem>

-					 <para>Remove the panel</para>

-				  </listitem>

-				</itemizedlist></para>

-		  </listitem> 

-		  <listitem>

-			 <para>Use a shortcut key</para>

-			 <para>You can use a shortcut key to open the 

-				<guimenu>Global Menu</guimenu>. When you use a shortcut key to open

-				the 

-				<guimenu>Global Menu</guimenu>, the 

-				<guimenu> Global Menu</guimenu> appears at the mouse pointer.

-				</para>

-			 <para>The default shortcut key to open the 

-				<guimenu>Global Menu</guimenu> is 

-				<keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo>. You can change the shortcut key that opens the

-				

-				<guimenu>Global Menu</guimenu> in the <application>Panel

-				</application> capplet.</para>

-		  </listitem>

-		</itemizedlist> 

-	 </sect2>

-	 <sect2 id="goseditmainmenu-29"> 

-		<title>To Add a Global Menu to a Panel</title> 

-		<para>You can add as many 

-		  <guimenu>Global Menu</guimenu> buttons as you want to your panels. To

-		  add a 

-		  <guimenu>Global Menu</guimenu> to a panel, right-click on any vacant

-		  space on the panel to open the 

-		  <guimenu>Global Menu</guimenu>. Choose 

-		  <menuchoice>

-			 <guimenu>Panel</guimenu>

-			 <guisubmenu>Add to panel</guisubmenu>

-			 <guisubmenu>Menu</guisubmenu>

-			 <guimenuitem>Main menu</guimenuitem>

-		  </menuchoice>.</para>

-	 </sect2>

-	 <sect2 id="goseditmainmenu-30"> 

-		<title>To Change a Global Menu Icon</title> 

-		<para>You can choose a custom icon to represent a 

-		  <guimenu>Global Menu</guimenu>. </para>

-		<para>To choose a custom icon to represent a 

-		  <guimenu>Global Menu</guimenu> perform the following steps:</para>

-		<orderedlist> 

-		  <listitem>

-			 <para>Right-click on the 

-				<guimenu>Global Menu</guimenu> to open the panel object popup

-				menu.</para>

-		  </listitem>

-		  <listitem>

-			 <para>Choose 

-				<guimenuitem>Properties</guimenuitem> to display the 

-				<guilabel> Menu Properties</guilabel> dialog. Click on the 

-				<guilabel>Icon</guilabel> tab to display the 

-				<guilabel>Icon</guilabel> tabbed section.</para>

-		  </listitem> 

-		  <listitem>

-			 <para>Select the 

-				<guilabel>Use custom icon for panel button</guilabel> option.

-				</para>

-		  </listitem>

-		  <listitem>

-			 <para>Click on the icon selector button to display an icon selector

-				dialog. Choose an icon from the dialog. Alternatively, click 

-				<guibutton>Browse </guibutton> to choose an icon from another

-				directory. When you choose an icon, click 

-				<guibutton>OK</guibutton>.</para>

-		  </listitem> 

-		  <listitem>

-			 <para>Click 

-				<guibutton>Close</guibutton>.</para>

-		  </listitem>

-		</orderedlist> 

-	 </sect2>

-	 <sect2 id="goseditmainmenu-31"> 

-		<title>To Modify How the Global Menu Displays Menus</title> 

-		<para>To modify how the 

-		  <guimenu>Global Menu</guimenu> displays menus perform the following

-		  steps:</para>

-		<orderedlist>

-		  <listitem>

-			 <para>To start the <application>Panel</application> capplet open the 

-				<guimenu>Global Menu</guimenu>, then choose 

-				<menuchoice>

-				  <guimenu>Programs</guimenu>

-				  <guisubmenu>Settings</guisubmenu>

-				  <guisubmenu>Desktop</guisubmenu>

-				  <guimenuitem>Panel</guimenuitem> 

-				</menuchoice>. Click on the 

-				<guilabel> Menu</guilabel> tab.</para>

-		  </listitem> 

-		  <listitem>

-			 <para>In the 

-				<guilabel>Global menu</guilabel> group, choose the appropriate

-				setting for each menu, as follows:</para>

-			 <informaltable frame="topbot"> 

-				<tgroup cols="2" colsep="0" rowsep="0"><colspec

-				  colwidth="23.47*"/><colspec colwidth="76.53*"/> 

-				  <thead> 

-					 <row rowsep="1"> 

-						<entry>

-						  <para>Option</para></entry> 

-						<entry>

-						  <para>Description </para></entry> 

-					 </row> 

-				  </thead> 

-				  <tbody> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>In the menu</guilabel></para></entry> 

-						<entry>

-						  <para> Select this option to place the items in the menu

-							 directly at the top level of the 

-							 <guimenu>Global Menu</guimenu>. </para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>In a submenu</guilabel></para></entry> 

-						<entry>

-						  <para> Select this option to place the menu as a submenu on

-							 the 

-							 <guimenu>Global Menu </guimenu>. </para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Off</guilabel></para></entry> 

-						<entry>

-						  <para>Select this option to exclude the menu from the 

-							 <guimenu>Global Menu</guimenu>.</para></entry> 

-					 </row> 

-				  </tbody> 

-				</tgroup> 

-			 </informaltable>

-		  </listitem>

-		  <listitem>

-			 <para>Click 

-				<guibutton>OK</guibutton> to save your changes. </para>

-		  </listitem>

-		</orderedlist>

-	 </sect2>

-  </sect1>

-  <sect1 id="goseditmainmenu-6"> 

-	 <title>Main Menu</title> 

-	 <indexterm>

-		<primary>menus</primary>

-		<secondary>Main Menu</secondary>

-	 </indexterm>

-	 <para>The 

-		<guimenu>Main Menu</guimenu> is represented on panels as a stylized

-		footprint icon. To open the 

-		<guimenu>Main Menu</guimenu> click on the 

-		<guibutton> Main Menu</guibutton> button.</para>

-	 <para>The 

-		<guimenu>Main Menu</guimenu> provides the same menus and functions as the

-		

-		<guimenu>Global Menu</guimenu>. The 

-		<guimenu>Main Menu</guimenu> differs from the 

-		<guimenu>Global Menu</guimenu> in the following ways:</para>

-	 <itemizedlist>

-		<listitem> 

-		  <para>A 

-			 <guimenu>Main Menu</guimenu> button is a panel object. A 

-			 <guimenu> Global Menu</guimenu> button is a panel object but you can

-			 also open the 

-			 <guimenu> Global Menu</guimenu> from anywhere on the desktop. </para>

-		</listitem>

-		<listitem> 

-		  <para>You can have many 

-			 <guimenu>Main Menu</guimenu> buttons in your panels. The structure of

-			 the menus can be different in each 

-			 <guimenu> Main Menu</guimenu>. That is, you can select how particular

-			 menus are displayed in the menu. For example you can select to display all the

-			 items in the 

-			 <guimenu> Programs</guimenu> menu at the top level of the 

-			 <guimenu>Main Menu</guimenu>. </para>

-		  <para>You can also have many 

-			 <guimenu>Global Menu</guimenu> buttons in your panels, but the

-			 structure of the menus is exactly the same in each 

-			 <guimenu> Global Menu</guimenu>.</para>

-		</listitem>

-		<listitem>

-		  <para>To customize instances of a 

-			 <guimenu>Main Menu</guimenu> you modify the properties of the 

-			 <guimenu>Main Menu</guimenu>. To customize the 

-			 <guimenu> Global Menu</guimenu> you use the <application>Control

-			 Center</application>. </para>

-		</listitem>

-	 </itemizedlist>

-	 <sect2 id="goseditmainmenu-12"> 

-		<title>To Add a Main Menu to a Panel</title> 

-		<para>You can add as many 

-		  <guimenu>Main Menu</guimenu> buttons as you want to your panels. To add

-		  a 

-		  <guimenu>Main Menu</guimenu> to a panel, right-click on any vacant

-		  space on the panel to open the 

-		  <guimenu>Global Menu</guimenu>. Choose 

-		  <menuchoice>

-			 <guimenu>Panel</guimenu>

-			 <guisubmenu> Add to panel</guisubmenu>

-			 <guisubmenu>Menu</guisubmenu>

-			 <guimenuitem>Main menu</guimenuitem>

-		  </menuchoice>.</para>

-		<note>

-		  <para>When you add a 

-			 <guimenu>Main Menu</guimenu> button to a panel, the button is added

-			 as a 

-			 <guimenu>Global Menu</guimenu>. To change the 

-			 <guimenu> Global Menu</guimenu> to a 

-			 <guimenu>Main Menu</guimenu>, right-click on the button to open the

-			 panel object popup menu. Choose 

-			 <guimenuitem>Properties </guimenuitem>. On the 

-			 <guilabel>Menu Properties</guilabel> dialog, select 

-			 <guilabel> Main menu</guilabel>. Click 

-			 <guibutton>Close</guibutton>.</para> 

-		</note>

-	 </sect2>

-	 <sect2 id="goseditmainmenu-13"> 

-		<title>To Customize a Main Menu</title> 

-		<para>You can customize each 

-		  <guimenu>Main Menu</guimenu> on your panels to help you work more

-		  efficiently. For each 

-		  <guimenu>Main Menu</guimenu>, you can specify the following:</para>

-		<itemizedlist>

-		  <listitem>

-			 <para>The menus that are on the 

-				<guimenu>Main Menu</guimenu>.</para>

-		  </listitem>

-		  <listitem> 

-			 <para>Whether the menus are in a submenu on the 

-				<guimenu>Main Menu </guimenu>.</para> 

-		  </listitem>

-		</itemizedlist>

-		<para>To customize a 

-		  <guimenu>Main Menu</guimenu> perform the following steps: </para>

-		<orderedlist>

-		  <listitem>

-			 <para>Right-click on the 

-				<guibutton>Main Menu</guibutton> to open the panel object popup

-				menu.</para> 

-		  </listitem>

-		  <listitem>

-			 <para>Choose 

-				<guimenuitem>Properties</guimenuitem> to display the 

-				<guilabel> Menu Properties</guilabel> dialog.

-				<xref linkend="goseditmainmenu-FIG-42"/> shows the 

-				<guilabel>Menu Properties</guilabel> dialog. </para>

-			 <figure id="goseditmainmenu-FIG-42"> 

-				<title>Main Menu Properties Dialog</title> 

-				<screenshot>

-				  <screeninfo>Screenshot of Main Menu Properties

-					 dialog</screeninfo> 

-				  <mediaobject>

-					 <imageobject><imagedata fileref="figures/mainmenuprop_dialog.png"

-						format="PNG"/>

-					 </imageobject>

-					 <textobject>

-						<phrase>Screenshot of Main Menu Properties dialog</phrase>

-					 </textobject>

-				  </mediaobject>

-				</screenshot>

-			 </figure>

-		  </listitem> 

-		  <listitem>

-			 <para>Choose the appropriate setting for each menu, as follows:

-				<informaltable frame="topbot"> 

-				  <tgroup cols="2" colsep="0" rowsep="0"><colspec

-					 colwidth="28.75*"/><colspec colwidth="71.25*"/> 

-					 <thead> 

-						<row rowsep="1"> 

-						  <entry>

-							 <para>Option</para></entry> 

-						  <entry>

-							 <para>Description </para></entry> 

-						</row> 

-					 </thead> 

-					 <tbody> 

-						<row> 

-						  <entry>

-							 <para>

-								<guilabel>On the main menu</guilabel></para></entry> 

-						  <entry>

-							 <para> Select this option to place the items in the menu

-								directly at the top level of the 

-								<guimenu>Main Menu</guimenu>.</para></entry> 

-						</row> 

-						<row> 

-						  <entry>

-							 <para>

-								<guilabel>In a submenu</guilabel></para></entry> 

-						  <entry>

-							 <para> Select this option to place the menu as a submenu

-								on the 

-								<guimenu>Main Menu </guimenu>.</para></entry> 

-						</row> 

-						<row> 

-						  <entry>

-							 <para>

-								<guilabel>Off</guilabel></para></entry> 

-						  <entry>

-							 <para>Select this option to exclude the menu from the 

-								<guimenu>Main Menu</guimenu>.</para></entry> 

-						</row> 

-					 </tbody> 

-				  </tgroup> 

-				</informaltable></para>

-		  </listitem>

-		  <listitem>

-			 <para>To choose a custom icon to represent the 

-				<guimenu>Main Menu </guimenu>, click on the Icon tab. Select the 

-				<guilabel>Use custom icon for panel button</guilabel> option.

-				</para> 

-			 <para>Click on the icon selector button to display an icon selector

-				dialog. Choose an icon from the dialog. Alternatively, click 

-				<guibutton>Browse</guibutton> to choose an icon from another

-				directory. When you choose an icon, click 

-				<guibutton> OK</guibutton>.</para>

-		  </listitem>

-		  <listitem>

-			 <para>Click 

-				<guibutton>OK</guibutton> to apply the changes and close the 

-				<guilabel>Menu Properties</guilabel> dialog.</para> 

-		  </listitem>

-		</orderedlist>

-	 </sect2>

-  </sect1>

-  <sect1 id="goseditmainmenu-8"> 

-	 <title>System Menus</title> 

-	 <indexterm>

-		<primary>menus</primary>

-		<secondary>system menus</secondary>

-	 </indexterm>

-	 <para>System menus contain the standard applications and standard applets

-		that you can use on your desktop.</para>

-	 <para><xref linkend="goseditmainmenu-TBL-32"/> describes the system menus

-		available on your desktop.</para> 

-	 <table frame="topbot" id="goseditmainmenu-TBL-32"> 

-	 <title>System Menus</title> 

-	 <tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="26.43*"/><colspec

-		colwidth="73.57*"/> 

-		<thead> 

-		  <row rowsep="1"> 

-			 <entry>

-				<para>Menu</para></entry> 

-			 <entry>

-				<para>Description</para></entry> 

-		  </row> 

-		</thead> 

-		<tbody> 

-		  <row> 

-			 <entry>

-				<para>

-				  <guimenu>Programs</guimenu></para></entry> 

-			 <entry>

-				<para> Contains all applications and configuration tools. The 

-				  <guimenu>Programs</guimenu> menu contains a hierarchy of submenus

-				  such as 

-				  <guimenu>Applications</guimenu> and 

-				  <guimenu>Settings</guimenu>, from which you can start the

-				  standard GNOME applications and configuration tools. The 

-				  <guimenu>Programs</guimenu> menu also includes the file manager

-				  and <application>GNOME Help Browser</application>. </para>

-				<para>The 

-				  <guimenu>Programs</guimenu> menu resides in the following places:

-				  </para>

-				<itemizedlist>

-				  <listitem>

-					 <para>

-						<guimenu>Global Menu</guimenu></para>

-				  </listitem>

-				  <listitem>

-					 <para>

-						<guimenu>Main Menu</guimenu></para> 

-				  </listitem>

-				  <listitem>

-					 <para>

-						<guimenu>Root</guimenu> menu</para>

-				  </listitem> 

-				  <listitem>

-					 <para>On the Menu Panel, in modified form</para>

-				  </listitem>

-				</itemizedlist></entry> 

-		  </row> 

-		  <row> 

-			 <entry>

-				<para>

-				  <guimenu>Applets</guimenu></para></entry> 

-			 <entry>

-				<para>The 

-				  <guimenu> Applets</guimenu> menu contains all of the applets that

-				  are installed on your system. To add an applet to a panel open the 

-				  <guimenu>Global Menu</guimenu> from the panel, then choose the

-				  applet from the 

-				  <guimenu>Applets</guimenu> menu. </para>

-				<para>The 

-				  <guimenu>Applets</guimenu> menu resides in the following

-				  places:</para>

-				<itemizedlist>

-				  <listitem>

-					 <para>

-						<guimenu>Global Menu</guimenu></para> 

-				  </listitem>

-				  <listitem>

-					 <para>

-						<guimenu>Main Menu</guimenu></para>

-				  </listitem> 

-				  <listitem>

-					 <para>On the Menu Panel, in the 

-						<guimenu>Programs</guimenu> menu </para>

-				  </listitem>

-				</itemizedlist></entry> 

-		  </row> 

-		</tbody> 

-	 </tgroup> 

-	 </table> 

-	 <para>Your system administrator specifies the contents of system menus.

-		Typically, all users on a system have access to the system menus. The 

-		<guimenu>Programs </guimenu> menu corresponds to the

-		<filename>$GNOME_BASEDIR/share/gnome/apps </filename> directory. The 

-		<guimenu>Applets</guimenu> menu corresponds to the

-		<filename>$GNOME_BASEDIR/share/applets</filename> directory. </para>

-	 <sect2 id="goseditmainmenu-33"> 

-		<title>To Edit a System Menu</title> 

-		<para>You can edit the contents of the system menus only if you have the

-		  appropriate system privileges. You can use the <application>Menu

-		  Editor</application> to edit the system menus. You can also open the system

-		  menus and right-click on menu items to open a popup menu that enables you to

-		  edit the system menus. </para>

-	 </sect2>

-  </sect1>

-  <sect1 id="goseditmainmenu-9"> 

-	 <title>Favorites Menu</title> 

-	 <indexterm>

-		<primary>menus</primary>

-		<secondary>Favorites Menu</secondary>

-	 </indexterm>

-	 <para>The 

-		<guimenu>Favorites</guimenu> menu resides in the following places:

-		</para>

-	 <itemizedlist>

-		<listitem>

-		  <para>

-			 <guimenu>Global Menu</guimenu></para>

-		</listitem>

-		<listitem>

-		  <para>

-			 <guimenu>Main Menu</guimenu></para> 

-		</listitem>

-		<listitem>

-		  <para>Menu Panel</para>

-		</listitem>

-	 </itemizedlist>

-	 <para>You can add items that you frequently use to your 

-		<guimenu>Favorites </guimenu> menu, and organize the items into submenus.

-		Your 

-		<guimenu>Favorites </guimenu> menu contains only items that you add.

-		</para>

-	 <para>The 

-		<guimenu>Favorites</guimenu> menu contains items that are not shared, but

-		are specific to each individual user. The 

-		<guimenu>Favorites</guimenu> menu corresponds to a directory in your

-		private home directory, the <filename> ~/.gnome/apps</filename> directory. This

-		structure contrasts with system menus, which are usually shared by many users

-		and which reside in a public directory. </para>

-	 <sect2 id="goseditmainmenu-48"> 

-		<title>To Edit the Favorites Menu</title> 

-		<para>You can use the <application>Menu Editor</application> to edit the

-		  contents of your 

-		  <guimenu>Favorites</guimenu> menu. You can also open menus and

-		  right-click on menu items to open a popup menu that enables you to add items to

-		  the 

-		  <guimenu> Favorites</guimenu> menu. If you right-click on a menu item

-		  in the 

-		  <guimenu> Favorites</guimenu> menu, you can remove the item from the 

-		  <guimenu>Favorites </guimenu> menu. </para>

-	 </sect2>

-  </sect1> 

-  <sect1 id="goseditmainmenu-10"> 

-	 <title>Custom Menus</title> 

-	 <indexterm>

-		<primary>menus</primary>

-		<secondary>customs menus</secondary>

-	 </indexterm>

-	 <para>A custom menu is menu that you create. You can create a custom menu

-		in any directory to which you have write access. If you want to create a menu

-		to share with other users, you can create a custom menu in a public location.

-		You can then inform other users of the location of the custom menu. The other

-		users can then open their file manager and drag the menu to their panels, where

-		the menu is added as a menu object. </para>

-	 <para>You must create a custom menu manually. To create a menu manually you

-		must first understand the structure of menus, and their relationship to

-		directories and special files. </para>

-	 <sect2 id="goseditmainmenu-27"> 

-		<title>To Create a Custom Menu</title> 

-		<para>To create a custom menu follow these steps:</para>

-		<orderedlist>

-		  <listitem> 

-			 <para>Create the directory for the menu. The name that you choose for

-				the directory becomes the name of the menu. </para>

-		  </listitem>

-		  <listitem>

-			 <para>Create a <filename>.directory</filename> file and a <filename>

-				.order</filename> file for the menu, and add the files to the menu directory.

-				You can copy the <filename>.directory</filename> file and <filename>.order

-				</filename> files from another menu directory, then edit the files to suit your

-				requirements.</para>

-		  </listitem>

-		  <listitem>

-			 <para>Create <filename>.desktop</filename> files for the menu, and

-				add the files to the menu directory. You can copy the

-				<filename>.desktop</filename> files from another menu directory, then edit the

-				files to suit your requirements. </para>

-		  </listitem>

-		  <listitem>

-			 <para>Your menu is now complete. To add the menu to a panel drag the

-				menu directory from your file manager to the panel.</para>

-		  </listitem>

-		</orderedlist>

-		<tip>

-		  <para>You can also use the <application>Menu Editor</application> to

-			 create a custom menu. Use the <application>Menu Editor</application> to create

-			 the custom menu in your 

-			 <guimenu>Favorites</guimenu> menu. The <application> Menu

-			 Editor</application> creates the <filename>.order</filename> and <filename>

-			 .directory</filename> files. Move the custom menu structure to the required

-			 location.</para>

-		</tip> 

-	 </sect2>

-	 <sect2 id="goseditmainmenu-45"> 

-		<title>To Edit a Custom Menu</title> 

-		<para>If you have permissions to write to the custom menu files, you can

-		  open the custom menu and right-click on menu items to open a popup menu. The

-		  popup menu enables you to edit the custom menu.</para>

-		<para>You can also edit the custom menu manually. To edit a menu manually

-		  you must first understand the structure of menus on your desktop.</para>

-	 </sect2>

-  </sect1>

-  <sect1 id="goseditmainmenu-35"> 

-	 <title>Menu Editor</title> 

-	 <indexterm>

-		<primary>menus</primary>

-		<secondary>Menu Editor</secondary>

-	 </indexterm>

-	 <para>This section describes how to edit your menus.</para>

-	 <sect2 id="goseditmainmenu-37"> 

-		<title>Introduction to the Menu Editor </title> 

-		<para>You can use the <application>Menu Editor</application> to edit your

-		  menus. If you are a system administrator, you can use the <application>Menu

-		  Editor</application> to edit the system menus. If you are a normal user, you

-		  can use the <application>Menu Editor</application> to edit your 

-		  <guimenu> Favorites</guimenu> menu.</para>

-		<para>You can use the <application>Menu Editor</application> to add the

-		  following items to your menus: </para>

-		<itemizedlist>

-		  <listitem> 

-			 <para>Submenus</para>

-		  </listitem>

-		  <listitem>

-			 <para>Launchers</para>

-		  </listitem> 

-		  <listitem>

-			 <para>Applets</para>

-		  </listitem>

-		</itemizedlist>

-		<para>You can also add further items to your submenus. This feature

-		  enables you to create a hierarchical menu structure for your launchers and

-		  applets. </para>

-		<para><xref linkend="goseditmainmenu-FIG-44"/> shows the

-		  <application>Menu Editor</application>.</para>

-		<figure id="goseditmainmenu-FIG-44"> 

-		  <title>Menu Editor</title> 

-		  <screenshot>

-			 <screeninfo>Annotated screenshot of a Menu Editor window</screeninfo>

-			 <mediaobject>

-				<imageobject><imagedata

-				  fileref="figures/menu_editor_anno_window.png" format="PNG"/>

-				</imageobject>

-				<textobject>

-				  <phrase>Annotated screenshot of a Menu Editor window</phrase>

-				</textobject>

-			 </mediaobject>

-		  </screenshot>

-		</figure> 

-		<para>The <application>Menu Editor</application> contains the following

-		  elements: </para> 

-		<table frame="topbot" id="goseditmainmenu-TBL-33"> 

-		<title>Menu Editor Elements</title> 

-		<tgroup cols="2" colsep="0" rowsep="0"><colspec

-		  colwidth="30.45*"/><colspec colname="COLSPEC1" colwidth="77.85*"/> 

-		  <thead> 

-			 <row rowsep="1"> 

-				<entry>

-				  <para>Element</para></entry> 

-				<entry colname="COLSPEC1">

-				  <para> Description</para></entry> 

-			 </row> 

-		  </thead> 

-		  <tbody> 

-			 <row> 

-				<entry>

-				  <para>Menubar</para></entry> 

-				<entry colname="COLSPEC1">

-				  <para>Contains commands that you use to perform tasks in the

-					 <application>Menu Editor</application>. These commands are in the 

-					 <guimenu>File</guimenu>, 

-					 <guimenu>Sort</guimenu>, and 

-					 <guimenu>Help</guimenu> menus. </para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>Toolbar</para></entry> 

-				<entry colname="COLSPEC1">

-				  <para>Contains buttons that you use to perform tasks in the

-					 <application>Menu Editor</application>. For example, the toolbar contains 

-					 <guibutton>New Submenu</guibutton>, 

-					 <guibutton> New Item</guibutton>, and 

-					 <guibutton>Delete</guibutton> buttons.</para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>Menu tree pane</para></entry> 

-				<entry colname="COLSPEC1">

-				  <para> Displays the hierarchical structure of your menus. You can

-					 expand and collapse the menus in the menu tree pane. </para>

-				  <para>You use the menu tree pane to select the menu that you want

-					 to edit.</para>

-				  <para>The menu tree also includes a popup menu that you can use

-					 to perform tasks in the <application>Menu Editor</application>. To use this

-					 popup menu, right-click on the item that you want to edit, then choose a menu

-					 item. </para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>Dialog pane</para></entry> 

-				<entry colname="COLSPEC1">

-				  <para> Contains a dialog with a 

-					 <guilabel>Basic</guilabel> tabbed section and an 

-					 <guilabel> Advanced</guilabel> tabbed section. Use this dialog

-					 to add and modify submenus and submenu items.</para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>Comment statusbar</para></entry> 

-				<entry colname="COLSPEC1">

-				  <para> Displays information on the item selected in the menu

-					 tree. This information is usually the same as the 

-					 <guilabel>Comment</guilabel> information for the

-					 item.</para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>Directory statusbar</para></entry> 

-				<entry colname="COLSPEC1">

-				  <para> Displays the directory location of the item selected in

-					 the menu tree.</para></entry> 

-			 </row> 

-			 <row> 

-				<entry>

-				  <para>Resize button</para></entry> 

-				<entry colname="COLSPEC1">

-				  <para> Drag this button to resize the menu tree pane and dialog

-					 pane areas.</para></entry> 

-			 </row> 

-		  </tbody> 

-		</tgroup> 

-		</table> 

-	 </sect2>

-	 <sect2 id="goseditmainmenu-49"> 

-		<title>To Start the Menu Editor</title> 

-		<para>To start the <application>Menu Editor</application> perform one of

-		  the following actions:</para>

-		<itemizedlist>

-		  <listitem>

-			 <para>Open the 

-				<guimenu>Global Menu</guimenu>. Choose 

-				<menuchoice>

-				  <guimenu>Programs</guimenu>

-				  <guisubmenu>Settings</guisubmenu>

-				  <guimenuitem>Menu editor</guimenuitem>

-				</menuchoice>.</para> 

-		  </listitem>

-		  <listitem>

-			 <para>Right-click on a 

-				<guibutton>Global Menu</guibutton> or a 

-				<guibutton> Main Menu</guibutton> to open a panel object popup

-				menu. Choose 

-				<guimenuitem> Edit menus</guimenuitem>.</para>

-		  </listitem>

-		</itemizedlist> 

-	 </sect2>

-	 <sect2 id="goseditmainmenu-38"> 

-		<title>To Add a Submenu</title> 

-		<para>To add a submenu perform the following steps:</para>

-		<orderedlist>

-		  <listitem> 

-			 <para>In the menu tree, select the menu to which you want to add a

-				submenu.</para> 

-		  </listitem>

-		  <listitem>

-			 <para>Choose 

-				<menuchoice>

-				  <guimenu>File</guimenu> 

-				  <guimenuitem> New Submenu</guimenuitem>

-				</menuchoice>. A 

-				<guilabel>New Folder</guilabel> icon is added to the menu tree. A

-				dialog for entering details of the new submenu is displayed in the dialog

-				pane.</para>

-		  </listitem>

-		  <listitem>

-			 <para>Enter the information for the submenu in the 

-				<guilabel>Basic</guilabel> tabbed section on the dialog pane. The

-				following table describes the dialog elements on the 

-				<guilabel>Basic</guilabel> tabbed section:</para>

-			 <informaltable frame="topbot"> 

-				<tgroup cols="2" colsep="0" rowsep="0"><colspec

-				  colwidth="29.60*"/><colspec colwidth="70.40*"/> 

-				  <thead> 

-					 <row rowsep="1"> 

-						<entry>

-						  <para>Dialog Element</para></entry> 

-						<entry>

-						  <para>Description </para></entry> 

-					 </row> 

-				  </thead> 

-				  <tbody> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Name</guilabel></para></entry> 

-						<entry>

-						  <para>Use this text box to specify the name of the submenu.

-							 You can use the 

-							 <guilabel> Advanced</guilabel> tabbed section to add

-							 translations of the name. </para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Comment</guilabel></para></entry> 

-						<entry>

-						  <para> Use this text box to specify a short description of

-							 the submenu. The description is displayed as a tooltip when you point to the

-							 submenu icon. You can use the 

-							 <guilabel>Advanced</guilabel> tabbed section to add

-							 translations of the short description.</para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Command</guilabel></para></entry> 

-						<entry>

-						  <para> Not required for a submenu.</para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Type</guilabel></para></entry> 

-						<entry>

-						  <para>The 

-							 <guilabel> Type</guilabel> of a submenu must be 

-							 <guilabel>Directory</guilabel>. You cannot change the 

-							 <guilabel>Type</guilabel> of a submenu.</para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Icon</guilabel></para></entry> 

-						<entry>

-						  <para>Choose an icon to represent the submenu. To choose an

-							 icon, click on the icon selector button. An icon selector dialog is displayed.

-							 Choose an icon from this dialog. Alternatively, to choose an icon from another

-							 directory, click 

-							 <guibutton> Browse</guibutton>. When you choose an icon,

-							 click 

-							 <guibutton>OK</guibutton>. </para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Run in Terminal</guilabel></para></entry> 

-						<entry>

-						  <para> Not required for a submenu.</para></entry> 

-					 </row> 

-				  </tbody> 

-				</tgroup> 

-			 </informaltable>

-		  </listitem>

-		  <listitem>

-			 <para>You can also add a translation of the 

-				<guilabel>Name</guilabel> and 

-				<guilabel>Comment</guilabel> information for the submenu. To add a

-				translation, click on the 

-				<guilabel>Advanced</guilabel> tab. Enter the details of the

-				translation in the 

-				<guilabel>Name/Comment translations</guilabel> table as follows:

-				</para>

-			 <informaltable frame="topbot"> 

-				<tgroup cols="2" colsep="0" rowsep="0"><colspec

-				  colwidth="27.48*"/><colspec colwidth="72.52*"/> 

-				  <thead> 

-					 <row rowsep="1"> 

-						<entry>

-						  <para>Field</para></entry> 

-						<entry>

-						  <para>Description </para></entry> 

-					 </row> 

-				  </thead> 

-				  <tbody> 

-					 <row> 

-						<entry>

-						  <para>First field</para></entry> 

-						<entry>

-						  <para>Enter the two-letter code for the language for which

-							 you want to add a translation.</para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>Second field</para></entry> 

-						<entry>

-						  <para>Enter the translation of the 

-							 <guilabel>Name</guilabel> text box.</para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>Third field</para></entry> 

-						<entry>

-						  <para>Enter the translation of the 

-							 <guilabel>Comment</guilabel> text box.</para></entry> 

-					 </row> 

-				  </tbody> 

-				</tgroup> 

-			 </informaltable>

-			 <para>Click on the 

-				<guibutton>Add/Set</guibutton> button. </para> 

-			 <para>To edit a translation, select the translation in the 

-				<guilabel>Name/Comment translations</guilabel> table. The

-				translated text is displayed in the fields under the table. Edit the fields as

-				required, then click on the 

-				<guibutton> Add/Set</guibutton> button.</para>

-			 <para>To remove a translation, select the translation in the 

-				<guilabel>Name/Comment translations</guilabel> table, then click 

-				<guibutton>Remove</guibutton>. </para>

-			 <note>

-				<para>The 

-				  <guilabel>Try this before using</guilabel> text box and 

-				  <guilabel> Documentation</guilabel> text box are not required for

-				  a submenu. </para>

-			 </note>

-		  </listitem>

-		  <listitem> 

-			 <para>Click 

-				<guibutton>Save</guibutton> to save the details of the new

-				submenu.</para> 

-			 <para>Alternatively, click 

-				<guibutton>Revert</guibutton> to return to your previously saved

-				menu structure.</para>

-		  </listitem>

-		</orderedlist>

-	 </sect2>

-	 <sect2 id="goseditmainmenu-39"> 

-		<title>To Add an Item to a Submenu </title> 

-		<para>To add an item to a submenu perform the following steps:</para>

-		<orderedlist> 

-		  <listitem>

-			 <para>In the menu tree, select the menu to which you want to add the

-				item. </para>

-		  </listitem>

-		  <listitem>

-			 <para>Choose 

-				<menuchoice>

-				  <guimenu>File</guimenu>

-				  <guimenuitem> New Item</guimenuitem>

-				</menuchoice>. An 

-				<guilabel>untitled</guilabel> icon is added to the menu tree. A

-				dialog where you can enter details of the new item is displayed in the dialog

-				pane.</para>

-		  </listitem>

-		  <listitem>

-			 <para>Enter the information for the item in the 

-				<guilabel>Basic</guilabel> tabbed section in the dialog pane. The

-				following table describes the dialog elements on the 

-				<guilabel>Basic</guilabel> tabbed section:</para>

-			 <informaltable frame="topbot"> 

-				<tgroup cols="2" colsep="0" rowsep="0"><colspec

-				  colwidth="29.81*"/><colspec colwidth="70.19*"/> 

-				  <thead> 

-					 <row rowsep="1"> 

-						<entry>

-						  <para>Dialog Element</para></entry> 

-						<entry>

-						  <para>Description </para></entry> 

-					 </row> 

-				  </thead> 

-				  <tbody> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Name</guilabel></para></entry> 

-						<entry>

-						  <para>Use this text box to specify the name of the item.

-							 You can use the 

-							 <guilabel> Advanced</guilabel> tab to add translations of

-							 the name.</para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Comment</guilabel></para></entry> 

-						<entry>

-						  <para> Use this text box to specify a short description of

-							 the item. When you point to the item, the comment is displayed as a tooltip.

-							 You can use the 

-							 <guilabel> Advanced</guilabel> tabbed section to add

-							 translations of the comment. </para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Command</guilabel></para></entry> 

-						<entry>

-						  <para> Enter the command to run when you choose the item.

-							 You can also enter a URL if you choose 

-							 <guilabel>URL</guilabel> as the 

-							 <guilabel>Type</guilabel>.</para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Type</guilabel></para></entry> 

-						<entry>

-						  <para>Choose from the following types of list item:</para>

-						  <itemizedlist> 

-							 <listitem>

-								<para>

-								  <guilabel>Application</guilabel>: Choose this list

-								  item for an application launcher. </para>

-							 </listitem>

-							 <listitem>

-								<para>

-								  <guilabel>PanelApplet</guilabel>: Choose this list

-								  item for an applet launcher.</para>

-							 </listitem>

-							 <listitem> 

-								<para>

-								  <guilabel>URL</guilabel>: Choose this list item to

-								  create a launcher that opens an Internet browser at a particular URL.</para>

-							 </listitem>

-						  </itemizedlist></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Icon</guilabel></para></entry> 

-						<entry>

-						  <para>Choose an icon to represent the item. To choose an

-							 icon, click on the 

-							 <guibutton> Icon</guibutton> button. An icon selector

-							 dialog is displayed. Choose an icon from this dialog. Alternatively, to choose

-							 an icon from another directory, click 

-							 <guibutton>Browse</guibutton>.</para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Run in Terminal</guilabel></para></entry> 

-						<entry>

-						  <para> Select this option to run the application or command

-							 in a terminal window. Choose this option for an application or command that

-							 does not create a window in which to run.</para></entry> 

-					 </row> 

-				  </tbody> 

-				</tgroup> 

-			 </informaltable>

-		  </listitem>

-		  <listitem>

-			 <para>Enter the advanced properties of the item in the dialog. The

-				following table describes the fields on the top part of the 

-				<guilabel>Advanced</guilabel> tabbed section:</para>

-			 <informaltable frame="topbot"> 

-				<tgroup cols="2" colsep="0" rowsep="0"><colspec

-				  colwidth="37.84*"/><colspec colwidth="62.16*"/> 

-				  <thead> 

-					 <row rowsep="1"> 

-						<entry>

-						  <para>Field</para></entry> 

-						<entry>

-						  <para>Description </para></entry> 

-					 </row> 

-				  </thead> 

-				  <tbody> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Try this before using</guilabel></para></entry>

-						

-						<entry>

-						  <para>Enter a command here for your system to try before

-							 starting the item. If the system can execute this command, the item is not

-							 displayed on the submenu.</para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>

-							 <guilabel>Documentation</guilabel></para></entry> 

-						<entry>

-						  <para> This field is not currently in use.</para></entry> 

-					 </row> 

-				  </tbody> 

-				</tgroup> 

-			 </informaltable>

-		  </listitem>

-		  <listitem>

-			 <para>You can also add a translation of the 

-				<guilabel>Name</guilabel> and 

-				<guilabel>Comment</guilabel> information for the item. To add a

-				translation, click on the 

-				<guilabel>Advanced</guilabel> tab. Enter the details of the

-				translation in the 

-				<guilabel>Name/Comment translations</guilabel> table as follows:

-				</para>

-			 <informaltable frame="topbot"> 

-				<tgroup cols="2" colsep="0" rowsep="0"><colspec

-				  colwidth="31.71*"/><colspec colwidth="68.29*"/> 

-				  <thead> 

-					 <row rowsep="1"> 

-						<entry>

-						  <para>Field</para></entry> 

-						<entry>

-						  <para>Description </para></entry> 

-					 </row> 

-				  </thead> 

-				  <tbody> 

-					 <row> 

-						<entry>

-						  <para>First field</para></entry> 

-						<entry>

-						  <para>Enter the two-letter code for the language for which

-							 you want to add a translation.</para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>Second field</para></entry> 

-						<entry>

-						  <para>Enter the translation of the 

-							 <guilabel>Name</guilabel> of the item.</para></entry> 

-					 </row> 

-					 <row> 

-						<entry>

-						  <para>Third field</para></entry> 

-						<entry>

-						  <para>Enter the translation of the 

-							 <guilabel>Comment</guilabel> for the item.

-							 </para></entry> 

-					 </row> 

-				  </tbody> 

-				</tgroup> 

-			 </informaltable>

-			 <para>Then click on the 

-				<guibutton>Add/Set</guibutton> button. </para> 

-			 <para>To edit a translation, select the translation in the 

-				<guilabel>Name/Comment translations</guilabel> table. The

-				translated text is displayed in the fields under the table. Make your edits in

-				the fields, then click on the 

-				<guibutton> Add/Set</guibutton> button.</para>

-			 <para>To remove a translation, select the translation in the 

-				<guilabel>Name/Comment translations</guilabel> table, then click 

-				<guibutton>Remove</guibutton>.</para>

-		  </listitem>

-		  <listitem>

-			 <para>Click 

-				<guibutton>Save</guibutton> to save the details of the new

-				item.</para>

-			 <para>Alternatively, click 

-				<guibutton>Revert</guibutton> to return to your previously saved

-				menu.</para>

-		  </listitem>

-		</orderedlist>

-	 </sect2> 

-	 <sect2 id="goseditmainmenu-40"> 

-		<title>To Modify a Submenu or Submenu Item</title> 

-		<para>To modify a submenu or submenu item perform the following

-		  steps:</para> 

-		<orderedlist>

-		  <listitem>

-			 <para>In the menu tree, select the menu or menu item that you want to

-				modify. The details of the menu or menu item are displayed in the dialog

-				pane.</para>

-		  </listitem>

-		  <listitem>

-			 <para>In the dialog pane, modify the dialog elements.</para>

-		  </listitem>

-		  <listitem>

-			 <para>Click 

-				<guibutton>Save</guibutton> to save your changes to the

-				submenu.</para>

-			 <para>Alternatively, click 

-				<guibutton>Revert</guibutton> to undo your changes.</para>

-		  </listitem>

-		</orderedlist>

-	 </sect2>

-	 <sect2 id="goseditmainmenu-41"> 

-		<title>To Move a Submenu or Submenu Item </title> 

-		<para>To move a submenu or submenu item perform one of the following

-		  actions: </para> 

-		<itemizedlist>

-		  <listitem>

-			 <para>To move the submenu or submenu item to another menu, drag the

-				submenu or submenu item to the new location in the menu tree. </para> 

-		  </listitem>

-		  <listitem>

-			 <para>To move the submenu or submenu item within a menu, select the

-				menu that you want to move. Click on the 

-				<guibutton>Move up</guibutton> or 

-				<guibutton>Move down</guibutton> toolbar buttons to move the item.

-				Repeat this step until the submenu or item is in the new location. </para>

-		  </listitem> 

-		</itemizedlist>

-	 </sect2>

-	 <sect2 id="goseditmainmenu-42"> 

-		<title>To Delete a Submenu or Submenu Item </title> 

-		<para>To delete a submenu or submenu item, select the item that you want

-		  to delete in the menu tree. Choose 

-		  <menuchoice>

-			 <guimenu>File</guimenu> 

-			 <guimenuitem>Delete</guimenuitem>

-		  </menuchoice>. The item is deleted from the menu. </para>

-	 </sect2>

-	 <sect2 id="goseditmainmenu-43"> 

-		<title>To Sort a Submenu</title> 

-		<para>The <application>Menu Editor</application> includes commands that

-		  enable you to sort your menus alphabetically. You can sort the items in a

-		  particular menu. You can also sort menus recursively. In other words, you can

-		  sort all of the submenus and submenu items that a menu contains.</para>

-		<para>To sort a submenu, select the menu that you want to sort in the

-		  menu tree. Choose 

-		  <menuchoice> 

-			 <guimenu>Sort</guimenu>

-			 <guimenuitem>Sort Submenu</guimenuitem>

-		  </menuchoice>. To perform a recursive sort, choose 

-		  <menuchoice>

-			 <guimenu>Sort</guimenu> 

-			 <guimenuitem>Sort Submenu Recursive</guimenuitem>

-		  </menuchoice>.</para>

-	 </sect2> 

-	 <sect2 id="goseditmainmenu-44"> 

-		<title>To Quit the Menu Editor</title> 

-		<para>To quit the <application>Menu Editor</application>, choose 

-		  <menuchoice> 

-			 <guimenu>File</guimenu>

-			 <guimenuitem>Exit</guimenuitem>

-		  </menuchoice>.</para> 

-	 </sect2>

-  </sect1>

-</chapter> 
\ No newline at end of file
+
+
+
+<chapter id="goseditmainmenu-1">
+<title>Working With Menus</title>
+<highlights><para>This chapter describes how to use menus in the desktop.
+</para></highlights>
+<sect1 id="goseditmainmenu-2">
+<title>Introduction to Menus</title>
+<indexterm><primary>menus</primary><secondary>introduction</secondary></indexterm>
+<para>You can access all desktop functions through menus. The default panels
+contain menus, so you can use a combination of menus and panels to perform
+your tasks. You can perform various actions on your menus, such as copy menu
+items to panels.</para>
+<para>You can access the following menus from the desktop:</para>
+<itemizedlist>
+<listitem><para><guimenu>Applications</guimenu> menu: You can access many
+of the applications, commands, and configuration options on your desktop from
+the <guimenu>Applications</guimenu> menu.</para></listitem>
+<listitem><para><guimenu>Actions</guimenu> menu: You can access various desktop
+commands from the <guimenu>Actions</guimenu> menu. For example, you can start
+the <application>Search Tool</application> application, or log out from the
+desktop. </para></listitem>
+<listitem><para><guimenu>GNOME Menu</guimenu>: You can also access the items
+in the <guimenu>Applications</guimenu> and <guimenu>Actions</guimenu> menus
+from the <guimenu>GNOME Menu</guimenu>. You can have many <guimenu>GNOME Menu
+</guimenu> buttons in your panels. </para></listitem>
+</itemizedlist>
+<para>You can also right-click on the desktop background to open the <guimenu>
+Desktop Background</guimenu> menu. The <guimenu>Desktop Background</guimenu>
+menu enables you to perform desktop background-related tasks. For information
+on the <guimenu>Desktop Background</guimenu> menu, see <xref linkend="gosdeskback-1"/>.
+</para>
+<para>All of these menus provide you with multiple ways to perform your tasks,
+and enable you to work in the way that you prefer.</para>
+</sect1>
+<sect1 id="goseditmainmenu-5">
+<title>Menu Features</title>
+<indexterm><primary>menus</primary><secondary>features</secondary></indexterm>
+<para>Menus can contain the following items: </para>
+<itemizedlist>
+<listitem><para>Submenus</para></listitem>
+<listitem><para>Launchers</para></listitem>
+</itemizedlist>
+<para>An arrow to the right of an item in a menu indicates that the item is
+a submenu. When you point to the submenu, the submenu opens. You can choose
+items from the submenu. </para>
+<para>When you choose a launcher, the launcher starts an application or runs
+a command. You can also right-click on a launcher to open a popup menu. The
+popup menu enables you to add the item to a panel, and perform other tasks.
+For more information on the popup menu, see the next section. </para>
+<para>You can change the theme for your session to change how all your menus
+look. To change the theme, choose <menuchoice><guimenu>Applications
+</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>
+Theme</guimenuitem></menuchoice>.</para>
+<sect2 id="goseditmainmenu-11">
+<title>Launcher Popup Menu</title>
+<indexterm><primary>menus</primary><secondary>launcher popup menu</secondary>
+</indexterm><indexterm><primary>launcher popup menu</primary><secondary>description
+</secondary></indexterm><para>Launchers on menus have an associated popup
+menu that enables you to perform tasks related to launchers. When you right-click
+on a launcher in a menu, the popup menu for the launcher opens. The popup
+menu also contains a submenu that allows you to perform menu-related tasks. 
+</para>
+<para>You can use the launcher popup menu to perform the following tasks: 
+</para>
+<itemizedlist>
+<listitem><para>Add launchers to panels. </para></listitem>
+<listitem><para>Remove launchers from menus. </para></listitem>
+<listitem><para>Open the <guilabel>Run Program</guilabel> dialog with the
+launcher command in the dialog.</para></listitem>
+<listitem><para>Add menus to panels. You can add a menu as a menu object or
+as a drawer object. </para></listitem>
+<listitem><para>Add new items to menus.</para></listitem>
+<listitem><para>Change the properties of submenus and launchers.</para></listitem>
+</itemizedlist>
+<para>Some items in the popup menu might not be available to you. Your user
+privileges determine which items are available. For example, if you do not
+have system administrator privileges, you can not modify the properties of
+the <guimenu>Applications</guimenu> menu. </para>
+<para><xref linkend="goseditmainmenu-FIG-39"/> shows the popup menu.</para>
+<indexterm><primary>launcher popup menu</primary><secondary>illustration</secondary>
+</indexterm>
+<figure id="goseditmainmenu-FIG-39">
+<title>Launcher Popup Menu</title>
+<screenshot>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figures/launcher_popup.png" format="PNG"/>
+  </imageobject>
+  <textobject>
+	<phrase>Shows launcher popup menu. The context describes the graphic.
+</phrase>
+  </textobject>
+</mediaobject>
+</screenshot>
+</figure>
+<para><xref linkend="goseditmainmenu-TBL-30"/> describes the items on launcher
+popup menus. <indexterm><primary>launchers</primary><secondary>adding to panel
+</secondary></indexterm></para>
+<table frame="topbot" id="goseditmainmenu-TBL-30">
+<title>Items on Launcher Popup Menus</title>
+<tgroup cols="2" colsep="0" rowsep="0"><colspec colname="COLSPEC0" colwidth="42.71*"/>
+<colspec colname="COLSPEC1" colwidth="57.29*"/>
+<thead>
+<row rowsep="1"><entry valign="top"><para>Item</para></entry><entry valign="top"><para>
+Description</para></entry></row>
+</thead>
+<tbody>
+<row><entry valign="top"><para><guimenuitem>Add this launcher to panel</guimenuitem></para></entry>
+<entry valign="top"><para>Adds the launcher to the panel from which you open
+the menu.</para></entry></row>
+<row><entry valign="top"><para><guimenuitem>Remove this item</guimenuitem></para></entry>
+<entry valign="top"><para>Removes the launcher from the menu.</para></entry>
+</row>
+<row><entry valign="top"><para><guimenuitem>Put into run dialog</guimenuitem></para></entry>
+<entry valign="top"><para>Displays the <guilabel>Run Program</guilabel> dialog
+with  the command from the <guilabel>Command</guilabel> field of the launcher
+in  the command field on the <guilabel>Run Program</guilabel> dialog. </para></entry>
+</row>
+<row><entry colname="COLSPEC0"><para><guimenuitem>Help on <replaceable>application_name
+</replaceable></guimenuitem></para></entry><entry colname="COLSPEC1"><para>
+Open the online help for the application.</para></entry></row>
+<row><entry valign="top"><para><guimenuitem>Properties</guimenuitem></para></entry>
+<entry valign="top"><para>Displays a dialog that enables you to edit the properties
+of the launcher.</para></entry></row>
+<row><entry colname="COLSPEC0" valign="top"><para><menuchoice><guimenu>Entire
+menu</guimenu><guimenuitem>Add this as drawer to panel</guimenuitem>
+</menuchoice></para></entry><entry colname="COLSPEC1" valign="top"><para>
+Adds the submenu as a drawer to the panel from which you open the menu.</para></entry>
+</row>
+<row><entry colname="COLSPEC0" valign="top"><para><menuchoice><guimenu>Entire
+menu</guimenu><guimenuitem>Add this as menu to panel</guimenuitem>
+</menuchoice></para></entry><entry colname="COLSPEC1" valign="top"><para>
+Adds the submenu as a menu object to the panel from which you open the menu.
+</para></entry></row>
+<row><entry colname="COLSPEC0" valign="top"><para><menuchoice><guimenu>Entire
+menu</guimenu><guimenuitem>Add new item to this menu</guimenuitem>
+</menuchoice></para></entry><entry colname="COLSPEC1" valign="top"><para>
+Enables you to add an item to the submenu.</para></entry></row>
+<row><entry colname="COLSPEC0" valign="top"><para><menuchoice><guimenu>Entire
+menu</guimenu><guimenuitem>Properties</guimenuitem></menuchoice></para></entry>
+<entry colname="COLSPEC1" valign="top"><para>Displays a dialog that enables
+you to edit the properties of the submenu.</para></entry></row>
+</tbody>
+</tgroup>
+</table>
+<indexterm><primary>menus</primary><secondary>adding to panel</secondary>
+</indexterm></sect2>
+</sect1>
+<sect1 id="goseditmainmenu-8">
+<title>Applications Menu</title>
+<indexterm><primary>menus</primary><secondary>Applications</secondary></indexterm>
+<para>The <guimenu>Applications</guimenu> menu contains a hierarchy of submenus,
+from which you can start the standard GNOME applications and preference tools.
+The <guimenu>Applications</guimenu> menu also includes the file manager and
+the help browser.</para>
+<para>The <guimenu>Applications</guimenu> menu resides in the following places: 
+</para>
+<itemizedlist>
+<listitem><para>Menu Panel</para></listitem>
+<listitem><para><guilabel>Start Here</guilabel> location in <application>
+Nautilus</application></para></listitem>
+<listitem><para><guimenu>GNOME Menu</guimenu></para></listitem>
+</itemizedlist>
+</sect1>
+<sect1 id="goseditmainmenu-51">
+<title>Actions Menu</title>
+<indexterm><primary>menus</primary><secondary>Actions</secondary></indexterm>
+<para>The <guimenu>Actions</guimenu> menu contains various desktop commands. <xref
+linkend="goseditmainmenu-TBL-52"/> describes the commands in the <guimenu>
+Actions</guimenu> menu.</para>
+<table frame="topbot" id="goseditmainmenu-TBL-52">
+<title>Actions Menu Commands</title>
+<tgroup cols="2" colsep="0" rowsep="0"><colspec colwidth="38.48*"/><colspec
+colwidth="61.52*"/>
+<thead>
+<row rowsep="1"><entry valign="top"><para>Menu Item</para></entry><entry valign="top"><para>
+Function</para></entry></row>
+</thead>
+<tbody>
+<row><entry valign="top"><para><guimenuitem>Run Program</guimenuitem></para></entry>
+<entry valign="top"><para>Opens the <guilabel>Run Program</guilabel> dialog.
+Use the <guilabel>Run Program</guilabel> dialog to run commands. For more
+information, see <xref linkend="gospanel-23"/>.</para></entry></row>
+<row><entry valign="top"><para><guimenuitem>Search for Files</guimenuitem></para></entry>
+<entry valign="top"><para>Starts the <application>Search Tool</application>
+application. For more information, see the <citetitle>Search Tool</citetitle>
+manual.</para></entry></row>
+<row><entry valign="top"><para><guimenuitem>Take a Screen Shot</guimenuitem></para></entry>
+<entry valign="top"><para>Opens the <guilabel>Screenshot</guilabel> dialog.
+Use the <guilabel>Screenshot</guilabel> to take screenshots of your desktop.
+</para></entry></row>
+<row><entry valign="top"><para><guimenuitem>Lock Display</guimenuitem></para></entry>
+<entry valign="top"><para>Locks your screen. For more information, see <xref
+linkend="gosstartsession-1"/>.</para></entry></row>
+<row><entry valign="top"><para><guimenuitem>Log Out</guimenuitem></para></entry>
+<entry valign="top"><para>Logs you out of the current session. For more information,
+see <xref linkend="gosgetstarted-73"/>.</para></entry></row>
+</tbody>
+</tgroup>
+</table>
+<para>The <guimenu>Actions</guimenu> menu resides in the following places: 
+</para>
+<itemizedlist>
+<listitem><para>Menu Panel. </para></listitem>
+<listitem><para><guimenu>GNOME Menu</guimenu>. The items in the <guimenu>
+Actions</guimenu> menu are at the top level of the <guimenu>GNOME Menu</guimenu>.
+</para></listitem>
+</itemizedlist>
+<sect2 id="gospanel-23">
+<title>Using the Run Program Dialog</title>
+<indexterm><primary>Run Program dialog, using</primary></indexterm>
+<para>The <guilabel>Run Program</guilabel> dialog gives you access to the
+command line. When you run a command in the <guilabel>Run Program</guilabel>
+dialog, you cannot receive output from the command.</para>
+<para>To run a command from the command line perform the following steps: 
+</para>
+<orderedlist>
+<listitem><para>Display the <guilabel>Run Program</guilabel> dialog. You can
+display the <guilabel>Run Program</guilabel> dialog in any of the following
+ways:<itemizedlist>
+<listitem><para>From the Menu Panel</para>
+<para>Choose <menuchoice><guimenu>Actions</guimenu><guimenuitem>Run
+Program</guimenuitem></menuchoice>.</para></listitem>
+<listitem><para>From the <guimenu>GNOME Menu</guimenu></para>
+<para>Open the <guimenu>GNOME Menu</guimenu>, then choose <guimenuitem>Run
+Program</guimenuitem>.</para></listitem>
+<listitem><para>Use a shortcut key</para>
+<para>The default shortcut key to display the <guilabel>Run Program</guilabel>
+dialog is <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. You can change the shortcut
+key that displays the <guilabel>Run Program</guilabel> dialog in the <application>
+Desktop Preferences</application>. To change the shortcut key, choose <menuchoice>
+<guimenu>Applications</guimenu><guisubmenu>Desktop Preferences
+</guisubmenu><guimenuitem>Keyboard Shortcuts</guimenuitem></menuchoice>.</para>
+</listitem>
+<listitem><para>From a launcher popup menu</para>
+<para>Right-click on a launcher in a menu, then choose <guilabel>Put into
+run dialog</guilabel> from the popup menu. The <guilabel>Run Program</guilabel>
+dialog opens with the command from the menu in the command field.</para></listitem>
+</itemizedlist></para>
+<para>The <guilabel>Run Program</guilabel> dialog is displayed as follows:
+</para>
+<screenshot>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figures/runprogram_dialog.png" format="PNG"/>
+  </imageobject>
+  <textobject>
+	<phrase>Shows Run Program dialog. Contains applications drop-down combination box, Run in terminal check box. Contains Append File, Help, Close, Run buttons. Contains Known Applications button.
+</phrase>
+  </textobject>
+</mediaobject>
+</screenshot>
+</listitem>
+<listitem><para>Choose the command that you want to run from the applications
+drop-down combination box.</para>
+<para>Alternatively, click on the <guibutton>Known Applications</guibutton>
+button to display a list of available applications, as shown in the following
+figure:</para>
+<screenshot>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figures/runprogram2_dialog.png" format="PNG"/>
+  </imageobject>
+  <textobject>
+	<phrase>Shows Run Program dialog, with advanced options. Contains applications drop-down combination box, Run in terminal check box. Contains Append File, Help, Close, Run buttons. Contains expanded Known Applications list.
+</phrase>
+  </textobject>
+</mediaobject>
+</screenshot>
+<para>Enter the command that you want to run in the blank field. Alternatively,
+to choose  a command that you ran previously, click the down arrow button,
+then choose the command to run.</para>
+<para>You can also use the <guibutton>Append File</guibutton> button to choose
+a file to append to the command line. For example, you can enter <application>
+emacs</application> as the command, then choose a file to edit.</para>
+<para>Select the <guilabel>Run in terminal</guilabel> option to run the application
+or command in a terminal window. Choose this option for an application or
+command that does not create a window in which to run.</para></listitem>
+<listitem><para>Click on the <guibutton>Run</guibutton> button on the <guilabel>
+Run Program</guilabel> dialog. </para></listitem>
+</orderedlist>
+</sect2>
+</sect1>
+<sect1 id="goseditmainmenu-7">
+<title>GNOME Menu</title>
+<indexterm><primary>menus</primary><secondary>GNOME Menu</secondary><see>
+GNOME Menu</see></indexterm><indexterm><primary>GNOME Menu</primary><secondary>
+introduction</secondary></indexterm>
+<screenshot>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figures/open_main_menu.png" format="PNG"/>
+  </imageobject>
+  <textobject>
+	<phrase>Shows open GNOME Menu. Menu items: Programs, Favorites, Applets, Run, Panel, Lock Screen, Log Out.
+</phrase>
+  </textobject>
+</mediaobject>
+</screenshot>
+<para>You can access almost all of the standard applications, commands, and
+configuration options on your desktop from the <guimenu>GNOME Menu</guimenu>. 
+</para>
+<para>The <guimenu>GNOME Menu</guimenu> provides the following top-level menus
+and special menu items: </para>
+<itemizedlist>
+<listitem><para><guimenu>Applications</guimenu>: Contains all applications
+and preference tools. This menu also includes the file manager and help browser.
+</para></listitem>
+<listitem><para><guimenu>Actions</guimenu>: Contains desktop commands the <guimenuitem>
+Lock screen</guimenuitem> and <guimenuitem>Log out</guimenuitem> menu items.
+By default, the items in the <guimenu>Desktop</guimenu> menu are at the top
+level of the <guimenu>GNOME Menu</guimenu>. </para></listitem>
+<listitem><para><guimenuitem>Run</guimenuitem> launcher: Displays the <guilabel>
+Run Program</guilabel> dialog. </para></listitem>
+</itemizedlist>
+<para>You can add <guimenu>GNOME Menu</guimenu> buttons to your panels. By
+default, the <guimenu>GNOME Menu</guimenu> is represented on panels by a stylized
+footprint icon, as follows:</para>
+<screenshot>
+<mediaobject>
+  <imageobject>
+    <imagedata fileref="figures/footprint_icon.png" format="PNG"/>
+  </imageobject>
+  <textobject>
+	<phrase>Shows GNOME Menu icon.</phrase>
+  </textobject>
+</mediaobject>
+</screenshot>
+<sect2 id="goseditmainmenu-15">
+<title>To Open the GNOME Menu</title>
+<indexterm><primary>GNOME Menu</primary><secondary>opening</secondary></indexterm>
+<para>You can open the <guimenu>GNOME Menu</guimenu> in the following ways: 
+</para>
+<itemizedlist>
+<listitem><para>From a panel with a <guimenu>GNOME Menu</guimenu></para>
+<para>Click on the <guimenu>GNOME Menu</guimenu>. </para></listitem>
+<listitem><para>Use a shortcut key</para>
+<para>You can use a shortcut key to open the <guimenu>GNOME Menu</guimenu>.
+When you use a shortcut key to open the <guimenu>GNOME Menu</guimenu>, the <guimenu>
+GNOME Menu</guimenu> appears at the mouse pointer. </para>
+<para>The default shortcut key to open the <guimenu>GNOME Menu</guimenu> is <keycombo><keycap>Alt</keycap><keycap>F1</keycap></keycombo>. To change the shortcut key that opens
+the <guimenu>GNOME Menu</guimenu>, choose <menuchoice><guimenu>Applications
+</guimenu><guisubmenu>Desktop Preferences</guisubmenu><guimenuitem>
+Keyboard Shortcuts</guimenuitem></menuchoice>.</para></listitem>
+</itemizedlist>
+</sect2>
+<sect2 id="goseditmainmenu-29">
+<title>To Add a GNOME Menu to a Panel</title>
+<indexterm><primary>GNOME Menu</primary><secondary>adding to panel</secondary>
+</indexterm><para>You can add as many <guimenu>GNOME Menu</guimenu> buttons
+as you want to your panels. To add a <guimenu>GNOME Menu</guimenu> to a panel,
+right-click on any vacant space on the panel to open the panel popup menu.
+Choose <menuchoice><guimenu>Add to panel</guimenu><guimenuitem>GNOME
+Menu</guimenuitem></menuchoice>.</para>
+</sect2>
+</sect1>
+</chapter>
+