summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNicolas Goaziou <mail@nicolasgoaziou.fr>2018-10-07 23:16:59 +0200
committerNicolas Goaziou <mail@nicolasgoaziou.fr>2018-10-07 23:16:59 +0200
commita85ba9fb9bc7518bc0b654c79812f5606be84c58 (patch)
treeaaf7c0bb727fe0da2f8a5d7e76b0da48ba13e798
parent01061ccb063b443b8c963dc083be32d732e7fac0 (diff)
downloadorg-mode-a85ba9fb9bc7518bc0b654c79812f5606be84c58.tar.gz
org-manual: Remove unnecessary @noindent
* doc/org-manual.org (Feedback): (Headlines): (Initial visibility): (Sparse Trees): (Creating Footnotes): (Column Width and Alignment): (Named references): (Formula syntax for Calc): (Using multiple =TBLFM= lines): (Link Format): (External Links): (Link Abbreviations): (Basic TODO Functionality): (Setting up keywords for individual files): (Tracking TODO state changes): (Priorities): (Checkboxes): (Tag Inheritance): (Setting Tags): (Property Syntax): (Column attributes): (Capturing column view): (Custom time format): (The clock table): (Template elements): (Template expansion): (Attachments): (Moving a tree to an archive file): (Agenda Views): (Agenda Files): (Categories): (Exporting Agenda Views): (Exporting): (Images in HTML export): (JavaScript supported display of web pages): (Images in LaTeX export): (A Cleaner Outline View): (Setting up the staging area): (Radio tables): (A LaTeX example of radio tables): (Extracting Agenda Information): (From Carsten): Remove unnecessary @noindent.
-rw-r--r--doc/org-manual.org98
1 files changed, 22 insertions, 76 deletions
diff --git a/doc/org-manual.org b/doc/org-manual.org
index 17527c3..3500562 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -280,7 +280,6 @@ information about:
2. What did you expect to happen?
3. What happened instead?
-#+texinfo: @noindent
Thank you for helping to improve this program.
*** How to create a useful backtrace
@@ -420,9 +419,8 @@ example:
#+end_example
#+vindex: org-footnote-section
-#+texinfo: @noindent
-Note that the name defined in ~org-footnote-section~ is reserved. Do
-not use it as a title for your own headings.
+The name defined in ~org-footnote-section~ is reserved. Do not use it
+as a title for your own headings.
Some people find the many stars too noisy and would prefer an outline
that has whitespace followed by a single star as headline starters.
@@ -582,7 +580,6 @@ buffer:
#+end_example
#+cindex: @samp{VISIBILITY}, property
-#+texinfo: @noindent
Furthermore, any entries with a =VISIBILITY= property (see [[*Properties
and Columns]]) get their visibility adapted accordingly. Allowed values
for this property are =folded=, =children=, =content=, and ~all~.
@@ -966,7 +963,6 @@ commands can be accessed through a dispatcher:
Jump to the previous sparse tree match in this buffer.
#+vindex: org-agenda-custom-commands
-#+texinfo: @noindent
For frequently used sparse trees of specific search strings, you can
use the variable ~org-agenda-custom-commands~ to define fast keyboard
access to specific sparse trees. These commands will then be
@@ -1323,7 +1319,6 @@ yourself. This is handled by the variable ~org-footnote-auto-label~
and its corresponding =STARTUP= keywords. See the docstring of that
variable for details.
-#+texinfo: @noindent
The following command handles footnotes:
- {{{kbd(C-c C-x f)}}} ::
@@ -1748,7 +1743,6 @@ case, you can always align manually a table:
#+findex: org-table-align
Align the current table.
-#+texinfo: @noindent
#+vindex: org-startup-align-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
@@ -2055,7 +2049,6 @@ a line like this example:
: #+CONSTANTS: c=299792458. pi=3.14 eps=2.4e-6
-#+texinfo: @noindent
#+vindex: constants-unit-system
#+pindex: constants.el
Also, properties (see [[*Properties and Columns]]) can be used as
@@ -2175,7 +2168,6 @@ variable ~org-calc-default-modes~.
Literal, for Lisp formulas only. See the next section.
-#+texinfo: @noindent
Unless you use large integer numbers or high-precision calculation and
display for floating point numbers you may alternatively provide
a ~printf~ format specifier to reformat the Calc result after it has
@@ -2673,9 +2665,9 @@ Pressing {{{kbd(C-c C-c)}}} in the line of =#+TBLFM: $2=$1*2= yields:
#+end_example
#+texinfo: @noindent
-Note: If you recalculate this table, with {{{kbd(C-u C-c *)}}}, for
-example, you get the following result from applying only the first
-=TBLFM= keyword.
+If you recalculate this table, with {{{kbd(C-u C-c *)}}}, for example,
+you get the following result from applying only the first =TBLFM=
+keyword.
#+begin_example
| x | y |
@@ -3034,7 +3026,6 @@ or alternatively
: [[LINK]]
-#+texinfo: @noindent
Once a link in the buffer is complete (all brackets present), Org
changes the display so that =DESCRIPTION= is displayed instead of
=[[LINK][DESCRIPTION]]= and =LINK= is displayed instead of =[[LINK]]=. Links are be
@@ -3214,7 +3205,6 @@ Format]]), for example:
: [[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
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
@@ -3524,7 +3514,6 @@ can define them in the file with
,#+LINK: google http://www.google.com/search?q=%s
#+end_example
-#+texinfo: @noindent
In-buffer completion (see [[*Completion]]) can be used after =[= to
complete link abbreviations. You may also define a Lisp function that
implements special (e.g., completion) support for inserting such a
@@ -3648,7 +3637,6 @@ for example:
: *** TODO Write letter to Sam Fortune
-#+texinfo: @noindent
The most important commands to work with TODO entries are:
- {{{kbd(C-c C-t)}}} (~org-todo~) ::
@@ -3725,7 +3713,6 @@ The most important commands to work with TODO entries are:
Insert a new TODO entry below the current one.
#+vindex: org-todo-state-tags-triggers
-#+texinfo: @noindent
Changing a TODO state can also trigger tag changes. See the docstring
of the option ~org-todo-state-tags-triggers~ for details.
@@ -3911,7 +3898,6 @@ anywhere in the file:
: #+TODO: TODO FEEDBACK VERIFY | DONE CANCELED
-#+texinfo: @noindent
You may also write =#+SEQ_TODO= to be explicit about the
interpretation, but it means the same as =#+TODO=, or
@@ -3927,7 +3913,6 @@ A setup for using several sets in parallel would be:
#+cindex: completion, of option keywords
#+kindex: M-TAB
-#+texinfo: @noindent
To make sure you are using the correct keyword, type =#+= into the
buffer and then use {{{kbd(M-TAB)}}} to complete it (see [[*Completion]]).
@@ -4130,7 +4115,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.
#+vindex: org-log-done
-#+texinfo: @noindent
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=,
and that a note is recorded when switching to =WAIT= or
@@ -4297,7 +4281,6 @@ like this
: *** TODO [#A] Write letter to Sam Fortune
#+vindex: org-priority-faces
-#+texinfo: @noindent
By default, Org mode supports three priorities: =A=, =B=, and =C=.
=A= is the highest priority. An entry without a cookie is treated as
equivalent if it had priority =B=. Priorities make a difference only
@@ -4467,7 +4450,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
off a box while there are unchecked boxes above it.
-#+texinfo: @noindent
The following commands work with checkboxes:
- {{{kbd(C-c C-c)}}} (~org-toggle-checkbox~) ::
@@ -4583,7 +4565,6 @@ surrounds the entire file. Use a line like this[fn:52]
#+vindex: org-use-tag-inheritance
#+vindex: org-tags-exclude-from-inheritance
-#+texinfo: @noindent
To limit tag inheritance to specific tags, or to turn it off entirely,
use the variables ~org-use-tag-inheritance~ and
~org-tags-exclude-from-inheritance~.
@@ -4682,13 +4663,11 @@ case you can set something like:
(setq org-tag-alist '(("@work" . ?w) ("@home" . ?h) ("laptop" . ?l)))
#+end_src
-#+texinfo: @noindent
If the tag is only relevant to the file you are working on, then you
can instead set the =TAGS= keyword as:
: #+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
you want to start a new line after a specific tag, insert =\n= into
the tag list
@@ -4703,7 +4682,6 @@ or write them in two lines:
,#+TAGS: laptop(l) pc(p)
#+end_example
-#+texinfo: @noindent
You can also group together tags that are mutually exclusive by using
braces, as in:
@@ -4713,11 +4691,9 @@ braces, as in:
you indicate that at most one of =@work=, =@home=, and =@tennisclub=
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
lines to activate any changes.
-#+texinfo: @noindent
To set these mutually exclusive groups in the variable
~org-tags-alist~, you must use the dummy tags ~:startgroup~ and
~:endgroup~ instead of the braces. Similarly, you can use ~:newline~
@@ -4785,7 +4761,6 @@ In this interface, you can also use the following special keys:
using expert mode, the first {{{kbd(C-c)}}} displays the
selection window.
-#+texinfo: @noindent
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
=@home=, =laptop= and =pc= tags with just the following keys:
@@ -5067,7 +5042,6 @@ Note that a property can only have one entry per drawer.
Property values set with the global variable ~org-global-properties~
can be inherited by all entries in all Org files.
-#+texinfo: @noindent
The following commands help to work with properties:
#+attr_texinfo: :sep ,
@@ -5392,7 +5366,6 @@ optional. The individual parts have the following meaning:
| =@mean= | Arithmetic mean of ages (in days/hours/mins/seconds). |
| =est+= | Add low-high estimates. |
- #+texinfo: @noindent
#+vindex: org-columns-summary-types
You can also define custom summary types by setting
~org-columns-summary-types~.
@@ -5584,7 +5557,6 @@ this block looks like this:
,#+END:
#+end_example
-#+texinfo: @noindent
This dynamic block has the following parameters:
- =:id= ::
@@ -5636,7 +5608,6 @@ This dynamic block has the following parameters:
When non-~nil~, indent each =ITEM= field according to its level.
-#+texinfo: @noindent
The following commands insert or update the dynamic block:
- {{{kbd(C-c C-x i)}}} (~org-insert-columns-dblock~) ::
@@ -6018,7 +5989,6 @@ it by customizing the variables ~org-display-custom-times~ and
#+findex: org-toggle-time-stamp-overlays
Toggle the display of custom formats for dates and times.
-#+texinfo: @noindent
Org mode needs the default format for scanning, so the custom
date/time format does not /replace/ the default format. Instead, it
is put /over/ the default format using text properties. This has the
@@ -6541,14 +6511,12 @@ into the buffer with the {{{kbd(C-c C-x C-r)}}} command:
,#+END: clocktable
#+end_example
-#+texinfo: @noindent
#+vindex: org-clocktable-defaults
The =#+BEGIN= line and specify a number of options to define the
scope, structure, and formatting of the report. Defaults for all
these options can be configured in the variable
~org-clocktable-defaults~.
-#+texinfo: @noindent
First there are options that determine which clock entries are to
be selected:
@@ -6561,16 +6529,16 @@ be selected:
The scope to consider. This can be any of the following:
- | ~nil~ | the current buffer or narrowed region |
- | ~file~ | the full current buffer |
- | ~subtree~ | the subtree where the clocktable is located |
- | ~treeN~ | the surrounding level N tree, for example =tree3= |
- | ~tree~ | the surrounding level 1 tree |
- | ~agenda~ | all agenda files |
+ | =nil= | the current buffer or narrowed region |
+ | =file= | the full current buffer |
+ | =subtree= | the subtree where the clocktable is located |
+ | =treeN= | the surrounding level N tree, for example =tree3= |
+ | =tree= | the surrounding level 1 tree |
+ | =agenda= | all agenda files |
| =("file" ...)= | scan these files |
| =FUNCTION= | scan files returned by calling {{{var(FUNCTION)}}} with no argument |
- | ~file-with-archives~ | current file and its archives |
- | ~agenda-with-archives~ | all agenda files, including archives |
+ | =file-with-archives= | current file and its archives |
+ | =agenda-with-archives= | all agenda files, including archives |
- =:block= ::
@@ -6583,11 +6551,11 @@ be selected:
| =2007-W50= | ISO-week 50 in 2007 |
| =2007-Q2= | 2nd quarter in 2007 |
| =2007= | the year 2007 |
- | ~today~, ~yesterday~, ~today-N~ | a relative day |
- | ~thisweek~, ~lastweek~, ~thisweek-N~ | a relative week |
- | ~thismonth~, ~lastmonth~, ~thismonth-N~ | a relative month |
- | ~thisyear~, ~lastyear~, ~thisyear-N~ | a relative year |
- | ~untilnow~ | all clocked time ever |
+ | =today=, =yesterday=, =today-N= | a relative day |
+ | =thisweek=, =lastweek=, =thisweek-N= | a relative week |
+ | =thismonth=, =lastmonth=, =thismonth-N= | a relative month |
+ | =thisyear=, =lastyear=, =thisyear-N= | a relative year |
+ | =untilnow= | all clocked time ever |
#+vindex: org-clock-display-default-range
When this option is not set, Org falls back to the value in
@@ -7199,7 +7167,6 @@ Now lets look at the elements of a template definition. Each entry in
("b" "Templates for marking stuff to buy")
#+end_src
- #+texinfo: @noindent
If you do not define a template for the {{{kbd(C)}}} key, this
key opens the Customize buffer for this complex variable.
@@ -7500,7 +7467,6 @@ here:
After completing the template, position point here.
-#+texinfo: @noindent
#+vindex: org-store-link-props
For specific link types, the following keywords are defined[fn:84]:
@@ -7574,7 +7540,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
same attached directory.
-#+texinfo: @noindent
The following commands deal with attachments:
- {{{kbd(C-c C-a)}}} (~org-attach~) ::
@@ -8093,7 +8058,6 @@ example:
#+cindex: @samp{ARCHIVE}, keyword
: #+ARCHIVE: %s_done::
-#+texinfo: @noindent
#+cindex: ARCHIVE, property
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
@@ -8218,7 +8182,6 @@ a separate buffer. Seven different view types are provided:
- /custom views/ that are special searches and combinations of
different views.
-#+texinfo: @noindent
The extracted information is displayed in a special /agenda buffer/.
This buffer is read-only, but provides commands to visit the
corresponding locations in the original Org files, and even to edit
@@ -8317,9 +8280,8 @@ scope for an extended period, use the following commands:
#+findex: org-agenda-remove-restriction-lock
Remove the restriction created by {{{kbd(C-c C-x <)}}}.
-#+texinfo: @noindent
-When working with =speedbar.el=, you can use the following commands in
-the Speedbar frame:
+When working with Speedbar, you can use the following commands in the
+Speedbar frame:
- {{{kbd(<)}}} (~org-speedbar-set-agenda-restriction~) ::
@@ -8979,17 +8941,14 @@ this:
: #+CATEGORY: Thesis
-#+texinfo: @noindent
#+cindex: @samp{CATEGORY}, property
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
category you want to apply as the value.
-#+texinfo: @noindent
The display in the agenda buffer looks best if the category is not
longer than 10 characters.
-#+texinfo: @noindent
#+vindex: org-agenda-category-icon-alist
You can set up icons for category by customizing the
~org-agenda-category-icon-alist~ variable.
@@ -10442,7 +10401,6 @@ the black-and-white printer. Settings specified in
#+texinfo: @noindent
but the settings in ~org-agenda-custom-commands~ take precedence.
-#+texinfo: @noindent
From the command line you may also use:
#+begin_src shell
@@ -11120,7 +11078,6 @@ back-ends:
- /texinfo/ (Texinfo format)
- /man/ (Man page format)
-#+texinfo: @noindent
Users can install libraries for additional formats from the Emacs
packaging system. For easy discovery, these packages have a common
naming scheme: ~ox-NAME~, where {{{var(NAME)}}} is a format. For
@@ -12652,9 +12609,8 @@ accessibility standards.
[[./img/a.jpg]]
#+end_example
-#+texinfo: @noindent
-The HTML export back-end copies the =http= links from the Org file as
-is.
+The HTML export back-end copies the =http= links from the Org file
+as-is.
*** Math formatting in HTML export
:PROPERTIES:
@@ -12901,7 +12857,6 @@ options described below:
Should view-toggle buttons be everywhere? When =nil= (the
default), only one such button is present.
-#+texinfo: @noindent
#+vindex: org-infojs-options
#+vindex: org-export-html-use-infojs
You can choose default values for these options by customizing the
@@ -13341,7 +13296,6 @@ attribute to one of the following:
To avoid a =:float= even if using a caption.
-#+texinfo: @noindent
Use the =placement= attribute to modify a floating environment's
placement.
@@ -18872,7 +18826,6 @@ uses only one star and indents text to line with the heading:
,* Another top level headline | * Another top level headline
#+end_example
-#+texinfo: @noindent
#+cindex: Indent mode
#+findex: org-indent-mode
To turn this mode on, use the minor mode, ~org-indent-mode~. Text
@@ -18935,7 +18888,6 @@ headings as shown in examples below.
...
#+end_example
- #+texinfo: @noindent
#+vindex: org-hide, face
Because Org makes the font color the same as the background color
to hide to stars, sometimes ~org-hide~ face may need tweaking to
@@ -19325,7 +19277,6 @@ locally just set the variable to point to that directory:
(setq org-mobile-directory "~/orgmobile/")
#+end_src
-#+texinfo: @noindent
Alternatively, by using TRAMP (see [[info:tramp][TRAMP User Manual]]),
~org-mobile-directory~ may point to a remote directory accessible
through, for example, SSH and SCP:
@@ -19667,7 +19618,6 @@ If the mode is C, then:
/* END RECEIVE ORGTBL table_name */
#+end_example
-#+texinfo: @noindent
At the location of source, Org needs a special line to direct Orgtbl
to translate and to find the target for inserting the translated
table. For example:
@@ -19696,7 +19646,6 @@ called:
translator function, which then skips columns as specified in
=skipcols=.
-#+texinfo: @noindent
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
of these strategies:
@@ -19756,7 +19705,6 @@ features[fn:154]:
\end{comment}
#+end_example
-#+texinfo: @noindent
After editing, {{{kbd(C-c C-c)}}} inserts the translated table at the
target location, between the two marker lines.
@@ -20174,7 +20122,6 @@ with the following fields:
- priority-l :: The priority letter if any was given
- priority-n :: The computed numerical priority
-#+texinfo: @noindent
If the selection of the agenda item was based on a timestamp,
including those items with =DEADLINE= and =SCHEDULED= keywords, then
Org includes date and time in the output.
@@ -20523,7 +20470,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
navigation.
-#+texinfo: @noindent
See below for the full list of contributions! Again, please let me
know what I am missing here!