summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBastien <bzg@gnu.org>2020-09-06 07:52:28 +0200
committerBastien <bzg@gnu.org>2020-09-06 07:52:28 +0200
commit9410fbe0606a53b0582cc175b2cc525d556b23fe (patch)
treeb48919371a0c957fa2f49304ce8bfd2ced1be10e
parentd4f48821c1e01f68ad9f5157a61e0ae5cce6b00d (diff)
parent351a0a0b0c176ffb3564f225030252db4c1c4a7a (diff)
downloadorg-mode-9410fbe0606a53b0582cc175b2cc525d556b23fe.tar.gz
Merge branch 'maint'
-rw-r--r--doc/org-manual.org227
1 files changed, 113 insertions, 114 deletions
diff --git a/doc/org-manual.org b/doc/org-manual.org
index faf5435..46498bd 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -6043,26 +6043,26 @@ can control the calendar fully from the minibuffer:
#+kindex: .
#+kindex: C-.
#+attr_texinfo: :columns 0.25 0.55
-| {{{kbd(RET)}}} | Choose date at point in calendar. |
-| {{{kbd(mouse-1)}}} | Select date by clicking on it. |
-| {{{kbd(S-RIGHT)}}} | One day forward. |
-| {{{kbd(S-LEFT)}}} | One day backward. |
-| {{{kbd(S-DOWN)}}} | One week forward. |
-| {{{kbd(S-UP)}}} | One week backward. |
-| {{{kbd(M-S-RIGHT)}}} | One month forward. |
-| {{{kbd(M-S-LEFT)}}} | One month backward. |
-| {{{kbd(>)}}} | Scroll calendar forward by one month. |
-| {{{kbd(<)}}} | Scroll calendar backward by one month. |
-| {{{kbd(M-v)}}} | Scroll calendar forward by 3 months. |
-| {{{kbd(C-v)}}} | Scroll calendar backward by 3 months. |
-| {{{kbd(.)}}} or {{{kbd(C-.)}}} | Select today's date |
+| {{{kbd(RET)}}} | Choose date at point in calendar. |
+| {{{kbd(mouse-1)}}} | Select date by clicking on it. |
+| {{{kbd(S-RIGHT)}}} | One day forward. |
+| {{{kbd(S-LEFT)}}} | One day backward. |
+| {{{kbd(S-DOWN)}}} | One week forward. |
+| {{{kbd(S-UP)}}} | One week backward. |
+| {{{kbd(M-S-RIGHT)}}} | One month forward. |
+| {{{kbd(M-S-LEFT)}}} | One month backward. |
+| {{{kbd(>)}}} | Scroll calendar forward by one month. |
+| {{{kbd(<)}}} | Scroll calendar backward by one month. |
+| {{{kbd(M-v)}}} | Scroll calendar forward by 3 months. |
+| {{{kbd(C-v)}}} | Scroll calendar backward by 3 months. |
+| {{{kbd(C-.)}}} | Select today's date[fn:63] |
#+vindex: org-read-date-display-live
The actions of the date/time prompt may seem complex, but I assure you
they will grow on you, and you will start getting annoyed by pretty
much any other way of entering a date/time out there. To help you
understand what is going on, the current interpretation of your input
-is displayed live in the minibuffer[fn:63].
+is displayed live in the minibuffer[fn:64].
*** Custom time format
:PROPERTIES:
@@ -6154,7 +6154,7 @@ immediately after the task they refer to.
date.
#+vindex: org-agenda-skip-scheduled-if-done
- The headline is listed under the given date[fn:64]. In addition,
+ The headline is listed under the given date[fn:65]. In addition,
a reminder that the scheduled date has passed is present in the
compilation for /today/, until the entry is marked as done, i.e.,
the task is automatically forwarded until completed.
@@ -6206,7 +6206,7 @@ expression entry matches.
:END:
The following commands allow you to quickly insert a deadline or to
-schedule an item:[fn:65]
+schedule an item:[fn:66]
- {{{kbd(C-c C-d)}}} (~org-deadline~) ::
@@ -6218,7 +6218,7 @@ schedule an item:[fn:65]
timestamp . When called with a prefix argument, also remove any
existing deadline from the entry. Depending on the variable
~org-log-redeadline~, take a note when changing an existing
- deadline[fn:66].
+ deadline[fn:67].
- {{{kbd(C-c C-s)}}} (~org-schedule~) ::
@@ -6230,7 +6230,7 @@ schedule an item:[fn:65]
=CLOSED= timestamp. When called with a prefix argument, also remove
the scheduling date from the entry. Depending on the variable
~org-log-reschedule~, take a note when changing an existing
- scheduling time[fn:67].
+ scheduling time[fn:68].
- {{{kbd(C-c / d)}}} (~org-check-deadlines~) ::
@@ -6270,7 +6270,7 @@ any current timestamp.
Some tasks need to be repeated again and again. Org mode helps to
organize such tasks using a so-called repeater in a =DEADLINE=,
-=SCHEDULED=, or plain timestamps[fn:68]. In the following example:
+=SCHEDULED=, or plain timestamps[fn:69]. In the following example:
#+begin_example
,** TODO Pay the rent
@@ -6298,7 +6298,7 @@ then also the /next/ instance of the repeated entry will not be
active. Org mode deals with this in the following way: when you try
to mark such an entry as done, using {{{kbd(C-c C-t)}}}, it shifts the
base date of the repeating timestamp by the repeater interval, and
-immediately sets the entry state back to TODO[fn:69]. In the example
+immediately sets the entry state back to TODO[fn:70]. In the example
above, setting the state to =DONE= would actually switch the date like
this:
@@ -6311,7 +6311,7 @@ To mark a task with a repeater as DONE, use {{{kbd(C-- 1 C-c C-t)}}},
i.e., ~org-todo~ with a numeric prefix argument of =-1=.
#+vindex: org-log-repeat
-A timestamp[fn:70] is added under the deadline, to keep a record that
+A timestamp[fn:71] is added under the deadline, to keep a record that
you actually acted on the previous instance of this deadline.
As a consequence of shifting the base date, this entry is no longer
@@ -6381,7 +6381,7 @@ a project. When you start working on an item, you can start the
clock. When you stop working on that task, or when you mark the task
done, the clock is stopped and the corresponding time interval is
recorded. It also computes the total time spent on each
-subtree[fn:71] of a project. And it remembers a history or tasks
+subtree[fn:72] of a project. And it remembers a history or tasks
recently clocked, so that you can jump quickly between a number of
tasks absorbing your time.
@@ -6394,7 +6394,7 @@ To save the clock history across Emacs sessions, use:
#+vindex: org-clock-persist
When you clock into a new task after resuming Emacs, the incomplete
-clock[fn:72] is retrieved (see [[*Resolving idle time]]) and you are
+clock[fn:73] is retrieved (see [[*Resolving idle time]]) and you are
prompted about what to do with it.
*** Clocking commands
@@ -6432,14 +6432,14 @@ prompted about what to do with it.
the mode line, along with the title of the task. The clock time
shown is all time ever clocked for this task and its children. If
the task has an effort estimate (see [[*Effort Estimates]]), the mode
- line displays the current clocking time against it[fn:73]. If the
+ line displays the current clocking time against it[fn:74]. If the
task is a repeating one (see [[*Repeated tasks]]), show only the time
- since the last reset of the task[fn:74]. You can exercise more
+ since the last reset of the task[fn:75]. You can exercise more
control over show time with the =CLOCK_MODELINE_TOTAL= property. It
may have the values =current= to show only the current clocking
instance, =today= to show all time clocked on this tasks today---see
also the variable ~org-extend-today-until~, ~all~ to include all
- time, or ~auto~ which is the default[fn:75]. Clicking with
+ time, or ~auto~ which is the default[fn:76]. Clicking with
{{{kbd(mouse-1)}}} onto the mode line entry pops up a menu with
clocking options.
@@ -6453,7 +6453,7 @@ prompted about what to do with it.
computes the resulting time in inserts it after the time range as
==>HH:MM=. See the variable ~org-log-note-clock-out~ for the
possibility to record an additional note together with the clock-out
- timestamp[fn:76].
+ timestamp[fn:77].
- {{{kbd(C-c C-x C-x)}}} (~org-clock-in-last~) ::
@@ -6642,7 +6642,7 @@ be selected:
| =thisweek=, =lastweek=, =thisweek-N= | a relative week |
| =thismonth=, =lastmonth=, =thismonth-N= | a relative month |
| =thisyear=, =lastyear=, =thisyear-N= | a relative year |
- | =untilnow=[fn:77] | all clocked time ever |
+ | =untilnow=[fn:78] | all clocked time ever |
#+vindex: org-clock-display-default-range
When this option is not set, Org falls back to the value in
@@ -6704,7 +6704,7 @@ using the =:formatter= parameter.
- =:lang= ::
- Language[fn:78] to use for descriptive cells like "Task".
+ Language[fn:79] to use for descriptive cells like "Task".
- =:link= ::
@@ -6784,7 +6784,7 @@ day, you could write:
#+end_example
#+texinfo: @noindent
-To use a specific time range you could write[fn:79]
+To use a specific time range you could write[fn:80]
#+begin_example
,#+BEGIN: clocktable :tstart "<2006-08-10 Thu 10:00>"
@@ -6840,7 +6840,7 @@ current clock, or applying it to another one.
#+vindex: org-clock-x11idle-program-name
By customizing the variable ~org-clock-idle-time~ to some integer,
such as 10 or 15, Emacs can alert you when you get back to your
-computer after being idle for that many minutes[fn:80], and ask what
+computer after being idle for that many minutes[fn:81], and ask what
you want to do with the idle time. There will be a question waiting
for you when you get back, indicating how much idle time has passed
constantly updated with the current amount, as well as a set of
@@ -7009,7 +7009,7 @@ displayed.
#+vindex: org-agenda-columns-add-appointments-to-effort-sum
If you switch to column view in the daily/weekly agenda, the effort
-column summarizes the estimated work effort for each day[fn:81], and
+column summarizes the estimated work effort for each day[fn:82], and
you can use this to find space in your schedule. To get an overview
of the entire part of the day that is committed, you can set the
option ~org-agenda-columns-add-appointments-to-effort-sum~. The
@@ -7148,7 +7148,7 @@ special command:
~org-outline-path-complete-in-steps~. If you would like to be able
to create new nodes as new parents for refiling on the fly, check
the variable ~org-refile-allow-creating-parent-nodes~. When the
- variable ~org-log-refile~[fn:82] is set, a timestamp or a note is
+ variable ~org-log-refile~[fn:83] is set, a timestamp or a note is
recorded whenever an entry is refiled.
- {{{kbd(C-u C-c C-w)}}} ::
@@ -7620,7 +7620,7 @@ Now lets look at the elements of a template definition. Each entry in
- =(file+olp+datetree "filename" [ "Level 1 heading" ...])= ::
- This target[fn:83] creates a heading in a date tree[fn:84] for
+ This target[fn:84] creates a heading in a date tree[fn:85] for
today's date. If the optional outline path is given, the tree
will be built under the node it is pointing to, instead of at top
level. Check out the ~:time-prompt~ and ~:tree-type~ properties
@@ -7645,7 +7645,7 @@ Now lets look at the elements of a template definition. Each entry in
empty, an appropriate default template will be used. Otherwise this
is a string with escape codes, which will be replaced depending on
time and context of the capture call. You may also get this
- template string from a file[fn:85], or dynamically, from a function
+ template string from a file[fn:86], or dynamically, from a function
using either syntax:
: (file "/path/to/template-file")
@@ -7746,7 +7746,7 @@ Now lets look at the elements of a template definition. Each entry in
:DESCRIPTION: Filling in information about time and context.
:END:
-In the template itself, special "%-escapes"[fn:86] allow dynamic
+In the template itself, special "%-escapes"[fn:87] allow dynamic
insertion of content. The templates are expanded in the order given
here:
@@ -7873,7 +7873,7 @@ here:
After completing the template, position point here.
#+vindex: org-store-link-props
-For specific link types, the following keywords are defined[fn:87]:
+For specific link types, the following keywords are defined[fn:88]:
#+vindex: org-link-from-user-regexp
| Link type | Available keywords |
@@ -7886,7 +7886,7 @@ For specific link types, the following keywords are defined[fn:87]:
| | =%:date= (message date header field) |
| | =%:date-timestamp= (date as active timestamp) |
| | =%:date-timestamp-inactive= (date as inactive timestamp) |
-| | =%:fromto= (either "to NAME" or "from NAME")[fn:88] |
+| | =%:fromto= (either "to NAME" or "from NAME")[fn:89] |
| gnus | =%:group=, for messages also all email fields |
| w3, w3m | =%:url= |
| info | =%:file=, =%:node= |
@@ -17352,7 +17352,7 @@ they are mutually exclusive.
- =value= ::
- Default for most Babel libraries[fn:142]. Functional mode. Org
+ Default for most Babel libraries[fn:141]. Functional mode. Org
gets the value by wrapping the code in a function definition in the
language of the source block. That is why when using =:results
value=, code should execute like a function and return a value. For
@@ -17926,10 +17926,10 @@ Code blocks in the following languages are supported.
| Asymptote | =asymptote= | Lisp | =lisp= |
| Awk | =awk= | Lua | =lua= |
| C | =C= | MATLAB | =matlab= |
-| C++ | =C++=[fn:143] | Mscgen | =mscgen= |
+| C++ | =C++=[fn:142] | Mscgen | =mscgen= |
| Clojure | =clojure= | Objective Caml | =ocaml= |
| CSS | =css= | Octave | =octave= |
-| D | =D=[fn:144] | Org mode | =org= |
+| D | =D=[fn:143] | Org mode | =org= |
| ditaa | =ditaa= | Oz | =oz= |
| Emacs Calc | =calc= | Perl | =perl= |
| Emacs Lisp | =emacs-lisp= | Plantuml | =plantuml= |
@@ -18060,7 +18060,7 @@ for Python and Emacs Lisp languages.
#+cindex: @samp{noweb-ref}, header argument
Source code blocks can include references to other source code blocks,
-using a noweb[fn:145] style syntax:
+using a noweb[fn:144] style syntax:
: <<CODE-BLOCK-ID>>
@@ -18571,7 +18571,7 @@ Org Tempo expands snippets to structures defined in
~org-structure-template-alist~ and ~org-tempo-keywords-alist~. For
example, {{{kbd(< s TAB)}}} creates a code block. Enable it by
customizing ~org-modules~ or add =(require 'org-tempo)= to your Emacs
-init file[fn:146].
+init file[fn:145].
#+attr_texinfo: :columns 0.1 0.9
| {{{kbd(a)}}} | =#+BEGIN_EXPORT ascii= ... =#+END_EXPORT= |
@@ -18651,7 +18651,7 @@ in the desired amount with hard spaces and hiding leading stars.
To display the buffer in the indented view, activate Org Indent minor
mode, using {{{kbd(M-x org-indent-mode)}}}. Text lines that are not
headlines are prefixed with virtual spaces to vertically align with
-the headline text[fn:147].
+the headline text[fn:146].
#+vindex: org-indent-indentation-per-level
To make more horizontal space, the headlines are shifted by two
@@ -18679,9 +18679,9 @@ use =STARTUP= keyword as follows:
It is possible to use hard spaces to achieve the indentation instead,
if the bare ASCII file should have the indented look also outside
-Emacs[fn:148]. With Org's support, you have to indent all lines to
+Emacs[fn:147]. With Org's support, you have to indent all lines to
line up with the outline headers. You would use these
-settings[fn:149]:
+settings[fn:148]:
#+begin_src emacs-lisp
(setq org-adapt-indentation t
@@ -18948,7 +18948,7 @@ changes.
#+vindex: org-startup-indented
Dynamic virtual indentation is controlled by the variable
- ~org-startup-indented~[fn:150].
+ ~org-startup-indented~[fn:149].
| =indent= | Start with Org Indent mode turned on. |
| =noindent= | Start with Org Indent mode turned off. |
@@ -19767,7 +19767,7 @@ Tags]]) only for those set in these variables.
#+vindex: org-mobile-directory
The mobile application needs access to a file directory on
-a server[fn:151] to interact with Emacs. Pass its location through
+a server[fn:150] to interact with Emacs. Pass its location through
the ~org-mobile-directory~ variable. If you can mount that directory
locally just set the variable to point to that directory:
@@ -19788,7 +19788,7 @@ With a public server, consider encrypting the files. Org also
requires OpenSSL installed on the local computer. To turn on
encryption, set the same password in the mobile application and in
Emacs. Set the password in the variable
-~org-mobile-use-encryption~[fn:152]. Note that even after the mobile
+~org-mobile-use-encryption~[fn:151]. Note that even after the mobile
application encrypts the file contents, the file name remains visible
on the file systems of the local computer, the server, and the mobile
device.
@@ -19804,15 +19804,15 @@ The command ~org-mobile-push~ copies files listed in
~org-mobile-files~ into the staging area. Files include agenda files
(as listed in ~org-agenda-files~). Customize ~org-mobile-files~ to
add other files. File names are staged with paths relative to
-~org-directory~, so all files should be inside this directory[fn:153].
+~org-directory~, so all files should be inside this directory[fn:152].
Push creates a special Org file =agendas.org= with custom agenda views
-defined by the user[fn:154].
+defined by the user[fn:153].
Finally, Org writes the file =index.org=, containing links to other
files. The mobile application reads this file first from the server
to determine what other files to download for agendas. For faster
-downloads, it is expected to only read files whose checksums[fn:155]
+downloads, it is expected to only read files whose checksums[fn:154]
have changed.
*** Pulling from the mobile application
@@ -19829,7 +19829,7 @@ data in an inbox file format, through the following steps:
1.
#+vindex: org-mobile-inbox-for-pull
- Org moves all entries found in =mobileorg.org=[fn:156] and appends
+ Org moves all entries found in =mobileorg.org=[fn:155] and appends
them to the file pointed to by the variable
~org-mobile-inbox-for-pull~. It should reside neither in the
staging area nor on the server. Each captured entry and each
@@ -20125,9 +20125,9 @@ of these strategies:
#+cindex: @LaTeX{}, and Orgtbl mode
To wrap a source table in LaTeX, use the =comment= environment
-provided by =comment.sty=[fn:157]. To activate it, put
+provided by =comment.sty=[fn:156]. To activate it, put
~\usepackage{comment}~ in the document header. Orgtbl mode inserts
-a radio table skeleton[fn:158] with the command {{{kbd(M-x
+a radio table skeleton[fn:157] with the command {{{kbd(M-x
orgtbl-insert-radio-table)}}}, which prompts for a table name. For
example, if =salesfigures= is the name, the template inserts:
@@ -20146,7 +20146,7 @@ The line =#+ORGTBL: SEND= tells Orgtbl mode to use the function
~orgtbl-to-latex~ to convert the table to LaTeX format, then insert
the table at the target (receive) location named =salesfigures=. Now
the table is ready for data entry. It can even use spreadsheet
-features[fn:159]:
+features[fn:158]:
#+begin_example
% BEGIN RECEIVE ORGTBL salesfigures
@@ -20362,7 +20362,7 @@ Dynamic blocks, like any other block, can be narrowed with
#+vindex: org-agenda-skip-function
#+vindex: org-agenda-skip-function-global
Org provides a special hook to further limit items in agenda views:
-~agenda~, ~agenda*~[fn:160], ~todo~, ~alltodo~, ~tags~, ~tags-todo~,
+~agenda~, ~agenda*~[fn:159], ~todo~, ~alltodo~, ~tags~, ~tags-todo~,
~tags-tree~. Specify a custom function that tests inclusion of every
matched item in the view. This function can also skip as much as is
needed.
@@ -20405,7 +20405,7 @@ meaningful string suitable for the agenda view.
#+vindex: org-agenda-skip-function
Search for entries with a limit set on levels for the custom search.
This is a general approach to creating custom searches in Org. To
-include all levels, use =LEVEL>0=[fn:161]. Then to selectively pick
+include all levels, use =LEVEL>0=[fn:160]. Then to selectively pick
the matched entries, use ~org-agenda-skip-function~, which also
accepts Lisp forms, such as ~org-agenda-skip-entry-if~ and
~org-agenda-skip-subtree-if~. For example:
@@ -21524,63 +21524,68 @@ shift the date to tomorrow.
[fn:62] If you do not need/want the calendar, configure the variable
~org-popup-calendar-for-date-prompt~.
-[fn:63] If you find this distracting, turn off the display with
+[fn:63] You can also use the calendar command {{{kbd(.)}}} to jump to
+today's date, but if you are inserting an hour specification for your
+timestamp, {{{kbd(.)}}} will then insert a dot after the hour. By contrast,
+{{{kbd(C-.)}}} will always jump to today's date.
+
+[fn:64] If you find this distracting, turn off the display with
~org-read-date-display-live~.
-[fn:64] It will still be listed on that date after it has been marked
+[fn:65] It will still be listed on that date after it has been marked
as done. If you do not like this, set the variable
~org-agenda-skip-scheduled-if-done~.
-[fn:65] The =SCHEDULED= and =DEADLINE= dates are inserted on the line
+[fn:66] The =SCHEDULED= and =DEADLINE= dates are inserted on the line
right below the headline. Do not put any text between this line and
the headline.
-[fn:66] Note the corresponding =STARTUP= options =logredeadline=,
+[fn:67] Note the corresponding =STARTUP= options =logredeadline=,
=lognoteredeadline=, and =nologredeadline=.
-[fn:67] Note the corresponding =STARTUP= options =logreschedule=,
+[fn:68] Note the corresponding =STARTUP= options =logreschedule=,
=lognotereschedule=, and =nologreschedule=.
-[fn:68] Org does not repeat inactive timestamps, however. See
+[fn:69] Org does not repeat inactive timestamps, however. See
[[*Timestamps]].
-[fn:69] In fact, the target state is taken from, in this sequence, the
+[fn:70] In fact, the target state is taken from, in this sequence, the
=REPEAT_TO_STATE= property, the variable ~org-todo-repeat-to-state~ if
it is a string, the previous TODO state if ~org-todo-repeat-to-state~
is ~t~, or the first state of the TODO state sequence.
-[fn:70] You can change this using the option ~org-log-repeat~, or the
+[fn:71] You can change this using the option ~org-log-repeat~, or the
=STARTUP= options =logrepeat=, =lognoterepeat=, and =nologrepeat=.
With =lognoterepeat=, you will also be prompted for a note.
-[fn:71] Clocking only works if all headings are indented with less
+[fn:72] Clocking only works if all headings are indented with less
than 30 stars. This is a hard-coded limitation of ~lmax~ in
~org-clock-sum~.
-[fn:72] To resume the clock under the assumption that you have worked
+[fn:73] To resume the clock under the assumption that you have worked
on this task while outside Emacs, use =(setq org-clock-persist t)=.
-[fn:73] To add an effort estimate "on the fly", hook a function doing
+[fn:74] To add an effort estimate "on the fly", hook a function doing
this to ~org-clock-in-prepare-hook~.
-[fn:74] The last reset of the task is recorded by the =LAST_REPEAT=
+[fn:75] The last reset of the task is recorded by the =LAST_REPEAT=
property.
-[fn:75] See also the variable ~org-clock-mode-line-total~.
+[fn:76] See also the variable ~org-clock-mode-line-total~.
-[fn:76] The corresponding in-buffer setting is: =#+STARTUP:
+[fn:77] The corresponding in-buffer setting is: =#+STARTUP:
lognoteclock-out=.
-[fn:77] When using ~:step~, ~untilnow~ starts from the beginning of
+[fn:78] When using ~:step~, ~untilnow~ starts from the beginning of
2003, not the beginning of time.
-[fn:78] Language terms can be set through the variable
+[fn:79] Language terms can be set through the variable
~org-clock-clocktable-language-setup~.
-[fn:79] Note that all parameters must be specified in a single
+[fn:80] Note that all parameters must be specified in a single
line---the line is broken here only to fit it into the manual.
-[fn:80] On computers using macOS, idleness is based on actual user
+[fn:81] On computers using macOS, idleness is based on actual user
idleness, not just Emacs' idle time. For X11, you can install
a utility program =x11idle.c=, available in the =contrib/scripts/=
directory of the Org Git distribution, or install the xprintidle
@@ -21588,39 +21593,35 @@ package and set it to the variable ~org-clock-x11idle-program-name~ if
you are running Debian, to get the same general treatment of idleness.
On other systems, idle time refers to Emacs idle time only.
-[fn:81] Please note the pitfalls of summing hierarchical data in
+[fn:82] Please note the pitfalls of summing hierarchical data in
a flat list (see [[*Using Column View in the Agenda]]).
-[fn:82] Note the corresponding =STARTUP= options =logrefile=,
+[fn:83] Note the corresponding =STARTUP= options =logrefile=,
=lognoterefile=, and =nologrefile=.
-[fn:83] Org used to offer four different targets for date/week tree
+[fn:84] Org used to offer four different targets for date/week tree
capture. Now, Org automatically translates these to use
~file+olp+datetree~, applying the ~:time-prompt~ and ~:tree-type~
properties. Please rewrite your date/week-tree targets using
~file+olp+datetree~ since the older targets are now deprecated.
-[fn:84] A date tree is an outline structure with years on the highest
+[fn:85] A date tree is an outline structure with years on the highest
level, months or ISO weeks as sublevels and then dates on the lowest
level. Tags are allowed in the tree structure.
-[fn:85] When the file name is not absolute, Org assumes it is relative
+[fn:86] When the file name is not absolute, Org assumes it is relative
to ~org-directory~.
-[fn:86] If you need one of these sequences literally, escape the =%=
+[fn:87] If you need one of these sequences literally, escape the =%=
with a backslash.
-[fn:87] If you define your own link types (see [[*Adding Hyperlink
+[fn:88] If you define your own link types (see [[*Adding Hyperlink
Types]]), any property you store with ~org-store-link-props~ can be
accessed in capture templates in a similar way.
-[fn:88] This is always the other, not the user. See the variable
+[fn:89] This is always the other, not the user. See the variable
~org-link-from-user-regexp~.
-[fn:89] If you move entries or Org files from one directory to
-another, you may want to configure ~org-attach-id-dir~ to contain
-an absolute path.
-
[fn:90] If the value of that variable is not a list, but a single file
name, then the list of agenda files in maintained in that external
file.
@@ -21746,9 +21747,7 @@ and =#+STARTUP: nofnadjust=.
[fn:121] The variable ~org-export-date-timestamp-format~ defines how
this timestamp are exported.
-[fn:122] For export to LaTeX format---or LaTeX-related formats such as
-Beamer---, the ~org-latex-package-alist~ variable needs further
-configuration. See [[*LaTeX specific export settings]].
+[fn:122] DEFINITION NOT FOUND.
[fn:123] At the moment, some export back-ends do not obey this
specification. For example, LaTeX export excludes every unnumbered
@@ -21817,68 +21816,64 @@ to remove code evaluation from the {{{kbd(C-c C-c)}}} key binding.
are not evaluated when they appear in a keyword (see [[*Summary of
In-Buffer Settings]]).
-[fn:142] For shell source blocks, the default is to return the output.
-If you want to enforce returning the exit status, add =:results value=
-explicitly.
-
-[fn:143] C++ language is handled in =ob-C.el=. Even though the
+[fn:142] C++ language is handled in =ob-C.el=. Even though the
identifier for such source blocks is =C++=, you activate it by loading
the C language.
-[fn:144] D language is handled in =ob-C.el=. Even though the
+[fn:143] D language is handled in =ob-C.el=. Even though the
identifier for such source blocks is =D=, you activate it by loading
the C language.
-[fn:145] For noweb literate programming details, see
+[fn:144] For noweb literate programming details, see
http://www.cs.tufts.edu/~nr/noweb/.
-[fn:146] For more information, please refer to the commentary section
+[fn:145] For more information, please refer to the commentary section
in =org-tempo.el=.
-[fn:147] Org Indent mode also sets ~wrap-prefix~ correctly for
+[fn:146] Org Indent mode also sets ~wrap-prefix~ correctly for
indenting and wrapping long lines of headlines or text. This minor
mode also handles Visual Line mode and directly applied settings
through ~word-wrap~.
-[fn:148] This works, but requires extra effort. Org Indent mode is
+[fn:147] This works, but requires extra effort. Org Indent mode is
more convenient for most applications.
-[fn:149] ~org-adapt-indentation~ can also be set to ='headline-data=,
+[fn:148] ~org-adapt-indentation~ can also be set to ='headline-data=,
in which case only data lines below the headline will be indented.
-[fn:150] Note that Org Indent mode also sets the ~wrap-prefix~
+[fn:149] Note that Org Indent mode also sets the ~wrap-prefix~
property, such that Visual Line mode (or purely setting ~word-wrap~)
wraps long lines, including headlines, correctly indented.
-[fn:151] For a server to host files, consider using a WebDAV server,
+[fn:150] For a server to host files, consider using a WebDAV server,
such as [[https://nextcloud.com][Nextcloud]]. Additional help is at this [[https://orgmode.org/worg/org-faq.html#mobileorg_webdav][FAQ entry]].
-[fn:152] If Emacs is configured for safe storing of passwords, then
+[fn:151] If Emacs is configured for safe storing of passwords, then
configure the variable ~org-mobile-encryption-password~; please read
the docstring of that variable.
-[fn:153] Symbolic links in ~org-directory~ need to have the same name
+[fn:152] Symbolic links in ~org-directory~ need to have the same name
as their targets.
-[fn:154] While creating the agendas, Org mode forces =ID= properties
+[fn:153] While creating the agendas, Org mode forces =ID= properties
on all referenced entries, so that these entries can be uniquely
identified if Org Mobile flags them for further action. To avoid
setting properties configure the variable
~org-mobile-force-id-on-agenda-items~ to ~nil~. Org mode then relies
on outline paths, assuming they are unique.
-[fn:155] Checksums are stored automatically in the file
+[fn:154] Checksums are stored automatically in the file
=checksums.dat=.
-[fn:156] The file will be empty after this operation.
+[fn:155] The file will be empty after this operation.
-[fn:157] https://www.ctan.org/pkg/comment
+[fn:156] https://www.ctan.org/pkg/comment
-[fn:158] By default this works only for LaTeX, HTML, and Texinfo.
+[fn:157] By default this works only for LaTeX, HTML, and Texinfo.
Configure the variable ~orgtbl-radio-table-templates~ to install
templates for other modes.
-[fn:159] If the =TBLFM= keyword contains an odd number of dollar
+[fn:158] If the =TBLFM= keyword contains an odd number of dollar
characters, this may cause problems with Font Lock in LaTeX mode. As
shown in the example you can fix this by adding an extra line inside
the =comment= environment that is used to balance the dollar
@@ -21886,9 +21881,13 @@ expressions. If you are using AUCTeX with the font-latex library,
a much better solution is to add the =comment= environment to the
variable ~LaTeX-verbatim-environments~.
-[fn:160] The ~agenda*~ view is the same as ~agenda~ except that it
+[fn:159] The ~agenda*~ view is the same as ~agenda~ except that it
only considers /appointments/, i.e., scheduled and deadline items that
have a time specification =[h]h:mm= in their time-stamps.
-[fn:161] Note that, for ~org-odd-levels-only~, a level number
+[fn:160] Note that, for ~org-odd-levels-only~, a level number
corresponds to order in the hierarchy, not to the number of stars.
+
+[fn:161] If you move entries or Org files from one directory to
+another, you may want to configure ~org-attach-id-dir~ to contain
+an absolute path.