<?xml version="1.0" standalone="no"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" 
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [
  <!ENTITY app "Gnumeric">
  <!ENTITY appversion "1.2">
  <!ENTITY manrevision "1.2">
  <!ENTITY date "September 2003">
  <!ENTITY file-format-open "Excel 95/97/2000, gnumeric XML, HTML, 
           comma separated CSV, Applix,  Lotus 1-2-3, GNU oleo">


  <!ENTITY legal                SYSTEM "legal.xml">

  <!ENTITY welcome              SYSTEM "welcome.xml">
  <!ENTITY manual-usage         SYSTEM "manual-usage.xml">
  <!ENTITY quick-start          SYSTEM "quick-start.xml">

  <!ENTITY gui-overview	        SYSTEM "gui-overview.xml">
  <!ENTITY gui-menus            SYSTEM "gui-menus.xml">
  <!ENTITY gui-toolbars	        SYSTEM "gui-toolbars.xml">
  <!ENTITY gui-other-elements   SYSTEM "gui-other-elements.xml">
  <!ENTITY gui-mouse            SYSTEM "gui-mouse.xml">



  <!ENTITY data-overview        SYSTEM "data-overview.xml">
  <!ENTITY data-types           SYSTEM "data-types.xml">
  <!ENTITY data-entry           SYSTEM "data-entry.xml">
  <!ENTITY data-entry-adv       SYSTEM "data-entry-advanced.xml">
  <!ENTITY data-entry-extern    SYSTEM "data-entry-external.xml">
  <!ENTITY data-selections      SYSTEM "data-selections.xml">
  <!ENTITY data-move-copy       SYSTEM "data-move-copy.xml">
  <!ENTITY data-delete          SYSTEM "data-delete.xml">
  <!ENTITY data-insert          SYSTEM "data-insert.xml">
  <!ENTITY data-format          SYSTEM "data-format.xml">
  <!ENTITY data-modify          SYSTEM "data-modify.xml">
  <!ENTITY data-generate        SYSTEM "data-generate.xml">
  <!ENTITY data-commentNlink    SYSTEM "data-commentNlink.xml">

  <!ENTITY f-worksheets         SYSTEM "worksheets.xml">

  <!ENTITY f-workbooks          SYSTEM "workbooks.xml">

  <!ENTITY graphics-overview    SYSTEM "graphics-overview.xml">
  <!ENTITY graphics-plots       SYSTEM "graphics-plots.xml">
  <!ENTITY graphics-images      SYSTEM "graphics-images.xml">
  <!ENTITY graphics-drawings    SYSTEM "graphics-drawings.xml">

  <!ENTITY files-overview       SYSTEM "files-overview.xml">
  <!ENTITY files-opening        SYSTEM "files-opening.xml">
  <!ENTITY files-saving         SYSTEM "files-saving.xml">
  <!ENTITY files-autosave       SYSTEM "files-autosave.xml">

  <!ENTITY printing             SYSTEM "printing.xml">

  <!ENTITY config-overview      SYSTEM "configuration-overview.xml">
  <!ENTITY config-toolbars      SYSTEM "configuration-toolbars.xml">
  <!ENTITY config-preferences   SYSTEM "configuration-preferences.xml">
  <!ENTITY config-plugins       SYSTEM "configuration-plugins.xml">
  <!ENTITY config-localization  SYSTEM "configuration-localization.xml">

  <!ENTITY analysis-overview    SYSTEM "analysis-overview.xml">
  <!ENTITY analysis-statistical SYSTEM "analysis-statistical.xml">
  <!ENTITY analysis-complexNum  SYSTEM "analysis-complexNumbers.xml">
  <!ENTITY analysis-solver      SYSTEM "analysis-solver.xml">
  <!ENTITY analysis-simulation  SYSTEM "analysis-simulation.xml">
  <!ENTITY analysis-scenarios   SYSTEM "analysis-scenarios.xml">
  <!ENTITY analysis-goalseek    SYSTEM "analysis-goalseek.xml">

  <!ENTITY morehelp             SYSTEM "morehelp.xml">

  <!ENTITY extending-overview   SYSTEM "extending-overview.xml">
  <!ENTITY extending-functions  SYSTEM "extending-functions.xml">
  <!ENTITY extending-python     SYSTEM "extending-python.xml">
  <!ENTITY extending-plugins    SYSTEM "extending-plugins.xml">
  <!ENTITY extending-code       SYSTEM "extending-code.xml">

  <!ENTITY about-history        SYSTEM "about-history.xml">
  <!ENTITY about-authors        SYSTEM "about-authors.xml">
  <!ENTITY about-license        SYSTEM "about-license.xml">
  <!ENTITY about-compiling      SYSTEM "about-compiling.xml">
  <!ENTITY about-get-involved   SYSTEM "about-get-involved.xml">
  

  <!ENTITY function-ref	        SYSTEM "functions.xml">

  <!ENTITY appendix-keybindings SYSTEM "appendix-keybindings.xml">
  <!ENTITY appendix-glossary    SYSTEM "appendix-glossary.xml">
]>


<!-- 
      (Do not remove this comment block.)
  Maintained by the GNOME Documentation Project
  http://developer.gnome.org/projects/gdp
  Template version: 2.0 beta
  Template last modified Feb 12, 2002
  
-->
<!-- =============Document Header ============================= -->
<book id="index" lang="en">
<!-- please do not change the id; for translations, change lang to -->
<!-- appropriate code -->
  <title>The Gnumeric Manual, version 1.2</title>

  <bookinfo>

<!-- 
    <abstract>
      <para>
        This manual describes <application>Gnumeric</application>, a
        spreadsheet produced by the GNOME project. The manual provides
        a brief introduction to spreadsheets, describes exhaustively
        all of the elements of the program and explains how to use the
        program.
      </para>
    </abstract>
-->

    <copyright>
      <year>2003</year>
      <holder>Kevin Breit, Adrian Custer, Ray Dassen, 
              Jody Goldberg, Andreas J. Guelzow, Jon K. Hellan, 
              Jukka-Pekka Iivonen, Alexander Kirillov, 
              Charles Twardy.
      </holder> 
    </copyright>
  <!-- translators: uncomment this:
    <copyright>
   	<year>2003</year>
   	<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
    </copyright>
   -->

    <copyright>
      <year>2002</year>
      <holder>Jody Goldberg, Andreas J. Guelzow, Wayne Schuller, 
              Adrian Custer, Kevin Breit, Aaron Weber, 
              Alexander Kirillov, Eric Baudais, Gregory Leblanc.
      </holder> 
    </copyright>
  <!-- translators: uncomment this:
    <copyright>
   	<year>2002</year>
   	<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
    </copyright>
   -->

    <copyright>
      <year>1998</year>
      <year>1999</year>
      <year>2000</year>
      <year>2001</year>
      <holder>Miguel de Icaza, Thomas Canty, Jukka-Pekka Iivonen,
              Almer S. Tigelaar, Morten Welinder.
      </holder> 
    </copyright>
  <!-- translators: uncomment this:
    <copyright>
        <year>1998</year>
        <year>1999</year>
        <year>2000</year>
   	<year>2001</year>
   	<holder>ME-THE-TRANSLATOR (Latin translation)</holder>
    </copyright>
   -->

    <publisher> 
      <publishername> GNOME Documentation Project </publishername> 
    </publisher> 

    <!-- This file  contains link to license for the documentation 
         (GNU FDL), and other legal stuff such as "NO WARRANTY" 
         statement. Please do not change any of this. 
    -->
    &legal;

    <authorgroup> 
      <author> 
        <firstname>Eric</firstname>
	<surname>Baudais</surname> 
        <email>baudais@okstate.edu</email>
      </author>
      <author> 
        <firstname>Kevin</firstname>
	<surname>Breit</surname>  
       <email>mrproper@ximian.com</email>
      </author>
      <author> 
        <firstname>Thomas</firstname>
	<surname>Canty</surname> 
        <email>tommydal@ihug.com.au</email>
      </author>
      <author> 
        <firstname>Adrian</firstname>
	<surname>Custer</surname> 
        <email>acuster@gnome.org</email>
      </author>
      <author> 
        <firstname>Ray</firstname>
	<surname>Dassen</surname> 
        <email>jdassen@debian.org</email>
      </author>
      <author>
        <firstname>Jody</firstname>
        <surname>Goldberg</surname> 
        <email>jody@gnome.org</email>
      </author>
      <author> 
        <firstname>Andreas</firstname>
	<surname>Guelzow</surname> 
        <email>aguelzow@taliesin.ca</email>
      </author>
      <author> 
        <firstname>Jon K.</firstname>
	<surname>Hellan</surname> 
        <email>hellan@acm.org</email>
      </author>
      <author> 
        <firstname>Miguel</firstname>
	<surname>de Icaza</surname>
        <email>miguel@gnu.org</email>
      </author>
      <author> 
        <firstname>Jukka-Pekka</firstname>
	<surname>Iivonen</surname> 
        <email>jiivonen@hutcs.cs.hut.fi</email>
      </author>
      <author> 
        <firstname>Alexander</firstname>
	<surname>Kirillov</surname> 
        <email>kirillov@math.sunysb.edu</email>
      </author>
      <author> 
        <firstname>Gregory</firstname>
	<surname>Leblanc</surname>
        <email>gleblanc@linuxweasel.com</email>
      </author>
      <author> 
        <firstname>Wayne</firstname>
	<surname>Schuller</surname>
        <email>k_wayne@linuxpower.org</email>
      </author>
      <author> 
        <firstname>Almer S.</firstname>
	<surname>Tigelaar</surname>
        <email>almer1@dds.nl</email>
      </author>
      <author> 
        <firstname>Charles</firstname>
	<surname>Twardy</surname>
        <email>ctwardy@mail.csse.monash.edu.au</email>
      </author>
      <author> 
        <firstname>Aaron</firstname>
	<surname>Weber</surname>
        <email>aaron@ximian.com</email>
      </author>
      <author> 
        <firstname>Morten</firstname>
	<surname>Welinder</surname>
        <email>terra@diku.dk</email>
      </author>
   <!-- This is appropriate place for other contributors: translators,
          maintainers,  etc. Commented out by default.
     <othercredit role="translator">
       <firstname>Latin</firstname> 
       <surname>Translator 1</surname> 
       <affiliation> 
	  <orgname>Latin Translation Team</orgname> 
	  <address> <email>translator@gnome.org</email> </address> 
       </affiliation>
       <contrib>Latin translation</contrib>
     </othercredit>
   -->
    </authorgroup> 


    <revhistory>
      <revision> 
	<revnumber>Gnumeric Manual: Version &manrevision;</revnumber> 
	<date>&date;</date> 
	<revdescription> 
	  <para role="author">The Gnumeric Team</para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision>
      <revision> 
	<revnumber>Gnumeric Manual: Version 1.0</revnumber> 
	<date>January 2002</date> 
	<revdescription> 
	  <para role="author">The Gnumeric Team</para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision>
      <revision> 
	<revnumber>Gnumeric Manual: Earlier Versions</revnumber> 
	<date>1998-2001</date> 
	<revdescription> 
	  <para role="author">The Gnumeric Team</para>
	  <para role="publisher">GNOME Documentation Project</para>
	</revdescription> 
      </revision>
    </revhistory>

    <releaseinfo>This manual describes version &appversion; of &app;.
    </releaseinfo> 
    <legalnotice> 
      <title>Feedback</title> 
      <para>
        To report a bug or make a suggestion regarding the &app;
        application or this manual, follow the directions in the
        <ulink url="ghelp:gnome-feedback" type="help">GNOME Feedback
        Page</ulink>.
      </para>
<!-- Translators may also add here feedback address for translations -->
    </legalnotice> 
  </bookinfo>

<!-- ============= Index         ============================= -->
<!--
  <indexterm> 
    <primary>Gnumeric</primary> 
  </indexterm>
  <indexterm> 
    <primary>GNOME Spreadsheet</primary> 
  </indexterm> 
  <indexterm> 
    <primary>Office</primary> 
  </indexterm> 
-->

<!-- ============= Document Body ============================= -->
    <!-- Note: keep the chapter introductions presented here 
         synched up with those in manual-usage.xml -->

  <chapter id="chapter-welcome">
    <title>Welcome!</title>

    &welcome;

  </chapter>



  <chapter id="chapter-manual-usage">
    <title>How to Use this Manual</title>

    &manual-usage;

  </chapter>



  <chapter id="chapter-quick-start">
    <title>A Quick Introduction</title>

    <para>
      This chapter of the manual explains the fundamentals of
      spreadsheets in general and of
      <application>Gnumeric</application> in particular. The chapter
      attempts to help new users get started with
      <application>Gnumeric</application> and provides background for
      the more detailled explanations given in the rest of the manual.
    </para>

    &quick-start;

  </chapter>



  <chapter id="chapter-gui-elements">
    <title>The Elements of Gnumeric</title>

    <para>
      This chapter describes all of the pieces of
      <application>Gnumeric</application> which a user can
      manipulate. The chapter provides explanations for each of the
      menus, menu entries, toolbar buttons and other elements of the
      graphical user interface.
    </para>

    <note>
      <para>
        This chapter has not yet been updated for the 1.2 release of
        <application>Gnumeric</application> but still describes the
        earlier releases. The descriptions will still be generally
        useful to those attempting to understand the menu entries of
        <application>Gnumeric</application> 1.2. This chapter will be
        updated as time permits.
      </para>
    </note>

    &gui-overview;
    &gui-menus;
    &gui-toolbars;
    &gui-other-elements;
    &gui-mouse;

  </chapter>



  <chapter id="chapter-data">
    <title>Working with Data</title>

    <para>
      This chapter explains the core functionality of
      <application>Gnumeric</application> including the basic types of
      data manipulated by <application>Gnumeric</application>, the
      methods of entering, manipulating and formating data, and the
      basic tools for analysis of these data. More advanced analysis is
      described in <xref linkend="chapter-advanced-analysis" />.
    </para>

    &data-overview;
    &data-types;
    &data-entry;
    &data-entry-adv;
    &data-entry-extern;
    &data-selections;
    &data-move-copy;
    &data-delete;
    &data-insert;
    &data-format;
    &data-modify;
    &data-generate;
    &data-commentNlink;

  </chapter>



  <chapter id="chapter-advanced-analysis">
    <title>Advanced Analysis</title>

    <para>
      This chapter explains many of the advanced analytic tools
      available in <application>Gnumeric</application> including
      statistical analysis, linear algebra calculations and simulation
      analysis.
    </para>

    &analysis-overview;
    &analysis-complexNum;
    &analysis-goalseek;
    &analysis-solver;
    &analysis-simulation;
    &analysis-scenarios;
    &analysis-statistical;
  </chapter>





  <chapter id="chapter-graphics">
    <title>Graphics: Plots, Images and Drawings</title>

    <para>
      This chapter explains how to use
      <application>Gnumeric</application> to add graphical elements to
      a worksheet. Data plots allow users to create charts of data in
      a worksheet including pie charts, bar and column charts and
      scatterplots. Images in standard computer formats can be added
      on top of a worksheet. Drawings allow users to add simple
      graphical elements on top of a worksheet including lines, arrows
      and simple polygons.
    </para>

    &graphics-overview;
    &graphics-plots;
    &graphics-images;
    &graphics-drawings;

  </chapter>



  <chapter id="chapter-worksheets">
    <title>Managing and Viewing Worksheets</title>

    <para>
      This chapter explains how to manage worksheets and manipulate
      the view of the worksheet contents.
    </para>

    &f-worksheets;

  </chapter>



  <chapter id="chapter-workbooks">
    <title>Workbook Settings</title>

    <para>
      This chapter explains the contents of a
      <application>Gnumeric</application> workbook which are not part
      of the worksheets. This includes several settings which apply to
      the workbook and are saved in the
      <application>Gnumeric</application> file. Settings which apply
      to the <application>Gnumeric</application> program itself are
      called `preferences' and are explained in <xref
      linkend="chapter-configuring" />.
    </para>

    &f-workbooks;

  </chapter>



  <chapter id="chapter-configuring">
    <title>Configuring Gnumeric</title>

    <para>
      This chapter explains how to change the default behaviour of
      <application>Gnumeric</application> including the startup
      behaviour and default locale (language and number display).
    </para>

    &config-overview;
    &config-toolbars;
    &config-preferences;
    &config-plugins;
    &config-localization;

  </chapter>



  <chapter id="chapter-files">
    <title>File Opening and Saving</title>

    <para>
      This chapter explains how to use files in
      <application>Gnumeric</application> including how to save the
      current file, how to change the file format of saved files and
      how to open files from a different format.
    </para>

    &files-overview;
    &files-opening;
    &files-saving;
    &files-autosave;

  </chapter>



  <chapter id="chapter-printing">
    <title>Printing</title>

    <para>
      This chapter explains how to print spreadsheets, tables and
      plots from <application>Gnumeric</application> to a printer
      directly or into Postscript or PDF (both are page description
      languages).
    </para>

    &printing;

  </chapter>



  <chapter id="chapter-morehelp">
    <title>Getting Help from Other Sources</title>

    <para>
      This chapter describes other sources of help which are available
      to users including the <application>Gnumeric</application> web
      site, the mailing list, and the internet relay chat (IRC)
      discussion channel. The chapter also explains how to tell the
      project about a problem with the program.
    </para>

    &morehelp;

  </chapter>



  <chapter id="chapter-extending">
    <title>Extending Gnumeric</title>

    <para>
      This chapter explains how to go about extending
      <application>Gnumeric</application> to provide extra
      functionality. Because <application>Gnumeric</application> is
      Free Software this is quite easy to do.
    </para>

    &extending-overview;
    &extending-functions;
    &extending-python;
    &extending-plugins;
    &extending-code;

  </chapter>



  <chapter id="chapter-about">
    <title>About Gnumeric</title>

    <para>
      This chapter provides some background information on the
      creation and distribution of
      <application>Gnumeric</application>.
    </para>

    &about-history;
    &about-authors;
    &about-license;
    &about-compiling;
    &about-get-involved;

  </chapter>



<!-- ============= Appendices ================================ -->

  <appendix id="function-reference">
    <title>Function Reference</title>

    <para>
      This appendix provides a list of all the functions which are
      currently defined in <application>Gnumeric</application>.
    </para>

    &function-ref;

  </appendix>



  <appendix id="keybinding">
    <title>Keybinding Reference</title>

    <para>
      This appendix lists the keyboard shortcuts which are defined by
      default in <application>Gnumeric</application>.
    </para>

    &appendix-keybindings;

  </appendix>


<!--

  <appendix id="glossary">
    <title>Glossary</title>

    <para>
      This appendix defines certain terms used in this manual.
    </para>

    &appendix-glossary;

  </appendix>

-->


</book>

