From cb4e04585cd844fbb5a0b86cd358eced42d9e477 Mon Sep 17 00:00:00 2001 From: Joris van der Hoeven Date: Wed, 7 Mar 2012 13:09:20 +0000 Subject: [PATCH] Completed documentation of spreadsheets --- main/interface/man-spreadsheet.en.tm | 62 ++++++++++++++++++++++++++++ 1 file changed, 62 insertions(+) diff --git a/main/interface/man-spreadsheet.en.tm b/main/interface/man-spreadsheet.en.tm index 78945c3..2612555 100644 --- a/main/interface/man-spreadsheet.en.tm +++ b/main/interface/man-spreadsheet.en.tm @@ -78,6 +78,68 @@ Similarly, automatic renumbering is used when inserting new columns or rows, or when removing existing columns or rows. + also allows you to use some of the spreadsheet capacities outside + tables. For instance, assuming that you selected a scripting language from + , you may insert a new + using or . The behaviour is similar to the one of : when pressing , the + current input is evaluated and you will see the corresponding output; you + may switch back to the input by pressing once more. In + particular, the input does not need to be preceded by (as in the + case of spreadsheet cells). + + Contrary to executable switches, you may attach an identifier to the + executable input field by disactivating the field or by editing the + field in the focus bar. Inside other executable input fields, + you may then refer to the value of the field by inserting a using or . As a variant to executable input fields, you may sometimes + prefer to insert plain using + or . These fields can only be used as inputs + and pressing inside such a field will only recompute those + other fields which depend on it. + + <\example> + The excutable input fields may for instance be nice in pedagogic + documents in which parts of the document may be modified and recomputed + by the reader. For instance, evaluation of the input fragment + + <\quote-env> + The derivative of >>> + equals ,x)|*+1|)>>>>. + + The second derivative is given by ,x)|*+1|)>+x>>>. + + + yields + + <\quote-env> + The derivative of >>> + equals ,x)|*+1|)>>>>. + + The second derivative is given by ,x)|*+1|)>+x>>>. + + + Of course, if the reader changes the input function > into + something else and presses , then the first and second + derivatives will be updated automatically. + + + We notice that field references can also be used inside spreadsheet cells + in order to refer to some computational markup outside the table. + Inversely, each spreadsheet also carries an invisible field + which can be edited by deactivating the spreadsheet or from the focus bar + (when selecting the entire spreadsheet). The field of the + spreadsheet is used as a prefix for refering to the contents of cells + outside the table or from within other spreadsheets. For instance, if + equals , then will refer to the + field inside the table. +