<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
<!ENTITY date "April 2006">
<!ENTITY version "@PACKAGE_VERSION@">
]>
<article id="exo-preferred-applications" lang="am">


  <!-- Header -->
  <articleinfo>
    <title>Xfce 4 Preferred Applications</title>

    <pubdate>&date;</pubdate>

    <copyright>
      <year>2004</year>
      <year>2005</year>
      <year>2006</year>
      <holder>Benedikt Meurer</holder>
    </copyright>

    <legalnotice id="legalnotice">
      <para>
        Permission is granted to copy, distribute and/or modify this document
        under the terms of the GNU Free Documentation License, Version 1.1 or
        any later version published by the Free Software Foundation; with no
        Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
        Texts. The complete license text is available from the <ulink type="http" url="http://www.gnu.org/">Free Software Foundation</ulink>.
      </para>
    </legalnotice>

    <authorgroup>
      <author>
        <firstname>Benedikt</firstname>
        <surname>Meurer</surname>
        <affiliation>
          <address><email>benny@xfce.org</email></address>
        </affiliation>
      </author>
    </authorgroup>

    <releaseinfo>
      This manual describes version @PACKAGE_VERSION@ of the <emphasis>Xfce Preferred
      Applications</emphasis> framework and its components.
    </releaseinfo>
  </articleinfo>


  <!-- Content -->
  <sect1 id="intro">
    <title>ማስተዋወቂያ</title>

    <para>
      Throughout the 4.x series of the Xfce Desktop Environment, there
      was no easy way for users to set their preferred applications, i.e.
      the Web Browser that should be used to open hyperlinks. The
      <emphasis>Xfce Preferred Applications</emphasis> framework was
      added in Xfce 4.3 to overcome this limitation and provide users
      with an easy way to select their preferred web browser, mail reader
      and terminal emulator.
    </para>
  </sect1>


  <sect1 id="configuration">
    <title>Configuration</title>

    <para>
      You can access the configuration dialog by clicking on the
      <guibutton>Preferred Applications</guibutton> button in the
      <ulink type="http" url="xfce-mcs-manager.html#manager-dialog">Xfce
      Settings Manager</ulink>. The configuration dialog is split
      into two pages, which are described in the following sections.
    </para>

    <sect2 id="configuration-internet">
      <title>Internet applications</title>

      <para>
        The first page of the configuration dialog allows you to select
        your preferred Web Browser and Mail Reader. The selected Web
        Browser will be used to open hyperlinks that you click on and
        to display the documentation, whereas the Mail Reader will be
        used to compose mails.
      </para>

      <figure id="configuration-internet-figure">
        <title>Internet applications</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="images/exo-preferred-applications-internet.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Select internet applications</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>

      <para>
        To select a different Web Browser than the current default one,
        click on the button in the <guilabel>Default Web Browser</guilabel>
        section and a list of web browsers that were detected on your
        system will appear, as shown in <xref linkend="configuration-webbrowser-menu"/>.
      </para>

      <figure id="configuration-webbrowser-menu">
        <title>Select Web Browser</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="images/exo-preferred-applications-webbrowser-menu.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Select Web Browser</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>

      <para>
        If the Web Browser you are looking for is not automatically
        detected by the system, you can select
        <guimenu><guimenuitem>Other...</guimenuitem></guimenu> from the
        drop down menu and a dialog will appear asking you to enter the
        command for the custom Web Browser, as shown in <xref linkend="configuration-webbrowser-custom"/>.
      </para>

      <figure id="configuration-webbrowser-custom">
        <title>Specify a custom Web Browser</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="images/exo-preferred-applications-webbrowser-custom.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Specify a custom Web Browser</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>

      <para>
        The special marker <literal>%s</literal> in the command will be
        substituted with the URL when you click on a hyperlink. When
        running just the preferred Web Browser without any URL, i.e.
        using <command>exo-open --launch WebBrowser</command>, only the
        binary of the specified command will be used and the parameters
        will be stripped off. In the example above, with <command>mywebbrowser
        "%s"</command> as custom Web Browser, the command
        <command>mywebbrowser</command> will be used to open the Web
        Browser without an URL.
      </para>
    </sect2>

    <sect2 id="configuration-utilities">
      <title>Other applications</title>

      <para>
        The first page of the configuration dialog allows you to select
        your preferred terminal emulator. The preferred terminal emulator
        will be used throughout the Xfce Desktop Environment to launch
        applications that need to be run in a CLI (command line
        interface) environment.
      </para>

      <figure id="configuration-utilities-figure">
        <title>Other applications</title>
        <screenshot>
          <mediaobject>
            <imageobject>
              <imagedata fileref="images/exo-preferred-applications-utilities.png" format="PNG"/>
            </imageobject>
            <textobject>
              <phrase>Select other applications</phrase>
            </textobject>
          </mediaobject>
        </screenshot>
      </figure>

      <para>
        For custom terminal commands, the special marker <literal>%s</literal>
        will be substituted with the application to run in the terminal.
        Otherwise the same rules apply as described in <xref linkend="configuration-internet"/>.
      </para>
    </sect2>
  </sect1>


  <sect1 id="exo-open">
    <title>exo-open</title>

    <para>
      A simple command line frontend to the <emphasis>Xfce Preferred
      Applications</emphasis> framework is included, named
      <application>exo-open</application>. Users and developers can use
      this utility to launch the preferred application for a certain
      category or open URLs with the default URL handler.
    </para>

    <para>
      <application>exo-open</application> supports two operation modes.
      The first will simply launch the preferred application for a
      certain category, optionally passing a parameter (the exact meaning
      of the term <emphasis>parameter</emphasis> depends on the category).
      For example, to launch the command <command>mutt</command> in the
      preferred Terminal Emulator, you would use 
    </para>

<screen>exo-open --launch TerminalEmulator mutt</screen>

    <para>
      while to just open the preferred Web Browser, the following
      command would be used:
    </para>

<screen>exo-open --launch WebBrowser</screen>

    <para>
      The second mode supported by <application>exo-open</application> opens
      all parameters passed to it with the default URL handlers. Here URLs
      mean either fully qualified URLs (i.e.
      <literal>http://www.xfce.org/</literal> or
      <literal>mailto:xfce4-dev@xfce.org</literal>) or local paths (i.e.
      <literal>/home/dude/myfile.txt</literal>). For example to open
      <literal>/home/dude/file1.mp3</literal> and
      <literal>/home/dude/file2.txt</literal> in the default
      applications, you would use the following command:
    </para>

<screen>exo-open /home/dude/file1.mp3 /home/dude/file2.txt</screen>

    <para>
      To start composing a mail to the <ulink type="http" url="http://foo-projects.org/mailman/listinfo/xfce4-dev">xfce4-dev</ulink>
      mailing list, you can do:
    </para>

<screen>exo-open mailto:xfce4-dev@xfce.org</screen>
  </sect1>


  <sect1 id="copyright">
    <title>ስለ</title>

    <para>
      The <emphasis>Xfce Preferred Applications</emphasis> framework and its
      components was written by Benedikt Meurer (<email>benny@xfce.org</email>)
      for the Xfce Desktop Environment. For more information, please visit
      the <ulink url="http://www.xfce.org" type="http">Xfce website</ulink>.
    </para>

    <para>
      To report a bug or make a suggestion regarding the software or this
      manual, use the <ulink type="http" url="http://bugzilla.xfce.org/">Xfce
      Bug Tracking System</ulink> (Product: <literal>libexo</literal>,
      Component: <literal>helpers</literal>).
    </para>

    <para>
      If you have questions about the use or installation of this package,
      please ask on the <ulink type="http" url="http://foo-projects.org/mailman/listinfo/xfce">xfce</ulink> mailing
      list. Development discussion takes place on the <ulink type="http" url="http://foo-projects.org/mailman/listinfo/xfce4-dev">xfce4-dev</ulink>
      mailing list.
    </para>

     <para>
      This software is distributed under the terms of the GNU General Public
      License as published by the Free Software Foundation; either version 2
      of the License, or (at your option) any later version.
    </para>

    <para>
      You should have received a copy of the GNU General Public License 
      along with this program; if not, write to the Free Software 
      Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, 
      USA.
    </para>
  </sect1>
  
</article>
