Commit Graph

2534 Commits

Author SHA1 Message Date
Lambda Coder b4978e271b doc/org.texi: Editorial revisions to the manual
Chapters edited in this revision:
* From Working with source code chapter to end of manual
2016-12-04 00:42:29 +01:00
Kyle Meyer bc0bebbc43 Merge branch 'maint' 2016-11-19 16:50:37 -05:00
Eli Zaretskii d31c8ef17c Backport commit 5b0cddd from Emacs
* doc/orgcard.tex: Change "GNU Emacs" to "this document" in copyright
notices.  (Bug#24520)

More fixes in copyright notices in etc/refcards/
5b0cddd91535025bbf0c69d17e2d4e470dd350c5
Eli Zaretskii
Tue Nov 15 19:01:07 2016 +0200
2016-11-19 16:50:27 -05:00
Eli Zaretskii 68760e703e Backport commit f994c20 from Emacs
* doc/orgcard.tex: Update the copyright blurb.  (Bug#24520)

Update copyright text in refcards
f994c2046588b168c1a4a900879cdffaf9d02f01
Eli Zaretskii
Sun Nov 13 18:20:59 2016 +0200
2016-11-19 16:49:19 -05:00
Nicolas Goaziou 0a24f50136 Merge branch 'maint' 2016-11-18 09:37:53 +01:00
Nicolas Goaziou 400186d839 org.texi: Small fixes
* doc/org.texi (Structure of code blocks): Remove too recent
  @indentedblock structure and fix some @ref, @xref, @pxref uses.
2016-11-18 09:36:47 +01:00
Nicolas Goaziou 56f1b8095f Merge branch 'maint' 2016-11-17 23:54:57 +01:00
Lambda Coder b9ed40c4b5 org.texi: Reword Babel chapter
* doc/org.texi (Template elements):
(Tables in @LaTeX{} export):
(Working with source code):
(Structure of code blocks):
(Editing source code):
(Exporting code blocks):
(Extracting source code):
(Evaluating code blocks):
(Library of Babel):
(Languages):
(Header arguments):
(Using header arguments):
(System-wide header arguments):
(Language-specific header arguments):
(Header arguments in Org mode properties):
(Language-specific header arguments in Org mode properties):
(Code block specific header arguments):
(Header arguments in function calls):
(Specific header arguments):
(var):
(results):
(file-desc):
(file):
(output-dir):
(dir):
(exports):
(comments):
(padline):
(no-expand):
(session):
(noweb):
(noweb-ref):
(noweb-sep):
(cache):
(sep):
(hlines):
(colnames):
(rownames):
(shebang):
(tangle-mode):
(eval):
(wrap):
(post):
(prologue):
(Results of evaluation):
(Noweb reference syntax):
(Key bindings and useful functions):
(Batch execution): Improve wording.
2016-11-17 23:36:08 +01:00
Nicolas Goaziou 047451c29d org.texi: Fix typo
* doc/org.texi (Exporting code blocks): Fix typo.
2016-11-14 08:43:08 +01:00
Charles Berry 3b5ce449c4 Replace `org-export-babel-evaluate' with `org-export-use-babel'
* lisp/ob-exp.el (org-babel-exp-process-buffer): Change variable
  name `org-export-babel-evaluate' to `org-export-use-babel'.  Also
  change the name in its `defcustom' and set the `:safe' key.

* lisp/ox-icalendar.el (org-icalendar-export-current-agenda): Change
  variable name.

* lisp/ox.el (org-export-as): Change variable name.

* doc/org.texi (Exporting code blocks): Change variable name.  Amplify
   the explanation of what the variable does.  Add variable index entry.

* testing/lisp/test-ob-exp.el: Change variable name.

* testing/lisp/test-ob-lob.el: Change variable name.

* testing/lisp/test-ox.el: Change variable name.

Users were often confused that setting this variable to `nil' will
cause header arguments to be ignored in addition to preventing code
from being evaluated.  It is hoped that the documentation changes and
the name `org-export-use-babel' will better convey that everything
babel does can be switched off with this variable.
2016-11-13 15:29:33 -08:00
Nicolas Goaziou 45f25aea75 Merge branch 'maint' 2016-11-13 18:10:53 +01:00
Nicolas Goaziou 928e18dff9 org.texi: Fix typo
* doc/org.texi (External links): Fix typo.
2016-11-13 18:10:25 +01:00
Nicolas Goaziou 8a5e54f1cc Small fix to documentation
* doc/org.texi (Setting tags): Remove misleading information.
* lisp/org.el (org-tag-alist): Fix consistency with
  `org-tag-persistent-alist'.
2016-11-13 18:08:15 +01:00
Nicolas Goaziou 3375671e83 Merge branch 'maint' 2016-11-12 01:45:46 +01:00
Nicolas Goaziou ff0748beac Small documentation fixes
* doc/org.texi (The very busy C-c C-c key):
* lisp/org.el (org-startup-folded): Documentation fixes.
2016-11-12 01:45:05 +01:00
Nicolas Goaziou c535f54330 Merge branch 'maint' 2016-11-10 16:05:33 +01:00
Nicolas Goaziou dd2a0d3361 org.texi: More pregnant DEADLINE position in entries
* doc/org.texi (Deadlines and scheduling): Insist on the location for
  planning keywords.
(Inserting deadline/schedule): No need to specify the functions add
planning keywords at an appropriate location.
2016-11-10 16:02:46 +01:00
Nicolas Goaziou 8dc2d77678 Merge branch 'maint' 2016-11-07 01:16:29 +01:00
Nicolas Goaziou 13dbea95af Fix documentation
* doc/org.texi (Installation):
(Feedback):
(Handling links):
(Setting tags):
(Matching tags and properties):
(Storing searches):
(The very busy C-c C-c key):
(org-crypt):
(Adding hyperlink types):
* lisp/org-agenda.el (org-agenda-todo-ignore-deadlines):
(org-agenda-show-inherited-tags):
(org-agenda-week-view):
(org-agenda-fortnight-view):
(org-agenda-month-view):
(org-agenda-year-view):
* lisp/org-archive.el (org-archive-to-archive-sibling):
* lisp/org-capture.el (org-capture-templates):
* lisp/org-table.el:
* lisp/org.el (org-startup-folded):
(org-tag-alist):
(org-match-sparse-tree): Provide more accurate documentation.

Reported-by: Jorge Morais Neto <jorge13515@gmail.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/110080>
2016-11-07 01:14:04 +01:00
Nicolas Goaziou 2c0d8774b4 ox-latex: Allow horizontal rules in table math mode
* lisp/ox-latex.el (org-latex--math-table): Handle horizontal rules.
* doc/org.texi (Tables in @LaTeX{} export): Update documentation.
2016-11-06 23:31:54 +01:00
Nicolas Goaziou f5645675a3 Disallow S-exp in capture templates
* lisp/org-capture.el (org-capture-expand-file): Disallow S-exp.
(org-capture-templates):
* doc/org.texi (Template elements): Update documentation.

A function is equivalent to using S-exp, without tainting code with an
yet another call to `eval'.
2016-11-04 17:41:27 +01:00
Nicolas Goaziou 1e43168ff8 org.texi: Fix typo
* doc/org.texi (Template expansion): Fix typo.
2016-10-19 20:46:15 +02:00
Nicolas Goaziou e4c38ab1d3 Improve documentation for capture templates
* doc/org.texi (Template expansion):
* lisp/org-capture.el (org-capture-templates): Clarify documentation.

Suggested-by: Stig Brautaset <stig@brautaset.org>
<http://permalink.gmane.org/gmane.emacs.orgmode/109844>
2016-10-19 19:23:31 +02:00
Nicolas Goaziou d3e338dc0a org.texi: Add missing blank line
* doc/org.texi (Using the property API): Add missing blank line.
2016-10-11 21:00:58 +02:00
Marco Wahl 17e73cf949 Merge branch 'maint' 2016-10-02 19:08:45 +02:00
Marco Wahl 194e51e102 doc/orgcard.tex: Fix compile-command 2016-10-02 19:07:26 +02:00
Nicolas Goaziou eda8ac493f Fix inconsistencies in `org-occur' binding
* doc/org.texi (Sparse trees): Add C-c / / binding for `org-occur'.
* lisp/org.el (org-sparse-tree): Mention "r" suffix for consistency with
  other entries in the help menu.
2016-10-02 00:30:14 +02:00
Nicolas Goaziou 7075704b09 org.texi: Fix documentation about C-RET and M-RET
* doc/org.texi (Structure editing): Fix documentation, which is no
  longer in sync with the current behavior of the commands.
2016-10-02 00:19:51 +02:00
Nicolas Goaziou 12196b8472 Fix documentation
* doc/org.texi (Conventions): Remove unhelpful and wrong footnote.
(Initial visibility): Remove spurious paragraph.
(Global and local cycling):
(Motion): Fix function name.
(Plain lists): Reverse prefix argument action.
(Column width and alignment):
(Column groups):
(Tag inheritance):
(Tag hierarchy):
(The date/time prompt): Fix typo
(Link abbreviations):
(Tag searches):
(Timers): Fix wording.
(Checkboxes): Improve accuracy of footnote.  Correctly describe the
behaviour of `org-toggle-checkbox' on a headline.
(Filtering/limiting agenda items): More accurate description for `+' and
`-'.  Also remove unused `\' key.
(Agenda commands): Fix behaviour description.

* lisp/org-agenda.el (org-agenda-filter-by-tag): Fix docstring
  appearance.
(org-agenda-show-and-scroll-up): Fix wording.

* lisp/org-id.el (org-id-link-to-org-use-id): Fix function name.
(org-id-update-id-locations): Remove reference to unused argument.

* lisp/org.el (org-insert-heading): Improve docstring.
(org-insert-todo-heading): Describe behavior on a plain list item.
(org-update-statistics-cookies): Describe behavior when called with
a prefix argument.
(org-metaright): Fix typo.
(org-kill-note-or-show-branches): Fix function name.
(org-yank): Fix wording.

Reported-by: Jorge <jorge13515@gmail.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/109428>
2016-09-29 22:22:56 +02:00
Rasmus e03e837168 org-src: New syntax for source blocks faces
* doc/org.texi (Editing source code): Document changes.
* lisp/org-faces.el (org-block): Update docstring.
  (org-src-block-faces): New defcustom for source-block faces.
* lisp/org-src.el (org-src-font-lock-fontify-block): Use
  org-src-block-faces.
* etc/ORG-NEWS: Update NEWS entry.
2016-09-22 09:31:43 +02:00
Nicolas Goaziou 8f39d832df org.texi: Document smart quotes behavior
* doc/org.texi (Export settings): Explain smart quotes behavior.
2016-09-18 23:16:33 +02:00
Nicolas Goaziou a1f51c8655 org.texi: Fix typo
* doc/org.texi (Special symbols): Fix typo.
2016-09-18 16:30:03 +02:00
Nicolas Goaziou c74f4c9cf8 org.texi: Move subscripts section outside of Embedded LaTeX section
* doc/org.texi (Subscripts and superscripts): Move outside of Embedded
  LaTeX section.  Document multi-words sub- superscripts.
2016-09-18 01:16:48 +02:00
Nicolas Goaziou 53373285f7 org.texi: Improve special symbols section
* doc/org.texi (Special symbols): Add details about `org-entities-help'
  and entities as a way to escape characters in Org.  Also move the
  section outside of LaTeX markup.
2016-09-18 01:00:41 +02:00
Nicolas Goaziou e8c8386687 org.texi: Remove useless footnote
* doc/org.texi (OpenDocument Text export): Remove useless reference to
  old Org releases since the manual is tied to a specific version.
2016-09-17 23:32:59 +02:00
Jake Romer d4a073f5be ox-md.el: Export footnotes section as Markdown
* lisp/ox-md.el (org-md--headline-title): New function.
(org-md-headline): Use `org-md-headline-title' to generate section
headers.
(org-md--footnote-formatted): New function.
(org-md--footnote-section): New function.
(org-md-inner-template): Update to use `org-md-footnote-section'.
(org-md-footnotes-section): New customizable variable.
(org-md-footnote-format): New customizable variable.

Update ox-md.el to export the Footnotes section as Markdown, using HTML
only where necessary - namely, in footnote and footnote reference links.
2016-09-01 18:41:52 +02:00
Nicolas Goaziou a4cb6463d0 org.texi: Add Lua to supported languages
* doc/org.texi (Languages): Add Lua to the list of supported languages.
2016-08-29 08:57:10 +02:00
Nicolas Goaziou 71a3331aaf Move org-eww to core
* lisp/org-eww.el: Move file from contrib/lisp/ to lisp/.
* lisp/org.el (org-modules): Apply change.
* lisp/org-capture.el (org-capture-templates):
* doc/org.texi: Document changes.
2016-08-20 02:59:56 +02:00
Nicolas Goaziou 661987e121 org.texi: Reorder two sections
* doc/org.texi (Exporting): Update menu.
(Export in foreign buffers): Move this section...
(Other built-in back-ends): ... past this one.
2016-08-19 16:06:49 +02:00
Nicolas Goaziou 888c3652c5 org.texi: Remove useless section
* doc/org.texi (Exporting): Reword section.
(Export back-ends): Remove section.
2016-08-19 16:04:49 +02:00
Nicolas Goaziou fb517fabc0 org.texi: Remove outdated comments
* doc/org.texi: Remove outdated comments.
2016-07-26 20:35:35 +02:00
Jarmo Hurri 04e0bc0b00 ox-html: Provide a default CSS class for embedded SVG images
* lisp/ox-html.el (org-html--svg-image): Set CSS class of embedded SVG
images to be org-svg if no other class is set in attributes.
org-html-style-default: Provide default properties for new CSS class.

* doc/org.texi (CSS support): Documentation of default CSS class
org-svg for SVG images embedded into exported HTML.
2016-07-26 10:37:17 +02:00
Nicolas Goaziou 096f4287a6 ox-latex: Allow toggling centering of images
* lisp/ox-latex.el (latex): Introduce new
  property :latex-images-centered.
(org-latex-images-centered): New variable.
(org-latex--inline-image): Handle new attribute :center, in addition to
variable above.
* doc/org.texi (Images in @LaTeX{} export): Document new behaviour
(Publishing options): Reference :latex-images-centered.
2016-07-25 23:31:25 +02:00
Nicolas Goaziou a9fe21f218 org.texi: Merge "markup" related nodes
* doc/org.texi (Top): Update master menu.

(Structural markup elements): Splice contents of this node...
(Markup): ... here.

(Paragraphs): Add concept index entries

(Emphasis and monospace):
(Horizontal rules): Make those a section.
2016-07-23 16:35:29 +02:00
Nicolas Goaziou 98258c72cd org.texi: Remove "Special blocks" node
* doc/org.texi (Special blocks): Remove node.
(Top):
(Markup): Update menus.
2016-07-23 16:09:52 +02:00
Nicolas Goaziou b94ef2e3d7 org.texi: Move "Comment lines" and "Table of contents"
* doc/org.texi (Top): Update menu.
(Structural markup elements): Move "Table of contents" and "Comment
lines" nodes from here...
(Exporting): ... to there.
2016-07-23 16:05:12 +02:00
Nicolas Goaziou 8168c61ebc org.texi: Remove duplicates nodes
* doc/org.texi (Top):
(Document title):
(Headings and sections):
(Lists):
(Footnote markup): Remove sections.
(Export settings): Add a concept index entry.
2016-07-23 15:54:34 +02:00
Nicolas Goaziou c48c840d76 org.texi: Move "Include files" and "Macro replacement" nodes
* doc/org.texi (Top): Update menu
(Markup): Move "Include files" and "Macro replacement" nodes from here...
(Exporting): ... to there.
2016-07-23 15:44:58 +02:00
Nicolas Goaziou 9de3143931 org.texi: Move "Index entries" within publishing section
* doc/org.texi (Include entries): Move contents...
(Generating an index): ... here.
(Top):
(Markup): Update menus.
2016-07-23 15:39:18 +02:00
Nicolas Goaziou e5598c4bd4 org.texi: Fix typo
* doc/org.texi (Texinfo specific export settings): Fix typo.
2016-07-23 14:55:21 +02:00
Nicolas Goaziou 713d2908da org.texi: Improve Texinfo documentation
* doc/org.texi (Top):
(Texinfo export): Update menus.

(Texinfo file header):
(Texinfo title and copyright page):
(Texinfo @samp{Top} node): New nodes.
2016-07-23 14:53:58 +02:00
Nicolas Goaziou ec281e8d2b org.texi: Small rewording
* doc/org.texi (Exporting): Small rewording.  Write about Texinfo
  export.
2016-07-23 14:29:41 +02:00
Nicolas Goaziou 9cb6eb2731 org.texi: Improve a section name
* doc/org.texi (Top):
(Texinfo export): Update menus.
(A Texinfo example): Rename to something more specific.
2016-07-23 14:23:56 +02:00
Nicolas Goaziou bf54ff5830 org.texi: Spread Texinfo export back-end attributes
* doc/org.texi (Top): Update master menu.
(Texinfo export): Update menu.
(Images in Texinfo export):
(Special blocks in Texinfo export):
(Tables in Texinfo export):
(Quoting Texinfo code): New sections.
2016-07-23 14:18:11 +02:00
Nicolas Goaziou 0f68b43133 org.texi: Small reordering in HTML export section
* doc/org.texi (Top): Update master menu.
(HTML doctypes): Remove useless @subsubheading.  Change index entries
locations, small improvement to a variable value.
2016-07-23 14:06:31 +02:00
Nicolas Goaziou 8e92216a7c org.texi: Spread LaTeX export back-end documentation
* doc/org.texi (Top): Update master menu
(@LaTeX{} export): Update menu.

(@LaTeX{} header and sectioning):
(Quoting @LaTeX{} code):
(Images in @LaTeX{} export):
(Plain lists in @LaTeX{} export):
(Source blocks in @LaTeX{} export):
(Special blocks in @LaTeX{} export):
(Horizontal rules in @LaTeX{} export): New subsections.
2016-07-23 13:56:29 +02:00
Nicolas Goaziou 9ee185c3af org.texi: Rename `latex' export back-end section
* doc/org.texi (Top):
(Exporting):
(Beamer export):
(Beamer specific syntax):
(JavaScript support): Rename `latex' export back-end section.

The PDF output format is not specific to `latex' back-end so it doesn't
need to be part of the section name.
2016-07-23 12:09:39 +02:00
Nicolas Goaziou c4b68a13a1 org.texi: Update default export back-ends
* doc/org.texi (Export back-ends): Notify that `odt' back-end is loaded
  by default.
2016-07-23 12:04:59 +02:00
Nicolas Goaziou 8fe6f27512 Deprecate "file+application" link types
* doc/org.texi (External links): Remove "file+emacs" and "file+sys"
  syntax.
* lisp/org-compat.el (org): Support "file+emacs" and "file+sys" for the
  time being.
* lisp/org-lint.el (org-lint--checkers): Add checker for obsolete link
  types.
(org-lint-file-application): New function.
* lisp/org.el (org-link-parameters): Remove deprecated link types.
2016-07-18 23:45:52 +02:00
John Kitchin 4e42012090 Update the texinfo for link parameters documentation 2016-07-18 22:47:51 +02:00
Nicolas Goaziou f38f83b4f1 Remove deprecated syntax for Babel properties
* doc/org.texi (Header arguments in Org mode properties): Remove
  reference to deprecated syntax.
* lisp/ob-core.el (org-babel-params-from-properties): Ignore deprecated
  syntax.
* testing/examples/babel.org:
* testing/examples/normal.org:
* testing/examples/ob-header-arg-defaults.org:
* testing/examples/property-inheritance.org:
* testing/lisp/test-ob-header-arg-defaults.el
(test-ob-header-arg-defaults/global/noweb):
(test-ob-header-arg-defaults/global/call):
(test-ob-header-arg-defaults/tree/overwrite/call):
(test-ob-header-arg-defaults/tree/overwrite/noweb):
(test-ob-header-arg-defaults/tree/accumulate/call):
(test-ob-header-arg-defaults/tree/accumulate/noweb):
(test-ob-header-arg-defaults/tree/complex/call):
(test-ob-header-arg-defaults/tree/complex/noweb):
* testing/lisp/test-ob.el (test-ob/elisp-in-header-arguments):
* testing/lisp/test-property-inheritance.el
(test-org-property-accumulation-overwrite-use): Update syntax.
(test-org-property-accumulation-append-use): Use new syntax.
(test-org-property-accumulation-top-val)
(test-org-property-accumulation-overwrite-val)
(test-org-property-accumulation-append-val): Remove tests.
2016-07-04 00:41:56 +02:00
Don March 86e592cb66 Reschedule "++" repeaters on same day if in future
* lisp/org.el (org-auto-repeat-maybe): Include the time in a
  timestamp (hours and minutes) when checking if a repeat occurrence is
  in the future.
* doc/org.texi (Repeated Tasks): Document repeat occurrences with a time
  in the timestamp.
2016-07-01 10:59:20 +02:00
Nicolas Goaziou e33ca741c0 org.texi: Fix typo
* doc/org.texi (Sources and destinations): Add missing word.
2016-06-22 18:36:29 +02:00
Nicolas Goaziou 5cd793c59a ox-publish: Change signature for preparation and completion functions
* doc/org.texi (Sources and destinations): Document new signature.
* lisp/ox-publish.el (org-publish-project-alist): Update docstring.
(org-publish-projects): Call preparation and
completion functions with the project properties as the sole argument.

`project-plist' used to be dynamically scoped.  This is no longer
possible due to the switch to lexical binding.

Reported-by: Arun Isaac <arunisaac@systemreboot.net>
<http://permalink.gmane.org/gmane.emacs.orgmode/107856>
2016-06-22 15:31:48 +02:00
Nicolas Goaziou ed8dea83a9 orgguide: Mirror changes to Org manual
* doc/orgguide.texi (Installation):
(Clean view): Remove references to old Emacsen or XEmacs.
2016-06-15 13:17:32 +02:00
Nicolas Goaziou a101aad97c org.texi: Fix left-overs from src block syntax change
* doc/org.texi (Evaluating code blocks):
(results):
* doc/orgguide.texi (HTML export):
(@LaTeX{} and PDF export): Use "#+begin_export" foo instead of
"#+begin_foo".
2016-06-15 13:15:08 +02:00
Nicolas Goaziou 1ee633ecf1 org.texi: Fix previous commit
* doc/org.texi (Plain lists): Remove reference to filladapt, which is
  not needed to fill plain lists.
2016-06-15 11:44:15 +02:00
Nicolas Goaziou 1e6a0d2268 org.texi: Remove spurious white spaces
* doc/org.texi (Clean view): Remove spurious white spaces.
2016-06-15 11:40:04 +02:00
Nicolas Goaziou c258605f7d org.texi: Remove unnecessary external package references
* doc/org.texi (Cooperation): Remove references to packages Org no
  longer cooperate with.
2016-06-15 11:34:26 +02:00
Nicolas Goaziou 27857f952f org.texi: Remove references to older Emacsen
* doc/org.texi (Activation):
(Handling links):
(Literal examples in ODT export):
(In-buffer settings):
(Clean view):
(Cooperation):
(Conflicts): Assume Emacs is at least 24.3, so remove any reference to
Emacsen earlier than this release.
2016-06-15 11:30:46 +02:00
Nicolas Goaziou 1da065ba21 org.texi: Remove XEmacs references
* doc/org.texi (Installation):
(Activation):
(Feedback):
(Sparse trees):
(Plain lists):
(Column width and alignment):
(dir): Remove XEmacs references.
2016-06-15 11:13:09 +02:00
Rasmus af463605f1 Document org-block face changes
* doc/org.texi (Editing source code): Document org-block and
  org-block-LANG faces.
* lisp/org-faces.el (org-block): Mention org-block-LANG faces.
* lisp/org.el (org-src-fontify-natively): Add reference to org-block.
* etc/ORG-NEWS: Update entry.
2016-06-10 10:11:03 +02:00
Matt Lundin c702dd0034 Remove paragraph about obsolete variables
* doc/org.texi: Remove paragraph documenting now obsolete variables
  `org-completion-use-ido' and `org-completion-use-iswitchb'.
2016-06-01 19:28:02 +02:00
Brian J. Carlson 3179d30683 org.texi: Updated doc for [+-]n in SRC/EXAMPLE export
* doc/org.texi (Timers): Added information about optional argument to
  -n/+n line-numbering
* etc/ORG-NEWS: Added infomation for "Provide offset to [+-]n in
  SRC/EXAMPLE export"  (commit af8e3d8)
2016-05-31 22:35:21 +02:00
Rasmus 888ebfdeaf ox-latex: More robust repeated footnote references
* lisp/ox-latex.el (org-latex--delayed-footnotes-definitions): Fix typo
  in docstring.
(org-latex-footnote-defined-format): New defcustom.
(org-latex-footnote-reference): Refer to repeated footnotes using
labels.  Format using new defcustom.
* etc/ORG-NEWS: Mention change.
* doc/org.texi (Publishing options): Add new defcustom.
2016-05-25 09:14:52 +02:00
Feng Shu bf93e166be Use dvisvgm to preview latex formulas
* ox-html.el (org-html-with-latex): Add dvisvgm support.
(org-html-with-latex): Add dvisvgm support.
(org-html-format-latex): "ltxpng" -> "ltximg".
(org-html-latex-environment): Add dvisvgm support.
(org-html-latex-fragment): Add dvisvgm support.

* org.el (org-preview-latex-default-process): New variable.
(org-latex-create-formula-image-program): Rename it to `org-preview-latex-default-process'.
(org-latex-preview-ltximg-directory): Rename it to `org-preview-latex-image-directory'.
(org-preview-latex-image-directory): New variable.
(org--format-latex-make-overlay): Add optional image-type, which used to deal with svg.
(org-toggle-latex-fragment): "org-ltxpng" -> "org-ltximg".
(org-format-latex): Add dvisvgm support.
(org-create-formula-image): Big refactor, merge dvipng and imagemagick
backend's feature.  Add dvisvgm feature.
(org-preview-latex-process-alist): Add new variable, which used to set
latex preview processes.
(org-create-formula-image-with-dvipng):
(org-create-formula-image-with-imagemagick): Useless, removed.

* org.texi (@LaTeX{} fragments):
(Previewing @LaTeX{} fragments):
(Math formatting in HTML export):
(Working with @LaTeX{} math snippets): Add dvisvgm information.
2016-05-21 10:50:38 +02:00
Nicolas Goaziou 8eb582b951 ox-texinfo: Allow :options attribute on special blocks
* lisp/ox-texinfo.el (org-texinfo-special-block): Handle :options
  attribute.
* doc/org.texi (Texinfo specific attributes): Add special block section.
2016-05-19 19:15:55 +02:00
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
Nicolas Goaziou ea98632e3b Merge branch 'maint' 2016-04-08 22:52:32 +02:00
Nicolas Goaziou d522fc8853 orgguide: Fix mis-uses of itemx
* doc/orgguide.texi (Agenda commands): Fix mis-uses of itemx.

Reported-by: Jean-Christophe Helary <jean.christophe.helary@gmail.com>
<http://permalink.gmane.org/gmane.emacs.orgmode/106211>
2016-04-08 22:51:04 +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 74e35a9154 doc/orgguide.texi: uncomment the license 2015-08-05 01:44:41 +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
Paul Eggert bb77dd2e88 Backport commit 7e09ef0 from Emacs master branch
Update copyright year to 2015
7e09ef09a479731d01b1ca46e94ddadd73ac98e3
Paul Eggert
Thu Jan 1 14:26:41 2015 -0800
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
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
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
Nicolas Goaziou 9209aa3c9d org-table: Use "ox.el" internally for radio tables
* lisp/org-table.el (org-table-clean-before-export, orgtbl-get-fmt,
  orgtbl-apply-fmt, orgtbl-eval-str, orgtbl-format-line,
  orgtbl-format-section): Remove functions.
(org-table-clean-did-remove-column, *orgtbl-table*, *orgtbl-rtn*,
  *orgtbl-hline*, *orgtbl-sep*, *orgtbl-default-fmt*, *orgtbl-fmt*,
  *orgtbl-efmt*, *orgtbl-lfmt*, *orgtbl-llfmt*, *orgtbl-lstart*,
  *orgtbl-llstart*, *orgtbl-lend*, *orgtbl-llend*): Remove variables.

(org-table-export, orgtbl-send-table): Apply function removal.  Do not
set `org-table-last-alignment' and `org-table-last-column-widths'
anymore.
(org-table-to-lisp, orgtbl-send-replace-tbl): Small refactoring.

(org-table--to-generic-table, org-table--to-generic-row,
org-table--to-generic-cell): New functions.
(orgtbl-to-generic): Rewrite function.  Handle :skip and :skipcols
parameters.
(orgtbl-to-latex, orgtbl-to-html, orgtbl-to-texinfo, orgtbl-to-orgtbl,
orgtbl-to-unicode): Use new `orgtbl-to-generic' features.

* testing/lisp/test-org-table.el (test-org-table/to-generic,
  test-org-table/to-latex, test-org-table/to-texinfo,
  test-org-table/to-html, test-org-table/to-unicode,
  test-org-table/send-region): New tests.

* doc/org.texi (Radio tables, A @LaTeX{} example, Translator
  functions): Update documentation.

* etc/ORG-NEWS (argument): Document new features.
2014-09-13 15:10:26 +02:00
Nicolas Goaziou c235bd83d2 ox: Implement body filter
* lisp/ox.el (org-export-filters-alist): Add body filter.
(org-export-filter-body-functions): New variable.
(org-export-as): Call body filter.

* doc/org.texi (Advanced configuration):
* etc/ORG-NEWS (argument): Document new filter.
2014-09-06 10:28:38 +02:00
Nicolas Goaziou 4b9146cd68 org.texi: Tiny fix 2014-09-04 22:14:23 +02:00
Nicolas Goaziou 9798a5d524 Merge branch 'maint' 2014-09-03 19:56:47 +02:00
Nicolas Goaziou dc16617f46 orgguide.texi: Small fixes
* doc/orgguide.texi (Export options): Small fixes.

Thanks to Alexis Roda for reporting them.
2014-09-03 19:55:20 +02:00
Nicolas Goaziou d4e4b1ea68 Merge branch 'maint' 2014-09-02 14:56:16 +02:00
Nicolas Goaziou 51f2730d7f org.texi: Fix Texinfo export documentation 2014-09-02 14:54:22 +02:00
Nicolas Goaziou 4dd9f392c1 Merge branch 'maint' 2014-08-24 21:56:57 +02:00
Nicolas Goaziou 896fa6d1f7 orgguide: Fix keybinding
* doc/orgguide.texi (Clocking work time): Fix keybinding.
2014-08-24 21:56:12 +02:00
Nicolas Goaziou 86283db227 org.texi: Add missing publishing properties
* doc/org.texi (Publishing options): Add missing properties.
2014-08-21 10:51:19 +02:00
Nicolas Goaziou 6400c9a8e5 Merge branch 'maint'
Conflicts:
	doc/org.texi
	lisp/ox-texinfo.el
2014-08-11 15:00:57 +02:00
Nicolas Goaziou 595cfd57dc org.texi: Document menus in Texinfo export
* doc/org.texi (Headings and sectioning structure): Document menus.
2014-08-11 14:56:01 +02:00
Nicolas Goaziou eb234d2b45 Merge branch 'maint' 2014-08-08 23:57:45 +02:00
Nicolas Goaziou 85bfda77ed org.texi: Fix typo 2014-08-08 23:57:16 +02:00