Minor editorial changes to babel documentation (Seattle Airport)

This commit is contained in:
Tom Dye 2010-06-14 19:47:59 -04:00 committed by Eric Schulte
parent 892292c2d9
commit b548c3e794
1 changed files with 32 additions and 34 deletions

View File

@ -10934,7 +10934,7 @@ further configuration options.
@table @code @table @code
@item org-src-lang-modes @item org-src-lang-modes
If an emacs major-mode named @code{<lang>-mode} exists, where If an Emacs major-mode named @code{<lang>-mode} exists, where
@code{<lang>} is the language named in the header line of the code block, @code{<lang>} is the language named in the header line of the code block,
then the edit buffer will be placed in that major-mode. This variable then the edit buffer will be placed in that major-mode. This variable
can be used to map arbitrary language names to existing major modes. can be used to map arbitrary language names to existing major modes.
@ -10946,7 +10946,7 @@ python, in which whitespace indentation in the output is critical.
@item org-src-ask-before-returning-to-edit-buffer @item org-src-ask-before-returning-to-edit-buffer
By default, Org will ask before returning to an open edit buffer. Set By default, Org will ask before returning to an open edit buffer. Set
to a non-nil value to switch without asking. to a non-nil value to switch without asking.
@end table @End table
@node Exporting code blocks, Extracting source code, Editing source code, Working With Source Code @node Exporting code blocks, Extracting source code, Editing source code, Working With Source Code
@comment node-name, next, previous, up @comment node-name, next, previous, up
@ -10969,15 +10969,13 @@ behavior:
The default in most languages. The body of the code block is exported, as The default in most languages. The body of the code block is exported, as
described in @ref{Literal examples}. described in @ref{Literal examples}.
@item :exports results @item :exports results
On export, the code block will be evaluated and the results will be placed in The code block will be evaluated and the results will be placed in the
the Org-mode buffer, either updating previous results of the code block Org-mode buffer for export, either updating previous results of the code
located anywhere in the buffer or, if no previous results exist, placing the block located anywhere in the buffer or, if no previous results exist,
results immediately after the code block. The body of the code block will placing the results immediately after the code block. The body of the code
not be exported. block will not be exported.
@item :exports both @item :exports both
On export, the code block will be evaluated and the results inserted into the Both the code block and its results will be exported.
buffer as described above, however the body of the code block will be
exported as well.
@item :exports none @item :exports none
Neither the code block nor its results will be exported. Neither the code block nor its results will be exported.
@end table @end table
@ -10988,29 +10986,29 @@ Neither the code block nor its results will be exported.
@section Extracting source code @section Extracting source code
Creating pure source code files by extracting code from source blocks is Creating pure source code files by extracting code from source blocks is
referred to as ``tangling'' -- a term adopted from the literate programming referred to as ``tangling''---a term adopted from the literate programming
community. During ``tangling'' of code blocks their bodies are expanded community. During ``tangling'' of code blocks their bodies are expanded
using @code{org-babel-expand-src-block} which can expand both variable and using @code{org-babel-expand-src-block} which can expand both variable and
``noweb'' (see @ref{Noweb reference syntax}) style references. ``noweb'' style references (see @ref{Noweb reference syntax}).
@subsubheading header arguments: @subsubheading header arguments:
@table @code @table @code
@item :tangle no @item :tangle no
The default. The default. The code block is not included in the tangled output.
@item :tangle yes @item :tangle yes
Include block in tangled output. The output file name is the name of the org Include the code block in the tangled output. The output file name is the
file with the extension @samp{.org} replaced by the extension for the block name of the org file with the extension @samp{.org} replaced by the extension
language. for the block language.
@item :tangle filename @item :tangle filename
Include block in tangled output to file @samp{filename} Include the code block in the tangled output to file @samp{filename}.
@end table @end table
@subsubheading functions: @subsubheading functions:
@table @code @table @code
@item org-babel-tangle @key{C-c C-v t} @item org-babel-tangle @key{C-c C-v t}
Tangle the current file Tangle the current file.
@item org-babel-tangle-file @item org-babel-tangle-file
Choose a file to tangle Choose a file to tangle.
@end table @end table
@node Evaluating code blocks, Library of Babel, Extracting source code, Working With Source Code @node Evaluating code blocks, Library of Babel, Extracting source code, Working With Source Code
@ -11018,22 +11016,22 @@ Choose a file to tangle
@comment Evaluating code blocks, , Extracting source code, Working With Source Code @comment Evaluating code blocks, , Extracting source code, Working With Source Code
@section Evaluating code blocks @section Evaluating code blocks
Blocks of code can be evaluated and the results incorporated into the Code blocks can be evaluated and the results placed in the Org-mode buffer.
org-mode buffer. Check the value of the @code{org-babel-interpreters} for a Check the value of the @code{org-babel-interpreters} for a list of languages
list of evaluable languages on your system, also see @ref{Languages} for a that can be evaluated on your system. See also @ref{Languages} for a list of
list of supported languages. See @ref{Structure of code blocks} for supported languages. See @ref{Structure of code blocks} for information on
information on the syntax used to define a code block. the syntax used to define a code block.
There are a number of ways of evaluating code blocks. The simplest is to There are a number of ways to evaluate code blocks. The simplest is to
press @key{C-c C-c} with the point on a code block. This will call the press @key{C-c C-c} with the point on a code block. This will call the
@code{org-babel-execute-src-block} function evaluating the block and @code{org-babel-execute-src-block} function to evaluate the block and
inserting its results into the Org-mode buffer. insert its results into the Org-mode buffer.
It is also possible to evaluate named code blocks from anywhere in an 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}). Both of these lines use the following syntax. (see @ref{Library of Babel}). These lines use the following syntax.
@example @example
#+call: <name>(<arguments>) <header arguments> #+call: <name>(<arguments>) <header arguments>
@ -11041,7 +11039,7 @@ blocks located in the current Org-mode buffer or in the ``Library of Babel''
@table @code @table @code
@item <name> @item <name>
This name is associated with the source code block to be evaluated. The name of the source code block to be evaluated.
@item <arguments> @item <arguments>
Arguments specified in this section will be passed to the code block. Arguments specified in this section will be passed to the code block.
@item <header arguments> @item <header arguments>
@ -11052,10 +11050,10 @@ Header arguments can be placed after the function invocation. See
@node Library of Babel, Languages, Evaluating code blocks, Working With Source Code @node Library of Babel, Languages, Evaluating code blocks, Working With Source Code
@section Library of Babel @section Library of Babel
The ``Library of Babel'' is two things. First it is a library of code blocks The ``Library of Babel'' is two things. First, it is a library of code blocks
which can be called from any Org-mode file, and second it is an actual that can be called from any Org-mode file, and second it is an actual
Org-mode file located in the @samp{contrib} directory of Org-mode in which Org-mode file located in the @samp{contrib} directory of Org-mode in which
Org-mode users may deposit functions which they believe to be generally Org-mode users may deposit functions they believe to be generally
useful. useful.
Code blocks defined in the``Library of Babel'' can be called remotely as if Code blocks defined in the``Library of Babel'' can be called remotely as if
@ -11577,7 +11575,7 @@ it is absent, then the directory associated with the current buffer is
used. In other words, supplying @code{:dir path} temporarily has the same used. In other words, supplying @code{:dir path} temporarily has the same
effect as changing the current directory with @key{M-x cd path}, and then not effect as changing the current directory with @key{M-x cd path}, and then not
supplying @code{:dir}. Under the surface, @code{:dir} simply sets the value supplying @code{:dir}. Under the surface, @code{:dir} simply sets the value
of the emacs variable @code{default-directory}. of the Emacs variable @code{default-directory}.
When using @code{:dir}, you should supply a relative path for file output When using @code{:dir}, you should supply a relative path for file output
(e.g. @code{:file myfile.jpg} or @code{:file results/myfile.jpg}) in which (e.g. @code{:file myfile.jpg} or @code{:file results/myfile.jpg}) in which
@ -11615,7 +11613,7 @@ and a link of the following form will be inserted in the org buffer:
@end example @end example
Most of this functionality follows immediately from the fact that @code{:dir} Most of this functionality follows immediately from the fact that @code{:dir}
sets the value of the emacs variable @code{default-directory}, thanks to sets the value of the Emacs variable @code{default-directory}, thanks to
tramp. Those using XEmacs, or GNU Emacs prior to version 23 may need to tramp. Those using XEmacs, or GNU Emacs prior to version 23 may need to
install tramp separately in order for the above features to work correctly. install tramp separately in order for the above features to work correctly.