<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 the file manager 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>
