mirrors/org-mode
0
0
Fork 1
mirror of https://git.savannah.gnu.org/git/emacs/org-mode.git synced 2024-07-16 15:46:27 +00:00
Code Releases Activity

Add command names for chapters 4-7

Browse source
This commit is contained in:
Carsten Dominik 2010-11-13 09:52:29 -06:00
parent 8c31cce753
commit c2a366ac5a
2 changed files with 83 additions and 126 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

207
doc/org.texi
View file

@ -1020,6 +1020,18 @@ User-defined properties are capitalized; built-in properties with
special meaning are written with all capitals. special meaning are written with all capitals.
@end table @end table
The manual lists both the keys and the corresponding commands for accessing
functionality. Org mode often uses the same key for different functions,
depending on context. The command that is bound to such keys has a generic
name, like @code{org-metaright}. In the manual we will, wherever possible,
give the function that is internally called by the generic command. For
example, in the chapter on document structure, @kbd{M-@key{right}} will be
listed to call @code{org-do-demote}, while in the chapter on tables, it will
be listed to call org-table-move-column-right.
If you prefer, you can compile the manual without the command names by
unsetting the flag @code{cmdnames} in @file{org.texi}.
@node Document Structure, Tables, Introduction, Top @node Document Structure, Tables, Introduction, Top
@chapter Document structure @chapter Document structure
@cindex document structure @cindex document structure
@ -3103,9 +3115,8 @@ Org provides methods to create a link in the correct syntax, to
insert it into an Org file, and to follow the link. insert it into an Org file, and to follow the link.
@table @kbd @table @kbd
@kindex C-c l @orgcmd{C-c l,org-store-link}
@cindex storing links @cindex storing links
@item C-c l
Store a link to the current location. This is a @emph{global} command (you Store a link to the current location. This is a @emph{global} command (you
must create the key binding yourself) which can be used in any buffer to must create the key binding yourself) which can be used in any buffer to
create a link. The link will be stored for later insertion into an Org create a link. The link will be stored for later insertion into an Org
@ -3161,11 +3172,10 @@ When the cursor is in an agenda view, the created link points to the
entry referenced by the current line. entry referenced by the current line.
@c @c
@kindex C-c C-l @orgcmd{C-c C-l,org-insert-link}
@cindex link completion @cindex link completion
@cindex completion, of links @cindex completion, of links
@cindex inserting links @cindex inserting links
@item C-c C-l
@vindex org-keep-stored-link-after-insertion @vindex org-keep-stored-link-after-insertion
Insert a link@footnote{ Note that you don't have to use this command to Insert a link@footnote{ Note that you don't have to use this command to
insert a link. Links in Org are plain text, and you can type or paste them insert a link. Links in Org are plain text, and you can type or paste them
@ -3195,10 +3205,9 @@ calling a special function @code{org-PREFIX-complete-link}.} For
example, if you type @kbd{file @key{RET}}, file name completion (alternative example, if you type @kbd{file @key{RET}}, file name completion (alternative
access: @kbd{C-u C-c C-l}, see below) will be offered, and after @kbd{bbdb access: @kbd{C-u C-c C-l}, see below) will be offered, and after @kbd{bbdb
@key{RET}} you can complete contact names. @key{RET}} you can complete contact names.
@kindex C-u C-c C-l @orgkey C-u C-c C-l
@cindex file name completion @cindex file name completion
@cindex completion, of file names @cindex completion, of file names
@item C-u C-c C-l
When @kbd{C-c C-l} is called with a @kbd{C-u} prefix argument, a link to When @kbd{C-c C-l} is called with a @kbd{C-u} prefix argument, a link to
a file will be inserted and you may use file name completion to select a file will be inserted and you may use file name completion to select
the name of the file. The path to the file is inserted relative to the the name of the file. The path to the file is inserted relative to the
@ -3213,9 +3222,7 @@ When the cursor is on an existing link, @kbd{C-c C-l} allows you to edit the
link and description parts of the link. link and description parts of the link.
@c @c
@cindex following links @cindex following links
@kindex C-c C-o @orgcmd{C-c C-o,org-open-at-point}
@kindex @key{RET}
@item C-c C-o @ @r{(or, if @code{org-return-follows-link} is set, also} @key{RET}
@vindex org-file-apps @vindex org-file-apps
Open link at point. This will launch a web browser for URLs (using Open link at point. This will launch a web browser for URLs (using
@command{browse-url-at-point}), run VM/MH-E/Wanderlust/Rmail/Gnus/BBDB for @command{browse-url-at-point}), run VM/MH-E/Wanderlust/Rmail/Gnus/BBDB for
@ -3231,13 +3238,17 @@ visit the file with Emacs, use a @kbd{C-u} prefix. If you want to avoid
opening in Emacs, use a @kbd{C-u C-u} prefix.@* opening in Emacs, use a @kbd{C-u C-u} prefix.@*
If the cursor is on a headline, but not on a link, offer all links in the If the cursor is on a headline, but not on a link, offer all links in the
headline and entry text. headline and entry text.
@orgkey @key{RET}
@vindex org-return-follows-link
When @code{org-return-follows-link} is set, @kbd{@key{RET}} will also follow
the link at point.
@c @c
@kindex mouse-2 @kindex mouse-2
@kindex mouse-1 @kindex mouse-1
@item mouse-2 @item mouse-2
@itemx mouse-1 @itemx mouse-1
On links, @kbd{mouse-2} will open the link just as @kbd{C-c C-o} On links, @kbd{mouse-2} will open the link just as @kbd{C-c C-o}
would. Under Emacs 22, @kbd{mouse-1} will also follow a link. would. Under Emacs 22 and later, @kbd{mouse-1} will also follow a link.
@c @c
@kindex mouse-3 @kindex mouse-3
@item mouse-3 @item mouse-3
@ -3246,13 +3257,12 @@ Like @kbd{mouse-2}, but force file links to be opened with Emacs, and
internal links to be displayed in another window@footnote{See the internal links to be displayed in another window@footnote{See the
variable @code{org-display-internal-link-with-indirect-buffer}}. variable @code{org-display-internal-link-with-indirect-buffer}}.
@c @c
@orgcmd{C-c C-x C-v,org-toggle-inline-images}
@cindex inlining images @cindex inlining images
@cindex images, inlining @cindex images, inlining
@kindex C-c C-x C-v
@vindex org-startup-with-inline-images @vindex org-startup-with-inline-images
@cindex @code{inlineimages}, STARTUP keyword @cindex @code{inlineimages}, STARTUP keyword
@cindex @code{noinlineimages}, STARTUP keyword @cindex @code{noinlineimages}, STARTUP keyword
@item C-c C-x C-v
Toggle the inline display of linked images. Normally this will only inline Toggle the inline display of linked images. Normally this will only inline
images that have no description part in the link, i.e. images that will also images that have no description part in the link, i.e. images that will also
be inlined during export. When called with a prefix argument, also display be inlined during export. When called with a prefix argument, also display
@ -3260,25 +3270,20 @@ images that do have a link description. You can ask for inline images to be
displayed at startup by configuring the variable displayed at startup by configuring the variable
@code{org-startup-with-inline-images}@footnote{with corresponding @code{org-startup-with-inline-images}@footnote{with corresponding
@code{#+STARTUP} keywords @code{inlineimages} and @code{inlineimages}}. @code{#+STARTUP} keywords @code{inlineimages} and @code{inlineimages}}.
@orgcmd{C-c %,org-mark-ring-push}
@cindex mark ring @cindex mark ring
@kindex C-c %
@item C-c %
Push the current position onto the mark ring, to be able to return Push the current position onto the mark ring, to be able to return
easily. Commands following an internal link do this automatically. easily. Commands following an internal link do this automatically.
@c @c
@orgcmd{C-c &,org-mark-ring-goto}
@cindex links, returning to @cindex links, returning to
@kindex C-c &
@item C-c &
Jump back to a recorded position. A position is recorded by the Jump back to a recorded position. A position is recorded by the
commands following internal links, and by @kbd{C-c %}. Using this commands following internal links, and by @kbd{C-c %}. Using this
command several times in direct succession moves through a ring of command several times in direct succession moves through a ring of
previously recorded positions. previously recorded positions.
@c @c
@kindex C-c C-x C-n @orgcmdkkcc{C-c C-x C-n,C-c C-x C-p,org-next-link,org-previous-link}
@kindex C-c C-x C-p
@cindex links, finding next/previous @cindex links, finding next/previous
@item C-c C-x C-n
@itemx C-c C-x C-p
Move forward/backward to the next link in the buffer. At the limit of Move forward/backward to the next link in the buffer. At the limit of
the buffer, the search fails once, and then wraps around. The key the buffer, the search fails once, and then wraps around. The key
bindings for this are really too long, you might want to bind this also bindings for this are really too long, you might want to bind this also
@ -3480,9 +3485,8 @@ Any headline becomes a TODO item when it starts with the word
The most important commands to work with TODO entries are: The most important commands to work with TODO entries are:
@table @kbd @table @kbd
@kindex C-c C-t @orgcmd{C-c C-t,org-todo}
@cindex cycling, of TODO states @cindex cycling, of TODO states
@item C-c C-t
Rotate the TODO state of the current item among Rotate the TODO state of the current item among
@example @example
@ -3493,8 +3497,7 @@ Rotate the TODO state of the current item among
The same rotation can also be done ``remotely'' from the timeline and The same rotation can also be done ``remotely'' from the timeline and
agenda buffers with the @kbd{t} command key (@pxref{Agenda commands}). agenda buffers with the @kbd{t} command key (@pxref{Agenda commands}).
@kindex C-u C-c C-t @orgkey{C-u C-c C-t}
@item C-u C-c C-t
Select a specific keyword using completion or (if it has been set up) Select a specific keyword using completion or (if it has been set up)
the fast selection interface. For the latter, you need to assign keys the fast selection interface. For the latter, you need to assign keys
to TODO states, see @ref{Per-file keywords}, and @ref{Setting tags}, for to TODO states, see @ref{Per-file keywords}, and @ref{Setting tags}, for
@ -3502,17 +3505,15 @@ more information.
@kindex S-@key{right} @kindex S-@key{right}
@kindex S-@key{left} @kindex S-@key{left}
@item S-@key{right} @ @r{/} @ S-@key{left}
@vindex org-treat-S-cursor-todo-selection-as-state-change @vindex org-treat-S-cursor-todo-selection-as-state-change
@item S-@key{right}
@itemx S-@key{left}
Select the following/preceding TODO state, similar to cycling. Useful Select the following/preceding TODO state, similar to cycling. Useful
mostly if more than two TODO states are possible (@pxref{TODO mostly if more than two TODO states are possible (@pxref{TODO
extensions}). See also @ref{Conflicts}, for a discussion of the interaction extensions}). See also @ref{Conflicts}, for a discussion of the interaction
with @code{shift-selection-mode}. See also the variable with @code{shift-selection-mode}. See also the variable
@code{org-treat-S-cursor-todo-selection-as-state-change}. @code{org-treat-S-cursor-todo-selection-as-state-change}.
@kindex C-c / t @orgcmd{C-c / t,org-show-todo-key}
@cindex sparse tree, for TODO @cindex sparse tree, for TODO
@itemx C-c / t
@vindex org-todo-keywords @vindex org-todo-keywords
View TODO items in a @emph{sparse tree} (@pxref{Sparse trees}). Folds the View TODO items in a @emph{sparse tree} (@pxref{Sparse trees}). Folds the
entire buffer, but shows all TODO items (with not-DONE state) and the entire buffer, but shows all TODO items (with not-DONE state) and the
@ -3523,15 +3524,13 @@ entries that match any one of these keywords. With numeric prefix argument
N, show the tree for the Nth keyword in the variable N, show the tree for the Nth keyword in the variable
@code{org-todo-keywords}. With two prefix arguments, find all TODO states, @code{org-todo-keywords}. With two prefix arguments, find all TODO states,
both un-done and done. both un-done and done.
@kindex C-c a t @orgcmd{C-c a t,org-todo-list}
@item C-c a t
Show the global TODO list. Collects the TODO items (with not-DONE states) Show the global TODO list. Collects the TODO items (with not-DONE states)
from all agenda files (@pxref{Agenda Views}) into a single buffer. The new from all agenda files (@pxref{Agenda Views}) into a single buffer. The new
buffer will be in @code{agenda-mode}, which provides commands to examine and buffer will be in @code{agenda-mode}, which provides commands to examine and
manipulate the TODO entries from the new buffer (@pxref{Agenda commands}). manipulate the TODO entries from the new buffer (@pxref{Agenda commands}).
@xref{Global TODO list}, for more information. @xref{Global TODO list}, for more information.
@kindex S-M-@key{RET} @orgcmd{S-M-@key{RET},org-insert-todo-heading}
@item S-M-@key{RET}
Insert a new TODO entry below the current one. Insert a new TODO entry below the current one.
@end table @end table
@ -3808,8 +3807,7 @@ example:
@end example @end example
@table @kbd @table @kbd
@kindex C-c C-x o @orgcmd{C-c C-x o,org-toggle-ordered-property}
@item C-c C-x o
@vindex org-track-ordered-property-with-tag @vindex org-track-ordered-property-with-tag
@cindex property, ORDERED @cindex property, ORDERED
Toggle the @code{ORDERED} property of the current entry. A property is used Toggle the @code{ORDERED} property of the current entry. A property is used
@ -3817,8 +3815,7 @@ for this behavior because this should be local to the current entry, not
inherited like a tag. However, if you would like to @i{track} the value of inherited like a tag. However, if you would like to @i{track} the value of
this property with a tag for better visibility, customize the variable this property with a tag for better visibility, customize the variable
@code{org-track-ordered-property-with-tag}. @code{org-track-ordered-property-with-tag}.
@kindex C-u C-u C-u C-c C-t @orgkey{C-u C-u C-u C-c C-t}
@item C-u C-u C-u C-c C-t
Change TODO state, circumventing any state blocking. Change TODO state, circumventing any state blocking.
@end table @end table
@ -4092,18 +4089,16 @@ Priorities can be attached to any outline node; they do not need to be TODO
items. items.
@table @kbd @table @kbd
@kindex @kbd{C-c ,}
@item @kbd{C-c ,} @item @kbd{C-c ,}
Set the priority of the current headline. The command prompts for a @kindex @kbd{C-c ,}
priority character @samp{A}, @samp{B} or @samp{C}. When you press @findex org-priority
@key{SPC} instead, the priority cookie is removed from the headline. Set the priority of the current headline (@command{org-priority}). The
The priorities can also be changed ``remotely'' from the timeline and command prompts for a priority character @samp{A}, @samp{B} or @samp{C}.
agenda buffer with the @kbd{,} command (@pxref{Agenda commands}). When you press @key{SPC} instead, the priority cookie is removed from the
headline. The priorities can also be changed ``remotely'' from the timeline
and agenda buffer with the @kbd{,} command (@pxref{Agenda commands}).
@c @c
@kindex S-@key{up} @orgcmdkkcc{S-@key{up},S-@key{down},org-priority-up,org-priority-down}
@kindex S-@key{down}
@item S-@key{up}
@itemx S-@key{down}
@vindex org-priority-start-cycle-with-default @vindex org-priority-start-cycle-with-default
Increase/decrease priority of current headline@footnote{See also the option Increase/decrease priority of current headline@footnote{See also the option
@code{org-priority-start-cycle-with-default}.}. Note that these keys are @code{org-priority-start-cycle-with-default}.}. Note that these keys are
@ -4253,13 +4248,11 @@ off a box while there are unchecked boxes above it.
@noindent The following commands work with checkboxes: @noindent The following commands work with checkboxes:
@table @kbd @table @kbd
@kindex C-c C-c @orgcmd{C-c C-c,org-toggle-checkbox}
@item C-c C-c
Toggle checkbox status or (with prefix arg) checkbox presence at point. With Toggle checkbox status or (with prefix arg) checkbox presence at point. With
double prefix argument, set it to @samp{[-]}, which is considered to be an double prefix argument, set it to @samp{[-]}, which is considered to be an
intermediate state. intermediate state.
@kindex C-c C-x C-b @orgcmd{C-c C-x C-b,org-toggle-checkbox}
@item C-c C-x C-b
Toggle checkbox status or (with prefix arg) checkbox presence at point. With Toggle checkbox status or (with prefix arg) checkbox presence at point. With
double prefix argument, set it to @samp{[-]}, which is considered to be an double prefix argument, set it to @samp{[-]}, which is considered to be an
intermediate state. intermediate state.
@ -4274,13 +4267,11 @@ this headline and the next (so @emph{not} the entire subtree).
@item @item
If there is no active region, just toggle the checkbox at point. If there is no active region, just toggle the checkbox at point.
@end itemize @end itemize
@kindex M-S-@key{RET} @orgcmd{M-S-@key{RET},org-insert-todo-heading}
@item M-S-@key{RET}
Insert a new item with a checkbox. Insert a new item with a checkbox.
This works only if the cursor is already in a plain list item This works only if the cursor is already in a plain list item
(@pxref{Plain lists}). (@pxref{Plain lists}).
@kindex C-c C-x o @orgcmd{C-c C-x o,org-toggle-ordered-property}
@item C-c C-x o
@vindex org-track-ordered-property-with-tag @vindex org-track-ordered-property-with-tag
@cindex property, ORDERED @cindex property, ORDERED
Toggle the @code{ORDERED} property of the entry, to toggle if checkboxes must Toggle the @code{ORDERED} property of the entry, to toggle if checkboxes must
@ -4289,8 +4280,7 @@ this should be local to the current entry, not inherited like a tag.
However, if you would like to @i{track} the value of this property with a tag However, if you would like to @i{track} the value of this property with a tag
for better visibility, customize the variable for better visibility, customize the variable
@code{org-track-ordered-property-with-tag}. @code{org-track-ordered-property-with-tag}.
@kindex C-c # @orgcmd{C-c #,org-update-statistics-cookies}
@item C-c #
Update the statistics cookie in the current outline entry. When called with Update the statistics cookie in the current outline entry. When called with
a @kbd{C-u} prefix, update the entire file. Checkbox statistic cookies are a @kbd{C-u} prefix, update the entire file. Checkbox statistic cookies are
updated automatically if you toggle checkboxes with @kbd{C-c C-c} and make updated automatically if you toggle checkboxes with @kbd{C-c C-c} and make
@ -4384,8 +4374,7 @@ After a colon, @kbd{M-@key{TAB}} offers completion on tags. There is
also a special command for inserting tags: also a special command for inserting tags:
@table @kbd @table @kbd
@kindex C-c C-q @orgcmd{C-c C-q,org-set-tags-command}
@item C-c C-q
@cindex completion, of tags @cindex completion, of tags
@vindex org-tags-column @vindex org-tags-column
Enter new tags for the current headline. Org-mode will either offer Enter new tags for the current headline. Org-mode will either offer
@ -4395,8 +4384,7 @@ to @code{org-tags-column}. When called with a @kbd{C-u} prefix, all
tags in the current buffer will be aligned to that column, just to make tags in the current buffer will be aligned to that column, just to make
things look nice. TAGS are automatically realigned after promotion, things look nice. TAGS are automatically realigned after promotion,
demotion, and TODO state changes (@pxref{TODO basics}). demotion, and TODO state changes (@pxref{TODO basics}).
@kindex C-c C-c @orgcmd{C-c C-c,org-set-tags-command}
@item C-c C-c
When the cursor is in a headline, this does the same as @kbd{C-c C-q}. When the cursor is in a headline, this does the same as @kbd{C-c C-q}.
@end table @end table
@ -4563,18 +4551,13 @@ Once a system of tags has been set up, it can be used to collect related
information into special lists. information into special lists.
@table @kbd @table @kbd
@kindex C-c \ @orgcmdkkc{C-c / m,C-c \,org-match-sparse-tree}
@kindex C-c / m
@item C-c \
@itemx C-c / m
Create a sparse tree with all headlines matching a tags search. With a Create a sparse tree with all headlines matching a tags search. With a
@kbd{C-u} prefix argument, ignore headlines that are not a TODO line. @kbd{C-u} prefix argument, ignore headlines that are not a TODO line.
@kindex C-c a m @orgcmd{C-c a m,org-tags-view}
@item C-c a m
Create a global list of tag matches from all agenda files. Create a global list of tag matches from all agenda files.
@xref{Matching tags and properties}. @xref{Matching tags and properties}.
@kindex C-c a M @orgcmd{C-c a M,org-tags-view}
@item C-c a M
@vindex org-tags-match-list-sublevels @vindex org-tags-match-list-sublevels
Create a global list of tag matches from all agenda files, but check Create a global list of tag matches from all agenda files, but check
only TODO items and force checking subitems (see variable only TODO items and force checking subitems (see variable
@ -4675,33 +4658,29 @@ Org files.
The following commands help to work with properties: The following commands help to work with properties:
@table @kbd @table @kbd
@kindex M-@key{TAB} @orgcmd{M-@key{TAB},org-complete}
@item M-@key{TAB}
After an initial colon in a line, complete property keys. All keys used After an initial colon in a line, complete property keys. All keys used
in the current file will be offered as possible completions. in the current file will be offered as possible completions.
@kindex C-c C-x p @orgcmd{C-c C-x p,org-set-property}
@item C-c C-x p
Set a property. This prompts for a property name and a value. If Set a property. This prompts for a property name and a value. If
necessary, the property drawer is created as well. necessary, the property drawer is created as well.
@item M-x org-insert-property-drawer @item M-x org-insert-property-drawer
@findex{org-insert-property-drawer}
Insert a property drawer into the current entry. The drawer will be Insert a property drawer into the current entry. The drawer will be
inserted early in the entry, but after the lines with planning inserted early in the entry, but after the lines with planning
information like deadlines. information like deadlines.
@kindex C-c C-c @orgcmd{C-c C-c,org-property-action}
@item C-c C-c
With the cursor in a property drawer, this executes property commands. With the cursor in a property drawer, this executes property commands.
@item C-c C-c s @orgcmd{C-c C-c s,org-set-property}
Set a property in the current entry. Both the property and the value Set a property in the current entry. Both the property and the value
can be inserted using completion. can be inserted using completion.
@kindex S-@key{right} @orgcmdkkcc{S-@key{right},S-@key{left},org-property-next-allowed-value,org-property-previous-allowed-value}
@kindex S-@key{left}
@item S-@key{left}/@key{right}
Switch property at point to the next/previous allowed value. Switch property at point to the next/previous allowed value.
@item C-c C-c d @orgcmd{C-c C-c d,org-delete-property}
Remove a property from the current entry. Remove a property from the current entry.
@item C-c C-c D @orgcmd{C-c C-c D,org-delete-property-globally}
Globally remove a property, from all entries in the current file. Globally remove a property, from all entries in the current file.
@item C-c C-c c @orgcmd{C-c C-c c,org-compute-property-at-point}
Compute the property at point, using the operator and scope from the Compute the property at point, using the operator and scope from the
nearest column format definition. nearest column format definition.
@end table @end table
@ -4756,18 +4735,13 @@ ITEM @r{The content of the entry.}
To create sparse trees and special lists with selection based on properties, To create sparse trees and special lists with selection based on properties,
the same commands are used as for tag searches (@pxref{Tag searches}). the same commands are used as for tag searches (@pxref{Tag searches}).
@table @kbd @table @kbd
@kindex C-c \ @orgcmdkkc{C-c / m,C-c \,org-match-sparse-tree}
@kindex C-c / m
@item C-c \
@itemx C-c / m
Create a sparse tree with all matching entries. With a Create a sparse tree with all matching entries. With a
@kbd{C-u} prefix argument, ignore headlines that are not a TODO line. @kbd{C-u} prefix argument, ignore headlines that are not a TODO line.
@kindex C-c a m @orgcmd{C-c a m,org-tags-view}
@item C-c a m
Create a global list of tag/property matches from all agenda files. Create a global list of tag/property matches from all agenda files.
@xref{Matching tags and properties}. @xref{Matching tags and properties}.
@kindex C-c a M @orgcmd{C-c a M,org-tags-view}
@item C-c a M
@vindex org-tags-match-list-sublevels @vindex org-tags-match-list-sublevels
Create a global list of tag matches from all agenda files, but check Create a global list of tag matches from all agenda files, but check
only TODO items and force checking of subitems (see variable only TODO items and force checking of subitems (see variable
@ -4781,8 +4755,7 @@ There is also a special command for creating sparse trees based on a
single property: single property:
@table @kbd @table @kbd
@kindex C-c / p @orgkey{C-c / p}
@item C-c / p
Create a sparse tree based on the value of a property. This first Create a sparse tree based on the value of a property. This first
prompts for the name of a property, and then for a value. A sparse tree prompts for the name of a property, and then for a value. A sparse tree
is created with all entries that define this property with the given is created with all entries that define this property with the given
@ -4993,8 +4966,7 @@ in the subtree.
@table @kbd @table @kbd
@tsubheading{Turning column view on and off} @tsubheading{Turning column view on and off}
@kindex C-c C-x C-c @orgcmd{C-c C-x C-c,org-columns}
@item C-c C-x C-c
@vindex org-columns-default-format @vindex org-columns-default-format
Turn on column view. If the cursor is before the first headline in the file, Turn on column view. If the cursor is before the first headline in the file,
column view is turned on for the entire file, using the @code{#+COLUMNS} column view is turned on for the entire file, using the @code{#+COLUMNS}
@ -5005,14 +4977,11 @@ for the tree starting at the entry that contains the @code{:COLUMNS:}
property. If no such property is found, the format is taken from the property. If no such property is found, the format is taken from the
@code{#+COLUMNS} line or from the variable @code{org-columns-default-format}, @code{#+COLUMNS} line or from the variable @code{org-columns-default-format},
and column view is established for the current entry and its subtree. and column view is established for the current entry and its subtree.
@kindex r @orgcmd{r,org-columns-redo}
@item r
Recreate the column view, to include recent changes made in the buffer. Recreate the column view, to include recent changes made in the buffer.
@kindex g @orgcmd{g,org-columns-redo}
@item g
Same as @kbd{r}. Same as @kbd{r}.
@kindex q @orgcmd{q,org-columns-quit}
@item q
Exit column view. Exit column view.
@tsubheading{Editing values} @tsubheading{Editing values}
@item @key{left} @key{right} @key{up} @key{down} @item @key{left} @key{right} @key{up} @key{down}
@ -5024,39 +4993,29 @@ Switch to the next/previous allowed value of the field. For this, you
have to have specified allowed values for a property. have to have specified allowed values for a property.
@item 1..9,0 @item 1..9,0
Directly select the nth allowed value, @kbd{0} selects the 10th value. Directly select the nth allowed value, @kbd{0} selects the 10th value.
@kindex n @orgcmdkkcc{n,p,org-columns-next-allowed-value,org-columns-previous-allowed-value}
@kindex p
@itemx n / p
Same as @kbd{S-@key{left}/@key{right}} Same as @kbd{S-@key{left}/@key{right}}
@kindex e @orgcmd{e,org-columns-edit-value}
@item e
Edit the property at point. For the special properties, this will Edit the property at point. For the special properties, this will
invoke the same interface that you normally use to change that invoke the same interface that you normally use to change that
property. For example, when editing a TAGS property, the tag completion property. For example, when editing a TAGS property, the tag completion
or fast selection interface will pop up. or fast selection interface will pop up.
@kindex C-c C-c @orgcmd{C-c C-c,org-columns-set-tags-or-toggle}
@item C-c C-c
When there is a checkbox at point, toggle it. When there is a checkbox at point, toggle it.
@kindex v @orgcmd{v,org-columns-show-value}
@item v
View the full value of this property. This is useful if the width of View the full value of this property. This is useful if the width of
the column is smaller than that of the value. the column is smaller than that of the value.
@kindex a @orgcmd{a,org-columns-edit-allowed}
@item a
Edit the list of allowed values for this property. If the list is found Edit the list of allowed values for this property. If the list is found
in the hierarchy, the modified values is stored there. If no list is in the hierarchy, the modified values is stored there. If no list is
found, the new value is stored in the first entry that is part of the found, the new value is stored in the first entry that is part of the
current column view. current column view.
@tsubheading{Modifying the table structure} @tsubheading{Modifying the table structure}
@kindex < @orgcmdkkcc{<,>,org-columns-narrow,org-columns-widen}
@kindex >
@item < / >
Make the column narrower/wider by one character. Make the column narrower/wider by one character.
@kindex S-M-@key{right} @orgcmd{S-M-@key{right},org-columns-new}
@item S-M-@key{right}
Insert a new column, to the left of the current column. Insert a new column, to the left of the current column.
@kindex S-M-@key{left} @orgcmd{S-M-@key{left},org-columns-delete}
@item S-M-@key{left}
Delete the current column. Delete the current column.
@end table @end table
@ -5112,20 +5071,16 @@ column view is @code{ITEM}.
The following commands insert or update the dynamic block: The following commands insert or update the dynamic block:
@table @kbd @table @kbd
@kindex C-c C-x i @orgcmd{C-c C-x i,org-insert-columns-dblock}
@item C-c C-x i
Insert a dynamic block capturing a column view. You will be prompted Insert a dynamic block capturing a column view. You will be prompted
for the scope or ID of the view. for the scope or ID of the view.
@kindex C-c C-c @orgcmdkkc{C-c C-c,C-c C-x C-u,org-dblock-update}
@item C-c C-c
@kindex C-c C-x C-u
@itemx C-c C-x C-u
Update dynamic block at point. The cursor needs to be in the Update dynamic block at point. The cursor needs to be in the
@code{#+BEGIN} line of the dynamic block. @code{#+BEGIN} line of the dynamic block.
@kindex C-u C-c C-x C-u @orgcmd{C-u C-c C-x C-u,org-update-all-dblocks}
@item C-u C-c C-x C-u
Update all dynamic blocks (@pxref{Dynamic blocks}). This is useful if Update all dynamic blocks (@pxref{Dynamic blocks}). This is useful if
you have several clock table blocks in a buffer. you have several clock table blocks, column-capturing blocks or other dynamic
blocks in a buffer.
@end table @end table
You can add formulas to the column view table and you may add plotting You can add formulas to the column view table and you may add plotting

2
lisp/org.el
View file

@ -10463,6 +10463,7 @@ blocks in the buffer."
"Update the dynamic block at point. "Update the dynamic block at point.
This means to empty the block, parse for parameters and then call This means to empty the block, parse for parameters and then call
the correct writing function." the correct writing function."
(interactive)
(save-window-excursion (save-window-excursion
(let* ((pos (point)) (let* ((pos (point))
(line (org-current-line)) (line (org-current-line))
@ -10504,6 +10505,7 @@ Error if there is no such block at point."
(defun org-update-all-dblocks () (defun org-update-all-dblocks ()
"Update all dynamic blocks in the buffer. "Update all dynamic blocks in the buffer.
This function can be used in a hook." This function can be used in a hook."
(interactive)
(when (org-mode-p) (when (org-mode-p)
(org-map-dblocks 'org-update-dblock))) (org-map-dblocks 'org-update-dblock)))