[gnumeric] Some documentation update

[Andreas J. Guelzow <guelzow src gnome org>]

commit c7a8235c1e0c151725630bfc803d661a636b961b
Author: Andreas J Guelzow <aguelzow pyrshep ca>
Date:   Sun Jul 31 13:54:03 2011 -0600

    Some documentation update
    
    2011-07-31  Andreas J. Guelzow <aguelzow pyrshep ca>
    
    	* data-format-conditional.xml: new stub
    	* Makefile.am: include data-format-conditional.xml
    	* data-format.xml: refer to data-format-conditional.xml
    	* gnumeric.xml: add data-format-conditional entity
    	* gui-menus.xml: fix typo
    	* manual-usage.xml: update chapter listing
    	* worksheets.xml: update info on worksheet size

 doc/C/ChangeLog                   |   10 +++++++
 doc/C/Makefile.am                 |    1 +
 doc/C/data-format-conditional.xml |   10 +++++++
 doc/C/data-format.xml             |    9 ++++++-
 doc/C/gnumeric.xml                |   13 +++++++---
 doc/C/gui-menus.xml               |    4 +-
 doc/C/manual-usage.xml            |   49 ++++++++++++++++++++++++++++++-------
 doc/C/worksheets.xml              |   37 +++++++++++++--------------
 8 files changed, 98 insertions(+), 35 deletions(-)
---
diff --git a/doc/C/ChangeLog b/doc/C/ChangeLog
index 9fc80c2..438a772 100644
--- a/doc/C/ChangeLog
+++ b/doc/C/ChangeLog
@@ -1,3 +1,13 @@
+2011-07-31  Andreas J. Guelzow <aguelzow pyrshep ca>
+
+	* data-format-conditional.xml: new stub
+	* Makefile.am: include data-format-conditional.xml
+	* data-format.xml: refer to data-format-conditional.xml
+	* gnumeric.xml: add data-format-conditional entity
+	* gui-menus.xml: fix typo
+	* manual-usage.xml: update chapter listing
+	* worksheets.xml: update info on worksheet size
+
 2011-07-31  Morten Welinder <terra gnome org>
 
 	* Release 1.10.17
diff --git a/doc/C/Makefile.am b/doc/C/Makefile.am
index 6287e49..1c32538 100644
--- a/doc/C/Makefile.am
+++ b/doc/C/Makefile.am
@@ -27,6 +27,7 @@ entities =  \
      data-entry-external.xml \
      data-entry.xml \
      data-format.xml \
+     data-format-conditional.xml \
      data-generate.xml \
      data-insert.xml \
      data-modify.xml \
diff --git a/doc/C/data-format-conditional.xml b/doc/C/data-format-conditional.xml
new file mode 100644
index 0000000..1e81a40
--- /dev/null
+++ b/doc/C/data-format-conditional.xml
@@ -0,0 +1,10 @@
+<sect1 id="sect-data-format-conditional">
+  <title>Conditional Formatting of Cells</title>
+
+  <note>
+    <para>
+      This section needs to be written.
+    </para>
+  </note>
+
+</sect1>
diff --git a/doc/C/data-format.xml b/doc/C/data-format.xml
index c1cec6d..46ae90f 100644
--- a/doc/C/data-format.xml
+++ b/doc/C/data-format.xml
@@ -2,7 +2,14 @@
   <title>Formatting Cells</title>
 
   <para>
-    Cell formats allow you to change the way cell data appears in the
+    This section describes how to format the appearance of data in a cell.
+    The section <xref linkend="sect-data-format-conditional"/> describes a more 
+    advanced method of formatting where the depends on various conditions
+    involving the current cell value and/or the values in other cells.
+  </para>
+
+  <para>
+    Cell formats allow you to only 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.
diff --git a/doc/C/gnumeric.xml b/doc/C/gnumeric.xml
index 55b6e43..9d66491 100644
--- a/doc/C/gnumeric.xml
+++ b/doc/C/gnumeric.xml
@@ -84,6 +84,7 @@
   <!ENTITY data-delete          SYSTEM "data-delete.xml">
   <!ENTITY data-insert          SYSTEM "data-insert.xml">
   <!ENTITY data-format          SYSTEM "data-format.xml">
+  <!ENTITY data-format-conditional SYSTEM "data-format-conditional.xml">
   <!ENTITY data-filter          SYSTEM "data-filter.xml">
   <!ENTITY data-modify          SYSTEM "data-modify.xml">
   <!ENTITY data-generate        SYSTEM "data-generate.xml">
@@ -454,7 +455,7 @@
 
 
   <chapter id="chapter-manual-usage">
-    <title>How to Use this Manual</title>
+    <title>How to Use This Manual</title>
 
     &manual-usage;
 
@@ -562,6 +563,7 @@
     &data-delete;
     &data-insert;
     &data-format;
+    &data-format-conditional;
     &data-filter;
     &data-modify;
     &data-generate;
@@ -575,8 +577,9 @@
 
     <para>
       This chapter explains many of the advanced analytic tools
-      available in &gnum; including linear algebra calculations and simulation
-      analysis.
+      available in &gnum; including linear algebra calculations,
+      the goal seek tool,
+      simulation analysis, and scenarios.
     </para>
 
     &analysis-overview;
@@ -603,7 +606,9 @@
 
     <para>
       This chapter explains the various statistical analysis tools
-      available within &gnum;.
+      available within &gnum; including tools to create descriptive
+      statistics, as well as parametric and non-parametric hypotheses
+      tests.
     </para>
 
   <para>
diff --git a/doc/C/gui-menus.xml b/doc/C/gui-menus.xml
index 57fb8c8..59eb97c 100644
--- a/doc/C/gui-menus.xml
+++ b/doc/C/gui-menus.xml
@@ -2416,8 +2416,8 @@
 </sect2>
 
 <sect2 id="menu-context-tabs">
-	<title>The Context Menu menu for Worksheet Tabs</title>
-		<para>The Context Menu menu for Worksheet Tabs.</para>
+	<title>The Context Menu for Worksheet Tabs</title>
+		<para>The Context Menu for Worksheet Tabs.</para>
 		<figure id="menu-context-tabs.png">
 		    <title>The Context Menu.</title>
 		    <screenshot>
diff --git a/doc/C/manual-usage.xml b/doc/C/manual-usage.xml
index b272178..5ac42ba 100644
--- a/doc/C/manual-usage.xml
+++ b/doc/C/manual-usage.xml
@@ -99,28 +99,61 @@
               <emphasis role="bold">Advanced Analysis</emphasis>
         </para>
         <para>
-          This chapter explains many of the advanced analytic tools
-          available in &gnum; including
-          statistical analysis, linear algebra calculations and
-          simulation analysis.
+          This chapter explains the advanced analytic tools
+          available in &gnum; including linear algebra calculations,
+          the goal seek tool,
+          simulation analysis, and scenarios.
 	</para>
       </listitem>
 
       <listitem>
 	<para>
+	  <xref linkend="chapter-solver" />: 
+              <emphasis role="bold">The Solver</emphasis>
+        </para>
+        <para>
+          This chapter explains how to use &gnum;'s linear programming 
+	  Solver.
+	</para>
+      </listitem>
+
+       <listitem>
+	<para>
+	  <xref linkend="chapter-stat-analysis" />: 
+              <emphasis role="bold">Statistical Analysis</emphasis>
+        </para>
+        <para>
+          This chapter explains the various statistical analysis tools
+          available in &gnum; including tools to create descriptive
+	  statistics, as well as parametric and non-parametric hypotheses
+	  tests.
+	</para>
+      </listitem>
+
+       <listitem>
+	<para>
 	  <xref linkend="chapter-graphics" />: <emphasis role="bold">Graphics:
-              Plots, Images, Widgets, and Drawings</emphasis> 
+              Images, Widgets, and Drawings</emphasis> 
 	</para> 
 	<para> 
 	  This chapter explains how to add graphical elements to a
           &gnum; worksheet, including
-          data graphs to plot worksheet data, images from external
+          images from external
           files, graphical user interface widgets which interact with
           worksheet data, and simple drawing elements. 
 	</para> 
       </listitem>
 
-<!--
+       <listitem>
+	<para>
+	  <xref linkend="chapter-graphs" />: <emphasis role="bold">Graphs
+	</emphasis> 
+	</para> 
+	<para> 
+	  This chapter explains how to add data graphs to a
+          &gnum; worksheet, that can be used to plot worksheet data. 
+	</para> 
+      </listitem>
 
       <listitem>
 	<para>
@@ -154,8 +187,6 @@
 	</para>
       </listitem>
 
--->
-
       <listitem>
 	<para>
 	  <xref linkend="chapter-configuring" />: 
diff --git a/doc/C/worksheets.xml b/doc/C/worksheets.xml
index 1ebe5d0..319fee0 100644
--- a/doc/C/worksheets.xml
+++ b/doc/C/worksheets.xml
@@ -112,30 +112,29 @@
     The display of each worksheet can be controlled by several
     settings and configurations. The worksheet, conceptually, consists
     of a single continuous two dimensional grid of cells arranged in
-    65536 rows by 258 columns, and &gnum;, by default, displays a
-    small portion of the worksheet area as a continuous region. This
-    chapter...
-
-
-    ...or which allow
-    the user to rearrange the cell grid to fix parts of the worksheet
-    grid while scrolling others or to group rows or columns of data
-    within a worksheet for convenient editing and analysis...
+    rows by columns, and &gnum;, by default, displays a
+    small portion of the worksheet area as a continuous region. 
+  </para>
+  <para>
+    A worksheet is created with the number of rows and columns specified
+    by the preference setting that can be adjusted on the <guilabel>Windows
+  </guilabel> tab of the Preference Dialog (see  <xref
+    linkend="sect-configuration-preferences-windows"/>);
   </para>
-
   <note>
-    <title>
-      Changing the default size of the &gnum; cell grid.
-    </title>
     <para>
-      The worksheet grid is 65536 rows by 258 columns of cells, by
-      default. This can be changed but only by altering the computer
-      program files and recompiling the code to make a new version of
-      the &gnum; program. 
-<!-- TODO: ask- how to change the size (row/col) of the cell grid? -->
-<!-- TODO: add- add a link to compile section. -->
+      The maximum number of supported rows in a sheet is 16,777,216 and the
+      maximum number of supported columns is 16384. The numbers of rows and
+      columns of a sheet must always be powers of 2.
     </para>
   </note>
+  <para>
+    The size of an existing sheet can be increased through the <guilabel>
+    Resize Sheet</guilabel> dialog accessible through the sheet tab context
+    menu (see <xref linkend="menu-context-tabs"/>) or the <guilabel>Sheet
+    </guilabel> submenu of the <guilabel>Edit</guilabel> menu (see <xref 
+    linkend="Edit-Menu"/>).
+  </para>