<!--
<!DOCTYPE Chapter PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN">
-->

<chapter id="browser-window">
  <title>The Browser Window</title>
  <para>
    <application>Galeon</application>'s interface should be familiar to
    anyone who has used any popular Web browser like
    <application>Netscape</application> or
    <application>Mozilla</application>.  There is a menubar at the top of
    the window, a main toolbar below it, and a statusbar at the bottom of
    the window. There may also be other toolbars, created by the user for
    often used bookmarks, as described in <xref linkend="bookmarks-toolbars"/>.
  </para>

  <figure id="browser-window.png">
    <title>The Galeon Browser Window</title>
    <screenshot>
      <graphic fileref="figures/browser-window" format="PNG"></graphic>
    </screenshot>
  </figure>

  <sect1 id="navigation">
    <title>Basic Navigation</title>
      <para>
        As with any browser, the most common form of navigation is clicking
        on links.  Galeon also supports a number of other mouse interactions:
	<simplelist>
	  <member><guibutton>Shift+Left Click:</guibutton> Download link</member>
	  <member><guibutton>Middle Click:</guibutton> Open link in new tab, unless changed in 
	  preferences, see <xref linkend="prefs-user-interface-mouse"/>
	  </member>
	  <member><guibutton>Shift+Middle Click:</guibutton> Open link in new window</member>
	  <member><guibutton>Right Click:</guibutton> Display context menu</member>
	</simplelist>
      </para>
  </sect1>

  <sect1 id="menubar">
    <title>Menus</title>
      <para>
	Depending on your window manager settings, there may be a small dashed
        line under each menu.  Clicking on this allows
	a menu to be detached from the menubar and to float above the browser
	window.
      </para>
  <sect2 id="menubar-file">
      <title>File Menu</title>
      <para>
	<variablelist>

	  <varlistentry>
	    <term><guimenuitem>New window</guimenuitem></term>
	    <listitem><para>
	      Creates a new browser window and loads the home page into it.
	      Instructions for setting the home page are described in <xref
	      linkend="prefs-browsing-general"/>.
       	    </para></listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><guimenuitem>New tab</guimenuitem></term>
	    <listitem><para>
	      Creates a new notebook tab in the current browser window and
	      loads the home page into it.
       	    </para></listitem>
	  </varlistentry>

          <varlistentry>
            <term><guimenuitem>Open...</guimenuitem></term>
            <listitem><para>
	      Opens a local file.  A file selector window is opened,
	      allowing you to browse through the filesystem for the file
	      you'd like to open.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Open URL...</guimenuitem></term>
            <listitem><para>
	      Opens a dialog with an entry field that you can type a new
	      URL into.
             </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Save As...</guimenuitem></term>
            <listitem><para>
	      Saves a copy of the current page to disk.  A dialog window is
	      opened allowing you to choose the path and filename you'd
	      like to use.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Send link to...</guimenuitem></term>
            <listitem><para>
              Creates an e-mail message referencing the current URL.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Print...</guimenuitem></term>
            <listitem><para>
	      Prints the current page.  A dialog window is opened, allowing
	      you to specify various print-related settings.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Save session as...</guimenuitem></term>
            <listitem><para>
	      Opens a dialog allowing you to save the current session to a
	      file.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Open session...</guimenuitem></term>
            <listitem><para>
	      Opens a dialog allowing you to choose a session to load.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>[Listing of recently-opened
	      sessions]</guimenuitem></term>
            <listitem><para>
	      Recently-opened sessions are listed here.  Clicking one opens
	      it.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Close</guimenuitem></term>
            <listitem><para>
	      If multiple tabs are open, the currently-selected tab is
	      closed.  If only one tab exists in the window, the window is
	      closed.  If this window is the only window opened, the
	      program will exit as well.
             </para></listitem>
           </varlistentry>

          <varlistentry>
            <term><guimenuitem>Exit with session</guimenuitem></term>
            <listitem><para>
	      Saves a record of the sites you are currently viewing and
	      exits.  The next time you run
	      <application>Galeon</application>, your session will be
	      restored automatically for you. All the windows and
	      tabs you have open will be reopened, and their contents will
	      be reloaded.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Exit</guimenuitem></term>
            <listitem><para>
              Closes all open browser windows and exits the program.
            </para></listitem>
          </varlistentry>

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

    <sect2 id="menubar-edit">
      <title>Edit Menu</title>
      <para>
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Cut</guimenuitem></term>
            <listitem><para>
	      Copies the currently selected text to the clipboard, and
	      also deletes the original version of the text if it is in an
	      editable field.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Copy</guimenuitem></term>
            <listitem><para>
	      Copies the currently selected text to the clipboard.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Paste</guimenuitem></term>
            <listitem><para>
	      If an editable field is selected, any text stored by the
	      clipboard is pasted into it.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Find...</guimenuitem></term>
            <listitem><para>
              Opens a dialog box that allows you to search for a word
	      in the page being viewed.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Find next...</guimenuitem></term>
            <listitem><para>
              Repeats previous Find.
            </para></listitem>
          </varlistentry>

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

    <sect2 id="menubar-view">
      <title>View Menu</title>
      <para>
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Menubar</guimenuitem></term>
            <listitem><para>
              Toggles the display of the menubar.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Toolbar</guimenuitem></term>
            <listitem><para>
              Toggles the display of the main toolbar.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Bookmarks toolbars</guimenuitem></term>
            <listitem><para>
              Toggles the display of the bookmark toolbars.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Statusbar</guimenuitem></term>
            <listitem><para>
              Toggles the display of the statusbar.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Full screen</guimenuitem></term>
            <listitem><para>
              Toggles full screen mode, which is described in more detail
	      in <xref linkend="full-screen-mode"/>.
	     </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Zoom</guimenuitem></term>
            <listitem><para>
	      <variablelist>

	        <varlistentry>
            	  <term><guimenuitem>In</guimenuitem></term>
                  <listitem><para>
         	    Increases the sizes of the fonts on the page.
		  </para></listitem>
		</varlistentry>

	        <varlistentry>
                  <term><guimenuitem>100%</guimenuitem></term>
                  <listitem><para>
		    Resets the sizes of the fonts on the page to their
		    defaults.
		  </para></listitem>
		</varlistentry>

	        <varlistentry>
            	  <term><guimenuitem>Out</guimenuitem></term>
                  <listitem><para>
               	    Decreases the sizes of the fonts on the page.
		  </para></listitem>
		</varlistentry>

	      </variablelist>
            </para></listitem>
          </varlistentry>

	  <varlistentry>
	    <term><guimenuitem>Encoding</guimenuitem></term>
	    <listitem><para>
	      Sets the character set used to display the page, bypassing
	      <application>Mozilla</application>'s autodetection.
	    </para></listitem>
	  </varlistentry>

          <varlistentry>
            <term><guimenuitem>Stylesheet</guimenuitem></term>
            <listitem><para>
	      Allows you to choose between using the current page's default
	      stylesheet, no stylesheet, or any alternate stylesheets that
	      may be defined by the page.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Page source</guimenuitem></term>
            <listitem><para>
	      Opens a new window containing the source code for the
	      currently loaded page.
            </para></listitem>
          </varlistentry>

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

    <sect2 id="menubar-tab">
      <title>Tab Menu</title>
      <para>
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Detach tab</guimenuitem></term>
            <listitem><para>
	      Detaches the currently-selected tab, placing it in a new
	      window.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Move tab to another
	      window</guimenuitem></term>
            <listitem><para>
	      Clicking on one of the windows listed in this submenu
	      detaches the currently-selected tab and moves it to that
	      window.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Previous tab</guimenuitem></term>
            <listitem><para>
	      Selects the previous tab.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Next tab</guimenuitem></term>
            <listitem><para>
	      Selects the next tab.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Move tab left / up</guimenuitem></term>
            <listitem><para>
	      Moves the currently-selected tab to the previous position in
	      the notebook.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Move tab right / down</guimenuitem></term>
            <listitem><para>
	      Moves the currently-selected tab to the next position in the
	      notebook.
            </para></listitem>
          </varlistentry>

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

    <sect2 id="menubar-settings">
      <title>Settings Menu</title>
      <para>
  	The settings menu offers quick access to some commonly used settings.
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Load images</guimenuitem></term>
            <listitem>
	    <para>
	      Images in a page can be set to load
	      <guimenuitem>Always</guimenuitem>, <guimenuitem>From current
	      server only</guimenuitem>, or
	      <guimenuitem>Never</guimenuitem>. If <guimenuitem>From
	      current server only </guimenuitem> is selected, only images
	      that originate from the same place as the current page will
	      be loaded.
            </para>
	    </listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Animate images</guimenuitem></term>
            <listitem>
            <para>
	      Animated images in a page can be set to play
	      <guimenuitem>Continuously</guimenuitem>,
	      <guimenuitem>Once</guimenuitem>, or
	      <guimenuitem>Never</guimenuitem>.
	      <guimenuitem>Continuously</guimenuitem> means that animations
	      will loop. <guimenuitem>Once </guimenuitem> means the
	      animation will play once and then stop.
	      <guimenuitem>Never</guimenuitem> means the animation will not
	      be played - only the first frame of the sequence will be
	      displayed.
            </para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Proxy</guimenuitem></term>
            <listitem>
            <para>
	      Galeon's proxy usage can be set to
	      <guimenuitem>Disabled</guimenuitem>,
	      <guimenuitem>Manual</guimenuitem>, or
	      <guimenuitem>Auto</guimenuitem>.
	      These settings are described in more detail in <xref
	      linkend="prefs-advanced-network"/>.
            </para>
            </listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Use own fonts</guimenuitem></term>
            <listitem><para>
               Overrides the fonts that the page specifies, instead using
	       the user-selected default fonts.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Use own colors</guimenuitem></term>
            <listitem><para>
               Overrides the colors that the page specifies, instead using
	       the user-selected default colors.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Allow Java</guimenuitem></term>
            <listitem><para>
               Allows Java code to be executed.  This has an effect only
	       if a Java plugin has been installed. 
               <!-- FIXME: add xref -->
             </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Allow JavaScript</guimenuitem></term>
            <listitem><para>
              Allows JavaScript code to be executed.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Allow popups</guimenuitem></term>
            <listitem><para>
	      Allows pages to open popup windows.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Work offline</guimenuitem></term>
            <listitem><para>
	      Toggles whether pages should loaded over the network or
              from the local cache.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Preferences</guimenuitem></term>
            <listitem><para>
	      Opens the <link linkend="preferences">preferences
	      window</link>, where all of
	      <application>Galeon</application>'s settings can be viewed
	      and/or modified.
            </para></listitem>
          </varlistentry>

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

    <sect2 id="menubar-bookmarks">
      <title>Bookmarks Menu</title>
      <para>
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Add bookmark</guimenuitem></term>
            <listitem><para>
	      Adds a bookmark to the default bookmark folder, 
              possibly also opening a dialog box
              allowing you to name the bookmark.  
	      Instructions for setting the
	      default bookmark folder can be found in <xref
	      linkend="bookmarks-editor"/>.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Add bookmark to</guimenuitem></term>
            <listitem><para>
              Adds a bookmark for the currently loaded URL to one of your
              bookmarks folders.  This option is described
              in <xref linkend="prefs-browsing-bookmarks"/>.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Edit bookmarks...</guimenuitem></term>
            <listitem><para>
              Opens the <link linkend="bookmarks-editor">
	      bookmarks editor</link>.
            </para></listitem>
          </varlistentry>

	  <varlistentry>
	    <term><guimenuitem>AutoBookmarks</guimenuitem></term>
	    <listitem><para>
	      Displays a listing of automatically created bookmarks based
	      on sites you've recently visited.  This is described in
	      <xref linkend="prefs-browsing-bookmarks"/>
	    </para></listitem>
	  </varlistentry>

	  <varlistentry>
	    <term><guimenuitem>Smart Bookmarks Toolbar</guimenuitem></term>
	    <listitem><para>
	      Shows the items on your Bookmarks Toolbar.
	    </para></listitem>
	  </varlistentry>

	</variablelist>
	The bottom portion of the menu consists of a listing of all of your
	bookmarks.  Depending on the <guilabel>Show folder actions
	setting</guilabel>, described in <xref
	linkend="prefs-browsing-bookmarks"/>, bookmark-editing actions may
	be visible at the top or bottom of each folder, or in a context
	menu accessible by right-clicking on an item or folder.
       </para>
    </sect2>

    <sect2 id="menubar-go">
      <title>Go Menu</title>
      <para>
	The first six items in this menu, <guimenuitem>Back</guimenuitem>,
	<guimenuitem>Forward</guimenuitem>, <guimenuitem>Up</guimenuitem>,
	<guimenuitem>Reload</guimenuitem>, <guimenuitem>Home
	page</guimenuitem>, and <guimenuitem>Stop</guimenuitem>, are simply
	copies of the corresponding toolbar buttons, which are described in
	<xref linkend="toolbar"/>.
      </para>
      <para>
	Under these six items is a dynamically generated list of links to
	pages that have been recently visited in this window.
      </para>
    </sect2>

    <sect2 id="menubar-tools">
      <title>Tools Menu</title>
      <para>
	This menu provides access to several additional browsing-related
	functions.
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Cookies</guimenuitem></term>
            <listitem>
	    <para>
	      You can view all the stored cookies on the <link
	      linkend="pdm-cookies">Cookies page of the Persistent Data
	      Manager</link> by selecting <guimenuitem>View
	      cookies...</guimenuitem>.  The <guimenuitem>View cookie
	      sites...</guimenuitem> item opens the <link
	      linkend="pdm-cookie-sites">Cookie Sites page of the
	      Persistent Data Manager</link>, allowing you to set
	      acception/rejection policies for cookies on a per-site basis.
	    </para>
	    <para>
	      Cookie permissions can also be set on a per-site basis from
	      this menu.  <guilabel>Allow cookies from this site</guilabel>
	      allows the currently loaded site to store cookies on your
	      computer.  <guilabel>Block cookies from this site</guilabel>
	      will prevent the currently loaded site from storing any
	      cookies on your computer.
            </para>
	    </listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Images</guimenuitem></term>
            <listitem>
	    <para>
	      Image loading can be controlled on a per-site basis.
	      <guimenuitem> Allow images from this site</guimenuitem> will
	      allow the currently loaded site to display images, while
	      <guimenuitem>Block images from this site</guimenuitem> will
	      prevent the currently loaded site from displaying any images.
	      To view the list of sites with explicitly set permissions,
	      select <guimenuitem>View image sites...</guimenuitem>
	    </para>
	    </listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Passwords</guimenuitem></term>
            <listitem>
	    <para>
	      You can view all the stored passwords on the <link
	      linkend="pdm-passwords">Passwords page of the Persistent Data
	      Manager</link> by selecting <guimenuitem>View
	      passwords...</guimenuitem>.  The <guimenuitem>View password
	      sites...</guimenuitem> item opens the <link
	      linkend="pdm-password-sites">Password Sites page of the
	      Persistent Data Manager</link>, allowing you to specify sites
	      for which username/password combinations will not be saved.
	    </para>
	    </listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>History...</guimenuitem></term>
            <listitem><para>
	      Shows the history window or dock, which contains a list of
	      all previously visited locations.  You can learn more about
	      changing history-related settings in <xref
	      linkend="prefs-browsing-history"/>, and more about the dialog
	      itself in <xref linkend="history"/>.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Java console...</guimenuitem></term>
            <listitem><para>
	      Opens a new window allowing you to read Java-related messages
	      that are emitted.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Javascript console...</guimenuitem></term>
            <listitem><para>
	      Opens a new window allowing you to read Javascript-related
	      messages that are emitted.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Rerun first time druid...</guimenuitem></term>
            <listitem><para>
	      Reruns the druid that is run the first time Galeon is
	      started, allowing you to import preferences and bookmarks
	      that are already being used by other browsers installed on
	      your system.
            </para></listitem>
          </varlistentry>

        </variablelist>
      </para>
    </sect2>
	  
    <sect2 id="menubar-help">
      <title>Help Menu</title>
      <para>
	<variablelist>

          <varlistentry>
            <term><guimenuitem>Galeon FAQ</guimenuitem></term>
            <listitem><para>
              Displays the Galeon FAQ (Frequently Asked Questions) page.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Galeon manual</guimenuitem></term>
            <listitem><para>
              Displays this manual.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Galeon homepage</guimenuitem></term>
            <listitem><para>
	      Loads the official <application>Galeon</application>
	      homepage.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>Report a bug</guimenuitem></term>
            <listitem><para>
	      Loads a page allowing you to report a bug in
	      <application>Galeon</application>.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>About plugins</guimenuitem></term>
            <listitem><para>
	      Opens a page in the current window displaying information
	      about the plugins that <application>Galeon</application> has
	      been configured to use.
            </para></listitem>
          </varlistentry>

          <varlistentry>
            <term><guimenuitem>About...</guimenuitem></term>
            <listitem><para>
	      Displays a window containing information about
	      <application>Galeon</application>.
            </para></listitem>
          </varlistentry>

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

  </sect1>

  <sect1 id="toolbar">
    <title>The Main Toolbar</title>
    <para>
      The main toolbar contains controls that let you use
      <application>Galeon</application> to browse the Web more efficiently.
      <figure id="toolbars-main.png">
        <title>The Main Toolbar</title>
        <screenshot>
          <graphic fileref="figures/toolbars-main" format="PNG"></graphic>
        </screenshot>
      </figure>
      You can enable, disable, or rearrange the order of the items
      appearing in the toolbar.  These and other related options are
      described in <xref linkend="prefs-user-interface-toolbars"/>.
      Additionally, a context menu allowing control of the appearance of
      the toolbar is available by clicking a blank space on the toolbar
      with the right mouse button.  An alphabetical listing of the
      controls, along with brief descriptions of their functions, follows.

      <variablelist>

        <varlistentry>
          <term><guibutton>Back</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Back</guibutton> button will go back to
	    the previous page in the browser's history.  To get a list of
	    pages in the browser's back history, press and hold the right
	    mouse button when the mouse pointer is over the button.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Back History</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Back history</guibutton> button
	    displays a menu listing the pages in the browser's back
	    history.  The menu is identical to the one that is displayed
	    when right-clicking the <guibutton>Back</guibutton> button.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Bookmarks</guibutton> button</term>
          <listitem><para>
	    Pressing the <guibutton>Bookmarks</guibutton> button toggles
	    the display of the <link linkend="bookmarks-editor">Bookmarks
	    Editor</link> dock.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Drag handle</guibutton> icon</term>
          <listitem><para>
	    <application>Galeon</application> supports Drag and Drop (DnD)
	    extensively.  If you have the appropriate option set, as
	    described in <xref linkend="prefs-user-interface-mouse"/>,
	    pressing and holding the left mouse button on the
	    <guibutton>Link drag</guibutton> icon (blue globe with a red
	    arrow) allows you to drag a copy of the URL to your desktop, a
	    terminal window, the bookmarks editor or temporary bookmarks
	    window, another <application>Galeon</application> window (or
	    tab label in tabbed mode), or any other DnD enabled
	    application. You can also drag links directly from web pages.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Find</guibutton> entry</term>
          <listitem><para>
	    The <guibutton>Find</guibutton> entry can be used to find text
	    within the current page.  Typing text into the entry and pressing
	    <keycap>Enter</keycap> repeatedly will cycle through the matching
	    text in the page by highlighting it.  If no matches are found,
	    nothing will happen.
	  </para><para>
	    The <guibutton>Find</guibutton> entry also keeps a history of
	    previous searches.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Forward</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Forward</guibutton> button will go
	    forward to the next page in the browser's history.  To get a
	    list of pages in the browser's forward history, press and hold
	    the right mouse button when the mouse pointer is over the
	    button.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Forward History</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Forward history</guibutton> button
	    displays a menu listing the pages in the browser's forward
	    history.  The menu is identical to the one that is displayed
	    when right-clicking the <guibutton>Forward</guibutton> button.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Go</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Go</guibutton> button will load
	    whatever location is currently in the location bar.  Clicking
	    the button with the middle mouse button will load the page in a
	    new window or tab, useful for cloning the current browser.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>History</guibutton> button</term>
          <listitem><para>
	    Pressing the <guibutton>History</guibutton> button toggles the
	    display of the <link linkend="history">History</link> dock.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Home</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Home</guibutton> button will load your
	    home page, which can be set as described in <xref
	    linkend="prefs-browsing-general"/>.  Clicking the button with
	    the middle mouse button will load your home page in a new
	    window or tab.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Location</guibutton> entry</term>
          <listitem><para>
	    The <guibutton>Location</guibutton> entry is where you enter
	    URLs that you want to visit.  Once you have typed an address
	    into the entry, pressing <keycap>Enter</keycap> or clicking on
	    the <guibutton>Go</guibutton> button will load the page.
          </para><para>
	    The <guibutton>Location</guibutton> entry also keeps a history
	    of previous addresses that were typed into it. Pressing the
	    arrow button will display a list of recently typed URLs.  If
	    the <guibutton>Go</guibutton> button is turned on, clicking on
	    an item in this list will replace the contents of the entry bar
	    but will not load the page. If the <guibutton>Go</guibutton>
	    button is turned off, the page will automatically be loaded.
          </para><para>
	    Finally, the location entry supports autocompletion. Once you
	    start typing in the location bar, your history will be searched
	    and the first possible match will be displayed.  If this is not
	    the URL you had in mind, continue typing or hit the
	    <keycap>Tab</keycap> key.  If you hit the <keycap>Tab</keycap>
	    key, a list of all possible matches will be display below the
	    location bar.  Click on an item or use the up/down arrow keys
	    and press <keycap>Enter</keycap> to load the desired URL. If
	    you have disabled autocompletion, as described in <xref
	    linkend="prefs-browsing-history"/>, hitting
	    <keycap>Tab</keycap> will complete the URL that you are typing
	    and will show the alternatives window.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>New</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>New</guibutton> button will open a
	    either a new window or a new tab, depending on the value of the
	    <guilabel>Open in tabs by default</guilabel> setting on the
	    <link linkend="prefs-user-interface-tabs">Tabs page of the
	    Preferences window</link>.  To choose whether the new browser
	    should be in a window or a tab, press and hold the right mouse
	    button when the mouse pointer is over the button and select the
	    appropriate item from the menu that results.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Print</guibutton> button</term>
          <listitem><para>
	    Pressing the <guibutton>Print</guibutton> button displays the
	    Print dialog, allowing you to print the current page.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Reload</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Reload</guibutton> button will reload
	    the page that is currently being viewed.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Spinner</guibutton></term>
          <listitem><para>
	    The <guibutton>Spinner</guibutton> is the <application>Galeon
	    </application> equivalent of the "throbber" in
	    <application>Netscape</application> or <application>Mozilla
	    </application>.  During a page load, the spinner plays back an
	    animation. Clicking on the spinner will take you to the Galeon
	    homepage.  You can change the animation that is shown, or turn
	    off the spinner altogether, on the <link
	    linkend="prefs-user-interface-toolbars">Toolbars page of the
	    Preferences window</link>.
	  </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Stop</guibutton> button</term>
          <listitem><para>
	    Pressing the <guibutton>Stop</guibutton> button immediately
	    stops the loading of the current page.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Up</guibutton> button</term>
          <listitem><para>
	    Clicking the <guibutton>Up</guibutton> button will load the
	    page in the next-highest directory of the current URL.  For
	    example, pressing the button while at
	    <literal>http://www.example.com/a/b/</literal> would cause the
	    URL <literal>http://www.example.com/a/</literal> to be loaded.
          </para></listitem>
        </varlistentry>

        <varlistentry>
          <term><guibutton>Zoom control</guibutton> spinbutton</term>
          <listitem><para>
	    The <guibutton>Zoom control</guibutton> spinbutton allows you
	    to easily change the size of the fonts on the page being
	    viewed.  Pressing the up arrow will increase the size of the
	    fonts on the page, while pressing the down arrow will decrease
	    the size of the fonts on the page.  Additionally, you can set
	    the zoom to an arbitrary number by typing in the entry field.
          </para></listitem>
        </varlistentry>

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

  <sect1 id="statusbar">
  <title>The Statusbar</title>
    <para>
      The statusbar at the bottom of the window displays messages relating
      to network activity, and also contains a meter showing the progress
      of the page currently being loaded and a security icon.  When the
      cursor is over a link, the statusbar shows the target of the link.
      Some pages contain JavaScript code that writes messages into the
      statusbar.  To prevent pages from writing to the statusbar, uncheck
      the <guibutton>Allow statusbar messages</guibutton> option, described
      in <xref linkend="prefs-advanced-filtering"/>.
    </para>
    <para>The security icon is located in the far right of the statusbar.
      When the security icon field displays an open lock, the
      connection to the current web server is not encrypted, and it is
      possible for eavesdroppers to see sensitive information
      (such as addresses or credit card numbers) in transit.  When the
      field displays a closed lock, the connection is encrypted.
    </para>
  </sect1>

  <sect1 id="tabbed-browsing">
  <title>Tabbed Browsing</title>
    <para>
      <application>Galeon</application>'s "tabbed browsing" feature can
      help you avoid cluttering your desktop with browser windows.
      Multiple pages can be stored in a single
      <application>Galeon</application> window, and you can switch between
      them with a click of the mouse.  The behavior of the tabbed browsing
      mode can be configured in the <link
      linkend="prefs-user-interface-tabs">"Tabs" page of the Preferences
      Window</link>.
    </para>
    <figure id="tabbed-browsing.png">
      <title>Tabbed Browsing in Galeon</title>
      <screenshot>
        <graphic fileref="figures/tabbed-browsing" format="PNG"></graphic>
      </screenshot>
    </figure>
    <para>
      To start using tabs, either create a new tab through the <link
      linkend="menubar-file"><guimenu>File menu</guimenu></link> or open a
      link in a new tab by right-clicking it and choosing the
      <guimenuitem>Open in a new tab</guimenuitem> item from the context
      menu.  By default, a tab listing will appear below the toolbar at the
      top of the window.  You can also drag links onto a tab to have that
      link loaded in a particular tabbed window. This is handy if you want
      to load a page in a different tab than the one you are currently
      viewing but don't necessarily want to open a new tab.
    </para>
    <para>
      You can switch to different pages by clicking on their corresponding
      tabs.  When the tab listing becomes too long to fit in the window,
      arrows will appear at its right, allowing you to scroll through the
      listing.  Additionally, right-clicking on a tab will display a menu
      containing all of the tabs.  The <guimenuitem>Previous
      tab</guimenuitem> and <guimenuitem>Next tab</guimenuitem> menu items
      in the <link linkend="menubar-tab"><guimenu>Tab menu</guimenu></link>
      allow you to jump to the previous or next tab in the listing.
      Finally, you can jump directly to a tab by typing <keycombo>
      <keycap>Alt</keycap><keycap>[0-9]</keycap> </keycombo> where 1 is the
      first page and 0 is the tenth page.
    </para>
    <para>
      You can close tabs either by making them active and then using the
      <guimenuitem>Close</guimenuitem> item from the <link
      linkend="menubar-file"><guimenu>File menu</guimenu></link>, or by
      clicking the small "X" button that (configurably) appears at the
      right edge of each tab.
    </para>
    <para>
    <!--
      Tabs can also be moved, either to different positions in the listing
      or to different windows altogether.  The easiest way to do this is by
      holding the left mouse button down on a tab and dragging it either to
      another tab or to another window.  Alternately, you can use the
      <guimenuitem>Move tab left / up</guimenuitem> and <guimenuitem>Move
      tab right / down</guimenuitem> menu items in the <link
      linkend="menubar-tab"><guimenu>Tab menu</guimenu></link> to shift a
      tab within its current tab listing.  The <guimenuitem>Detach
      tab</guimenuitem> item will move the currently selected tab into a
      new window.
      -->
      Tabs can also be moved, either to different positions in the listing
      or to different windows altogether, by use of the items in the <link
      linkend="menubar-tab"><guimenu>Tab menu</guimenu></link>.
    </para>
  </sect1>

  <sect1 id="full-screen-mode">
  <title>Full Screen Mode</title>
    <para>
      Browsing in full screen mode can be very handy if you're running at a
      low resolution and find it difficult to fit the contents of pages in
      <application>Galeon</application>'s window.
    </para>
    <para>
      When you enable this option, through the <guimenu>View</guimenu> menu
      (described in <xref linkend="menubar-view"/>) or by hitting the
      <keycap>F11</keycap> key, the window will be expanded to fill the
      entire screen and the visibility of the menubar, toolbars, and
      statusbar will be toggled off.  The visibility of these components of
      the interface can be enabled again by typing the appropriate
      shortcuts:
      <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>M</keycap></keycombo> for the
      menubar, <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>T</keycap></keycombo>
      for the toolbars, and
      <keycombo><keycap>Shift</keycap><keycap>Ctrl</keycap><keycap>S</keycap></keycombo>
      for the statusbar.  Full screen mode can be toggled off in the same
      ways that can be used to toggle it on.
       <tip>
          <title>Tip</title>
	  <para>
	    It's possible to browse in full screen mode with the menubar,
	    toolbars, and status bar turned off.  Navigation controls are
	    available from the context menu or through keyboard shortcuts,
	    and a bookmark listing can be displayed by clicking the
	    <mousebutton>middle</mousebutton> mouse button.  To enter a new
	    URL, just hit
	    <keycombo><keycap>Ctrl</keycap><keycap>O</keycap></keycombo> to
	    display the dialog box.
	  </para>
       </tip>
     </para>
  </sect1>

</chapter>
