Commit Graph

2064 Commits

Author SHA1 Message Date
Nicolas Goaziou 4eb4f47141 Simplify `org-show-context' configuration
* lisp/org.el (org-show-context-detail): New variable.
(org-context-choice, org-show-following-heading, org-show-siblings,
org-show-entry-below, org-show-hierarchy-above): Remove variables.
(org-show-set-visibility): New function.
(org-convert-to-oddeven-levels, org-get-location, org-show-context,
org-reveal): Use new function.
(org-link-search): Update docstring.

* lisp/org-agenda.el (org-agenda-cycle-show): Use new function.
(org-agenda-show): Replace missing variable.

* testing/lisp/test-org.el (test-org/show-set-visibility): New test.

* doc/org.texi (Sparse trees):
* doc/orgguide.texi (Sparse trees): Document changes.

* etc/ORG-NEWS: Signal changes.

Configuration of `org-show-context' is done with a single variable
offering six different views, instead of four variables for a total
of 16 configurations.
2015-02-22 14:57:09 +01:00
Arni Magnusson f79bc6d6c6 Add documentation regarding reserved keywords in @node Headlines 2015-02-21 18:30:35 +01:00
Nicolas Goaziou 73fef543ea org.texi: Add missing `org-export-with-date'
* doc/org.texi (Export settings): Add `org-export-with-date'.
(Publishing options): Add `org-export-with-date' and
`org-export-with-title'.
2015-02-13 00:28:04 +01:00
Rasmus 4f905107c9 org.texi: Fix typo
* org.texi (Export settings): Fix typo in vindex.
2015-02-12 11:56:21 +01:00
Rasmus b39dd5a099 org.texi: Fix bug
* org.texi: Fix bug introduced in e6fcc853c.
2015-02-12 10:42:19 +01:00
Rasmus e6fcc853c5 ox: Optional export of title
* ox.el (org-export-with-title): New variable.
* ox (org-export-options-alist),
  ox-ascii.el (org-ascii-template--document-title),
  ox-beamer.el (org-beamer-template), ox-html.el (org-html-template),
  ox-latex.el (org-latex-template), ox-man.el (org-man-template),
  ox-odt.el (org-odt-template), ox-org.el (org-org-template),
  ox-publish.el (org-publish-project-alist),
  ox-texinfo.el (org-texinfo-template),
  ox-groff.el (org-groff--mt-head): Use new variable.
* ox-koma-letter.el (org-koma-letter-use-title): Mark obsolete.
* test-ox.el (test-org-export/parse-option-keyword): Add :with-title.
* ORG-NEWS, org.texi: Mention org-export-with-title.

This is useful in e.g. ox-html where title can be set via
`org-html-preamble-template' or when using the {{{title}}}-macro.
2015-02-12 01:45:39 +01:00
rasmus ae83b37e3e org.texi: New example on babel :post header
* org.texi (post): Clarification and new example.
2015-02-10 12:04:41 +01:00
Rasmus 8f38f037b4 ox.el: {{{date}}} formatting argument
* ox.el (org-export-as): Allow {{{date}}} to take formatting-argument.
* org.texi (Macro replacement): Document {{{date}}} formatting.
* test-ox.el (test-org-export/expand-macro): Test {{{data(format)}}}
* org-NEWS: Mention optional {{{data}}} argument.

Optional argument to {{{date}}} like {{{date(FMT)}}} are treated
similar to {{{time(FMT)}}} if \#+DATE is a timestamp.
2015-02-09 01:47:21 +01:00
Rasmus 1aad2fd6de org.texi: Consistent formatting of non-nil
* org.texi: All occurances of non-nil changed to non-@code{nil}.
2015-02-08 22:48:57 +01:00
Rasmus 41cd87ab76 org.texi: Document all predefined macros
* org.texi (Macro replacement): Document all predefined macros.
2015-02-08 22:43:25 +01:00
Alan Schmitt 6d691e2aa8 Function `org-link-search' does exact headline search
* lisp/org.el (org-link-search): Change headline search such that it
always does an exact search, ignoring spaces.

* testing/lisp/test-org.el (test-org/fuzzy-links): Test exact headline
match with spaces and cookies.

* doc/org.texi (External links): Cleanup footnote about the
`org-link-search-must-match-exact-headline' option for text searches
and add a footnote about the effect of the same option for heading
searches.

* doc/ORG-NEWS: Document changes.
2015-02-07 22:42:40 +01:00
Nicolas Goaziou e76a541865 org-texi: Fix typo
* doc/org.texi (Timers): Fix typo.

This fixes e3bd15a8dd.
2015-02-05 17:44:48 +01:00
Nicolas Goaziou e3bd15a8dd org.texi: Fix typo
* doc/org.texi (Timers): Fix typo.

Reported-by: J. David Boyd <dboyd2@mmm.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/94674>
2015-02-05 17:42:20 +01:00
Nicolas Goaziou 21c73e38e4 org.texi: Fix typo
* doc/org.texi (Filtering/limiting agenda items): Fix typo.
2015-02-03 21:46:22 +01:00
Nicolas Goaziou b719c10e9a org.texi: Fix typo
* doc/org.texi (Summary): Fix typo

Suggested-by: Thierry Pellé <abonnements@thierry-pelle.eu>
2015-02-03 12:19:02 +01:00
Nicolas Goaziou 31e7634779 Fix special properties list
* lisp/org.el (org-special-properties): Add missing "CATEGORY".

* doc/org.texi (Special properties): Remove "NOBLOCKING" as a special
  property, since it can only be set through a properties drawer.
  This is a reserved property.

Reported-by: Samuel Loury <konubinix@gmail.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/94483>
2015-01-30 09:55:31 +01:00
Nicolas Goaziou 2ca9222252 org.texi: Minor fixes
* doc/org.texi (Export settings): Add UNNUMBERED property to concept
  index.  Fix number of spaces at the end of a sentence.  Use @code
  instead of @samp for reserved properties.
2015-01-21 23:50:19 +01:00
rasmus 6d0acc46a2 org.texi: Documentation for 464cd96
* org.texi (Export settings): Document the UNNUMBERED property.
2015-01-21 18:04:14 +01:00
Aaron Ecay d18ea6e30a manual: Further rewrite :session doc.
* doc/org.texi (session): Spruce up.
2015-01-16 22:37:48 -05:00
Thierry Pellé b919d06ad7 manual: Rewrite :session doc.
* doc/org.texi (session): Spruce up.
2015-01-16 22:37:39 -05:00
rasmus d36bd8dc53 org.texi: Replace parenthesis comment style
* org.texi (Table of contents): Replace parenthesis comment style with
  @r{} comment style in examples.
2015-01-13 17:22:52 +01:00
Nicolas Goaziou 5675c97073 org.texi: Fix typo
* doc/org.texi (Table of contents): Fix typo.
2015-01-13 15:20:47 +01:00
rasmus 032d9aeb94 org.texi: Footonote on titletoc-hyperref issue
* org.texi (Table of contents): Add footnote on hyperref and
titletoc conflict with LaTeX export.
2015-01-13 12:53:31 +01:00
Nicolas Goaziou b07e2f6ff1 ox: Implement local table of contents
* lisp/ox.el (org-export-collect-headlines): Allow to collect
  headlines locally.
* testing/lisp/test-ox.el (test-org-export/collect-headlines): Add
  tests.

* lisp/ox-ascii.el (org-ascii--build-toc):
(org-ascii-keyword):
* lisp/ox-html.el (org-html-toc):
(org-html-keyword):
* lisp/ox-odt.el (org-odt-toc): Allow local table of contents.
(org-odt--format-toc): New function.
(org-odt-begin-toc, org-odt-end-toc): Remove functions.

* lisp/ox-latex.el (org-latex-logfiles-extensions): Optionally remove
  "ptc" files.
(org-latex-headline, org-latex-keyword): Implement partial table of
contents assuming "titletoc" package is loaded.

* etc/ORG-NEWS:
* doc/org.texi (Table of contents): Document new parameter.
2015-01-11 22:47:02 +01:00
Rasmus 12fc68f3cd org.texi: Fix typo
* org.texi (Customizing tables in ODT export): Fix typo.

Reported by: Thomas <thomas@friendlyvillagers.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/93914>
2015-01-11 00:33:44 +01:00
Nick Dokos 1853fb546d org.texi: Fix typo
* doc/org.texi (Headlines): Typo in footnote.

Reported-by: Daniel E. Doherty <ded-law@ddoherty.net>
2014-12-29 12:15:46 -05:00
Jon Snader 71b098702c org.el: Implement user-defined table sorting
* lisp/org.el (org-do-sort): Implement the ?f and ?F sorting options
  to allow user-defined table sorting.  Update the DOC string.

* lisp/org-table (org-table-sort-lines): Add the GETKEY-FUNC and
  COMPARE-FUNC optional parameters and pass them to the call to
  `org-do-sort'.  Update the DOC string.

* doc/org.texi (org-table-sort-lines): Update documentation to reflect
  the addition of the ?f and ?F options.

This patch implements user-defined extraction and comparison functions
for table sorting.  Thanks to Nicolas Goaziou for helpful suggestions.

This patch was discussed on the Org Mode mailing list:
http://article.gmane.org/gmane.emacs.orgmode/93334
2014-12-20 20:36:57 +01:00
Toby S. Cubitt 54dfb86719 org-archive.el: Add command to archive entries with timestamps before today
* lisp/org-archive.el (org-archive-all-old): archive all entries with
  timestamps prior to today.
  (org-archive-subtree): double prefix argument invokes
  org-archive-all-old.
  (org-archive-all-matches, org-archive-all-done): factor out common
  code into org-archive-all-matches.
2014-12-17 00:08:39 +01:00
Nicolas Goaziou c1558d34d7 Fix low-high estimates
* doc/org.texi (Column attributes): Emphasize estimates format.
  Document degenerate case of plain numbers.
* lisp/org-colview.el (org-columns-compute): Properly sum estimates.
(org-columns-string-to-number): Recognize estimates containing an
unit.
(org-estimate-mean-and-var, org-estimate-print): Allow numbers as
a degenerate case of estimates.

Reported-by: yary <not.com@gmail.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/93505>
2014-12-16 23:53:15 +01:00
Nicolas Goaziou 1527b70010 Merge branch 'maint' 2014-12-09 22:42:56 +01:00
Nicolas Goaziou 7fe4574899 org.texi: Fix typos
* doc/org.texi (Document preamble):
(Headings and sectioning structure): Fix typo.
2014-12-09 22:42:17 +01:00
Kyle Meyer 173b0cb6d6 org-timer.el: Merge API for the two timers
* lisp/org-timer.el (org-timer-stop): Support countdown timers in addition
to relative timers.

* lisp/org-timer.el (org-timer-cancel-timer): Remove function.

* lisp/org-timer.el (org-timer-pause-or-continue): Support countdown
timers in addition to relative timers.

* testing/lisp/test-org-timer.el: New file.

* doc/org.texi: Merge relative and countdown timer nodes.

Several previous issues are fixed with these changes.

- org-timer-set-timer and org-timer-cancel-timer did not reset
  org-timer-start-time after countdown completed.

- Because org-timer-start did not return org-timer-pause-time to nil,
  the modeline remained stuck at the paused time.

- When org-timer-start was called with a countdown timer, the modeline
  was updated for the new relative timer, but the countdown timer
  remained scheduled.

- When org-timer-pause-or-continue was called with a countdown timer
  running, the modeline was put in a paused state, but the countdown
  timer remained scheduled.

- When org-timer-stop was called with a countdown timer running, the
  timer was removed from the modeline, but the countdown timer remained
  scheduled.

- When org-timer-set-timer was called with a paused relative timer, the
  relative timer was not reset properly (org-timer-pause-time was still
  non-nil) and the modeline remained in the paused state of the relative
  timer, even though the countdown timer was scheduled with
  run-with-timer.

- Running org-timer-set-timer at the beginning of an empty buffer
  resulted in an args-out-of-range error (due to the org-get-at-eol
  call).
2014-12-09 10:13:29 +01:00
Nicolas Goaziou 65cef8dce4 Merge branch 'maint' 2014-12-09 10:09:20 +01:00
Nicolas Goaziou 56c958cf9d org.texi: Remove reference to `org-effort-property'
* doc/org.texi (Effort estimates): Remove `org-effort-property' from
  variables index since it is a defconst, not a defcustom anymore.

See also 20dcd061a5.
2014-12-09 10:07:46 +01:00
Nicolas Goaziou 16ebbe49e4 Merge branch 'maint' 2014-12-07 23:53:23 +01:00
Nicolas Goaziou 1ec4164615 org.texi: Fix typo
* doc/org.texi (Export settings): Add missing OPTIONS item.

Reported-by: Amitai Hoze <amitai.hoze@gmail.com>
2014-12-07 23:52:24 +01:00
Nicolas Goaziou e2e6a39003 org.texi: Small fix
* doc/org.texi (Matching tags and properties): Remove inaccurate
  sentence and footnote.
2014-12-06 21:51:08 +01:00
Nicolas Goaziou 4c172fe5cc org.texi: Small fixes
* doc/org.texi (Matching tags and properties): Fix typo.  Remove
  inaccurate paragraph.
2014-12-06 21:30:59 +01:00
Alan Schmitt 40a5b7af99 org.texi: Document `org-html-link-org-files-as-html'
* doc/org.texi: Document `org-html-link-org-files-as-html' in the
"Links in HTML export" section.
2014-12-04 08:09:03 +01:00
Nicolas Goaziou f4900843ba org.texi: Fix typo
* doc/org.texi (Adding export back-ends): Fix typo.
2014-12-03 22:01:27 +01:00
Nicolas Goaziou fe99861781 org.texi: Remove NOBLOCKING from special properties list
* doc/org.texi (Special properties): Remove NOBLOCKING.

Special properties are properties that can get their value from
somewhere else than a properties drawer.  This is not the case of
NOBLOCKING, which is always set through such a drawer.  Technically,
it is more a reserved property than a special one, per manual
definition.
2014-12-03 21:44:03 +01:00
Bastien Guerry 9aa58fa852 org.texi: Document `org-table-blank-field'
* doc/org.texi: Document `org-table-blank-field'.

Thanks to Vicente Vera for suggesting this.
2014-12-01 17:04:36 +01:00
Bastien Guerry e435b0eac3 org.texi (TODO dependencies): Document the NOBLOCKING property
* org.texi (TODO dependencies): Document the NOBLOCKING
property.

Thanks to James Harkins for reporting this.
2014-12-01 15:52:30 +01:00
Kim 96e1971f0f org-info: Try info index if info node is not found
* lisp/org-info.el (org-info-follow-link): Attempt index lookup if node
  lookup fails.

* doc/org.texi (External links): Update info links.

Info index is almost always finer grain than info nodes.  For example
with this change, [[info:libc#close]] brings up not only
"(libc)Opening and Closing Files" info node, but also place the cursor
on the line that documents "close" function within the node.  This is
done by looking up "close"in the index upon failing to find a node
named "close".  Hence one can now link function, variable and other
names that are in the index rather than being limited to info node
names.  Typically there are far more index items than there are node
names.  For example libc manual has about 700 nodes, but over 4000
concept, type, function, and variables index items.  More examples of
new ways to create links are shown using org.info as example

- [[info:org#org-clock-idle-time]] uses "Variable Index"
- [[info:org#org-capture]] uses "Command and Function Index".
- [[info:org#timestamp]] uses "Main Index"
- [[info:org#C-c C-c]] uses "Key Index"

TINYCHANGE
2014-11-16 00:14:29 +01:00
Nicolas Goaziou 9309fd5d20 Add "ITEM" to special properties
* lisp/org.el (org-special-properties): Add "ITEM".  Tiny fix to
  docstring.
(org-entry-properties): Compute "ITEM" property's value.
(org-buffer-property-keys): Remove hack since "ITEM" now officially
belongs to the special properties list.

* doc/org.texi (Special properties): Document "ITEM" change.

* testing/lisp/test-org.el (test-org/entry-properties): Add test.
2014-11-10 16:45:36 +01:00
Nicolas Goaziou d2e78d2505 org.texi: Remove "ID" as a special property
* doc/org.texi (Special properties): Remove "ID" as a special
  property.  Sort list.

Special properties cannot be set only using properties located in
a properties drawer.  "ID" is always set through a properties drawer.
It is more a reserved property than a special one.
2014-11-10 11:07:22 +01:00
Nicolas Goaziou 76034be4cd Merge branch 'maint' 2014-11-02 23:43:17 +01:00
Nicolas Goaziou 20dcd061a5 org.texi: Remove outdated footnote
* doc/org.texi (Effort estimates): EFFORT property is a defconst.  It
  is not desirable to change it.
2014-11-02 23:42:33 +01:00
Kyle Meyer aa1fd698ec org.texi: Remove reference to deleted command
* doc/org.texi (Inserting deadlines or schedules): Remove entry for
`org-mark-entry-for-agenda-action', which was deleted in commit f95e5ff.
2014-10-30 16:44:57 +01:00
Nicolas Goaziou fcd4adf9cd org.texi: Update LaTeX environment syntax
* doc/org.texi (@LaTeX{} fragments): Update environments syntax.
2014-10-29 18:14:08 +01:00