From 3281a5db13fa9fb03a7e6952148f865960f434a5 Mon Sep 17 00:00:00 2001
From: Joris van der Hoeven <vdhoeven@lix.polytechnique.fr>
Date: Tue, 6 Mar 2012 23:12:07 +0000
Subject: [PATCH] Basic documentation on spreadsheets

---
 main/interface/man-itf.en.tm         |  4 +-
 main/interface/man-spreadsheet.en.tm | 72 ++++++++++++++++++++++++++++
 2 files changed, 75 insertions(+), 1 deletion(-)
 create mode 100644 main/interface/man-spreadsheet.en.tm

diff --git a/main/interface/man-itf.en.tm b/main/interface/man-itf.en.tm
index 35e3fda..4278d94 100644
--- a/main/interface/man-itf.en.tm
+++ b/main/interface/man-itf.en.tm
@@ -1,4 +1,4 @@
-<TeXmacs|1.0.7.11>
+<TeXmacs|1.0.7.14>
 
 <style|tmdoc>
 
@@ -23,6 +23,8 @@
     <branch|Selecting the input method|man-session-input.en.tm>
 
     <branch|Scripting languages|man-scripting-language.en.tm>
+
+    <branch|Spreadsheets|man-spreadsheet.en.tm>
   </traverse>
 
   <tmdoc-copyright|1998--2002|Joris van der Hoeven>
diff --git a/main/interface/man-spreadsheet.en.tm b/main/interface/man-spreadsheet.en.tm
new file mode 100644
index 0000000..6a5f913
--- /dev/null
+++ b/main/interface/man-spreadsheet.en.tm
@@ -0,0 +1,72 @@
+<TeXmacs|1.0.7.14>
+
+<style|tmdoc>
+
+<\body>
+  <tmdoc-title|Spreadsheets>
+
+  <TeXmacs> provides rudimentary spreadsheet-like facilities with the
+  advantage that the computations can be carried out using any of the
+  plug-ins that can be used as a scripting language. In order to use the
+  spreadsheet facilities, you should therefore start with the selection of a
+  scripting language in the menu <menu|Document|Scripts>.
+
+  As soon as you have selecting a scripting language, such as <name|Maxima>,
+  then you may enter a new spreadsheet using <menu|Insert|Table|Textual
+  spreadsheet> or <menu|Insert|Table|Numeric spreadsheet>. You may edit the
+  spreadsheet as an ordinary table, except that the <key|return> key will
+  attempt to reevaluate the cells of the table.
+
+  In addition, when preceding the contents of a cell by =, then cell will be
+  considered as an input-output switch. More precisely, the input is a
+  formula which will be evaluated using the current scripting language. After
+  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.
+
+  <\example>
+    On the left-hand side of the figure below, we have displayed a simple
+    table with formulas for evaluating the sums of the first two items of
+    each row. On the right-hand side, we have shown the result after
+    evaluation.
+
+    <\big-figure|<small|<with|prog-scripts|maxima|<calc-table|simple1|<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|1>>|<cell|<cell-inert|a2|10>>|<cell|<cell-inert|a3|=a1+a2>>>|<row|<cell|<cell-inert|b1|100>>|<cell|<cell-inert|b2|1000>>|<cell|<cell-inert|b3|=b1+b2>>>>>>><space|2em><calc-table|simple2|<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|1>>|<cell|<cell-inert|a2|10>>|<cell|<cell-output|a3|=a1+a2|<math|11>>>>|<row|<cell|<cell-inert|b1|100>>|<cell|<cell-inert|b2|1000>>|<cell|<cell-output|b3|=b1+b2|<math|1100>>>>>>>>>>>
+      Evaluation of a simple spreadsheet.
+    </big-figure>
+  </example>
+
+  <\example>
+    The cells may contain mathematical formulas and the spreadsheet may take
+    advantage of any of the capacities of the scripting language. For
+    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
+    <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
+    <around*|(|x<rsup|2>|)>-8*x<rsup|3>*cos
+    <around*|(|x<rsup|2>|)>>>>>>>>>>>>
+      Computation of successive derivatives using <name|Maxima>.
+    </big-figure>
+  </example>
+
+  <TeXmacs> supports a few special notations for applying operations on all
+  cells in a subtable. For instance,
+
+  <tmdoc-copyright|2012|Joris van der Hoeven>
+
+  <tmdoc-license|Permission is granted to copy, distribute and/or modify this
+  document under the terms of the GNU Free Documentation License, Version 1.1
+  or any later version published by the Free Software Foundation; with no
+  Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
+  Texts. A copy of the license is included in the section entitled "GNU Free
+  Documentation License".>
+</body>
+
+<\initial>
+  <\collection>
+    <associate|language|english>
+  </collection>
+</initial>
\ No newline at end of file