<?xml version="1.0" encoding="utf-8"?>
<sect2 id="usage-sorting">
  <title>Sorting the items list</title>
  <para>
    Your actions and menus will be displayed in file manager context
    menus in the same order that they are listed in the
    <!-- i18n: "Items list" is a UI label -->
    <guilabel>Items list</guilabel>,
    on the left pane of the main <application>Caja-Actions Configuration Tool</application> window.
  </para>
  <para>
    You may decide to:
  </para>
  <itemizedlist>
    <listitem>
      <para>
        sort your actions and menus in ascending or descending
        alphabetical order of their label,
      </para>
    </listitem>
    <listitem>
      <para>
        or do not sort, and manually organize your actions and menus
        in your own order.
      </para>
    </listitem>
  </itemizedlist>

  <sect3 id="usage-sorting-alpha">
    <title>Alphabetically sorting your actions and menus</title>
    <para>
      In these modes, actions and menus are sorted depending of their
      label, inside of their parent. 
    </para>
    <figure id="cact-FIG-sort-buttons">
      <title>Sort buttons in the main window</title>
      <screenshot>
        <mediaobject>
          <imageobject>
            <imagedata fileref="figures/sort-buttons-frame.png" format="PNG"/>
          </imageobject>
          <textobject>
            <phrase>Shows the three sort buttons in the main window.</phrase>
          </textobject>
        </mediaobject>
      </screenshot>
    </figure>
    <para>
      You may sort your actions by:
    </para>
    <itemizedlist>
      <listitem>
        <para>Click on <guibutton><inlinegraphic fileref="figures/sort-asc.png"/></guibutton>(<abbrev>resp.)</abbrev><guibutton><inlinegraphic fileref="figures/sort-desc.png"/></guibutton>button to sort your actions in ascending (<abbrev>resp.</abbrev> descending) order.</para>
      </listitem>
      <listitem>
        <para>
          Or edit the corresponding preference.
        </para>
      </listitem>
    </itemizedlist>
  </sect3>

  <sect3 id="usage-sorting-manual">
    <title>Manually organizing your actions and menus</title>
    <para>
      When items are manually sorted in the list, new items are usually
      inserted just at the current position.
    </para>
    <para>
      There is nonetheless the case where an action is
      selected, and not expanded (or has currently only one profile).
      Inserting a new profile will not insert it before the action,
      but inside of the action. 
    </para>
    <para>
      To choose this mode:
    </para>
    <itemizedlist>
      <listitem>
        <para>
          Click on
          <guibutton><inlinegraphic fileref="figures/sort-manual.png"/></guibutton>
          button.
        </para>
      </listitem>
      <listitem>
        <para>
          Or edit the corresponding preference.
        </para>
      </listitem>
    </itemizedlist>
  </sect3>
</sect2>
