doc: documenting the new option for inline call lines

* doc/org.texi (Evaluating code blocks): Documenting the new option
  for inline call lines.
This commit is contained in:
Eric Schulte 2011-06-24 15:22:42 -07:00
parent 5c3def4713
commit 00c62aa65f
1 changed files with 12 additions and 3 deletions

View File

@ -11593,11 +11593,20 @@ It is also possible to evaluate named code blocks from anywhere in an
Org-mode buffer or an Org-mode table. @code{#+call} (or synonymously Org-mode buffer or an Org-mode table. @code{#+call} (or synonymously
@code{#+function} or @code{#+lob}) lines can be used to remotely execute code @code{#+function} or @code{#+lob}) lines can be used to remotely execute code
blocks located in the current Org-mode buffer or in the ``Library of Babel'' blocks located in the current Org-mode buffer or in the ``Library of Babel''
(see @ref{Library of Babel}). These lines use the following syntax. (see @ref{Library of Babel}). These lines use the following syntax to place
a call on a line by itself.
@example @example
#+call: <name>(<arguments>) #+call: <name>(<arguments>)
#+call: <name>[<header arguments>](<arguments>) <header arguments> #+call: <name>[<header args>](<arguments>) <header args>
@end example
The following syntax can be used to place these calls within a block of
prose.
@example
...prose... call_<name>(<arguments>) ...prose...
...prose... call_<name>[<header args>](<arguments>)[<header args>] ...prose...
@end example @end example
@table @code @table @code
@ -11610,7 +11619,7 @@ block expressed using standard function call syntax. For example if the
original code block named @code{double} has the header argument @code{:var original code block named @code{double} has the header argument @code{:var
n=2}, then the call line passing the number four to that block would be n=2}, then the call line passing the number four to that block would be
written as @code{#+call: double(n=2)}. written as @code{#+call: double(n=2)}.
@item <header arguments> @item <header args>
Header arguments can be placed either inside the call to the code block or at Header arguments can be placed either inside the call to the code block or at
the end of the line as shown below. the end of the line as shown below.