Browse Source

org.texi: Re-generate file

Nicolas Goaziou 7 years ago
parent
commit
9a5557d715
1 changed files with 39 additions and 22 deletions
  1. 39 22
      doc/org.texi

+ 39 - 22
doc/org.texi

@@ -2300,9 +2300,11 @@ Shrink all columns with a column width.  Expand the others.
 Expand all columns.
 Expand all columns.
 @end table
 @end table
 
 
-To see the full text of a shrunk field, hold the mouse over it---a
-tool-tip window then shows the full content.  Alternatively @kbd{C-h .}  (@code{display-local-help}) reveals the full content.  For
-convenience, any change to a shrunk column expands it.
+To see the full text of a shrunk field, hold the mouse over it:
+a tool-tip window then shows the full contents of the field.
+Alternatively, @kbd{C-h .} (@code{display-local-help}) reveals them,
+too.  For convenience, any change near the shrunk part of a column
+expands it.
 
 
 @vindex org-startup-shrink-all-tables
 @vindex org-startup-shrink-all-tables
 Setting the option @code{org-startup-shrink-all-tables} shrinks all columns
 Setting the option @code{org-startup-shrink-all-tables} shrinks all columns
@@ -18062,14 +18064,14 @@ Choose one of the options; they are mutually exclusive.  The default
 follows from the type specified above.
 follows from the type specified above.
 
 
 @table @asis
 @table @asis
-@item @samp{raw}
-Interpreted as raw Org mode.  Inserted directly into the buffer.
-Aligned if it is a table.  Usage example: @samp{:results value raw}.
+@item @samp{code}
+Result enclosed in a code block.  Useful for parsing.  Usage
+example: @samp{:results value code}.
 
 
-@item @samp{org}
-Results enclosed in a @samp{BEGIN_SRC org} block.  For comma-escape,
-either @kbd{@key{TAB}} in the block, or export the file.  Usage
-example: @samp{:results value org}.
+@item @samp{drawer}
+Result wrapped in a @samp{RESULTS} drawer.  Useful for containing
+@samp{raw} or @samp{org} results for later scripting and automated
+processing.  Usage example: @samp{:results value drawer}.
 
 
 @item @samp{html}
 @item @samp{html}
 Results enclosed in a @samp{BEGIN_EXPORT html} block.  Usage example:
 Results enclosed in a @samp{BEGIN_EXPORT html} block.  Usage example:
@@ -18079,19 +18081,32 @@ Results enclosed in a @samp{BEGIN_EXPORT html} block.  Usage example:
 Results enclosed in a @samp{BEGIN_EXPORT latex} block.  Usage example:
 Results enclosed in a @samp{BEGIN_EXPORT latex} block.  Usage example:
 @samp{:results value latex}.
 @samp{:results value latex}.
 
 
-@item @samp{code}
-Result enclosed in a code block.  Useful for parsing.  Usage
-example: @samp{:results value code}.
+@item @samp{link}
+@itemx @samp{graphics}
+Result is a link to the file specified in @samp{:file} header
+argument.  However, unlike plain @samp{:file}, nothing is written to
+the disk.  The block is used for its side-effects only, as in the
+following example:
+
+@example
+#+begin_src shell :results link :file "download.tar.gz"
+wget -c "http://example.com/download.tar.gz"
+#+end_src
+@end example
+
+@item @samp{org}
+Results enclosed in a @samp{BEGIN_SRC org} block.  For comma-escape,
+either @kbd{@key{TAB}} in the block, or export the file.  Usage
+example: @samp{:results value org}.
 
 
 @item @samp{pp}
 @item @samp{pp}
 Result converted to pretty-print source code.  Enclosed in a code
 Result converted to pretty-print source code.  Enclosed in a code
 block.  Languages supported: Emacs Lisp, Python, and Ruby.  Usage
 block.  Languages supported: Emacs Lisp, Python, and Ruby.  Usage
 example: @samp{:results value pp}.
 example: @samp{:results value pp}.
 
 
-@item @samp{drawer}
-Result wrapped in a @samp{RESULTS} drawer.  Useful for containing
-@samp{raw} or @samp{org} results for later scripting and automated
-processing.  Usage example: @samp{:results value drawer}.
+@item @samp{raw}
+Interpreted as raw Org mode.  Inserted directly into the buffer.
+Aligned if it is a table.  Usage example: @samp{:results value raw}.
 @end table
 @end table
 
 
 @anchor{Handling}
 @anchor{Handling}
@@ -19137,12 +19152,15 @@ blocks, such as @samp{#+BEGIN_SRC} @dots{} @samp{#+END_SRC}, or to wrap existing
 text in such a block.
 text in such a block.
 
 
 @table @asis
 @table @asis
-@item @kbd{C-c C-x w} (@code{org-insert-structure-template})
+@item @kbd{C-c C-,} (@code{org-insert-structure-template})
+@findex org-insert-structure-template
+@kindex C-c C-,
 Prompt for a type of block structure, and insert the block at
 Prompt for a type of block structure, and insert the block at
 point.  If the region is active, it is wrapped in the block.
 point.  If the region is active, it is wrapped in the block.
-First prompts the user for a key, which is used to look up
-a structure type from the values below.  If the key is
-@kbd{@key{TAB}}, the user is prompted to enter a type.
+First prompts the user for keys, which are used to look up
+a structure type from the variable below.  If the key is
+@kbd{@key{TAB}}, @kbd{@key{RET}}, or @kbd{@key{SPC}}, the user is
+prompted to enter a block type.
 @end table
 @end table
 
 
 @vindex org-structure-template-alist
 @vindex org-structure-template-alist
@@ -19154,7 +19172,6 @@ changing values.
 @cindex template expansion
 @cindex template expansion
 @cindex insertion, of templates
 @cindex insertion, of templates
 @vindex org-tempo-keywords-alist
 @vindex org-tempo-keywords-alist
-@vindex org-structure-template-alist
 Org Tempo expands snippets to structures defined in
 Org Tempo expands snippets to structures defined in
 @code{org-structure-template-alist} and @code{org-tempo-keywords-alist}.  For
 @code{org-structure-template-alist} and @code{org-tempo-keywords-alist}.  For
 example, @kbd{< s @key{TAB}} creates a code block.  Enable it by
 example, @kbd{< s @key{TAB}} creates a code block.  Enable it by