<?xml version="1.0" encoding="utf-8"?>
<?db.chunk.max_depth 3?>
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:db="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="tools" xml:lang="en-CA">
    <info><title xml:lang="en">Tools and Utilities</title></info>

  <highlights>
    <para xml:lang="en">This section describes some tools and utilities in the MATE Desktop.</para>
  </highlights>

  <section xml:id="tools-run-app"><info><title xml:lang="en">Running Applications</title></info>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor xml:id="gospanel-23"/>
    <indexterm xml:lang="en">
      <primary>Run Application dialog, using</primary>
    </indexterm>
    <para xml:lang="en">
      The <guilabel>Run Application</guilabel> dialog gives you access to the command
      line. When you run a command in the <guilabel>Run Application</guilabel> dialog,
      you cannot receive output from the command.
    </para>
    <para xml:lang="en">
    To run a command from the command line perform the following steps:</para>
    <orderedlist>
      <listitem>
        <para xml:lang="en">Open the <guilabel>Run Application</guilabel> dialog in any of the
        following ways:
        <variablelist>
          <varlistentry><term xml:lang="en">From a panel</term>
          <listitem><para xml:lang="en">You can add the <application>Run Application</application> button to any 
          panel. See <xref linkend="panels-addobject"/>. Click on the <guibutton>Run Application</guibutton> 
          panel button to open the <guilabel>Run Application</guilabel> dialog.</para></listitem></varlistentry>
          <varlistentry><term xml:lang="en">Using shortcut keys</term>
          <listitem>
            <para xml:lang="en">
              Press <keycombo><keycap>Alt</keycap><keycap>F2</keycap></keycombo>. You can change 
              the shortcut keys that display the <guilabel>Run Application</guilabel> dialog
              in the <application><xref linkend="prefs-keyboard-shortcuts"/></application> tool.
            </para>
          </listitem>
          </varlistentry>
        </variablelist>
      </para>
      <para xml:lang="en">The <guilabel>Run Application</guilabel> dialog is displayed.</para>
    </listitem>
    <listitem>
      <para xml:lang="en">Enter the command that you want to run in the blank field, or choose from the list of known applications.</para>
      <para xml:lang="en">If you enter only the location of a file, an appropriate application will launch to open it.
      If you enter a web page address, your default web browser will open the page. Prefix the web page address with https://, as in https://mate-desktop.org.
      </para>
      <para xml:lang="en">
        To choose a command that you ran previously, click the
        down arrow button beside the command field, then choose the command to run.
      </para>
      <para xml:lang="en">
      You can also use the <guibutton>Run with file</guibutton> button to
      choose a file to append to the command line. For example, you can enter 
      <application>emacs</application> as the command, then choose a file to edit.
      </para>
      <para xml:lang="en">Select the <guilabel>Run in terminal</guilabel> option to run the application
      or command in a terminal window. Choose this option for an application or
      command that does not create a window in which to run.</para>
    </listitem>
    <listitem>
      <para xml:lang="en">Click on the <guibutton>Run</guibutton> button on the <guilabel>Run Application</guilabel> dialog. </para>
    </listitem>
      </orderedlist>
  </section>

<section xml:id="tools-screenshot"><info><title xml:lang="en">Taking Screenshots</title></info>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor xml:id="goseditmainmenu-53"/>
  <indexterm xml:lang="en">
    <primary>screenshots, taking</primary>
  </indexterm>
  <para xml:lang="en">You can take a screenshot in any of the following ways:</para>
  <itemizedlist>
    <listitem>
      <para xml:lang="en">From any panel</para>
      <para xml:lang="en">You can add a <guibutton>Take Screenshot</guibutton> button to any panel. For instructions on how to do this, see <xref linkend="panels-addobject"/>. Click on the <guibutton>Take Screenshot</guibutton> button to take
a screenshot of the entire screen.</para>
    </listitem>
    <listitem>
      <para xml:lang="en">Use shortcut keys</para>
      <para xml:lang="en">To take a screenshot, use the following shortcut keys:</para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="35.67*"/>
          <colspec colname="colspec1" colwidth="64.33*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para xml:lang="en">Default Shortcut Keys</para>
              </entry>
              <entry>
                <para xml:lang="en">Function</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <keycap>Print Screen</keycap>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot of the entire screen.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en"><keycombo><keycap>Alt</keycap><keycap>Print Screen</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot of the window which is active.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para xml:lang="en">You can use the <application><xref linkend="prefs-keyboard-shortcuts"/></application> tool to modify the default shortcut keys.</para>
    </listitem>
    <listitem>
      <para xml:lang="en">From the Menubar</para>
      <para xml:lang="en">Choose <menuchoice><guimenu>Applications</guimenu><guimenuitem>Accessories</guimenuitem>
      <guimenuitem>Take Screenshot</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para xml:lang="en">From the Terminal</para>
      <para xml:lang="en">
        You can use the <command>mate-screenshot</command> command to
        take a screenshot. The <command>mate-screenshot</command> command takes
        a screenshot of the entire screen, and displays the <guilabel>Save Screenshot</guilabel> 
        dialog. Use the <guilabel>Save Screenshot</guilabel> dialog to save the screenshot.
      </para>
      <para xml:lang="en">
        You can also use options on the <command>mate-screenshot</command> command 
        as follows: 
      </para>
      <informaltable frame="topbot">
        <tgroup cols="2" colsep="0" rowsep="0">
          <colspec colname="colspec0" colwidth="35.67*"/>
          <colspec colname="colspec1" colwidth="64.33*"/>
          <thead>
            <row rowsep="1">
              <entry>
                <para xml:lang="en">Option</para>
              </entry>
              <entry>
                <para xml:lang="en">Function</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--window</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot of the window that has focus.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--delay=<replaceable>seconds</replaceable></command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">
                  Takes a screenshot after the specified number of seconds, 
                and displays the <guilabel>Save Screenshot</guilabel> dialog. 
                Use the <guilabel>Save Screenshot</guilabel> dialog to save 
                the screenshot.
                </para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--include-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot including the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--remove-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot without the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--border-effect=shadow</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot and adds a shadow bevel effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Takes a screenshot and adds a border effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--interactive</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Opens a window that lets you set options before taking the screenshot.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para xml:lang="en">
                  <command>--help</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para xml:lang="en">Displays the options for the command.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </listitem>
  </itemizedlist>

  <para xml:lang="en">
  When you take a screenshot, the <guilabel>Save Screenshot</guilabel> dialog 
  opens. To save the screenshot as an image file, enter the filename for the 
  screenshot, choose a location from the drop-down list and click the <guilabel>Save</guilabel> button. You can also use the <guilabel>Copy to Clipboard</guilabel> button to copy the image to the clipboard or transfer it to another application by drag-and-drop.
  </para>
  
</section>

<!-- ============= Yelp ============================= -->
<section xml:id="yelp"><info><title xml:lang="en">Yelp Help Browser</title></info>
  <indexterm xml:lang="en">
    <primary>Yelp</primary>
  </indexterm>
  <!-- ============= Introduction ============================== -->

  <section xml:id="yelp-introduction"><info><title xml:lang="en">Introduction</title></info>
    <para xml:lang="en">The <application>Yelp Help Browser</application> application allows you to view documentation
    regarding MATE and other components through a variety of formats. These
    formats include docbook files, HTML help pages, man pages and info pages
    (support for man pages and info pages may optionally be compiled in).
    Despite the different formats supported, Yelp does its best to provide a
    unified look and feel regardless of the original document format.</para>

    <para xml:lang="en"><application>Yelp Help Browser</application> is internationalized, meaning that it has support
    to view documents in different languages. The documents must be localized
    or translated for each language and installed properly for Yelp Help
    Browser to be able to view them.</para>
  </section>

  <!-- ============= Getting Started  ================================ -->

  <section xml:id="yelp-getting-started"><info><title xml:lang="en">Starting Yelp</title></info>
  
    <section><info><title xml:lang="en">To Start <application>Yelp Help Browser</application></title></info>
      <para xml:lang="en">You can start <application>Yelp Help Browser</application> in the following ways:</para>

      <para><variablelist>
          <varlistentry>
            <term xml:lang="en"><guimenu>System</guimenu> Menu</term>

            <listitem>
              <para xml:lang="en">Choose <application>Help</application></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term>Command Line</term>

            <listitem>
              <para xml:lang="en">Execute the following command:
              <command>yelp</command></para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title xml:lang="en">Interface</title></info>
      <para xml:lang="en">When you start <application>Yelp Help Browser</application>, you will see the following
      window appear.</para>

      <para xml:lang="en"><figure xml:id="fig-yelp-window"><info><title xml:lang="en"><application>Yelp Help Browser</application> Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_window.png"/>
            </imageobject>
          </mediaobject>
        </figure><application>Yelp Help Browser</application> contains the following elements in <xref linkend="fig-yelp-window"/></para>

      <variablelist>
        <varlistentry>
          <term><interface xml:lang="en">Menubar</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term xml:lang="en"><guimenu>File</guimenu></term>

                  <listitem>
                    <para xml:lang="en">Use this menu to Open a New Window, view the About
                    this Document page, Print the current document, or Close
                    the window.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Edit</guimenu></term>

                  <listitem>
                    <para xml:lang="en">Use this menu to Copy, Select all, Find..., or to
                    set your Preferences.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Go</guimenu></term>

                  <listitem>
                    <para xml:lang="en">Use this menu to navigate Back, Forward, to the Help
                    Topics page. When viewing a DocBook document, use this
                    menu to navigate to the Next Section, Previous Section or
                    to the Contents.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Bookmarks</guimenu></term>

                  <listitem>
                    <para xml:lang="en">Use this menu to Add Bookmark(s), or Edit
                    Bookmark(s).</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guimenu>Help</guimenu></term>

                  <listitem>
                    <para xml:lang="en">View information about Yelp Help Browser and
                    contributors to the project through the
                    <guimenuitem>About</guimenuitem> menuitem. Open this
                    document with the <guimenuitem>Contents</guimenuitem>
                    menuitem or by pressing <keycap>F1</keycap>.</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry>
          <term><interface xml:lang="en">Toolbar</interface></term>

          <listitem>
            <para><variablelist>
                <varlistentry>
                  <term xml:lang="en"><guibutton>Back</guibutton></term>

                  <listitem>
                    <para xml:lang="en">Use this button to navigate back in your document
                    history.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guibutton>Forward</guibutton></term>

                  <listitem>
                    <para xml:lang="en">Use this button to navigate forward in your document
                    history.</para>
                  </listitem>
                </varlistentry>

                <varlistentry>
                  <term xml:lang="en"><guibutton>Help Topics</guibutton></term>

                  <listitem>
                    <para xml:lang="en">Use this button to return to the main table of
                    contents (shown in <xref linkend="fig-yelp-window"/>).</para>
                  </listitem>
                </varlistentry>
              </variablelist></para>
          </listitem>
        </varlistentry>

        <varlistentry xml:id="yelp-browser-pane" xreflabel="Yelp Browser Pane">
          <term><interface xml:lang="en">Browser Pane</interface></term>

          <listitem>
            <para xml:lang="en">The browser pane is where you will be presented with the
            table of contents or the documentation. Use the table of contents
            to navigate to the documentation you need.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </section>
  </section>

  <!--===================== Usage ========================-->

  <section xml:id="yelp-usage"><info><title xml:lang="en">Using Yelp</title></info>

    <section><info><title xml:lang="en">Open a Document</title></info>
      <para xml:lang="en">To open a document in <application>Yelp Help Browser</application>:
	  
	  <itemizedlist>
		<listitem>
			<para xml:lang="en">In an application, click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice>
			  </para>
		</listitem>	  
		<listitem>
			<para xml:lang="en">Use the Table of Contents to navigate to the desired document.</para>
		</listitem>
		<listitem>
			<para xml:lang="en">You can drag a Docbook XML file from Caja to the Yelp window or launcher.</para>
		</listitem>
		<listitem>
			<para xml:lang="en">Press the <keycap>F1</keycap> key.</para>
		</listitem>		
	  
	  </itemizedlist></para>
	  
      <para xml:lang="en">Alternatively, you may view a particular document by invoking Yelp
      Help Browser from the command line or dragging files to Yelp. See <xref linkend="yelp-open-specific"/> for more on this.</para>
    </section>

    <section><info><title xml:lang="en">Open a New Window</title></info>
      <para xml:lang="en">To open a new window:</para>
	  
      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>New Window</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>N</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title>About This Document</title></info>
      <para xml:lang="en">To view information about the currently open document:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>About This Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para xml:lang="en">This option is only available for DocBook documentation. Legal
          notices and documentation contributors are usually listed in this
          section.</para>
        </note></para>
    </section>

    <section><info><title xml:lang="en">Print a Page</title></info>
      <para xml:lang="en">To print any page that you are able to view in <application>Yelp Help Browser</application>:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this Page</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title xml:lang="en">Print a Document</title></info>
      <para xml:lang="en">To print an entire document:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Print this Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para xml:lang="en">This option is only available for DocBook
          documentation.</para>
        </note></para>
    </section>

    <section><info><title xml:lang="en">Close a Window</title></info>
      <para xml:lang="en">To close a window in <application>Yelp Help Browser</application>, do the following:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

                <guimenuitem>Close Window</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>W</keycap></keycombo></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title xml:lang="en">Set Preferences</title></info>
      <para xml:lang="en">To set your preferences in <application>Yelp Help Browser</application>:</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Edit</guimenu>

                <guimenuitem>Preferences</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-preferences"/>:</para>

      <para xml:lang="en"><figure xml:id="yelp-preferences"><info><title xml:lang="en"><application>Yelp Help Browser</application> Preferences Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_preferences.png"/>
            </imageobject>
          </mediaobject>
        </figure>The options that are available in this dialog have the
      following functions:</para>

      <para><variablelist>
          <varlistentry>
            <term xml:lang="en"><guilabel>Use system fonts</guilabel></term>

            <listitem>
              <para xml:lang="en">Check this option to display documentation using the
              default fonts used by the MATE Desktop.</para>

              <para xml:lang="en">To choose your own fonts to display documentation, uncheck
              this option and click on the buttons next to the text
              <guilabel>Variable Width</guilabel> or <guilabel>Fixed
              Width</guilabel>.</para>

              <para><variablelist>
                  <varlistentry>
                    <term xml:lang="en"><guilabel>Variable Width</guilabel></term>

                    <listitem>
                      <para xml:lang="en">This is the font to use when a static or fixed
                      width font is not required. The majority of text will be
                      of this type.</para>
                    </listitem>
                  </varlistentry>

                  <varlistentry>
                    <term xml:lang="en"><guilabel>Fixed Width</guilabel></term>

                    <listitem>
                      <para xml:lang="en">This is the font to use when all text characters
                      need to be of the same size. This font is usually used
                      to indicate commands, program blocks, or other text that
                      falls under these categories.</para>
                    </listitem>
                  </varlistentry>
                </variablelist></para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guilabel>Browse with caret</guilabel></term>

            <listitem>
              <para xml:lang="en">Click this option if you would like see a caret or cursor
              in the <xref linkend="yelp-browser-pane"/>. This allows you to
              browse the document more easily by showing where the cursor is
              located in the document.</para>
            </listitem>
          </varlistentry>
        </variablelist></para>
    </section>

    <section><info><title xml:lang="en">Go Back in Document History</title></info>
      <para xml:lang="en">To go back in the document history:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Back</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Left</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the <guibutton>Back</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title xml:lang="en">Go Forward in Document History</title></info>
      <para xml:lang="en">To go forward in the document history:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Forward</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Right</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the <guibutton>Forward</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title xml:lang="en">Go to Help Topics</title></info>
      <para xml:lang="en">To go to the Help Topics:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Help Topics</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Home</keycap></keycombo></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the <guibutton>Help Topics</guibutton> button in the
            <interface xml:lang="en">Toolbar</interface></para>
          </listitem>
        </itemizedlist></para>
    </section>

    <section><info><title xml:lang="en">Go to Previous Section</title></info>
      <para xml:lang="en">To go to the previous section:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Previous Section</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Up</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para xml:lang="en">This option is only available in DocBook formatted
          documents.</para>
        </note></para>
    </section>

    <section><info><title xml:lang="en">Go to Next Section</title></info>
      

      <para xml:lang="en">To go to the next section:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Next Section</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Alt</keycap><keycap>Down</keycap></keycombo></para>
          </listitem>
        </itemizedlist><note>
          <para xml:lang="en">This option is only available in DocBook formatted
          documents.</para>
        </note></para>
    </section>

    <section><info><title xml:lang="en">Go to Contents</title></info>
      

      <para xml:lang="en">To go to the contents for a document:</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Go</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para xml:lang="en">This option is only available in DocBook formatted
          documents.</para>
        </note></para>
    </section>

    <section><info><title xml:lang="en">Add a Bookmark</title></info>
      

      <para xml:lang="en">To add a bookmark for a particular document:</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Bookmarks</guimenu>

                <guimenuitem>Add Bookmark</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>D</keycap></keycombo></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-add-bookmark"/>.</para>

      <para xml:lang="en"><figure xml:id="yelp-add-bookmark"><info><title xml:lang="en">Add Bookmark Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_add_bookmark.png"/>
            </imageobject>
          </mediaobject>
        </figure>Enter your desired bookmark title in to the
      <guilabel>Title</guilabel> text entry field. Then click
      <guibutton>Add</guibutton> to add the bookmark, or click
      <guibutton>Cancel</guibutton> to cancel the request.</para>
    </section>

    <section><info><title>Edit Bookmarks</title></info>
      <para xml:lang="en">To edit your collection of bookmarks:</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Bookmarks</guimenu>
                <guimenuitem>Edit Bookmarks...</guimenuitem>
              </menuchoice></para>
          </listitem>

          <listitem>
            <para xml:lang="en">Use the key combination
            <keycombo><keycap>Ctrl</keycap><keycap>B</keycap></keycombo></para>
          </listitem>
        </itemizedlist>A window will appear that looks like <xref linkend="yelp-edit-bookmarks"/>.</para>

      <para xml:lang="en"><figure xml:id="yelp-edit-bookmarks"><info><title xml:lang="en">Edit Bookmarks Window</title></info>
          <mediaobject>
            <imageobject>
              <imagedata fileref="figures/yelp_edit_bookmarks.png"/>
            </imageobject>
          </mediaobject>
        </figure>You can manage your bookmarks using this window in the
      following ways:</para>

      <para xml:lang="en"><variablelist>
          <varlistentry>
            <term xml:lang="en"><guibutton>Open</guibutton></term>

            <listitem>
              <para xml:lang="en">Use this button to open the selected bookmark in a new
              window.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guibutton>Rename</guibutton></term>

            <listitem>
              <para xml:lang="en">Use this button to rename the title of your
              bookmark.</para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><guibutton>Remove</guibutton></term>

            <listitem>
              <para xml:lang="en">Use this button to delete the bookmark from your
              collection.</para>
            </listitem>
          </varlistentry>
        </variablelist>Once you are finished managing your bookmarks, click
      the <guibutton>Close</guibutton> button to exit the <interface xml:lang="en">Edit
      Bookmarks Window</interface>.</para>
    </section>

    <section><info><title xml:lang="en">Get Help</title></info>
      <para xml:lang="en">To get help to use <application>Yelp Help Browser</application> (and see this
      document):</para>

      <para><itemizedlist>
          <listitem>
            <para xml:lang="en">Click <menuchoice>
                <guimenu>Help</guimenu>

                <guimenuitem>Contents</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist></para>
    </section>
  </section>

  <!--=============== Advanced Features ====================-->

  <section xml:id="yelp-advanced"><info><title xml:lang="en">Advanced Features</title></info>

   <section xml:id="yelp-open-specific" xreflabel="Opening Specific Documents"><info><title xml:lang="en">Opening Specific Documents</title></info>

    <section xml:id="yelp-open-drag"><info><title xml:lang="en">Opening Documents from the File Manager</title></info>
        <para xml:lang="en">To open a document, such as an XML file, from the file manager, open the document in <application>Caja</application> File Manager, or drag the icon from <application>Caja</application> to the <application>Yelp</application> document pane
        or launcher.</para>
    </section>

    <section xml:id="yelp-advanced-cmdline" xreflabel="Using the Command Line to Open Documents"><info><title xml:lang="en">Using the Command Line to Open Documents</title></info>
      <para xml:lang="en">Yelp Help Browser supports opening documents from the command
      line. There are a number of URIs (Uniform Resource Identifiers) that can
      be used. These include:</para>

      <variablelist>
          <varlistentry>
            <term xml:lang="en"><option>file:</option></term>

            <listitem>
              <para xml:lang="en">Use this URI when you want to access a file with
              yelp, for example:</para>

              <screen xml:lang="en"><userinput>yelp file:///usr/share/help/C/mate-control-center/config-mouse.xml</userinput></screen>

            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>help:</option></term>

            <listitem>
              <para xml:lang="en">Use this URI when you want to access MATE help documents,
              which are typically written in DocBook format.</para>

              <screen xml:lang="en"><userinput>yelp help:mate-terminal</userinput></screen>

              <para xml:lang="en">If you want to open the help document at a particular section,
              append a slash to the end of the URI, followed by the section id.</para>
              
              <screen xml:lang="en"><userinput>yelp help:mate-user-guide/yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>man:</option></term>

            <listitem>
              <para xml:lang="en">Use this URI when you want to access a particular man
              page. You can append the section of the man page you would like
              to view if there are multiple man pages with the same
              name.  The section number should be enclosed in parentheses and 
              therefore it may be necessary to escape the argument so that the
              shell does not interpret the parenthesis.</para>

              <screen xml:lang="en"><userinput>yelp man:mate-panel</userinput></screen>
              
              <para xml:lang="en">or</para>

              <screen xml:lang="en"><userinput>yelp 'man:intro(1)'</userinput>
<userinput>yelp 'man:intro(2)'</userinput></screen>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term xml:lang="en"><option>info:</option></term>

            <listitem>
              <para xml:lang="en">Use this URI when you want to access a particular GNU info
              page.</para>

              <screen xml:lang="en"><userinput>yelp info:make</userinput></screen>
            </listitem>
          </varlistentry>
        </variablelist>
    </section>
   </section>

    <section><info><title xml:lang="en">Refreshing Content on Demand</title></info>
      <para xml:lang="en"><application>Yelp Help Browser</application> supports the
      <keycombo><keycap>Ctrl</keycap><keycap>R</keycap></keycombo> shortcut keys, which will reload the DocBook
      document that is currently open. This allows developers to view changes
      to documents as they are made.</para>
    </section>
  </section>

  <section xml:id="yelp-moreinfo"><info><title xml:lang="en">More Information</title></info>
    <para xml:lang="en">This section details some helper applications which 
    <application>Yelp Help Browser</application> uses, and provides resources where you can get more information
    about <application>Yelp Help Browser</application>.</para>

    <section><info><title xml:lang="en">Scrollkeeper</title></info>
      <para xml:lang="en"><application>Yelp Help Browser</application> uses scrollkeeper to generate the table of
      contents for DocBook and HTML documentation, and also keep track of
      translations for each document.</para>
    </section>

    <section><info><title xml:lang="en">MATE Documentation Utilites</title></info>
      <para xml:lang="en">The documentation distributed with MATE uses this set of
      utilities for a variety of things:</para>

      <para xml:lang="en"><itemizedlist>
          <listitem>
            <para xml:lang="en">Ease translation of documents to different languages.</para>
          </listitem>

          <listitem>
            <para xml:lang="en">Provide a set of tools to help package and install
            documentation into the correct location and register the
            documentation with scrollkeeper.</para>
          </listitem>

          <listitem>
            <para xml:lang="en">Perform conversion from DocBook format to a format suitable
            for display.</para>
          </listitem>
        </itemizedlist><application>Yelp Help Browser</application> relies on <link xlink:href="help:mate-doc-xslt">MATE XSLT
      Stylesheets</link> to perform conversion from DocBook to HTML.  <link xlink:href="help:mate-doc-make">MATE Documentation
      Build Utilities</link> are relied upon by application authors to install and register documentation within the help system.</para>
    </section>

    <section><info><title xml:lang="en">Homepage and Mailing List</title></info>
      <para xml:lang="en">For further information on <application>Yelp Help Browser</application>, please visit the Documentation Project homepage, <uri xlink:href="http://mate-desktop.org">http://mate-desktop.org</uri>, or subscribe to
      the mailing list, <uri xlink:href="http://ml.mate-desktop.org/listinfo/mate-dev">http://ml.mate-desktop.org/listinfo/mate-dev</uri>.</para>
    </section>
  </section>

  <section xml:id="yelp-joininggdp"><info><title xml:lang="en">Joining the MATE Documentation Project</title></info>
    <para xml:lang="en">If you are interested in helping produce and update documentation
    for the MATE project, please visit the Documentation Project homepage: <uri xlink:href="http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team">http://wiki.mate-desktop.org/dev-doc:doc-team-guide?s[]=users[]=guide#mate_documentation_team</uri></para>
  </section>
</section>
</chapter>
