<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE sect2 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
                "http://www.docbook.org/xml/4.3/docbookx.dtd">

<sect2 id="gimp-command-name">
<title><!-- command name --></title>

  <indexterm><primary><!-- command name --></primary></indexterm>

  <!--
    General description of what the command is good for and how it
    can be used in the creative process
  -->
  <para>
    The <quote><!-- command name --></quote> command is
  </para>
  <!--
    Description of how to activate the command
  -->

  <sect3>
    <title>Activating the Command</title>
    <!--
      No <itemizedlist><listitem> if only one reference
    -->
    <itemizedlist>
      <listitem>
        <para>
          You can access this command from the image menubar through
          <menuchoice>
            <guimenu></guimenu>
            <guisubmenu></guisubmenu>
            <guimenuitem></guimenuitem>
          </menuchoice>.
        </para>
      </listitem>
      <listitem>
        <para>
          <!-- Possibly another way to access-->
        </para>
      </listitem>
    </itemizedlist>
  </sect3>


  <!--
    The next section describes the options of the command. If it hasn't
    any, remove this part
  -->
  <sect3>
    <title>Options</title>

    <para>
      <!--
        Describe how the command options are organized in general.
        This part is optional, but helps if the command options dialog is a bit
        more complex e.g. has some tabs etc.
       -->
    </para>


    <!--
      If the dialog is organized in tabs, there is one level 4 section for
      the options outside of the tabs (mostly the preview) and one level 4
      section for each tab.
      If the dialog is not tabbed, just remove the level 4 sections
    -->
    <sect4>
      <title><!-- Preview domain / <quote>tab-name</quote> Options tab --></title>

      <figure>
        <title>
          <quote><!-- command name --></quote><!-- tab name --> options tab
        </title>
        <mediaobject>
          <imageobject>
            <imagedata format="PNG"
              fileref="images/menus/submenu/subsubmenu/name-tab.png" />
          </imageobject>
          <!-- or: images/menus/submenu/subsubmenu/name-tab-options.png" -->
        </mediaobject>
      </figure>

      <para><!-- Describe what the preview/tab is good for --></para>

      <!-- The following list contains one item per option. -->
      <variablelist>
        <varlistentry>
          <term><!-- name of the option / gui-element --></term>

          <listitem>
            <para>
              <!-- Description of the option / gui-element -->
            </para>
          </listitem>
        </varlistentry>
        <!-- next option / gui-element -->
      </variablelist>
    </sect4>
    <!-- next options tab -->


    <!--
      If the dialog is not tabbed, use the following structure to describe
      the options and gui elements.
      Otherwise remove content down to the end of the level 3 section.
    -->
    <figure>
      <title>
        <quote><!-- command name --></quote> options
      </title>
      <mediaobject>
        <imageobject>
          <imagedata format="PNG"
            fileref="images/menus/submenu/subsubmenu/name.png" />
        </imageobject>
        <!-- or: images/menus/submenu/subsubmenu/name-options.png" -->
      </mediaobject>
    </figure>

    <!-- The following list contains one item per option. -->
    <variablelist>
      <varlistentry>
        <term><!-- name of the option / gui-element --></term>
        <listitem>
          <para>
            <!-- Description of the option / gui-element -->
          </para>
        </listitem>
      </varlistentry>
      <!-- next option / gui-element -->
    </variablelist>
  </sect3>
</sect2>
