Commit 408a1251 authored by Adrian Likins's avatar Adrian Likins Committed by Adrian Likins
Browse files

Minor updates, new info on formatting, spelling and formatting fixes.

1998-09-39 Adrian Likins <adrian@gimp.org>

        * doc/autofill.sgml, sell_refer.sgml, editing.sgml,
          gnumeric.sgml, number-format.sgml, worksheet.sgml:
            Minor updates, new info on formatting, spelling
            and formatting fixes.

        * doc/selection.sgml, selections.sgml: removed selection.sgml
        and added selections.sgml.

        * doc/images/worksheet-data-[1234].jpg,
        worksheet-running-calc-1.jpg, number-format-dialog-1.jpg:
        more pics to go along with the docs.


I got a ton of merge conflicts on my last update, so i may
have missed some of the new stuff when I was correcting them,
but I think I got everything. Everything should be spellchecked
now an formatted correctly.

-adrian
parent 3a8efdd5
1998-09-39 Adrian Likins <adrian@gimp.org>
* doc/autofill.sgml, sell_refer.sgml, editing.sgml,
gnumeric.sgml, number-format.sgml, worksheet.sgml:
Minor updates, new info on formatting, spelling
and formatting fixes.
* doc/selection.sgml, selections.sgml: removed selection.sgml
and added selections.sgml.
* doc/images/worksheet-data-[1234].jpg,
worksheet-running-calc-1.jpg, number-format-dialog-1.jpg:
more pics to go along with the docs.
1998-09-30 Miguel de Icaza <miguel@nuclecu.unam.mx>
* src/workbook.c (quick_compute_routines): Made static
......
1998-09-39 Adrian Likins <adrian@gimp.org>
* doc/autofill.sgml, sell_refer.sgml, editing.sgml,
gnumeric.sgml, number-format.sgml, worksheet.sgml:
Minor updates, new info on formatting, spelling
and formatting fixes.
* doc/selection.sgml, selections.sgml: removed selection.sgml
and added selections.sgml.
* doc/images/worksheet-data-[1234].jpg,
worksheet-running-calc-1.jpg, number-format-dialog-1.jpg:
more pics to go along with the docs.
1998-09-30 Miguel de Icaza <miguel@nuclecu.unam.mx>
* src/workbook.c (quick_compute_routines): Made static
......
1998-09-39 Adrian Likins <adrian@gimp.org>
* doc/autofill.sgml, sell_refer.sgml, editing.sgml,
gnumeric.sgml, number-format.sgml, worksheet.sgml:
Minor updates, new info on formatting, spelling
and formatting fixes.
* doc/selection.sgml, selections.sgml: removed selection.sgml
and added selections.sgml.
* doc/images/worksheet-data-[1234].jpg,
worksheet-running-calc-1.jpg, number-format-dialog-1.jpg:
more pics to go along with the docs.
1998-09-30 Miguel de Icaza <miguel@nuclecu.unam.mx>
* src/workbook.c (quick_compute_routines): Made static
......
1998-09-39 Adrian Likins <adrian@gimp.org>
* doc/autofill.sgml, sell_refer.sgml, editing.sgml,
gnumeric.sgml, number-format.sgml, worksheet.sgml:
Minor updates, new info on formatting, spelling
and formatting fixes.
* doc/selection.sgml, selections.sgml: removed selection.sgml
and added selections.sgml.
* doc/images/worksheet-data-[1234].jpg,
worksheet-running-calc-1.jpg, number-format-dialog-1.jpg:
more pics to go along with the docs.
1998-09-30 Miguel de Icaza <miguel@nuclecu.unam.mx>
* src/workbook.c (quick_compute_routines): Made static
......
<sect1>
<title>Autofill</title>
<para>When dealing with spreadsheets it's pretty typical to want to
add a set of cells that contain a series of numbers or dates or other
values. While this can be done by hand, Gnumeric implements an autofill
option to allow these sorts of series to be easily fill in.</para>
<title>Autofill</title>
<para>When dealing with spreadsheets it's pretty typical to want to
add a set of cells that contain a series of numbers or dates or other
values. While this can be done by hand, Gnumeric implements an autofill
option to allow these sorts of series to be easily fill in.</para>
<para>A typical example of when you want to use this feature is to fill
a serie of numbers, maybe a list of part numbers, or a perhaps a list
of TV channels. To create a list like this, all the user needs to do
is to enter the first number into a cell and click on the autofill
cursor in the bottom right corner of the cell border and drag it in
the direction to fill. If the first cell contains a '1', for example,
dragging the autofill button(see <xref linkend="celltobautofilled">) down three or four cells
will fill the cells with 1,2,3,4 automatically.(see <xref linkend="cellsautofilled">)</para>
a series of numbers maybe a list of part numbers, or a perhaps a list
of TV channels. To create a list like this, all the user needs to do
is to enter the first number into a cell and click on the autofill
cursor in the bottom right corner of the cell border and drag it in
the direction to fill. If the first cell contains a '1', for example,
dragging the autofill button(see <xref linkend="celltobautofilled">) down three or four cells
will fill the cells with 1,2,3,4 automatically.(see <xref linkend="cellsautofilled">)</para>
<itemizedlist>
<listitem><para>Select the cell that marks the begining of the
area to autofill</para></listitem>
<listitem><para>Enter the starting value into this cell</para></listitem>
<listitem><para>Click the small rectangle in the bottom right corner
of the first cell, and drag it to the end of the area to fill.</para></listitem>
<listitem><para>Release the mouse button. The cells in the selected area should
now be field with autofilled values</para></listitem>
<listitem><para>Select the cell that marks the beginning of the
area to autofill</para></listitem>
<listitem><para>Enter the starting value into this cell</para></listitem>
<listitem><para>Click the small rectangle in the bottom right corner
of the first cell, and drag it to the end of the area to fill.</para></listitem>
<listitem><para>Release the mouse button. The cells in the selected area should
now be field with autofilled values</para></listitem>
</itemizedlist>
<figure id="celltobautofilled">
<title>A cell with the seed for an autofill.</title>
<screenshot>
<title>A cell with the seed for an autofill.</title>
<screenshot>
<graphic fileref="images/autofill-1.jpg"></graphic>
</screenshot>
</screenshot>
</figure>
<figure id="cellsautofilled">
<title>A set of cells being autofill'ed</title>
<screenshot>
<graphic fileref="images/autofill-2.jpg"></graphic>
</screenshot>
<figure id="cellsautofilled">
<title>A set of cells being autofill'ed</title>
<screenshot>
<graphic fileref="images/autofill-2.jpg"></graphic>
</screenshot>
</figure>
<para>As handy as being able to simply and quickly generate series of
numbers incremented by one, autofill can do much much more. The next simplest
example is autofilling with a series with an increment other than 1. For example,
to create a series that consist of odd numbers starting at 11, just enter 11 into
a cell and 13 into the next cell. Then select both cells, and stretch it to the
cover the cells to be filled. If you select the next 5 cells for example, it will
fill with values 11,13,15,17,19,21,23. See <xref linkend="seedcellautofillsequence">
and <xref linkend="autofillsequence"> for example.</para>
numbers incremented by one, autofill can do much much more. The next simplest
example is autofilling with a series with an increment other than 1. For example,
to create a series that consist of odd numbers starting at 11, just enter 11 into
a cell and 13 into the next cell. Then select both cells, and stretch it to the
cover the cells to be filled. If you select the next 5 cells for example, it will
fill with values 11,13,15,17,19,21,23. See <xref linkend="seedcellautofillsequence">
and <xref linkend="autofillsequence"> for example.</para>
<figure id="seedcellautofillsequence">
<title>A seed cell for a date autofill.</title>
<screenshot>
<graphic fileref="images/autofill-3.jpg"></graphic>
</screenshot>
<title>A seed cell for a date autofill.</title>
<screenshot>
<graphic fileref="images/autofill-3.jpg"></graphic>
</screenshot>
</figure>
<figure id="autofillsequence">
<figure id="autofillsequence">
<title>A set of cells being filled with a sequence.</title>
<screenshot>
<graphic fileref="images/autofill-4.jpg"></graphic>
</screenshot>
<screenshot>
<graphic fileref="images/autofill-4.jpg"></graphic>
</screenshot>
</figure>
<sect2>
<title>Filling with Dates</title>
<para>Oh, but numbers are easy you say! The real painful stuff is entering
in cell by cell dates and times and other info. But never fear, Gnumeric is there
to help you. Gnumeric has the ability to autofill dates, months, days of the week,
and more. </para>
<title>Filling with Dates</title>
<para>Oh, but numbers are easy you say! The real painful stuff is entering
in cell by cell dates and times and other info. But never fear, Gnumeric is there
to help you. Gnumeric has the ability to autofill dates, months, days of the week,
and more. </para>
<para> For an example, think of a typical business invoice, where everything is
logged by the month. So it is quite typically to want to fill a series of cells
with the months of the year in order. To do this is quite simple, essentially the
same steps as making a numerical fill.</para>
<para>Starting from cell B2 for example, if you want to fill the next 12 cells
with the months, just enter the string "January" in B2. Then, click the fill button
and stretch it over the next 12 cells, and release. Simple as that. See <xref
linkend="datefillseed">, <xref linkend="datebeingfilled">, and
<xref linkend="cellsfilled">. </para>
logged by the month. So it is quite typically to want to fill a series of cells
with the months of the year in order. To do this is quite simple, essentially the
same steps as making a numerical fill.</para>
<para>Starting from cell B2 for example, if you want to fill the next 12 cells
with the months, just enter the string "January" in B2. Then, click the fill button
and stretch it over the next 12 cells, and release. Simple as that. See <xref
linkend="datefillseed">, <xref linkend="datebeingfilled">, and
<xref linkend="cellsfilled">. </para>
<figure id="datefillseed">
<title>A cell with a date in it, ready to be the seed for a fill.</title>
<screenshot>
<graphic fileref="images/autofill-5.jpg"></graphic>
</screenshot>
</figure>
<figure id="datebeingfilled">
<title>A set of cells being filled.</title>
<screenshot>
<graphic fileref="images/autofill-6.jpg"></graphic>
</screenshot>
</figure>
<figure id="cellsfilled">
<title>A range of cells autofilled with the months.</title>
<screenshot>
<graphic fileref="images/autofill-7.jpg"></graphic>
</screenshot>
<title>A cell with a date in it, ready to be the seed for a fill.</title>
<screenshot>
<graphic fileref="images/autofill-5.jpg"></graphic>
</screenshot>
</figure>
<figure id="datebeingfilled">
<title>A set of cells being filled.</title>
<screenshot>
<graphic fileref="images/autofill-6.jpg"></graphic>
</screenshot>
</figure>
<figure id="cellsfilled">
<title>A range of cells autofilled with the months.</title>
<screenshot>
<graphic fileref="images/autofill-7.jpg"></graphic>
</screenshot>
</figure>
<para> Other examples of strings that can be autofilled include days of
the week (Monday, Tuesday,...), short weekdays (Mon, Tues, ....),
short months (Jan, Feb,...) </para>
<para> More string fill types to follow </para>
<para> Other examples of strings that can be autofilled include days of
the week (Monday, Tuesday,...), short weekdays (Mon, Tues, ....),
short months (Jan, Feb,...) </para>
<para> More string fill types to follow </para>
</sect2>
<sect2>
<title>String And Number autofill</title>
<para>Gnumeric tries to be intelligent about autofilling number values that
embedded into text strings. So its possible to autofill cells with values
like "9 lives to live","8 lives to live", etc. </para>
<para>See <xref linkend="autofillexamples"> for some contrived examples.</para>
<figure id="autofillexamples">
<title>Some simple autofill examples.</title>
<screenshot>
<graphic fileref="images/autofill-8.jpg"></graphic>
</screenshot>
</figure>
<sect2>
<title>String And Number autofill</title>
<para>Gnumeric tries to be intelligent about autofilling number values that
embedded into text strings. So its possible to autofill cells with values
like "9 lives to live","8 lives to live", etc. </para>
<para>See <xref linkend="autofillexamples"> for some contrived examples.</para>
<figure id="autofillexamples">
<title>Some simple autofill examples.</title>
<screenshot>
<graphic fileref="images/autofill-8.jpg"></graphic>
</screenshot>
</figure>
</sect2>
<sect2>
<title>Formula autofill</title>
<para>Probably the most useful of all the autofill capabilties is
the ability to autofill functions. In practice it works essentialy the
same as all the other autofill methods, it just transfers the funtions
of course. </para>
<para>See <xref linkend="autofillfunction1"> and <xref linkend="autofillfunction2">
for a simple example.</para>
<figure id="autofillfunction1">
<title>Formula to be autofilled.</title>
<screenshot>
<graphic fileref="images/autofill-9.jpg"></graphic>
</screenshot>
</figure>
<figure id="autofillfunction2">
<title>Formula autofilled to several cells.</title>
<screenshot>
<graphic fileref="images/autofill-10.jpg"></graphic>
</screenshot>
</figure>
</sect2>
<sect2>
<title>Other Notes on autofill</title>
<itemizedlist>
<listitem><para>Autofills only work to the down and to the right of a cell.</para>
</listitem>
<listitem><para>To make a series that decrements insteads of incrementing, enter the
highest value into the first cell, then the next value in the second cell and select
them both in the first step outlined above. </para>
</listitem>
<listitem><para>Starting a serie with more than two inital values can result in
some unexpected results. Use with care.</para>
</listitem>
<title>Formula autofill</title>
<para>Probably the most useful of all the autofill capabilities is
the abilty to autofill functions. In practice it works essentials the
same as all the other autofill methods, it just transfers the functions
of course. </para>
<para>See <xref linkend="autofillfunction1"> and <xref linkend="autofillfunction2">
for a simple example.</para>
<figure id="autofillfunction1">
<title>Formula to be autofilled.</title>
<screenshot>
<graphic fileref="images/autofill-9.jpg"></graphic>
</screenshot>
</figure>
<figure id="autofillfunction2">
<title>Formula autofilled to several cells.</title>
<screenshot>
<graphic fileref="images/autofill-10.jpg"></graphic>
</screenshot>
</figure>
</sect2>
<sect2>
<title>Other Notes on autofill</title>
<itemizedlist>
<listitem>
<para>Autofills only work to the down and to the right of a cell.</para>
</listitem>
<listitem>
<para>To make a series that decrements instead of incrementing, enter the
highest value into the first cell, then the next value in the second cell and select
them both in the first step outlined above. </para>
</listitem>
<listitem>
<para>Starting a series with more than two initial values can result in
some unexpected results. Use with care.</para>
</listitem>
</itemizedlist>
</sect2>
</sect1>
</itemizedlist>
</sect2>
<!-- 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>
......@@ -31,78 +31,104 @@ be a comma seperated list, an array, or any combination thereof.</para>
<para>A comma seperated list of cell references can be used to
indicate cells that are discontinous.</para>
<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="images/cells-1.jpg"></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="images/cells-2.jpg"></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>
</sect1>
<example id="cellrefermutiplecells">
<title>Some examples of function syntax</title>
<programlisting>
=SUM(A1,B2,C4)
=MIN(A1,B2, C4,C5,D6)
</programlisting>
</example>
<screenshot>
<screeninfo>Figure 10.
</screeninfo>
<graphic fileref="images/cells-1.jpg"></graphic>
</screenshot>
</sect3>
<sect3>
<title>Referencing a continous 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 upperleft corner:bottom rigth corner. </para>
<example id="cellrefercontin">
<title>Referencing blocks of cells</title>
<programlisting>
=SUM(A1:E1)
=AVERAGE(B4:E7)
=MIN(A1:A5)
</programlisting>
</example>
<screenshot>
<screeninfo>Figure 10.
</screeninfo>
<graphic fileref="images/cells-2.jpg"></graphic>
</screenshot>
</sect3>
<sect3>
<title>Referencing non-continous regions</title>
<para>For referencing cells that are in non-continous 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>
</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>
<title>Strings and numbers</title>
<para>The basic forms of data that can be entered into a cell include
strings, numbers, formulas, and cell references. </para>
strings, numbers, formulas, and cell references. </para>
<para>The simplest of these types are strings and numbers. They are
just constant values that are stored in a cell. There is no special
syntax for this kind of data. The only limitation is that strings and
numbers can not contain newlines or begin with a '='. The '=' is
used to denote cells that contain formulas or cell references.</para>
just constant values that are stored in a cell. There is no special
syntax for this kind of data. The only limitation is that strings and
numbers can not contain newlines or begin with a '='. The '=' is
used to denote cells that contain formulas or cell references.</para>
<para>See <xref linkend="stringnumber"> for an example of entering
a string.</para>
<figure id="stringnumber">
<title>Entering strings and numbers.</title>
<screenshot>
<graphic fileref="images/editing-1.jpg"></graphic>
</screenshot>
a string.</para>
<figure id="stringnumber">
<title>Entering strings and numbers.</title>
<screenshot>
<graphic fileref="images/editing-1.jpg"></graphic>
</screenshot>
</figure>
</sect1>
<sect1>