org.texi: Use uppercase for #+results too.

Using lowercase for environment keywords is not as readable
as using uppercase.  Using lowercase just for #+results looks
weird -- instead, we use uppercase for *all* environment and
option keywords, explicitely explaining that the user can use
either lowercase or uppercase in their file.
This commit is contained in:
Bastien Guerry 2012-01-11 16:31:13 +01:00
parent a9c15fe9ab
commit 454ee2346e
1 changed files with 28 additions and 28 deletions

View File

@ -1097,11 +1097,11 @@ special meaning are written with all capitals.
@end table @end table
Moreover, Org uses @i{option keywords} (like @code{#+TITLE} to set the title) Moreover, Org uses @i{option keywords} (like @code{#+TITLE} to set the title)
and @i{environment keywords} (like @code{#+BEGIN_LaTeX} to start a @LaTeX{} and @i{environment keywords} (like @code{#+BEGIN_HTML} to start a @code{HTML}
environment). Both are written in uppercase@footnote{@code{#+results} is the environment). They are written in uppercase in the manual to enhance its
only exception, as it is dynamically inserted with lowercase characters.} for readability, but you can use lowercase in your Org files@footnote{Easy
a better readability of the manual, but you can safely use lowercase templates insert lowercase keywords and Babel dynamically inserts
(e.g. @code{#+title} and @code{#+begin_latex}) in your Org files. @code{#+results}.}
The manual lists both the keys and the corresponding commands for accessing a The manual lists both the keys and the corresponding commands for accessing a
functionality. Org mode often uses the same key for different functions, functionality. Org mode often uses the same key for different functions,
@ -12945,7 +12945,7 @@ Multi-line header arguments on an un-named code block:
(message "data1:%S, data2:%S" data1 data2) (message "data1:%S, data2:%S" data1 data2)
#+END_SRC #+END_SRC
#+results: #+RESULTS:
: data1:1, data2:2 : data1:1, data2:2
@end example @end example
@ -12957,7 +12957,7 @@ Multi-line header arguments on a named code block:
(message "data:%S" data) (message "data:%S" data)
#+END_SRC #+END_SRC
#+results: named-block #+RESULTS: named-block
: data:2 : data:2
@end example @end example
@ -13030,7 +13030,7 @@ case, variables require a default value when they are declared.
The values passed to arguments can either be literal values, references, or The values passed to arguments can either be literal values, references, or
Emacs Lisp code (see @ref{var, Emacs Lisp evaluation of variables}). References Emacs Lisp code (see @ref{var, Emacs Lisp evaluation of variables}). References
include anything in the Org mode file that takes a @code{#+NAME:}, include anything in the Org mode file that takes a @code{#+NAME:},
@code{#+TBLNAME:}, or @code{#+results:} line. This includes tables, lists, @code{#+TBLNAME:}, or @code{#+RESULTS:} line. This includes tables, lists,
@code{#+BEGIN_EXAMPLE} blocks, other code blocks, and the results of other @code{#+BEGIN_EXAMPLE} blocks, other code blocks, and the results of other
code blocks. code blocks.
@ -13067,7 +13067,7 @@ an Org mode table named with either a @code{#+NAME:} or @code{#+TBLNAME:} line
(length table) (length table)
#+END_SRC #+END_SRC
#+results: table-length #+RESULTS: table-length
: 4 : 4
@end example @end example
@ -13086,7 +13086,7 @@ carried through to the source code block)
(print x) (print x)
#+END_SRC #+END_SRC
#+results: #+RESULTS:
| simple | list | | simple | list |
@end example @end example
@ -13099,7 +13099,7 @@ optionally followed by parentheses
(* 2 length) (* 2 length)
#+END_SRC #+END_SRC
#+results: #+RESULTS:
: 8 : 8
@end example @end example
@ -13114,7 +13114,7 @@ code block name using standard function call syntax
(* 2 input) (* 2 input)
#+END_SRC #+END_SRC
#+results: double #+RESULTS: double
: 16 : 16
#+NAME: squared #+NAME: squared
@ -13122,7 +13122,7 @@ code block name using standard function call syntax
(* input input) (* input input)
#+END_SRC #+END_SRC
#+results: squared #+RESULTS: squared
: 4 : 4
@end example @end example
@ -13141,7 +13141,7 @@ on two lines
(concatenate 'string x " for you.") (concatenate 'string x " for you.")
#+END_SRC #+END_SRC
#+results: read-literal-example #+RESULTS: read-literal-example
: A literal example : A literal example
: on two lines for you. : on two lines for you.
@ -13183,7 +13183,7 @@ following example assigns the last cell of the first row the table
data data
#+END_SRC #+END_SRC
#+results: #+RESULTS:
: a : a
@end example @end example
@ -13204,7 +13204,7 @@ to @code{data}.
data data
#+END_SRC #+END_SRC
#+results: #+RESULTS:
| 2 | b | | 2 | b |
| 3 | c | | 3 | c |
| 4 | d | | 4 | d |
@ -13226,7 +13226,7 @@ column is referenced.
data data
#+END_SRC #+END_SRC
#+results: #+RESULTS:
| 1 | 2 | 3 | 4 | | 1 | 2 | 3 | 4 |
@end example @end example
@ -13246,7 +13246,7 @@ another by commas, as shown in the following example.
data data
#+END_SRC #+END_SRC
#+results: #+RESULTS:
| 11 | 14 | 17 | | 11 | 14 | 17 |
@end example @end example
@ -13279,7 +13279,7 @@ Emacs Lisp, as shown in the following example.
$data $data
#+END_SRC #+END_SRC
#+results: #+RESULTS:
: (a b c) : (a b c)
@end example @end example
@ -13682,7 +13682,7 @@ every time it is called.
@item @code{yes} @item @code{yes}
Every time the code block is run a SHA1 hash of the code and arguments Every time the code block is run a SHA1 hash of the code and arguments
passed to the block will be generated. This hash is packed into the passed to the block will be generated. This hash is packed into the
@code{#+results:} line and will be checked on subsequent @code{#+RESULTS:} line and will be checked on subsequent
executions of the code block. If the code block has not executions of the code block. If the code block has not
changed since the last time it was evaluated, it will not be re-evaluated. changed since the last time it was evaluated, it will not be re-evaluated.
@end itemize @end itemize
@ -13699,7 +13699,7 @@ changed since it was last run.
runif(1) runif(1)
#+END_SRC #+END_SRC
#+results[a2a72cd647ad44515fab62e144796432793d68e1]: random #+RESULTS[a2a72cd647ad44515fab62e144796432793d68e1]: random
0.4659510825295 0.4659510825295
#+NAME: caller #+NAME: caller
@ -13707,7 +13707,7 @@ changed since it was last run.
x x
#+END_SRC #+END_SRC
#+results[bec9c8724e397d5df3b696502df3ed7892fc4f5f]: caller #+RESULTS[bec9c8724e397d5df3b696502df3ed7892fc4f5f]: caller
0.254227238707244 0.254227238707244
@end example @end example
@ -13751,7 +13751,7 @@ default value yields the following results.
return tab return tab
#+END_SRC #+END_SRC
#+results: echo-table #+RESULTS: echo-table
| a | b | c | | a | b | c |
| d | e | f | | d | e | f |
| g | h | i | | g | h | i |
@ -13773,7 +13773,7 @@ Leaves hlines in the table. Setting @code{:hlines yes} has this effect.
return tab return tab
#+END_SRC #+END_SRC
#+results: echo-table #+RESULTS: echo-table
| a | b | c | | a | b | c |
|---+---+---| |---+---+---|
| d | e | f | | d | e | f |
@ -13811,7 +13811,7 @@ processing, then reapplied to the results.
return [[val + '*' for val in row] for row in tab] return [[val + '*' for val in row] for row in tab]
#+END_SRC #+END_SRC
#+results: echo-table-again #+RESULTS: echo-table-again
| a | | a |
|----| |----|
| b* | | b* |
@ -13854,7 +13854,7 @@ and is then reapplied to the results.
return [[val + 10 for val in row] for row in tab] return [[val + 10 for val in row] for row in tab]
#+END_SRC #+END_SRC
#+results: echo-table-once-again #+RESULTS: echo-table-once-again
| one | 11 | 12 | 13 | 14 | 15 | | one | 11 | 12 | 13 | 14 | 15 |
| two | 16 | 17 | 18 | 19 | 20 | | two | 16 | 17 | 18 | 19 | 20 |
@end example @end example
@ -13966,7 +13966,7 @@ process. For example, compare the following two blocks:
print "bye" print "bye"
#+END_SRC #+END_SRC
#+results: #+RESULTS:
: hello : hello
: bye : bye
@end example @end example
@ -13979,7 +13979,7 @@ In non-session mode, the `2' is not printed and does not appear.
print "bye" print "bye"
#+END_SRC #+END_SRC
#+results: #+RESULTS:
: hello : hello
: 2 : 2
: bye : bye