Commit Graph

2505 Commits

Author SHA1 Message Date
Eric Abrahamsen 7973ec1057 Inherit TIMEZONE and LOCATION properties in iCalendar export
* lisp/ox-icalendar.el (org-icalendar-entry): Both properties now
optionally inherit, depending on value of
`org-use-property-inheritance'.
* doc/org.texi: Mention change.
2017-08-20 00:12:57 +02:00
Eric Abrahamsen 42458e682d Add per-entry timezone support for icalendar export
* lisp/ox-icalendar.el (org-icalendar-entry): Look for a "TIMEZONE"
  property.
(org-icalendar--vevent, org-icalendar--vtodo): Accept additional
timezone argument.
(org-icalendar-convert-timestamp): Change parameter name to "tz", and
accept a wider variety of values.

* doc/org.texi: Mention in manual.
2017-08-20 00:11:18 +02:00
Nicolas Goaziou 6a590738b1 Remove `org-enable-table-editor'
* doc/org.texi (Built-in table editor): Document removal.
* lisp/org-table.el (orgtbl-optimized):
(org-table-auto-blank-field): Ignore removed variable.
2017-08-19 23:39:22 +02:00
Nicolas Goaziou a5dbedea06 Merge branch 'maint' 2017-08-19 11:11:55 +02:00
Nicolas Goaziou d01ee01d52 Document backslash escaping rule in capture templates
* doc/org.texi (Template expansion): Document backslash escaping rule
  in capture templates.

Reported-by: Peter Tomhas <peter.tomhas@gmail.com>
<http://lists.gnu.org/archive/html/emacs-orgmode/2017-08/msg00429.html>
2017-08-19 11:10:55 +02:00
Kaushal Modi 8e599ff546 Fix org.texi compilation
* doc/org.texi (Exporting agenda views): Add the missing closing brace
  for a footnote.
2017-08-18 12:32:31 -04:00
Bastien d0ced98943 Delete htmlize.el from Org’s contrib directory
* lisp/ox-org.el (org-org-publish-to-org):
* lisp/ox-html.el (org-html-htmlize-generate-css):
(org-html-fontify-code):
* lisp/org-agenda.el (org-agenda-write): Throw an error
requesting the user to install htmlize.el.

* doc/org.texi (Exporting agenda views, Literal examples):
Don’t assume htmlize.el is available.

You need to install it from https://github.com/hniksic/emacs-htmlize

See https://github.com/hniksic/emacs-htmlize/issues/7 for this issue.
2017-08-18 09:54:19 +02:00
Bastien 5176370129 Move the library-of-babel.org to Worg 2017-08-18 09:34:34 +02:00
Nicolas Goaziou 940c90ec97 Merge branch 'maint' 2017-08-13 16:23:33 +02:00
Chunyang Xu 6f5cacd607 * doc/org.texi: Add org-babel-load-languages to Variable Index
TINYCHANGE
2017-08-13 16:23:11 +02:00
Grant Rettke 33e0dc6155 Add Easy Template for COMMENT (C)
* lisp/org.el: (org-structure-template-alist): Added `COMMENT' block template
  bound to `C'

* doc/org.texi: Add documentation for `COMMENT' Easy Template.

* contrib/orgmanual.org: Add documentation for `COMMENT' Easy
  Template.

* etc/ORG-NEWS: Added note for 9.1 release under Miscellaneous
2017-08-10 12:45:02 +02:00
Christian Garbs 4d2c8354ee ob-vala.el: Add Vala support to Babel
* lisp/ob-vala.el: Add support for the Vala language to Babel.

* testing/lisp/test-ob-vala.el: Add tests for ob-vala.el.

* doc/org.texi (Working with source code): Add Vala to the list of
  supported languages.
2017-08-07 11:40:25 +02:00
Kyle Meyer b2a2818a69 Merge branch 'maint' 2017-08-06 11:59:45 -04:00
Marshall handheld Flax 492420b605 org.texi: Replace a misused word
* doc/org.texi (Code evaluation security): Replace misused "weary"
with "wary".

TINYCHANGE
2017-08-06 11:58:10 -04:00
Nicolas Goaziou 6b9f9e9aff Merge branch 'maint' 2017-07-24 09:42:50 +02:00
Nicolas Goaziou 10bdef394d org.texi: Fix last commit 2017-07-24 09:34:57 +02:00
Nicolas Goaziou 6c38314429 Merge branch 'maint' 2017-07-23 22:49:11 +02:00
Nicolas Goaziou 16dbf09419 org.texi: Document Org Protocol
* doc/org.texi (Protocols): Document feature.
2017-07-23 22:48:51 +02:00
Nicolas Goaziou e07392cf41 Merge branch 'maint' 2017-07-13 11:00:17 +02:00
Chunyang Xu a8e13b9ffc library-of-babel: Fix typo
* doc/library-of-babel.org: Replace non-existent with-temp-filebuffer.

TINYCHANGE
2017-07-13 10:00:58 +02:00
Kyle Meyer d39ccc17d4 Merge branch 'maint' 2017-07-09 11:28:54 -04:00
Paul Eggert b7fdc30388 Backport commit 20e9a00fb from Emacs
* lisp/org-table.el (org-table-sort-lines): Fix misspelling in prompt.
* lisp/ox-ascii.el (org-ascii--describe-datum): Fix misspelling in
call to org-element-lineage.

Spelling fixes
20e9a00fb5d12ad408f9dd15adcfcd205783c1b0
Paul Eggert
Thu Jul 6 00:24:56 2017 -0700
2017-07-09 11:27:12 -04:00
Marco Wahl 360109e6c7 Merge branch 'maint' 2017-07-08 23:32:10 +02:00
Marco Wahl 4b4f659d74 doc/org.texi (Easy templates): unified the notation. 2017-07-08 23:29:49 +02:00
Bastien 39906ee63d doc/org.texi (Global and local cycling): Add an online label
* doc/org.texi (Global and local cycling): Add an online label
to a reference.

Thanks to HyungSuk Ryu for reporting this.
2017-07-03 08:35:25 +02:00
Nicolas Goaziou fbd865941f Merge branch 'maint' 2017-07-01 18:27:21 +02:00
Mario Martelli 20d1c56575 org.texi: Fixes missing space after dot.
* doc/org.texi (Summary):
(Weekly/daily agenda): Fixes missing space after dot.
2017-07-01 18:25:51 +02:00
Nicolas Goaziou bff7f5daad Merge branch 'maint' 2017-07-01 14:34:19 +02:00
Nicolas Goaziou 3d63899088 org.texi: Small change to Copying example in Texinfo export
* doc/org.texi (Texinfo title and copyright page): Clarify that the
  headline needs to be named Copying, as pointed out above.
2017-07-01 14:32:54 +02:00
Kyle Meyer 282abe8969 Merge branch 'maint' 2017-07-01 00:18:15 -04:00
Kyle Meyer b00705f9e3 doc/Makefile: Use printf to generate org-version.tex
* doc/Makefile (org-version.tex): Use printf instead of echo to
increase portability.

By default GNU coreutil's echo disables the interpretation of
backslash escapes (-E option), but this isn't the case for some echo
variants.

Reported-by: Dale <dale@codefu.org>
<https://lists.gnu.org/archive/html/emacs-orgmode/2017-06/msg00619.html>
2017-06-30 13:27:53 -04:00
Kyle Meyer 6b65af9e10 Merge branch 'maint' 2017-06-28 01:00:26 -04:00
Kyle Meyer a8d007db15 doc/Makefile: Auto-generate org-version.tex for orgcard
* doc/Makefile: Add rule to generate org-version.tex.
* doc/orgcard.tex: Include org-version.tex rather than explicitly
setting version and year.

This removes the only instance in the repo where the Org version is
hardcoded.
2017-06-28 00:54:32 -04:00
Bastien d9344b9ad6 Merge branch 'maint' 2017-06-25 10:53:06 +02:00
Kitamoto Tsuyoshi 08334effc1 doc/org.texi (HTML doctypes): Fix formatting
* doc/org.texi (HTML doctypes): Fix formatting.

TINYCHANGE
2017-06-25 10:38:46 +02:00
Kaushal Modi d94475d63c Merge branch 'maint' 2017-06-23 06:05:10 -04:00
Kaushal Modi 3c9ec81e18 Improve Noweb documentation
* doc/org.texi (noweb, noweb-ref, Noweb reference syntax): Add
examples and improve wording.  Clarify how to use Noweb style
references with code block arguments.  Replace occurrences of
``noweb'' and ``Noweb'' with Noweb for consistency.
2017-06-23 06:03:36 -04:00
Bastien 6bbc07f916 Merge branch 'maint' 2017-06-21 15:23:55 +02:00
Tsuyoshi Kitamoto 877377ebb3 doc/org.texi (External links): Tiny formatting fix
* doc/org.texi (External links): Tiny formatting fix.

TINYCHANGE
2017-06-21 15:23:23 +02:00
Nicolas Goaziou 3aa3add326 Merge branch 'maint' 2017-06-20 09:32:48 +02:00
Nicolas Goaziou bb25a04f86 org.texi: Fix menus
* doc/org.texi (Top):
(Texinfo export): Fix menus.
2017-06-20 09:32:10 +02:00
Nicolas Goaziou 5e439d41f8 Merge branch 'maint' 2017-06-20 09:25:05 +02:00
Nicolas Goaziou fa6b7bf25c ox-texinfo: Fix location of text before first headline
* doc/org.texi (Info directory file): Fix node name.
(Headings and sectioning structure): Document location of text before
  first headline.
(A Texinfo example): Update example.

* lisp/ox-texinfo.el (org-texinfo-template): Handle contents of very
  first section.
(org-texinfo-section): Ignore very first section.

According to Texinfo specifications, Top node contents should not
appear in printed output.  Move it near "@top" command, within
"@ifnottex".
2017-06-20 09:24:34 +02:00
Kyle Meyer bed2c25fd3 Merge branch 'maint' 2017-06-19 23:37:06 -04:00
Kyle Meyer 2ab2a420a6 org.texi: Clean up spacing to pass Emacs's pre-commit check
Like c1822e556 (2017-01-25), this is in preparation for syncing with
the Emacs repo.
2017-06-19 23:23:07 -04:00
Nicolas Goaziou a615d399d9 org.texi: Update Texinfo section
* doc/org.texi (Plain lists in Texinfo export): Update according to
  latest changes.
2017-06-18 11:04:38 +02:00
Nicolas Goaziou 1a6bf9c5f9 Merge branch 'maint' 2017-06-18 11:03:43 +02:00
Nicolas Goaziou df62584820 org.texi: Small update
* doc/org.texi (A Texinfo example): Update according to latest
  ox-texinfo fixes.
2017-06-18 11:03:13 +02:00
Nicolas Goaziou 8769cfc91c Revert "ox-texinfo: Escape @ { } in index"
* lisp/ox-texinfo.el (org-texinfo-keyword): Index keywords are
  specific to Texinfo back-end, so they expect regular Texinfo code.
* doc/org.texi (Indices): Update documentation.
2017-06-18 11:00:56 +02:00
Kaushal Modi d48cfdf68b Add hold 'action' to the "n" macro and ws-trim all "n" macro args
* lisp/org-macro.el (org-macro--counter-increment): Rename the
optional arg RESET to ACTION, as now that action can mean setting,
resetting or even holding the specified counter.  ACTION set to
"-" will hold the previous value of the counter.  White-space is
now trimmed from the NAME arg too.

* doc/org.texi (Macro replacement): Document the new hold action.

* testing/lisp/test-org-macro.el (test-org-macro/n): Add new tests for
the hold action.
2017-06-17 23:46:24 -04:00
Bastien 32676822de Merge branch 'maint' 2017-06-15 16:50:16 +02:00
Tsuyoshi Kitamoto 01ba5cafa5 doc/org.texi: Fix typos
* doc/org.texi (Include files)
(Special blocks in Texinfo export, Translator functions): Fix typos.

TINYCHANGE
2017-06-15 16:48:21 +02:00
Nicolas Goaziou c7be9d9ad5 org.texi: Add missing documentation about "n" macro
* doc/org.texi (Macro replacement): Add missing documentation.
2017-06-14 21:42:27 +02:00
Nicolas Goaziou be30c8b126 ox-texinfo: Change default table markup
* lisp/ox-texinfo.el (org-texinfo-table-default-markup): Rename from
  `org-texinfo-def-table-markup'.  Set default value to the neutral
  "@asis".
(org-texinfo-plain-list): Use new name.
* lisp/org-compat.el (org-texinfo-def-table-markup): Mark as obsolete.
* doc/org.texi (Publishing options): Document change.
2017-06-14 19:11:33 +02:00
Carsten Dominik feed16e1ed Merge branch 'master' of orgmode.org:org-mode 2017-06-14 05:46:17 +02:00
Carsten Dominik daff9c93f2 Implement new `U' mode switch for table formulas to omit seconds in durations
* lisp/org-table.el (org-table-duration-custom-format): Add new
	HH:MM format.
	(org-table-duration-hour-zero-padding): New option.
	(org-table-eval-formula): Select second-less format if
	requested.
	(org-table-time-seconds-to-string): Implement formats without
	seconds and without zero-padding for hours.

	* testing/lisp/test-org-table.el (test-org-table/duration):
	New test for second-less durations.

	* doc/org.texi (Formula syntax for Calc)
	(Durations and time values): Document the U mode switch.
2017-06-14 05:43:12 +02:00
Kaushal Modi 1e92f5ed39 Allow org-file-contents to fetch file contents from a URL
* lisp/org.el (org--file-cache): New variable.
(org-reset-file-cache):
(org-file-url-p): New function.
(org-mode-restart): Use new function.

* lisp/org.el (org-file-contents): Allow the FILE argument to be a
URL.  If the URL contents are already cached, return the cache
contents, else download the file and return contents of that.  The
file is automatically cached each time it is downloaded.  Add a new
optional argument NOCACHE.  If this is non-nil, the URL is always
downloaded afresh.  Use `org--file-cache' and `org-file-url-p'.

* lisp/org.el (org-edit-special): Do not allow editing the "file" if a
URL is specified for the "#+SETUPFILE".

* lisp/ox.el (org-export--list-bound-variables)
(org-export--prepare-file-contents):
* lisp/org-macro.el (org-macro--collect-macros) : Adapt to the
possibility that the input to `org-file-contents' can be a URL too.

* doc/org.texi (Export settings, In-buffer settings)
(The very busy C-c C-c key): Mention that #+SETUPFILE keyword can now
take a URL as a value, and that C-c C-c on the #+SETUPFILE line will
clear the org file cache.

* testing/lisp/test-org.el (test-org/org-file-contents-url)
(test-org/org-file-contents-file): Add tests for org-file-contents.

* testing/lisp/test-ox.el (test-org-export/get-inbuffer-options): Add
test for reading setupfile specified via a URL.
2017-06-13 11:41:58 -04:00
Kaushal Modi a933b34992 Merge branch 'maint' 2017-06-09 16:18:24 -04:00
Kaushal Modi 7cd7b90dcb Update remote file syntax for Tramp
* testing/lisp/test-ox.el (test-org-export/file-uri):
* doc/org.texi (External links): The method part of remote file names
is mandatory now in the emacs master (26+).  A valid remote file name
starts with "/method:host:" or "/method:user@host:".  ssh is used as
an example method here.

This change in the examples is backward compatible with emacs 25, 24, ..

Suggested by: Michael Albinus <michael.albinus@gmx.de>
<http://lists.gnu.org/archive/html/emacs-orgmode/2017-06/msg00151.html>

Relevant commit in emacs master causing this change:
<http://git.savannah.gnu.org/cgit/emacs.git/commit/?id=ed33337c3e0d0b1a8b140e23168421ea43d79324>
2017-06-09 16:15:15 -04:00
Kaushal Modi 4c24ecc073 Merge branch 'maint' 2017-06-07 18:40:56 -04:00
Kaushal Modi 51b743fc29 Mention org-speed-command-help in Speed Keys info node
* doc/org.texi (Speed keys): Mention org-speed-command-help.
2017-06-07 18:37:23 -04:00
Nicolas Goaziou 8dc31ed680 ox-texinfo: Implement the :sep attribute in plain lists
* lisp/ox-texinfo.el (org-texinfo-item):
* doc/org.texi (Plain lists in Texinfo export):
2017-06-07 22:17:08 +02:00
Nicolas Goaziou 82066d1a0c Merge branch 'maint' 2017-05-15 14:05:19 +02:00
Nicolas Goaziou 3c7ef9f8e8 org.texi: Silence Texinfo
* doc/org.texi (HTML Specific export settings): Silence Texinfo.
2017-05-15 14:04:38 +02:00
Nicolas Goaziou da68c2cc35 Merge branch 'maint' 2017-05-15 08:41:31 +02:00
Nicolas Goaziou 44a81a11a6 org.texi: Fix typo
* doc/org.texi (Tables in @LaTeX{} export): Fix typo.

Reported-by: Robert Klein <roklein@roklein.de>
<http://permalink.gmane.org/gmane.emacs.orgmode/113490>
2017-05-15 08:41:12 +02:00
Nicolas Goaziou 8fba95ea8a Merge branch 'maint' 2017-05-15 00:20:03 +02:00
Nicolas Goaziou 134500e7c1 org.texi: Fix Texinfo compilation 2017-05-15 00:19:41 +02:00
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