Commit 7a2664ab authored by Arturo Espinosa's avatar Arturo Espinosa
Browse files

1. Make the Guile plugin optional (you need to use --with-guile) because



1. Make the Guile plugin optional (you need to use --with-guile)
   because it is not really a plugin right now.

2. Documentation fixes.

3. Documentation framework integrated into Gnumeric

Miguel
parent 05ec3d22
......@@ -17,7 +17,9 @@ AM_PROG_LIBTOOL
GNOME_COMPILE_WARNINGS
GNOME_X_CHECKS
GNOME_XML_CHECK
GNOME_CHECK_GUILE
AC_ARG_WITH(guile,[--with-guile Include Guile support],
GNOME_CHECK_GUILE)
AC_SUBST(CFLAGS)
AC_SUBST(CPPFLAGS)
......@@ -70,7 +72,6 @@ if $perl_val; then
AC_MSG_RESULT(no)
perl_val=false
fi
fi
AM_CONDITIONAL(WITH_PERL, $perl_val)
......@@ -80,33 +81,34 @@ dnl **************************************************
dnl
AC_CHECK_PROG(python_val, python, true, false)
if $python_val; then
PY_PREFIX=`python -c 'import sys ; print sys.prefix'`
PY_EXEC_PREFIX=`python -c 'import sys ; print sys.exec_prefix'`
changequote(<<, >>)dnl
PY_VERSION=`python -c 'import sys ; print sys.version[0:3]'`
changequote([, ])dnl
if test -f $PY_PREFIX/include/python$PY_VERSION/Python.h; then
PY_LIBS="python$PY_VERSION"
PY_LIB_LOC="-L$PY_EXEC_PREFIX/lib/python$PY_VERSION/config"
PY_CFLAGS="-I$PY_PREFIX/include/python$PY_VERSION"
PY_MAKEFILE="$PY_EXEC_PREFIX/lib/python$PY_VERSION/config/Makefile"
PY_LOCALMODLIBS=`sed -n -e 's/^LOCALMODLIBS=\(.*\)/\1/p' $PY_MAKEFILE`
PY_BASEMODLIBS=`sed -n -e 's/^BASEMODLIBS=\(.*\)/\1/p' $PY_MAKEFILE`
PY_OTHER_LIBS=`sed -n -e 's/^LIBS=\(.*\)/\1/p' $PY_MAKEFILE`
PY_EXTRA_LIBS="$PY_LOCALMODLIBS $PY_BASEMODLIBS $PY_OTHER_LIBS"
AC_SUBST(PY_LIBS)
AC_SUBST(PY_LIB_LOC)
AC_SUBST(PY_CFLAGS)
AC_SUBST(PY_EXTRA_LIBS)
else
python_val=false
fi
PY_PREFIX=`python -c 'import sys ; print sys.prefix'`
PY_EXEC_PREFIX=`python -c 'import sys ; print sys.exec_prefix'`
changequote(<<, >>)dnl
PY_VERSION=`python -c 'import sys ; print sys.version[0:3]'`
changequote([, ])dnl
if test -f $PY_PREFIX/include/python$PY_VERSION/Python.h; then
PY_LIBS="python$PY_VERSION"
PY_LIB_LOC="-L$PY_EXEC_PREFIX/lib/python$PY_VERSION/config"
PY_CFLAGS="-I$PY_PREFIX/include/python$PY_VERSION"
PY_MAKEFILE="$PY_EXEC_PREFIX/lib/python$PY_VERSION/config/Makefile"
PY_LOCALMODLIBS=`sed -n -e 's/^LOCALMODLIBS=\(.*\)/\1/p' $PY_MAKEFILE`
PY_BASEMODLIBS=`sed -n -e 's/^BASEMODLIBS=\(.*\)/\1/p' $PY_MAKEFILE`
PY_OTHER_LIBS=`sed -n -e 's/^LIBS=\(.*\)/\1/p' $PY_MAKEFILE`
PY_EXTRA_LIBS="$PY_LOCALMODLIBS $PY_BASEMODLIBS $PY_OTHER_LIBS"
AC_SUBST(PY_LIBS)
AC_SUBST(PY_LIB_LOC)
AC_SUBST(PY_CFLAGS)
AC_SUBST(PY_EXTRA_LIBS)
else
python_val=false
fi
fi
AM_CONDITIONAL(WITH_PYTHON, $python_val)
AC_OUTPUT([
Makefile
src/Makefile
doc/Makefile
plugins/Makefile
plugins/sample/Makefile
plugins/excel/Makefile
......
gnumeric_helpdir = $(datadir)/gnome/help/gnumeric/C
gnumeric_help_DATA = \
gnumeric.html \
topic.dat
SGML_FILES = \
autofill.sgml \
cell_refer.sgml \
dndselection.sgml \
editing.sgml \
files.sgml \
formats.sgml \
formulas.sgml \
functions.sgml \
gnumeric.sgml \
intro.sgml \
number-format.sgml \
selections.sgml \
text-entry.sgml \
translating.sgml \
worksheet.sgml
TEXT_FILES = \
Design \
Future-Roadmap \
saving.txt
EXTRA_DIST = \
$(SGML_FILES) \
$(TEXT_FILES)
all: gnumeric.html
gnumeric.html: gnumeric/gnumeric.html
-cp gnumeric/gnumeric.html .
gnumeric/gnumeric.html: $(SGML_FILES)
-db2html gnumeric.sgml
dist-hook:
mkdir $(distdir)/gnumeric
-cp gnumeric/*.html gnumeric/*.css $(distdir)/gnumeric
install-data-local: gnumeric.html
$(srcdir)/../mkinstalldirs $(gnumeric_helpdir)/images
-for file in $(srcdir)/gnumeric/*.html $(srcdir)/gnumeric/*.css; do \
basefile=`basename $$file`; \
$(INSTALL_DATA) $(srcdir)/$$file $(gnumeric_helpdir)/$$basefile; \
done
-for file in $(srcdir)/images/*.jpg; do \
$(INSTALL_DATA) $(srcdir)/$$file $(gnumeric_helpdir)/images;\
done
gnumeric.ps: gnumeric.sgml
-db2ps $<
gnumeric.rtf: gnumeric.sgml
-db2rtf $<
<sect1>
<title>Moving Cells</title>
<para>Gnumeric allows the user to move and copy cells
and their contents by simply dragging and dropping the
cell to its new location. </para>
<para>The basic procedure to quickly drag and drop a cell to
a new location is to click on the border, and drag the cell
to its new location and release. The contents of the cell
will be moved to the new cell.</para>
<title>Moving Cells</title>
<para>Gnumeric allows the user to move and copy cells
and their contents by simply dragging and dropping the
cell to its new location. </para>
<para>The basic procedure to quickly drag and drop a cell to
a new location is to click on the border, and drag the cell
to its new location and release. The contents of the cell
will be moved to the new cell.</para>
<itemizedlist>
<listitem><para>Click (MB1) on the border (anywhere, except the autofill square in
the bottom right corner). Ctrl+click copies the cell, while a plain
click just moves the cell.</para></listitem>
<listitem><para>Drag the cell to the new cell location.</para></listitem>
<listitem><para>Release the selection.</para></listitem>
<listitem><para>Click (MB1) on the border (anywhere, except the autofill square in
the bottom right corner). Ctrl+click copies the cell, while a plain
click just moves the cell.</para></listitem>
<listitem><para>Drag the cell to the new cell location.</para></listitem>
<listitem><para>Release the selection.</para></listitem>
</itemizedlist>
<para>This is the simplest method and most common use the drag and drop
cell moving and copying. The keybindings give you a good set of options
for quick moving and copying.</para>
<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 keybindings</para>
<itemizedlist>
<listitem><para>Right Click (MB3) on the border (anywhere, except the autofill square in
the bottom right corner).</para></listitem>
<listitem><para>Drag the cell to the new cell location.</para></listitem>
<listitem><para>Release the selection. An options menu should pop-up.</para></listitem>
<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>
cell moving and copying. The keybindings give you a good set of options
for quick moving and copying.</para>
<itemizedlist>
<listitem><para>Copy: Same effect as the normal Copy operations. It
copies the value, the format, and the formula. Equilivent to Ctrl+MB1.</para></listitem>
<listitem><para>Move: Same effect as the normal Move operations. It
moves the value, the format, and the formula. Equilivent to MB1.</para></listitem>
<listitem><para>Copy Formats: Copies the formatting info of the source cell. This
includes number format, color, font, filltype, 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>
<screenshot>
<screeninfo>Figure 1.
</screeninfo>
<graphic fileref="dndselection-1.jpg"></graphic>
The right click option menu.
</screenshot>
<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 keybindings</para>
<itemizedlist>
<listitem><para>Right Click (MB3) on the border (anywhere, except the autofill square in
the bottom right corner).</para></listitem>
<listitem><para>Drag the cell to the new cell location.</para></listitem>
<listitem><para>Release the selection. An options menu should pop-up.</para></listitem>
<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>
<itemizedlist>
<listitem><para>Copy: Same effect as the normal Copy operations. It
copies the value, the format, and the formula. Equilivent to Ctrl+MB1.</para></listitem>
<listitem><para>Move: Same effect as the normal Move operations. It
moves the value, the format, and the formula. Equilivent to MB1.</para></listitem>
<listitem><para>Copy Formats: Copies the formatting info of the source cell. This
includes number format, color, font, filltype, 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>
<screenshot>
<screeninfo>Figure 1.
</screeninfo>
<graphic fileref="dndselection-1.jpg"></graphic>
The right click option menu.
</screenshot>
</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="formulas">
<title>Formulas</title>
<para>Formulas are the key to the whole ball of wax when it comes to
spreadsheets. A formula can take almost anything as its arguments
including single numbers, cell references, ranges of cells, arrays
of cells, etc. <para>
<sect2>
<title>Syntax</title>
<para> Formulas are distinguished from regular data by a '='
as the first character. Everything following a '=' is evaluated
as a formula, not a string. </para>
<para> The simplest fomula's just use the standard math operator
and symbols. +,-,*,/ are intrepreted just as you would expect them to.
+,- can be used as unary operators and indicate sign, just as can
be expected.</para>
spreadsheets. A formula can take almost anything as its arguments
including single numbers, cell references, ranges of cells, arrays
of cells, etc. </para>
<sect2>
<title>Syntax</title>
<para> Formulas are distinguished from regular data by a '=' as
the first character. Everything following a '=' is evaluated as
a formula, not a string. </para>
<para> The simplest fomula's just use the standard math operator
and symbols. +,-,*,/ are intrepreted just as you would expect
them to. +,- can be used as unary operators and indicate sign,
just as can be expected.</para>
<example id="standardoperators">
<example id="standardoperators">
<title>Examples of standard operators</title>
<programlisting>
=5+5 returns 10.
=5-4 returns 1.
=-5 returns -5.
=5*5 returns 25.
=(5*5)+11 returns 36.
=(5*)+(49/7) returns 32.
</programlisting>
</example>
=5+5 returns 10.
=5-4 returns 1.
=-5 returns -5.
=5*5 returns 25.
=(5*5)+11 returns 36.
=(5*)+(49/7) returns 32.
</programlisting>
</example>
</sect2>
<sect2>
<title>Using Functions</title>
<para>Most of the standard math, business, statistical, and scientific calculations
are implemented in terms of functions. Functions are in the form of:</para>
<sect2>
<title>Using Functions</title>
<para>Most of the standard math, business, statistical, and
scientific calculations are implemented in terms of
functions. Functions are in the form of:</para>
<example id="basicfunctionsyntax">
<title>Basic Function syntax</title>
<programlisting>
=FUNCTION(ARGUMENTS)
</programlisting>
</example>
<para> While the documentation generally refers to functions in all caps,
there use is not actually case sensitive.<para>
<example id="funxtionsyntax">
<title>Some examples of function syntax</title>
<programlisting>
=SUM(A1,A2,A4,B5)
<title>Basic Function syntax</title>
<programlisting>
=FUNCTION(ARGUMENTS)
</programlisting>
</example>
<para> While the documentation generally refers to functions in all caps,
there use is not actually case sensitive.</para>
<example id="funxtionsyntax">
<title>Some examples of function syntax</title>
<programlisting>
=SUM(A1,A2,A4,B5)
=AVERAGE(A1:A16)
=EXP(1)
=PI()
=MIN(A1,A2,B6)
</programlisting>
</example>
</sect2>
</programlisting>
</example>
</sect2>
</sect1>
......
......@@ -21,9 +21,17 @@
</address>
</affiliation>
</author>
<author>
<firstname>Adrian</firstname> <surname>Likins</surname>
<affiliation>
<address>
<email>adrian@gimp.org</email>
</address>
</affiliation>
</author>
</authorgroup>
<copyright>
<year>1998</year> <holder>Miguel de Icaza (n.)</holder>
<year>1998, 1989</year> <holder>Miguel de Icaza (n.)</holder>
</copyright>
<legalnotice>
<para>This documentation is free software; you can redistribute
......
<sect1>
<title>Cell Formatting</title>
<para>Cell formats allow you to change the way cell data appears in the
spreadsheet. It is important to keep in mind that it only alters the way the
data is presented, and does not change the value of the data. </para>
<para>Cell formats allow you to change the way cell data appears in
the spreadsheet. It is important to keep in mind that it only
alters the way the data is presented, and does not change the
value of the data. </para>
<para>The formatting options allows for monetary units, scientific options,
dates, times, fractions,and more. Positive and negative values can have different colors and formats
for aiding in keeping track of values. There are also a large variety of
date and time formats for virtually any time and date format one can think of.
<para>The formatting options allows for monetary units, scientific
options, dates, times, fractions,and more. Positive and negative
values can have different colors and formats for aiding in
keeping track of values. There are also a large variety of date
and time formats for virtually any time and date format one can
think of.
</para>
<para>To change the formatting style for a cell or a range of cells,
you only need to select the range of cells (see <xref linkend="editing-selections">)
where you want to
apply/change the format and then select from the
<guimenu>Format</guimenu>/<guimenuitem>Cells</guimenuitem>/Numbers menu
(or from the context sensitive popup menu
bound to the right mouse button) the appropriate format.</para>
you only need to select the range of cells (see <xref
linkend="editing-selections">) where you want to apply/change the
format and then select from the
<guimenu>Format</guimenu>/<guimenuitem>Cells</guimenuitem>/Numbers
menu (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>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
......@@ -31,8 +36,8 @@
<para>If none of the predetermined formatting styles fits your
needs, you can define your own number formatting style by using a
custom formatting expression: the custom formatting expressions give
you more flexibility in number display.</para>
custom formatting expression: the custom formatting expressions
give you more flexibility in number display.</para>
<sect2 id="format-dialog">
<title>The Format Dialog</title>
......@@ -99,7 +104,9 @@ tab. This will open the standard Gnome font selection dialog.</para>
<step>
<para>Select the font tab in the dialog box notebook. This will open
the font selection part of the dialog. See
<xref linkend="number-format-font-dialog"> for a look at the dialog.</para>
<xref linkend="number-format-font-dialog"> for a look at
the dialog.</para>
</step>
<step><para>TELL PEOPLE HOW TO USE THE FONT DIALOG HERE</para></step>
</procedure>
......
gnumeric.html Gnumeric manual
\ No newline at end of file
......@@ -2,12 +2,13 @@
<title>The Worksheet</title>
<para>After opening up gnumeric, you're presented with a view of a
worksheet. This is where the majority of the work on the spreadsheet
is done, and provides access to all the various sub dialogs of Gnumeric.</para>
worksheet. This is where the majority of the work on the
spreadsheet is done, and provides access to all the various sub
dialogs of Gnumeric.</para>
<para>The worksheet view is split into several main areas. The menu bar, the
button bar, the entry area, the main cell area, and the info area. See
<xref linkend="worksheet-all-1.jpg"> </para>
<para>The worksheet view is split into several main areas. The menu
bar, the button bar, the entry area, the main cell area, and the
info area. See <xref linkend="worksheet-all-1.jpg"> </para>
<figure id="worksheet-all-1.jpg">
<title>A example of the entire worksheet.</title>
......@@ -15,7 +16,7 @@
<graphic fileref="images/worksheet-all-1.jpg"></graphic>
</screenshot>
</figure>
<sect2 id="menu-bar">
<title>The Menu bar</title>
<para>The default location of the menu bar is the top of the application window.
......@@ -23,22 +24,23 @@
operations available.</para>
<sect3>
<!-- IF someone knows a more approriate way to document menu
options, let me know. This seems a bit excessive, and the output
from db2html is kind of lame -->
from db2html is kind of lame -->
<title><guimenu><accel>F</accel>ile</guimenu></title>
<variablelist>
<varlistentry>
<term><guimenuitem><accel>N</accel>ew</guimenuitem></term>
<listitem><para>Create a new worksheet. This opens a new worksheet in a window.</para></listitem>
<listitem><para>Create a new worksheet. This opens a new
worksheet in a window.</para></listitem>
</varlistentry>
<varlistentry>
<term><guimenuitem><accel>O</accel>pen</guimenuitem></term>
<listitem><para>Open an existing worksheet. A new window is created with the file
selected in it.</para></listitem>
<listitem><para>Open an existing worksheet. A new window is
created with the file selected in it.</para></listitem>
</varlistentry>
<varlistentry>
......@@ -49,9 +51,12 @@
</varlistentry>
<varlistentry>
<term><guimenuitem>S<accel>a</accel>ve as..</guimenuitem></term>
<term><guimenuitem>S<accel>a</accel>ve
as..</guimenuitem></term>
<listitem><para>Save a file with a new name. Save a newly created file or save
a file with a different name. </para></listitem>
</varlistentry>
<varlistentry>
......@@ -174,7 +179,7 @@
<para>The Button bar contains 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.</para>
<variablelist>
<varlistentry>
<term>
......@@ -352,167 +357,169 @@
<sect2 id="worksheet-data-entry">
<title>Data entry area.</title>
<para>Immediately under the button bar is the data entry area. This is a small
area, which contains a current cell indicator, a <guibutton>confirm</guibutton>
and a <guibutton>cancel</guibutton> button,
and an entry area for detailed editing of the cell contents.
See <xref linkend="worksheet-data-1"><para>
<figure id="worksheet-data-1">
<title>The Data Entry area.</title>
<screenshot>
<graphic fileref="images/worksheet-data-1.jpg"></graphic>
</screenshot>
</figure>
<sect3>
<title>Current Cell Indicator.</title>
<para>On the far left of the Data Entry area is the current cell indicator
area. If a single cell is selected, it will show the address for the cell.
If a region is selected, it shows the size of the region in the format:</para>
<blockquote><para>4Lx5C</para></blockquote>
<para>Where L is the number of rows and C is the number of columns. In the example
above, this would be a selection of 4 rows by 5 columns.</para>
<figure id="worksheet-data-2">
<title>The Current Cell Indicator.</title>
<screenshot>
<graphic fileref="images/worksheet-data-2.jpg"></graphic>
</screenshot>
</figure>
</sect3>