Browse Source

Release 4.20

Carsten Dominik 18 years ago
parent
commit
d21dfc8541
6 changed files with 599 additions and 643 deletions
  1. 228 235
      org
  2. 252 297
      org.el
  3. BIN
      org.pdf
  4. 112 101
      org.texi
  5. BIN
      orgcard.pdf
  6. 7 10
      orgcard.tex

+ 228 - 235
org

@@ -5,7 +5,7 @@ START-INFO-DIR-ENTRY
 * Org Mode: (org).	outline-based notes management and organizer
 END-INFO-DIR-ENTRY
 
-   This manual is for Org-mode (version 4.19b).
+   This manual is for Org-mode (version 4.20).
 
    Copyright (C) 2004, 2005, 2006 Free Software Foundation
 
@@ -27,7 +27,7 @@ File: org,  Node: Top,  Next: Introduction,  Prev: (dir),  Up: (dir)
 Org Mode Manual
 ***************
 
-This manual is for Org-mode (version 4.19b).
+This manual is for Org-mode (version 4.20).
 
    Copyright (C) 2004, 2005, 2006 Free Software Foundation
 
@@ -265,12 +265,6 @@ this:
 which will select Org-mode for this buffer no matter what the file's
 name is.  See also the variable `org-insert-mode-line-in-empty-file'.
 
-   If you are upgrading to version 4.20 or later from a version 4.14 or
-earlier, some links may stop working.  These are links containing space
-characters.  To make such links work again, and also to transform all
-links from the old `<link>' format to the new `[[link]]' format,
-execute once in each file: `M-x org-upgrade-old-links'.
-
 
 File: org,  Node: Feedback,  Prev: Installation and activation,  Up: Introduction
 
@@ -681,18 +675,16 @@ unpredictable for you, configure the variables
 Creation and conversion
 .......................
 
-`M-x org-table-create'
-     Creates an empty Org-mode table.  However, it is much easier to
-     just start typing, like `|Name|Phone|Age <RET> |- <TAB>'
-
-`C-c C-c'
-     Convert region to table.  Works when the cursor is not in an
-     existing table, and when there is a region defined.  If every line
-     contains at least one TAB character, the function assumes that the
-     material is tab separated.  If not, lines are split at whitespace
-     into fields.  You can use a prefix argument to indicate the
-     minimum number of consequtive spaces required to indentify a field
-     separator (default: just one).
+`C-c |'
+     Convert the active region to table. If every line contains at
+     least one TAB character, the function assumes that the material is
+     tab separated.  If not, lines are split at whitespace into fields.
+     You can use a prefix argument to indicate the minimum number of
+     consequtive spaces required to indentify a field separator
+     (default: just one).
+     If there is no active region, this command creates an empty
+     Org-mode table.  However, it's easier to just start typing, like
+     `|Name|Phone|Age <RET> |- <TAB>'.
 
 Re-aligning and field motion
 ............................
@@ -834,11 +826,6 @@ Miscellaneous
      This is an alias for `C-u C-c `' to make the current field fully
      visible.
 
-`C-c |'
-     Toggle the visibility of vertical lines in tables.  The lines are
-     still there, only made invisible with a text property.  Any `|'
-     added by hand will become invisible on the next align.
-
 `M-x org-table-import'
      Import a file as a table.  The table should be TAB- or whitespace
      separated.  Useful, for example, to import an Excel table or data
@@ -1236,25 +1223,27 @@ File: org,  Node: Link format,  Next: Internal links,  Prev: Hyperlinks,  Up: Hy
 4.1 Link format
 ===============
 
-Org-mode will recognize plain URL-like links in the buffer and activate
-them as clickable links.  However, the general linkformat looks like
-this:
+Org-mode will recognize plain URL-like links and activate them as
+clickable links.  However, the general linkformat looks like this:
 
      [[link][description]]       or alternatively           [[link]]
 
-   The description part is optional.  Once a link in the buffer is
-complete, Org-mode will change the display so that `description'( is
-displayed instead of `[[link][description]]' and `link' is displayed
-instead of `[[link]]'.  Links will be highlighted in the face
-`org-link', which by default is an underlined face.  You can directly
-edit the visible part of a link.  To edit the invisible part, use `C-c
-C-l' with the cursor on the link.  If you place the cursor at the
-beginning of end of the displayed text and press <BACKSPACE>, you will
-remove the (invisible) bracket at that location.  This makes the link
-incomplete and the internals are again displayed as plain text.
-Inserting the missing bracket does hide the link internal again.
-Finally, you may also use the menu entry `Org->Hperlinks->Literal
-links' to unhide all links.
+   Once a link in the buffer is complete (all brackets present),
+Org-mode will change the display so that `description' is displayed
+instead of `[[link][description]]' and `link' is displayed instead of
+`[[link]]'.  Links will be highlighted in the face `org-link', which by
+default is an underlined face.  You can directly edit the visible part
+of a link.  Note that this can be either the `link' part (if there is
+not description) or the `description' part.  To edit also the invisible
+`link' part, use `C-c C-l' with the cursor on the link.
+
+   If you place the cursor at the beginning or just behind the end of
+the displayed text and press <BACKSPACE>, you will remove the
+(invisible) bracket at that location.  This makes the link incomplete
+and the internals are again displayed as plain text.  Inserting the
+missing bracket does hide the link internals again.  To show the
+internal structure of all links, use the menu entry
+`Org->Hyperlinks->Literal links'.
 
 
 File: org,  Node: Internal links,  Next: External links,  Prev: Link format,  Up: Hyperlinks
@@ -1325,13 +1314,9 @@ File: org,  Node: CamelCase links,  Prev: Radio targets,  Up: Internal links
 
 Org-mode also supports CamelCase words as links.  This feature is not
 turned on by default because of the inconsistencies this system suffers
-from.  It is mainly kept for backward compatibility, but the use is
-deprecated.  To activate CamelCase words as links, and to make headline
-completion offer CamelCase version of headlines, the following
-customization is needed:
-
-     (setq org-activate-camels t
-           org-file-link-context-use-camel-case t)
+from.  To activate CamelCase words as links, you need to customize the
+option `org-activate-links'.  A CamelCase word then leads to a text
+search such that `CamelCaseLink' is equivalent to `[[camel case link]]'.
 
 
 File: org,  Node: External links,  Next: Managing links,  Prev: Internal links,  Up: Hyperlinks
@@ -1360,7 +1345,7 @@ following list shows examples for each link type.
      gnus:group                               GNUS group link
      gnus:group#id                            GNUS article link
      bbdb:Richard Stallman                    BBDB link
-     shell:ls *.org(1)                          A shell command
+     shell:ls *.org                           A shell command
 
    A link should be enclosed in double brackets and may contain a
 descriptive text to be displayed instead of the url (*note Link
@@ -1369,13 +1354,9 @@ format::), for example:
      [[http://www.gnu.org/software/emacs/][GNU Emacs]]
 
    Org-mode also finds external links in the normal text and activates
-them as links.  Plain text links cannot contain spaces.  To remove
-ambiguities about the end of the link, enclose them in angular brackets.
-
-   ---------- Footnotes ----------
-
-   (1) Note that `<' and `>' cannot be part of a link, and therefore of
-a shell command.  If you need redirection, use @{ and @} instead.
+them as links.  If spaces must be part of the link (for example in
+`bbdb:Richard Stallman') or to remove ambiguities about the end of the
+link, enclose them in angular brackets.
 
 
 File: org,  Node: Managing links,  Next: Search Options,  Prev: External links,  Up: Hyperlinks
@@ -1390,9 +1371,9 @@ insert it into an org-mode file, and to follow the link.
      Store a link to the current location.  This is a _global_ command
      which can be used in any buffer to create a link.  The link will be
      stored for later insertion into an Org-mode buffer (see below).
-     For VM, RMAIL, WANDERLUST, GNUS and BBDB buffers, the link will
-     point to the current article/entry.  For W3 and W3M buffers, the
-     link goes to the current URL.  For Org-mode files, the current
+     For VM, RMAIL, WANDERLUST, MH-E, GNUS and BBDB buffers, the link
+     will point to the current article/entry.  For W3 and W3M buffers,
+     the link goes to the current URL.  For Org-mode files, the current
      headline is targeted.  For any other files, the link will point to
      the file, with a search string (*note Search Options::) pointing
      to the contents of the current line.  If there is an active
@@ -1519,11 +1500,11 @@ location in your Org-mode outline tree.  The following customization(1)
 will tell _Remember_ to use org files as target, and to create
 annotations compatible with Org-mode links.
 
+     (setq org-directory "~/path/to/my/orgfiles/")
+     (setq org-default-notes-file "~/.notes")
      (autoload 'org-remember-annotation "org")
      (autoload 'org-remember-apply-template "org")
      (autoload 'org-remember-handler "org")
-     (setq org-directory "~/path/to/my/orgfiles/")
-     (setq org-default-notes-file "~/.notes")
      (setq remember-annotation-functions '(org-remember-annotation))
      (setq remember-handler-functions '(org-remember-handler))
      (add-hook 'remember-mode-hook 'org-remember-apply-template)
@@ -1538,9 +1519,9 @@ journal entries, you could use:
              (?j "* %U %?\n\n  %i\n  %a" "~/org/JOURNAL.org")))
 
 In these entries, the character specifies how to select the template,
-the first string specifies the template, and the second string
-specifies a default file (overruling `org-default-notes-file') as a
-target for this note.
+the first string specifies the template, and the (optional) second
+string specifies a default file (overruling `org-default-notes-file')
+as a target for this note.
 
    When you call `M-x remember' to remember something, org will prompt
 for a key to select the template and then prepare the buffer like
@@ -1556,14 +1537,13 @@ or
 See the variable `org-remember-templates' for more details.
 
    When you are finished composing a note with remember, you have to
-press `C-c C-c' to exit remember-mode and to file the note away.  The
-handler first prompts for a target file - if you press <RET>, the value
-of `org-default-notes-file' is used.  Then the command offers the
-headings tree of the selected file.  You can either immediately press
-<RET> to get the note appended to the file.  Or you can use vertical
-cursor motion (<up> and <down>) and visibility cycling (<TAB>) to find
-a better place.  Pressing <RET> or <left> or <right> leads to the
-following result.
+press `C-c C-c' to file the note away.  The handler first prompts for a
+target file - if you press <RET>, the value of `org-default-notes-file'
+is used.  Then the command offers the headings tree of the selected
+file.  You can either immediately press <RET> to get the note appended
+to the file.  Or you can use vertical cursor motion (<up> and <down>)
+and visibility cycling (<TAB>) to find a better place.  Pressing <RET>
+or <left> or <right> leads to the following result.
 
 Cursor         Key     Note gets inserted
 position               
@@ -2532,7 +2512,7 @@ Remote editing
      original org file.
 
 `T'
-     Show all tags assiciated with the current item.  Because of
+     Show all tags associated with the current item.  Because of
      inheritance, this may be more than the tags listed in the line
      itself.
 
@@ -2591,7 +2571,7 @@ Calendar commands
      date at the cursor.
 
 `M'
-     Show the phases of the moon for the three month around current
+     Show the phases of the moon for the three months around current
      date.
 
 `S'
@@ -3049,33 +3029,53 @@ File: org,  Node: FAQ,  Next: Interaction,  Prev: TTY keys,  Up: Miscellaneous
 
   2. Some of my links stopped working after I upgraded to a version
      4.20 or later.  Why is this, and how can I fix it?
-     The newer versions of Org-mode have a better link system and no
-     longer allow unescaped space characters as part of a link.  To fix
-     these links, and also to move all `<link>' style links to the new
-     `[[link]]' system, execute once in each Org-mode file: `M-x
-     org-upgrade-old-links'.
-
-  3. I really like the old style links with angular brackets better.
-     Please give them back to me, don't tell me it is not possible!
+     These must be links in plain text, containing white space, such as
+     `bbdb:Richard Stallman'.  You need to protect these links by
+     putting double brackets around them, like `[[bbdb:Richard
+     Stallman]]'.
+
+  3. I see that Org-mode now creates links using the double bracket
+     convention that hides the link part and the brackets, only showing
+     the description part.  How can I convert my old links to this new
+     format?
+     Execute once in each Org-mode file: `M-x org-upgrade-old-links'.
+     The replaces angular brackets with the link format.
+
+  4. I don't care if you find the new bracket links great, I am
+     attached to the old style using angular brackets and no hiding of
+     the link text.  Please give them back to me, don't tell me it is
+     not possible!
      Would I let you down like that?  If you must (even if I don't
      understand why), you can do this
-          (setq org-allow-space-in-plain-links t
-                org-link-style 'plain
+          (setq org-link-style 'plain
                 org-link-format "<%s>")
 
-  4. All these stars are driving me mad, I just find the Emacs outlines
+  5. When I am executing shell links I always get a confirmation prompt
+     and need to type `yes <RET>', thats 4 key presses!  Can I get rid
+     of this?
+     The confirmation is there to protect you from unwantingly execute
+     potentially dangerous commands.  For example, imagine a link
+     `[[shell:rm -rf ~/*][Google Search]]'.  In an Org-mode buffer, this
+     command would look like `Google Search', but really it would remove
+     your home directory.  If you wish, you can make it easier to
+     respond to the query by setting `org-confirm-shell-links' to
+     `y-or-n-p'.  Then a single `y' keypress will be enough to confirm
+     shell links.  It is also possible to turn off this check entirely,
+     but I do not recommend to do this.  Be warned.
+
+  6. All these stars are driving me mad, I just find the Emacs outlines
      unreadable. Can't you just put white space and a single star as a
      starter for headlines?
      See *Note Clean view::.
 
-  5. I would like to have two windows on the same Org-mode file, but
+  7. I would like to have two windows on the same Org-mode file, but
      with different outline visibility.  Is that possible?
-     In GNU Emacs, you may use _indirect buffers_ which do exactly
-     this.  See the documentation on the command
-     `make-indirect-buffer'.  In XEmacs, this is currently not possible
-     because of the different outline implementation.
+     In GNU Emacs, you may use _indirect buffers_ which do exactly this.
+     See the documentation on the command `make-indirect-buffer'.  In
+     XEmacs, this is currently not possible because of the different
+     outline implementation.
 
-  6. When I export my TODO list, every TODO item becomes a separate
+  8. When I export my TODO list, every TODO item becomes a separate
      section.  How do I enforce these items to be exported as an
      itemized list?
      If you plan to use ASCII or HTML export, make sure things you want
@@ -3093,42 +3093,35 @@ File: org,  Node: FAQ,  Next: Interaction,  Prev: TTY keys,  Up: Miscellaneous
 
           +OPTIONS:   H:2; ...
 
-  7. I would like to export only a subtree of my file to HTML.  How?
+  9. I would like to export only a subtree of my file to HTML.  How?
      If you want to export a subtree, mark the subtree as region and
      then export.  Marking can be done with `C-c @ C-x C-x', for
      example.
 
-  8. Org-mode takes over the S-cursor keys.  I also want to use
+ 10. Org-mode takes over the S-cursor keys.  I also want to use
      CUA-mode, is there a way to fix this conflict?
      Yes, see *Note Interaction::.
 
-  9. Is there an easy way to insert an empty table template with a
-     default number of rows and columns?
-     To insert an empty table template, just type `|-' and use <TAB>.
-     The default size can be changed with the variable
-     `org-table-default-size'.  However, just starting to type the
-     first line is usually much easier.
-
- 10. One of my table columns has started to fill up with `#ERROR'.
+ 11. One of my table columns has started to fill up with `#ERROR'.
      What is going on?
      Org-mode tried to compute the column from other fields using a
      formula stored in the `#+TBLFMT:' line just below the table, and
      the evaluation of the formula fails.  Fix the fields used in the
      formula, or fix the formula, or remove it!
 
- 11. When I am in the last column of a table and just above a
+ 12. When I am in the last column of a table and just above a
      horizontal line in the table, pressing TAB creates a new table line
      before the horizontal line.  How can I quickly move to the line
      below the horizontal line instead?
      Press <down> (to get on the separator line) and then <TAB>.  Or
      configure the variable `org-table-tab-jumps-over-hlines'.
 
- 12. How can I change the indentation of an entire table without fixing
+ 13. How can I change the indentation of an entire table without fixing
      every line by hand?
      The indentation of a table is set by the first line.  So just fix
      the indentation of the first line and realign with <TAB>.
 
- 13. Is it possible to include entries from org-mode files into my
+ 14. Is it possible to include entries from org-mode files into my
      emacs diary?
      Since the org-mode agenda is much more powerful and can contain the
      diary (*note Calendar/Diary integration::), you should think twice
@@ -3374,7 +3367,7 @@ File: org,  Node: Index,  Next: Key Index,  Prev: Miscellaneous,  Up: Top
 * active region <1>:                     HTML export.         (line  10)
 * active region <2>:                     ASCII export.        (line   6)
 * active region <3>:                     Built-in table editor.
-                                                              (line 167)
+                                                              (line 165)
 * active region:                         Structure editing.   (line  46)
 * agenda:                                Weekly/Daily Agenda. (line   6)
 * agenda commands, custom:               Agenda dispatcher.   (line   6)
@@ -3398,7 +3391,7 @@ File: org,  Node: Index,  Next: Key Index,  Prev: Miscellaneous,  Up: Top
 * calc.el:                               Interaction.         (line  17)
 * calculations, in tables <1>:           Table calculations.  (line   6)
 * calculations, in tables:               Built-in table editor.
-                                                              (line 137)
+                                                              (line 135)
 * calendar integration:                  Calendar/Diary integration.
                                                               (line   6)
 * calendar, for selecting date:          Creating timestamps. (line  68)
@@ -3436,6 +3429,7 @@ File: org,  Node: Index,  Next: Key Index,  Prev: Miscellaneous,  Up: Top
 * cutting, of subtrees:                  Structure editing.   (line   6)
 * cycling, of TODO states:               TODO basics.         (line  13)
 * cycling, visibility:                   Visibility cycling.  (line   6)
+* dangerous commands:                    FAQ.                 (line  37)
 * date stamps:                           Time stamps.         (line   6)
 * date, reading in minibuffer:           Creating timestamps. (line  68)
 * DEADLINE keyword:                      Time stamps.         (line  27)
@@ -3454,7 +3448,7 @@ File: org,  Node: Index,  Next: Key Index,  Prev: Miscellaneous,  Up: Top
 * emphasized text:                       Export options.      (line  22)
 * evaluate time range:                   Creating timestamps. (line  63)
 * exporting:                             Exporting.           (line   6)
-* exporting a subtree:                   FAQ.                 (line  58)
+* exporting a subtree:                   FAQ.                 (line  78)
 * exporting, not:                        Comment lines.       (line   6)
 * extended TODO keywords:                TODO extensions.     (line   6)
 * external links:                        External links.      (line   6)
@@ -3479,7 +3473,7 @@ File: org,  Node: Index,  Next: Key Index,  Prev: Miscellaneous,  Up: Top
                                                               (line   6)
 * formula, for table column:             Column formulas.     (line   6)
 * formula, in tables:                    Built-in table editor.
-                                                              (line 137)
+                                                              (line 135)
 * global keybindings:                    Installation and activation.
                                                               (line   6)
 * global TODO list:                      Global TODO list.    (line   6)
@@ -3499,8 +3493,8 @@ File: org,  Node: Index,  Next: Key Index,  Prev: Miscellaneous,  Up: Top
 * HTML tags:                             HTML formatting.     (line  33)
 * hyperlinks:                            Hyperlinks.          (line   6)
 * iCalendar export:                      iCalendar export.    (line   6)
-* indentation, of tables:                FAQ.                 (line  89)
-* indirect buffers:                      FAQ.                 (line  34)
+* indentation, of tables:                FAQ.                 (line 102)
+* indirect buffers:                      FAQ.                 (line  54)
 * inheritance, of tags:                  Tag inheritance.     (line   6)
 * inserting links:                       Managing links.      (line  23)
 * installation:                          Installation and activation.
@@ -3523,7 +3517,7 @@ File: org,  Node: Index,  Next: Key Index,  Prev: Miscellaneous,  Up: Top
 * lists, plain:                          Plain Lists.         (line   6)
 * logging, of progress:                  Progress logging.    (line   6)
 * maintainer:                            Feedback.            (line   6)
-* make-indirect-buffer:                  FAQ.                 (line  34)
+* make-indirect-buffer:                  FAQ.                 (line  54)
 * mark ring:                             Managing links.      (line  72)
 * marking characters, tables:            Advanced features.   (line  34)
 * matching, of tags:                     Matching headline tags.
@@ -3569,7 +3563,7 @@ File: org,  Node: Index,  Next: Key Index,  Prev: Miscellaneous,  Up: Top
 * region, active <1>:                    HTML export.         (line  10)
 * region, active <2>:                    ASCII export.        (line   6)
 * region, active <3>:                    Built-in table editor.
-                                                              (line 167)
+                                                              (line 165)
 * region, active:                        Structure editing.   (line  46)
 * remember.el <1>:                       Interaction.         (line  39)
 * remember.el:                           Remember.            (line   6)
@@ -3580,6 +3574,7 @@ File: org,  Node: Index,  Next: Key Index,  Prev: Miscellaneous,  Up: Top
 * section-numbers:                       Export options.      (line  22)
 * setting tags:                          Setting tags.        (line   6)
 * SHELL links:                           External links.      (line   6)
+* shell links, confirmation:             FAQ.                 (line  37)
 * show all, command:                     Visibility cycling.  (line  27)
 * show all, global visibility state:     Visibility cycling.  (line  19)
 * show hidden text:                      Visibility cycling.  (line   6)
@@ -3604,7 +3599,6 @@ File: org,  Node: Index,  Next: Key Index,  Prev: Miscellaneous,  Up: Top
                                                               (line   6)
 * table editor, table.el:                table.el.            (line   6)
 * table of contents:                     Export options.      (line  22)
-* table, empty template:                 FAQ.                 (line  68)
 * table.el <1>:                          Interaction.         (line  13)
 * table.el:                              table.el.            (line   6)
 * tables <1>:                            Export options.      (line  22)
@@ -3636,7 +3630,7 @@ File: org,  Node: Index,  Next: Key Index,  Prev: Miscellaneous,  Up: Top
 * transient-mark-mode <1>:               HTML export.         (line  10)
 * transient-mark-mode <2>:               ASCII export.        (line   6)
 * transient-mark-mode <3>:               Built-in table editor.
-                                                              (line 167)
+                                                              (line 165)
 * transient-mark-mode:                   Structure editing.   (line  46)
 * trees, sparse:                         Sparse trees.        (line   6)
 * trees, visibility:                     Visibility cycling.  (line   6)
@@ -3672,12 +3666,12 @@ File: org,  Node: Key Index,  Prev: Index,  Up: Top
 * <RET> <1>:                             Agenda commands.     (line  41)
 * <RET> <2>:                             Creating timestamps. (line 100)
 * <RET>:                                 Built-in table editor.
-                                                              (line  66)
+                                                              (line  64)
 * <right>:                               Agenda commands.     (line  81)
 * <SPC>:                                 Agenda commands.     (line  28)
 * <TAB> <1>:                             Agenda commands.     (line  35)
 * <TAB> <2>:                             Built-in table editor.
-                                                              (line  59)
+                                                              (line  57)
 * <TAB> <3>:                             Plain Lists.         (line  37)
 * <TAB>:                                 Visibility cycling.  (line  10)
 * > <1>:                                 Agenda commands.     (line 140)
@@ -3685,7 +3679,7 @@ File: org,  Node: Key Index,  Prev: Index,  Up: Top
 * C:                                     Agenda commands.     (line 170)
 * c:                                     Agenda commands.     (line 154)
 * C-#:                                   Built-in table editor.
-                                                              (line 157)
+                                                              (line 155)
 * C-,:                                   Agenda files.        (line  18)
 * C-c !:                                 Creating timestamps. (line  21)
 * C-c $:                                 Archiving.           (line   9)
@@ -3694,35 +3688,35 @@ File: org,  Node: Key Index,  Prev: Index,  Up: Top
 * C-c ' <1>:                             Editing/debugging formulas.
                                                               (line  20)
 * C-c ':                                 Built-in table editor.
-                                                              (line 146)
+                                                              (line 144)
 * C-c *:                                 Built-in table editor.
-                                                              (line 150)
+                                                              (line 148)
 * C-c +:                                 Built-in table editor.
-                                                              (line 167)
+                                                              (line 165)
 * C-c ,:                                 Priorities.          (line  18)
 * C-c -:                                 Built-in table editor.
-                                                              (line  94)
+                                                              (line  92)
 * C-c .:                                 Creating timestamps. (line  10)
 * C-c /:                                 Sparse trees.        (line  15)
 * C-c ::                                 HTML export.         (line  17)
 * C-c ;:                                 Comment lines.       (line  12)
 * C-c <:                                 Creating timestamps. (line  25)
 * C-c <TAB>:                             Built-in table editor.
-                                                              (line 189)
+                                                              (line 187)
 * C-c =:                                 Built-in table editor.
-                                                              (line 137)
+                                                              (line 135)
 * C-c >:                                 Creating timestamps. (line  29)
 * C-c ? <1>:                             Editing/debugging formulas.
                                                               (line  20)
 * C-c ?:                                 Built-in table editor.
-                                                              (line 163)
+                                                              (line 161)
 * C-c [:                                 Agenda files.        (line  12)
 * C-c \:                                 Tag searches.        (line   9)
 * C-c ]:                                 Agenda files.        (line  15)
 * C-c ^:                                 Built-in table editor.
-                                                              (line  98)
+                                                              (line  96)
 * C-c `:                                 Built-in table editor.
-                                                              (line 183)
+                                                              (line 181)
 * C-c a a:                               Weekly/Daily Agenda. (line   9)
 * C-c a C:                               Agenda dispatcher.   (line  30)
 * C-c a M:                               Matching headline tags.
@@ -3741,7 +3735,7 @@ File: org,  Node: Key Index,  Prev: Index,  Up: Top
 * C-c C-c <3>:                           Editing/debugging formulas.
                                                               (line  16)
 * C-c C-c <4>:                           Built-in table editor.
-                                                              (line  44)
+                                                              (line  54)
 * C-c C-c:                               Plain Lists.         (line  61)
 * C-c C-d:                               Creating timestamps. (line  37)
 * C-c C-f:                               Motion.              (line  12)
@@ -3754,7 +3748,7 @@ File: org,  Node: Key Index,  Prev: Index,  Up: Top
 * C-c C-q <1>:                           Editing/debugging formulas.
                                                               (line  20)
 * C-c C-q:                               Built-in table editor.
-                                                              (line 121)
+                                                              (line 119)
 * C-c C-r:                               Timeline.            (line  13)
 * C-c C-s:                               Creating timestamps. (line  47)
 * C-c C-t:                               TODO basics.         (line  13)
@@ -3768,26 +3762,26 @@ File: org,  Node: Key Index,  Prev: Index,  Up: Top
 * C-c C-x C-i:                           iCalendar export.    (line  15)
 * C-c C-x C-k:                           Structure editing.   (line  31)
 * C-c C-x C-w <1>:                       Built-in table editor.
-                                                              (line 110)
+                                                              (line 108)
 * C-c C-x C-w:                           Structure editing.   (line  31)
 * C-c C-x C-y <1>:                       Built-in table editor.
-                                                              (line 114)
+                                                              (line 112)
 * C-c C-x C-y:                           Structure editing.   (line  38)
 * C-c C-x h:                             HTML export.         (line  10)
 * C-c C-x i:                             iCalendar export.    (line  13)
 * C-c C-x M-w <1>:                       Built-in table editor.
-                                                              (line 107)
+                                                              (line 105)
 * C-c C-x M-w:                           Structure editing.   (line  35)
 * C-c C-x t:                             HTML export.         (line  14)
 * C-c C-x v:                             Sparse trees.        (line  39)
 * C-c C-y:                               Creating timestamps. (line  63)
 * C-c l:                                 Managing links.      (line   9)
 * C-c |:                                 Built-in table editor.
-                                                              (line 193)
+                                                              (line  40)
 * C-c ~:                                 table.el.            (line  18)
 * C-u C-c .:                             Creating timestamps. (line  16)
 * C-u C-c =:                             Built-in table editor.
-                                                              (line 141)
+                                                              (line 139)
 * C-u C-c C-l:                           Managing links.      (line  36)
 * D:                                     Agenda commands.     (line  66)
 * d:                                     Agenda commands.     (line  63)
@@ -3799,37 +3793,37 @@ File: org,  Node: Key Index,  Prev: Index,  Up: Top
 * L:                                     Agenda commands.     (line  32)
 * M:                                     Agenda commands.     (line 161)
 * M-<down>:                              Built-in table editor.
-                                                              (line  84)
+                                                              (line  82)
 * M-<left> <1>:                          Built-in table editor.
-                                                              (line  74)
+                                                              (line  72)
 * M-<left>:                              Structure editing.   (line  13)
 * M-<RET> <1>:                           Plain Lists.         (line  42)
 * M-<RET>:                               Structure editing.   (line   6)
 * M-<right> <1>:                         Built-in table editor.
-                                                              (line  74)
+                                                              (line  72)
 * M-<right>:                             Structure editing.   (line  16)
 * M-<TAB> <1>:                           Completion.          (line  10)
 * M-<TAB> <2>:                           Setting tags.        (line   6)
 * M-<TAB>:                               Per file keywords.   (line  17)
 * M-<up>:                                Built-in table editor.
-                                                              (line  84)
+                                                              (line  82)
 * M-S-<down> <1>:                        Built-in table editor.
-                                                              (line  91)
+                                                              (line  89)
 * M-S-<down> <2>:                        Plain Lists.         (line  46)
 * M-S-<down>:                            Structure editing.   (line  28)
 * M-S-<left> <1>:                        Creating timestamps. (line  97)
 * M-S-<left> <2>:                        Built-in table editor.
-                                                              (line  78)
+                                                              (line  76)
 * M-S-<left> <3>:                        Plain Lists.         (line  52)
 * M-S-<left>:                            Structure editing.   (line  19)
 * M-S-<RET>:                             Structure editing.   (line  10)
 * M-S-<right> <1>:                       Creating timestamps. (line  94)
 * M-S-<right> <2>:                       Built-in table editor.
-                                                              (line  81)
+                                                              (line  79)
 * M-S-<right> <3>:                       Plain Lists.         (line  52)
 * M-S-<right>:                           Structure editing.   (line  22)
 * M-S-<up> <1>:                          Built-in table editor.
-                                                              (line  88)
+                                                              (line  86)
 * M-S-<up> <2>:                          Plain Lists.         (line  46)
 * M-S-<up>:                              Structure editing.   (line  25)
 * mouse-1 <1>:                           Agenda commands.     (line  35)
@@ -3853,11 +3847,11 @@ File: org,  Node: Key Index,  Prev: Index,  Up: Top
 * S-<left> <1>:                          Agenda commands.     (line 136)
 * S-<left>:                              Creating timestamps. (line  50)
 * S-<RET>:                               Built-in table editor.
-                                                              (line 172)
+                                                              (line 170)
 * S-<right> <1>:                         Agenda commands.     (line 128)
 * S-<right>:                             Creating timestamps. (line  50)
 * S-<TAB> <1>:                           Built-in table editor.
-                                                              (line  63)
+                                                              (line  61)
 * S-<TAB>:                               Visibility cycling.  (line  19)
 * S-<up> <1>:                            Agenda commands.     (line 118)
 * S-<up> <2>:                            Creating timestamps. (line  55)
@@ -3870,97 +3864,96 @@ File: org,  Node: Key Index,  Prev: Index,  Up: Top
 
 
 Tag Table:
-Node: Top960
-Node: Introduction7181
-Node: Summary7495
-Node: Installation and activation9607
-Node: Feedback11612
-Node: Document Structure12398
-Node: Outlines13164
-Node: Headlines13824
-Node: Visibility cycling14447
-Node: Motion15638
-Node: Structure editing16422
-Node: Archiving18165
-Node: Sparse trees19025
-Ref: Sparse trees-Footnote-121054
-Ref: Sparse trees-Footnote-221146
-Node: Plain Lists21260
-Ref: Plain Lists-Footnote-124016
-Node: Tables24373
-Node: Built-in table editor24921
-Node: Narrow columns32811
-Ref: Narrow columns-Footnote-134744
-Node: Table calculations34790
-Node: Formula syntax35966
-Ref: Formula syntax-Footnote-138900
-Node: Column formulas39199
-Node: Advanced features40961
-Node: Named-field formulas44216
-Node: Editing/debugging formulas44856
-Node: Appetizer46614
-Node: orgtbl-mode47716
-Node: table.el48207
-Node: Hyperlinks49184
-Node: Link format49818
-Node: Internal links51000
-Node: Radio targets52890
-Node: CamelCase links53605
-Node: External links54204
-Ref: External links-Footnote-156129
-Node: Managing links56268
-Node: Search Options60246
-Ref: Search Options-Footnote-161566
-Node: Remember61647
-Ref: Remember-Footnote-165528
-Node: TODO items65652
-Node: TODO basics66575
-Node: Progress logging68090
-Node: TODO extensions68876
-Node: Workflow states69676
-Node: TODO types70544
-Ref: TODO types-Footnote-172202
-Node: Per file keywords72284
-Ref: Per file keywords-Footnote-173737
-Node: Priorities73965
-Node: Timestamps75174
-Node: Time stamps75495
-Node: Creating timestamps77510
-Node: Tags80639
-Node: Tag inheritance81374
-Node: Setting tags82311
-Node: Tag searches83273
-Node: Agenda Views84482
-Node: Agenda files86021
-Ref: Agenda files-Footnote-186981
-Ref: Agenda files-Footnote-287130
-Node: Agenda dispatcher87322
-Node: Weekly/Daily Agenda89452
-Node: Categories90587
-Node: Time-of-day specifications91235
-Node: Calendar/Diary integration93211
-Node: Sorting of agenda items94588
-Node: Global TODO list95420
-Node: Matching headline tags96835
-Node: Timeline97778
-Node: Agenda commands98651
-Node: Exporting103906
-Node: ASCII export104478
-Node: HTML export105313
-Node: HTML formatting106429
-Node: Export options108061
-Node: Comment lines110252
-Node: iCalendar export110722
-Node: Miscellaneous112517
-Node: Completion113144
-Node: Customization114140
-Node: Clean view114588
-Node: TTY keys117228
-Node: FAQ118829
-Node: Interaction124335
-Node: Bugs127176
-Node: Acknowledgments129485
-Node: Index132415
-Node: Key Index152984
+Node: Top959
+Node: Introduction7179
+Node: Summary7493
+Node: Installation and activation9605
+Node: Feedback11274
+Node: Document Structure12060
+Node: Outlines12826
+Node: Headlines13486
+Node: Visibility cycling14109
+Node: Motion15300
+Node: Structure editing16084
+Node: Archiving17827
+Node: Sparse trees18687
+Ref: Sparse trees-Footnote-120716
+Ref: Sparse trees-Footnote-220808
+Node: Plain Lists20922
+Ref: Plain Lists-Footnote-123678
+Node: Tables24035
+Node: Built-in table editor24583
+Node: Narrow columns32197
+Ref: Narrow columns-Footnote-134130
+Node: Table calculations34176
+Node: Formula syntax35352
+Ref: Formula syntax-Footnote-138286
+Node: Column formulas38585
+Node: Advanced features40347
+Node: Named-field formulas43602
+Node: Editing/debugging formulas44242
+Node: Appetizer46000
+Node: orgtbl-mode47102
+Node: table.el47593
+Node: Hyperlinks48570
+Node: Link format49204
+Node: Internal links50500
+Node: Radio targets52390
+Node: CamelCase links53105
+Node: External links53603
+Node: Managing links55528
+Node: Search Options59512
+Ref: Search Options-Footnote-160832
+Node: Remember60913
+Ref: Remember-Footnote-164779
+Node: TODO items64903
+Node: TODO basics65826
+Node: Progress logging67341
+Node: TODO extensions68127
+Node: Workflow states68927
+Node: TODO types69795
+Ref: TODO types-Footnote-171453
+Node: Per file keywords71535
+Ref: Per file keywords-Footnote-172988
+Node: Priorities73216
+Node: Timestamps74425
+Node: Time stamps74746
+Node: Creating timestamps76761
+Node: Tags79890
+Node: Tag inheritance80625
+Node: Setting tags81562
+Node: Tag searches82524
+Node: Agenda Views83733
+Node: Agenda files85272
+Ref: Agenda files-Footnote-186232
+Ref: Agenda files-Footnote-286381
+Node: Agenda dispatcher86573
+Node: Weekly/Daily Agenda88703
+Node: Categories89838
+Node: Time-of-day specifications90486
+Node: Calendar/Diary integration92462
+Node: Sorting of agenda items93839
+Node: Global TODO list94671
+Node: Matching headline tags96086
+Node: Timeline97029
+Node: Agenda commands97902
+Node: Exporting103158
+Node: ASCII export103730
+Node: HTML export104565
+Node: HTML formatting105681
+Node: Export options107313
+Node: Comment lines109504
+Node: iCalendar export109974
+Node: Miscellaneous111769
+Node: Completion112396
+Node: Customization113392
+Node: Clean view113840
+Node: TTY keys116480
+Node: FAQ118081
+Node: Interaction124316
+Node: Bugs127157
+Node: Acknowledgments129466
+Node: Index132396
+Node: Key Index153038
 
 End Tag Table

File diff suppressed because it is too large
+ 252 - 297
org.el


BIN
org.pdf


+ 112 - 101
org.texi

@@ -4,8 +4,8 @@
 @c @setfilename ../info/org
 @settitle Org Mode Manual
 
-@set VERSION 4.19b
-@set DATE March 2006
+@set VERSION 4.20
+@set DATE April 2006
 
 @dircategory Emacs
 @direntry
@@ -311,12 +311,6 @@ MY PROJECTS    -*- mode: org; -*-
 the file's name is.  See also the variable
 @code{org-insert-mode-line-in-empty-file}.
 
-If you are upgrading to version 4.20 or later from a version 4.14 or
-earlier, some links may stop working.  These are links containing space
-characters.  To make such links work again, and also to transform all
-links from the old @samp{<link>} format to the new @samp{[[link]]}
-format, execute once in each file: @kbd{M-x org-upgrade-old-links}.
-
 @node Feedback,  , Installation and activation, Introduction
 @section Feedback
 @cindex feedback
@@ -786,18 +780,16 @@ unpredictable for you, configure the variables
 
 @table @kbd
 @tsubheading{Creation and conversion}
-@item M-x org-table-create
-Creates an empty Org-mode table.  However, it is much easier to just
-start typing, like @kbd{|Name|Phone|Age @key{RET} |- @key{TAB}}
-
-@kindex C-c C-c
-@item C-c C-c
-Convert region to table.  Works when the cursor is not in an existing
-table, and when there is a region defined.  If every line contains at
-least one TAB character, the function assumes that the material is tab
-separated.  If not, lines are split at whitespace into fields.  You
-can use a prefix argument to indicate the minimum number of consequtive
-spaces required to indentify a field separator (default: just one).
+@kindex C-c |
+@item C-c |
+Convert the active region to table. If every line contains at least one
+TAB character, the function assumes that the material is tab separated.
+If not, lines are split at whitespace into fields.  You can use a prefix
+argument to indicate the minimum number of consequtive spaces required
+to indentify a field separator (default: just one).@* 
+If there is no active region, this command creates an empty Org-mode
+table.  However, it's easier to just start typing, like
+@kbd{|Name|Phone|Age @key{RET} |- @key{TAB}}.
 
 @tsubheading{Re-aligning and field motion}
 @kindex C-c C-c
@@ -958,12 +950,6 @@ edited in place.
 This is an alias for @kbd{C-u C-c `} to make the current field fully
 visible.
 
-@kindex C-c |
-@item C-c |
-Toggle the visibility of vertical lines in tables.  The lines are
-still there, only made invisible with a text property.  Any @samp{|}
-added by hand will become invisible on the next align.
-
 @item M-x org-table-import
 Import a file as a table.  The table should be TAB- or whitespace
 separated.  Useful, for example, to import an Excel table or data from a
@@ -1381,28 +1367,30 @@ links to other files, Usenet articles, emails and much more.
 @cindex link format
 @cindex format, of links
 
-Org-mode will recognize plain URL-like links in the buffer and activate
-them as clickable links.  However, the general linkformat looks like
-this:
+Org-mode will recognize plain URL-like links and activate them as
+clickable links.  However, the general linkformat looks like this:
 
 @example
 [[link][description]]       @r{or alternatively}           [[link]]  
 @end example
 
-The description part is optional.  Once a link in the buffer is
-complete, Org-mode will change the display so that
-@u{@samp{description}} is displayed instead of
-@samp{[[link][description]]} and @samp{link} is displayed instead of
+Once a link in the buffer is complete (all brackets present), Org-mode
+will change the display so that @samp{description} is displayed instead
+of @samp{[[link][description]]} and @samp{link} is displayed instead of
 @samp{[[link]]}.  Links will be highlighted in the face @code{org-link},
 which by default is an underlined face.  You can directly edit the
-visible part of a link.  To edit the invisible part, use @kbd{C-c C-l}
-with the cursor on the link.  If you place the cursor at the beginning
-of end of the displayed text and press @key{BACKSPACE}, you will remove
-the (invisible) bracket at that location.  This makes the link incomplete
+visible part of a link.  Note that this can be either the @samp{link}
+part (if there is not description) or the @samp{description} part.  To
+edit also the invisible @samp{link} part, use @kbd{C-c C-l} with the
+cursor on the link.
+
+If you place the cursor at the beginning or just behind the end of the
+displayed text and press @key{BACKSPACE}, you will remove the
+(invisible) bracket at that location.  This makes the link incomplete
 and the internals are again displayed as plain text.  Inserting the
-missing bracket does hide the link internal again.  Finally, you may also
-use the menu entry @code{Org->Hperlinks->Literal links} to unhide all
-links.
+missing bracket does hide the link internals again.  To show the
+internal structure of all links, use the menu entry
+@code{Org->Hyperlinks->Literal links}.
 
 @node Internal links, External links, Link format, Hyperlinks
 @section Internal links
@@ -1473,15 +1461,10 @@ loaded into Emacs.  To update the target list during editing, press
 
 Org-mode also supports CamelCase words as links.  This feature is not
 turned on by default because of the inconsistencies this system suffers
-from.  It is mainly kept for backward compatibility, but the use is
-deprecated.  To activate CamelCase words as links, and to make headline
-completion offer CamelCase version of headlines, the following
-customization is needed:
-
-@lisp
-(setq org-activate-camels t
-      org-file-link-context-use-camel-case t)
-@end lisp
+from.  To activate CamelCase words as links, you need to customize
+the option @code{org-activate-links}.  A CamelCase word then leads to a
+text search such that @samp{CamelCaseLink} is equivalent to
+@samp{[[camel case link]]}.
 
 @node External links, Managing links, Internal links, Hyperlinks
 @section External links
@@ -1521,7 +1504,7 @@ rmail:folder#id                          @r{RMAIL message link}
 gnus:group                               @r{GNUS group link}
 gnus:group#id                            @r{GNUS article link}
 bbdb:Richard Stallman                    @r{BBDB link}
-shell:ls *.org@footnote{Note that @samp{<} and @samp{>} cannot be part of a link, and therefore of a shell command.  If you need redirection, use @@@{ and @@@} instead.}                          @r{A shell command}
+shell:ls *.org                           @r{A shell command}
 @end example
 
 A link should be enclosed in double brackets and may contain a
@@ -1535,8 +1518,9 @@ format}), for example:
 @cindex angular brackets, around links
 @cindex plain text external links
 Org-mode also finds external links in the normal text and activates them
-as links.  Plain text links cannot contain spaces.  To remove
-ambiguities about the end of the link, enclose them in angular brackets.
+as links.  If spaces must be part of the link (for example in
+@samp{bbdb:Richard Stallman}) or to remove ambiguities about the end of
+the link, enclose them in angular brackets.
 
 @node Managing links, Search Options, External links, Hyperlinks
 @section Managing links
@@ -1550,16 +1534,15 @@ insert it into an org-mode file, and to follow the link.
 @item C-c l
 Store a link to the current location.  This is a @emph{global} command
 which can be used in any buffer to create a link.  The link will be
-stored for later insertion into an Org-mode buffer (see below).  For
-VM, RMAIL, WANDERLUST, GNUS and BBDB buffers, the link will point to
-the current article/entry.  For W3 and W3M buffers, the link goes to
-the current URL.  For Org-mode files, the current headline is
-targeted.  For any other files, the link will point to the file, with
-a search string (@pxref{Search Options}) pointing to the
-contents of the current line.  If there is an active region, the
-selected words will form the basis of the search string.  The key
-binding @kbd{C-c l} is only a suggestion - see @ref{Installation and
-activation}.
+stored for later insertion into an Org-mode buffer (see below).  For VM,
+RMAIL, WANDERLUST, MH-E, GNUS and BBDB buffers, the link will point to
+the current article/entry.  For W3 and W3M buffers, the link goes to the
+current URL.  For Org-mode files, the current headline is targeted.  For
+any other files, the link will point to the file, with a search string
+(@pxref{Search Options}) pointing to the contents of the current line.
+If there is an active region, the selected words will form the basis of
+the search string.  The key binding @kbd{C-c l} is only a suggestion -
+see @ref{Installation and activation}.
 
 @kindex C-c C-l
 @cindex link completion
@@ -1697,11 +1680,11 @@ package.} will tell @emph{Remember} to use org files as target, and to
 create annotations compatible with Org-mode links.
 
 @example
+(setq org-directory "~/path/to/my/orgfiles/")
+(setq org-default-notes-file "~/.notes")
 (autoload 'org-remember-annotation "org")
 (autoload 'org-remember-apply-template "org")
 (autoload 'org-remember-handler "org")
-(setq org-directory "~/path/to/my/orgfiles/")
-(setq org-default-notes-file "~/.notes")
 (setq remember-annotation-functions '(org-remember-annotation))
 (setq remember-handler-functions '(org-remember-handler))
 (add-hook 'remember-mode-hook 'org-remember-apply-template)
@@ -1720,9 +1703,9 @@ journal entries, you could use:
 @end example
 
 @noindent In these entries, the character specifies how to select the
-template, the first string specifies the template, and the second string
-specifies a default file (overruling @code{org-default-notes-file}) as a
-target for this note.
+template, the first string specifies the template, and the (optional)
+second string specifies a default file (overruling
+@code{org-default-notes-file}) as a target for this note.
 
 When you call @kbd{M-x remember} to remember something, org will prompt
 for a key to select the template and then prepare the buffer like
@@ -1742,12 +1725,12 @@ for a key to select the template and then prepare the buffer like
 @noindent See the variable @code{org-remember-templates} for more details.
 
 When you are finished composing a note with remember, you have to press
-@kbd{C-c C-c} to exit remember-mode and to file the note away.  The
-handler first prompts for a target file - if you press @key{RET}, the
-value of @code{org-default-notes-file} is used.  Then the command offers
-the headings tree of the selected file.  You can either immediately
-press @key{RET} to get the note appended to the file.  Or you can use
-vertical cursor motion (@key{up} and @key{down}) and visibility cycling
+@kbd{C-c C-c} to file the note away.  The handler first prompts for a
+target file - if you press @key{RET}, the value of
+@code{org-default-notes-file} is used.  Then the command offers the
+headings tree of the selected file.  You can either immediately press
+@key{RET} to get the note appended to the file.  Or you can use vertical
+cursor motion (@key{up} and @key{down}) and visibility cycling
 (@key{TAB}) to find a better place.  Pressing @key{RET} or @key{left} or
 @key{right} leads to the following result.
 
@@ -2796,7 +2779,7 @@ original org file.
 
 @kindex T
 @item T
-Show all tags assiciated with the current item.  Because of
+Show all tags associated with the current item.  Because of
 inheritance, this may be more than the tags listed in the line itself.
 
 @kindex :
@@ -2866,7 +2849,7 @@ date at the cursor.
 
 @kindex M
 @item M
-Show the phases of the moon for the three month around current date.
+Show the phases of the moon for the three months around current date.
 
 @kindex S
 @item S
@@ -3401,45 +3384,75 @@ rather use @kbd{C-c .}  to re-insert the timestamp.
 @enumerate
 @item @b{Org-mode seems to be a useful default mode for the various
 @file{README} files I have scattered through my directories.  How do I
-turn it on for all @file{README} files?}
+turn it on for all @file{README} files?}@*
+@c
 @example
 (add-to-list 'auto-mode-alist '("README$" . org-mode))
 @end example
 
 @item @b{Some of my links stopped working after I upgraded to a version
-4.20 or later.  Why is this, and how can I fix it?}@* The newer versions of
-Org-mode have a better link system and no longer allow unescaped space
-characters as part of a link.  To fix these links, and also to move all
-@samp{<link>} style links to the new @samp{[[link]]} system, execute
-once in each Org-mode file: @kbd{M-x org-upgrade-old-links}.
-
-@item @b{I really like the old style links with angular brackets
-better.  Please give them back to me, don't tell me it is not
-possible!}@* Would I let you down like that?  If you must (even if I
-don't understand why), you can do this
+4.20 or later.  Why is this, and how can I fix it?}@*
+@c
+These must be links in plain text, containing white space, such as
+@samp{bbdb:Richard Stallman}.  You need to protect these links by
+putting double brackets around them, like @samp{[[bbdb:Richard
+Stallman]]}.
+
+@item @b{I see that Org-mode now creates links using the double bracket
+convention that hides the link part and the brackets, only showing the
+description part.  How can I convert my old links to this new format?}@*
+@c
+Execute once in each Org-mode file: @kbd{M-x org-upgrade-old-links}.
+The replaces angular brackets with the link format.
+
+@item @b{I don't care if you find the new bracket links great, I am
+attached to the old style using angular brackets and no hiding of the
+link text.  Please give them back to me, don't tell me it is not
+possible!}@*
+@c
+Would I let you down like that?  If you must (even if I don't understand
+why), you can do this
 @lisp
-(setq org-allow-space-in-plain-links t
-      org-link-style 'plain
+(setq org-link-style 'plain
       org-link-format "<%s>")
 @end lisp
 
+@item @b{When I am executing shell links I always get a 
+confirmation prompt and need to type @kbd{yes @key{RET}}, thats 4 key
+presses!  Can I get rid of this?}@*
+@c
+@cindex shell links, confirmation
+@cindex dangerous commands
+The confirmation is there to protect you from unwantingly execute
+potentially dangerous commands.  For example, imagine a link
+@samp{[[shell:rm -rf ~/*][Google Search]]}.  In an Org-mode buffer, this
+command would look like @samp{Google Search}, but really it would remove
+your home directory.  If you wish, you can make it easier to respond to
+the query by setting @code{org-confirm-shell-links} to @code{y-or-n-p}.
+Then a single @kbd{y} keypress will be enough to confirm shell links.
+It is also possible to turn off this check entirely, but I do not
+recommend to do this.  Be warned.
+
 @item @b{All these stars are driving me mad, I just find the Emacs
 outlines unreadable. Can't you just put white space and a single star as a
 starter for headlines?}@*
+@c
 See @ref{Clean view}.
 
 @item @b{I would like to have two windows on the same Org-mode
 file, but with different outline visibility.  Is that possible?}@*
+@c
 @cindex @code{make-indirect-buffer}
 @cindex indirect buffers
-In GNU Emacs, you may use @emph{indirect buffers} which do exactly
-this.  See the documentation on the command
-@code{make-indirect-buffer}.  In XEmacs, this is currently not
-possible because of the different outline implementation.
+In GNU Emacs, you may use @emph{indirect buffers} which do exactly this.
+See the documentation on the command @code{make-indirect-buffer}.  In
+XEmacs, this is currently not possible because of the different outline
+implementation.
 
 @item @b{When I export my TODO list, every TODO item becomes a
 separate section.  How do I enforce these items to be exported as an
 itemized list?}@*
+@c
 If you plan to use ASCII or HTML export, make sure things you want to
 be exported as item lists are level 4 at least, even if that does mean
 there is a level jump.  For example:
@@ -3459,7 +3472,9 @@ configure the @samp{H} switch.
 +OPTIONS:   H:2; ...
 @end example
 
-@item @b{I would like to export only a subtree of my file to HTML.  How?}@*
+@item @b{I would like to export only a subtree of my file to HTML.
+How?}@*
+@c
 @cindex exporting a subtree
 If you want to export a subtree, mark the subtree as region and then
 export.  Marking can be done with @kbd{C-c @@ C-x C-x}, for example.
@@ -3468,16 +3483,9 @@ export.  Marking can be done with @kbd{C-c @@ C-x C-x}, for example.
 CUA-mode, is there a way to fix this conflict?}@*
 Yes, see @ref{Interaction}.
 
-@item @b{Is there an easy way to insert an empty table template with a
-default number of rows and columns?}@*
-@cindex table, empty template
-To insert an empty table template, just type @samp{|-} and use
-@key{TAB}.  The default size can be changed with the variable
-@code{org-table-default-size}.  However, just starting to type the
-first line is usually much easier.
-
 @item @b{One of my table columns has started to fill up with
 @samp{#ERROR}.  What is going on?}@*
+@c
 Org-mode tried to compute the column from other fields using a
 formula stored in the @samp{#+TBLFMT:} line just below the table, and
 the evaluation of the formula fails.  Fix the fields used in the
@@ -3487,17 +3495,20 @@ formula, or fix the formula, or remove it!
 horizontal line in the table, pressing TAB creates a new table line
 @i{before} the horizontal line.  How can I quickly move to the line
 @i{below} the horizontal line instead?}@*
+@c
 Press @key{down} (to get on the separator line) and then @key{TAB}.
 Or configure the variable @code{org-table-tab-jumps-over-hlines}.
 
 @item @b{How can I change the indentation of an entire table without
 fixing every line by hand?}@*
+@c
 @cindex indentation, of tables
 The indentation of a table is set by the first line.  So just fix the
 indentation of the first line and realign with @key{TAB}.
 
 @item @b{Is it possible to include entries from org-mode files into my
 emacs diary?}@*
+@c
 Since the org-mode agenda is much more powerful and can contain the
 diary (@pxref{Calendar/Diary integration}), you should think twice
 before deciding to do this.  Integrating Org-mode information into the

BIN
orgcard.pdf


+ 7 - 10
orgcard.tex

@@ -1,5 +1,5 @@
 % Reference Card for Org Mode
-\def\orgversionnumber{4.19b}
+\def\orgversionnumber{4.20}
 \def\year{2006}
 %
 %**start of header
@@ -427,9 +427,8 @@ To set archive location for current file, add a line like$^3$:
 
 %\metax{insert a new Org-mode table}{M-x org-table-create}
 \metax{just start typing, e.g.}{|Name|Phone|Age RET |- TAB}
-\key{convert region to table}{C-c C-c}
-\key{... separator at least 3 spaces}{C-3 C-c C-c}
-%\key{... prompt for separator regexp}{C-u C-c C-c}
+\key{convert region to table}{C-c |}
+\key{... separator at least 3 spaces}{C-3 C-c |}
 
 {\bf Commands available inside tables}
 
@@ -465,9 +464,7 @@ Outside of tables, the same keys may have other functionality.
 \key{paste rectangular region}{C-c C-x C-y}
 \key{fill paragraph across selected cells}{C-c C-q}
 
-{\bf Calculations}
-
-These need the Emacs calc package installed.
+{\bf Calculations} (in combination with Emacs \kbd{calc} package)
 
 \key{set and eval column formula}{C-c =}
 \key{set and eval named-field formula}{C-u C-c =}
@@ -475,8 +472,8 @@ These need the Emacs calc package installed.
 \key{re-apply all stored equations to current line}{C-c *}
 \key{re-apply all stored equations to entire table}{C-u C-c *}
 
-\kbd{TAB}, \kbd{RET} and \kbd{C-c C-c} trigger automatic recalculation
-in lines starting with: {\tt | \# |}.
+%\kbd{TAB}, \kbd{RET} and \kbd{C-c C-c} trigger automatic recalculation
+%in lines starting with: {\tt | \# |}.
 
 \key{rotate calculation mark through \# * ! \^ \_ \$}{C-\#}
 
@@ -496,9 +493,9 @@ formula, \kbd{:=} a named-field formula.
 
 {\bf Miscellaneous}
 
+\key{to limit column width to \kbd{N} characters, use}{...| <N> |...}
 \key{edit the current field in a separate window}{C-c `}
 \key{make current field fully visible}{C-u TAB}
-\key{toggle visibility of vertical lines}{C-c |}
 \metax{export as tab-separated file}{M-x org-table-export}
 \metax{import tab-separated file}{M-x org-table-import}
 

Some files were not shown because too many files changed in this diff