<!-- <!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"> -->
<chapter id="preferences">
  <title>Setting Galeon Preferences</title>
  <para>
    <application>Galeon</application> is very configurable.  The
    preferences window is where you will find all the options available to
    customize your browser.  You can open it by clicking the
    <guimenuitem>Preferences...</guimenuitem> item in the <link
    linkend="menubar-settings"><guimenu>Settings</guimenu> menu</link>.  On
    the left side, there is a listing of several different categories of
    options.  You can expand and hide the listings of subcategories by
    clicking on the category buttons.  When you click a subcategory, its
    page will be displayed in the window.
  </para>

  <sect1 id="prefs-browsing">
    <title>Browsing</title>

    <sect2 id="prefs-browsing-general">
      <title>General</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Home Page</term>
	    <listitem><para>
	      When <application>Galeon</application> first starts up, it
	      will automatically load the page specified here. Type an
	      address into the entry bar or, if you are currently viewing a
	      page you would like to set as your permanent home page, click
	      the <guibutton>Set to Current</guibutton> button.  You can
	      also elect to make the "My Portal" page your home page by
	      checking the <guibutton>Set to "My Portal"</guibutton>
	      button.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>On Startup</term>
	    <listitem><para>
	      When opening the initial browser window, you can have a page
	      loaded automatically.  You can choose to open your home page,
	      the page you last viewed, or a blank page.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>On New Page</term>
	    <listitem><para>
	      When opening a new, additional window, you can have a page
	      loaded automatically.  You can choose to open your home page,
	      the page you last viewed, or a blank page.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Exit</term>
	    <listitem><para>
	      If the <guibutton>Always save session at exit</guibutton>
	      button is checked, your session will always be saved when you
	      exit <application>Galeon</application>.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>

    <sect2 id="prefs-browsing-bookmarks">
      <title>Bookmarks</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>When Adding Bookmarks</term>
	    <listitem><para>
	      When you add a normal bookmark, you can choose to have the
	      bookmark name set to the page title or you can choose the
	      name yourself.  If you select the <guibutton>Ask user for a
	      title</guibutton> option, <application>Galeon</application>
	      will display a dialog for you to type the desired name into
	      when adding bookmarks.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Show Folder Actions</term>
	    <listitem><para>
	      Here, you can control whether bookmark-editing functions will
	      be displayed at the top or the bottom of each bookmark menu,
	      or only in a context menu accessible by right-clicking on the
	      menu.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>AutoBookmarks</term>
	    <listitem><para>
	      The auto bookmarking feature can be enabled here.  You can
	      also set how many bookmarks you want to be automatically
	      generated.  If you choose to have your AutoBookmarks
	      displayed in a button toolbar, it may be useful to shorten
	      the titles of the bookmarks so they will fit within the
	      toolbar.  You can also set the maximum number of characters
	      in an AutoBookmark title.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Smart Bookmarks</term>
	    <listitem><para>
	      Smart bookmarks are described in <xref
	      linkend="bookmarks-smart-bookmarks"/>.  The <guibutton>Enable
	      history</guibutton> checkbox controls whether previous search
	      items are stored in the drop-down list, and the
	      <guibutton>Show "go to" button</guibutton> checkbox controls
	      whether a button that performs the search is added to the
	      right of the entry box.  The <guibutton>Clear smart bookmarks
	      after use</guibutton> checkbox controls whether the entry
	      fields should be cleared after a search is performed.  You
	      can also control the width of the entry box created for a
	      smart bookmark on the toolbar by adjusting the
	      <guilabel>Default entry width</guilabel> control. As you
	      adjust the width, the example entry box will change width to
	      show you what the entry will look like on the toolbar.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>

    <sect2 id="prefs-browsing-history">
      <title>History</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>History</term>
	    <listitem><para>
	      Galeon keeps a record of all your previously visited URLs.
	      You can set how many days you want to keep these items in
	      your history.  After the specified number of days, a history
	      item will be deleted.  If you wish to immediately delete all
	      items in your browsing history, click the <guibutton>Clear
	      History</guibutton> button.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Completions</term>
	    <listitem><para>
	      The location entry bar and the open URL dialog support
	      autocompletion of typed URLs.  The autocompletion routine
	      will search your history for a possible match to the
	      characters being typed in.  If autocompletion is enabled, the
	      best current match will be automatically filled in as you
	      type.  You can also select the order in which you'd like the
	      URLs used for autocompletion to be sorted.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>
  </sect1>

  <sect1 id="prefs-user-interface">
  <title>User Interface</title>

    <sect2 id="prefs-user-interface-tabs">
    <title>Tabs</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Tabbed Browsing</term>
	    <listitem>
	    <para>
	      <application>Galeon</application> operates in a "hybrid"
	      browsing mode.  Each browser window contains a notebook which
	      itself can display multiple pages.  You can find more
	      information about this feature in <xref
	      linkend="tabbed-browsing"/>.
	    </para>
	    <para>
	      The <guibutton>Open in tabs by default</guibutton> option
	      causes middle-clicked links to open in new tabs, rather than
	      new windows.  The <guibutton>Jump to new tabs
	      automatically</guibutton> option causes
	      <application>Galeon</application> to automatically switch to
	      newly created tabs.  The <guibutton>Display close buttons on
	      tabs</guibutton> option controls whether small "X" buttons
	      allowing you to quickly close each tab should be displayed.
	      The <guibutton>Always show tabs</guibutton> option
	      causes the tab listing to be shown even when only one tab
	      exists in the window.
	    </para>
	    <para>
	      The <guibutton>Open popups in tabs</guibutton> option causes
	      popup windows opened by pages to appear in tabs, rather than
	      in new windows.  The <guibutton>Insert new tabs after current
	      tab</guibutton> option causes new tabs to appear after the
	      current tab in the tab listing, rather than before.  The
	      <guibutton>Insensitive close buttons</guibutton> option
	      controls whether the close buttons on non-active tabs should
	      be made insensitive, to prevent you from accidentally
	      clicking them.  The <guilabel>Tabs appear along</guilabel>
	      dropdown list allows selection of the location where the tabs
	      will be listed.
	    </para>
	    </listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Tab Names</term>
	    <listitem>
	    <para>
	      Use the <guilabel>Shorten names to target length</guilabel>
	      spinbutton to set the maximum tab name length, in characters.
	      Alternately, the <guilabel>Shorten names to fixed
	      width</guilabel> spinbutton can be used to set a fixed size
	      for the width of each tab.
	    </para>
	    <para>
	      By default, <application>Galeon</application> will simply
	      drop words from the end of the page title if it is too long
	      to fit in the desired space. There are also several other
	      (currently English-centric) title shortening strategies
	      available.
	    </para>
            <para>
	      You can choose to shorten names by looking for common
	      separators, dropping vowels, or dropping common prefixes.
	      The first option will look for a separator such as
	      <literal>-</literal>, <literal>:</literal>, etc. and drop
	      anything after that. The second option will compress words by
	      removing vowels from them. For example,
	      <literal>Slashdot</literal> might become
	      <literal>Slshdt</literal>. This allows much more of the title
	      to fit within the tab, while still remaining readable most of
	      the time. The last option searches for common prefixes like
	      <literal>Welcome to</literal> or <literal>My</literal> and
	      drops them from the title.
            </para>
            </listitem>
          </varlistentry>

          <varlistentry>
	    <term>Tab Colors</term>
	    <listitem>
	    <para>
	      Here, you can select the colors that will be used for the
	      text on tabs whose pages are still being loaded, and on tabs
	      that have finished loading but have not yet been viewed.
            </para>
            </listitem>
          </varlistentry>

        </variablelist>
      </para>
    </sect2>

    <sect2 id="prefs-user-interface-windows">
    <title>Windows</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Default Layout</term>
	    <listitem><para>
              This controls what elements are displayed by default.
            </para>
	    <para>
	      If the <guibutton>Keep fullscreen window above all other
	      windows</guibutton> checkbox is activated, in fullscreen mode
	      the browser window will be raised above all other windows on
	      your desktop, including the <application>GNOME
	      panel</application>.  If this checkbox is deactivated, in
	      fullscreen mode other applications will be able to cover the
	      browser window.
            </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Default Dock</term>
	    <listitem><para>
              Here, you can control which docked items are displayed when
	      a new window is opened.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>

    <sect2 id="prefs-user-interface-toolbars">
    <title>Toolbars</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Toolbar Appearance</term>
	    <listitem><para>
	      The toolbar buttons can also be shown as icons, as text, or
	      as both, in configurations with the text under or to the
	      right of the icons.  The location entry bar can be shown on
	      same toolbar as the navigation buttons or it can be shown on
	      its own separate toolbar.  
	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Toolbar Controls</term>
	    <listitem><para>
	      Here, you can control which items are contained in
	      <application>Galeon</application>'s toolbar, and the order in
	      which they are displayed.  The list on the left,
	      <guilabel>Current Controls</guilabel>, lists the items in the
	      toolbar, while the one on the right, <guilabel>Available
	      Controls</guilabel>, lists items not in the toolbar.  To move
	      an item into the toolbar, select it in the
	      <guilabel>Available Controls</guilabel> list and click the
	      button containing a left arrow, or double-click it.  To
	      remove an item from the toolbar, select it in the
	      <guilabel>Current Controls</guilabel> list and click the
	      button containing a right arrow, or double-click it.  Items
	      in the <guilabel>Current Controls</guilabel> list can be
	      reordered, either by dragging them to a new position or by
	      selecting one and clicking the buttons with up or down
	      arrows.  The various toolbar controls are described in <xref
	      linkend="toolbar"/>.
	    </para></listitem>
          </varlistentry>

          <varlistentry>
	    <term>Toolbar Theme</term>
	    <listitem><para>
	      The style of icons that are used for the toolbar buttons can
	      be selected here.  To get more themes, visit 
              <ulink url="http://galeon.sourceforge.net/themes">
              http://galeon.sourceforge.net/themes</ulink>.
	    </para></listitem>
          </varlistentry>

          <varlistentry>
	    <term>Spinner</term>
	    <listitem><para>
	      A graphical list of all spinners installed on your system is
	      displayed. Click on an icon to select it as the spinner you
	      wish to have displayed on your main toolbar.  If you'd like
	      to browse to a spinner animation that is in a different
	      location on your system than the default, you can browse to
	      its folder.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>

    <sect2 id="prefs-user-interface-mouse">
    <title>Mouse</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Mouse buttons</term>
	    <listitem><para>
	      When you click on a link with the middle mouse button, the
	      link will be opened in a new window or tab.  Middle-button
	      clicks elsewhere in the browser window, though, can be
	      configured to show a menu containing all your bookmarks, to
	      load a URL contained in the clipboard, or to do nothing.  The
	      second option allows you to highlight a URL in, for example,
	      a terminal window and then simply middle click in the browser
	      window to load the URL.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Mouse wheel</term>
	    <listitem>
            <para>
	      By default, the mouse wheel scrolls by 1 line.  This can be
              customized within the range of 1 to 100 lines.
            </para>
            </listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>
  </sect1>

  <sect1 id="prefs-handlers">
  <title>Handlers</title>

    <sect2 id="prefs-handlers-downloading">
    <title>Downloading</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Downloader</term>
	    <listitem>
	      <para>
	        Here, you can configure how
		<application>Galeon</application> handles downloadable
		files.  You can choose to use the built-in downloader, the
		<application>GNOME Transfer Manager (GTM)</application>, or
		an external program called by a command.  If you use an
		external program, you can also choose to run the command
		inside of a terminal.  The string <literal>%s</literal>
		inside of the command will be replaced with the URL of the
		file to be downloaded.  Likewise <literal>%f</literal>
		will be replaced with the destination folder.
                Commands for several common
		programs are included in the drop-down list.
	      </para>
	      <note>
	      <title>Auto download and GTM</title>
		<para>
		  If you are using GTM to transfer files, you'll also need
		  to configure GTM to get auto download working.  Launch
		  GTM and select the <guilabel>Auto</guilabel> tab in its
		  preferences dialog.  The <guilabel>Interface to
		  connect:</guilabel> option must be set to the correct
		  interface for auto download to work.  If you are unsure
		  which interface you are using, type
		  <userinput>ifconfig</userinput> in a terminal window and
		  look at the output.  If you are using a modem, you are
		  likely using "ppp0".  If you are using an ethernet
		  connection (this includes cable modems and DSL), you are
		  likely using "eth0".
		</para>
	      </note>
	    </listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Options</term>
	    <listitem>
	      <para>
		In this section, you can set some basic options controlling
		<application>Galeon</application>'s behavior with regard to
		downloading files via HTTP.  You can select whether you 
                would like to be prompted for a location to save the file
                to every time, and the directory that will be used as a default.
	      </para>
	    </listitem>
	  </varlistentry>

          <varlistentry>
	    <term>FTP</term>
	    <listitem><para>
	      In this section, you can specify how
	      <application>Galeon</application> should handle "ftp://"
	      links.  You can choose to use either
	      <application>Galeon</application>'s built-in FTP handler or
	      the external handler that is specified in the GNOME Control
	      Center.  For more information on configuring your GNOME URL
	      handlers, consult <xref linkend="prefs-GNOME-URL-handlers"/>.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>

    <sect2 id="prefs-handlers-programs">
    <title>Programs</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>View source</term>
	    <listitem><para>
	      Here, you can select whether HTML source code will be viewed
	      within a <application>Galeon</application> browser window or
	      in an external program.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Mailer</term>
	    <listitem><para>
	      The default mailer for mailto: URLs can be specified here.
              To support legacy mail clients, the following options are available:
		<simplelist>
                  <member><literal>%t</literal> To</member>
                  <member><literal>%c</literal> Cc</member>
                  <member><literal>%b</literal> Bcc</member>
                  <member><literal>%k</literal> Reference</member>
                  <member><literal>%w</literal> News Host</member>
                  <member><literal>%n</literal> News Group</member>
                  <member><literal>%p</literal> Priority</member>
                  <member><literal>%a</literal> Attachment</member>
                  <member><literal>%e</literal> Reference</member>
                  <member><literal>%h</literal> Html</member>
                  <member><literal>%y</literal> Body</member>
                  <member><literal>%s</literal> Subject</member>
                  <member><literal>%r</literal> Reply</member>
                  <member><literal>%o</literal> Follow up</member>
	          <member>For example: <literal>mutt [-c %c] [-b %b] [-s %s] [-t %t]</literal></member>
		</simplelist>
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Help</term>
	    <listitem><para>
	      This setting controls whether
	      <application>Galeon</application> will be used when viewing
	      <application>GNOME</application> help documents.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>

    <sect2 id="prefs-handlers-mime-types">
    <title>MIME Types</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>MIME Types</term>
	    <listitem><para>
	      This section controls what <application>Galeon</application>
	      will do when encountering different types of files.
	      <application>Galeon</application> will use the list displayed
	      here to determine what course of action should be taken with
	      files with different MIME types.  You can add and delete MIME
	      types here and modify the action that will be performed for
	      each.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>
  </sect1>

  <sect1 id="prefs-rendering">
  <title>Rendering</title>

    <sect2 id="prefs-rendering-fonts-colors">
    <title>Fonts/Colors</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Fonts</term>
	    <listitem><para>
	      In this section, you can customize the fonts that the
	      <application>Mozilla</application> rendering engine will use
	      when displaying pages in <application>Galeon</application>.
	      If the <guibutton>Always use these fonts</guibutton> button
	      is checked, these fonts will be used on all pages; otherwise,
	      they will only be used by pages that do not specify their own
	      fonts.  The font sizes selected in the dialog boxes opened by
	      the <guibutton>Serif</guibutton> and
	      <guibutton>Monospace</guibutton> buttons determine the
	      default sizes for all variable- and fixed-width fonts,
	      respectively.  The <guibutton>Min. Size</guibutton>
	      spinbutton allows you to specify the minimum point size for
	      fonts that are displayed.  The default font type, either
	      Serif or Sans Serif, can be selected.  All of these options
	      can be set for each of the encodings listed in the
	      <guilabel>Language encoding</guilabel> box.
	      <tip>
	        <title>Tip</title>
		<para>
		  Make sure you select the appropriate character set in the
		  font browsers for the language that you're using
		  (<literal>iso8859-1</literal> for Western European
		  languages)!  If you don't, your settings may be ignored.
		</para>
	      </tip>
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Colors</term>
	    <listitem><para>
	      Here, you can select the default colors that will be used for
	      the background, text, and unvisited and visited links of web
	      pages that don't define their own colors.  You can also
	      choose whether you'd like these colors to be used for all
	      pages, and whether you'd like links to be underlined or not.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Stylesheet</term>
	    <listitem><para>
	      Here, you can select stylesheets that will be
	      used by default for all pages.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>

    <sect2 id="prefs-rendering-languages">
    <title>Languages</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Charsets</term>
	    <listitem><para>
	      You can select the default character set that will be used
	      for text here, and whether this setting should be
	      autodetected.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Languages</term>
	    <listitem><para>
	      This section lets you manage the languages that
	      <application>Galeon</application> is capable of displaying.
	      <!-- FIXME: I know nothing about this.  Someone else should
	      cover it in more detail, if they have the time and
	      inclination. :) -Daniel -->
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>
  </sect1>

  <sect1 id="prefs-advanced">
  <title>Advanced</title>

    <sect2 id="prefs-advanced-network">
    <title>Network</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Protocol</term>
	    <listitem><para>
	      You can choose either HTTP version 1.0 or 1.1. Some proxy
	      software, (e.g. <application>Junkbuster</application>)
	      requires the older HTTP version 1.0 to function correctly.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Proxies</term>
	    <listitem><para>
	      If you use proxies for the HTTP, SSL, or FTP protocols, enter
	      their information here and check the <guibutton>Enable
	      proxy</guibutton> button.  You can also give a <!-- FIXME:
	      space-separated? comma-separated? -Daniel --> list of sites
	      for which the proxies will not be used, and enable the use of
	      proxy keep-alive, if necessary.  If your network is set up
	      appropriately, it is also possible to automatically get the
	      correct proxy configuration here.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>

    <sect2 id="prefs-advanced-filtering">
    <title>Filtering</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Filtering</term>
	    <listitem><para>
	      Many pages contain HTML or JavaScript code that will open new
	      browser windows.  You can prevent these popup windows from
	      being opened by unchecking the <guibutton>Allow
	      popups</guibutton> button.  If you have a Java plugin
	      installed, you can enable or disable it here.  You can also
	      control whether any other plugins will be used.
	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>JavaScript</term>
	    <listitem><para>
	      You can enable or disable the execution of JavaScript code
	      here.  Unchecking the <guibutton>Allow statusbar
	      messages</guibutton> button prevents pages from changing the
	      text in the statusbar.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Image loading</term>
	    <listitem><para>
	      When images are present in a page, you can choose to always
	      load them, load them only if they come from the current
	      server, or never load them.  Images for banner ads are
	      usually loaded from a different server than the page you are
	      viewing, so selecting "Load from current server only" will
	      often block these banner ads from displaying.  To open the
	      <link linkend="pdm-image-sites">Image Sites page of the
	      Persistent Data Manager</link>, allowing you to block images
	      from specific sites, click the <guibutton>Image
	      Sites...</guibutton> button.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>

    <sect2 id="prefs-advanced-persistent-data">
      <title>Persistent Data</title>
      <para>
        <variablelist>

          <varlistentry>
	    <term>Cookies</term>
	    <listitem>
	    <para>
	      You can choose to accept all cookies, accept cookies from the
	      current server only, or to not accept any cookies. If you
	      want to be notified when a site attempts to store a cookie on
	      your computer, select the <guibutton>Warn before accepting a
	      cookie</guibutton> checkbox.
       	    </para>
	    <para>
	      Clicking the <guibutton>Cookies...</guibutton> or
	      <guibutton>Cookie Sites...</guibutton> buttons will open the
	      corresponding pages of the <link linkend="pdm">Persistent
	      Data Manager</link>, allowing you to manage the cookies that
	      are being stored and the site-specific cookie policies.
	    </para>
	    </listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Passwords</term>
	    <listitem>
	    <para>
	      <application>Galeon</application> can automatically remember
	      username/password combinations that you enter.  To enable
	      this functionality, check the <guibutton>Remember passwords
	      for sites that require logins</guibutton> button.
       	    </para>
	    <para>
	      Clicking the <guibutton>Passwords...</guibutton> or
	      <guibutton>Password Sites...</guibutton> buttons will open
	      the corresponding pages of the <link linkend="pdm">Persistent
	      Data Manager</link>, allowing you to manage the
	      username/password combinations that are being stored and the
	      listing of sites for which combinations should not be stored.
	    </para>
	    </listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Cache</term>
	    <listitem><para>
	      The disk cache stores a local copy of pages and images you
	      have viewed on your hard drive, in order to make browsing of
	      pages that you've already visited faster.  The memory cache
	      does the same thing, but in your RAM.  You can set how often
	      items in the cache and their actual versions on the network
	      should be compared, and how much space you want the caches to
	      use.  If you would like to delete all stored items, click the
	      <guibutton>Clear disk cache</guibutton> and <guibutton>Clear
	      memory cache</guibutton> buttons.
       	    </para></listitem>
	  </varlistentry>

        </variablelist>
      </para>
    </sect2>

  </sect1>

  <sect1 id="prefs-GNOME-URL-handlers">
    <title>Configuring the GNOME URL handlers</title>
      <para>
	<application>Galeon</application> uses the program specified by
	GNOME to handle the "mailto" protocol.
	<application>Galeon</application> will also use the
	"ftp" protocol handler specified by your GNOME settings if you
	have elected to use an external FTP handler (described in
	<xref linkend="prefs-handlers-downloading"/>).
      </para>
      <para>
	To set your GNOME "mailto" and "ftp" handlers, first launch the
	GNOME Control Center.  Click on <menuchoice><guimenu>Document
	Handlers</guimenu><guimenuitem>URL Handlers</guimenuitem>
	</menuchoice>.  Look in the column labeled "Protocol". If you have
	an item labeled "mailto" or "ftp", you can click on it and edit the
	text entry field to the right of the <guilabel>handler:</guilabel>
	label.  If, for example, you want to use
	<application>Balsa</application> to handle "mailto" links, enter
	<userinput>balsa -m "%s"</userinput> in this field.  The "%s"
	parameter will be replaced with the email address specified in the
	"mailto" link.  After you have entered this information, click the
	<guibutton>Set</guibutton> button.  If desired, do the same for the
	"ftp" protocol.  If there is no "mailto" or "ftp" handler currently
	set, simply enter <userinput>mailto</userinput> or
	<userinput>ftp</userinput> in the first text entry field, and the
	command that should be run in the second.  After clicking the
	<guibutton>Set</guibutton> button, you should see the new handler
	in the list below.  Click on the <guibutton>OK</guibutton> button
	to apply and save your changes.
      </para>
  </sect1>
</chapter>
