From 702dc88400df546bf878a22c56b9f3c4a7672de7 Mon Sep 17 00:00:00 2001
From: Joris van der Hoeven <vdhoeven@lix.polytechnique.fr>
Date: Wed, 7 Mar 2012 09:02:32 +0000
Subject: [PATCH] Spreadsheet documentation

---
 main/interface/man-spreadsheet.en.tm | 29 +++++++++++++++++++++++++---
 1 file changed, 26 insertions(+), 3 deletions(-)

diff --git a/main/interface/man-spreadsheet.en.tm b/main/interface/man-spreadsheet.en.tm
index 6a5f913..78945c3 100644
--- a/main/interface/man-spreadsheet.en.tm
+++ b/main/interface/man-spreadsheet.en.tm
@@ -23,7 +23,8 @@
   the evaluation, only the result of the evaluation is shown in the cell.
   After pressing <key|return> a second time in the cell, it will be possible
   switch back and edit the input. In the formulas, one may refer to the
-  others using names such as c5 for the third row and the fifth column.
+  others using names such as <samp|c5> for the third row and the fifth
+  column.
 
   <\example>
     On the left-hand side of the figure below, we have displayed a simple
@@ -42,7 +43,7 @@
     instance, the figure below demonstrates another possible use of
     <name|Maxima>.
 
-    <\big-figure|<small|<with|prog-scripts|maxima|<calc-table|derivatives1|<numeric-dot-table|<tformat|<cwith|1|-1|1|1|cell-width|15em>|<cwith|1|-1|1|1|cell-hmode|max>|<table|<row|<cell|<cell-inert|a1|<math|sin<around*|(|x<rsup|2>|)>>>>>|<row|<cell|<cell-inert|b1|=diff(a1,x)>>>|<row|<cell|<cell-inert|c1|=diff(b1,x)>>>|<row|<cell|<cell-inert|d1|=diff(c1,x)>>>>>>><space|2em><calc-table|derivatives2|<numeric-dot-table|<tformat|<cwith|1|-1|1|1|cell-width|15em>|<cwith|1|-1|1|1|cell-hmode|max>|<table|<row|<cell|<cell-inert|a1|<math|sin<around*|(|x<rsup|2>|)>>>>>|<row|<cell|<cell-output|b1|=diff(a1,x)|<math|2*x*cos
+    <\big-figure|<small|<with|prog-scripts|maxima|<calc-table|derivatives1|<textual-table|<tformat|<cwith|1|-1|1|1|cell-width|15em>|<cwith|1|-1|1|1|cell-hmode|max>|<table|<row|<cell|<cell-inert|a1|<math|sin<around*|(|x<rsup|2>|)>>>>>|<row|<cell|<cell-inert|b1|=diff(a1,x)>>>|<row|<cell|<cell-inert|c1|=diff(b1,x)>>>|<row|<cell|<cell-inert|d1|=diff(c1,x)>>>>>>><space|2em><calc-table|derivatives2|<textual-table|<tformat|<cwith|1|-1|1|1|cell-width|15em>|<cwith|1|-1|1|1|cell-hmode|max>|<table|<row|<cell|<cell-inert|a1|<math|sin<around*|(|x<rsup|2>|)>>>>>|<row|<cell|<cell-output|b1|=diff(a1,x)|<math|2*x*cos
     <around*|(|x<rsup|2>|)>>>>>|<row|<cell|<cell-output|c1|=diff(b1,x)|<math|2*cos
     <around*|(|x<rsup|2>|)>-4*x<rsup|2>*sin
     <around*|(|x<rsup|2>|)>>>>>|<row|<cell|<cell-output|d1|=diff(c1,x)|<math|-12*x*sin
@@ -53,7 +54,29 @@
   </example>
 
   <TeXmacs> supports a few special notations for applying operations on all
-  cells in a subtable. For instance,
+  cells in a subtable. For instance, as in <name|Excel>, one may use the
+  notation <samp|c3:d5> for indicating all cells <samp|c3>, <samp|c4>,
+  <samp|c5>, <samp|d3>, <samp|d4>, <samp|d5> in the block from <samp|c3> to
+  <samp|d5>. An alternative notation <cell-commas> for <samp|:> can be
+  entered by typing <key|, ,>. In a similar way, one may enter the special
+  notation <cell-plusses> by typing <key|+ +>. For instance,
+  <samp|c3<cell-plusses>d5> stands for the sum of all cells between <samp|c3>
+  and <samp|d5>.
+
+  <\example>
+    The figure below shows an example on how to use taking sums of cells.
+    Notice that empty cells count for zero.
+
+    <\big-figure|<small|<with|prog-scripts|maxima|<calc-table|sum1|<numeric-dot-table|<tformat|<cwith|1|-1|1|-1|cell-width|5em>|<cwith|1|-1|1|-1|cell-hmode|max>|<table|<row|<cell|<cell-inert|a1|15.10>>|<cell|<cell-inert|a2|15.10>>|<cell|<cell-inert|a3|30.20>>>|<row|<cell|<cell-inert|b1|100>>|<cell|<cell-inert|b2|125>>|<cell|<cell-inert|b3|75>>>|<row|<cell|<cell-inert|c1|28.50>>|<cell|<cell-inert|c2|>>|<cell|<cell-inert|c3|14.25>>>|<row|<cell|<cell-inert|d1|12>>|<cell|<cell-inert|d2|16>>|<cell|<cell-inert|d3|20>>>|<row|<cell|<cell-inert|e1|=a1<cell-plusses>d1>>|<cell|<cell-inert|e2|=a2<cell-plusses>d2>>|<cell|<cell-inert|e3|=a3<cell-plusses>c3>>>>>>><space|2em><calc-table|sum2|<numeric-dot-table|<tformat|<cwith|1|-1|1|-1|cell-width|5em>|<cwith|1|-1|1|-1|cell-hmode|max>|<cwith|5|5|1|3|cell-width|5em>|<cwith|5|5|1|3|cell-hmode|max>|<table|<row|<cell|<cell-inert|a1|15.10>>|<cell|<cell-inert|a2|15.10>>|<cell|<cell-inert|a3|30.20>>>|<row|<cell|<cell-inert|b1|100>>|<cell|<cell-inert|b2|125>>|<cell|<cell-inert|b3|75>>>|<row|<cell|<cell-inert|c1|28.50>>|<cell|<cell-inert|c2|>>|<cell|<cell-inert|c3|14.25>>>|<row|<cell|<cell-inert|d1|12>>|<cell|<cell-inert|d2|16>>|<cell|<cell-inert|d3|20>>>|<row|<cell|<cell-output|e1|=a1<cell-plusses>d1|<math|155.6>>>|<cell|<cell-output|e2|=a2<cell-plusses>d2|<math|156.1>>>|<cell|<cell-output|e3|=a3<cell-plusses>c3|<math|119.45>>>>>>>>>>>
+      Evaluation of a simple spreadsheet.
+    </big-figure>
+  </example>
+
+  Notice that copying and pasting of subtables works in the same way as for
+  ordinary tables, with the additional features that the names of the cells
+  and references to cells in the formulas are renumbered automatically.
+  Similarly, automatic renumbering is used when inserting new columns or
+  rows, or when removing existing columns or rows.
 
   <tmdoc-copyright|2012|Joris van der Hoeven>