Browse Source

Doc improvements

Carsten Dominik 15 years ago
parent
commit
d1500f3c8a
2 changed files with 10 additions and 2 deletions
  1. 1 0
      doc/ChangeLog
  2. 9 2
      doc/org.texi

+ 1 - 0
doc/ChangeLog

@@ -1,6 +1,7 @@
 2010-04-04  Carsten Dominik  <carsten.dominik@gmail.com>
 2010-04-04  Carsten Dominik  <carsten.dominik@gmail.com>
 
 
 	* org.texi (Sectioning structure): Update.
 	* org.texi (Sectioning structure): Update.
+	(References): New use case for field coordinates.
 
 
 2010-04-01  Carsten Dominik  <carsten.dominik@gmail.com>
 2010-04-01  Carsten Dominik  <carsten.dominik@gmail.com>
 
 

+ 9 - 2
doc/org.texi

@@ -2061,12 +2061,19 @@ see the @samp{E} mode switch below).  If there are no non-empty fields,
 For Calc formulas and Lisp formulas @code{@@#} and @code{$#} can be used to
 For Calc formulas and Lisp formulas @code{@@#} and @code{$#} can be used to
 get the row or column number of the field where the formula result goes.
 get the row or column number of the field where the formula result goes.
 The traditional Lisp formula equivalents are @code{org-table-current-dline}
 The traditional Lisp formula equivalents are @code{org-table-current-dline}
-and @code{org-table-current-column}.  Example:
+and @code{org-table-current-column}.  Examples:
 
 
 @example
 @example
-if(@@# % 2, $#, string(""))      @r{column number on odd lines only}
+if(@@# % 2, $#, string(""))   @r{column number on odd lines only}
+$3 = remote(FOO, @@@@#$2)      @r{copy column 2 from table FOO into}
+                             @r{column 3 of the current table}
 @end example
 @end example
 
 
+@noindent For the second example, table FOO must have at least as many rows
+as the current table.  Inefficient@footnote{The computation time scales as
+O(N^2) because table FOO is parsed for each field to be copied.} for large
+number of rows.
+
 @subsubheading Named references
 @subsubheading Named references
 @cindex named references
 @cindex named references
 @cindex references, named
 @cindex references, named