Commit Graph

2161 Commits

Author SHA1 Message Date
Rasmus 291938d0b0 org-macro.el: Allow modification-time from vc.el
* org-macro.el (org-macro--vc-modified-time): New function.
* org-macro.el (org-macro-initialize-templates): Add support for new
  function.
* doc/org.texi (Macro replacement): Document new behavior.
* etc/ORG-NEWS: Mention new behavior.
2016-05-18 21:39:37 +02:00
Nicolas Goaziou ad766435dc Merge branch 'maint' 2016-05-16 11:21:05 +02:00
Phil Hudson 5fc351ab78 org-capture: Support all capture template target-file variants in Customize
* lisp/org-capture.el (`org-capture-templates'): Adjust the
  `org-capture-templates' defcustom template to support specifying the capture
  target file using either a literal pathname, a function, a variable or a
  form, as documented.  Previously the Customize UI supported specifying only a
  literal pathname.
  (org-capture-templates): Clarify the documentation for the `function' method
  for setting up the capture target.

* doc/org.texi (Template elements): Clarify the `function' method for setting up
  the capture target.
2016-05-16 11:17:26 +02:00
Nicolas Goaziou da9fb9eacd Merge branch 'maint' 2016-04-16 11:31:01 +02:00
Nicolas Goaziou e3656b6b2e org.texi: Fix typo
* doc/org.texi (Timers): Fix typo.

Reported-by: Lee <maplainfly@gmail.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/106430>
2016-04-16 11:30:31 +02:00
Nick Dokos 16ad80fe34 Fix the paragraph on tag groups as regular expressions.
Reword the paragraph and fix the regexps to include
the requisite @ signs.
2016-04-13 10:59:09 -04:00
Ethan Ligon a6ccd4ad95 org.texi: Replace broken example script for batch execution
* doc/org.texi: Example bash script to tangle from *.org file was broken
and obsolete; fixed to now work with recent versions of Org.

There is an example bash script in section  14.12 of the Org manual which
is meant to tangle source blocks from a supplied list of Org files.

The present version is broken in several small ways (it appears to date
from a period when babel was still part of contrib), and requires a
hard-coded specification of the path ORG_HOME.

I've fixed the issue with ORG_HOME, another issue with grepping for strings
that no longer are emitted by ob-tangle, and removed some obsolete
dependencies.

I'm finding the corrected script a useful thing to call from makefiles.
2016-04-09 23:16:39 +02:00
Rasmus 18b7661a84 org.texi: Add documentation on list nesting
* org.texi (@LaTeX{} specific attributes): Document how to get
  more than four levels.

Suggested-by: 9661031 <9661031@gmail.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/105427>
2016-03-28 18:33:05 +02:00
Nicolas Goaziou 06177a4208 Merge branch 'maint' 2016-03-25 14:27:05 +01:00
Nicolas Goaziou 780445c0aa org.texi: Fix typo
* doc/org.texi (HTML doctypes): Special block names are case-sensitive.

Reported-by: Guilherme Gondim <guilherme@semente.io>
<http://permalink.gmane.org/gmane.emacs.orgmode/105896>
2016-03-25 14:26:09 +01:00
Nicolas Goaziou 0cdc2b339f Merge branch 'maint' 2016-03-24 14:02:57 +01:00
Nicolas Goaziou c736013224 org.texi: Fix typo
* doc/org.texi (@LaTeX{} specific attributes): Fix typo.

Reported-by: Eduardo Mercovich <eduardo@mercovich.net>
<http://permalink.gmane.org/gmane.emacs.orgmode/105873>
2016-03-24 14:02:24 +01:00
Rafael Laboissiere 9fb077339b Merge branch 'maint' 2016-03-14 15:38:18 +01:00
Rafael Laboissiere 3e79c60379 Document the lack of evaluation of inline code blocks in keyword lines
* doc/org.texi (Evaluating code blocks): Add footnote explaining that
inline code blocks are not evaluated inside keyword lines.
2016-03-14 15:34:47 +01:00
Nicolas Goaziou 0ff9a9a335 org.texi: Document cross references
* doc/org.texi (Publishing links): Explain syntax for cross references.
2016-03-12 23:18:55 +01:00
Kyle Meyer 015d971f48 Merge branch 'maint' 2016-03-12 11:12:08 -05:00
Kyle Meyer 857b970b3a org.texi: Fix org-timer-pause-or-continue's key
* doc/org.texi (Timers): Fix keybinding for org-timer-pause-or-continue.

Reported-by: Tubo Shi <shitubo@gmail.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/105685>
2016-03-12 11:08:40 -05:00
Nicolas Goaziou de439a68c8 org-colview: Allow multiple summaries for a single property
* lisp/org-colview.el (org-columns--collect-values):
(org-agenda-colview-summarize): Use column format specification as the
  unique identifier for the returned alist.

* lisp/org-colview.el (org-columns--display-here): Store column format
  specification in a new overlay property.

(org-columns--set-widths):
(org-columns--display-here): Use column format specification instead of
(org-columns--displayed-value): Since the same property can have
multiple titles, use column specification instead of property as keys.

(org-columns--collect-values): Apply signature change.

(org-columns-update): Handle multiple columns for the same property.
Also apply signature change to `org-columns--displayed-value'.

(org-columns--compute-spec): New function.
(org-columns-compute):
(org-columns-compute-all): Use new function.

* testing/lisp/test-org-colview.el (test-org-colview/columns-summary):
(test-org-colview/columns-update): Add tests.

* doc/org.texi (Column attributes): Document computation with multiple
  summary types for a given property.
2016-02-23 13:18:34 +01:00
Nicolas Goaziou fedd6be97a org-colview: Introduce custom summary types
* lisp/org-colview.el (org-columns-summary-types): New variable.
(org-columns-compile-map): Rename into...
(org-columns-summary-types-default): ... this.

(org-columns-new):
(org-columns-compile-format): Use new variables.

* testing/lisp/test-org-colview.el (test-org-colview/columns-summary):
  Add test.

* doc/org.texi (Column attributes): Document new variable.  Improve
  description of time and age based summary types.
2016-02-21 00:44:17 +01:00
Nicolas Goaziou aa2db034a0 org-colview: Fix age related summary
* lisp/org-colview.el (org-columns-time): Rename to...
(org--columns-time): ... this.
(org-columns--fractional-duration-re): New variable.

(org-columns-edit-value):
(org-columns):
(org-columns-compute-all):
(org-agenda-columns): Use new variable.

(org-columns-compile-map): Remove unneeded "calc" attribute.

(org-columns-number-to-string):
(org-columns-string-to-number): Fix ages set as a duration (e.g., "1d
12h").  Compare ages as seconds, not number of days.

* doc/org.texi (Column attributes): Document syntax for "age".
2016-02-17 22:49:19 +01:00
Nicolas Goaziou 23f1119042 org-colview: Allow to force global column view
* lisp/org-colview.el (org-columns): Add new argument to force global
  column view.

* doc/org.texi (Using column view): Document change.
2016-02-17 22:49:19 +01:00
Kyle Meyer 4f499fff96 Merge branch 'maint' 2016-02-07 11:56:36 -05:00
Kyle Meyer 30bcff1129 org-capture: Document org-directory
* lisp/org-capture.el (org-capture-templates):
* doc/org.texi (Template elements): Document org-directory.
2016-02-07 11:56:04 -05:00
Nicolas Goaziou 99697abdb9 org-colview: Add :indent parameter
* lisp/org-colview.el (org-dblock-write:columnview): Handle :indent
  parameter.
* doc/org.texi (Capturing column view): Document new feature.
2016-02-04 23:06:03 +01:00
Nicolas Goaziou 00f0c70418 Special property "ITEM" contains headline without stars
* lisp/org.el (org-entry-properties): "ITEM" contains headline without
  stars.
* lisp/org-colview.el (org-columns-display-here): Apply changes.
* doc/org.texi (Special properties): Update documentation.
* testing/lisp/test-org.el (test-org/entry-properties): Update tests.
2016-02-04 23:06:03 +01:00
Kyle Meyer c53936dcfb org-agenda: Fix org-agenda-filter-by-tag-refine
* lisp/org-agenda.el (org-agenda-filter-by-tag-refine): Remove command
  because this functionality is redundant with org-agenda-filter-by-tag
  as of 6c6ae99.

Reported-by: Viktor Rosenfeld <v.rosenfeld@gmx.de>
<http://permalink.gmane.org/gmane.emacs.orgmode/104605>
2016-02-03 23:49:48 -05:00
Kyle Meyer e44524b3b2 Merge branch 'maint' 2016-02-03 23:37:26 -05:00
Kyle Meyer 2fc29a1796 Fix "it's" typos
* lisp/ob-C.el (org-babel-expand-body:cpp):
(org-babel-expand-body:C++):
(org-babel-expand-body:D):
(org-babel-expand-body:C):
(org-babel-C-expand-C++):
(org-babel-C-expand-C):
(org-babel-C-expand-D):
* lisp/ob-exp.el (org-babel-exp-src-block):
* lisp/ob-fortran.el (org-babel-expand-body:fortran):
* testing/org-test.el (org-test-buffer):
Correct "it's" typo in docstring.

* doc/org.texi:
Correct "it's" typos.
2016-02-03 23:33:28 -05:00
Kyle Meyer 034c176995 Merge branch 'maint' 2016-01-24 16:41:20 -05:00
Alan Mackenzie 347191042a Backport commit fbce475 from Emacs
Expunge "allow" + infinitive without direct object from source and doc.
fbce4757a874cc43806eb41b8637538b101c3c69
Alan Mackenzie
Sun Jan 24 20:30:39 2016 +0000
2016-01-24 16:35:22 -05:00
Nicolas Goaziou 9db78611b4 Tweak `org-auto-repeat-maybe'
* lisp/org.el (org-auto-repeat-maybe): Only clear non-repeated SCHEDULED
  information in a repeated task.

* doc/org.texi (Repeated tasks): Document behavior.

Do not clear non-repeated DEADLINE information however, as it could be
a global deadline for all occurrences of the task.  Also, this case is
taken care of by `org-agenda-skip-scheduled-if-deadline-is-shown' with
a value set to `repeated-after-deadline'.
2016-01-11 12:11:22 +01:00
Kyle Meyer 6345de2d05 Merge branch 'maint' 2016-01-09 17:43:27 -05:00
Kyle Meyer 6bc48c5f41 Update copyright years 2016-01-09 17:12:03 -05:00
tsdye d5595ac671 Change "keybinding" to "key binding"
* doc/org.texi (Conventions):
(Clocking commands):
(Using capture):
(Key bindings and useful functions): Change "keybinding" to "key binding".
2016-01-06 22:53:56 +01:00
Nicolas Goaziou f4ffbccf64 Remove left-over :export-block keywords
* contrib/lisp/ox-freemind.el (freemind):
* contrib/lisp/ox-gfm.el (gfm):
* contrib/lisp/ox-groff.el (groff): Remove :export-block keyword.

* doc/org.texi (Adding export back-ends): Remove documentation about the
  keyword.

Reported-by: Kaushal Modi <kaushal.modi@gmail.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/104057>
2016-01-06 22:50:22 +01:00
Rüdiger Sonderfeld 3e252a4dea org-capture.el: Add support for week trees
* lisp/org-capture.el (org-capture-templates): Add
  file+weektree(+prompt) options.
  (org-capture-set-target-location): Add support for week trees.
* doc/org.texi (Template elements): Document file+weektree(+prompt)
  options.
2015-12-29 21:57:58 +01:00
Jan Malakhovski 839dae713e org-notmuch: Add date support to org-notmuch-store-link
* contrib/lisp/org-notmuch.el (org-notmuch-store-link): Add date
  support.
* doc/org.texi: Fix `org-capture-templates' documentation.
2015-12-29 21:17:00 +01:00
Jan Malakhovski d1f42e7f32 Factor out date-timestamp* calculations to org-store-link-props
* lisp/org.el (org-store-link-props): Rewrite function to get
  date-timestamp* calculations.
* lisp/org-gnus.el:
* lisp/org-mhe.el:
* lisp/org-rmail.el:
* contrib/lisp/org-mew.el:
* contrib/lisp/org-vm.el:
* contrib/lisp/org-wl.el: Remove date-timestamp* copy-paste.
* doc/org.texi: Fix `org-capture-templates' documentation.
2015-12-29 21:17:00 +01:00
Nicolas Goaziou 3699558452 org.texi: Update footnotes documentation
* doc/org.texi (Footnotes): Be more accurate about footnote marker.
  Remove useless information.  Inline definitions need not start with
  a whitepace.
2015-12-22 16:55:17 +01:00
Nicolas Goaziou deafe56554 org-element: Ignore plain footnotes
* lisp/org-element.el (org-element--set-regexps):
(org-element-footnote-definition-interpreter):
(org-element-footnote-reference-parser):
(org-element-footnote-reference-interpreter): Do not consider [1]-like
constructs as footnotes anymore.

* lisp/ox.el (org-export-expand-include-keyword):
(org-export--prepare-file-contents): Apply changes to footnotes.

* doc/org.texi (Footnotes): Remove references to plain footnotes.

* testing/lisp/test-org-element.el (test-org-element/footnote-reference-parser):
(test-org-element/footnote-reference-interpreter):
* testing/lisp/test-ox.el (test-org-export/expand-include):
(test-org-export/expand-macro):
(test-org-export/get-footnote-number):
(test-org-export/collect-footnote-definitions):
(test-org-export/footnotes):
(test-org-export/fuzzy-link): Update tests.

Since it is possible to refer unambiguously to a label without the "fn:"
prefix, the latter becomes part of the syntax and no longer part of the
label.  In particular [fn:1] and [fn:label] are labelled, respectively,
"1" and "label".
2015-12-22 16:55:17 +01:00
Nicolas Goaziou 9f5a1ad51e org.texi: Update export blocks documentation
* doc/org.texi (Conventions):
(Include files):
(Special blocks):
(ASCII/Latin-1/UTF-8 export):
(Beamer specific syntax):
(Quoting HTML tags):
(Quoting @LaTeX{} code):
(Creating one-off styles):
(Quoting Texinfo code):
(Easy templates): Update export blocks documentation.
2015-12-20 21:56:27 +01:00
Nicolas Goaziou 11291ffcd0 org-list: Radio lists use Org Export library
* lisp/org-list.el (org-list-to-lisp): New function.
(org-list-parse-list): Mark function obsolete.

(org-list-send-list):
(org-list-to-generic):
(org-list-make-subtree): Use new function.

(org-list-item-trim-br): Remove function.

(org-list-to-generic): Use Org Export library.
(org-list--depth):
(org-list--trailing-newlines):
(org-list--generic-eval):
(org-list--to-generic-plain-list):
(org-list--to-generic-item): New functions.

(org-list-to-latex):
(org-list-to-html):
(org-list-to-texinfo): Apply changes.  Allow parameters.
(org-list-to-subtree): Apply changes.

* lisp/org.el (org-toggle-heading):
* lisp/ob-core.el (org-babel-insert-result): Apply changes.

* doc/org.texi (Radio lists): Update documentation.

* testing/lisp/test-org-list.el (test-org-list/to-generic): New test.
2015-12-03 09:54:49 +01:00
Aaron Ecay e47c7c3ed6 babel: update the manual wrt :cache header arg
* doc/org.texi (cache): Update manual section.
2015-11-05 14:50:23 +00:00
Marco Wahl 4552a8915b Merge branch 'maint' 2015-10-27 10:16:01 +01:00
Marco Wahl 3efb519ff5 doc/org.texi: Add index for Archive mode 2015-10-27 10:14:10 +01:00
Nicolas Goaziou 59761024b1 ox: Add an option to ignore broken links
* lisp/ox.el (org-export-with-broken-links): New variable.
(org-export-options-alist): Add new OPTIONS item.
(org-link-broken): New error type.
(org-export-resolve-coderef):
(org-export-resolve-fuzzy-link):
(org-export-resolve-id-link): Raise appropriate error symbol when a link
cannot be resolved.
(org-export-data): Handle new error type.

* doc/org.texi (Export settings): Document new feature.

* testing/lisp/test-ox.el (test-org-export/resolve-id-link):
(test-org-export/resolve-fuzzy-link):
(test-org-export/resolve-coderef): Update tests.
2015-10-17 14:42:07 +02:00
Nicolas Goaziou 249b7b4742 Merge branch 'maint' 2015-10-16 22:17:09 +02:00
Michael O'Connor 843be85c1d org.texi, orgguide.texi: Fix spelling of Sean Astin's name
* doc/org.texi: Fix a typo of Sean Astin's name as Sean Austin.

* doc/orgguide.texi: Fix a typo of Sean Astin's name as Sean Austin.

TINYCHANGE
2015-10-16 22:16:37 +02:00
Nick Dokos 75f91f0bb7 Allow early-warning anniversaries in agenda.
* lisp/org-bbdb.el (org-bbdb-anniversaries-future, org-bbdb-date-list): New functions.

* doc/org.texi: Document the usage of `org-bbdb-anniversaries-future'.

* etc/ORG-NEWS: Feature description.

Feature requested by Julien Cubizolles:

http://thread.gmane.org/gmane.emacs.orgmode/99344
2015-10-13 09:00:16 -04:00
Nicolas Goaziou d074ff703f Clarify documentation for `org-src-preserve-indentation'
* doc/org.texi (Editing source code): Clarify documentation.
2015-10-11 23:27:03 +02:00
Kyle Meyer 984b1ff0ab Merge branch 'maint' 2015-10-04 02:46:23 -04:00
Kyle Meyer 00dacdcc50 Clean up spacing to pass Emacs's pre-commit check
This is in preparation for syncing with the Emacs repo.
2015-10-04 02:31:29 -04:00
Rasmus 1e4b7e4bec ox-latex: Support changable TeX compilers
* org.el (org-latex-default-packages-alist): Only use inputenc
and fontenc in pdftex.
* ox-latex.el (latex): Add :latex-compiler.
(org-latex-compiler): New defcustom.
(org-latex-compilers): New defconst.
(org-latex--remove-packages): New function.
(org-latex-template): Use new function and variables.
(org-latex-pdf-process): Update to use %latex shorthand.
(org-latex-compile): Check and use intended compiler.
* org.texi (@LaTeX{} and PDF export): Document changes.
* ORG-NEWS: Add entry.

Adds #+latex_compiler: keyword.

Note, rubber is dropped from `org-latex-pdf-process' since it does not
allow arbitrary latex commands.

Suggested-by: Suvayu Ali <fatkasuvayu+linux@gmail.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/98921>
2015-09-27 23:49:32 +02:00
Rasmus d015606e5b Merge branch 'maint' 2015-09-13 20:23:09 +02:00
Joe Riel 823cadafa6 doc/org.texi: Elide duplicate phrase
* doc/org.texi (The export dispatcher): The phrase "from which it is
  possible to select an export format and to toggle export options."
  appeared both before and after the footnote.  Remove the redundancy.

TINYCHANGE.
2015-09-13 20:22:25 +02:00
Joe Riel 862bb9d9e3 doc/org.texi: Add link to relevant chapter
* doc/org.texi (Exporting code blocks): Add link to Exporting. Coming
  into this section without having read the chapter 12 is pretty
  confusing.  The link is helpful.

TINYCHANGE.
2015-09-13 20:22:03 +02:00
Joe Riel 6a12aa73cc doc/org.texi: Rewrite paragraph
doc/org.texi (Evaluating code blocks): Rewrite paragraph to state where
 to find information on enabling other languages.  Without this, it
 isn't clear where to look.

TINYCHANGE.
2015-09-13 20:20:34 +02:00
Nicolas Goaziou f91968bc38 Merge branch 'maint' 2015-09-10 14:29:19 +02:00
Marco Wahl a4375e81c0 org-agenda,org.texi: Fix doc about category filter
* lisp/org-agenda.el (org-agenda-filter-by-category): Documentation of
  the effect of the prefix argument.

* doc/org.texi (Filtering/limiting agenda items): Documentation about
  the effect of the prefix argument when filtering by category.
2015-09-10 13:41:21 +02:00
Nicolas Goaziou 8bd08a2c18 Merge branch 'maint' 2015-08-27 20:55:54 +02:00
Jorge A. Alfaro Murillo fc40d16bda org.texi: Fix typo
* doc/org.texi (Extracting source code): Fix typo.
2015-08-27 20:55:33 +02:00
Kyle Meyer 8b8476e995 Merge branch 'maint' 2015-08-22 16:52:07 -04:00
Kyle Meyer 6629a9b5ba org.texi: Fix typo
* doc/org.texi (Clocking commands): Fix typo.
2015-08-22 16:51:42 -04:00
Nicolas Goaziou 5269279bf4 Merge branch 'maint' 2015-08-19 16:51:29 +02:00
Nicolas Goaziou aa7dfd54de Revert "ox-latex.el: Resurrect `org-latex-with-hyperref'"
This reverts commit 6f41105bd9.
2015-08-19 16:45:01 +02:00
Bastien c9872990ed Merge branch 'maint' 2015-08-18 19:24:27 +02:00
Bastien 6f41105bd9 ox-latex.el: Resurrect `org-latex-with-hyperref'
* ox-latex.el (latex): Resurrect :latex-hyperref-p.
(org-latex-with-hyperref): Resurrect.
(org-latex-template): Use :latex-hyperref-p.

* org.texi (Beamer specific export settings)
(@LaTeX{} specific export settings): Mention both
`org-latex-hyperref-template' and `org-latex-with-hyperref'.

Thanks to Scott Randby for raising this issue.
2015-08-18 19:23:34 +02:00
Bastien 88cc2a422d Merge branch 'maint' 2015-08-18 18:02:57 +02:00
Grant Rettke ffbf9119cd org.texi: Fix case of `results' header-arg node
* org.texi (Top, Specific header arguments, var)
(Results of evaluation): Lowercase "results".
2015-08-18 18:02:30 +02:00
Bastien 86170ff501 Merge branch 'maint' 2015-08-16 16:02:20 +02:00
Bastien 55544780e2 ox-html.el (org-html-use-unicode-chars): Delete.
* ox-html.el (org-html-use-unicode-chars): Delete.
(html, org-html-final-function): Update.

* org.texi (Publishing options): Don't mention
`org-html-use-unicode-chars'.

Thanks to Vladimir Alexiev for raising this.
2015-08-16 16:01:57 +02:00
Nicolas Goaziou eb3b31c80b Implement Org linting
* lisp/org-lint.el: New file.

* doc/org.texi (Org syntax):
* etc/ORG-NEWS:  Document new feature.
2015-08-14 18:16:31 +02:00
Nicolas Goaziou c8e3bc2bbc org.texi: Fix compilation error
* doc/org.texi (Macro replacement): Fix typo.
2015-08-12 15:00:48 +02:00
tsdye 06026a16f9 org.texi: Edit date and time macros
* doc/org.texi (Macro replacement): Edit date and time macros.
2015-08-12 00:58:15 +02:00
Bastien 0d0d0ad56e Merge branch 'backport-master'
Conflicts:
	lisp/org-table.el
2015-08-05 01:01:46 +02:00
Bastien 49ef9d02a2 org.texi (Library of Babel): Tiny fix
* org.texi (Library of Babel): Tiny fix.

Thanks to Charles Millar for reporting this.
2015-08-05 00:58:24 +02:00
tsdye ee945acf98 org.texi: ob-languages and multiple sessions support 2015-07-27 10:18:32 +02:00
Kyle Meyer 6f9184a294 Merge branch 'maint' into backport-master 2015-07-26 23:56:50 -04:00
Paul Eggert 9347da11bf Backport commit 08782a2 from Emacs master branch
Prefer plain characters to Texinfo circumlocutions
08782a2ea95dec5662954a1de353a7da699ac339
Paul Eggert
Fri May 1 12:58:53 2015 -0700
2015-07-26 23:29:31 -04:00
Paul Eggert d3df9d203b Backport commit c33d89c from Emacs master branch
* doc/docstyle.texi: New file, which specifies treatment for
grave accent and apostrophe, as well as the document encoding.
* doc/org.texi: Use it instead of '@documentencoding UTF-8', to lessen the need for
global changes like this in the future.

Fix single-quoting style in PDF manuals
c33d89cc644f995510b13b951e4201879de2b6f8
Paul Eggert
Fri May 1 12:06:38 2015 -0700
2015-07-26 23:29:31 -04:00
Paul Eggert 961cf22823 Backport commit 279558f from Emacs master branch
Minor quoting etc. fixes to misc manuals
279558f472246dd19864f4175cb1d6061bc1ed92
Paul Eggert
2015-07-26 23:29:31 -04:00
Paul Eggert 0ee18fcf48 Backport commit 41278b7 from Emacs master branch
Spacing and punctuation fixes
41278b775bd3ebc213ff8b9eda2f2c04a5354bba
Paul Eggert
Tue Mar 17 16:56:21 2015 -0700
2015-07-26 23:29:30 -04:00
Paul Eggert 3935f05990 Backport commit 52a4e87 from Emacs master branch
Fix copyright years by hand
52a4e87c630ea397408efe4f8486be55e1199905
Paul Eggert
2015-07-26 23:29:30 -04:00
Glenn Morris fcce57324d Backport commit 2999341 from Emacs master branch
Add .info extension to @setfilename commands in doc
29993416fb4d19c1c3bb146367fc4bed74845486
Glenn Morris
Mon Jun 9 22:20:31 2014 -0400
2015-07-26 23:29:30 -04:00
Paul Eggert bf75f1bff8 Backport commit 02073b2 from Emacs master branch
* doc/misc/org.texi (The date/time prompt, Matching tags and properties):
Use leading zero with 24-hour times less than 10:00.

Fix some 24-hour time stamps in documentation.
02073b2e84022ff9c9b76d58061e9aa810056229
Paul Eggert
Thu Nov 13 19:16:15 2014 -0800
2015-07-26 23:28:24 -04:00
Paul Eggert 217ad4aafb Backport commit 123ddec from Emacs master branch
* doc/org.texi (Dynamic blocks):
* lisp/org-archive.el (org-archive-subtree)
(org-archive-to-archive-sibling):
* lisp/org-clock.el (org-resolve-clocks, org-clock-get-sum-start)
(org-clock-special-range):
* lisp/org-timer.el (org-timer-seconds):
* lisp/org.el (org-read-date-analyze, org-get-cursor-date):
* lisp/ox-html.el (org-html-format-spec):
* lisp/ox-icalendar.el (org-icalendar--vtodo):
Omit unnecessary call to current-time.
* lisp/org.el (org-get-cursor-date):
Don't call current-time twice to get the current time stamp,
as this can lead to inconsistent results.
* lisp/org-compat.el (org-float-time):
Simplify to an alias because time-to-seconds now behaves like float-time
with respect to nil arg.
* lisp/org-clock.el (org-clock-get-table-data): Omit unnecessary, lossy
conversion from floating point to Emacs time and back.
(org-resolve-clocks): Prefer two-argument floor.

Simplify use of current-time and friends.
123ddec7f807f4bd7400bbbe08219afb02269c00
Paul Eggert
Tue Oct 28 18:42:51 2014 -0700
2015-07-26 23:25:11 -04:00
Nicolas Goaziou c76fef6b9d org-clock: Add `untilnow' time block
* lisp/org-clock.el (org-clock-special-range): Handle `untilnow'
  range.
(org-clock--oldest-date): New variable.
(org-clock-display-default-range): Add `untilnow' as valid range.  Use
new variable.
(org-clock-display): Offer `untilnow' as a possible range.

* doc/org.texi (The clock table): Document `untilnow'

* testing/lisp/test-org-clock.el (test-org-clock-clocktable-contents-at-point): Fix test
when called interactively.
(test-org-clock/clocktable):
(test-org-clock/clocktable1): Update tests.
(test-org-clock/clocktable-until-now): New test.

* etc/ORG-NEWS (title): Document new feature.

Suggested-by: Sébastien Vauban
2015-07-04 14:31:34 +02:00
Rasmus c4a913770d Update minted documentation.
* ox-latex.el (org-latex-listings):
* org.texi (Literal examples): Update minted documentation.
2015-07-03 13:42:21 +01:00
Nicolas Goaziou 2c66e40c67 org.texi: Fix un-exportable table
* doc/org.texi (Column groups): Prevent "[4]" from being interpreted
  as a footnote reference so as to make table exportable.

Reported-by: Nicolas Richard <youngfrog@members.fsf.org>
<http://permalink.gmane.org/gmane.emacs.orgmode/98816>
2015-07-02 09:20:42 +02:00
Alan Schmitt d828f789a9 org.texi: Fix the :post example
* doc/org.texi (post): Add a missing colon in the example.
2015-06-23 23:36:46 +02:00
Nicolas Goaziou 0a45e4fcbc org.texi: Remove reference to unexistent filter
* doc/org.texi (Advanced configuration): Remove reference to
  quote-section filter.
2015-06-23 08:50:45 +02:00
Nicolas Goaziou 8ff31bd0cf ox-latex: Introduce :environment attribute for example blocks
* lisp/ox-latex.el (org-latex-example-block): Implement :environment
  attribute, which allows to override "verbatim" environment.
* doc/org.texi (@LaTeX{} specific attributes): Document change.
2015-06-23 08:43:07 +02:00
myq larson dd7f8af9f5 org.texi: Fix typo
* doc/org.texi (Timestamps): Fix typo.

TINYCHANGE
2015-06-21 00:00:04 +02:00
Bjarte Johansen f6c75f2e41 Org Babel now supports sed scripts
* doc/org.texi: Signal new babel language.

* lisp/ob-sed.el:
* testing/examples/ob-sed-test.org:
* testing/lisp/test-ob-sed.el: New files.
2015-05-30 14:59:01 +02:00
Nicolas Goaziou c77656f620 org.texi: Fix typo
* doc/org.texi (Texinfo specific attributes): Fix typo.
2015-05-26 01:14:51 +02:00
Nicolas Goaziou bc3cf21659 ox-texinfo: Handle @image
* lisp/ox-texinfo.el (org-texinfo-inline-image-rules): New variable.
(org-texinfo--inline-image): New function.
(org-texinfo-link): Use new function.

* doc/org.texi (Texinfo specific attributes):
* etc/ORG-NEWS:  Document new feature.
2015-05-26 01:14:24 +02:00
Nicolas Goaziou 09fface1a9 org.texi: Remove unnecessary @quotation
* doc/org.texi (The export dispatcher):
(Languages): Remove @quotation.
2015-05-15 15:29:06 +02:00
Nicolas Goaziou 1c49bdfe26 org.texi: Fix typo
* doc/org.texi (Macro replacement): Fix typo.
2015-05-15 15:28:47 +02:00
Nicolas Goaziou 0793fa9f1a org.texi: Add header separator in Babel languages table
* doc/org.texi (Languages): Add separator.
2015-05-15 15:28:15 +02:00
Nicolas Goaziou 2eb9913980 org.texi: Fix typo
* doc/org.texi (Languages): Fix typo.
2015-05-14 16:16:35 +02:00
Nicolas Goaziou 1b09dfbf4a org.texi: Reorder languages
* doc/org.texi (Languages): Reorder languages.
2015-05-14 16:14:49 +02:00
Nicolas Goaziou 849f0da717 org.texi: Add Fortran to supported languages
* doc/org.texi (Languages): Add Fortran.

Reported-by: Alain Cochard <Alain.Cochard@unistra.fr>
<http://permalink.gmane.org/gmane.emacs.orgmode/97534>
2015-05-14 16:10:35 +02:00
Nicolas Goaziou 56d9834acc org.texi: Fix typo
* doc/org.texi (Macro replacement): Fix typo introduced in
  fa5f8c8f90.
2015-05-10 11:58:34 +02:00
Nicolas Goaziou fa5f8c8f90 Allow optional argument to {{{property}}} for remote entries
* lisp/org-macro.el (org-macro-initialize-templates): "property"
  template accepts an optional argument, as a search option to grab
  properties from other headlines.

* doc/org.texi (Macro replacement): Document new feature.  Improve
  documentation.
(An example): Update documentation.

* testing/lisp/test-org-macro.el (test-org/macro-replace-all): Add
  tests.
2015-05-10 11:48:13 +02:00
Titus von der Malsburg 6779f8f424 Fix detection of latex fragments
* org-element.el (org-element-latex-fragment-parser):
* org.el (org-latex-regexps): Fix the detection of latex
  fragments.  Uses syntax tables to detect whitespaces and punctuation
  marks following the final $ sign.

In order to qualify as a math delimiter, the final $ sign of a LaTeX
fragment has to be followed by a whitespace or punctuation mark but the
regexp used in the previous code matched only a small number of
punctuation marks and therefore missed some latex fragments.
2015-05-09 09:36:53 +02:00
Bastien 86dcd90771 Merge branch 'maint' 2015-04-29 07:57:07 +02:00
Bastien 8cc7b72160 Backport commit 25166a91 from Emacs master branch. 2015-04-29 07:56:37 +02:00
Rasmus 7b8dacc348 org.texi: Document C-c ' key for footnotes
* org.texi (Footnotes): Add documentation on C-c '.
2015-04-28 00:05:37 +02:00
Jarmo Hurri 0d21d8d0ea ob-processing.el: Support for Processing language
* lisp/ob-processing.el: New file.

* doc/org.texi (Languages): Signal new language.

This library implements necessary functions for implementing editing
of Processing code blocks, viewing the resulting sketches in an
external viewer, and HTML export of the sketches.

Editing Processing blocks requires processing2-emacs mode. Viewing
Processing blocks embedded in Org buffer in an external viewer also
requires processing2-emacs. This viewing is bound to C-c C-v C-k and
produces no results in Org buffer. HTML export of the results of a
Processing block is also supported, assuming that the processing.js
module is available: the sketch is then drawn by the browser when the
HTML page is viewed. This drawing is implemented by embedding the
Processing code in a script using the processing.js module. The user
is responsible for making sure that processing.js is available in the
correct location.

Console output from a Processing block produced e.g. by println() is
shown in the Processing compilation window when the code is executed
in Org buffer, and in text area (console) of the browser when the code
is embedded in HTML.
2015-04-25 10:01:21 +02:00
Nicolas Goaziou ea4e8e3b2c org.texi: Remove `org-latex-custom-id-as-label'
* doc/org.texi (Publishing options): Remove
  `org-latex-custom-id-as-label'.

This variable was replaced with `org-latex-prefer-user-labels' in
4bbc054bd2.
2015-04-19 15:47:50 +02:00
Nicolas Goaziou 1841892321 org.texi: Introduce `org-latex-prefer-user-labels'
* doc/org.texi (Publishing options): Introduce
  `org-latex-prefer-user-labels'.
2015-04-19 15:46:24 +02:00
Nicolas Goaziou 0865cbb674 Merge branch 'maint' 2015-04-11 13:47:40 +02:00
François Allisson c000e87888 Fix documentation for org-capture template expansion
* doc/org.texi (Template expansion): Fix typo.

TINYCHANGE
2015-04-11 13:46:16 +02:00
Rasmus a780080fcf ox: Add #+SUBTITLE property in some backends
* ox-texinfo.el (texinfo, org-texinfo-template): Parse subtitle.
* ox-s5.el (org-s5-title-slide-template):
* ox-deck.el (org-deck-title-slide-template):
* ox-odt.el (odt, org-odt-template):
* ox-latex.el (latex, org-latex-template):
* ox-html.el (html, org-html-format-spec, org-html-template):
* ox-ascii.el (ascii, org-ascii-template--document-title):
* ox-beamer.el (beamer, org-beamer-template): Support #+SUBTITLE.
* ox-html.el (org-html-postamble-format)
(org-html-preamble-format):
* ox-latex.el (org-latex-title-command)
(org-latex-hyperref-template): Update docstring.
* ox-html.el (org-html-style-default): New .subtitle css property.
* ox-beamer.el (org-beamer-subtitle-format):
* ox-latex.el (org-latex-subtitle-format)
(org-latex-subtitle-separate): New variable.
* org.texi (ASCII/Latin-1/UTF-8 export)
(Beamer specific export settings)
(HTML Specific export settings)
(@LaTeX{} specific export settings, CSS support)
(ODT specific export settings)
(Texinfo specific export settings, Document preamble)
(Publishing options, Publishing options): Document #+SUBTITLE.

The patch adds a #+SUBTITLE keyword to ox-ascii, ox-latex, ox-html and
ox-odt.
2015-04-08 23:23:13 +02:00
Rasmus a7becba686 ox-html: Use viewport
* ox-html.el (org-html--build-meta-info): Insert viewport.
  (org-html-viewport): New custom variable.
* ORG-NEWS: Mention viewport.
* org.texi: Mention org-html-viewport.

Viewport makes org-generated html work well with small screens.
2015-04-08 12:06:09 +02:00
Nicolas Goaziou 8d22f8ec65 org.texi: Fix copyright year 2015-04-02 11:36:13 +02:00
Rasmus 5574e005d6 org.texi: Small fix
* org.texi (ODT export commands): Remove unnecessary heading.
2015-04-01 23:10:05 +02:00
Rasmus b1b8a86de5 org.texi: Changes to In-buffer settings
* org.texi (In-buffer settings): Remove keywords not defined in ox.el
2015-04-01 23:10:04 +02:00
Rasmus c0c3b0ce5a org.texi: New export keywords sections
* org.texi (Beamer specific export settings)
  (HTML Specific export settings)
  (@LaTeX{} specific export settings)
  (ODT specific export settings)
  (Texinfo specific export settings): New sections.
  (Beamer specific syntax): Removed some text.
2015-04-01 23:10:04 +02:00
Rasmus ccb7307535 Manuals: Remove DESCRIPTION and KEYWORDS
* org.texi (Export settings)
  orgguide.texi (Export options): Remove DESCRIPTION and KEYWORDS.
2015-04-01 23:10:04 +02:00
Rasmus 7ddb3af04a org.texi: Change beamer example to @example
* org.texi (A Beamer Example): Change to @example.
2015-04-01 23:10:04 +02:00
Rasmus a20dd23656 org.texi: Subsections in Beamer export
* org.texi (Beamer export): Add menu and change subheading to
subsection.
2015-04-01 23:10:04 +02:00
Nicolas Goaziou b9df29cdfc org.texi: Fix #+CATEGORY description
* doc/org.texi (In-buffer settings): Remove deprecated behaviour.
2015-03-31 22:01:28 +02:00
Rasmus 79c0aa21ca ox: Remove #+KEYWORD and #+DESCRIPTION
* ox.el: Remove #+KEYWORD: and #+DESCRIPTION:.
* ox-deck.el, ox-rss.el, ox-html, ox-latex, ox-odt, ox-org: Add
  #+KEYWORD and #+DESCRIPTION.
* org.texi (Export settings): Explicit state which backends
  support #+DESCRIPTION and #+KEYWORDS.
2015-03-29 14:08:13 +02:00
Nicolas Goaziou 188efec47c org.texi: Fix typo
* doc/org.texi (Comment lines): Fix typo.
2015-03-28 16:04:21 +01:00
Nicolas Goaziou 0ac26737f0 ox: Remove filter associated to comments
* lisp/ox.el (org-export-filters-alist): Remove reference to comment
  filters.
(org-export-filter-comment-functions,
org-export-filter-comment-block-functions): Remove variables.

* doc/org.texi (Advanced configuration): Remove reference to comment
  filters.

* etc/ORG-NEWS: Signal removal.

Comments are removed before parsing the buffer.  As a consequence,
filters are never called.
2015-03-28 10:45:36 +01:00
Nicolas Goaziou 47bad1ee9b org.texi: Suggest :noexport: as an alternative for COMMENT
* doc/org.texi (Comment lines): Suggest :noexport: as an alternative
  for COMMENT.
2015-03-28 10:10:53 +01:00
Gregor Zattler 830cf3e193 Document how to scroll calendar by one year at date prompt
* doc/org.texi (The date/time prompt): Add respective keys to the Key
  index.  Also justify the lines in this block to look prettier in
  info.

TINYCHANGE
2015-03-23 00:51:19 +01:00
Thierry Banel 921c7ad662 D is supported by Babel
* doc/org.texi: added D in the list of Babel supported languages
2015-03-17 16:11:27 +01:00
Nicolas Goaziou 16cea3d7b7 ox: Remove `comment' special value for `org-export-with-creator'
* lisp/ox.el (org-export-with-creator): Change default value.

* lisp/ox-ascii.el (org-ascii-template):
* lisp/ox-beamer.el (org-beamer-template):
* lisp/ox-latex.el (org-latex-template):
* lisp/ox-odt.el (org-odt-template):
* lisp/ox-org.el (org-org-template):
* lisp/ox-texinfo.el (org-texinfo-template): Treat
  `org-export-with-creator' as a boolean.

* testing/lisp/test-ox.el (test-org-export/parse-option-keyword):
  Update test.

* doc/org.texi (Export settings): Update allowed values in
  `org-export-with-creator'.

* etc/ORG-NEWS: Signal change.

Special `comment' value isn't meaningful for all back-ends and is not
implemented in every back-end where it makes sense anyway.

It is possible to add a comment including creator at the end of the
document using a body filter instead.
2015-03-17 15:51:22 +01:00
Gustav Wikström ecfd00cda8 org.texi: Complement info for group tags
group tags are more general and a name-change (or addition) is made in
the manual: tag groups are now called tag hierarchy.

Adding information about the added tag hierarchy functionality and
use-cases.
2015-03-16 22:27:41 +01:00
Rasmus 5fe3a68a79 org.texi: Fix typos
* org.texi (@LaTeX{} and PDF export): Correct typo.  Remove warning
  about ox-latex documents are incompatible with xetex and luatex.

Reported by: Reuben Thomas <rrt@sc3d.org>
<http://permalink.gmane.org/gmane.emacs.orgmode/96065>
2015-03-14 16:05:50 +01:00
Rasmus ac358cd351 org.texi: Small fix
* org.texi (In-buffer settings): Include ODT_STYLES_FILE and fix typo.
2015-03-14 13:57:42 +01:00
Nicolas Goaziou 69e6f4acaf org.texi: Remove references to deprecated syntax
* doc/org.texi (Moving subtrees):
(Weekly/daily agenda):
(Categories): Remove references to deprecated syntax.
2015-03-11 17:33:22 +01:00
Nicolas Goaziou 1de825df31 Fix CATEGORY property
* doc/org.texi (Special properties): Remove "CATEGORY"

* lisp/org.el (org-special-properties): Remove "CATEGORY".
(org-property-get-allowed-values): Ignore "CATEGORY".
(org-entry-get): Make sure to get CATEGORY value using
`org-entry-properties'.

* testing/lisp/test-org.el (test-org/entry-put): Add test.

"CATEGORY" is not a special property as it can also be set using
a properties drawer.
2015-03-11 17:12:49 +01:00
Matthew Gidden 3d01a0bd19 ox-beamer.el: Update BEAMER_HEADER placement
* lisp/ox-beamer.el (`beamer-header'): Move BEAMER_HEADER injection to
  final part of preamble (after themes, title, etc.).  Allows for
  custom short titles, etc., with #+BEAMER_HEADER:
  \title[Short]{Long}.

* doc/org.texi: Updated BEAMER_HEADER entry with a relevant footnote.

Previously, TITLE, etc., was being injected after BEAMER_HEADER, so
short titles (and related) could not be added.  BEAMER_HEADER now
serves as a final preamble injection point.

TINYCHANGE
2015-03-10 21:20:29 +01:00
Robert Pluim d4c19a1c85 org.texi: Correct reference to `org-agenda-persistent-marks'
* org.texi (Agenda commands): Correct reference to
  `org-agenda-persistent-marks'.
2015-03-06 11:52:51 +01:00
Rasmus 8c54b254b1 ox-html: Use upstream MathJax CDN
* ox-html.el (org-html-mathjax-options): Add multlinewidth,
  autonumber, tagindent, font, linebreaks and tagside.  Remove MathML.
  Change default indent to correspond to upstream default.  Change
  default MathJax path to point to upstream CDN.
  (org-html--build-mathjax-config): Remove MathML-related parts.
  (org-html-mathjax-template): Simplifiy template.
* org.texi (@LaTeX{} fragments), (Math formatting in HTML export):
  Reflect change in default CDN.
* ORG-NEWS: Document changes.
2015-02-27 13:57:58 +01:00
Rasmus f82dad1237 org.el: More general TeX to MathML convert support
* org.el (org-latex-to-mathml-convert-command): Work with
  other converters than mathtoweb.
  (org-latex-to-mathml-convert-command): Add possibility of
  passing latex-fragment.
* org.texi (Working with @LaTeX{} math snippets): Show LaTeXML config.
2015-02-26 15:49:34 +01:00
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