diff --git a/doc/org.texi b/doc/org.texi index 38fd4b9..c699731 100644 --- a/doc/org.texi +++ b/doc/org.texi @@ -929,6 +929,8 @@ tables, @address@hidden jumps to the previous field. Show all, including drawers. @kindex C-c C-r @item C-c C-r address@hidden org-reveal +(@code{org-reveal}) Reveal context around point, showing the current entry, the following heading and the hierarchy above. Useful for working near a location that has been exposed by a sparse tree command (@pxref{Sparse trees}) or an agenda command @@ -937,9 +939,13 @@ level, all sibling headings. With double prefix arg, also show the entire subtree of the parent. @kindex C-c C-k @item C-c C-k address@hidden org-kill-note-or-show-branches +(@code{org-kill-note-or-show-branches}) Expose all the headings of the subtree, CONTENT view for just one subtree. @kindex C-c C-x b @item C-c C-x b address@hidden org-tree-to-indirect-buffer +(@code{org-tree-to-indirect-buffer}) Show the current subtree in an indirect address@hidden indirect buffer @ifinfo @@ -999,21 +1005,33 @@ The following commands jump to other headlines in the buffer. @table @kbd @kindex C-c C-n @item C-c C-n address@hidden outline-next-visible-heading +(@code{outline-next-visible-heading}) Next heading. @kindex C-c C-p @item C-c C-p address@hidden outline-previous-visible-heading +(@code{outline-previous-visible-heading}) Previous heading. @kindex C-c C-f @item C-c C-f address@hidden org-forward-same-level +(@code{org-forward-same-level}) Next heading same level. @kindex C-c C-b @item C-c C-b address@hidden org-backward-same-level +(@code{org-backward-same-level}) Previous heading same level. @kindex C-c C-u @item C-c C-u address@hidden outline-up-heading +(@code{outline-up-heading}) Backward to higher level heading. @kindex C-c C-j @item C-c C-j address@hidden org-goto +(@code{org-goto}) Jump to a different place without changing the current outline visibility. Shows the document structure in a temporary buffer, where you can use the following keys to find your destination: @@ -1107,14 +1125,20 @@ level). Move subtree down (swap with next subtree of same level). @kindex C-c C-x C-w @item C-c C-x C-w address@hidden org-cut-special +(@code{org-cut-special}) Kill subtree, i.e. remove it from buffer but save in kill ring. With a numeric prefix argument N, kill N sequential subtrees. @kindex C-c C-x M-w @item C-c C-x M-w address@hidden org-copy-special +(@code{org-copy-special}) Copy subtree to kill ring. With a numeric prefix argument N, copy the N sequential subtrees. @kindex C-c C-x C-y @item C-c C-x C-y address@hidden org-paste-special +(@code{org-paste-special}) Yank subtree from kill ring. This does modify the level of the subtree to make sure the tree fits in nicely at the yank position. The yank level can also be specified with a numeric prefix argument, or by yanking after a @@ -1135,6 +1159,8 @@ yank, it will yank previous kill items plainly, without adjustment and folding. @kindex C-c C-x c @item C-c C-x c address@hidden org-clone-subtree-with-time-shift +(@code{org-clone-subtree-with-time-shift}) Clone a subtree by making a number of sibling copies of it. You will be prompted for the number of copies to make, and you can also specify if any timestamps in the entry should be shifted. This can be useful, for example, @@ -1143,9 +1169,13 @@ more details, see the docstring of the command @code{org-clone-subtree-with-time-shift}. @kindex C-c C-w @item C-c C-w address@hidden org-refile +(@code{org-refile}) Refile entry or region to a different location. @xref{Refiling notes}. @kindex C-c ^ @item C-c ^ address@hidden org-sort +(@code{org-sort}) Sort same-level entries. When there is an active region, all entries in the region will be sorted. Otherwise the children of the current headline are sorted. The command prompts for the sorting method, which can be @@ -1164,6 +1194,8 @@ Narrow buffer to current subtree. Widen buffer to remove narrowing. @kindex C-c * @item C-c * address@hidden org-ctrl-c-star +(@code{org-ctrl-c-star}) Turn a normal line or plain list item into a headline (so that it becomes a subheading at its location). Also turn a headline into a normal line by removing the stars. If there is an active region, turn all lines in the @@ -1210,6 +1242,8 @@ commands can be accessed through a dispatcher: @table @kbd @kindex C-c / @item C-c / address@hidden org-sparse-tree +(@code{org-sparse-tree}) This prompts for an extra key to select a sparse-tree creating command. @kindex C-c / r @item C-c / r @@ -1402,12 +1436,16 @@ would imply a different hierarchy. To use the new hierarchy, break the command chain with a cursor motion or so. @kindex C-c C-c @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-c}) If there is a checkbox (@pxref{Checkboxes}) in the item line, toggle the state of the checkbox. If not, this command makes sure that all the items on this list level use the same bullet. Furthermore, if this is an ordered list, make sure the numbering is OK. @kindex C-c - @item C-c - address@hidden org-ctrl-c-minus +(@code{org-ctrl-c-minus}) Cycle the entire list level through the different itemize/enumerate bullets (@samp{-}, @samp{+}, @samp{*}, @samp{1.}, @samp{1)}). With a numeric prefix argument N, select the Nth bullet from this list. If there is an active @@ -1417,6 +1455,8 @@ list. Finally, even without an active region, a normal line will be converted into a list item. @kindex C-c * @item C-c * address@hidden org-ctrl-c-star +(@code{org-ctrl-c-star}) Turn a plain list item into a headline (so that it becomes a subheading at its location). @xref{Structure editing}, for a detailed explanation. @kindex address@hidden @@ -1428,6 +1468,8 @@ anywhere in an item line, details depending on @code{org-support-shift-select}. @kindex C-c ^ @item C-c ^ address@hidden org-sort +(@code{org-sort}) Sort the plain list. You will be prompted for the sorting method: numerically, alphabetically, by time, or by custom function. @end table @@ -1468,6 +1510,8 @@ done by state changes, use @table @kbd @kindex C-c C-z @item C-c C-z address@hidden org-add-note +(@code{org-add-note}) Add a time-stamped note to the LOGBOOK drawer. @end table @@ -1543,6 +1587,8 @@ for details. @table @kbd @kindex C-c C-x f @item C-c C-x f address@hidden org-footnote-action +(@code{org-footnote-action}) The footnote action command. When the cursor is on a footnote reference, jump to the definition. When it @@ -1587,6 +1633,8 @@ deletion. @kindex C-c C-c @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-c}) If the cursor is on a footnote reference, jump to the definition. If it is a the definition, jump back to the reference. When called at a footnote location with a prefix argument, offer the same menu as @kbd{C-c C-x f}. @@ -1697,6 +1745,8 @@ unpredictable for you, configure the variables @tsubheading{Creation and conversion} @kindex C-c | @item C-c | address@hidden org-table-create-or-convert-from-region +(@code{org-table-create-or-convert-from-region}) Convert the active region to table. If every line contains at least one TAB character, the function assumes that the material is tab separated. If every line contains a comma, comma-separated values (CSV) are assumed. @@ -1712,6 +1762,8 @@ table. But it's easier just to start typing, like @tsubheading{Re-aligning and field motion} @kindex C-c C-c @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-c}) Re-align the table without moving the cursor. @c @kindex @key{TAB} @@ -1768,6 +1820,8 @@ created below the current one. @c @kindex C-c - @item C-c - address@hidden org-ctrl-c-minus +(@code{org-ctrl-c-minus}) Insert a horizontal line below current row. With a prefix argument, the line is created above the current line. @c @@ -1778,6 +1832,8 @@ below that line. @c @kindex C-c ^ @item C-c ^ address@hidden org-sort +(@code{org-sort}) Sort the table lines in the region. The position of point indicates the column to be used for sorting, and the range of lines is the range between the nearest horizontal separator lines, or the entire table. If @@ -1791,17 +1847,23 @@ argument, alphabetic sorting will be case-sensitive. @tsubheading{Regions} @kindex C-c C-x M-w @item C-c C-x M-w address@hidden org-copy-special +(@code{org-copy-special}) Copy a rectangular region from a table to a special clipboard. Point and mark determine edge fields of the rectangle. If there is no active region, copy just the current field. The process ignores horizontal separator lines. @c @kindex C-c C-x C-w @item C-c C-x C-w address@hidden org-cut-special +(@code{org-cut-special}) Copy a rectangular region from a table to a special clipboard, and blank all fields in the rectangle. So this is the ``cut'' operation. @c @kindex C-c C-x C-y @item C-c C-x C-y address@hidden org-paste-special +(@code{org-paste-special}) Paste a rectangular region into a table. The upper left corner ends up in the current field. All involved fields will be overwritten. If the rectangle does not fit into the present table, @@ -1827,6 +1889,8 @@ field is made blank, and the content is appended to the field above. @cindex transient mark mode @kindex C-c + @item C-c + address@hidden org-table-sum +(@code{org-table-sum}) Sum the numbers in the current column, or in the rectangle defined by the active region. The result is shown in the echo area and can be inserted with @kbd{C-y}. @@ -1845,6 +1909,8 @@ increment. This key is also used by shift-selection and related modes @tsubheading{Miscellaneous} @kindex C-c ` @item C-c ` address@hidden org-table-edit-field +(@code{org-table-edit-field}) Edit the current field in a separate window. This is useful for fields that are not fully visible (@pxref{Column width and alignment}). When called with a @kbd{C-u} prefix, just make the full field visible, so that it can be @@ -1859,6 +1925,8 @@ the buffer and then converting the region to a table. Any prefix argument is passed on to the converter, which uses it to determine the separator. @item C-c | address@hidden org-table-create-or-convert-from-region +(@code{org-table-create-or-convert-from-region}) Tables can also be imported by pasting tabular text into the Org buffer, selecting the pasted text with @kbd{C-x C-x} and then using the @kbd{C-c |} command (see above under @i{Creation and conversion}). @@ -2375,6 +2443,8 @@ following command: @table @kbd @kindex C-c = @item C-c = address@hidden org-table-eval-formula +(@code{org-table-eval-formula}) Install a new formula for the current column and replace current field with the result of the formula. The command prompts for a formula, with default taken from the @samp{#+TBLFM} line, applies it to the current field and @@ -2400,6 +2470,8 @@ if possible. If you prefer to only work with the internal format (like @kindex C-c = @kindex C-u C-c = @item C-c = address@hidden org-table-eval-formula +(@code{org-table-eval-formula}) @itemx C-u C-c = Edit the formula associated with the current column/field in the minibuffer. See @ref{Column formulas}, and @ref{Field formulas}. @@ -2411,6 +2483,8 @@ can edit it directly in the field. The advantage over editing in the minibuffer is that you can use the command @kbd{C-c ?}. @kindex C-c ? @item C-c ? address@hidden org-table-field-info +(@code{org-table-field-info}) 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 @} @@ -2423,6 +2497,8 @@ force it with @kbd{C-c C-c}. Toggle the formula debugger on and off. See below. @kindex C-c ' @item C-c ' address@hidden org-edit-special +(@code{org-edit-special}) Edit all formulas for the current table in a special buffer, where 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. @@ -2433,14 +2509,20 @@ remove and add formulas, and use the following commands: @kindex C-c C-c @kindex C-x C-s @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-c}) @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 address@hidden org-set-tags-command +(@code{org-set-tags-command}) Exit the formula editor without installing changes. @kindex C-c C-r @item C-c C-r address@hidden org-reveal +(@code{org-reveal}) Toggle all references in the formula editor between standard (like @code{B3}) and internal (like @code{@@3$2}). @kindex @key{TAB} @@ -2511,6 +2593,8 @@ following commands: @table @kbd @kindex C-c * @item C-c * address@hidden org-ctrl-c-star +(@code{org-ctrl-c-star}) Recalculate the current row by first applying the stored column formulas from left to right, and all field formulas in the current row. @c @@ -3003,6 +3087,8 @@ entry referenced by the current line. @cindex completion, of links @cindex inserting links @item C-c C-l address@hidden org-insert-link +(@code{org-insert-link}) @vindex org-keep-stored-link-after-insertion Insert a address@hidden 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 @@ -3094,12 +3180,16 @@ images that do have a link description. @cindex mark ring @kindex C-c % @item C-c % address@hidden org-mark-ring-push +(@code{org-mark-ring-push}) Push the current position onto the mark ring, to be able to return easily. Commands following an internal link do this automatically. @c @cindex links, returning to @kindex C-c & @item C-c & address@hidden org-mark-ring-goto +(@code{org-mark-ring-goto}) Jump back to a recorded position. A position is recorded by the commands following internal links, and by @kbd{C-c %}. Using this command several times in direct succession moves through a ring of @@ -3109,6 +3199,8 @@ previously recorded positions. @kindex C-c C-x C-p @cindex links, finding next/previous @item C-c C-x C-n address@hidden org-next-link +(@code{org-next-link}) @itemx C-c C-x C-p 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 @@ -3310,6 +3402,8 @@ The most important commands to work with TODO entries are: @kindex C-c C-t @cindex cycling, of TODO states @item C-c C-t address@hidden org-todo +(@code{org-todo}) Rotate the TODO state of the current item among @example @@ -3637,6 +3731,8 @@ example: @table @kbd @kindex C-c C-x o @item C-c C-x o address@hidden org-toggle-ordered-property +(@code{org-toggle-ordered-property}) @vindex org-track-ordered-property-with-tag @cindex property, ORDERED Toggle the @code{ORDERED} property of the current entry. A property is used @@ -4076,11 +4172,15 @@ off a box while there are unchecked boxes above it. @table @kbd @kindex C-c C-c @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-c}) 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 intermediate state. @kindex C-c C-x C-b @item C-c C-x C-b address@hidden org-toggle-checkbox +(@code{org-toggle-checkbox}) 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 intermediate state. @@ -4102,6 +4202,8 @@ This works only if the cursor is already in a plain list item (@pxref{Plain lists}). @kindex C-c C-x o @item C-c C-x o address@hidden org-toggle-ordered-property +(@code{org-toggle-ordered-property}) @vindex org-track-ordered-property-with-tag @cindex property, ORDERED Toggle the @code{ORDERED} property of the entry, to toggle if checkboxes must @@ -4112,6 +4214,8 @@ for better visibility, customize the variable @code{org-track-ordered-property-with-tag}. @kindex C-c # @item C-c # address@hidden org-update-statistics-cookies +(@code{org-update-statistics-cookies}) 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 updated automatically if you toggle checkboxes with @kbd{C-c C-c} and make @@ -4207,6 +4311,8 @@ also a special command for inserting tags: @table @kbd @kindex C-c C-q @item C-c C-q address@hidden org-set-tags-command +(@code{org-set-tags-command}) @cindex completion, of tags @vindex org-tags-column Enter new tags for the current headline. Org-mode will either offer @@ -4218,6 +4324,8 @@ things look nice. TAGS are automatically realigned after promotion, demotion, and TODO state changes (@pxref{TODO basics}). @kindex C-c C-c @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-c}) When the cursor is in a headline, this does the same as @kbd{C-c C-q}. @end table @@ -4387,6 +4495,8 @@ information into special lists. @kindex C-c \ @kindex C-c / m @item C-c \ address@hidden org-match-sparse-tree +(@code{org-match-sparse-tree}) @itemx C-c / m 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. @@ -4502,6 +4612,8 @@ After an initial colon in a line, complete property keys. All keys used in the current file will be offered as possible completions. @kindex C-c C-x p @item C-c C-x p address@hidden org-set-property +(@code{org-set-property}) Set a property. This prompts for a property name and a value. If necessary, the property drawer is created as well. @item M-x org-insert-property-drawer @@ -4510,6 +4622,8 @@ inserted early in the entry, but after the lines with planning information like deadlines. @kindex C-c C-c @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-c}) With the cursor in a property drawer, this executes property commands. @item C-c C-c s Set a property in the current entry. Both the property and the value @@ -4580,6 +4694,8 @@ the same commands are used as for tag searches (@pxref{Tag searches}). @kindex C-c \ @kindex C-c / m @item C-c \ address@hidden org-match-sparse-tree +(@code{org-match-sparse-tree}) @itemx C-c / m Create a sparse tree with all matching entries. With a @kbd{C-u} prefix argument, ignore headlines that are not a TODO line. @@ -4816,6 +4932,8 @@ in the subtree. @tsubheading{Turning column view on and off} @kindex C-c C-x C-c @item C-c C-x C-c address@hidden org-columns +(@code{org-columns}) @vindex org-columns-default-format 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} @@ -4857,6 +4975,8 @@ property. For example, when editing a TAGS property, the tag completion or fast selection interface will pop up. @kindex C-c C-c @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-c}) When there is a checkbox at point, toggle it. @kindex v @item v @@ -4935,10 +5055,14 @@ The following commands insert or update the dynamic block: @table @kbd @kindex C-c C-x i @item C-c C-x i address@hidden org-insert-columns-dblock +(@code{org-insert-columns-dblock}) Insert a dynamic block capturing a column view. You will be prompted for the scope or ID of the view. @kindex C-c C-c @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-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 @@ -5085,6 +5209,8 @@ format. @table @kbd @kindex C-c . @item C-c . address@hidden org-time-stamp +(@code{org-time-stamp}) Prompt for a date and insert a corresponding timestamp. When the cursor is at an existing timestamp in the buffer, the command is used to modify this timestamp instead of inserting a new one. When this command is used twice in @@ -5092,6 +5218,8 @@ succession, a time range is inserted. @c @kindex C-c ! @item C-c ! address@hidden org-time-stamp-inactive +(@code{org-time-stamp-inactive}) Like @kbd{C-c .}, but insert an inactive timestamp that will not cause an agenda entry. @c @@ -5106,16 +5234,22 @@ minutes, see the option @code{org-time-stamp-rounding-minutes}. @c @kindex C-c < @item C-c < address@hidden org-date-from-calendar +(@code{org-date-from-calendar}) Insert a timestamp corresponding to the cursor date in the Calendar. @c @kindex C-c > @item C-c > address@hidden org-goto-calendar +(@code{org-goto-calendar}) Access the Emacs calendar for the current date. If there is a timestamp in the current line, go to the corresponding date instead. @c @kindex C-c C-o @item C-c C-o address@hidden org-open-at-point +(@code{org-open-at-point}) Access the agenda for the date given by the timestamp or -range at point (@pxref{Weekly/daily agenda}). @c @@ -5142,6 +5276,8 @@ related modes (@pxref{Conflicts}). @kindex C-c C-y @cindex evaluate time range @item C-c C-y address@hidden org-evaluate-time-range +(@code{org-evaluate-time-range}) Evaluate a time range by computing the difference between start and end. With a prefix argument, insert result after the time range (in a table: into the following column). @@ -5279,6 +5415,8 @@ customizing the variables @code{org-display-custom-times} and @table @kbd @kindex C-c C-x C-t @item C-c C-x C-t address@hidden org-toggle-time-stamp-overlays +(@code{org-toggle-time-stamp-overlays}) Toggle the display of custom formats for dates and times. @end table @@ -5396,6 +5534,8 @@ an item: @c @kindex C-c C-d @item C-c C-d address@hidden org-deadline +(@code{org-deadline}) Insert @samp{DEADLINE} keyword along with a stamp. The insertion will happen in the line directly following the headline. When called with a prefix arg, an existing deadline will be removed from the entry. Depending on the @@ -5407,6 +5547,8 @@ deadline. @c @kindex C-c C-s @item C-c C-s address@hidden org-schedule +(@code{org-schedule}) Insert @samp{SCHEDULED} keyword along with a stamp. The insertion will happen in the line directly following the headline. Any CLOSED timestamp will be removed. When called with a prefix argument, remove the scheduling @@ -5420,6 +5562,8 @@ scheduling time. @kindex k a @kindex k s @item C-c C-x C-k address@hidden org-mark-entry-for-agenda-action +(@code{org-mark-entry-for-agenda-action}) Mark the current entry for agenda action. After you have marked the entry like this, you can open the agenda or the calendar to find an appropriate date. With the cursor on the selected date, press @kbd{k s} or @kbd{k d} to @@ -5582,6 +5726,8 @@ show all time clocked on this tasks today (see also the variable mode line entry will pop up a menu with clocking options. @kindex C-c C-x C-o @item C-c C-x C-o address@hidden org-clock-out +(@code{org-clock-out}) @vindex org-log-note-clock-out Stop the clock (clock-out). This inserts another timestamp at the same location where the clock was last started. It also directly computes @@ -5601,19 +5747,27 @@ is only necessary if you edit the timestamps directly. If you change them with @address@hidden keys, the update is automatic. @kindex C-c C-t @item C-c C-t address@hidden org-todo +(@code{org-todo}) Changing the TODO state of an item to DONE automatically stops the clock if it is running in this same item. @kindex C-c C-x C-x @item C-c C-x C-x address@hidden org-clock-cancel +(@code{org-clock-cancel}) Cancel the current clock. This is useful if a clock was started by mistake, or if you ended up working on something else. @kindex C-c C-x C-j @item C-c C-x C-j address@hidden org-clock-goto +(@code{org-clock-goto}) Jump to the entry that contains the currently running clock. With a @kbd{C-u} prefix arg, select the target task from a list of recently clocked tasks. @kindex C-c C-x C-d @item C-c C-x C-d address@hidden org-clock-display +(@code{org-clock-display}) @vindex org-remove-highlights-with-change Display time summaries for each subtree in the current buffer. This puts overlays at the end of each headline, showing the total time @@ -5623,6 +5777,8 @@ when you change the buffer (see variable @code{org-remove-highlights-with-change}) or press @kbd{C-c C-c}. @kindex C-c C-x C-r @item C-c C-x C-r address@hidden org-clock-report +(@code{org-clock-report}) Insert a dynamic block (@pxref{Dynamic blocks}) containing a clock report as an Org-mode table into the current file. When the cursor is at an existing clock table, just update it. When called with a prefix @@ -5697,6 +5853,8 @@ A summary of the current subtree with % times would be @end example @kindex C-c C-c @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-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 @@ -5804,6 +5962,8 @@ for an entry with the following commands: @table @kbd @kindex C-c C-x e @item C-c C-x e address@hidden org-set-effort +(@code{org-set-effort}) Set the effort estimate for the current entry. With a numeric prefix argument, set it to the NTH allowed value (see below). This command is also accessible from the agenda with the @kbd{e} key. @@ -5862,11 +6022,15 @@ such a relative timer and make it easy to create timed notes. @table @kbd @kindex C-c C-x . @item C-c C-x . address@hidden org-timer +(@code{org-timer}) Insert a relative time into the buffer. The first time you use this, the timer will be started. When called with a prefix argument, the timer is restarted. @kindex C-c C-x - @item C-c C-x - address@hidden org-timer-item +(@code{org-timer-item}) Insert a description list item with the current relative time. With a prefix argument, first reset the timer to 0. @kindex address@hidden @@ -5883,6 +6047,8 @@ Stop the timer. After this, you can only start a new timer, not continue the old one. This command also removes the timer from the mode line. @kindex C-c C-x 0 @item C-c C-x 0 address@hidden org-timer-start +(@code{org-timer-start}) Reset the timer without inserting anything into the buffer. By default, the timer is reset to 0. When called with a @kbd{C-u} prefix, reset the timer to specific starting offset. The user is prompted for the offset, with a @@ -5970,17 +6136,23 @@ node. You may then insert the information you want. @kindex C-c C-c @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-c}) Once you have finished entering information into the capture buffer, @kbd{C-c C-c} will return you to the window configuration before the capture process, so that you can resume your work without further distraction. @kindex C-c C-w @item C-c C-w address@hidden org-refile +(@code{org-refile}) Finalize the capture process by refiling (@pxref{Refiling notes}) the note to a different place. @kindex C-c C-k @item C-c C-k address@hidden org-kill-note-or-show-branches +(@code{org-kill-note-or-show-branches}) Abort the capture process and return to the previous state. @end table @@ -6260,6 +6432,8 @@ directory. @kindex C-c C-a @item C-c C-a address@hidden org-attach +(@code{org-attach}) The dispatcher for commands related to the attachment system. After these keys, a list of commands is displayed and you must press an additional key to select a command: @@ -6359,10 +6533,14 @@ the following command is used: @table @kbd @kindex C-c C-x g @item C-c C-x g address@hidden org-feed-update-all +(@code{org-feed-update-all}) Collect items from the feeds configured in @code{org-feed-alist} and act upon them. @kindex C-c C-x G @item C-c C-x G address@hidden org-feed-goto-inbox +(@code{org-feed-goto-inbox}) Prompt for a feed name and go to the inbox configured for this feed. @end table @@ -6404,6 +6582,8 @@ process, you can use the following special command: @table @kbd @kindex C-c C-w @item C-c C-w address@hidden org-refile +(@code{org-refile}) @vindex org-reverse-note-order @vindex org-refile-targets @vindex org-refile-use-outline-path @@ -6454,6 +6634,8 @@ searches like the construction of agenda views fast. @table @kbd @kindex C-c C-x C-a @item C-c C-x C-a address@hidden org-archive-subtree-default +(@code{org-archive-subtree-default}) @vindex org-archive-default-command Archive the current entry using the command specified in the variable @code{org-archive-default-command}. @@ -6564,6 +6746,8 @@ The following commands help manage the ARCHIVE tag: @table @kbd @kindex C-c C-x a @item C-c C-x a address@hidden org-toggle-archive-tag +(@code{org-toggle-archive-tag}) Toggle the ARCHIVE tag for the current headline. When the tag is set, the headline changes to a shadowed face, and the subtree below it is hidden. @@ -6579,6 +6763,8 @@ level 1 trees will be checked. Cycle a tree even if it is tagged with ARCHIVE. @kindex C-c C-x A @item C-c C-x A address@hidden org-archive-to-archive-sibling +(@code{org-archive-to-archive-sibling}) Move the current entry to the @emph{Archive Sibling}. This is a sibling of the entry with the heading @samp{Archive} and the tag @samp{ARCHIVE}. The entry becomes a child of that sibling and in this way retains a lot of its @@ -6673,11 +6859,15 @@ the easiest way to maintain it is through the following commands @table @kbd @kindex C-c [ @item C-c [ address@hidden org-agenda-file-to-front +(@code{org-agenda-file-to-front}) Add current file to the list of agenda files. The file is added to the front of the list. If it was already in the list, it is moved to the front. With a prefix argument, file is added/moved to the end. @kindex C-c ] @item C-c ] address@hidden org-remove-file +(@code{org-remove-file}) Remove current file from the list of agenda files. @kindex C-, @kindex C-' @@ -6704,6 +6894,8 @@ extended period, use the following commands: @table @kbd @kindex C-c C-x < @item C-c C-x < address@hidden org-agenda-set-restriction-lock +(@code{org-agenda-set-restriction-lock}) Permanently restrict the agenda to the current subtree. When with a prefix argument, or with the cursor before the first headline in a file, the agenda scope is set to the entire file. This restriction remains in @@ -6712,6 +6904,8 @@ or @kbd{>} in the agenda dispatcher. If there is a window displaying an agenda view, the new restriction takes effect immediately. @kindex C-c C-x > @item C-c C-x > address@hidden org-agenda-remove-restriction-lock +(@code{org-agenda-remove-restriction-lock}) Remove the permanent restriction created by @kbd{C-c C-x <}. @end table @@ -7436,6 +7630,8 @@ agenda buffers can be set with the variable @c @kindex C-c C-x b @item C-c C-x b address@hidden org-tree-to-indirect-buffer +(@code{org-tree-to-indirect-buffer}) Display the entire subtree of the current item in an indirect buffer. With a numeric prefix argument N, go up to level N and then take that tree. If N is negative, go up that many levels. With a @kbd{C-u} prefix, do not remove the @@ -7443,6 +7639,8 @@ previously used indirect buffer. @kindex C-c C-o @item C-c C-o address@hidden org-open-at-point +(@code{org-open-at-point}) Follow a link in the entry. This will offer a selection of any links in the text belonging to the referenced Org node. If there is only one link, it will be followed without a selection prompt. @@ -7575,6 +7773,8 @@ IDs. @c @kindex C-c C-x C-c @item C-c C-x C-c address@hidden org-columns +(@code{org-columns}) @vindex org-columns-default-format Invoke column view (@pxref{Column view}) in the agenda buffer. The column view format is taken from the entry at point, or (if there is no entry at @@ -7585,6 +7785,8 @@ that entry would be in the original buffer (taken from a property, from a @kindex C-c C-x > @item C-c C-x > address@hidden org-agenda-remove-restriction-lock +(@code{org-agenda-remove-restriction-lock}) Remove the restriction lock on the agenda, if it is currently restricted to a file or subtree (@pxref{Agenda files}). @@ -7718,6 +7920,8 @@ variable @code{org-agenda-confirm-kill}. @c @kindex C-c C-w @item C-c C-w address@hidden org-refile +(@code{org-refile}) Refile the entry at point. @c @kindex C-c C-x C-a @@ -7730,10 +7934,14 @@ archiving command set in @code{org-archive-default-command}. When using the @c @kindex C-c C-x a @item C-c C-x a address@hidden org-toggle-archive-tag +(@code{org-toggle-archive-tag}) Toggle the ARCHIVE tag for the current headline. @c @kindex C-c C-x A @item C-c C-x A address@hidden org-archive-to-archive-sibling +(@code{org-archive-to-archive-sibling}) Move the subtree corresponding to the current entry to its @emph{archive sibling}. @c @@ -7790,14 +7998,20 @@ same location where state change notes are put. Depending on @c @kindex C-c C-a @item C-c C-a address@hidden org-attach +(@code{org-attach}) Dispatcher for all command related to attachments. @c @kindex C-c C-s @item C-c C-s address@hidden org-schedule +(@code{org-schedule}) Schedule this item, with prefix arg remove the scheduling timestamp @c @kindex C-c C-d @item C-c C-d address@hidden org-deadline +(@code{org-deadline}) Set a deadline for this item, with prefix arg remove the deadline. @c @kindex k @@ -8318,6 +8532,8 @@ collected by certain criteria. @table @kbd @kindex C-c C-x C-c @item C-c C-x C-c address@hidden org-columns +(@code{org-columns}) Turn on column view in the agenda. @end table @@ -8579,6 +8795,8 @@ start it with @samp{#+ }. Also entire subtrees starting with the word @table @kbd @kindex C-c ; @item C-c ; address@hidden org-toggle-comment +(@code{org-toggle-comment}) Toggle the COMMENT keyword at the beginning of an entry. @end table @@ -8707,6 +8925,8 @@ areas in HTML export}. @table @kbd @kindex C-c ' @item C-c ' address@hidden org-edit-special +(@code{org-edit-special}) Edit the source code example at point in its native mode. This works by switching to a temporary buffer with the source code. You need to exit by pressing @kbd{C-c '} address@hidden exit, lines starting with @samp{*} @@ -8757,6 +8977,8 @@ the selected markup. For example, to include a file as an item, use @table @kbd @kindex C-c ' @item C-c ' address@hidden org-edit-special +(@code{org-edit-special}) Visit the include file at point. @end table @@ -8979,6 +9201,8 @@ typeset expressions: @table @kbd @kindex C-c C-x C-l @item C-c C-x C-l address@hidden org-preview-latex-fragment +(@code{org-preview-latex-fragment}) Produce a preview image of the address@hidden fragment at point and overlay it over the source code. If there is no fragment at point, process all fragments in the current entry (between two headlines). When called @@ -8987,6 +9211,8 @@ two prefix arguments, or when the cursor is before the first headline, process the entire buffer. @kindex C-c C-c @item C-c C-c address@hidden org-ctrl-c-ctrl-c +(@code{org-ctrl-c-ctrl-c}) Remove the overlay preview images. @end table @@ -9253,6 +9479,8 @@ the subtrees are exported. @table @kbd @kindex C-c C-e @item C-c C-e address@hidden org-export +(@code{org-export}) @vindex org-export-run-in-background Dispatcher for export and publishing commands. Displays a help-window listing the additional key(s) needed to launch an export or publishing @@ -9971,6 +10199,8 @@ support with @table @kbd @kindex C-c C-b @item C-c C-b address@hidden org-backward-same-level +(@code{org-backward-same-level}) In @code{org-beamer-mode}, this key offers fast selection of a beamer environment or the @code{BEAMER_col} property. @end table @@ -13026,10 +13256,14 @@ these tables directly in the buffer. Instead, you need to use the command @table @kbd @kindex C-c ' @item C-c ' address@hidden org-edit-special +(@code{org-edit-special}) Edit a @file{table.el} table. Works when the cursor is in a table.el table. @c @kindex C-c ~ @item C-c ~ address@hidden org-table-create-with-table.el +(@code{org-table-create-with-table.el}) Insert a @file{table.el} table. If there is already a table at point, this command converts it between the @file{table.el} format and the Org-mode format. See the documentation string of the command @@ -13669,6 +13903,8 @@ Dynamic blocks are updated with the following commands @table @kbd @kindex C-c C-x C-u @item C-c C-x C-u address@hidden org-dblock-update +(@code{org-dblock-update}) Update dynamic block at point. @kindex C-u C-c C-x C-u @item C-u C-c C-x C-u