Release 4.68

This commit is contained in:
Carsten Dominik 2008-01-31 11:34:04 +01:00
parent 608d54b655
commit de73a94faf
7 changed files with 1054 additions and 564 deletions

View File

@ -74,6 +74,12 @@ install: install-lisp
doc: org.html org.pdf orgcard.pdf
p:
make pdf && open org.pdf
c:
make card && gv orgcard.ps
install-lisp: $(LISPFILES) $(ELCFILES)
if [ ! -d $(lispdir) ]; then $(MKDIR) $(lispdir); else true; fi ;
$(CP) $(LISPFILES) $(lispdir)

605
org
View File

@ -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.67).
This manual is for Org-mode (version 4.68).
Copyright (C) 2004, 2005, 2006, 2007 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.67).
This manual is for Org-mode (version 4.68).
Copyright (C) 2004, 2005, 2006, 2007 Free Software Foundation
@ -131,7 +131,7 @@ TODO items
* TODO basics:: Marking and displaying TODO entries
* TODO extensions:: Workflow and assignments
* Priorities:: Some things are more important than others
* Breaking down tasks:: Splitting a task into managable pieces
* Breaking down tasks:: Splitting a task into manageable pieces
* Checkboxes:: Tick-off lists
Extended use of TODO keywords
@ -212,7 +212,7 @@ Exporting
HTML export
* Export commands:: How to invode HTML export
* Export commands:: How to invoke HTML export
* Quoting HTML tags:: Using direct HTML in Org-mode
* Links:: How hyperlinks get transferred to HTML
* Images:: To inline or not to inline?
@ -338,7 +338,7 @@ example as:
Org-mode's automatic, context sensitive table editor with spreadsheet
capabilities can be integrated into any major mode by activating the
minor Orgtbl-mode. Using a translation step, it can be used to maintain
tables in arbitray file types, for example in LaTeX.
tables in arbitrary file types, for example in LaTeX.
There is a website for Org-mode which provides links to the newest
version of Org-mode, as well as additional information, frequently asked
@ -1169,7 +1169,7 @@ to no more than this value.
Fields that are wider become clipped and end in the string `=>'. Note
that the full text is still in the buffer, it is only invisible. To
see the full text, hold the mouse over the field - a tooltip window
see the full text, hold the mouse over the field - a tool-tip window
will show the full content. To edit such a field, use the command `C-c
`' (that is `C-c' followed by the backquote). This will open a new
window with the full field. Edit it and finish with `C-c C-c'.
@ -1205,7 +1205,7 @@ in mail mode, use
Furthermore, with some special setup, it is possible to maintain
tables in arbitrary syntax with Orgtbl-mode. For example, it is
possible to construct LaTeX tables with the underlying ease and power of
Orgtbl-mode, including spreadsheet capabulities. For details, see
Orgtbl-mode, including spreadsheet capabilities. For details, see
*Note Tables in arbitrary syntax::.

@ -1216,7 +1216,11 @@ File: org, Node: The spreadsheet, Prev: orgtbl-mode, Up: Tables
The table editor makes use of the Emacs `calc' package to implement
spreadsheet-like capabilities. It can also evaluate Emacs Lisp forms to
derive fields from other fields.
derive fields from other fields. While fully featured, Org-mode's
implementation is not identical to other spreadsheets. For example,
Org-mode knows the concept of a _column formula_ that will be applied
to all non-header fields in a column without having to copy the formula
to each relevant field.
* Menu:
@ -1238,16 +1242,21 @@ File: org, Node: References, Next: Formula syntax for Calc, Prev: The spreads
To compute fields in the table from other fields, formulas must
reference other fields or ranges. In Org-mode, fields can be referenced
by name, by absolute coordinates, and by relative coordinates. To find
out what the coordinates of a field are, press `C-c ?' in that field.
out what the coordinates of a field are, press `C-c ?' in that field,
or press `C-c }' to toggle the display of a grid.
Field references
................
Formulas can reference the value of another field with the operator
Formulas can reference the value of another field in two ways. Like in
any other spreadsheet, you may reference fields with a letter/number
combination like `B3', meaning the 2nd field in the 3rd row.
Org-mode also uses another, more general operator that looks like this:
@row$column
Column references can be absolute like `1', `2',...`N', or relative
to the current column like `+1' or `-2'.
Column references can be absolute like `1', `2',...`N', or relative to
the current column like `+1' or `-2'.
The row specification only counts data lines and ignores horizontal
separator lines (hlines). You can use absolute row numbers `1'...`N',
@ -1264,17 +1273,19 @@ the value directly at the hline is used.
the column or the row part of the reference, the current row/column is
implied.
Org-mode's references with _positive_ numbers correspond to fixed
references in other spreadsheet programs. For example, `@3$28'
corresponds to `$AB$3'. Org-mode's references with _negative_ numbers
behave similar to non-fixed references in other spreadsheet programs,
because when the same formula is used in several fields, different
fields are referenced each time.
Org-mode's references with _unsigned_ numbers are fixed references
in the sense that if you use the same reference in the formula for two
different fields, the same field will be referenced each time.
Org-mode's references with _signed_ numbers are floating references
because the same reference operator can reference different fields
depending on the field being calculated by the formula.
Here are a few examples:
@2$3 2nd row, 3rd column
C2 same as previous
$5 column 5 in the current row
E& same as previous
@2 current column, row 2
@-1$-3 the field one row up, three columns to the left
@-I$2 field just under hline above current row, column 2
@ -1292,6 +1303,7 @@ order to be interpreted correctly). Examples:
$1..$3 First three fields in the current row.
$P..$Q Range, using column names (see under Advanced)
@2$1..@4$3 6 fields between these two fields.
A2..C4 Same as above.
@-1$-2..@-1 3 numbers from the column to the left, 2 up to current row
Range references return a vector of values that can be fed into Calc
@ -1307,9 +1319,17 @@ Named references
Constants are defined globally through the variable
`org-table-formula-constants'. If you have the `constants.el' package,
it will also be used to resolve constants, including natural constants
like `$h' for Planck's constant, and units like `$km' for kilometers.
Column names and parameters can be specified in special table lines.
These are described below, see *Note Advanced features::.
like `$h' for Planck's constant, and units like `$km' for
kilometers(1). Column names and parameters can be specified in special
table lines. These are described below, see *Note Advanced features::.
---------- Footnotes ----------
(1) `Constant.el' can supply the values of constants in two
different unit systems, `SI' and `cgs'. Which one is used depends on
the value of the variable `constants-unit-system'. You can use the
`#+STARTUP' options `constSI' and `constcgs' to set this value for the
current buffer.

File: org, Node: Formula syntax for Calc, Next: Formula syntax for Lisp, Prev: References, Up: The spreadsheet
@ -1348,7 +1368,7 @@ the final result. A few examples:
$1+$2 Sum of first and second field
$1+$2;%.2f Same, format result to two decimals
exp($2)+exp($1) Math functions can be used
$;%.1f Reformat current cell to 1 decimal
$0;%.1f Reformat current cell to 1 decimal
($3-32)*5/9 Degrees F -> C conversion
$c/$1/$cm Hz -> cm conversion, using `constants.el'
tan($1);Dp3s1 Compute in degrees, precision 3, display SCI 1
@ -1357,6 +1377,10 @@ the final result. A few examples:
vmean($2..$7);EN Same, but treat empty fields as 0
taylor($3,x=7,2) taylor series of $3, at x=7, second degree
Calc also contains a complete set of logical operations. For example
if($1<20,teen,string("")) "teen" if age $1 less than 20, else empty

File: org, Node: Formula syntax for Lisp, Next: Field formulas, Prev: Formula syntax for Calc, Up: The spreadsheet
@ -1364,16 +1388,17 @@ File: org, Node: Formula syntax for Lisp, Next: Field formulas, Prev: Formula
----------------------------------
It is also possible to write a formula in Emacs Lisp; this can be useful
for string manipulation and control structures. If a formula starts
with a single quote followed by an opening parenthesis, then it is
evaluated as a lisp form. The evaluation should return either a string
or a number. Just as with `calc' formulas, you can specify modes and a
printf format after a semicolon. A reference will be replaced with a
string (in double quotes) containing the field. If you provide the `N'
mode switch, all referenced elements will be numbers. Ranges are
inserted as space-separated fields, so you can embed them in list or
vector syntax. A few examples, note how the `N' mode is used when we
do computations in lisp.
for string manipulation and control structures, if the Calc's
functionality is not enough. If a formula starts with a single quote
followed by an opening parenthesis, then it is evaluated as a lisp form.
The evaluation should return either a string or a number. Just as with
`calc' formulas, you can specify modes and a printf format after a
semicolon. A reference will be replaced with a string (in double
quotes) containing the field. If you provide the `N' mode switch, all
referenced elements will be numbers. Ranges are inserted as
space-separated fields, so you can embed them in list or vector syntax.
A few examples, note how the `N' mode is used when we do computations
in lisp.
Swap the first two characters of the content of column 1
'(concat (substring $1 1 2) (substring $1 0 1) (substring $1 2))
@ -1397,11 +1422,11 @@ current field replaced with the result.
Formulas are stored in a special line starting with `#+TBLFM:'
directly below the table. If you typed the equation in the 4th field of
the 3rd data line in the table, the formula will look like
`@3$2=$1+$2'. When inserting/deleting/swapping column and rows with
`@3$4=$1+$2'. When inserting/deleting/swapping column and rows with
the appropriate commands, absolute references (but not relative ones)
in stored formulas are modified in order to still reference the same
field. Of cause this is not true if you edit the table structure with
normal editing commands - then you must go and fix equations yourself.
normal editing commands - then you must fix the equations yourself.
Instead of typing an equation into the field, you may also use the
following command
@ -1420,7 +1445,9 @@ File: org, Node: Column formulas, Next: Editing and debugging formulas, Prev:
Often in a table, the same formula should be used for all fields in a
particular column. Instead of having to copy the formula to all fields
in that column, org-mode allows to assign a single formula to an entire
column.
column. If the table contains horizontal separator hlines, everything
before the first such line is considered part of the table _header_ and
will not be modified by column formulas.
To assign a formula to a column, type it directly into any field in
the column, preceded by an equal sign, like `=$1+$2'. When you press
@ -1451,7 +1478,11 @@ File: org, Node: Editing and debugging formulas, Next: Updating the table, Pr
You can edit individual formulas in the minibuffer or directly in the
field. Org-mode can also prepare a special buffer with all active
formulas of a table.
formulas of a table. When offering a formula for editing, Org-mode
converts references to the standard format (like `B3' or `D&') if
possible. If you prefer to only work with the internal format (like
`@3$2' or `$4'), configure the variable
`org-table-use-standard-references'.
`C-c ='
`C-u C-c ='
@ -1469,18 +1500,34 @@ formulas of a table.
While editing a formula in a table field, highlight the field(s)
referenced by the reference at the cursor position in the formula.
`C-c }'
Toggle the display of row and column numbers for a table, using
overlays. These are updated each time the table is aligned, you
can force it with `C-c C-c'.
`C-c {'
Toggle the formula debugger on and off. See below.
`C-c ''
Edit all formulas for the current table in a special buffer, where
the formulas will be displayed one per line. While inside the
special buffer, Org-mode will automatically highlight any field or
range reference at the cursor position. You may edit, remove and
add formulas, and use the following commands:
the formulas will be displayed one per line. If the current field
has an active formula, the cursor in the formula editor will mark
it. While inside the special buffer, Org-mode will automatically
highlight any field or range reference at the cursor position.
You may edit, remove and add formulas, and use the following
commands:
`C-c C-c'
Exit the buffer and store the modified formulas. With `C-u'
prefix, also apply the new formulas to the entire table.
`C-x C-s'
Exit the formula editor and store the modified formulas.
With `C-u' prefix, also apply the new formulas to the entire
table.
`C-c C-q'
Exit the buffer without installing changes.
Exit the formula editor without installing changes.
`C-c C-r'
Toggle all references in the formula editor between standard
(like `B3') and internal (like `@3$2').
`<TAB>'
Pretty-print or indent lisp formula at point. When in a line
@ -1492,21 +1539,20 @@ formulas of a table.
`M-<TAB>'
Complete Lisp symbols, just like in Emacs-lisp-mode.
`S-<up>/<down>'
Move the reference line in the Org-mode buffer up and down.
This is important for highlighting the references of column
formulas for different rows.
`S-<up>/<down>/<left>/<right>'
Shift the reference at point. For example, if the reference
is `B3' and you press `S-<right>', it will become `C3'. This
also works for relative references, and for hline references.
`M-S-<up>/<down>'
Move the test line for column formulas in the Org-mode buffer
up and down.
`M-<up>/<down>'
Scroll the window displaying the table.
`C-c }'
Toggle the display of row and column numbers for a table, using
overlays. These are uptated each time the table is aligned, you
can force it with `C-c C-c'.
`C-c {'
Toggle the formula debugger on and off. See below.
`C-c }'
Turn the coordinate grid in the table on and off.
Making a table field blank does not remove the formula associated
with the field, because that is stored in a different line (the `TBLFM'
@ -1525,8 +1571,8 @@ When the evaluation of a formula leads to an error, the field content
becomes the string `#ERROR'. If you would like see what is going on
during variable substitution and calculation in order to find a bug,
turn on formula debugging in the `Tbl' menu and repeat the calculation,
for example by pressing `C-c = <RET>' in a field. Detailed information
will be displayed.
for example by pressing `C-u C-u C-c = <RET>' in a field. Detailed
information will be displayed.

File: org, Node: Updating the table, Next: Advanced features, Prev: Editing and debugging formulas, Up: The spreadsheet
@ -2153,7 +2199,7 @@ template has been expanded:
If you change you mind about which template to use, call `org-remember'
in the remember buffer. You may then select a new template that will
be filled with the previoous context information.
be filled with the previous context information.
---------- Footnotes ----------
@ -2220,7 +2266,7 @@ overview over all things you have to do.
* TODO basics:: Marking and displaying TODO entries
* TODO extensions:: Workflow and assignments
* Priorities:: Some things are more important than others
* Breaking down tasks:: Splitting a task into managable pieces
* Breaking down tasks:: Splitting a task into manageable pieces
* Checkboxes:: Tick-off lists

@ -2423,7 +2469,7 @@ File: org, Node: Breaking down tasks, Next: Checkboxes, Prev: Priorities, Up
5.4 Breaking tasks down into subtasks
=====================================
It is often advisable to break down large tasks into smaller, managable
It is often advisable to break down large tasks into smaller, manageable
subtasks. You can do this by creating an outline tree below a TODO
item, with detailed subtasks on the tree(1). Another possibility is
the use of checkboxes to identify (a hierarchy of) a large number of
@ -2626,8 +2672,8 @@ format.
minutes, see the option `org-time-stamp-rounding-minutes'.
`C-c !'
Like `C-c .', but insert an inactive time stamp not triggering the
agenda.
Like `C-c .', but insert an inactive time stamp that will not cause
an agenda entry.
`C-c <'
Insert a time stamp corresponding to the cursor date in the
@ -4353,7 +4399,7 @@ but with additional support for tables.
* Menu:
* Export commands:: How to invode HTML export
* Export commands:: How to invoke HTML export
* Quoting HTML tags:: Using direct HTML in Org-mode
* Links:: How hyperlinks get transferred to HTML
* Images:: To inline or not to inline?
@ -5100,6 +5146,10 @@ file is visited again in a new Emacs session.
`org-put-time-stamp-overlays' and
`org-time-stamp-overlay-formats'), use
customtime overlay custom time format
The following options influence the table spreadsheet (variable
`constants-unit-system').
constcgs `constants.el' should use the c-g-s unit system
constSI `constants.el' should use the SI unit system
`#+SEQ_TODO: #+TYP_TODO:'
These lines set the TODO keywords and their interpretation in the
@ -6093,8 +6143,10 @@ Index
* completion, of TeX symbols: Completion. (line 6)
* completion, of TODO keywords <1>: Completion. (line 6)
* completion, of TODO keywords: Workflow states. (line 12)
* constants, in calculations: References. (line 74)
* constants, in calculations: References. (line 82)
* constants.el: Cooperation. (line 14)
* constcgs, STARTUP keyword: In-buffer settings. (line 52)
* constSI, STARTUP keyword: In-buffer settings. (line 52)
* content, STARTUP keyword: In-buffer settings. (line 22)
* contents, global visibility state: Visibility cycling. (line 22)
* copying, of subtrees: Structure editing. (line 6)
@ -6118,7 +6170,7 @@ Index
* deadlines: Time stamps. (line 6)
* deadlines, repeating: Repeating items. (line 6)
* debugging, of table formulas: Editing and debugging formulas.
(line 78)
(line 97)
* demotion, of subtrees: Structure editing. (line 6)
* diary entries, creating from agenda: Agenda commands. (line 198)
* diary integration: Weekly/Daily agenda. (line 24)
@ -6148,7 +6200,7 @@ Index
* FAQ: Summary. (line 53)
* feedback: Feedback. (line 6)
* field formula: Field formulas. (line 6)
* field references: References. (line 14)
* field references: References. (line 15)
* file links: External links. (line 6)
* file links, searching: Search options. (line 6)
* file name completion: Handling links. (line 43)
@ -6164,7 +6216,7 @@ Index
(line 15)
* format, of links: Link format. (line 6)
* formula debugging: Editing and debugging formulas.
(line 78)
(line 97)
* formula editing: Editing and debugging formulas.
(line 6)
* formula syntax, Calc: Formula syntax for Calc.
@ -6259,8 +6311,8 @@ Index
(line 15)
* motion commands in agenda: Agenda commands. (line 19)
* motion, between headlines: Motion. (line 6)
* name, of column or field: References. (line 74)
* named references: References. (line 74)
* name, of column or field: References. (line 82)
* named references: References. (line 82)
* names as TODO keywords: TODO types. (line 6)
* narrow columns in tables: Narrow columns. (line 6)
* noalign, STARTUP keyword: In-buffer settings. (line 29)
@ -6306,13 +6358,13 @@ Index
* quoted HTML tags: Export options. (line 25)
* radio tables: Radio tables. (line 6)
* radio targets: Radio targets. (line 6)
* range references: References. (line 53)
* range references: References. (line 60)
* ranges, time: Time stamps. (line 6)
* recomputing table fields: Updating the table. (line 6)
* references: References. (line 6)
* references, named: References. (line 74)
* references, to fields: References. (line 14)
* references, to ranges: References. (line 53)
* references, named: References. (line 82)
* references, to fields: References. (line 15)
* references, to ranges: References. (line 60)
* region, active <1>: Export commands. (line 6)
* region, active <2>: ASCII export. (line 9)
* region, active <3>: Built-in table editor.
@ -6477,7 +6529,7 @@ Key Index
* <TAB> <2>: Agenda commands. (line 35)
* <TAB> <3>: Setting tags. (line 68)
* <TAB> <4>: Editing and debugging formulas.
(line 37)
(line 57)
* <TAB> <5>: Built-in table editor.
(line 57)
* <TAB> <6>: Plain lists. (line 37)
@ -6502,7 +6554,7 @@ Key Index
* C-c %: Handling links. (line 81)
* C-c &: Handling links. (line 85)
* C-c ': Editing and debugging formulas.
(line 24)
(line 36)
* C-c *: Updating the table. (line 13)
* C-c +: Built-in table editor.
(line 141)
@ -6517,11 +6569,11 @@ Key Index
* C-c <TAB>: Built-in table editor.
(line 163)
* C-c = <1>: Editing and debugging formulas.
(line 10)
* C-c =: Column formulas. (line 24)
(line 14)
* C-c =: Column formulas. (line 26)
* C-c >: Creating timestamps. (line 29)
* C-c ?: Editing and debugging formulas.
(line 20)
(line 24)
* C-c [: Agenda files. (line 12)
* C-c \: Tag searches. (line 9)
* C-c ]: Agenda files. (line 15)
@ -6553,7 +6605,7 @@ Key Index
* C-c C-c <4>: Setting tags. (line 10)
* C-c C-c <5>: Checkboxes. (line 37)
* C-c C-c <6>: Editing and debugging formulas.
(line 32)
(line 46)
* C-c C-c <7>: Built-in table editor.
(line 54)
* C-c C-c: Plain lists. (line 74)
@ -6581,9 +6633,11 @@ Key Index
* C-c C-o: Handling links. (line 58)
* C-c C-p: Motion. (line 9)
* C-c C-q <1>: Editing and debugging formulas.
(line 34)
(line 50)
* C-c C-q: Built-in table editor.
(line 125)
* C-c C-r <1>: Editing and debugging formulas.
(line 53)
* C-c C-r: Visibility cycling. (line 34)
* C-c C-s <1>: Agenda commands. (line 155)
* C-c C-s: Creating timestamps. (line 48)
@ -6623,18 +6677,18 @@ Key Index
* C-c l: Handling links. (line 9)
* C-c { <1>: CDLaTeX mode. (line 21)
* C-c {: Editing and debugging formulas.
(line 60)
(line 33)
* C-c |: Built-in table editor.
(line 40)
* C-c }: Editing and debugging formulas.
(line 56)
(line 28)
* C-c ~: Cooperation. (line 50)
* C-k: Agenda commands. (line 117)
* C-TAB: ARCHIVE tag. (line 38)
* C-u C-c *: Updating the table. (line 18)
* C-u C-c .: Creating timestamps. (line 16)
* C-u C-c = <1>: Editing and debugging formulas.
(line 10)
(line 14)
* C-u C-c =: Field formulas. (line 24)
* C-u C-c C-c: Updating the table. (line 19)
* C-u C-c C-l: Handling links. (line 43)
@ -6644,7 +6698,9 @@ Key Index
* C-u C-c C-x C-u: Clocking work time. (line 70)
* C-u C-u C-c *: Updating the table. (line 24)
* C-u C-u C-c =: Editing and debugging formulas.
(line 14)
(line 18)
* C-x C-s: Editing and debugging formulas.
(line 46)
* D: Agenda commands. (line 74)
* d: Agenda commands. (line 71)
* f: Agenda commands. (line 44)
@ -6656,7 +6712,7 @@ Key Index
* L: Agenda commands. (line 32)
* M: Agenda commands. (line 204)
* M-<down> <1>: Editing and debugging formulas.
(line 52)
(line 76)
* M-<down>: Built-in table editor.
(line 82)
* M-<left> <1>: Built-in table editor.
@ -6671,14 +6727,16 @@ Key Index
* M-<TAB> <2>: Setting tags. (line 6)
* M-<TAB> <3>: Per file keywords. (line 17)
* M-<TAB>: Editing and debugging formulas.
(line 44)
(line 64)
* M-<up> <1>: Editing and debugging formulas.
(line 52)
(line 76)
* M-<up>: Built-in table editor.
(line 82)
* M-S-<down> <1>: Built-in table editor.
* M-S-<down> <1>: Editing and debugging formulas.
(line 72)
* M-S-<down> <2>: Built-in table editor.
(line 89)
* M-S-<down> <2>: Plain lists. (line 59)
* M-S-<down> <3>: Plain lists. (line 59)
* M-S-<down>: Structure editing. (line 36)
* M-S-<left> <1>: The date/time prompt.
(line 54)
@ -6695,9 +6753,11 @@ Key Index
(line 79)
* M-S-<right> <3>: Plain lists. (line 65)
* M-S-<right>: Structure editing. (line 30)
* M-S-<up> <1>: Built-in table editor.
* M-S-<up> <1>: Editing and debugging formulas.
(line 72)
* M-S-<up> <2>: Built-in table editor.
(line 86)
* M-S-<up> <2>: Plain lists. (line 59)
* M-S-<up> <3>: Plain lists. (line 59)
* M-S-<up>: Structure editing. (line 33)
* mouse-1 <1>: Agenda commands. (line 35)
* mouse-1 <2>: The date/time prompt.
@ -6723,20 +6783,24 @@ Key Index
* S-<down> <3>: Creating timestamps. (line 58)
* S-<down> <4>: Priorities. (line 25)
* S-<down> <5>: Editing and debugging formulas.
(line 47)
(line 67)
* S-<down>: Plain lists. (line 55)
* S-<left> <1>: Agenda commands. (line 169)
* S-<left> <2>: The date/time prompt.
(line 42)
* S-<left> <3>: Creating timestamps. (line 53)
* S-<left>: TODO basics. (line 20)
* S-<left> <4>: TODO basics. (line 20)
* S-<left>: Editing and debugging formulas.
(line 67)
* S-<RET>: Built-in table editor.
(line 146)
* S-<right> <1>: Agenda commands. (line 161)
* S-<right> <2>: The date/time prompt.
(line 39)
* S-<right> <3>: Creating timestamps. (line 53)
* S-<right>: TODO basics. (line 20)
* S-<right> <4>: TODO basics. (line 20)
* S-<right>: Editing and debugging formulas.
(line 67)
* S-<TAB> <1>: Built-in table editor.
(line 61)
* S-<TAB>: Visibility cycling. (line 22)
@ -6746,7 +6810,7 @@ Key Index
* S-<up> <3>: Creating timestamps. (line 58)
* S-<up> <4>: Priorities. (line 25)
* S-<up> <5>: Editing and debugging formulas.
(line 47)
(line 67)
* S-<up>: Plain lists. (line 55)
* T: Agenda commands. (line 126)
* t: Agenda commands. (line 113)
@ -6758,181 +6822,182 @@ Key Index

Tag Table:
Node: Top970
Node: Introduction11398
Node: Summary11813
Node: Installation14821
Node: Activation16199
Node: Feedback17448
Node: Document structure19524
Node: Outlines20298
Node: Headlines20958
Node: Visibility cycling21581
Ref: Visibility cycling-Footnote-123795
Ref: Visibility cycling-Footnote-223853
Ref: Visibility cycling-Footnote-323903
Node: Motion24172
Node: Structure editing24956
Node: Archiving27782
Node: ARCHIVE tag28340
Node: Moving subtrees30133
Node: Sparse trees31444
Ref: Sparse trees-Footnote-133576
Ref: Sparse trees-Footnote-233758
Node: Plain lists33873
Ref: Plain lists-Footnote-137398
Ref: Plain lists-Footnote-237755
Node: Tables37939
Node: Built-in table editor38453
Node: Narrow columns45449
Ref: Narrow columns-Footnote-147381
Node: orgtbl-mode47427
Node: The spreadsheet48231
Node: References49049
Node: Formula syntax for Calc52684
Node: Formula syntax for Lisp55001
Node: Field formulas56229
Node: Column formulas57540
Node: Editing and debugging formulas58963
Node: Updating the table62328
Node: Advanced features63359
Node: Hyperlinks67884
Node: Link format68657
Node: Internal links69950
Ref: Internal links-Footnote-171875
Node: Radio targets72007
Node: External links72698
Node: Handling links75102
Ref: Handling links-Footnote-180194
Ref: Handling links-Footnote-280431
Node: Link abbreviations80505
Node: Search options82184
Ref: Search options-Footnote-183964
Node: Custom searches84045
Node: Remember85093
Node: Setting up remember86080
Node: Remember templates86662
Ref: Remember templates-Footnote-189977
Node: Storing notes90075
Node: TODO items91883
Node: TODO basics92865
Node: TODO extensions94392
Node: Workflow states95187
Node: TODO types96172
Ref: TODO types-Footnote-197830
Node: Per file keywords97912
Ref: Per file keywords-Footnote-199366
Node: Priorities99567
Node: Breaking down tasks100811
Ref: Breaking down tasks-Footnote-1101330
Node: Checkboxes101426
Node: Timestamps104181
Node: Time stamps104715
Ref: Time stamps-Footnote-1108209
Ref: Time stamps-Footnote-2108325
Node: Creating timestamps108480
Node: The date/time prompt111106
Ref: The date/time prompt-Footnote-1113067
Node: Custom time format113173
Node: Repeating items114731
Node: Progress logging116541
Node: Closing items117187
Ref: Closing items-Footnote-1118121
Ref: Closing items-Footnote-2118190
Node: Tracking TODO state changes118263
Node: Clocking work time119119
Ref: Clocking work time-Footnote-1122765
Ref: Clocking work time-Footnote-2122843
Node: Tags122969
Node: Tag inheritance123731
Node: Setting tags124668
Ref: Setting tags-Footnote-1129191
Ref: Setting tags-Footnote-2129303
Node: Tag searches129386
Node: Agenda views132097
Node: Agenda files134042
Ref: Agenda files-Footnote-1135008
Ref: Agenda files-Footnote-2135157
Node: Agenda dispatcher135350
Node: Built-in agenda views137041
Node: Weekly/Daily agenda137619
Node: Global TODO list139748
Node: Matching headline tags141921
Node: Timeline142992
Node: Stuck projects143658
Node: Presentation and sorting145357
Node: Categories146148
Node: Time-of-day specifications146812
Node: Sorting of agenda items148783
Node: Agenda commands150065
Node: Custom agenda views156718
Node: Storing searches157393
Node: Block agenda159305
Node: Setting Options160535
Node: Batch processing163247
Node: Embedded LaTeX164377
Ref: Embedded LaTeX-Footnote-1165469
Node: Math symbols165659
Node: Subscripts and Superscripts166424
Node: LaTeX fragments167268
Ref: LaTeX fragments-Footnote-1169376
Node: Processing LaTeX fragments169638
Node: CDLaTeX mode170584
Ref: CDLaTeX mode-Footnote-1173068
Node: Exporting173216
Node: ASCII export174530
Node: HTML export175820
Node: Export commands176439
Node: Quoting HTML tags177163
Node: Links177793
Node: Images178490
Ref: Images-Footnote-1179361
Node: CSS support179422
Ref: CSS support-Footnote-1180741
Node: XOXO export180854
Node: iCalendar export181293
Node: Text interpretation182512
Node: Comment lines182991
Node: Enhancing text183462
Node: Export options185280
Node: Publishing186977
Ref: Publishing-Footnote-1187773
Node: Configuration187969
Node: Project alist188687
Node: Sources and destinations189753
Node: Selecting files190483
Node: Publishing action191231
Node: Publishing options192464
Node: Publishing links194616
Node: Project page index196129
Node: Sample configuration196907
Node: Simple example197399
Node: Complex example198072
Node: Triggering publication200148
Node: Miscellaneous200833
Node: Completion201467
Node: Customization202938
Node: In-buffer settings203521
Node: The very busy C-c C-c key207761
Node: Clean view209405
Node: TTY keys211982
Node: Interaction213591
Node: Cooperation213988
Node: Conflicts216728
Node: Bugs218320
Node: Extensions and Hacking219816
Node: Extensions220412
Node: Tables in arbitrary syntax222359
Node: Radio tables223436
Node: A LaTeX example225939
Ref: A LaTeX example-Footnote-1229585
Ref: A LaTeX example-Footnote-2229733
Node: Translator functions230168
Ref: Translator functions-Footnote-1233277
Node: Dynamic blocks233365
Node: Special agenda views235337
Ref: Special agenda views-Footnote-1237616
Node: History and Acknowledgments237876
Node: Index243665
Node: Key Index274359
Node: Introduction11399
Node: Summary11814
Node: Installation14823
Node: Activation16201
Node: Feedback17450
Node: Document structure19526
Node: Outlines20300
Node: Headlines20960
Node: Visibility cycling21583
Ref: Visibility cycling-Footnote-123797
Ref: Visibility cycling-Footnote-223855
Ref: Visibility cycling-Footnote-323905
Node: Motion24174
Node: Structure editing24958
Node: Archiving27784
Node: ARCHIVE tag28342
Node: Moving subtrees30135
Node: Sparse trees31446
Ref: Sparse trees-Footnote-133578
Ref: Sparse trees-Footnote-233760
Node: Plain lists33875
Ref: Plain lists-Footnote-137400
Ref: Plain lists-Footnote-237757
Node: Tables37941
Node: Built-in table editor38455
Node: Narrow columns45451
Ref: Narrow columns-Footnote-147384
Node: orgtbl-mode47430
Node: The spreadsheet48234
Node: References49321
Ref: References-Footnote-153370
Node: Formula syntax for Calc53659
Node: Formula syntax for Lisp56125
Node: Field formulas57394
Node: Column formulas58702
Node: Editing and debugging formulas60301
Node: Updating the table64454
Node: Advanced features65485
Node: Hyperlinks70010
Node: Link format70783
Node: Internal links72076
Ref: Internal links-Footnote-174001
Node: Radio targets74133
Node: External links74824
Node: Handling links77228
Ref: Handling links-Footnote-182320
Ref: Handling links-Footnote-282557
Node: Link abbreviations82631
Node: Search options84310
Ref: Search options-Footnote-186090
Node: Custom searches86171
Node: Remember87219
Node: Setting up remember88206
Node: Remember templates88788
Ref: Remember templates-Footnote-192102
Node: Storing notes92200
Node: TODO items94008
Node: TODO basics94991
Node: TODO extensions96518
Node: Workflow states97313
Node: TODO types98298
Ref: TODO types-Footnote-199956
Node: Per file keywords100038
Ref: Per file keywords-Footnote-1101492
Node: Priorities101693
Node: Breaking down tasks102937
Ref: Breaking down tasks-Footnote-1103457
Node: Checkboxes103553
Node: Timestamps106308
Node: Time stamps106842
Ref: Time stamps-Footnote-1110336
Ref: Time stamps-Footnote-2110452
Node: Creating timestamps110607
Node: The date/time prompt113243
Ref: The date/time prompt-Footnote-1115204
Node: Custom time format115310
Node: Repeating items116868
Node: Progress logging118678
Node: Closing items119324
Ref: Closing items-Footnote-1120258
Ref: Closing items-Footnote-2120327
Node: Tracking TODO state changes120400
Node: Clocking work time121256
Ref: Clocking work time-Footnote-1124902
Ref: Clocking work time-Footnote-2124980
Node: Tags125106
Node: Tag inheritance125868
Node: Setting tags126805
Ref: Setting tags-Footnote-1131328
Ref: Setting tags-Footnote-2131440
Node: Tag searches131523
Node: Agenda views134234
Node: Agenda files136179
Ref: Agenda files-Footnote-1137145
Ref: Agenda files-Footnote-2137294
Node: Agenda dispatcher137487
Node: Built-in agenda views139178
Node: Weekly/Daily agenda139756
Node: Global TODO list141885
Node: Matching headline tags144058
Node: Timeline145129
Node: Stuck projects145795
Node: Presentation and sorting147494
Node: Categories148285
Node: Time-of-day specifications148949
Node: Sorting of agenda items150920
Node: Agenda commands152202
Node: Custom agenda views158855
Node: Storing searches159530
Node: Block agenda161442
Node: Setting Options162672
Node: Batch processing165384
Node: Embedded LaTeX166514
Ref: Embedded LaTeX-Footnote-1167606
Node: Math symbols167796
Node: Subscripts and Superscripts168561
Node: LaTeX fragments169405
Ref: LaTeX fragments-Footnote-1171513
Node: Processing LaTeX fragments171775
Node: CDLaTeX mode172721
Ref: CDLaTeX mode-Footnote-1175205
Node: Exporting175353
Node: ASCII export176667
Node: HTML export177957
Node: Export commands178576
Node: Quoting HTML tags179300
Node: Links179930
Node: Images180627
Ref: Images-Footnote-1181498
Node: CSS support181559
Ref: CSS support-Footnote-1182878
Node: XOXO export182991
Node: iCalendar export183430
Node: Text interpretation184649
Node: Comment lines185128
Node: Enhancing text185599
Node: Export options187417
Node: Publishing189114
Ref: Publishing-Footnote-1189910
Node: Configuration190106
Node: Project alist190824
Node: Sources and destinations191890
Node: Selecting files192620
Node: Publishing action193368
Node: Publishing options194601
Node: Publishing links196753
Node: Project page index198266
Node: Sample configuration199044
Node: Simple example199536
Node: Complex example200209
Node: Triggering publication202285
Node: Miscellaneous202970
Node: Completion203604
Node: Customization205075
Node: In-buffer settings205658
Node: The very busy C-c C-c key210135
Node: Clean view211779
Node: TTY keys214356
Node: Interaction215965
Node: Cooperation216362
Node: Conflicts219102
Node: Bugs220694
Node: Extensions and Hacking222190
Node: Extensions222786
Node: Tables in arbitrary syntax224733
Node: Radio tables225810
Node: A LaTeX example228313
Ref: A LaTeX example-Footnote-1231959
Ref: A LaTeX example-Footnote-2232107
Node: Translator functions232542
Ref: Translator functions-Footnote-1235651
Node: Dynamic blocks235739
Node: Special agenda views237711
Ref: Special agenda views-Footnote-1239990
Node: History and Acknowledgments240250
Node: Index246039
Node: Key Index276879

End Tag Table

647
org.el

File diff suppressed because it is too large Load Diff

BIN
org.pdf

Binary file not shown.

185
org.texi
View File

@ -3,8 +3,8 @@
@setfilename ../info/org
@settitle Org Mode Manual
@set VERSION 4.67
@set DATE February 2007
@set VERSION 4.68
@set DATE March 2007
@dircategory Emacs
@direntry
@ -162,7 +162,7 @@ TODO items
* TODO basics:: Marking and displaying TODO entries
* TODO extensions:: Workflow and assignments
* Priorities:: Some things are more important than others
* Breaking down tasks:: Splitting a task into managable pieces
* Breaking down tasks:: Splitting a task into manageable pieces
* Checkboxes:: Tick-off lists
Extended use of TODO keywords
@ -243,7 +243,7 @@ Exporting
HTML export
* Export commands:: How to invode HTML export
* Export commands:: How to invoke HTML export
* Quoting HTML tags:: Using direct HTML in Org-mode
* Links:: How hyperlinks get transferred to HTML
* Images:: To inline or not to inline?
@ -370,7 +370,7 @@ example as:
Org-mode's automatic, context sensitive table editor with spreadsheet
capabilities can be integrated into any major mode by activating the
minor Orgtbl-mode. Using a translation step, it can be used to maintain
tables in arbitray file types, for example in LaTeX.
tables in arbitrary file types, for example in LaTeX.
@cindex FAQ
There is a website for Org-mode which provides links to the newest
@ -1319,7 +1319,7 @@ value.
@noindent
Fields that are wider become clipped and end in the string @samp{=>}.
Note that the full text is still in the buffer, it is only invisible.
To see the full text, hold the mouse over the field - a tooltip window
To see the full text, hold the mouse over the field - a tool-tip window
will show the full content. To edit such a field, use the command
@kbd{C-c `} (that is @kbd{C-c} followed by the backquote). This will
open a new window with the full field. Edit it and finish with @kbd{C-c
@ -1355,7 +1355,7 @@ example in mail mode, use
Furthermore, with some special setup, it is possible to maintain tables
in arbitrary syntax with Orgtbl-mode. For example, it is possible to
construct LaTeX tables with the underlying ease and power of
Orgtbl-mode, including spreadsheet capabulities. For details, see
Orgtbl-mode, including spreadsheet capabilities. For details, see
@ref{Tables in arbitrary syntax}.
@node The spreadsheet, , orgtbl-mode, Tables
@ -1366,7 +1366,12 @@ Orgtbl-mode, including spreadsheet capabulities. For details, see
The table editor makes use of the Emacs @file{calc} package to implement
spreadsheet-like capabilities. It can also evaluate Emacs Lisp forms to
derive fields from other fields.
derive fields from other fields. While fully featured, Org-mode's
implementation is not identical to other spreadsheets. For example,
Org-mode knows the concept of a @emph{column formula} that will be
applied to all non-header fields in a column without having to copy the
formula to each relevant field.
@menu
* References:: How to refer to another field or range
* Formula syntax for Calc:: Using Calc to compute stuff
@ -1386,17 +1391,26 @@ To compute fields in the table from other fields, formulas must
reference other fields or ranges. In Org-mode, fields can be referenced
by name, by absolute coordinates, and by relative coordinates. To find
out what the coordinates of a field are, press @kbd{C-c ?} in that
field.
field, or press @kbd{C-c @}} to toggle the display of a grid.
@subsubheading Field references
@cindex field references
@cindex references, to fields
Formulas can reference the value of another field with the operator
Formulas can reference the value of another field in two ways. Like in
any other spreadsheet, you may reference fields with a letter/number
combination like @code{B3}, meaning the 2nd field in the 3rd row.
@c Such references are always fixed to that field, they don't change
@c when you copy and paste a formula to a different field. So
@c Org-mode's @code{B3} behaves like @code{$B$3} in other spreadsheets.
@noindent
Org-mode also uses another, more general operator that looks like this:
@example
@@row$column
@end example
@noindent
Column references can be absolute like @samp{1}, @samp{2},...@samp{N},
or relative to the current column like @samp{+1} or @samp{-2}.
@ -1416,18 +1430,20 @@ directly at the hline is used.
either the column or the row part of the reference, the current
row/column is implied.
Org-mode's references with @emph{positive} numbers correspond to fixed
references in other spreadsheet programs. For example, @code{@@3$28}
corresponds to @code{$AB$3}. Org-mode's references with @emph{negative}
numbers behave similar to non-fixed references in other spreadsheet
programs, because when the same formula is used in several fields,
different fields are referenced each time.
Org-mode's references with @emph{unsigned} numbers are fixed references
in the sense that if you use the same reference in the formula for two
different fields, the same field will be referenced each time.
Org-mode's references with @emph{signed} numbers are floating
references because the same reference operator can reference different
fields depending on the field being calculated by the formula.
Here are a few examples:
@example
@@2$3 @r{2nd row, 3rd column}
C2 @r{same as previous}
$5 @r{column 5 in the current row}
E& @r{same as previous}
@@2 @r{current column, row 2}
@@-1$-3 @r{the field one row up, three columns to the left}
@@-I$2 @r{field just under hline above current row, column 2}
@ -1448,6 +1464,7 @@ format at least for the first field (i.e the reference must start with
$1..$3 @r{First three fields in the current row.}
$P..$Q @r{Range, using column names (see under Advanced)}
@@2$1..@@4$3 @r{6 fields between these two fields.}
A2..C4 @r{Same as above.}
@@-1$-2..@@-1 @r{3 numbers from the column to the left, 2 up to current row}
@end example
@ -1465,12 +1482,16 @@ see the @samp{E} mode switch below). If there are no non-empty fields,
@samp{$name} is interpreted as the name of a column, parameter or
constant. Constants are defined globally through the variable
@code{org-table-formula-constants}. If you have the
@file{constants.el} package, it will also be used to resolve
constants, including natural constants like @samp{$h} for Planck's
constant, and units like @samp{$km} for kilometers. Column names and
parameters can be specified in special table lines. These are
described below, see @ref{Advanced features}.
@code{org-table-formula-constants}. If you have the @file{constants.el}
package, it will also be used to resolve constants, including natural
constants like @samp{$h} for Planck's constant, and units like
@samp{$km} for kilometers@footnote{@file{Constant.el} can supply the
values of constants in two different unit systems, @code{SI} and
@code{cgs}. Which one is used depends on the value of the variable
@code{constants-unit-system}. You can use the @code{#+STARTUP} options
@code{constSI} and @code{constcgs} to set this value for the current
buffer.}. Column names and parameters can be specified in special table
lines. These are described below, see @ref{Advanced features}.
@node Formula syntax for Calc, Formula syntax for Lisp, References, The spreadsheet
@subsection Formula syntax for Calc
@ -1517,7 +1538,7 @@ reformat the final result. A few examples:
$1+$2 @r{Sum of first and second field}
$1+$2;%.2f @r{Same, format result to two decimals}
exp($2)+exp($1) @r{Math functions can be used}
$;%.1f @r{Reformat current cell to 1 decimal}
$0;%.1f @r{Reformat current cell to 1 decimal}
($3-32)*5/9 @r{Degrees F -> C conversion}
$c/$1/$cm @r{Hz -> cm conversion, using @file{constants.el}}
tan($1);Dp3s1 @r{Compute in degrees, precision 3, display SCI 1}
@ -1527,21 +1548,28 @@ vmean($2..$7);EN @r{Same, but treat empty fields as 0}
taylor($3,x=7,2) @r{taylor series of $3, at x=7, second degree}
@end example
Calc also contains a complete set of logical operations. For example
@example
if($1<20,teen,string("")) @r{``teen'' if age $1 less than 20, else empty}
@end example
@node Formula syntax for Lisp, Field formulas, Formula syntax for Calc, The spreadsheet
@subsection Emacs Lisp forms as formulas
@cindex Lisp forms, as table formulas
It is also possible to write a formula in Emacs Lisp; this can be useful
for string manipulation and control structures. If a formula starts
with a single quote followed by an opening parenthesis, then it is
evaluated as a lisp form. The evaluation should return either a string
or a number. Just as with @file{calc} formulas, you can specify modes
and a printf format after a semicolon. A reference will be replaced
with a string (in double quotes) containing the field. If you provide
the @samp{N} mode switch, all referenced elements will be numbers.
Ranges are inserted as space-separated fields, so you can embed them in
list or vector syntax. A few examples, note how the @samp{N} mode is
used when we do computations in lisp.
for string manipulation and control structures, if the Calc's
functionality is not enough. If a formula starts with a single quote
followed by an opening parenthesis, then it is evaluated as a lisp form.
The evaluation should return either a string or a number. Just as with
@file{calc} formulas, you can specify modes and a printf format after a
semicolon. A reference will be replaced with a string (in double
quotes) containing the field. If you provide the @samp{N} mode switch,
all referenced elements will be numbers. Ranges are inserted as
space-separated fields, so you can embed them in list or vector syntax.
A few examples, note how the @samp{N} mode is used when we do
computations in lisp.
@example
@r{Swap the first two characters of the content of column 1}
@ -1566,12 +1594,11 @@ evaluated, and the current field replaced with the result.
Formulas are stored in a special line starting with @samp{#+TBLFM:}
directly below the table. If you typed the equation in the 4th field of
the 3rd data line in the table, the formula will look like
@samp{@@3$2=$1+$2}. When inserting/deleting/swapping column and rows
@samp{@@3$4=$1+$2}. When inserting/deleting/swapping column and rows
with the appropriate commands, @i{absolute references} (but not relative
ones) in stored formulas are modified in order to
still reference the same field. Of cause this is not true if you edit
the table structure with normal editing commands - then you must go and
fix equations yourself.
ones) in stored formulas are modified in order to still reference the
same field. Of cause this is not true if you edit the table structure
with normal editing commands - then you must fix the equations yourself.
Instead of typing an equation into the field, you may also use the
following command
@ -1592,7 +1619,9 @@ it to the current field and stores it.
Often in a table, the same formula should be used for all fields in a
particular column. Instead of having to copy the formula to all fields
in that column, org-mode allows to assign a single formula to an entire
column.
column. If the table contains horizontal separator hlines, everything
before the first such line is considered part of the table @emph{header}
and will not be modified by column formulas.
To assign a formula to a column, type it directly into any field in the
column, preceded by an equal sign, like @samp{=$1+$2}. When you press
@ -1625,7 +1654,11 @@ will apply it to that many consecutive fields in the current column.
You can edit individual formulas in the minibuffer or directly in the
field. Org-mode can also prepare a special buffer with all active
formulas of a table.
formulas of a table. When offering a formula for editing, Org-mode
converts references to the standard format (like @code{B3} or @code{D&})
if possible. If you prefer to only work with the internal format (like
@code{@@3$2} or @code{$4}), configure the variable
@code{org-table-use-standard-references}.
@table @kbd
@kindex C-c =
@ -1644,21 +1677,36 @@ minibuffer is that you can use the command @kbd{C-c ?}.
@item C-c ?
While editing a formula in a table field, highlight the field(s)
referenced by the reference at the cursor position in the formula.
@kindex C-c @}
@item C-c @}
Toggle the display of row and column numbers for a table, using
overlays. These are updated each time the table is aligned, you can
force it with @kbd{C-c C-c}.
@kindex C-c @{
@item C-c @{
Toggle the formula debugger on and off. See below.
@kindex C-c '
@item C-c '
Edit all formulas for the current table in a special buffer, where the
formulas will be displayed one per line.
formulas will be displayed one per line. If the current field has an
active formula, the cursor in the formula editor will mark it.
While inside the special buffer, Org-mode will automatically highlight
any field or range reference at the cursor position. You may edit,
remove and add formulas, and use the following commands:
@table @kbd
@kindex C-c C-c
@kindex C-x C-s
@item C-c C-c
Exit the buffer and store the modified formulas. With @kbd{C-u} prefix,
also apply the new formulas to the entire table.
@itemx C-x C-s
Exit the formula editor and store the modified formulas. With @kbd{C-u}
prefix, also apply the new formulas to the entire table.
@kindex C-c C-q
@item C-c C-q
Exit the buffer without installing changes.
Exit the formula editor without installing changes.
@kindex C-c C-r
@item C-c C-r
Toggle all references in the formula editor between standard (like
@code{B3}) and internal (like @code{@@3$2}).
@kindex @key{TAB}
@item @key{TAB}
Pretty-print or indent lisp formula at point. When in a line containing
@ -1670,23 +1718,25 @@ formula, @key{TAB} re-indents just like in Emacs-lisp-mode.
Complete Lisp symbols, just like in Emacs-lisp-mode.
@kindex S-@key{up}
@kindex S-@key{down}
@item S-@key{up}/@key{down}
Move the reference line in the Org-mode buffer up and down. This is
important for highlighting the references of column formulas for
different rows.
@kindex S-@key{left}
@kindex S-@key{right}
@item S-@key{up}/@key{down}/@key{left}/@key{right}
Shift the reference at point. For example, if the reference is
@code{B3} and you press @kbd{S-@key{right}}, it will become @code{C3}.
This also works for relative references, and for hline references.
@kindex M-S-@key{up}
@kindex M-S-@key{down}
@item M-S-@key{up}/@key{down}
Move the test line for column formulas in the Org-mode buffer up and
down.
@kindex M-@key{up}
@kindex M-@key{down}
@item M-@key{up}/@key{down}
Scroll the window displaying the table.
@end table
@kindex C-c @}
@item C-c @}
Toggle the display of row and column numbers for a table, using
overlays. These are uptated each time the table is aligned, you can
force it with @kbd{C-c C-c}.
@kindex C-c @{
@item C-c @{
Toggle the formula debugger on and off. See below.
Turn the coordinate grid in the table on and off.
@end table
@end table
Making a table field blank does not remove the formula associated with
@ -1707,8 +1757,8 @@ When the evaluation of a formula leads to an error, the field content
becomes the string @samp{#ERROR}. If you would like see what is going
on during variable substitution and calculation in order to find a bug,
turn on formula debugging in the @code{Tbl} menu and repeat the
calculation, for example by pressing @kbd{C-c = @key{RET}} in a field.
Detailed information will be displayed.
calculation, for example by pressing @kbd{C-u C-u C-c = @key{RET}} in a
field. Detailed information will be displayed.
@node Updating the table, Advanced features, Editing and debugging formulas, The spreadsheet
@subsection Updating the Table
@ -1742,7 +1792,6 @@ This may be necessary if some computed fields use the value of other
fields that are computed @i{later} in the calculation sequence.
@end table
@node Advanced features, , Updating the table, The spreadsheet
@subsection Advanced features
@ -2407,7 +2456,7 @@ template has been expanded:
@noindent
If you change you mind about which template to use, call
@code{org-remember} in the remember buffer. You may then select a new
template that will be filled with the previoous context information.
template that will be filled with the previous context information.
@node Storing notes, , Remember templates, Remember
@subsection Storing notes
@ -2466,7 +2515,7 @@ things you have to do.
* TODO basics:: Marking and displaying TODO entries
* TODO extensions:: Workflow and assignments
* Priorities:: Some things are more important than others
* Breaking down tasks:: Splitting a task into managable pieces
* Breaking down tasks:: Splitting a task into manageable pieces
* Checkboxes:: Tick-off lists
@end menu
@ -2686,7 +2735,7 @@ Furthermore, these keys are also used by CUA-mode (@pxref{Conflicts}).
@section Breaking tasks down into subtasks
@cindex tasks, breaking down
It is often advisable to break down large tasks into smaller, managable
It is often advisable to break down large tasks into smaller, manageable
subtasks. You can do this by creating an outline tree below a TODO
item, with detailed subtasks on the tree@footnote{To keep subtasks out
of the global TODO list, see the
@ -2907,8 +2956,8 @@ see the option @code{org-time-stamp-rounding-minutes}.
@kindex C-c !
@item C-c !
Like @kbd{C-c .}, but insert an inactive time stamp not triggering the
agenda.
Like @kbd{C-c .}, but insert an inactive time stamp that will not cause
an agenda entry.
@kindex C-c <
@item C-c <
@ -4772,7 +4821,7 @@ HTML formatting, in ways similar to John Grubers @emph{markdown}
language, but with additional support for tables.
@menu
* Export commands:: How to invode HTML export
* Export commands:: How to invoke HTML export
* Quoting HTML tags:: Using direct HTML in Org-mode
* Links:: How hyperlinks get transferred to HTML
* Images:: To inline or not to inline?
@ -5611,6 +5660,14 @@ To turn on custom format overlays over time stamps (variables
@example
customtime @r{overlay custom time format}
@end example
The following options influence the table spreadsheet (variable
@code{constants-unit-system}).
@cindex @code{constcgs}, STARTUP keyword
@cindex @code{constSI}, STARTUP keyword
@example
constcgs @r{@file{constants.el} should use the c-g-s unit system}
constSI @r{@file{constants.el} should use the SI unit system}
@end example
@item #+SEQ_TODO: #+TYP_TODO:
These lines set the TODO keywords and their interpretation in the
current file. The corresponding variables are @code{org-todo-keywords}

Binary file not shown.

View File

@ -1,6 +1,7 @@
% Reference Card for Org Mode
\def\orgversionnumber{4.67}
\def\year{2007}
\def\orgversionnumber{4.68}
\def\versionyear{2007} % latest update
\def\year{2007} % latest copyright year
%
%**start of header
\newcount\columnsperpage
@ -20,7 +21,7 @@
\columnsperpage=3
% Copyright (c) 2004, 2005, 2006, 2007 Free Software Foundation
% Copyright (C) 2004, 2005, 2006, 2007 Free Software Foundation, Inc
% GNU Emacs is free software; you can redistribute it and/or modify
% it under the terms of the GNU General Public License as published by
@ -61,14 +62,14 @@
% for their many good ideas.
\def\shortcopyrightnotice{\vskip 1ex plus 2 fill
\centerline{\small \copyright\ 2004, 2005, 2006, 2007\ Free Software Foundation, Inc.
\centerline{\small \copyright\ \year\ Free Software Foundation, Inc.
Permissions on back. v\orgversionnumber}}
\def\copyrightnotice{
\vskip 1ex plus 100 fill\begingroup\small
\centerline{Copyright \copyright\ \year\ Free Software Foundation, Inc.}
\centerline{v\orgversionnumber{} for Org-Mode \orgversionnumber{}, \year}
\centerline{Authors: Philip Rooke \& Carsten Dominik}
\centerline{v\orgversionnumber{} for Org-Mode \orgversionnumber{}, \versionyear}
\centerline{Author: Philip Rooke}
\centerline{based on refcard design and format by Stephen Gildea}
Permission is granted to make and distribute copies of
@ -377,34 +378,6 @@ 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} (in combination with Emacs \kbd{calc} package)
\key{set and eval column formula}{C-c =}
\key{set and eval field formula}{C-u C-c =}
\key{edit formulas in separate buffer}{C-c '}
\key{re-apply all stored equations to current line}{C-c *}
\key{re-apply all stored equations to entire table}{C-u C-c *}
\key{iterate table to stability}{C-u C-u C-c *}
%\kbd{TAB}, \kbd{RET} and \kbd{C-c C-c} trigger automatic recalculation
%in lines starting with: {\tt | \# |}.
\key{rotate calculation mark through \# * ! \^ \_ \$}{C-\#}
\key{show line, column, formula reference}{C-c ?}
\key{sum numbers in current column/rectangle}{C-c +}
\key{copy down with increment}{S-RET$^3$}
Formulas typed in field are executed by \kbd{TAB},
\kbd{RET} and \kbd{C-c C-c}. \kbd{=} introduces a column
formula, \kbd{:=} a named-field formula.
\key{Example: Add Col1 and Col2}{=\$1+\$2}
\key{... with printf format specification}{=\$1+\$2;\%.2f}
\key{... with constants from constants.el}{=\$1/\$c/\$cm}
\metax{sum from 2nd to 3rd hline}{:=vsum(@II..@III)}
\key{apply current column formula}{=}
{\bf Miscellaneous}
\key{to limit column width to \kbd{N} characters, use}{...| <N> |...}
@ -412,6 +385,8 @@ formula, \kbd{:=} a named-field formula.
\key{make current field fully visible}{C-u TAB}
\metax{export as tab-separated file}{M-x org-table-export}
\metax{import tab-separated file}{M-x org-table-import}
\key{sum numbers in current column/rectangle}{C-c +}
\key{copy down with increment}{S-RET$^3$}
{\bf Tables created with the \kbd{table.el} package}
@ -419,6 +394,42 @@ formula, \kbd{:=} a named-field formula.
\key{recognize existing table.el table}{C-c C-c}
\key{convert table (Org-mode $\leftrightarrow$ table.el)}{C-c ~}
{\bf Spreadsheet}
Formulas typed in field are executed by \kbd{TAB},
\kbd{RET} and \kbd{C-c C-c}. \kbd{=} introduces a column
formula, \kbd{:=} a field formula.
\key{Example: Add Col1 and Col2}{|=\$1+\$2 |}
\key{... with printf format specification}{|=\$1+\$2;\%.2f|}
\key{... with constants from constants.el}{|=\$1/\$c/\$cm |}
\metax{sum from 2nd to 3rd hline}{|:=vsum(@II..@III)|}
\key{apply current column formula}{| = |}
\key{set and eval column formula}{C-c =}
\key{set and eval field formula}{C-u C-c =}
\key{re-apply all stored equations to current line}{C-c *}
\key{re-apply all stored equations to entire table}{C-u C-c *}
\key{iterate table to stability}{C-u C-u C-c *}
\key{rotate calculation mark through \# * ! \^ \_ \$}{C-\#}
\key{show line, column, formula reference}{C-c ?}
\key{toggle coordinate grid}{C-c \}}
\key{toggle formula debugger}{C-c \{}
{\it Formula Editor}
\key{edit formulas in separate buffer}{C-c '}
\key{exit and install new formulas}{C-c C-c}
\key{exit, install, and apply new formulas}{C-u C-c C-c}
\key{abort}{C-c C-q}
\key{toggle reference style}{C-c C-r}
\key{pretty-print Lisp formula}{TAB}
\key{complete Lisp symbol}{M-TAB}
\key{shift reference point}{S-cursor}
\key{shift test line for column references}{M-up/down}
\key{scroll the window showing the table}{M-S-up/down}
\key{toggle table coordinate grid}{C-c \}}
\section{Links}
\key{globally store link to the current location}{C-c l$^1$}
@ -465,24 +476,24 @@ formula, \kbd{:=} a named-field formula.
%\key{\kbd{vm://myself@some.where.org/folder\#id}}{\rm VM remote}
\section{Remember-mode Integration}
% \section{Remember-mode Integration}
See the manual for how to make remember.el use Org-mode links and
files. The note-finishing command \kbd{C-c C-c} will first prompt for
an org file. In the file, find a location with:
% See the manual for how to make remember.el use Org-mode links and
% files. The note-finishing command \kbd{C-c C-c} will first prompt for
% an org file. In the file, find a location with:
\key{rotate subtree visibility}{TAB}
\key{next heading}{DOWN}
\key{previous heading}{UP}
% \key{rotate subtree visibility}{TAB}
% \key{next heading}{DOWN}
% \key{previous heading}{UP}
Insert the note with one of the following:
% Insert the note with one of the following:
\key{as sublevel of heading at cursor}{RET}
\key{right here (cursor not on heading)}{RET}
\key{before current heading}{LEFT}
\key{after current heading}{RIGHT}
\key{shortcut to end of buffer (cursor at buf-start)}{RET}
\key{Abort}{q}
% \key{as sublevel of heading at cursor}{RET}
% \key{right here (cursor not on heading)}{RET}
% \key{before current heading}{LEFT}
% \key{after current heading}{RIGHT}
% \key{shortcut to end of buffer (cursor at buf-start)}{RET}
% \key{Abort}{q}
\section{Completion}