Commit Graph

2048 Commits

Author SHA1 Message Date
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
Nicolas Goaziou 86ec0ac998 Fix ccde27d
* doc/org.texi (Special symbols): Fix
  ccde27ddc0.
2014-10-29 17:49:21 +01:00
rasmus ccde27ddc0 org.texi: Minor correction.
* org.texi (Special symbols): Correct output of fragment export.
2014-10-29 14:12:43 +01:00
Nicolas Goaziou 4af0f94665 Document new properties drawers syntax
* doc/org.texi (Per-file keywords): Remove wrong limitation.
(Tracking your habits): Make sure state changes appear after the
properties drawer.
(Property syntax): Specify new syntax.
(Using the property API): Fix a function definition.
2014-10-28 14:23:52 +01:00
Rafael Laboissiere 63afc9b20d org.texi: Remove extraneous backslash in key sequence
* doc/org.texi (ASCII bar plots): Remove the backslash character in
the key binding sequence for orgtbl-ascii-plot command.

I think that this backslash is not needed, since previously in the
same section, at subheading "Graphical plots using Gnuplot", there is
a similar key sequence without backslash @kbd{C-c " g}.

TINYCHANGE
2014-10-20 11:25:31 +02:00
Nicolas Goaziou 3bb75bc14c ox-latex: Add `org-latex-caption-above'
* lisp/ox-latex.el (org-latex-caption-above): New variable.
(org-latex-table-caption-above): Remove variable.  Make it an obsolete
alias of the previous one.
(org-latex--caption-above-p): New function.
(org-latex--inline-image, org-latex-src-block,
org-latex-special-block, org-latex table): Handle new variable.

* doc/org.texi (Publishing options):
* etc/ORG-NEWS: Document new option.
2014-10-17 21:42:17 +02:00
Thierry Banel ad0d51ff1c Document ASCII-art plot
* doc/org.texi: Extend Gnuplot chapter to ASCII-art plotting.
* etc/ORG-NEWS: Document ASCII-art plot.
2014-10-14 23:06:09 +02:00
Nicolas Goaziou bc342011e9 org.texi: Tiny fix
* doc/org.texi (An example): Tiny fix.
2014-10-14 12:14:55 +02:00
David Arroyo Menéndez 2900f18a2b orgguide.texi: break lines after @noindent
* doc/orgguide.texi: to avoid troubles with po4a, I've added break lines after @noindent
2014-10-08 15:06:42 +02:00
Bastien Guerry e54cf318ee Merge branch 'maint' 2014-10-06 14:29:01 +02:00
Bastien Guerry df3b24fe8a Backport typo fixes from Emacs 24 branch 2014-10-06 11:52:30 +02:00
Rasmus 986037a538 ox: Allow file-links with #+INCLUDE-keyword
* org.el (org-edit-special): Handle file-links for INCLUDE.
* ox.el (org-export--prepare-file-contents): Handle links and
add option no-heading.
* ox.el (org-export-expand-include-keyword): Resolve headline
links and add option :only-contents.
* orgguide.texi (Include files)
org.texi (Include files): Updated.
* testing/examples/include.org: New examples.
* test-ox.el (test-org-export/expand-include): New tests.
2014-10-02 18:51:37 +02:00
Nicolas Goaziou aaa7aa983d ox-ascii: Implement plain-lists own extra margin
* lisp/ox-ascii.el (org-ascii-list-margin): New variable.
(ascii): New property.
(org-ascii--current-text-width, org-ascii-plain-list): Take into
account list margin.

* doc/org.texi (Publishing options):
* etc/ORG-NEWS (argument): Document new variable.
2014-09-20 15:06:22 +02:00
Nicolas Goaziou 1465229957 Merge branch 'maint'
Conflicts:
	doc/org.texi
2014-09-20 00:35:09 +02:00
Nicolas Goaziou 2d02479c34 org.texi: Be more explicit about output file name
* doc/org.texi (Export settings): Be more explicit about how output
  file name is built.
2014-09-20 00:33:54 +02:00
Nicolas Goaziou b82f1cb2c2 Fix 788780296c 2014-09-19 22:45:22 +02:00
Nicolas Goaziou 788780296c org.texi: Document case-sensitivity of special blocks
* doc/org.texi (Special blocks, HTML doctypes, @LaTeX{} specific
  attributes): Take into account case-sensitivity of special blocks.
2014-09-19 22:42:35 +02:00