Commit eabe7652 authored by Kevin Breit's avatar Kevin Breit Committed by Kevin Breit
Browse files

I added a bunch of files to CVS for the XML conversion. I also made

2002-01-05  Kevin Breit  <mrproper@ximian.com>

	* new/gnumeric.xml: I added a bunch of files to CVS for the XML conversion.  I also made changes to this so stuff would work.
parent a47f49d1
2002-01-05 Kevin Breit <mrproper@ximian.com>
* new/gnumeric.xml: I added a bunch of files to CVS for the XML conversion. I also made changes to this so stuff would work.
2002-01-04 Kevin Breit <mrproper@ximian.com>
* new/gnumeric.xml: Added my name to the author list
......
2002-01-05 Kevin Breit <mrproper@ximian.com>
* new/gnumeric.xml: I added a bunch of files to CVS for the XML conversion. I also made changes to this so stuff would work.
2002-01-04 Kevin Breit <mrproper@ximian.com>
* new/gnumeric.xml: Added my name to the author list
......
<sect1 id="authors-intro">
<title>Authors</title>
<table frame='none'>
<title><application>Gnumeric</application> was written by</title>
<tgroup cols='3' align='left' colsep='0' rowsep='0'>
<tbody>
<row>
<entry>Miguel de Icaza</entry>
<entry>Creator</entry><entry>
<email>miguel@gnome.com</email></entry>
</row>
<row>
<entry>Jody Goldberg</entry>
<entry>Maintainer</entry><entry>
<email>jody@gnome.org</email></entry>
</row>
<row>
<entry>Morten Welinder</entry>
<entry>Core development, Purification</entry>
</row>
<row>
<entry>Jon K. Hellan</entry>
<entry>Core Development, GUI</entry>
</row>
<row>
<entry>Jukka-Pekka Iivonen</entry>
<entry>Core Development, Functions and Tools</entry>
</row>
<row>
<entry>Michael Meeks</entry>
<entry>Core Development, Excel</entry>
</row>
<row>
<entry>Almer S. Tigelaar</entry>
<entry>Core Development, STF, Autoformat</entry>
</row>
<row>
<entry>Sean Atkinson</entry>
<entry>Functions and X-Base importing</entry>
</row>
<row>
<entry>Kenneth Christiansen</entry>
<entry>i18n, misc stuff</entry>
</row>
<row>
<entry>Zbigniew Chyla</entry>
<entry>Plugin system, i18n, python</entry>
</row>
<row>
<entry>Tom Dyas</entry>
<entry>Plugin system</entry>
</row>
<row>
<entry>ERDI Gergo</entry>
<entry>Misc widgets</entry>
</row>
<row>
<entry>Andreas J. Guelzow</entry>
<entry>Statistics Tools, HTML and LaTeX exporters</entry>
</row>
<row>
<entry>Ross Ihaka</entry>
<entry>Special functions</entry>
</row>
<row>
<entry>Lutz Muller</entry>
<entry>SheetObject improvement</entry>
</row>
<row>
<entry>Yukihiro Nakai</entry>
<entry>Input method and multi-byte character support</entry>
</row>
<row>
<entry>Federico M. Quintero</entry>
<entry>Canvas support</entry>
</row>
<row>
<entry>JP Rosevear</entry>
<entry>Sorting, and INDEX</entry>
</row>
<row>
<entry>Ariel Rios</entry>
<entry>Guile support</entry>
</row>
<row>
<entry>Mark Probst</entry>
<entry>Guile support</entry>
</row>
<row>
<entry>Frank Chiulli</entry>
<entry>OLE support</entry>
</row>
<row>
<entry>Arturo Tena</entry>
<entry>OLE support</entry>
</row>
<row>
<entry>Tuomas Kuosmanen</entry>
<entry>Art</entry>
</row>
<row>
<entry>Jakub Steiner</entry>
<entry>Art</entry>
</row>
<row>
<entry>Grandma Chema Celorio</entry>
<entry>QA and sheet copy.</entry>
</row>
<row>
<entry>Juan Pablo</entry>
<entry>QA</entry>
</row>
<row>
<entry>Kevin Breit</entry>
<entry>Documentation</entry>
</row>
<row>
<entry>Thomas Canty</entry>
<entry>Documentation</entry>
</row>
<row>
<entry>Adrian Custer</entry>
<entry>QA, Documentation</entry>
</row>
<row>
<entry>Adrian Likins</entry>
<entry>QA, Documentation</entry>
</row>
<row>
<entry>Wayne Schuller</entry>
<entry>Documentation, printer headers</entry>
</row>
<row>
<entry>Aaron Weber</entry>
<entry>Documentation</entry>
</row>
<row>
<entry>Alexander Kirillov</entry>
<entry>Documentation</entry>
</row>
<row>
<entry>J.H.M. (Ray) Dassen</entry>
<entry>Debian packaging</entry>
</row>
<row>
<entry>John Gotts</entry>
<entry>RPM packaging</entry>
</row>
<row>
<entry>Takashi Matsuda</entry>
<entry>Original text plugin</entry>
</row>
<row>
<entry>Vincent Renardias</entry>
<entry>Original CSV support</entry>
</row>
<row>
<entry>Alan Cox</entry>
<entry>2nd csv plugin</entry>
</row>
<row>
<entry>Bruno Unna</entry>
<entry>Original fmt dialog</entry>
</row>
<row>
<entry>Daniel Veillard</entry>
<entry>Original DOM support</entry>
</row>
<row>
<entry>Vladimir Vuksan</entry>
<entry>Original financial functions</entry>
</row>
<row>
<entry>Jakub Jelinek</entry>
<entry>Early canvas work</entry>
</row>
<row>
<entry>Chris Lahey</entry>
<entry>Original number format engine</entry>
</row>
<row>
<entry>Rasca</entry>
<entry>Original HTML, Troff, LaTeX exporters</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
To find more information about
<application>Gnumeric</application>, please visit the
<ulink url="http://www.gnumeric.org" type="http">Web site</ulink>.
</para>
<para>
If you have some comments or suggestions regarding this application or
documentation, need help, or want to report a bug, please contact us!
Either via the <ulink url="http://bugzilla.gnome.org/enter_bug.cgi?product=Gnumeric" type="http">web</ulink>.
or on the mailing list
</para>
<!-- For translations: uncomment this:
<para>
Latin translation was done by ME
(<email>MYNAME@MYADDRESS</email>). Please send all comments and
suggestions regarding this translation to SOMEWHERE.
</para>
-->
</sect1>
<sect1 id="autocorrect">
<title>AutoCorrect Tool</title>
<para>
The auto-correction tool recognizes and attempts to automaticly repair
several common typing errors. The corrections are configured and activated
using AutoCorrect Dialog, available via ``Auto Correct'' in the ``Tools''
menu.
</para>
<figure id="autocorrect-figure">
<title>The Auto Correct dialog.</title>
<screenshot>
<graphic fileref="figures/auto-correct.png"></graphic>
</screenshot>
</figure>
<sect2 id="correct-initial-capitals">
<title>Correct TWo INitial CApitals</title>
<para>A common mistake is to hold down the shift key a little bit
too long while typing initial letters. When it happens, you will
get two initial capitals instead of one. If this correction rule
is activated, the second letter of words beginning with two
capital letters is automatically lowercased. For example, if you
type `TOtal' into a cell it is replaced by `Total'. Note that if
the word contains two capital letters only, it is not
replaced.</para>
<para>It is possible to specify exceptions to this tool. For
example, you do not want the tool to replace the word `PVbonds'
when it is typed. To specify exceptions, press the
``Exceptions...'' button in the dialog. This should pop up the
``Auto correct exceptions'' dialog. In this dialog, select the
``INitial CApitals'' page. In this page, type `PVbonds' into the
``Do not correct'' entry, and press ``Add'' button. Now the word
should be included in the list of exceptions. To remove a word
from the list, select the word and press the ``Remove'' button.
If you now press ``Ok'' the exceptions in the list are
activated.</para>
</sect2>
<sect2 id="correct-first-letter">
<title>Capitalize first letter of sentence</title>
<para>If this correction rule is activated, the first letter of a
sentence typed into a cell is capitalized, if it is a lowercase
letter in the first place. Only text that ends to a dot is
considered a sentence.</para>
<para>It is possible to specify exceptions to this tool. For
example, you do not want the tool to capitalize letters after
acronym `i.g.'. To specify exceptions, press the
``Exceptions...'' button in the dialog. This should pop up the
``Auto correct exceptions'' dialog. In this dialog, select the
``First letter'' page. In this page, type `i.g.' into the ``Do
not capitalize after'' entry, and press ``Add'' button. Now the
word should be included in the list of exceptions. To remove a
word from the list, select the word and press the ``Remove''
button. If you now press ``Ok'' the exceptions in the list are
activated.</para>
</sect2>
<sect2 id="correct-capitalize-days">
<title>Capitalize names of days</title>
<para>If this correction rule is activated, the first letter of a
name of a day is capitalized automatically. For example, if you
type `monday', it is automatically replaced by `Monday'.</para>
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
<sect1 id="cell-referencing">
<title>Cell Referencing</title>
<para>
Each cell in a spreadsheet is named by its column and row
labels. The row labels are numbers and the column labels are
letters. The first cell, therefore, is called A1. One row down
and one column over is cell B2, and so forth.
</para>
<para>
To reference the value stored in a single cell, enter its
coordinates as a function argument. For example, to have the data
in cell B1 appear in another cell, enter =B1 into that cell.
</para>
<example id="simplecellrefer">
<title>Some examples of function syntax</title>
<programlisting>
=EXP(B1)
=COS(A2)
</programlisting>
</example>
<sect2>
<title>Absolute cell referencing</title>
<para>Cells can be referenced in the default way (relative
referencing), or by using absolute referening. Absolute
referencing means that when the cell is copied, the cell
reference does not change. Normally, autofilling a cell range or
moving cell will change its cell reference to so that it
maintains a relation to the original cell. Absolute referencing
prevents these changes.
</para>
<tip id="why-bother">
<title>When Does Relative Referencing Make a Difference?</title>
<para>
The difference between absolute and relative cell references
only matters if you are copying or moving cells that contain
cell references. For cells that are going to remain in place,
both the relative and absolute references have the same result.
</para>
</tip>
<example id="relative-referencing-explained">
<title>Relative References</title>
<para>
For example, if =A1 is the formula entered into cell B2, cell
B2 will displat the data in cell A1, which is one row up and
one column left. Then, if you copy the contents of B2 to cell
F6, cell F6 will contain the value from E5, which is also one
row up and one column left.
</para>
<para>
For the copied cell to still refer to A1, specify absolute
references using the $ character: $A$1 refers to cell A1, no
matter where it is copied.
</para>
</example>
<para>
The format for absolute cell refencing is to use a '$' in front
of the cell coordinate that the you want to stay constant. The
column, row, sheet, or any combination of these can be held
constant.
</para>
<example id="cell-refer-absolute-reference">
<title>Absolute cell referencing examples</title>
<para>
What happens when a given formula is entered into cell B2,
then copied to other cells?
<variablelist>
<varlistentry>
<term>=A1</term>
<listitem><para>
=A1 is a normal, or relative, cell reference
function. When =A1 is entered into cell B2, it refers to
the value of data one cell up and one cell left from the
cell it is in. Therefore the value displayed in cell C2
will be the value of data in cell B1. Copied to cell R19,
the formula will display the data in cell Q18.
</para></listitem>
</varlistentry>
<varlistentry>
<term>=$A1</term>
<listitem><para>
In this case, the column value is absolute, but the row
value is relative. Therefore, if =$A1 is entered into
cell B2, the formula refers to the data in column A that
is one row up from the current location. Copied to cell
C2, the formula will refer to the data in cell A1. Copied
to cell R19, it will refer to the data in A18.
</para></listitem>
</varlistentry>
<varlistentry>
<term>=A$1</term>
<listitem><para>
This formula uses a relative column value and an
absolute row value. In cell B2, it refers to cell A1 as
the data in the cell one column left and in row
1. Copied to cell C3, the formula will display the data
in cell B1.
</para></listitem>
</varlistentry>
<varlistentry>
<term>=$A$1</term> <listitem><para> No matter where this
formula is copied, it will always refer to the data in
cell A1. </para></listitem>
</varlistentry>
</variablelist>
</para>
</example>
</sect2>
<sect2>
<title>Referencing multiple cells</title>
<para>Many functions can take multiple cells as arguments. This
can either be a comma separated list, an array, or any
combination thereof.</para>
<sect3>
<title>Multiple individual cells</title>
<para>A comma separated list of cell references can be used to
indicate cells that are discontinuous.</para>
<example id="cellrefermutiplecells">
<title>Some examples of function syntax</title>
<programlisting>
=SUM(A1,B2,C4)
=MIN(A1,B2, C4,C5,D6)
</programlisting>
</example>
<screenshot>
<graphic fileref="figures/cells-1.png" format="PNG"></graphic>
</screenshot>
</sect3>
<sect3>
<title>Referencing a continuous region of cells</title>
<para>For functions that take more than one argument, it is often
easier to reference the cells as a group. This can include
cells in sets horizontally, vertically, or in arrays.</para>
<para>The ':' operator is used to indicate a range of cells. The basic
syntax is upper left corner:bottom right corner. </para>
<example id="cellrefercontin">
<title>Referencing blocks of cells</title>
<programlisting>
=SUM(A1:E1)
=AVERAGE(B4:E7)
=MIN(A1:A5)
</programlisting>
</example>
<screenshot>
<graphic fileref="figures/cells-2.png" format="PNG"></graphic>
</screenshot>
</sect3>
<sect3>
<title>Referencing non-continuous regions</title>
<para>For referencing cells that are in non-continuous regions,
you can use any combination of the above methods to get
the needed cells.</para>
<example id="cellreferdiscontin">
<title>Referencing blocks of cells</title>
<programlisting>
=SUM(A1:E1, B19, L14:L17)
=AVERAGE(A1,A3, A5:C5)
</programlisting>
</example>
</sect3>
</sect2>
<sect2>
<title>Referencing cells on other sheets</title>
<para>It is possible to reference cells which are not part of the
current sheet. This is done using the NAME!CELL syntax,
where NAME is an identifier (usually a sheet name) and CELL is a
regular cell reference as described in the previous
sections.</para>
<para>Note that if NAME contains spaces, you need to quote the
whole name to allow Gnumeric to group the separate words in NAME
as single name. For example, you should use "Sheet 0" when
referencing the default created "Sheet 0".</para>
<example id="simple-sheet-ref">
<title>Referencing values in other sheets</title>
<programlisting>
='Sheet 0'!A1+'Sheet 3'!A5
=SUM('Sheet 1'!A1:'Sheet 1'!A5)
</programlisting>
</example>
</sect2>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->
This diff is collapsed.
<sect1 id="filter">
<title>Data Filters</title>
<para>With data filters you can select a subset of rows in the
worksheet that meet the given criteria. You can, for example, copy
rows of a table containing sales of departments whose profit has
been exceptionally high into a new sheet simply using a
filter.</para>
<sect2 id="advanced-filter">
<title>Advanced Filter</title>
<para>To use advanced filter, you should have a few blank rows
available in your worksheet to be used as a criteria range.
These rows should not overlap with the rows in the table to be
filtered.</para>
<para>Now copy all the column labels from the table you want to
filter into the first blank row in the criteria range. Below the
criteria labels, you can now type the conditions you want to
match for the particular label. For example, under a label
`Profit' you could type `>=1000'. The tool selects only rows
that match all the criteria.</para>
<figure id="advanced-filter-1-figure">
<title>Worksheet containing the table to be filtered and a
simple criteria</title>
<screenshot>
<graphic fileref="figures/advanced-filter-1.png" format="PNG"></graphic>
</screenshot>
</figure>
<para>It is possible to have many conditions for a single label.
For example, you can select the departments whose profit is
either very high or very low. To do this, type, for example,
<![CDATA[ `<=0' below the `>=40000' ]]> condition.</para>
<figure id="advanced-filter-2-figure">
<title>Criteria for selecting rows whose `Profit' column is between
0 and 40000.</title>
<screenshot>
<graphic fileref="figures/advanced-filter-2.png" format="PNG"></graphic>
</screenshot>
</figure>
<para>To start the tool, select ``Advanced Filter'' from the
``Data'' menu. It brings you the advanced filter dialog. In the
dialog, select the action you want to take.</para>
<figure id="advanced-filter-dialog-figure">
<title>The Advanced Filter dialog.</title>
<screenshot>
<graphic fileref="figures/filter.png" format="PNG"></graphic>
</screenshot>
</figure>
<para>``Filter in-place'' writes the new table in-place. Note
that you will loose all the rows in the table that will not match
the criteria. ``Copy to a new location'' copies the selected
rows into the same sheet but into the specified cell range. Type
the cell range into the ``Copy to'' entry if you want this action
to happen. The other options let you to copy the selected rows
into a new sheet or a new workbook.</para>
<para>You should then specify the cell range containing the table
to be filtered in the ``List range'' entry. The cell range
containing the criteria is specified in the ``Criteria range''
entry. If the original table contains duplicate rows, you may
also want to specify the ``Unique records only''. If it is
checked on, the filter removes all duplicates.</para>
<para>To start the tool, you can then click the ``OK'' button and
you will get the new table.</para>