<chapter id="commands" >
  <title>Command Reference</title>
  <sect1 id="kxstitch-menus" >
    <title>&kapp; Menus</title>
    <sect2>
      <title>The File Menu</title>
      <para>
        <variablelist>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>n</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>New</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Creates a new pattern, using the default values set in the pattern properties dialog.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>o</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Open</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Opens an existing pattern</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>r</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Open Recent</guimenuitem>
              </menuchoice></term>
            <listitem>
              <simpara>
                <action>Open a recently used pattern</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>s</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Save</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Saves the pattern</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>a</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Save As</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Saves the document under a new name</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>p</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Print</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Print the pattern</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Insert Background Image</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Insert an image as a background for tracing.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Clear Background Image</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Clears the current background image.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>File Properties</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Display / Edit the document properties</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Import Image File</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Import a graphics file</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Scan Image</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Scan an image</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>w</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Close</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Close the pattern</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>q</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Quit</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Quits</action>
                &kapp;
              </simpara>
            </listitem>
          </varlistentry>
        </variablelist>
      </para>
    </sect2>
    <sect2>
      <title>The Edit Menu</title>
      <para>
        <variablelist>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>z</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Undo</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Undo the last stitching action</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>Shift</keycap>
                    <keycap>z</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Redo</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Redo the last operation undone</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>x</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Cut</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Cut the selected area to the clipboard</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>c</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Copy</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Copy the selected area to the clipboard</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>v</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Paste</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Paste the selected area</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Stitch Selection Mask</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Limit selections to the currently selected stitch type</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Colour Selection Mask</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Limit selections to the currently selected colour</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Exclude Backstitches</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Exclude backstitches from the selection</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Exclude Knots</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Exclude Knots from the selection</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Mirror / Rotate makes copies</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>If set, the mirror and rotate functions will make a copy of the selection,
                        otherwise the selected area is moved</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Mirror selection vertically</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Mirrors the selected area vertically, i.e. flipped from top to bottom</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Mirror selection horizontally</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Mirror the selected area horizontally, i.e. flipped from left to right</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Rotate selection 90 degrees</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Rotate the selected area anti clockwise 90 degrees</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Rotate selection 180 degrees</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Rotate the selected area anti clockwise 180 degrees</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Rotate selection 270 degrees</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Rotate the selected area anti clockwise 270 degrees</action>
              </simpara>
            </listitem>
          </varlistentry>
        </variablelist>
      </para>
      <sect3>
        <title>Cut, Copy and Paste</title>
        <para>
          Cutting and copying areas of the pattern can make use of stitch and colour masks and the exclusion of backstitches and knots
          to limit the selection.
        </para>
        <para>
          The paste operation in &kapp; allows you to press and hold the &LMB; down roughly in the position that
          the paste data is to go which will provide an image of the paste data to allow accurate positioning before
          releasing the mouse button to finalise the position.  This technique is also used for the mirroring and
          rotate functions.
        </para>
        <para>
          A note about the clipboard.  As well as supplying stitch information that can be pasted into any instance
          of &kapp;, it also provides data in several image formats suitable for pasting into other Qt based applications.
        </para>
      </sect3>
    </sect2>
    <sect2>
      <title>The View Menu</title>
      <para>
        <variablelist>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Fit To Page</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Zoom the view so that the whole pattern fits within the visible area</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Fit To Page Width</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Zoom the view so that the patterns width fits within the visible area</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Fit To Page Height</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Zoom the view so that the patterns height fits within the visible area</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>Shift</keycap>
                    <keycap>+</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Zoom In</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Zoom in on the editor view</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <shortcut>
                  <keycombo>
                    <keycap>Ctrl</keycap>
                    <keycap>Shift</keycap>
                    <keycap>-</keycap>
                  </keycombo>
                </shortcut>
                <guimenuitem>Zoom Out</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Zoom out on the editor view</action>
              </simpara>
            </listitem>
          </varlistentry>
        </variablelist>
      </para>
    </sect2>
    <sect2>
      <title>The Stitch Menu</title>
      <para>
        These items select the stitch to be used for painting on the canvas.
        <variablelist>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Full</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Full Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Left to Right Half Stitch</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Half Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Right to Left Half Stitch</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Half Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Bottom Left 1/4 Stitch</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Quarter Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Bottom Right 1/4 Stitch</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Quarter Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Top Left 1/4 Stitch</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Quarter Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Top Right 1/4 Stitch</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Quarter Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Bottom Left 3/4 Stitch</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Three Quarter Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Bottom Right 3/4 Stitch</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Three Quarter Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Top Left 3/4 Stitch</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Three Quarter Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Top Right 3/4 Stitch</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Three Quarter Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>French Knot</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>French Knot Stitch</action>
              </simpara>
            </listitem>
          </varlistentry>
        </variablelist>
      </para>
    </sect2>
    <sect2>
      <title>The Tool Menu</title>
      <para>
        <variablelist>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Paint</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Paint stitches onto the canvas - Press down the &LMB; and drag around the window.
                  Stitches will be added to each cell passed over. Release the mouse button to stop painting.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Draw</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Draw a line of stitches onto the canvas - Press down the &LMB; at the start of the line,
                  drag to the required end point of the line and release the mouse button. Stitches will be added to
                  each cell that the line passes through.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Erase</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Erase stitches - Press down the &LMB; and drag over the stitches to be deleted. All stitches
                  within the cells passed over will be removed. Release the mouse button to stop erasing.  To erase backstitches
                  hold down the CTRL key and left click in the start or end point of the backstitch, if there is more than one backstitch
                  at the digitised point this method will erase the first one found.  To delete a specific backstitch, click and
                  drag from one end to the other. To erase french knots hold down the SHIFT key and left click on the knot to delete it.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Outline Rectangle</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Draw a rectangle - Press down the &LMB; at one corner of the rectangle and drag to the
                  opposite corner. Release the mouse button and an unfilled rectangle of stitches will be added to the
                  canvas.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Filled Rectangle</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Draw a filled rectangle - Press down the &LMB; at one corner of the rectangle and drag to the
                  opposite corner. Release the mouse button and a filled rectangle of stitches will be added to the canvas.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Outline Ellipse</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Draw an ellipse - Press down the &LMB; at one corner of the ellipse and drag to the
                  opposite corner. Release the mouse button and an unfilled ellipse of stitches will be added to the
                  canvas.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Filled Ellipse</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Draw a filled ellipse - Press down the &LMB; at one corner of the ellipse and drag to the
                  opposite corner. Release the mouse button and a filled ellipse of stitches will be added to the canvas.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Filled Polyline</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Draw a filled polyline - Click on each cell marking the vertices of the polyline, click and drag to create more complex
                  curves.  The starting point will be indicated by a red circle. Each of the other vertices are marked by a green circle with
                  a black line joining them. To close the polyline click on the starting cell again.  You can use the backspace key to remove
                  the last point, or the Esc key to remove all vertices.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Alphabet Text</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Insert patterns from the currently selected library that match the keys pressed.
                  This allows the creation of pattern alphabets that can have a key assignment.  After selecting this tool
                  and clicking a position on the pattern for the insertion point, each key pressed will be searched for in
                  the current library for a matching pattern.  If found this will be inserted at the position on the pattern
                  and the insertion position then advanced by the width of the inserted character pattern.  The pattern
                  space will be extended right to allow further characters to be entered.  Pressing Enter will start a new
                  line under the position of the original insertion point, the pattern space will be extended downwards
                  to accomodate the new line if insufficient space is available.  Backspace will delete the last character entered
                  and the space key will advance the insertion point by either the width of a space character in the library
                  or a predetermined amount if no space character exists.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Insert Text</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Insert text in stitches. This invokes the text dialog.  Select the font required and the size, enter the text
                  and click OK.  Press the &LMB; roughly where you would like the text, move the mouse to position
                  the text accuratly and then release the mouse button.  This is the same as the paste funtion.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Select Rectangle</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Select a rectangular region - Press down the &LMB; at one corner of the rectangle, drag
                  to the opposite corner and release the button. A marching ant boundary line will show the selected area.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Backstitching</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Add backstitching to the canvas - Press down the &LMB; at the start of the backstitch,
                  it will snap to the closest of 9 points in the cell, drag to the end point of the backstitch and release
                  the mouse button, again this will snap to the nearest of 9 points in the cell.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
        </variablelist>
      </para>
    </sect2>
    <sect2>
      <title>The Palette Menu</title>
      <para>
        <variablelist>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Palette Manager</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Add and remove colours to the current palette.  Assign symbols and the number of strands
                  for the stitching and backstitching.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Show Symbols</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Show the symbols associated with each colour</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Pick Colour</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Select colour from palette that matches a selection from the canvas - Click the mouse button in a
                  cell to select the colour in the palette that matches the stitch in the cell. If there is more than
                  one type of stitch in a cell, preference is given to the currently selected stitch type if one exists
                  in this cell.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Save Palette</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Saves the current palette to a seperate file. This allows several patterns to be created based on a
                  common palette without having to recreate it each time. In the dialog, just enter the name you want
                  to use for the new palette.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Load Palette</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Load a previously saved palette. This includes the default palettes, DMC for example.
                  Be aware that for large palettes, at this time there are not enough symbols for all
                  the flosses.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Create Palette</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Create a new palette from scratch. Enter a name for the new palette, then use the
                  Add colours dialog with the New colour button to add colours.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Clear Unused</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Clear the unused colours from the current palette.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Swap Colours</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>The next colour selected will be swapped with the currently select colour. If you select the eye dropper
                tool, you can choose the colour to be swapped with directly from the pattern.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Replace Colour</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>The next colour selected will replace the currently selected colour. As with swap colours, you can use the
                eye dropper tool to select the colour from the pattern.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Calibrate Colours</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Show the calibrate colours dialog and allows modifications to the colour values.</action>
              </simpara>
            </listitem>
          </varlistentry>
        </variablelist>
      </para>
    </sect2>
    <sect2>
      <title>The Pattern Menu</title>
      <para>
        <variablelist>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Extend Pattern</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Extend the pattern top, left, right and bottom</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Center Pattern</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Center the pattern in the canvas</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Crop Canvas To Pattern</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Crop the canvas to the extents of the pattern</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Crop Canvas To Selection</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Crop the canvas to the extents of the current selection</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Fit Background To Selection</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Resize the background image to fit in the selection area. As any background image is
                  normally scaled to cover the entire canvas, this may be used to resize and position the background
                  image just where you want it.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
        </variablelist>
      </para>
    </sect2>
    <sect2>
      <title>The Library Menu</title>
      <para>
        <variablelist>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Pattern Libraries</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Open the pattern library manager which is a non modal dialog allowing the creation and
                                 use of libraries of patterns or alphabets.  Drag and drop is available to allow the dragging and
                                 dropping of patterns from the library to the pattern.  Automatic conversion of flosses to suit the
                                 current pattern and scaling of the image to the current pattern scale for accurate positioning.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
        </variablelist>
      </para>
    </sect2>
    <sect2>
      <title>The Settings Menu</title>
      <para>
        <variablelist>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Format Stitches As</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Change the way stitches are displayed.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Format Scales As</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Change the scale display format to Stitches, CM or Inches.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Show Toolbar</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Show / Hide the main toolbar.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Show Stitch Toolbar</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Show / Hide the stitch toolbar.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Show Tool Toolbar</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Show / Hide the Tools toolbar.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Show Status Bar</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Show / Hide the status bar.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Configure &kapp;</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>
                  Allow changes to the configuration of &kapp;, in addition to the
                  set as default options on some dialogs.
                </action>
              </simpara>
            </listitem>
          </varlistentry>
        </variablelist>
      </para>
    </sect2>
    <sect2>
      <title>The Help Menu</title>
      <para>
        <variablelist>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>&kapp; Handbook</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Display this help.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>What's This.</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Display help on a particular feature.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>Report Bug.</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Fill out a bug report.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>About &kapp;</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Display some information about &kapp;.</action>
              </simpara>
            </listitem>
          </varlistentry>
          <varlistentry>
            <term>
              <menuchoice>
                <guimenuitem>About KDE</guimenuitem>
              </menuchoice>
            </term>
            <listitem>
              <simpara>
                <action>Display some information about KDE.</action>
              </simpara>
            </listitem>
          </varlistentry>
        </variablelist>
      </para>
    </sect2>
  </sect1>
</chapter>
