Merge branch 'master' into next
This commit is contained in:
commit
6a12f65453
|
@ -95,10 +95,12 @@ Recent Emacs distributions include a packaging system which lets you
|
||||||
install Elisp libraries. You can install Org with {{{kbd(M-x
|
install Elisp libraries. You can install Org with {{{kbd(M-x
|
||||||
package-install RET org)}}}.
|
package-install RET org)}}}.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
#+attr_texinfo: :tag Important
|
||||||
*Important*: you need to do this in a session where no =.org= file has
|
#+begin_quote
|
||||||
been visited, i.e., where no Org built-in function have been loaded.
|
You need to do this in a session where no =.org= file has been
|
||||||
|
visited, i.e., where no Org built-in function have been loaded.
|
||||||
Otherwise autoload Org functions will mess up the installation.
|
Otherwise autoload Org functions will mess up the installation.
|
||||||
|
#+end_quote
|
||||||
|
|
||||||
Then, to make sure your Org configuration is taken into account,
|
Then, to make sure your Org configuration is taken into account,
|
||||||
initialize the package system with ~(package-initialize)~ in your
|
initialize the package system with ~(package-initialize)~ in your
|
||||||
|
@ -278,7 +280,6 @@ information about:
|
||||||
2. What did you expect to happen?
|
2. What did you expect to happen?
|
||||||
3. What happened instead?
|
3. What happened instead?
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
Thank you for helping to improve this program.
|
Thank you for helping to improve this program.
|
||||||
|
|
||||||
*** How to create a useful backtrace
|
*** How to create a useful backtrace
|
||||||
|
@ -418,9 +419,8 @@ example:
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+vindex: org-footnote-section
|
#+vindex: org-footnote-section
|
||||||
#+texinfo: @noindent
|
The name defined in ~org-footnote-section~ is reserved. Do not use it
|
||||||
Note that the name defined in ~org-footnote-section~ is reserved. Do
|
as a title for your own headings.
|
||||||
not use it as a title for your own headings.
|
|
||||||
|
|
||||||
Some people find the many stars too noisy and would prefer an outline
|
Some people find the many stars too noisy and would prefer an outline
|
||||||
that has whitespace followed by a single star as headline starters.
|
that has whitespace followed by a single star as headline starters.
|
||||||
|
@ -580,7 +580,6 @@ buffer:
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+cindex: @samp{VISIBILITY}, property
|
#+cindex: @samp{VISIBILITY}, property
|
||||||
#+texinfo: @noindent
|
|
||||||
Furthermore, any entries with a =VISIBILITY= property (see [[*Properties
|
Furthermore, any entries with a =VISIBILITY= property (see [[*Properties
|
||||||
and Columns]]) get their visibility adapted accordingly. Allowed values
|
and Columns]]) get their visibility adapted accordingly. Allowed values
|
||||||
for this property are =folded=, =children=, =content=, and ~all~.
|
for this property are =folded=, =children=, =content=, and ~all~.
|
||||||
|
@ -964,7 +963,6 @@ commands can be accessed through a dispatcher:
|
||||||
Jump to the previous sparse tree match in this buffer.
|
Jump to the previous sparse tree match in this buffer.
|
||||||
|
|
||||||
#+vindex: org-agenda-custom-commands
|
#+vindex: org-agenda-custom-commands
|
||||||
#+texinfo: @noindent
|
|
||||||
For frequently used sparse trees of specific search strings, you can
|
For frequently used sparse trees of specific search strings, you can
|
||||||
use the variable ~org-agenda-custom-commands~ to define fast keyboard
|
use the variable ~org-agenda-custom-commands~ to define fast keyboard
|
||||||
access to specific sparse trees. These commands will then be
|
access to specific sparse trees. These commands will then be
|
||||||
|
@ -1321,7 +1319,6 @@ yourself. This is handled by the variable ~org-footnote-auto-label~
|
||||||
and its corresponding =STARTUP= keywords. See the docstring of that
|
and its corresponding =STARTUP= keywords. See the docstring of that
|
||||||
variable for details.
|
variable for details.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
The following command handles footnotes:
|
The following command handles footnotes:
|
||||||
|
|
||||||
- {{{kbd(C-c C-x f)}}} ::
|
- {{{kbd(C-c C-x f)}}} ::
|
||||||
|
@ -1770,7 +1767,6 @@ case, you can always align manually a table:
|
||||||
#+findex: org-table-align
|
#+findex: org-table-align
|
||||||
Align the current table.
|
Align the current table.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
#+vindex: org-startup-align-all-tables
|
#+vindex: org-startup-align-all-tables
|
||||||
Setting the option ~org-startup-align-all-tables~ re-aligns all tables
|
Setting the option ~org-startup-align-all-tables~ re-aligns all tables
|
||||||
in a file upon visiting it. You can also set this option on
|
in a file upon visiting it. You can also set this option on
|
||||||
|
@ -2077,7 +2073,6 @@ a line like this example:
|
||||||
|
|
||||||
: #+CONSTANTS: c=299792458. pi=3.14 eps=2.4e-6
|
: #+CONSTANTS: c=299792458. pi=3.14 eps=2.4e-6
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
#+vindex: constants-unit-system
|
#+vindex: constants-unit-system
|
||||||
#+pindex: constants.el
|
#+pindex: constants.el
|
||||||
Also, properties (see [[*Properties and Columns]]) can be used as
|
Also, properties (see [[*Properties and Columns]]) can be used as
|
||||||
|
@ -2197,7 +2192,6 @@ variable ~org-calc-default-modes~.
|
||||||
|
|
||||||
Literal, for Lisp formulas only. See the next section.
|
Literal, for Lisp formulas only. See the next section.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
Unless you use large integer numbers or high-precision calculation and
|
Unless you use large integer numbers or high-precision calculation and
|
||||||
display for floating point numbers you may alternatively provide
|
display for floating point numbers you may alternatively provide
|
||||||
a ~printf~ format specifier to reformat the Calc result after it has
|
a ~printf~ format specifier to reformat the Calc result after it has
|
||||||
|
@ -2695,9 +2689,9 @@ Pressing {{{kbd(C-c C-c)}}} in the line of =#+TBLFM: $2=$1*2= yields:
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: @noindent
|
#+texinfo: @noindent
|
||||||
Note: If you recalculate this table, with {{{kbd(C-u C-c *)}}}, for
|
If you recalculate this table, with {{{kbd(C-u C-c *)}}}, for example,
|
||||||
example, you get the following result from applying only the first
|
you get the following result from applying only the first =TBLFM=
|
||||||
=TBLFM= keyword.
|
keyword.
|
||||||
|
|
||||||
#+begin_example
|
#+begin_example
|
||||||
| x | y |
|
| x | y |
|
||||||
|
@ -2812,12 +2806,13 @@ and makes use of these features:
|
||||||
,#+TBLFM: $6=vsum($P1..$P3)::$7=10*$Tot/$max;%.1f::$at=vmean(@-II..@-I);%.1f
|
,#+TBLFM: $6=vsum($P1..$P3)::$7=10*$Tot/$max;%.1f::$at=vmean(@-II..@-I);%.1f
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: @noindent
|
#+attr_texinfo: :tag Important
|
||||||
*Important*: please note that for these special tables, recalculating
|
#+begin_quote
|
||||||
the table with {{{kbd(C-u C-c *)}}} only affects rows that are marked
|
Please note that for these special tables, recalculating the table
|
||||||
=#= or =*=, and fields that have a formula assigned to the field
|
with {{{kbd(C-u C-c *)}}} only affects rows that are marked =#= or
|
||||||
itself. The column formulas are not applied in rows with empty first
|
=*=, and fields that have a formula assigned to the field itself. The
|
||||||
field.
|
column formulas are not applied in rows with empty first field.
|
||||||
|
#+end_quote
|
||||||
|
|
||||||
#+cindex: marking characters, tables
|
#+cindex: marking characters, tables
|
||||||
The marking characters have the following meaning:
|
The marking characters have the following meaning:
|
||||||
|
@ -3055,7 +3050,6 @@ or alternatively
|
||||||
|
|
||||||
: [[LINK]]
|
: [[LINK]]
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
Once a link in the buffer is complete (all brackets present), Org
|
Once a link in the buffer is complete (all brackets present), Org
|
||||||
changes the display so that =DESCRIPTION= is displayed instead of
|
changes the display so that =DESCRIPTION= is displayed instead of
|
||||||
=[[LINK][DESCRIPTION]]= and =LINK= is displayed instead of =[[LINK]]=. Links are be
|
=[[LINK][DESCRIPTION]]= and =LINK= is displayed instead of =[[LINK]]=. Links are be
|
||||||
|
@ -3235,7 +3229,6 @@ Format]]), for example:
|
||||||
|
|
||||||
: [[http://www.gnu.org/software/emacs/][GNU Emacs]]
|
: [[http://www.gnu.org/software/emacs/][GNU Emacs]]
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
If the description is a file name or URL that points to an image, HTML
|
If the description is a file name or URL that points to an image, HTML
|
||||||
export (see [[*HTML Export]]) inlines the image as a clickable button. If
|
export (see [[*HTML Export]]) inlines the image as a clickable button. If
|
||||||
there is no description at all and the link points to an image, that
|
there is no description at all and the link points to an image, that
|
||||||
|
@ -3545,7 +3538,6 @@ can define them in the file with
|
||||||
,#+LINK: google http://www.google.com/search?q=%s
|
,#+LINK: google http://www.google.com/search?q=%s
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
In-buffer completion (see [[*Completion]]) can be used after =[= to
|
In-buffer completion (see [[*Completion]]) can be used after =[= to
|
||||||
complete link abbreviations. You may also define a Lisp function that
|
complete link abbreviations. You may also define a Lisp function that
|
||||||
implements special (e.g., completion) support for inserting such a
|
implements special (e.g., completion) support for inserting such a
|
||||||
|
@ -3669,7 +3661,6 @@ for example:
|
||||||
|
|
||||||
: *** TODO Write letter to Sam Fortune
|
: *** TODO Write letter to Sam Fortune
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
The most important commands to work with TODO entries are:
|
The most important commands to work with TODO entries are:
|
||||||
|
|
||||||
- {{{kbd(C-c C-t)}}} (~org-todo~) ::
|
- {{{kbd(C-c C-t)}}} (~org-todo~) ::
|
||||||
|
@ -3746,7 +3737,6 @@ The most important commands to work with TODO entries are:
|
||||||
Insert a new TODO entry below the current one.
|
Insert a new TODO entry below the current one.
|
||||||
|
|
||||||
#+vindex: org-todo-state-tags-triggers
|
#+vindex: org-todo-state-tags-triggers
|
||||||
#+texinfo: @noindent
|
|
||||||
Changing a TODO state can also trigger tag changes. See the docstring
|
Changing a TODO state can also trigger tag changes. See the docstring
|
||||||
of the option ~org-todo-state-tags-triggers~ for details.
|
of the option ~org-todo-state-tags-triggers~ for details.
|
||||||
|
|
||||||
|
@ -3932,7 +3922,6 @@ anywhere in the file:
|
||||||
|
|
||||||
: #+TODO: TODO FEEDBACK VERIFY | DONE CANCELED
|
: #+TODO: TODO FEEDBACK VERIFY | DONE CANCELED
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
You may also write =#+SEQ_TODO= to be explicit about the
|
You may also write =#+SEQ_TODO= to be explicit about the
|
||||||
interpretation, but it means the same as =#+TODO=, or
|
interpretation, but it means the same as =#+TODO=, or
|
||||||
|
|
||||||
|
@ -3948,7 +3937,6 @@ A setup for using several sets in parallel would be:
|
||||||
|
|
||||||
#+cindex: completion, of option keywords
|
#+cindex: completion, of option keywords
|
||||||
#+kindex: M-TAB
|
#+kindex: M-TAB
|
||||||
#+texinfo: @noindent
|
|
||||||
To make sure you are using the correct keyword, type =#+= into the
|
To make sure you are using the correct keyword, type =#+= into the
|
||||||
buffer and then use {{{kbd(M-TAB)}}} to complete it (see [[*Completion]]).
|
buffer and then use {{{kbd(M-TAB)}}} to complete it (see [[*Completion]]).
|
||||||
|
|
||||||
|
@ -4151,7 +4139,6 @@ to record a timestamp without a note for TODO keywords configured with
|
||||||
=@=, just type {{{kbd(C-c C-c)}}} to enter a blank note when prompted.
|
=@=, just type {{{kbd(C-c C-c)}}} to enter a blank note when prompted.
|
||||||
|
|
||||||
#+vindex: org-log-done
|
#+vindex: org-log-done
|
||||||
#+texinfo: @noindent
|
|
||||||
You not only define global TODO keywords and fast access keys, but
|
You not only define global TODO keywords and fast access keys, but
|
||||||
also request that a time is recorded when the entry is set to =DONE=,
|
also request that a time is recorded when the entry is set to =DONE=,
|
||||||
and that a note is recorded when switching to =WAIT= or
|
and that a note is recorded when switching to =WAIT= or
|
||||||
|
@ -4318,7 +4305,6 @@ like this
|
||||||
: *** TODO [#A] Write letter to Sam Fortune
|
: *** TODO [#A] Write letter to Sam Fortune
|
||||||
|
|
||||||
#+vindex: org-priority-faces
|
#+vindex: org-priority-faces
|
||||||
#+texinfo: @noindent
|
|
||||||
By default, Org mode supports three priorities: =A=, =B=, and =C=.
|
By default, Org mode supports three priorities: =A=, =B=, and =C=.
|
||||||
=A= is the highest priority. An entry without a cookie is treated as
|
=A= is the highest priority. An entry without a cookie is treated as
|
||||||
equivalent if it had priority =B=. Priorities make a difference only
|
equivalent if it had priority =B=. Priorities make a difference only
|
||||||
|
@ -4488,7 +4474,6 @@ If the current outline node has an =ORDERED= property, checkboxes must
|
||||||
be checked off in sequence, and an error is thrown if you try to check
|
be checked off in sequence, and an error is thrown if you try to check
|
||||||
off a box while there are unchecked boxes above it.
|
off a box while there are unchecked boxes above it.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
The following commands work with checkboxes:
|
The following commands work with checkboxes:
|
||||||
|
|
||||||
- {{{kbd(C-c C-c)}}} (~org-toggle-checkbox~) ::
|
- {{{kbd(C-c C-c)}}} (~org-toggle-checkbox~) ::
|
||||||
|
@ -4604,7 +4589,6 @@ surrounds the entire file. Use a line like this[fn:52]
|
||||||
|
|
||||||
#+vindex: org-use-tag-inheritance
|
#+vindex: org-use-tag-inheritance
|
||||||
#+vindex: org-tags-exclude-from-inheritance
|
#+vindex: org-tags-exclude-from-inheritance
|
||||||
#+texinfo: @noindent
|
|
||||||
To limit tag inheritance to specific tags, or to turn it off entirely,
|
To limit tag inheritance to specific tags, or to turn it off entirely,
|
||||||
use the variables ~org-use-tag-inheritance~ and
|
use the variables ~org-use-tag-inheritance~ and
|
||||||
~org-tags-exclude-from-inheritance~.
|
~org-tags-exclude-from-inheritance~.
|
||||||
|
@ -4703,13 +4687,11 @@ case you can set something like:
|
||||||
(setq org-tag-alist '(("@work" . ?w) ("@home" . ?h) ("laptop" . ?l)))
|
(setq org-tag-alist '(("@work" . ?w) ("@home" . ?h) ("laptop" . ?l)))
|
||||||
#+end_src
|
#+end_src
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
If the tag is only relevant to the file you are working on, then you
|
If the tag is only relevant to the file you are working on, then you
|
||||||
can instead set the =TAGS= keyword as:
|
can instead set the =TAGS= keyword as:
|
||||||
|
|
||||||
: #+TAGS: @work(w) @home(h) @tennisclub(t) laptop(l) pc(p)
|
: #+TAGS: @work(w) @home(h) @tennisclub(t) laptop(l) pc(p)
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
The tags interface shows the available tags in a splash window. If
|
The tags interface shows the available tags in a splash window. If
|
||||||
you want to start a new line after a specific tag, insert =\n= into
|
you want to start a new line after a specific tag, insert =\n= into
|
||||||
the tag list
|
the tag list
|
||||||
|
@ -4724,7 +4706,6 @@ or write them in two lines:
|
||||||
,#+TAGS: laptop(l) pc(p)
|
,#+TAGS: laptop(l) pc(p)
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
You can also group together tags that are mutually exclusive by using
|
You can also group together tags that are mutually exclusive by using
|
||||||
braces, as in:
|
braces, as in:
|
||||||
|
|
||||||
|
@ -4734,11 +4715,9 @@ braces, as in:
|
||||||
you indicate that at most one of =@work=, =@home=, and =@tennisclub=
|
you indicate that at most one of =@work=, =@home=, and =@tennisclub=
|
||||||
should be selected. Multiple such groups are allowed.
|
should be selected. Multiple such groups are allowed.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
Do not forget to press {{{kbd(C-c C-c)}}} with point in one of these
|
Do not forget to press {{{kbd(C-c C-c)}}} with point in one of these
|
||||||
lines to activate any changes.
|
lines to activate any changes.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
To set these mutually exclusive groups in the variable
|
To set these mutually exclusive groups in the variable
|
||||||
~org-tags-alist~, you must use the dummy tags ~:startgroup~ and
|
~org-tags-alist~, you must use the dummy tags ~:startgroup~ and
|
||||||
~:endgroup~ instead of the braces. Similarly, you can use ~:newline~
|
~:endgroup~ instead of the braces. Similarly, you can use ~:newline~
|
||||||
|
@ -4806,7 +4785,6 @@ In this interface, you can also use the following special keys:
|
||||||
using expert mode, the first {{{kbd(C-c)}}} displays the
|
using expert mode, the first {{{kbd(C-c)}}} displays the
|
||||||
selection window.
|
selection window.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
This method lets you assign tags to a headline with very few keys.
|
This method lets you assign tags to a headline with very few keys.
|
||||||
With the above setup, you could clear the current tags and set
|
With the above setup, you could clear the current tags and set
|
||||||
=@home=, =laptop= and =pc= tags with just the following keys:
|
=@home=, =laptop= and =pc= tags with just the following keys:
|
||||||
|
@ -5088,7 +5066,6 @@ Note that a property can only have one entry per drawer.
|
||||||
Property values set with the global variable ~org-global-properties~
|
Property values set with the global variable ~org-global-properties~
|
||||||
can be inherited by all entries in all Org files.
|
can be inherited by all entries in all Org files.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
The following commands help to work with properties:
|
The following commands help to work with properties:
|
||||||
|
|
||||||
#+attr_texinfo: :sep ,
|
#+attr_texinfo: :sep ,
|
||||||
|
@ -5413,7 +5390,6 @@ optional. The individual parts have the following meaning:
|
||||||
| =@mean= | Arithmetic mean of ages (in days/hours/mins/seconds). |
|
| =@mean= | Arithmetic mean of ages (in days/hours/mins/seconds). |
|
||||||
| =est+= | Add low-high estimates. |
|
| =est+= | Add low-high estimates. |
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
#+vindex: org-columns-summary-types
|
#+vindex: org-columns-summary-types
|
||||||
You can also define custom summary types by setting
|
You can also define custom summary types by setting
|
||||||
~org-columns-summary-types~.
|
~org-columns-summary-types~.
|
||||||
|
@ -5605,7 +5581,6 @@ this block looks like this:
|
||||||
,#+END:
|
,#+END:
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
This dynamic block has the following parameters:
|
This dynamic block has the following parameters:
|
||||||
|
|
||||||
- =:id= ::
|
- =:id= ::
|
||||||
|
@ -5662,7 +5637,6 @@ This dynamic block has the following parameters:
|
||||||
|
|
||||||
When non-~nil~, indent each =ITEM= field according to its level.
|
When non-~nil~, indent each =ITEM= field according to its level.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
The following commands insert or update the dynamic block:
|
The following commands insert or update the dynamic block:
|
||||||
|
|
||||||
- {{{kbd(C-c C-x i)}}} (~org-insert-columns-dblock~) ::
|
- {{{kbd(C-c C-x i)}}} (~org-insert-columns-dblock~) ::
|
||||||
|
@ -6044,7 +6018,6 @@ it by customizing the variables ~org-display-custom-times~ and
|
||||||
#+findex: org-toggle-time-stamp-overlays
|
#+findex: org-toggle-time-stamp-overlays
|
||||||
Toggle the display of custom formats for dates and times.
|
Toggle the display of custom formats for dates and times.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
Org mode needs the default format for scanning, so the custom
|
Org mode needs the default format for scanning, so the custom
|
||||||
date/time format does not /replace/ the default format. Instead, it
|
date/time format does not /replace/ the default format. Instead, it
|
||||||
is put /over/ the default format using text properties. This has the
|
is put /over/ the default format using text properties. This has the
|
||||||
|
@ -6135,15 +6108,16 @@ immediately after the task they refer to.
|
||||||
~org-agenda-skip-scheduled-delay-if-deadline~ for details on how
|
~org-agenda-skip-scheduled-delay-if-deadline~ for details on how
|
||||||
to control this globally or per agenda.
|
to control this globally or per agenda.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
#+attr_texinfo: :tag Important
|
||||||
*Important:* Scheduling an item in Org mode should /not/ be
|
#+begin_quote
|
||||||
understood in the same way that we understand /scheduling
|
Scheduling an item in Org mode should /not/ be understood in the
|
||||||
a meeting/. Setting a date for a meeting is just a simple
|
same way that we understand /scheduling a meeting/. Setting
|
||||||
appointment, you should mark this entry with a simple plain
|
a date for a meeting is just a simple appointment, you should
|
||||||
timestamp, to get this item shown on the date where it applies.
|
mark this entry with a simple plain timestamp, to get this item
|
||||||
This is a frequent misunderstanding by Org users. In Org mode,
|
shown on the date where it applies. This is a frequent
|
||||||
/scheduling/ means setting a date when you want to start working
|
misunderstanding by Org users. In Org mode, /scheduling/ means
|
||||||
on an action item.
|
setting a date when you want to start working on an action item.
|
||||||
|
#+end_quote
|
||||||
|
|
||||||
You may use timestamps with repeaters in scheduling and deadline
|
You may use timestamps with repeaters in scheduling and deadline
|
||||||
entries. Org mode issues early and late warnings based on the
|
entries. Org mode issues early and late warnings based on the
|
||||||
|
@ -6248,7 +6222,7 @@ organize such tasks using a so-called repeater in a =DEADLINE=,
|
||||||
DEADLINE: <2005-10-01 Sat +1m>
|
DEADLINE: <2005-10-01 Sat +1m>
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: noindent
|
#+texinfo: @noindent
|
||||||
the =+1m= is a repeater; the intended interpretation is that the task
|
the =+1m= is a repeater; the intended interpretation is that the task
|
||||||
has a deadline on =<2005-10-01>= and repeats itself every (one) month
|
has a deadline on =<2005-10-01>= and repeats itself every (one) month
|
||||||
starting from that time. You can use yearly, monthly, weekly, daily
|
starting from that time. You can use yearly, monthly, weekly, daily
|
||||||
|
@ -6566,14 +6540,12 @@ into the buffer with the {{{kbd(C-c C-x C-r)}}} command:
|
||||||
,#+END: clocktable
|
,#+END: clocktable
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
#+vindex: org-clocktable-defaults
|
#+vindex: org-clocktable-defaults
|
||||||
The =#+BEGIN= line and specify a number of options to define the
|
The =#+BEGIN= line and specify a number of options to define the
|
||||||
scope, structure, and formatting of the report. Defaults for all
|
scope, structure, and formatting of the report. Defaults for all
|
||||||
these options can be configured in the variable
|
these options can be configured in the variable
|
||||||
~org-clocktable-defaults~.
|
~org-clocktable-defaults~.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
First there are options that determine which clock entries are to
|
First there are options that determine which clock entries are to
|
||||||
be selected:
|
be selected:
|
||||||
|
|
||||||
|
@ -6586,16 +6558,16 @@ be selected:
|
||||||
|
|
||||||
The scope to consider. This can be any of the following:
|
The scope to consider. This can be any of the following:
|
||||||
|
|
||||||
| ~nil~ | the current buffer or narrowed region |
|
| =nil= | the current buffer or narrowed region |
|
||||||
| ~file~ | the full current buffer |
|
| =file= | the full current buffer |
|
||||||
| ~subtree~ | the subtree where the clocktable is located |
|
| =subtree= | the subtree where the clocktable is located |
|
||||||
| ~treeN~ | the surrounding level N tree, for example =tree3= |
|
| =treeN= | the surrounding level N tree, for example =tree3= |
|
||||||
| ~tree~ | the surrounding level 1 tree |
|
| =tree= | the surrounding level 1 tree |
|
||||||
| ~agenda~ | all agenda files |
|
| =agenda= | all agenda files |
|
||||||
| =("file" ...)= | scan these files |
|
| =("file" ...)= | scan these files |
|
||||||
| =FUNCTION= | scan files returned by calling {{{var(FUNCTION)}}} with no argument |
|
| =FUNCTION= | scan files returned by calling {{{var(FUNCTION)}}} with no argument |
|
||||||
| ~file-with-archives~ | current file and its archives |
|
| =file-with-archives= | current file and its archives |
|
||||||
| ~agenda-with-archives~ | all agenda files, including archives |
|
| =agenda-with-archives= | all agenda files, including archives |
|
||||||
|
|
||||||
- =:block= ::
|
- =:block= ::
|
||||||
|
|
||||||
|
@ -6608,11 +6580,11 @@ be selected:
|
||||||
| =2007-W50= | ISO-week 50 in 2007 |
|
| =2007-W50= | ISO-week 50 in 2007 |
|
||||||
| =2007-Q2= | 2nd quarter in 2007 |
|
| =2007-Q2= | 2nd quarter in 2007 |
|
||||||
| =2007= | the year 2007 |
|
| =2007= | the year 2007 |
|
||||||
| ~today~, ~yesterday~, ~today-N~ | a relative day |
|
| =today=, =yesterday=, =today-N= | a relative day |
|
||||||
| ~thisweek~, ~lastweek~, ~thisweek-N~ | a relative week |
|
| =thisweek=, =lastweek=, =thisweek-N= | a relative week |
|
||||||
| ~thismonth~, ~lastmonth~, ~thismonth-N~ | a relative month |
|
| =thismonth=, =lastmonth=, =thismonth-N= | a relative month |
|
||||||
| ~thisyear~, ~lastyear~, ~thisyear-N~ | a relative year |
|
| =thisyear=, =lastyear=, =thisyear-N= | a relative year |
|
||||||
| ~untilnow~ | all clocked time ever |
|
| =untilnow= | all clocked time ever |
|
||||||
|
|
||||||
#+vindex: org-clock-display-default-range
|
#+vindex: org-clock-display-default-range
|
||||||
When this option is not set, Org falls back to the value in
|
When this option is not set, Org falls back to the value in
|
||||||
|
@ -6933,7 +6905,7 @@ time. For a specific buffer you can use:
|
||||||
,#+COLUMNS: %40ITEM(Task) %17Effort(Estimated Effort){:} %CLOCKSUM
|
,#+COLUMNS: %40ITEM(Task) %17Effort(Estimated Effort){:} %CLOCKSUM
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: noindent
|
#+texinfo: @noindent
|
||||||
#+vindex: org-global-properties
|
#+vindex: org-global-properties
|
||||||
#+vindex: org-columns-default-format
|
#+vindex: org-columns-default-format
|
||||||
or, even better, you can set up these values globally by customizing
|
or, even better, you can set up these values globally by customizing
|
||||||
|
@ -7224,7 +7196,6 @@ Now lets look at the elements of a template definition. Each entry in
|
||||||
("b" "Templates for marking stuff to buy")
|
("b" "Templates for marking stuff to buy")
|
||||||
#+end_src
|
#+end_src
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
If you do not define a template for the {{{kbd(C)}}} key, this
|
If you do not define a template for the {{{kbd(C)}}} key, this
|
||||||
key opens the Customize buffer for this complex variable.
|
key opens the Customize buffer for this complex variable.
|
||||||
|
|
||||||
|
@ -7525,7 +7496,6 @@ here:
|
||||||
|
|
||||||
After completing the template, position point here.
|
After completing the template, position point here.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
#+vindex: org-store-link-props
|
#+vindex: org-store-link-props
|
||||||
For specific link types, the following keywords are defined[fn:84]:
|
For specific link types, the following keywords are defined[fn:84]:
|
||||||
|
|
||||||
|
@ -7599,7 +7569,6 @@ your choice to an entry. You can also make children inherit the
|
||||||
attachment directory from a parent, so that an entire subtree uses the
|
attachment directory from a parent, so that an entire subtree uses the
|
||||||
same attached directory.
|
same attached directory.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
The following commands deal with attachments:
|
The following commands deal with attachments:
|
||||||
|
|
||||||
- {{{kbd(C-c C-a)}}} (~org-attach~) ::
|
- {{{kbd(C-c C-a)}}} (~org-attach~) ::
|
||||||
|
@ -8118,7 +8087,6 @@ example:
|
||||||
#+cindex: @samp{ARCHIVE}, keyword
|
#+cindex: @samp{ARCHIVE}, keyword
|
||||||
: #+ARCHIVE: %s_done::
|
: #+ARCHIVE: %s_done::
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
#+cindex: ARCHIVE, property
|
#+cindex: ARCHIVE, property
|
||||||
If you would like to have a special archive location for a single
|
If you would like to have a special archive location for a single
|
||||||
entry or a (sub)tree, give the entry an =ARCHIVE= property with the
|
entry or a (sub)tree, give the entry an =ARCHIVE= property with the
|
||||||
|
@ -8243,7 +8211,6 @@ a separate buffer. Seven different view types are provided:
|
||||||
- /custom views/ that are special searches and combinations of
|
- /custom views/ that are special searches and combinations of
|
||||||
different views.
|
different views.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
The extracted information is displayed in a special /agenda buffer/.
|
The extracted information is displayed in a special /agenda buffer/.
|
||||||
This buffer is read-only, but provides commands to visit the
|
This buffer is read-only, but provides commands to visit the
|
||||||
corresponding locations in the original Org files, and even to edit
|
corresponding locations in the original Org files, and even to edit
|
||||||
|
@ -8342,9 +8309,8 @@ scope for an extended period, use the following commands:
|
||||||
#+findex: org-agenda-remove-restriction-lock
|
#+findex: org-agenda-remove-restriction-lock
|
||||||
Remove the restriction created by {{{kbd(C-c C-x <)}}}.
|
Remove the restriction created by {{{kbd(C-c C-x <)}}}.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
When working with Speedbar, you can use the following commands in the
|
||||||
When working with =speedbar.el=, you can use the following commands in
|
Speedbar frame:
|
||||||
the Speedbar frame:
|
|
||||||
|
|
||||||
- {{{kbd(<)}}} (~org-speedbar-set-agenda-restriction~) ::
|
- {{{kbd(<)}}} (~org-speedbar-set-agenda-restriction~) ::
|
||||||
|
|
||||||
|
@ -9004,17 +8970,14 @@ this:
|
||||||
|
|
||||||
: #+CATEGORY: Thesis
|
: #+CATEGORY: Thesis
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
#+cindex: @samp{CATEGORY}, property
|
#+cindex: @samp{CATEGORY}, property
|
||||||
If you would like to have a special category for a single entry or
|
If you would like to have a special category for a single entry or
|
||||||
a (sub)tree, give the entry a =CATEGORY= property with the special
|
a (sub)tree, give the entry a =CATEGORY= property with the special
|
||||||
category you want to apply as the value.
|
category you want to apply as the value.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
The display in the agenda buffer looks best if the category is not
|
The display in the agenda buffer looks best if the category is not
|
||||||
longer than 10 characters.
|
longer than 10 characters.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
#+vindex: org-agenda-category-icon-alist
|
#+vindex: org-agenda-category-icon-alist
|
||||||
You can set up icons for category by customizing the
|
You can set up icons for category by customizing the
|
||||||
~org-agenda-category-icon-alist~ variable.
|
~org-agenda-category-icon-alist~ variable.
|
||||||
|
@ -10467,7 +10430,6 @@ the black-and-white printer. Settings specified in
|
||||||
#+texinfo: @noindent
|
#+texinfo: @noindent
|
||||||
but the settings in ~org-agenda-custom-commands~ take precedence.
|
but the settings in ~org-agenda-custom-commands~ take precedence.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
From the command line you may also use:
|
From the command line you may also use:
|
||||||
|
|
||||||
#+begin_src shell
|
#+begin_src shell
|
||||||
|
@ -11145,7 +11107,6 @@ back-ends:
|
||||||
- /texinfo/ (Texinfo format)
|
- /texinfo/ (Texinfo format)
|
||||||
- /man/ (Man page format)
|
- /man/ (Man page format)
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
Users can install libraries for additional formats from the Emacs
|
Users can install libraries for additional formats from the Emacs
|
||||||
packaging system. For easy discovery, these packages have a common
|
packaging system. For easy discovery, these packages have a common
|
||||||
naming scheme: ~ox-NAME~, where {{{var(NAME)}}} is a format. For
|
naming scheme: ~ox-NAME~, where {{{var(NAME)}}} is a format. For
|
||||||
|
@ -12677,9 +12638,8 @@ accessibility standards.
|
||||||
[[./img/a.jpg]]
|
[[./img/a.jpg]]
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: @noindent
|
The HTML export back-end copies the =http= links from the Org file
|
||||||
The HTML export back-end copies the =http= links from the Org file as
|
as-is.
|
||||||
is.
|
|
||||||
|
|
||||||
*** Math formatting in HTML export
|
*** Math formatting in HTML export
|
||||||
:PROPERTIES:
|
:PROPERTIES:
|
||||||
|
@ -12926,7 +12886,6 @@ options described below:
|
||||||
Should view-toggle buttons be everywhere? When =nil= (the
|
Should view-toggle buttons be everywhere? When =nil= (the
|
||||||
default), only one such button is present.
|
default), only one such button is present.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
#+vindex: org-infojs-options
|
#+vindex: org-infojs-options
|
||||||
#+vindex: org-export-html-use-infojs
|
#+vindex: org-export-html-use-infojs
|
||||||
You can choose default values for these options by customizing the
|
You can choose default values for these options by customizing the
|
||||||
|
@ -13366,7 +13325,6 @@ attribute to one of the following:
|
||||||
|
|
||||||
To avoid a =:float= even if using a caption.
|
To avoid a =:float= even if using a caption.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
Use the =placement= attribute to modify a floating environment's
|
Use the =placement= attribute to modify a floating environment's
|
||||||
placement.
|
placement.
|
||||||
|
|
||||||
|
@ -14881,6 +14839,35 @@ and specify the text using Texinfo code, as shown in the example:
|
||||||
[[ridt.pdf]]
|
[[ridt.pdf]]
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
|
*** Quotations in Texinfo export
|
||||||
|
:PROPERTIES:
|
||||||
|
:DESCRIPTION: Quote block attributes.
|
||||||
|
:END:
|
||||||
|
|
||||||
|
#+cindex: @samp{ATTR_TEXINFO}, keyword
|
||||||
|
You can write the text of a quotation within a quote block (see
|
||||||
|
[[*Paragraphs]]). You may also emphasize some text at the beginning of
|
||||||
|
the quotation with the =:tag= attribute.
|
||||||
|
|
||||||
|
#+begin_example
|
||||||
|
,#+ATTR_TEXINFO: :tag Warning
|
||||||
|
,#+BEGIN_QUOTE
|
||||||
|
Striking your thumb with a hammer may cause severe pain and discomfort.
|
||||||
|
,#+END_QUOTE
|
||||||
|
#+end_example
|
||||||
|
|
||||||
|
To specify the author of the quotation, use the =:author= attribute.
|
||||||
|
|
||||||
|
#+begin_example
|
||||||
|
,#+ATTR_TEXINFO: :author King Arthur
|
||||||
|
,#+BEGIN_QUOTE
|
||||||
|
The Lady of the Lake, her arm clad in the purest shimmering samite,
|
||||||
|
held aloft Excalibur from the bosom of the water, signifying by divine
|
||||||
|
providence that I, Arthur, was to carry Excalibur. That is why I am
|
||||||
|
your king.
|
||||||
|
,#+END_QUOTE
|
||||||
|
#+end_example
|
||||||
|
|
||||||
*** Special blocks in Texinfo export
|
*** Special blocks in Texinfo export
|
||||||
:PROPERTIES:
|
:PROPERTIES:
|
||||||
:DESCRIPTION: Special block attributes.
|
:DESCRIPTION: Special block attributes.
|
||||||
|
@ -15310,10 +15297,9 @@ functions:
|
||||||
Convert the selected region into Markdown.
|
Convert the selected region into Markdown.
|
||||||
|
|
||||||
In-place conversions are particularly handy for quick conversion of
|
In-place conversions are particularly handy for quick conversion of
|
||||||
tables and lists in foreign buffers. For example, turn on the minor
|
tables and lists in foreign buffers. For example, in an HTML buffer,
|
||||||
mode {{{kbd(M-x orgstruct-mode)}}} in an HTML buffer, then use the
|
write a list in Org syntax, select it, and convert it to HTML with
|
||||||
convenient Org keyboard commands to create a list, select it, and
|
{{{kbd(M-x org-html-convert-region-to-html)}}}.
|
||||||
covert it to HTML with {{{kbd(M-x org-html-convert-region-to-html)}}}.
|
|
||||||
|
|
||||||
* Publishing
|
* Publishing
|
||||||
:PROPERTIES:
|
:PROPERTIES:
|
||||||
|
@ -18881,7 +18867,6 @@ uses only one star and indents text to line with the heading:
|
||||||
,* Another top level headline | * Another top level headline
|
,* Another top level headline | * Another top level headline
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
#+cindex: Indent mode
|
#+cindex: Indent mode
|
||||||
#+findex: org-indent-mode
|
#+findex: org-indent-mode
|
||||||
To turn this mode on, use the minor mode, ~org-indent-mode~. Text
|
To turn this mode on, use the minor mode, ~org-indent-mode~. Text
|
||||||
|
@ -18944,7 +18929,6 @@ headings as shown in examples below.
|
||||||
...
|
...
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
#+vindex: org-hide, face
|
#+vindex: org-hide, face
|
||||||
Because Org makes the font color the same as the background color
|
Because Org makes the font color the same as the background color
|
||||||
to hide to stars, sometimes ~org-hide~ face may need tweaking to
|
to hide to stars, sometimes ~org-hide~ face may need tweaking to
|
||||||
|
@ -19334,7 +19318,6 @@ locally just set the variable to point to that directory:
|
||||||
(setq org-mobile-directory "~/orgmobile/")
|
(setq org-mobile-directory "~/orgmobile/")
|
||||||
#+end_src
|
#+end_src
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
Alternatively, by using TRAMP (see [[info:tramp][TRAMP User Manual]]),
|
Alternatively, by using TRAMP (see [[info:tramp][TRAMP User Manual]]),
|
||||||
~org-mobile-directory~ may point to a remote directory accessible
|
~org-mobile-directory~ may point to a remote directory accessible
|
||||||
through, for example, SSH and SCP:
|
through, for example, SSH and SCP:
|
||||||
|
@ -19676,7 +19659,6 @@ If the mode is C, then:
|
||||||
/* END RECEIVE ORGTBL table_name */
|
/* END RECEIVE ORGTBL table_name */
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
At the location of source, Org needs a special line to direct Orgtbl
|
At the location of source, Org needs a special line to direct Orgtbl
|
||||||
to translate and to find the target for inserting the translated
|
to translate and to find the target for inserting the translated
|
||||||
table. For example:
|
table. For example:
|
||||||
|
@ -19705,7 +19687,6 @@ called:
|
||||||
translator function, which then skips columns as specified in
|
translator function, which then skips columns as specified in
|
||||||
=skipcols=.
|
=skipcols=.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
To keep the source table intact in the buffer without being disturbed
|
To keep the source table intact in the buffer without being disturbed
|
||||||
when the source file is compiled or otherwise being worked on, use one
|
when the source file is compiled or otherwise being worked on, use one
|
||||||
of these strategies:
|
of these strategies:
|
||||||
|
@ -19765,7 +19746,6 @@ features[fn:154]:
|
||||||
\end{comment}
|
\end{comment}
|
||||||
#+end_example
|
#+end_example
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
After editing, {{{kbd(C-c C-c)}}} inserts the translated table at the
|
After editing, {{{kbd(C-c C-c)}}} inserts the translated table at the
|
||||||
target location, between the two marker lines.
|
target location, between the two marker lines.
|
||||||
|
|
||||||
|
@ -20183,7 +20163,6 @@ with the following fields:
|
||||||
- priority-l :: The priority letter if any was given
|
- priority-l :: The priority letter if any was given
|
||||||
- priority-n :: The computed numerical priority
|
- priority-n :: The computed numerical priority
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
If the selection of the agenda item was based on a timestamp,
|
If the selection of the agenda item was based on a timestamp,
|
||||||
including those items with =DEADLINE= and =SCHEDULED= keywords, then
|
including those items with =DEADLINE= and =SCHEDULED= keywords, then
|
||||||
Org includes date and time in the output.
|
Org includes date and time in the output.
|
||||||
|
@ -20532,7 +20511,6 @@ Before I get to this list, a few special mentions are in order:
|
||||||
Org using an Info-like or a folding interface with single-key
|
Org using an Info-like or a folding interface with single-key
|
||||||
navigation.
|
navigation.
|
||||||
|
|
||||||
#+texinfo: @noindent
|
|
||||||
See below for the full list of contributions! Again, please let me
|
See below for the full list of contributions! Again, please let me
|
||||||
know what I am missing here!
|
know what I am missing here!
|
||||||
|
|
||||||
|
|
|
@ -1238,7 +1238,7 @@ the default behavior."
|
||||||
(org-with-point-at selected-task
|
(org-with-point-at selected-task
|
||||||
(unless selected-task (org-back-to-heading t))
|
(unless selected-task (org-back-to-heading t))
|
||||||
(when (and (eq (marker-buffer org-clock-hd-marker)
|
(when (and (eq (marker-buffer org-clock-hd-marker)
|
||||||
(buffer-base-buffer))
|
(org-base-buffer (current-buffer)))
|
||||||
(= (point) (marker-position org-clock-hd-marker))
|
(= (point) (marker-position org-clock-hd-marker))
|
||||||
(equal org-clock-current-task (org-get-heading t t t t)))
|
(equal org-clock-current-task (org-get-heading t t t t)))
|
||||||
(message "Clock continues in %S" org-clock-heading)
|
(message "Clock continues in %S" org-clock-heading)
|
||||||
|
|
|
@ -1345,11 +1345,12 @@ holding contextual information."
|
||||||
"Transcode a QUOTE-BLOCK element from Org to Texinfo.
|
"Transcode a QUOTE-BLOCK element from Org to Texinfo.
|
||||||
CONTENTS holds the contents of the block. INFO is a plist
|
CONTENTS holds the contents of the block. INFO is a plist
|
||||||
holding contextual information."
|
holding contextual information."
|
||||||
(let* ((title (org-element-property :name quote-block))
|
(let ((tag (org-export-read-attribute :attr_texinfo quote-block :tag))
|
||||||
(start-quote (concat "@quotation"
|
(author (org-export-read-attribute :attr_texinfo quote-block :author)))
|
||||||
(when title
|
(format "@quotation%s\n%s%s\n@end quotation"
|
||||||
(format " %s" title)))))
|
(if tag (concat " " tag) "")
|
||||||
(format "%s\n%s@end quotation" start-quote contents)))
|
contents
|
||||||
|
(if author (concat "\n@author " author) ""))))
|
||||||
|
|
||||||
;;;; Radio Target
|
;;;; Radio Target
|
||||||
|
|
||||||
|
|
Loading…
Reference in New Issue