diff options
Diffstat (limited to 'gnome2-user-guide/C/goseditmainmenu.xml')
| -rw-r--r-- | gnome2-user-guide/C/goseditmainmenu.xml | 1682 |
1 files changed, 1682 insertions, 0 deletions
diff --git a/gnome2-user-guide/C/goseditmainmenu.xml b/gnome2-user-guide/C/goseditmainmenu.xml new file mode 100644 index 0000000..2d53d73 --- /dev/null +++ b/gnome2-user-guide/C/goseditmainmenu.xml @@ -0,0 +1,1682 @@ +<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 |