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>
 
 	* org.texi (Sectioning structure): Update.
+	(References): New use case for field coordinates.
 
 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
 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}
-and @code{org-table-current-column}.  Example:
+and @code{org-table-current-column}.  Examples:
 
 @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
 
+@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
 @cindex named references
 @cindex references, named