<?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" lang="uz">
    <info><title lang="en">Tools and Utilities</title></info>

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

  <section xml:id="tools-run-app"><info><title lang="en">Running Applications</title></info>
    <!-- preserve id for backwards compatibility: 2.12 -->
    <anchor xml:id="gospanel-23"/>
    <indexterm lang="en">
      <primary>Run Application dialog, using</primary>
    </indexterm>
    <para 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 lang="en">
    To run a command from the command line perform the following steps:</para>
    <orderedlist>
      <listitem>
        <para lang="en">Open the <guilabel>Run Application</guilabel> dialog in any of the
        following ways:
        <variablelist>
          <varlistentry><term lang="en">From a panel</term>
          <listitem><para 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 lang="en">Using shortcut keys</term>
          <listitem>
            <para 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 lang="en">The <guilabel>Run Application</guilabel> dialog is displayed.</para>
    </listitem>
    <listitem>
      <para lang="en">Enter the command that you want to run in the blank field, or choose from the list of known applications.</para>
      <para 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 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 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 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 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 lang="en">Taking Screenshots</title></info>
  <!-- preserve id for backwards compatibility: 2.12 -->
  <anchor xml:id="goseditmainmenu-53"/>
  <indexterm lang="en">
    <primary>screenshots, taking</primary>
  </indexterm>
  <para lang="en">You can take a screenshot in any of the following ways:</para>
  <itemizedlist>
    <listitem>
      <para lang="en">From any panel</para>
      <para 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 lang="en">Use shortcut keys</para>
      <para 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 lang="en">Default Shortcut Keys</para>
              </entry>
              <entry>
                <para lang="en">Function</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para lang="en">
                  <keycap>Print Screen</keycap>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para lang="en">Takes a screenshot of the entire screen.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para lang="en"><keycombo><keycap>Alt</keycap><keycap>Print Screen</keycap></keycombo></para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para lang="en">Takes a screenshot of the window which is active.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
      <para lang="en">You can use the <application><xref linkend="prefs-keyboard-shortcuts"/></application> tool to modify the default shortcut keys.</para>
    </listitem>
    <listitem>
      <para lang="en">From the Menubar</para>
      <para lang="en">Choose <menuchoice><guimenu>Applications</guimenu><guimenuitem>Accessories</guimenuitem>
      <guimenuitem>Take Screenshot</guimenuitem></menuchoice>.</para>
    </listitem>
    <listitem>
      <para lang="en">From the Terminal</para>
      <para 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 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 lang="en">Option</para>
              </entry>
              <entry>
                <para lang="en">Function</para>
              </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry colname="colspec0" valign="top">
                <para lang="en">
                  <command>--window</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para lang="en">Takes a screenshot of the window that has focus.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para lang="en">
                  <command>--delay=<replaceable>seconds</replaceable></command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para 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 lang="en">
                  <command>--include-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para lang="en">Takes a screenshot including the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para lang="en">
                  <command>--remove-border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para lang="en">Takes a screenshot without the border of the window.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para lang="en">
                  <command>--border-effect=shadow</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para lang="en">Takes a screenshot and adds a shadow bevel effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para lang="en">
                  <command>--border-effect=border</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para lang="en">Takes a screenshot and adds a border effect around it.</para>
              </entry>
            </row>                                  
            <row>
              <entry colname="colspec0" valign="top">
                <para lang="en">
                  <command>--interactive</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para lang="en">Opens a window that lets you set options before taking the screenshot.</para>
              </entry>
            </row>
            <row>
              <entry colname="colspec0" valign="top">
                <para lang="en">
                  <command>--help</command>
                </para>
              </entry>
              <entry colname="colspec1" valign="top">
                <para lang="en">Displays the options for the command.</para>
              </entry>
            </row>
          </tbody>
        </tgroup>
      </informaltable>
    </listitem>
  </itemizedlist>

  <para 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 lang="en">Yelp Help Browser</title></info>
  <indexterm lang="en">
    <primary>Yelp</primary>
  </indexterm>
  <!-- ============= Introduction ============================== -->

  <section xml:id="yelp-introduction"><info><title lang="en">Introduction</title></info>
    <para 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 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 lang="en">Starting Yelp</title></info>
  
    <section><info><title lang="en">To Start <application>Yelp Help Browser</application></title></info>
      <para lang="en">You can start <application>Yelp Help Browser</application> in the following ways:</para>

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

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

          <varlistentry>
            <term>Buyruq Satri </term>

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

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

      <para lang="en"><figure xml:id="fig-yelp-window"><info><title 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 lang="en">Menubar</interface></term>

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

                  <listitem>
                    <para 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 lang="en"><guimenu>Edit</guimenu></term>

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

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

                  <listitem>
                    <para 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 lang="en"><guimenu>Bookmarks</guimenu></term>

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

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

                  <listitem>
                    <para 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 lang="en">Toolbar</interface></term>

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

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

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

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

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

                  <listitem>
                    <para 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 lang="en">Browser Pane</interface></term>

          <listitem>
            <para 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 lang="en">Using Yelp</title></info>

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

                <guimenuitem>Contents</guimenuitem>
              </menuchoice>
			  </para>
		</listitem>	  
		<listitem>
			<para lang="en">Use the Table of Contents to navigate to the desired document.</para>
		</listitem>
		<listitem>
			<para lang="en">You can drag a Docbook XML file from Caja to the Yelp window or launcher.</para>
		</listitem>
		<listitem>
			<para lang="en">Press the <keycap>F1</keycap> key.</para>
		</listitem>		
	  
	  </itemizedlist></para>
	  
      <para 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 lang="en">Open a New Window</title></info>
      <para lang="en">To open a new window:</para>
	  
      <para><itemizedlist>
          <listitem>
            <para lang="en">Click <menuchoice>
                <guimenu>File</guimenu>

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

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

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

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

                <guimenuitem>About This Document</guimenuitem>
              </menuchoice></para>
          </listitem>
        </itemizedlist><note>
          <para 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 lang="en">Print a Page</title></info>
      <para lang="en">To print any page that you are able to view in <application>Yelp Help Browser</application>:</para>

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

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

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

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

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

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

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

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

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

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

      <para lang="en"><itemizedlist>
          <listitem>
            <para 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 lang="en"><figure xml:id="yelp-preferences"><info><title 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 lang="en"><guilabel>Use system fonts</guilabel></term>

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

              <para 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 lang="en"><guilabel>Variable Width</guilabel></term>

                    <listitem>
                      <para 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 lang="en"><guilabel>Fixed Width</guilabel></term>

                    <listitem>
                      <para 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 lang="en"><guilabel>Browse with caret</guilabel></term>

            <listitem>
              <para 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 lang="en">Go Back in Document History</title></info>
      <para lang="en">To go back in the document history:</para>

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

          <listitem>
            <para 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 lang="en"><figure xml:id="yelp-add-bookmark"><info><title 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>Xatchoʻplarni tahrirlash</title></info>
      <para lang="en">To edit your collection of bookmarks:</para>

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

          <listitem>
            <para 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 lang="en"><figure xml:id="yelp-edit-bookmarks"><info><title 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 lang="en"><variablelist>
          <varlistentry>
            <term lang="en"><guibutton>Open</guibutton></term>

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

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

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

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

            <listitem>
              <para 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 lang="en">Edit
      Bookmarks Window</interface>.</para>
    </section>

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

      <para><itemizedlist>
          <listitem>
            <para 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 lang="en">Advanced Features</title></info>

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

    <section xml:id="yelp-open-drag"><info><title lang="en">Opening Documents from the File Manager</title></info>
        <para 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 lang="en">Using the Command Line to Open Documents</title></info>
      <para 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 lang="en"><option>file:</option></term>

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

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

            </listitem>
          </varlistentry>

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

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

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

              <para 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 lang="en"><userinput>yelp help:mate-user-guide/yelp-advanced-cmdline</userinput></screen>
            </listitem>
          </varlistentry>

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

            <listitem>
              <para 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 lang="en"><userinput>yelp man:mate-panel</userinput></screen>
              
              <para lang="en">or</para>

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

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

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

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

    <section><info><title lang="en">Refreshing Content on Demand</title></info>
      <para 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 lang="en">More Information</title></info>
    <para 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 lang="en">Scrollkeeper</title></info>
      <para 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 lang="en">MATE Documentation Utilites</title></info>
      <para lang="en">The documentation distributed with MATE uses this set of
      utilities for a variety of things:</para>

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

          <listitem>
            <para 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 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 lang="en">Homepage and Mailing List</title></info>
      <para 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 lang="en">Joining the MATE Documentation Project</title></info>
    <para 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>
