Commit 6f138c5f authored by Kevin Breit's avatar Kevin Breit Committed by Kevin Breit
Browse files

This file builds properly now under XML

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

	* new/worksheet.xml: This file builds properly now under XML

	* new/gnumeric.xml: Made worksheet and toolbars be enabled

	* new/toolbars.xml: XMLized and added
parent 52234354
2002-01-26 Kevin Breit <mrproper@ximian.com>
* new/worksheet.xml: This file builds properly now
2002-01-25 Kevin Breit <mrproper@ximian.com>
* new/gnumeric.xml: Made worksheet and toolbars be enabled
* new/worksheet.xml: XMLized and added
* new/toolbars.xml: XMLized and added
2002-01-24 Kevin Breit <mrproper@ximian.com>
* new/gui-elements.xml: Added file, not yet XMLized
......
2002-01-26 Kevin Breit <mrproper@ximian.com>
* new/worksheet.xml: This file builds properly now
2002-01-25 Kevin Breit <mrproper@ximian.com>
* new/gnumeric.xml: Made worksheet and toolbars be enabled
* new/worksheet.xml: XMLized and added
* new/toolbars.xml: XMLized and added
2002-01-24 Kevin Breit <mrproper@ximian.com>
* new/gui-elements.xml: Added file, not yet XMLized
......
......@@ -7,9 +7,9 @@ GNU oleo">
<!ENTITY preface SYSTEM "preface.xml">
<!ENTITY gui-elements SYSTEM "gui-elements.xml">
<!ENTITY menus SYSTEM "menus.xml">
<!ENTITY toolbars SYSTEM "toolbars.xml">
<!ENTITY worksheet SYSTEM "worksheet.xml">
<!--
<!ENTITY toolbars SYSTEM "toolbars.sgml">
<!ENTITY worksheet SYSTEM "worksheet.sgml">
<!ENTITY editing SYSTEM "editing.sgml">
<!ENTITY numberformat SYSTEM "number-format.sgml">
<!ENTITY formulas SYSTEM "formulas.sgml">
......@@ -90,18 +90,18 @@ GNU oleo">
<title>Gnumeric Menus</title>
&menus;
</chapter>
<!--
<chapter id="toolbars">
<title>Gnumeric Toolbars</title>
&toolbars;
</chapter>
<chapter id="other-elements">
<title>Gnumeric Data Entry area, Cell Grid and Information Area
</title>
&worksheet;
</chapter>
<!--
<chapter id="editing">
<title>Entering data</title>
&editing;
......
<sect1 id="toolbars-start">
<title>The Gnumeric Toolbars</title>
<para>The toolbars contain many icons representative of some the more common
operations a user may need to use. It is intended to provide fast access to these
tools. Almost all of these functions is also available through the menu
system.
</para>
<para><application>Gnumeric</application> has three toolbars, the standard toolbar, the format toolbar
and the object toolbar. The three toolbars are shown in
<xref linkend="toolbars.png" />.
</para>
<figure id="toolbars.png">
<title>The Three Gnumeric Toolbars</title>
<mediaobject>
<imageobject>
<imagedata fileref="figures/toolbars" format="PNG" />
</imageobject>
</mediaobject>
</figure>
<para> These toolbars will be discussed separately in the subsequent
sections of this manual. User interaction with each toolbar happens in
essentially the same way. Similarly, the toobars can be configured in the same
way. The next section explains the standard behavior of <application>Gnumeric</application> toolbars.</para>
<sect2 id="toolbar-use">
<title>General Toolbar Behavior</title>
<para>In the same way that menus can be moved around, as was explained
<xref linkend="menu-bars" />, toolbars can be moved around the <application>Gnumeric</application>
window by dragging the little tag on the leftmost portion of the
toolbar.
</para>
<para>
If the <application>Gnumeric</application> window is too small to fit all of the toolbar buttons,
gnumeric may display a little right pointing black arrow to indicate
that there are more options. If the user clicks on this arrow, a window
will open with the remaining buttons.
</para>
<para>
Certain toolbar options, such as the zoom box, are combinations of a
button or text entry area and a downward pointing arrow. If the user
clicks on the arrow, a list of avaliable options appears. It is also
posible to "tear off" these options into a separate window in the same
way as was explained for menus in <xref linkend="Menus-General" />.
</para>
<para>
The toolbars can be configured by a context-menu which opens when the
user clicks with a particular mouse button on an empty part of the
toolbars or on the toolbar handle. This menu is explained in
<xref linkend="menu-context-toolbars" />.
</para>
</sect2>
</sect1>
<!-- ************************* THE STANDARD TOOLBAR ************** -->
<sect1 id="std-toolbar">
<title>The Standard Toolbar</title>
<para>The standard toolbar is shown in <xref
linkend="toolbar-standard.png" />.</para>
<figure id="toolbar-standard.png">
<title>The <interface>Standard Toolbar</interface>.</title>
<mediaobject>
<imageobject>
<imagedata fileref="figures/toolbar-standard" format="PNG" />
</imageobject>
</mediaobject>
</figure>
<para> The <interface>Standard Toolbar</interface> gives the user access to
file operations, printing, movement of data blocks, the undo system, and to
some of the powerful tools like the function creator and the graphing
system.</para>
<!-- The list of standard toolbar objects. -->
<variablelist>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-new.png" />
New File.
</guiicon>
</term>
<listitem>
<para>Create a new file.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-open.png" /></guiicon>
Open
</term>
<listitem>
<para>Open an existing file.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-save.png"></inlinegraphic>
Save
</guiicon>
</term>
<listitem>
<para>Save the current worksheet to disk.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-print.png"></inlinegraphic>
Print
</guiicon>
</term>
<listitem>
<para>Print the current worksheet to a file or a printer.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-preview.png"></inlinegraphic>
Print Setup
</guiicon>
</term>
<listitem>
<para>Display a print preview of the current worksheet.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-cut.png"></inlinegraphic>
Cut
</guiicon>
</term>
<listitem>
<para>Copy the cells in the current selection to the clipboard buffer and mark them to
be deleted from the current position. The cells will only be removed if
they are pasted into a new position.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-copy.png"></inlinegraphic>
Copy
</guiicon>
</term>
<listitem>
<para>Copy the cells in the current selection to the clipboard buffer.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-paste.png"></inlinegraphic>
Paste
</guiicon>
</term>
<listitem>
<para>Paste the contents of the clipboard buffer into the active cell.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-undo-and-history.png"></inlinegraphic>
Undo
</guiicon>
</term>
<listitem>
<para>
Undoes the last operation undertaken.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-redo-and-history.png"></inlinegraphic>
Redo
</guiicon>
</term>
<listitem>
<para>This is the reverse of the undo operation, restoring its orginal state.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-sum.png"></inlinegraphic>
Sum into the current cell
</guiicon>
</term>
<listitem>
<para>Starts a simple sum formula in the selected cell with <application>Gnumeric</application>
simply waiting for a selection to be made to complete the sum. The user
selects the destination cell, pushes this button, enters the range to be
summed and pushes the confirm button (green arrow) in the data entry area
or types the <keycap>Return</keycap> key.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-fx.png"></inlinegraphic>
The function guru
</guiicon>
</term>
<listitem>
<para>This button will start a formula in the current cell using the
function guru.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-sort-az.png"></inlinegraphic>
Sort Ascending
</guiicon>
</term>
<listitem>
<para>Sorts the selected region in ascending order based on the
first column selected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-sort-za.png"></inlinegraphic>
Sort Descending
</guiicon>
</term>
<listitem>
<para>Sorts the selected region in descending order based on the
first column selected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-graph.png"></inlinegraphic>
Graph
</guiicon>
</term>
<listitem>
<para>This button calls the graph guru to create a graph.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-insert-object.png"></inlinegraphic>
Insert Object
</guiicon>
</term>
<listitem>
<para>This button will insert a component object into the
current worksheet. Components are the way that the GNOME
project has chosen to enable certain programs to use others
within themselves. <application>Gnumeric</application> is
able to use the <application>Guppi</application> plotting
program and the <application>Dia</application> diagramming
program in this way.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-insert-component.png"></inlinegraphic>
Insert Shaped Component
</guiicon>
</term>
<listitem>
<para>This button allows user to insert a component into <application>Gnumeric</application> that is
not a simple rectangle but may have an arbitrary shape. This
functionality is currently not used but provided for future needs.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-zoom.png"></inlinegraphic>
Zoom
</guiicon>
</term>
<listitem>
<para>The zoom button allows the users to tradeoff the extent of the
worksheet which is visible against the size of the visible text and cells.
</para>
</listitem>
</varlistentry>
</variablelist>
</sect1>
<!-- ************************* THE FORMAT TOOLBAR ************** -->
<sect1 id="fmt-toolbar">
<title>The Format Toolbar</title>
<para> The <interface>Format Toolbar</interface> ...</para>
<figure id="toolbar-format.png">
<title>The <interface>Format Toolbar</interface></title>
<mediaobject>
<imageobject>
<imagedata fileref="figures/toolbar-format" format="PNG" />
</imageobject>
</mediaobject>
</figure>
<para> The <interface>Format Toolbar</interface>. </para>
<variablelist>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-font-type.png"></inlinegraphic>
Font Chooser.
</guiicon>
</term>
<listitem>
<para>The user can change the font of a selection either by typing the
name of a new font in the text area of this box or by clicking on the little
arrow to the right of the text area. This will cause a menu to appear from
which a font can be chosen.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-font-size.png"></inlinegraphic>
Font size
</guiicon>
</term>
<listitem>
<para>The user can change the font size of a selection by typing the
number of a different font size or by clicking on the little arrow to the right
of the entry box and selecting the perferred size.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-bold.png"></inlinegraphic>
Bold
</guiicon>
</term>
<listitem>
<para>Change the style of the current cell to be bold, or un bold it if it is already bold.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-italic.png"></inlinegraphic>
Italic
</guiicon>
</term>
<listitem>
<para>Change the style of the current cell to be italicized .</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-underline.png"></inlinegraphic>
Underline
</guiicon>
</term>
<listitem>
<para>Change the style of the current cell to be underlined.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-align-left.png"></inlinegraphic>
Left justify..
</guiicon>
</term>
<listitem>
<para>Justify the contents of the cell to the left of the cell.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-align-center.png"></inlinegraphic>
Center
</guiicon>
</term>
<listitem>
<para>Center the content of the cells.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-align-right.png"></inlinegraphic>
Right Justify
</guiicon>
</term>
<listitem>
<para>Justify the content of the cells to the right side of the cells</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-center-across-selection.png"></inlinegraphic>
Right Justify
</guiicon>
</term>
<listitem>
<para>Justify the content of the cells to the right side of the cells</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-merge.png"></inlinegraphic>
Left justify.
</guiicon>
</term>
<listitem>
<para>Justify the contents of the cell to the left of the cell.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-split.png"></inlinegraphic>
Center
</guiicon>
</term>
<listitem>
<para>Center the content of the cells.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-money.png"></inlinegraphic>
Money
</guiicon>
</term>
<listitem>
<para>Sets the format of the selected cells to be monetary.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-percent.png"></inlinegraphic>
Percentage
</guiicon>
</term>
<listitem>
<para>Sets the format of the selected cells to be a percentage.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-thousands.png"></inlinegraphic>
Thousands separator
</guiicon>
</term>
<listitem>
<para>Sets the format of the selected cells to use thousands separator.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-increase-precision.png"></inlinegraphic>
Increase the displayed precision.
</guiicon>
</term>
<listitem>
<para>Increases the number of decimals shown in the currently selected cell.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-decrease-precision.png"></inlinegraphic>
Decrease the displayed precision.
</guiicon>
</term>
<listitem>
<para>Decreases the number of decimals in the currently selected cell.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-decrease-indent.png"></inlinegraphic>
Decrease the displayed indentation.
</guiicon>
</term>
<listitem>
<para>This button decreases the indentation of selected elements.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-increase-indent.png"></inlinegraphic>
Increase the displayed indentation.
</guiicon>
</term>
<listitem>
<para>This button increases the indentation of selected elements.</para>
</listitem>
</varlistentry>
<varlistentry>
<term>
<guiicon><inlinegraphic fileref="figures/button-borders.png"></inlinegraphic>
Change the display borders.
</guiicon>
</term>