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

  <preface id="introduction">
<!-- =============Introduction ============================= -->
    <title>Introduction</title> 

    <sect1 id="what"> 
      <title>What is Galeon?</title>
      <para>
	<application>Galeon</application> is a web browser built around
	Gecko (<ulink url="http://www.mozilla.org/"><application>Mozilla
	</application></ulink>'s rendering engine)
	and Necko (<application>Mozilla</application>'s networking engine).
	It's a <ulink url="http://www.gnome.org/">GNOME</ulink> web browser,
	designed to take advantage of as many GNOME technologies as makes
	sense. Galeon was written to do just one thing - <emphasis>browse the
        web</emphasis>.
      </para>

      <para>
         Here's a list of some of <application>Galeon</application>'s features:
      </para>

      <para>
         GNOME integrated
      </para>
	<para>
         <itemizedlist>
  	    <listitem>
               <para>Uses global GNOME themes and settings</para>
            </listitem>
	    <listitem>
	       <para>Translations available for many languages</para>
	    </listitem>
	    <listitem>
	       <para>CORBA used for automation</para>
	    </listitem>
	    <listitem>
	       <para>Extensive Drag and Drop support</para>
	    </listitem>
	 </itemizedlist>
	</para>    
      <para>
         Mozilla powered
      </para>
	<para>
	 <itemizedlist>
	    <listitem>
	       <para>Fast, feature complete rendering engine</para>
	    </listitem>
	    <listitem>
	       <para>Support for SSL, Java, Javascript and plugins</para>
	    </listitem>
	 </itemizedlist>
	 </para>   
      <para>
         Advanced bookmarks features
      </para>
	<para>
	 <itemizedlist>
	    <listitem>
	       <para>Import and export bookmarks from Netscape / Mozilla / Epiphany and Konqueror</para>
	    </listitem>
	    <listitem>
	       <para>Ability to display multiple bookmarks toolbars</para>
	    </listitem>
	    <listitem>
	       <para>Builtin editor</para>
	    </listitem>
	    <listitem>
	       <para>Bookmark nicks</para>
	    </listitem>
	    <listitem>
	       <para>Bookmarks represented by images</para>
	    </listitem>
	    <listitem>
	       <para>"Smart Bookmarks" (bookmarks with parameters)</para>
	    </listitem>
	    <listitem>
	       <para>Dynamically generated page with all your bookmarks
	       (My Portal)</para>
	    </listitem>
	 </itemizedlist>
	</para>   
      <para>
         Configurable
      </para>
	<para>
	 <itemizedlist>
	    <listitem>
	       <para>Browse with multiple windows, a notebook (tabbed)
	       interface, or a combination of the two</para>
	    </listitem>
	    <listitem>
	       <para>Fullscreen browsing mode</para>
	    </listitem>
	    <listitem>
	       <para>Configurable mouse button actions</para>
	    </listitem>
	    <listitem>
	       <para>Adjustable layout, spinner, colours, fonts</para>
	    </listitem>
	 </itemizedlist>
	</para>    
      <para>
         And more!
      </para>
	<para>
	 <itemizedlist>
	    <listitem>
	       <para>URL autocompletion based on history</para>
	    </listitem>
	    <listitem>
	       <para>Automatic session recovery</para>
	    </listitem>
	    <listitem>
	       <para>Filter cookies, adverts, popups</para>
	    </listitem>
	    <listitem>
	       <para>"Favicon" support, allowing
	       <application>Galeon</application> to automatically download
	       and use icons provided by websites</para>
	    </listitem>
	 </itemizedlist>
	</para>
      <para>
        Because it's part of the GNOME project,
        <application>Galeon</application> is Free Software.  The
        program and its source code are released under the terms of
        the GNU <ulink type="help" url="gnome-help:gpl"><citetitle>General
        Public License (GPL)</citetitle></ulink>, and the
        documentation falls under the <ulink type="help"
        url="gnome-help:fdl"><citetitle>Free Documentation
        License</citetitle></ulink> (FDL). For more information about
        the GPL and the FDL, visit the Free Software Foundation's
        website at <ulink url="http://www.fsf.org">http://www.fsf.org</ulink>.
      </para>
      <para>
        <note>
           <title>Feedback</title>
           <para>
             Feedback can be made to the <email>galeon-user@lists.sourceforge,net</email>
             mailing list. You can report feature requests or bugs at 
             <ulink url="http://bugzilla.gnome.org">Bugzilla</ulink>
	     or with the GNOME <application>Bug Report Tool</application>
	     (known as <command>bug-buddy</command> at the command line).
          </para>
        </note>
      </para>

  </sect1>
  <sect1 id="aboutbook">
      <title>About This Book</title>
        <para>
	This version of the <application>Galeon</application> User's Guide
	is a <emphasis>draft</emphasis>. It describes version 1.3 of the
	software. The content is subject to change, especially if you help.
	Please send comments on the guide to
	<email>galeon-user@list.sourceforge.net</email>. If you would like
	to work on the guide please send mail to
	<email>galeon-devel@lists.sourceforge.net</email>.
      </para>
  
      <formalpara>
        <title>Typographical conventions</title>
	<para>
          Some kinds of words are marked off with special typography:
          <simplelist>
	    <member><application>Applications</application></member>
	    <member><command>Commands</command> typed at the command line</member>
	    <member><guilabel>Labels</guilabel> for interface items</member>

            <member> Menu selections look like this:
                       <menuchoice>
                          <guimenu>Menu</guimenu>
                          <guisubmenu>Submenu</guisubmenu> 
                          <guimenuitem>Menu Item</guimenuitem>
                     </menuchoice>
            </member>
	    <member><guibutton>Buttons</guibutton> you can
            click</member> <member><userinput>Anything you type
            in</userinput></member> <member><computeroutput>Text
            output from a computer</computeroutput></member>
	  </simplelist>
        </para>
      </formalpara>
  </sect1>

<!-- maybe we should include something like this:
  <sect1 id="commontasks">
    <title>Quick Reference for Common Tasks</title>
    <para>
        You might want to get a copy of this section and tape it to
        the wall next to your computer: it's a very short summary of
        most of the things you'll want to do with
        <application>Evolution</application>, and pointers to the
        sections of the book where you'll find more in-depth
        description of those tasks.
    </para>
    <sect2 id="quickref-newthings">
      <title>Opening or Creating Anything</title>
      <para>
         Here are the keyboard shortcuts and menu items you're most
         likely to use: (Please note that the shortcuts listed are
         probably wrong at this point).
         
          <variablelist>

	  <varlistentry>
	    <term>Create a new folder</term>
	    <listitem>
	      <para>
                <menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu>
                <guimenuitem>Folder</guimenuitem></menuchoice> or
                <keycombo action="simul">
		  <keycap>Ctrl</keycap>
		  <keycap>Shift </keycap>
		  <keycap>F</keycap>
                </keycombo>
                </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Create a new Shortcut in the Evolution Bar</term>
	    <listitem>
	      <para>       
                  <menuchoice><guimenu>File</guimenu>
		  <guisubmenu>New</guisubmenu>
		  <guimenuitem>Evolution Bar Shortcut</guimenuitem> </menuchoice> or 
                <keycombo action="simul">
		  <keycap>Ctrl</keycap>
		  <keycap>Shift</keycap>
		  <keycap>S</keycap>
                </keycombo>
                </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Create a new email message:</term>
	    <listitem>
	      <para>
                Use
                <menuchoice><guimenu>File</guimenu><guisubmenu>New</guisubmenu><guimenuitem>Mail
                Message</guimenuitem>  </menuchoice> or 
                <keycombo action="simul">
		  <keycap>Ctrl</keycap>
		  <keycap>Shift </keycap>
		  <keycap>M</keycap>
                </keycombo>
              </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Create a new Appointment</term>
	    <listitem>
	      <para>       
                  <menuchoice><guimenu>File</guimenu>
		  <guisubmenu>New</guisubmenu>
		  <guimenuitem>Appointment</guimenuitem> </menuchoice>  or 
                <keycombo action="simul">
		  <keycap>Ctrl</keycap>
		  <keycap>Shift</keycap>
		  <keycap>A</keycap>
                </keycombo>
                </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Create a new Task</term>
	    <listitem>
	      <para>       
                  <menuchoice><guimenu>File</guimenu>
		  <guisubmenu>New</guisubmenu>
		  <guimenuitem>Task</guimenuitem>  </menuchoice> or 
                <keycombo action="simul">
		  <keycap>Ctrl</keycap>
		  <keycap>Shift</keycap>
		  <keycap>T</keycap>
                </keycombo>
                </para>
	    </listitem>
	  </varlistentry>

	  <varlistentry>
	    <term>Enter a new Contact</term>
	    <listitem>
	      <para>       
                  <menuchoice><guimenu>File</guimenu>
		  <guisubmenu>New</guisubmenu>
		  <guimenuitem>Contact</guimenuitem> </menuchoice>  or 
                <keycombo action="simul">
		  <keycap>Ctrl</keycap>
		  <keycap>Shift</keycap>
		  <keycap>C</keycap>
                </keycombo>
                </para>
	    </listitem>
	  </varlistentry>
	</variablelist>
      </para>
    </sect2> 
    <sect2 id="quickref-mail">
      <title>Mail Tasks</title>
      <para>
        Here are the most frequent email tasks, and shortcuts for navigating your mailbox with the keyboard instead of the mouse:
         <variablelist>
	  <varlistentry>
	    <term>Check Mail</term>
	    <listitem>
	      <para>
                Click <guibutton>Get Mail</guibutton> in the toolbar, or press 
                <keycombo action="simul">
		  <keycap>FIXME</keycap>
		  <keycap>FIXME</keycap>
		  <keycap>FIXME</keycap>
                </keycombo>
                </para>
	    </listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Reply to a Message</term>
	    <listitem>
	      <para>
                To reply to the sender of the message only:
                click <guibutton>Reply</guibutton> in the
                toolbar, or press
                <keycombo action="simul">
		  <keycap>FIXME</keycap>
		  <keycap>FIXME</keycap>
		  <keycap>FIXME</keycap>
                </keycombo>
                </para>
	      <para>
                To reply to the sender and all the other visible
                recipients of the message, click:
              </para>
	    </listitem>
	  </varlistentry>
	  
          <varlistentry>
	    <term>Forward a Message</term>
	    <listitem>
	      <para>
                Select the message or messages you want to forward,
                and click <guibutton>Forward</guibutton> in the
                toolbar, or press
                <keycombo action="simul">
		  <keycap>FIXME</keycap>
		  <keycap>FIXME</keycap>
		  <keycap>FIXME</keycap>
                </keycombo>
                </para>
	    </listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Open a Message in a New Window</term>
	    <listitem>
	      <para>
                Double-click the message you want to view, or select
                it and press
                <keycombo action="simul">
		  <keycap>Ctrl</keycap>
		  <keycap>O</keycap>
                </keycombo>
                </para>
	    </listitem>
	  </varlistentry>

          <varlistentry>
	    <term>Create Filters and vFolders</term>
	    <listitem>
	      <para>
                You can create filters and vFolders based on specific
                message attributes by right-clicking on a message or
                by selecting <menuchoice> <guimenu>Tools</guimenu>
                <guimenuitem>Mail Filters</guimenuitem> </menuchoice>
                or <menuchoice> <guimenu>Tools</guimenu>
                <guimenuitem>vFolder Editor</guimenuitem>
                </menuchoice>.  Filters are discussed in <xref
                linkend="usage-mail-organize-filters">, and vFolders
                in <xref linkend="usage-mail-organize-vfolders">.
            </para>
	    </listitem>
	</varlistentry>
	</variablelist>

        </para>
      </sect2>
      <sect2 id="quickref-cal">
        <title>Calendar</title>
        <para>
        <variablelist>
	  <varlistentry>
	    <term></term>
	    <listitem>
	      <para>
               </para>
	    </listitem>
	    </varlistentry>
	  </variablelist>

        </para>
      </sect2>
      <sect2 id="quickref-contact">
        <title>Contact Manager</title>
        <para>


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


        </para>
      </sect2>
    </sect1>
-->
  </preface>
