<page xmlns="http://projectmallard.org/1.0/"
      type="topic" style="task"
      id="gedit-plugins-sort">

<info>
  <link type="guide" xref="gedit-plugin-guide#gedit-default-plugins"/>
  <revision pkgversion="3.8" date="2013-02-24" status="review"/>
  <credit type="author">
    <name>Daniel Neel</name>
    <email>dneelyep@gmail.com</email>
  </credit>
  <credit type="author">
    <name>Jim Campbell</name>
    <email>jwcampbell@gmail.com</email>
  </credit>
  <credit type="editor">
    <name>Sindhu S</name>
    <email>sindhus@live.in</email>
  </credit>
  <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
  <desc>Sort lines of text into alphabetical order</desc>
</info>

<title>Sort</title>

  <p>The Sort plugin arranges selected lines of text into alphabetical
  order.</p>

  <note style="warning">
    <p>You cannot use the <gui>Undo</gui> feature to correct a <gui>Sort</gui>
  operation, so we recommend that you save the file immediately before
  performing the sort. If you make a mistake with the sort, you can revert to
  the previously-saved version of the file by selecting
  <guiseq><gui>File</gui><gui>Revert</gui></guiseq>.</p>
</note>

  <section id="enable-sort">
    <title>Enable Sort Plugin</title>

    <p>To enable the <app>Sort</app> plugin:</p>

    <steps>
      <item>
        <p>Select <guiseq><gui style="menu">gedit</gui>
        <gui style="menuitem">Preferences</gui>
        <gui style="tab">Plugins</gui></guiseq>.</p>
      </item>
      <item>
        <p>Select <gui style="menuitem">Sort</gui> to enable the plugin.</p>
      </item>
    </steps>

  </section>

  <section id="using-sort">
    <title>Using Sort Plugin</title>

    <p>To use the <gui>Sort</gui> plugin:</p>

    <steps>
      <item>
        <p>Drag and highlight the desired lines of text.</p>
      </item>
      <item>
        <p>Select <guiseq><gui style="menu">gedit</gui>
        <gui style="menuitem">Sort</gui></guiseq>.</p>
      </item>
      <item>
        <p>The <gui>Sort</gui> dialog will open, allowing you to choose between
        several sorting options:</p>
        <list>
          <item>
            <p><gui>Reverse order</gui> will arrange the text in reverse
            alphabetical order.</p>
          </item>
          <item>
            <p><gui>Remove duplicates</gui> will remove duplicate values from
            the list.</p>
          </item>
          <item>
            <p><gui>Ignore case</gui> will ignore case sensitivity.</p>
            <note style="tip">
              <p>To have the sort ignore the characters at the start of the
              lines, set the first character that should be used for sorting in
              the <gui>Start at</gui> column spin box.</p>
            </note>
          </item>
        </list>
      </item>
      <item>
        <p>To perform the sort operation, click <gui>Sort</gui>.</p>
      </item>
    </steps>
  </section>

</page>