Commit Graph

2437 Commits

Author SHA1 Message Date
Nicolas Goaziou 42f3daf6cf Merge branch 'maint' 2017-05-14 23:54:39 +02:00
Lambda Coder 6ce21caac5 Editorial revisions to the manual
* doc/org.texi: Exporting chapter
2017-05-14 23:43:33 +02:00
Nicolas Goaziou be90287802 Merge branch 'maint' 2017-04-16 09:00:04 +02:00
aviv 842a75828f Updating MathJax CDN links
* doc/org.texi : Change reference to "cdn.mathjax.org" to "cdnjs.com",
  removing comment about no longer relevant terms of service.
* lisp/ox-html.el (org-html-mathjax-options) : Change link to
  appropriate cdnjs.com link to load MathJax.

Updating MathJax CDN links to reflect cdnjs.com as cdn.mathjax.org
will be disconitnued as of 30 April 2017.

TINYCHANGE
2017-04-16 08:59:05 +02:00
Kyle Meyer e9018fbd0e Merge branch 'maint' 2017-03-26 21:52:15 -04:00
Paul Eggert 18d9b2181b Backport commit 14d8b6858 from Emacs
* doc/org.texi (noweb-ref): Simplify shell script example and don’t
use ‘tail -1’, which is not portable.

Port and simplify example sh script
14d8b6858a49e97f9b69593df5a8a7886430d43f
Paul Eggert
Tue Mar 21 09:19:42 2017 -0700
2017-03-26 21:50:06 -04:00
Kyle Meyer 48cd9729a5 Merge branch 'maint' 2017-03-19 13:32:19 -04:00
Michael Albinus 10bd44db7b Backport commit 265a5d979 from Emacs
* doc/org.texi (dir): Change example to use a method.

Document remote file name syntax change
265a5d9791bf42da0bab7bdbef4352e8d734ef31
Michael Albinus
Thu Mar 16 16:23:07 2017 +0100
2017-03-19 13:31:49 -04:00
Nicolas Goaziou e1cd71532f Merge branch 'maint' 2017-03-16 13:01:24 +01:00
Nicolas Goaziou 6039ece3f3 org.texi: Fix link
* doc/org.texi (Hooks): Fix link.
2017-03-16 13:00:39 +01:00
Carsten Dominik 0f1b5ec496 Consolidate capture targets and allow outline path in datetree targets
* doc/org.texi: Document the new capture templates target.
* lisp/org-capture.el (org-capture-upgrade-templates): New function.
(org-capture-templates): Implement the new file+olp+datetree target.
(org-capture): Document the C-1 prefix.
(org-capture-sanitize-olp): New function.
(org-capture-select-template): Make sure upgraded version of templates
variable is used.
* lisp/org-datetree.el (org-datetree-find-date-create): Accept
`subtree-at-point' as a value for the KEEP-RESTRICTION argument.
(org-datetree-find-iso-week-create): Accept `subtree-at-point'
as a value for the KEEP-RESTRICTION argument.
* lisp/org.el (org-find-olp): Throw an error when called in a
buffer that is not in Org mode.
* lisp/org-capture.el (org-capture-fill-template): Use overriding time
also in `?<>' escapes.
2017-03-16 08:18:55 +01:00
Wojciech Gac 2d1f73ebf8 org-attach.el: Add functionality to attach from URL
* lisp/org-attach.el (org-attach): Create a binding under 'u' to
  attach a file from URL
  (org-attach-url): Prompt user for URL
  (org-attach-attach): Update method list

* doc/org.texi (Attachments): Document attaching from URL

TINYCHANGE
2017-03-11 13:41:18 +01:00
Eduardo Bellani 78bddaca1f org-clock.el: Add nullary function evaluation as a clocktable scope parameter
* lisp/org-clock.el (org-dblock-write:clocktable): Funcall the scope
  argument if it is a function.

* doc/org.texi: Document the feature of using a nullary function as the
  scope for the clocktable.

* testing/lisp/test-org-clock.el: Adds a test for the above
  feature.  Also, fix the number of hours of a test that seemed to be
  broken.

TINYCHANGE
2017-03-06 18:00:19 +01:00
Nicolas Goaziou 8a1649902a Merge branch 'maint' 2017-03-02 22:01:13 +01:00
Th. Rikl 57fbe524e4 org.texi: Document alternatives to M-TAB
* doc/org.texi (Drawers):
(Editing and debugging formulas):
(Export settings):
(Completion): Document alternatives to M-TAB

(Built-in table editor): Change <TAB> into TAB.

TINYCHANGE
2017-03-02 21:58:06 +01:00
Nicolas Goaziou 28b8476bb9 Merge branch 'maint' 2017-02-23 20:49:43 +01:00
Nicolas Goaziou c7c9477260 org.texi: Fix example
* doc/org.texi (noweb-ref): Update Babel parameter syntax in example.
2017-02-23 19:15:22 +01:00
Kyle Meyer ca31fac933 Merge branch 'maint' 2017-02-11 17:39:33 -05:00
Kyle Meyer e50cd98f93 orgcard: Update export section
* doc/orgcard.tex (Export and Publishing): Correct stale bindings.
  Add asynchronous, body, and subtree bindings.

This section now includes all bindings listed in
(info "(org)The Export Dispatcher").

Reported-by: Charles C. Berry <ccberry@ucsd.edu>
<https://lists.gnu.org/archive/html/emacs-orgmode/2017-02/msg00200.html>
2017-02-11 17:39:13 -05:00
Kyle Meyer eb59c75f39 Merge branch 'maint' 2017-02-09 12:58:39 -05:00
Kyle Meyer fd565d6e63 orgcard: Remove another timeline entry
* doc/orgcard.tex (Filtering and Sparse Trees): Don't mention timeline
  because this feature will be removed in version 9.1.

90f87cb98 removed the org-timeline reference in the "Agenda Views"
section but missed this one.

As a bonus, this fixes a column formatting issue in the
orgcard_letter.pdf output (orgcard.pdf was not affected) that was
caused by an extra line added in 4340cc78f.

Reported-by: David Talmage <david.talmage@shoutpoint.com>
<http://lists.gnu.org/archive/html/emacs-orgmode/2017-02/msg00193.html>
2017-02-09 12:58:04 -05:00
Kyle Meyer d5460d9e43 Merge branch 'maint' 2017-02-08 21:49:17 -05:00
Kyle Meyer 90f87cb98a orgcard.tex: Remove timeline reference
* doc/orgcard.tex: Don't mention timeline because this feature will be
  removed in version 9.1.
2017-02-08 21:43:38 -05:00
Kaushal Modi 4340cc78f7 Update few bindings' descriptions based on org 9.0.4
* doc/orgcard.tex: Update descriptions for M-UP/DOWN and M-S-UP/DOWN
  bindings for structural editing.  Removed the C-c C-q binding
  description in the Tables/Regions section as it sets org tags as
  usual, does not fill paragraph.
2017-02-08 21:40:40 -05:00
Nicolas Goaziou 13b18ea5e6 Merge branch 'maint' 2017-02-01 15:43:18 +01:00
Nicolas Goaziou 76c08ea77b Replace org-set-local by setq-local in the documentation
* contrib/orgmanual.org (Conflicts): Update yasnippet instructions.

* doc/org.texi (Packages that conflict with Org mode): Update
  yasnippet instructions

TINYCHANGE
2017-02-01 15:42:04 +01:00
Nicolas Goaziou 2c5c68dec5 Merge branch 'maint' 2017-01-14 00:25:24 +01:00
Nicolas Goaziou 88486fdce0 org.texi: Document COMMENT and
* doc/org.texi (Internal archiving): Fix typo.
(Agenda views): Document that COMMENT trees are skipped by default
when building agenda views.
(Comment lines): Add a concept index entry.
2017-01-14 00:22:43 +01:00
Nicolas Goaziou 6582604527 Merge branch 'maint' 2017-01-13 10:36:56 +01:00
Nicolas Goaziou c394c8f58a org.texi: Small improvements
* doc/org.texi (Agenda column view): Add empty line between items.
  Replace some parenthesis.
2017-01-13 10:36:21 +01:00
Nicolas Goaziou e46676bd13 org.texi: Remove references to Timeline view
* doc/org.texi (Top):
(TODO basics):
(TODO types):
(Tracking TODO state changes):
(Priorities):
(Timestamps):
(Clocking commands):
(Agenda views):
(Agenda dispatcher):
(Built-in agenda views):
(Search view):
(Agenda commands): Remove references to Timeline view.

The "Timeline" feature itself was removed in 64efc0cd4.
2017-01-09 00:46:51 +01:00
Nicolas Goaziou 3e4ef50010 Merge branch 'maint' 2017-01-09 00:35:21 +01:00
Gregor Zattler a8c7fe2b1a ; * doc/org.texi (Key bindings and useful functions): Beautify table.
Correctly render table of org-babel key bindings even in info
mode. [tiny change]

Copyright-paperwork-exempt: yes
2017-01-09 00:34:30 +01:00
Kyle Meyer 0d3683f2cd Merge branch 'maint' 2017-01-05 20:23:58 -05:00
Kyle Meyer 713f785017 Update copyright years 2017-01-05 20:19:37 -05:00
Nicolas Goaziou d82d309095 Merge branch 'maint' 2017-01-04 23:11:07 +01:00
Nicolas Goaziou 16008b00e0 Improve documentation about agenda filters
* doc/org.texi (Filtering/limiting agenda items): Add reference to
  `org-agenda-effort-filter-preset'.  Document prefix arguments for
  `org-agenda-filter-by-effort'.  Fix typo.
(Agenda commands): Remove index entries for unreferenced variables.
Tiny clean-up.
2017-01-04 23:07:23 +01:00
Charles Berry fed1cf1c99 org.texi: fix noweb-ref property, clarify `Exporting code blocks'
* org.texi: The example in the `noweb-ref' node now uses the
  :header-arg: property to declare the :noweb-ref reference.  The
  `Exporting code blocks' node is edited to more carefully warn users
  of the consequences of setting `org-export-use-babel' to `nil'.
2017-01-03 16:12:00 -08:00
Marco Wahl 3fd0f57231 org.texi: Fix compile
* doc/org.texi: Fix compile.  (One item was misplaced.)
2016-12-21 10:10:00 +01:00
Nicolas Goaziou 91dc1b34e3 ox: Add EXPORT_FILE_NAME keyword
* lisp/ox.el (org-export-output-file-name): Support EXPORT_FILE_NAME
  keyword.
* doc/org.texi (Export settings): Document new keyword.
* testing/lisp/test-ox.el (test-org-export/output-file-name): Add
  tests.
2016-12-20 17:10:46 +01:00
Nicolas Goaziou 2ac798af6c org.texi: Fix typo
* doc/org.texi (Sitemap): Fix typo.
2016-12-19 23:02:26 +01:00
Nicolas Goaziou bd828e2d1c ox: Add `org-export-global-macros'
* lisp/ox.el (org-export-global-macros): New variable.
(org-export-as): Use new variable.
* doc/org.texi (Macro replacement): Document new variable.
* testing/lisp/test-ox.el (test-org-export/expand-macro): Add tests.
2016-12-19 23:00:38 +01:00
Nicolas Goaziou 83827952db ox-publish: Provide relative file in sitemap generation
* doc/org.texi (Sitemap):
* lisp/ox-publish.el (org-publish-project-alist): Document change.

(org-publish-property):
(org-publish--expand-file-name): New functions

(org-publish-get-base-files):
(org-publish-file):
(org-publish-projects):
(org-publish--sitemap-files-to-lisp):
(org-publish-sitemap):
(org-publish-find-property):
(org-publish-find-title):
(org-publish-find-date):
(org-publish-sitemap-default-entry):
(org-publish-sitemap-default): Use new functions.

* testing/lisp/test-ox-publish.el (test-org-publish/sitemap): Update
  test.
2016-12-19 17:36:19 +01:00
Nicolas Goaziou 6663452588 ox-publish: Remove :sitemap-sans-extension
* lisp/ox-publish.el (org-publish-sitemap): Remove property.

* doc/org.texi (Sitemap):
* lisp/ox-publish.el (org-publish-project-alist): Remove documentation.

Caches uses absolute file names as keys.  We cannot provide file names
without extension to `:sitemap-format-entry' as they are no longer
existing key, and cannot be used for `org-publish-find-property' or
`org-publish-find-title'.
2016-12-19 12:19:59 +01:00
Nicolas Goaziou d5dbf761eb ox-publish: Include directories in site-map
* lisp/ox-publish.el (org-publish-temp-files): Remove variable.
(org-publish-get-base-files-1):
(org-publish-compare-directory-files): Remove functions.
(org-publish-get-base-files): Remove optional argument.  Rewrite
function.
(org-publish-projects):
(org-publish-sitemap):
(org-publish-index-generate-theindex): Apply signature change.
(org-publish-sitemap-sort-folders): Allow to include or ignore
directories in the site-map.

* doc/org.texi (Sitemap):
* lisp/ox-publish.el (org-publish-project-alist): Document change.
2016-12-19 12:19:59 +01:00
Nicolas Goaziou ca0ad0a84b ox-publish: Implement `org-publish-find-property'
* lisp/ox-publish.el (org-publish-find-property): New function.
(org-publish-find-title): Use new function.  Remove unused optional
argument.
(org-publish-find-date): Use new function.

(org-publish-project-alist):
* doc/org.texi (Sitemap): Update documentation.

Suggested-by: Rasmus <rasmus@gmx.us>
<http://permalink.gmane.org/gmane.emacs.orgmode/107219>
2016-12-19 12:19:58 +01:00
Nicolas Goaziou 2d3e3f562a ox-publish: Improve control over site map
* lisp/ox-publish.el (org-publish-project-alist): Document
  new :sitemap-format-entry property, and change to `:sitemap-function'.
(org-publish-sitemap-file-entry-format): Make variable obsolete.
(org-publish-org-sitemap): Remove function.
(org-publish--sitemap-files-to-lisp):
(org-publish-sitemap):
(org-publish-sitemap-default-entry):
(org-publish-sitemap-default): New functions.
(org-publish-projects): Use new functions.
* lisp/org-compat: Implement directory-name-p when not available.

* doc/org.texi (Sitemap): Update documentation.

:sitemap-function is more specialized so it is easier to manipulate.  In
particular, it can make use of built-in `org-list-to-*' functions.
Also, :sitemap-format-entry, as a function, is less limited than
`org-publish-sitemap-file-entry-format' format string.
2016-12-19 12:19:58 +01:00
Nicolas Goaziou 05223fc6fa Merge branch 'maint' 2016-12-12 21:25:28 +01:00
Nicolas Goaziou b09d161873 org.texi: Fix some @xref usage
* doc/org.texi (Literal examples): @xref is expected to be followed by
  punctuation.
2016-12-12 21:24:45 +01:00
Nicolas Goaziou c8da8529f5 `org-insert-heading' doesn't create items anymore
* lisp/org.el (org-insert-heading): Specialize function for headlines,
  not items.
(org-meta-return): Update according to new specifications above.
* lisp/org-list.el (org-insert-item): Add interactive spec.
* doc/org.texi (Structure editing): Update documentation.

* testing/lisp/test-org.el (test-org/insert-heading): Remove tests.
* testing/lisp/test-org-list.el (test-org-list/insert-item): Add test.
2016-12-10 00:32:15 +01:00
Carsten Dominik d65aa337ae Fixed link to Carsten's Tools page 2016-12-06 13:18:19 +01:00
Carsten Dominik 908a549a5c Fixed link to the home of CDLaTeX 2016-12-06 13:00:14 +01:00
Nicolas Goaziou 1336115eb3 Merge branch 'maint' 2016-12-04 00:45:12 +01:00
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