<sect2 id="usage-menus">
  <title>Organizing actions in menus</title>
  <para>
    As your list of actions will grow, you most probably will want to
    organize them into menus, submenus, and so on.
  </para>
  <para>
    In order to create a new menu, choose
    <menuchoice>
      <!-- i18n: "File" is a menu item -->
      <guimenu>File</guimenu>
      <!-- i18n: "New menu" is a menu item -->
      <guimenuitem>New menu</guimenuitem>
    </menuchoice>.
  </para>
  <para>
    A menu may be created anywhere in the list of your actions, but
    inside of an action (<abbrev>i.e.</abbrev> not between two profiles
    of an action).
  </para>
  <para>
    As an action, the exact place where a new menu will be inserted
    depends on the current sort order:
  </para>
  <variablelist>
    <varlistentry>
      <term>
        Manual order:
      </term>
      <listitem>
        <para>
          The new menu is inserted just before the current action or
          menu.
        </para>
        <para>
          This place will not change when you later modify the label of
          the menu.
        </para>
      </listitem>
    </varlistentry>
    <varlistentry>
      <term>
        Ascending (resp. descending) alphabetical order:
      </term>
      <listitem>
        <para>
          The new menu is inserted at the correct place, regarding the
          <!-- i18n: "New Nautilus menu" is a UI label -->
          default &laquosp;<literal>New Nautilus menu</literal>&spraquo;
          label.
        </para>
        <para>
          This place will be automatically changed, each time you modify
          the label of the menu.
        </para>
      </listitem>
    </varlistentry>
  </variablelist>
  <para>
    As an action, too, a menu requires a label, and may have an icon and
    a tooltip. Also, you may define some conditions in order your menu
    be candidate to be displayed in &nautilus; context menu. If the
    defined conditions are not met at runtime, then your whole menu,
    including its submenus, its actions and so on, will not be displayed.
  </para>
</sect2>
