Commit d67bf3db authored by Adrian Likins's avatar Adrian Likins Committed by Adrian Likins

guess what? doc updates.. mainly info on formatting cells.

1998-10-01 Adrian Likins <adrian@gimp.org>

        * src/*.sgml: guess what? doc updates.. mainly
	  info on formatting cells.

        * src/images/number-format-*.jpg: more images

-adrian
parent 77614479
1998-10-01 Adrian Likins <adrian@gimp.org>
* src/*.sgml: guess what? doc updates.. mainly
info on formatting cells.
* src/images/number-format-*.jpg: more images
1998-10-01 Miguel de Icaza <miguel@nuclecu.unam.mx>
* src/item-grid.c (item_grid_event): Removed unused variables
......
1998-10-01 Adrian Likins <adrian@gimp.org>
* src/*.sgml: guess what? doc updates.. mainly
info on formatting cells.
* src/images/number-format-*.jpg: more images
1998-10-01 Miguel de Icaza <miguel@nuclecu.unam.mx>
* src/item-grid.c (item_grid_event): Removed unused variables
......
1998-10-01 Adrian Likins <adrian@gimp.org>
* src/*.sgml: guess what? doc updates.. mainly
info on formatting cells.
* src/images/number-format-*.jpg: more images
1998-10-01 Miguel de Icaza <miguel@nuclecu.unam.mx>
* src/item-grid.c (item_grid_event): Removed unused variables
......
1998-10-01 Adrian Likins <adrian@gimp.org>
* src/*.sgml: guess what? doc updates.. mainly
info on formatting cells.
* src/images/number-format-*.jpg: more images
1998-10-01 Miguel de Icaza <miguel@nuclecu.unam.mx>
* src/item-grid.c (item_grid_event): Removed unused variables
......
<sect1>
<sect1 id="autofill">
<title>Autofill</title>
<para>When dealing with spreadsheets it's pretty typical to want to
......@@ -16,18 +16,23 @@
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 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>
<procedure>
<title>Autofilling a range of cells</title>
<step performance="required">
<para>Select the cell that marks the beginning of the
area to autofill</para></step>
<step performance="required">
<para>Enter the starting value into this cell</para></step>
<step performance="required">
<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></step>
<listitem><para>Release the mouse button. The cells in the selected area should
now be field with autofilled values</para></listitem>
</itemizedlist>
<step performance="required">
<para>Release the mouse button. The cells in the selected area should
now be field with autofilled values</para></step>
</procedure>
<figure id="celltobautofilled">
......@@ -38,7 +43,7 @@
</figure>
<figure id="cellsautofilled">
<title>A set of cells being autofill'ed</title>
<title>A set of cells being autofilled</title>
<screenshot>
<graphic fileref="images/autofill-2.jpg"></graphic>
</screenshot>
......@@ -137,7 +142,7 @@
<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
the ability to autofill functions. In practice it works essentials the
same as all the other autofill methods, it just transfers the functions
of course. </para>
......
<sect1>
<title>Cell Referencing</title>
<para>To reference the value stored in a single cell, say B1, just enter "B1"
in the function argument.</para>
<para>Cells are reference in a format like C4, where C is the column label
and 4 is the row label.</para>
<example id="simplecellrefer">
<title>Some examples of function syntax</title>
<programlisting>
=EXP(B1)
=COS(A2)
<sect1 id="cell-referencing">
<title>Cell Referencing</title>
<para>To reference the value stored in a single cell, say B1, just enter "B1"
in the function argument.</para>
<para>Cells are reference in a format like C4, where C is the column label
and 4 is the row label.</para>
<example id="simplecellrefer">
<title>Some examples of function syntax</title>
<programlisting>
=EXP(B1)
=COS(A2)
</programlisting>
</example>
</example>
<sect2>
<title>Absolute cell referencing</title>
<para>Cells can be referenced in the default way (relative referencing),
or with absolute referening. Absolute referencing means that when the cell
is copied, the cell reference doesnt change. Normally, autofill'ing a cell
range or moving cell will change its cell reference to so that it maintains
a relation to the original cell. With sbsolute cell referencing this behaviour is
overridden. </para>
<sect2>
<title>Referencing multiple cells</title>
<para>The format to use absolute cell refencing is to use a '$' in front of the
cell coordinate that the user wants to stay constant. The col, row, sheet, or
any combination of these can be held constant.</para>
<para>Many funtions can take multiple cells as arguments. This can either
be a comma seperated list, an array, or any combination thereof.</para>
<example id="cell-refer-absolute-reference">
<title>Absolute cell referencing examples</title>
<programlisting>
A1 Normal cell reference
$A2 Hold the column value constant
A$2 Hold the row value constant
$A$2 Hold row and columns constant.
</programlisting>
</example>
<sect3>
<title>Multiple individual cells</title>
</sect2>
<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>
<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>
<title>Some examples of function syntax</title>
<programlisting>
=SUM(A1,B2,C4)
<screenshot>
<graphic fileref="images/cells-1.jpg"></graphic>
</screenshot>
=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>
<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)
<screenshot>
=MIN(A1:A5)
</programlisting>
</example>
<screenshot>
<graphic fileref="images/cells-2.jpg"></graphic>
</screenshot>
</sect3>
<sect3>
<title>Referencing non-continuous regions</title>
</screenshot>
</sect3>
<sect3>
<title>Referencing non-continuous regions</title>
<para>For referencing cells that are in non-continuous regions
<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>
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>
<title>Referencing blocks of cells</title>
<programlisting>
=SUM(A1:E1, B19, L14:L17)
=AVERAGE(A1,A3, A5:C5)
</sect3>
</sect2>
</programlisting>
</example>
</sect3>
</sect2>
</sect1>
......
<sect1>
<title>Strings and numbers</title>
<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>
......@@ -19,16 +19,46 @@
<graphic fileref="images/editing-1.jpg"></graphic>
</screenshot>
</figure>
</sect1>
<sect1>
<title>Editing of cells.</title>
<para>To enter data into a cell, click on the cell with the white-cross
cursor. This will make the cell become the active cell (see <xref linkend="activecell">).
Then the user types in the data or formula for the cell.</para>
<sect2 id="entering-dates-and-numbers">
<title>Dates and Numbers</title>
<para>Dates and numbers are a special case of strings that are automatically
converted to numerical types. If a string entered matches one of the formats
for dates or times, the string is converted into a serial number (representitive
of the time in the string) and the cell format is set to that of the
original string.</para>
<para>To make use of this feature, the user just needs to enter in a number in
a recognizable format. Gnumeric will automatically convert it into an approriate serial
number. Because of this, it is possible to enter a date or time in a human readable
format, and have it stored in a numerical format inside of Gnumeric.</para>
<para>The interesting part of this is that a user entered string, can be autofilled (see
<xref linkend="autofill">) properly. </para>
<para>See <xref linkend="number-format-date-time-examples"> for some examples of
the many date and time formats that are accepted by Gnumeric.</para>
</SECT2>
<sect2>
<title>Editing of cells.</title>
<procedure>
<title>Entering data in a cell</title>
<step>
<para>Activate the cell by clicking on it with the white-cross cursor.
This will make the cell become the active cell (see <xref linkend="activecell">).
</para></step>
<step>
<para>Type in the data or formula.</para></step>
</procedure>
<para>See <xref linkend="formulas"> for more detail on entering formulas into cells.</para>
</sect2>
<sect2>
<title>Editing commands</title>
......@@ -46,8 +76,8 @@
<para>This mode is accessed by pressing <keycap>F2</keycap>. This shifts the
focus from the current cell to the editing region in the worksheet. This
allows more complete control over the text and data in the cell. This includes
the use of the cursor keys to postition the cursor within the data in the cell.</para>
<!-- FIXME need docs on the editing region to refer here -->
the use of the cursor keys to postition the cursor within the data in the cell.
See <xref linkend="worksheet-data-entry"> For more info on the data entry area.</para>
<variablelist>
<varlistentry>
......@@ -106,7 +136,8 @@
<listitem><para>Using the mouse to drag the selection</para></listitem>
</itemizedlist>
<sect2><title>Using the mouse to drag the selection</title>
<sect2>
<title>Using the mouse to drag the selection</title>
<para>Gnumeric allows the user to move and copy cells
and their contents by simply dragging and dropping the
......@@ -118,77 +149,115 @@
to its new location and release. The contents of the cell
will be moved to the new cell.</para>
<itemizedlist>
<listitem><para>Click <mousebutton>(MB1)</mousebutton> on the border (anywhere, except the autofill square in
the bottom right corner).<keycap>Ctrl</keycap>+<mousebutton>MB1</mousebutton>
copies the cell, why a plain
click just moves the cell.</para></listitem>
<listitem><para>Drag the cell to the new cell location.</para></listitem>
<procedure>
<step>
<para>Click <mousebutton>(MB1)</mousebutton> on the border (anywhere, except the autofill square in
the bottom right corner).<keycap>Ctrl</keycap>+<mousebutton>MB1</mousebutton>
copies the cell, why a plain
click just moves the cell.
</para>
</step>
<step>
<para>Drag the cell to the new cell location.</para>
</step>
<listitem><para>Release the selection.</para></listitem>
</itemizedlist>
<step>
<para>Release the selection.</para>
</step>
</procedure>
<para>This is the simplest method and most common use the drag and drop
cell moving and copying. The key bindings give you a good set of options
for quick moving and copying.</para>
</sect2>
</sect2>
<sect2>
<title>Right Click Options</title>
<sect2>
<title>Right Click Options</title>
<para>The other more extensive option to moving and copying cells is the
right click options. This presents a menu of options that is more extensive
that can be easily done with the normal key bindings</para>
<para>The other more extensive option to moving and copying cells is the
right click options. This presents a menu of options that is more extensive
that can be easily done with the normal key bindings</para>
<itemizedlist>
<listitem><para>Right Click (MB3) on the border (anywhere, except the autofill square in
the bottom right corner).</para></listitem>
<procedure>
<step>
<para>Right Click <mousebutton>(MB3)</mousebutton> on the border (anywhere, except the autofill square in
the bottom right corner).
</para>
</step>
<listitem><para>Drag the cell to the new cell location.</para></listitem>
<step>
<para>Drag the cell to the new cell location.
</para>
</step>
<step>
<para>Release the selection. An options menu should pop-up.
</para>
</step>
<listitem><para>Release the selection. An options menu should pop-up.</para></listitem>
<step>
<para>Select the appropriate option from the menu and click again. The new
cell should have the new info.
</para>
</step>
</procedure>
<listitem><para>Select the appropriate option from the menu and click again. The new
cell should have the new info.</para></listitem>
</itemizedlist>
<para>FIXME! screenshot here once i figure out how to do cursors</para>
<para>Move and copy right click menu options</para>
</sect2>
<sect2>
<title>Move and copy right click menu options</title>
<itemizedlist>
<listitem><para>Copy: Same effect as the normal Copy operations. It
copies the value, the format, and the formula. Equivalent to Ctrl+MB1.</para></listitem>
<listitem><para>Move: Same effect as the normal Move operations. It
moves the value, the format, and the formula. Equivalent to MB1.</para></listitem>
<listitem><para>Copy Formats: Copies the formatting info of the source cell. This
includes number format, color, font, fill type, etc.</para></listitem>
<listitem><para>Copy Values: Copies the value in the source cell to the destination
cell. </para></listitem>
<listitem><para>Shift Cells Down and Copy: not implemented yet</para></listitem>
<listitem><para>Shift Cells Right and Copy: not implemented yet</para></listitem>
<listitem><para>Shift Cells Down and Move: not implemented yet</para></listitem>
<listitem><para>Shift Cells Right and Move: not implemented yet</para></listitem>
<listitem>
<para>
Copy: Same effect as the normal Copy operations. It
copies the value, the format, and the formula. Equivalent to Ctrl+MB1.
</para>
</listitem>
<listitem>
<para>
Move: Same effect as the normal Move operations. It
moves the value, the format, and the formula. Equivalent to MB1.
</para>
</listitem>
<listitem>
<para>
Copy Formats: Copies the formatting info of the source cell. This
includes number format, color, font, fill type, etc.
</para>
</listitem>
<listitem>
<para>
Copy Values: Copies the value in the source cell to the destination
cell.
</para>
</listitem>
<listitem><para>Shift Cells Down and Copy: not implemented yet</para></listitem>
<listitem><para>Shift Cells Right and Copy: not implemented yet</para></listitem>
<listitem><para>Shift Cells Down and Move: not implemented yet</para></listitem>
<listitem><para>Shift Cells Right and Move: not implemented yet</para></listitem>
</itemizedlist>
<figure id="rightclickmove">
<title>The option menu for dragging a cell with right click.</title>
<title>The option menu for dragging a cell with right click <mousebutton>(MB3)</mousebutton>.</title>
<screenshot>
<graphic fileref="images/dndselection-1.jpg"></graphic>
</screenshot>
</figure>
</sect2>
</sect1>
</sect2>
</sect1>
<!-- include the files for handling selections -->
......
......@@ -7,7 +7,7 @@
<!entity autofill SYSTEM "autofill.sgml">
<!entity worksheet SYSTEM "worksheet.sgml">
]>
<book>
<book id="gnumeric">
<bookinfo>
<title>Gnumeric's user manual</title>
<authorgroup>
......
......@@ -19,6 +19,10 @@
(or from the context sensitive popup menu
bound to the right mouse button) the appropriate format.</para>
<para>The quickest way to access the cell format dialog is to use its
keyboard shortcut, <keycombo><keycap>Ctrl</keycap><keycap>1</keycap></keycombo>.
This is equilivent to selecting the cell format item from the menus.</para>
<para>Gnumeric provides a wide range of predetermined formatting
styles. These formatting styles are shown by category in the
Cell/Style dialog box. Just choose one of the display formats and
......@@ -30,7 +34,7 @@
custom formatting expression: the custom formatting expressions give
you more flexibility in number display.</para>
<sect2>
<sect2 id="format-dialog">
<title>The Format Dialog</title>
<para>The number formatting dialog (see <xref linkend="number-format-dialog"> )
......@@ -55,6 +59,115 @@
look like, and the example of what the formatting code looks like.</para>
</sect2>
<sect2>
<title>Changing the Font</title>
<para>Any cell can use any font that is availble to Gnumeric. This
includes font attributes like bold, italics, etc as well as
font size.</para>
<para>To change the font for cells, simply open the file format
dialog (see <xref linkend="format-dialog">), and select the font
tab. This will open the standard Gnome font selection dialog.</para>
<!-- FIXME link to doc on the font dialog when they exist -->
<figure id="number-format-font-dialog">
<title>The Font selection dialog</title>
<screenshot>
<graphic fileref="images/number-format-font-dialog.jpg"></graphic>
</screenshot>
</figure>
<!-- FIXME -->
<para>Reference docs on how to use the font dialog here.</para>
<!-- FIXME -->
<para>For simply changing a cell's format to be Bold or Italics,
there are buttons on the toolbar for doing this quickly.
See <xref linkend="number-format-bold-italics"></para>
</sect2>
<sect2>
<title>Changing the cell's Color</title>
<para>Any cell in gnumeric can be assigned a color
for the text, the background, or the border. It is also
possible to add a pattern to the background of the cell.
FIXME: Setting the color and pattern for the background
currently is not enabled.</para>
<figure id="number-format-color-dialog">
<title>The cell color dialog.</title>
<screenshot>
<graphic fileref="images/number-format-color-dialog.jpg"></graphic>
</screenshot>
</figure>
<para>The <guilabel>Text color</guilabel> area is use to set an optional color
for the cell contents. The default is to not assign a
color to the cell and rely on the global defaults. To
give a cells contents a color, select the
<guibutton>Use This Color</guibutton> and then click
on the <guibutton>Color Selector Button</guibutton> to
open the Gnome color dialog. Select a color and
press <guibutton>Okay</guibutton> to return to the cell color dialog.
</para>
<Para>The <Guilabel>Background Configuration</Guilabel> Includes
Options For Setting The Cells Background To Either A Solid
Color Or A Pattern.</Para>
<Para>To Set The Background Of The Cell To A Solid Color,
Click On The <Guibutton>Use Solid Color</Guibutton>, And
Choose A Color From The Color Selector Dialog. </Para>
<Para>To Set A Pattern For The Cell Background,
Click On The <Guibutton>Use A Pattern</Guibutton> Button
And Select A Pattern By Clicking On The Pattern The User Wants.
There Is A Solid Black Border That Should Outline The Currently
Selected Pattern. </Para>
<!-- Fixme -->
<Para>Note: The Background Options Are Not Implemented Yet.</Para>
<!-- Fixme -->
</sect2>
<sect2>
<title>Cell content justification and alignment</title>