Browse Source

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.
Bastien Guerry 13 years ago
parent
commit
454ee2346e
1 changed files with 28 additions and 28 deletions
  1. 28 28
      doc/org.texi

+ 28 - 28
doc/org.texi

@@ -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{}
-environment).  Both are written in uppercase@footnote{@code{#+results} is the
-only exception, as it is dynamically inserted with lowercase characters.} for
-a better readability of the manual, but you can safely use lowercase
-(e.g. @code{#+title} and @code{#+begin_latex}) in your Org files.
+and @i{environment keywords} (like @code{#+BEGIN_HTML} to start a @code{HTML}
+environment).  They are written in uppercase in the manual to enhance its
+readability, but you can use lowercase in your Org files@footnote{Easy
+templates insert lowercase keywords and Babel dynamically inserts
+@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