Commit Graph

3318 Commits

Author SHA1 Message Date
Bastien e360cd8f3a Change the default values for several options
* doc/org-manual.org (Execute commands in the active region):
Update the manual given the new defaults.

* etc/ORG-NEWS (New default settings for some options): New
section.

* lisp/org.el (org-loop-over-headlines-in-active-region):
Change the default value to `t'.
(org-fontify-done-headline): Ditto.

* lisp/org-agenda.el
(org-agenda-loop-over-headlines-in-active-region): Ditto.

* lisp/org-src.el (org-src-tab-acts-natively): Ditto.
2020-02-21 16:35:56 +01:00
Nicolas Goaziou 5d2075abad org-manual: Stick to typographic conventions
* doc/org-manual.org (Subscripts and Superscripts): Use ~...~ markup
for symbols and capital letters for keywords. Also prefer direct voice
and present tense whenever possible.
2020-02-20 09:57:38 +01:00
Bastien 86cbaff2b8 org-manual.org: Enhance the "Subscripts and Superscripts" section
* doc/org-manual.org (Subscripts and Superscripts): Be more
explicit about the interaction between the relevant options.
2020-02-19 22:27:44 +01:00
Nicolas Goaziou f4bed78a19 Move custom links to new tooling
* contrib/lisp/ol-bookmark.el (org-bookmark-open):
* contrib/lisp/ol-elisp-symbol.el (elisp-symbol-open):
* contrib/lisp/ol-git-link.el (org-gitbare-open):
(org-git-open):
* contrib/lisp/ol-man.el (org-man-open):
* contrib/lisp/ol-mew.el (org-mew-open):
* contrib/lisp/ol-notmuch.el (org-notmuch-open):
(org-notmuch-search-open):
(org-notmuch-tree-open):
* contrib/lisp/ol-vm.el (org-vm-open):
(org-vm-imap-open):
* contrib/lisp/ol-wl.el (org-wl-open):
* contrib/lisp/org-mac-link.el (org-mac-together-item-open):
(org-mac-addressbook-item-open):
(org-mac-skim-open):
(org-mac-acrobat-open):
(org-mac-outlook-message-open):
(org-mac-evernote-note-open):
(org-devonthink-item-open):
(org-mac-message-open):
* contrib/lisp/org-mairix.el (org-mairix-open):
* lisp/ol-bbdb.el (org-bbdb-export):
(org-bbdb-open):
* lisp/ol-bibtex.el (org-bibtex-open):
* lisp/ol-docview.el (org-docview-open):
* lisp/ol-eshell.el (org-eshell-open):
* lisp/ol-eww.el ("eww"):
* lisp/ol-gnus.el (org-gnus-open):
* lisp/ol-info.el (org-info-open):
* lisp/ol-irc.el (org-irc-visit):
* lisp/ol-mhe.el (org-mhe-open):
* lisp/ol-rmail.el ("rmail"):
(org-rmail-open):
* lisp/ol.el (org-link--open-doi):
(org-link--open-elisp):
(org-link--open-help):
(org-link--open-shell):
* lisp/org-id.el (org-id-open):
* testing/lisp/test-ox.el (test-org-export/custom-protocol-maybe): Use
new tooling.
* doc/org-manual.org (Adding Hyperlink Types): Adapt example.
2020-02-19 18:42:50 +01:00
Bastien 325962c003 org.el: New option `org-startup-numeroted' and #+startup: num
* lisp/org.el (org-startup-numeroted): New option.
(org-startup-options): New "num" and "nonum" startup keywords.
(org-mode): Startup according `org-startup-numeroted' or the
local #+startup setup.

* doc/org-manual.org (Dynamic Headline Numbering)
(Summary of In-Buffer Settings): Document
`org-startup-numeroted' and #startup: num.

* etc/ORG-NEWS: Document the new startup option.

Thanks to Guillaume MULLER for this idea.
2020-02-18 13:27:33 +01:00
Bastien 430b644f79 Merge branch 'maint' 2020-02-13 08:19:34 +01:00
Bastien 79ed6d208e org-manual.org: Fix repository link
* doc/org-manual.org (Using Org's git repository): Fix
repository link.

Thanks to Gustavo Barros for reporting this.
2020-02-13 08:19:24 +01:00
Bastien 73445c0fab Merge branch 'maint' 2020-02-12 17:56:43 +01:00
Bastien c39c5c6559 Fix info dircategory
Thanks to Drew Adams and Steve Berman for reporting this.
2020-02-12 17:41:51 +01:00
Bastien c93ed7feb6 doc/doc-setup.org: Update maintainer 2020-02-12 17:41:29 +01:00
Bastien 5d21fbbcf3 doc/org-manual.org: Fix typo
Thanks to Colin Baxter for reporting this.
2020-02-12 09:10:12 +01:00
Bastien eaa220f6a7 Small code enhancement
* doc/org-manual.org (Checkboxes): Minor update.

* lisp/org-list.el (org-at-radio-list-p): Respect the
attributes #+ATTR_* syntax.
2020-02-12 08:40:46 +01:00
Bastien 4028cc731b Use "#+attr_org: :radio" before lists to enable radio buttons
* doc/org-manual.org (Checkboxes): Document the use of
"#+attr_org".

* lisp/org.el (org-ctrl-c-ctrl-c): When the list at point is
preceded by "#+attr_org: :radio" use `org-toggle-radio-button'
instead of `org-toggle-checkbox'.

* lisp/org-list.el (org-at-radio-list-p): New defsubst.
(org-toggle-checkbox): Use it.

* etc/ORG-NEWS: Document the use of "#+attr_org".
2020-02-12 01:51:46 +01:00
Bastien 561feb128d Add `org-toggle-radio-button' and related minor mode
* doc/org-manual.org (Checkboxes): Document the new minor mode
and command.

* lisp/org-keys.el (org-mode-map): Bind C-c C-x C-r to
`org-toggle-radio-button'.

* lisp/org-list.el (org-list-checkbox-radio-mode): New minor
mode to let C-c C-c call `org-toggle-radio-button' instead of
`org-toggle-checkbox'.
(org-toggle-radio-button): New command.

* lisp/org.el (org-ctrl-c-ctrl-c): Use `org-toggle-radio-button'.

* etc/ORG-NEWS: Document the new minor mode and command.

Thanks to Phil Sainty for sharing this idea and links to similar
implementations.
2020-02-11 23:55:53 +01:00
Bastien e3b79ad2bf Allow a new value for `org-adapt-indentation'
* doc/org-manual.org (Hard indentation): Add a footnote
mentioning the new value for `org-adapt-indentation'

* etc/ORG-NEWS: Mention the new value for
`org-adapt-indentation'.

* lisp/org.el (org-logbook-drawer-re): New constant.
(org-adapt-indentation): Allow 'headline-data as a new value
to only adapt indentation for headline data.
(org-fixup-indentation, org--get-expected-indentation): Handle
`org-adapt-indentation' set to 'headline-data.

* lisp/org-indent.el (org-indent-mode)
(org-indent-add-properties): Handle `org-adapt-indentation'
set to 'headline-data.

* lisp/org-clock.el (org-clock-in): Call `org-indent-line'
after clock timestamp insertion.
2020-02-09 17:30:42 +01:00
Bastien a62751a6a5 Add `org-clock-toggle-auto-clockout'
* doc/org-manual.org: Document the new command.

* lisp/org-clock.el (org-clock-toggle-auto-clockout): New
command.
2020-02-09 11:17:42 +01:00
Bastien 88794cab06 New option `org-clock-auto-clockout-timer'
* etc/ORG-NEWS (New option ~org-clock-auto-clockout-timer~):
Mention the new option `org-clock-auto-clockout-timer'.

* doc/org-manual.org (Clocking out automatically after some
idle time): Document `org-clock-auto-clockout-timer'.

* lisp/org.el (org-clock-auto-clockout-insinuate): New
function to add a hook for auto-clocking out the current tasks
after `org-clock-auto-clockout-timer' seconds.

* lisp/org-clock.el (org-clock-auto-clockout-timer): New option.
(org-clock-auto-clockout): New function, use the new option.
2020-02-09 11:05:12 +01:00
Nicolas Goaziou c23fa7b178 Merge branch 'maint' 2020-02-08 13:08:43 +01:00
Nicolas Goaziou d20e45b187 org-manual: New "features" section about source blocks
* doc/org-manual.org (Features): New section.

The main motivation behind this is to avoid starting "Working with
source code" section with a wall of text that hides the menu.
2020-02-08 13:06:41 +01:00
Bastien 0e75ebc523 Implement and document looping over headlines in agenda
* doc/org-manual.org (Execute commands in the active region):
New section, documenting both
`org-loop-over-headlines-in-active-region' and
`org-agenda-loop-over-headlines-in-active-region' options.

* etc/ORG-NEWS (Looping agenda commands over headlines): Add
an entry about "Looping agenda commands over headlines".

* lisp/org-agenda.el (org-agenda-do-in-region): New function.
(org-agenda-maybe-loop): New macro.
(org-agenda-kill, org-agenda-archive-default)
(org-agenda-archive-default-with-confirmation)
(org-agenda-archive, org-agenda-archive-to-archive-sibling)
(org-agenda-archive-with, org-agenda-todo)
(org-agenda-set-property, org-agenda-set-effort)
(org-agenda-toggle-archive-tag, org-agenda-date-prompt)
(org-agenda-schedule, org-agenda-deadline)
(org-agenda-add-entry-to-org-agenda-diary-file): Use
`org-agenda-maybe-loop' to DTRT when the region is active.
(org-agenda-loop-over-headlines-in-active-region): New option.
2020-02-08 12:17:40 +01:00
Nicolas Goaziou 5ab6f6b77e Merge branch 'maint' 2020-02-08 09:27:47 +01:00
Nicolas Goaziou 4f26e31203 org-manual: Clarify "link" format for Babel code
* doc/org-manual.org (Format): Clarify "link" format.

Reported-by: Matt Huszagh <huszaghmatt@gmail.com>
2020-02-08 09:26:24 +01:00
Bastien 3d69f055b0 doc/org-manual.org: Use `org-refile-copy'
* doc/org-manual.org (Refile and Copy): Use `org-refile-copy',
the new name of `org-copy'.
2020-02-05 15:51:07 +01:00
Bastien eaf8b78a74 org-manual.org: Precision on the priority cookie syntax
* doc/org-manual.org (Priorities): Indicate that the priority
cookie should be placed right after the TODO keyword.
2020-02-02 08:39:12 +01:00
Bastien 151a31917b doc/org-manual.org: Don't document deleted command
* doc/org-manual.org (Remote editing): Don't document deleted command.
2020-02-02 08:35:43 +01:00
Bastien 80fc678acd doc/org-manual.org: Don't document deleted command
* doc/org-manual.org (Remote editing): Don't document deleted command.
2020-02-02 08:34:33 +01:00
Kisaragi Hiu 2062761f5c org-manual.org: Mention the format of effort estimates
* doc/org-manual.org (Effort Estimates): Mention the format of effort
estimates.

TINYCHANGE
2020-02-01 17:44:13 +01:00
Bastien 110b034151 Replace "org-table-electric-header" by "org-table-header-line"
* lisp/org-table.el (org-table-header-line-p)
(org-table-header-line-mode): Replace
"org-table-electric-header" by "org-table-header-line".

* doc/org-manual.org (Miscellaneous): Ditto.

Thanks to Samuel Wales for suggesting this name.
2020-02-01 09:52:57 +01:00
Bastien 3d0282ef87 New option `org-archive-subtree-save-file-p'
* lisp/org-agenda.el (org-agenda-archive-with): Bind
`org-archive-from-agenda' to `t' when archiving from agenda.

* lisp/org-archive.el (org-archive-subtree-save-file-p): New option.
(org-archive-subtree): Use the new option.

* doc/org-manual.org (Moving a tree to an archive file):
Mention the new option.

Thanks to Russ Allbery for suggesting a similar idea.
2020-01-31 10:42:40 +01:00
Bastien 4f98694bf7 Allow numeric values for priorities
* lisp/org.el (org-priority-highest, org-priority-default):
Allow integer.
(org-priority-get-priority-function): Tiny docstring change.
(org-priority-to-value): New defsubst.
(org--setup-collect-keywords, org-priority-regexp)
(org-priority, org-get-priority): Allow numeric values.

* doc/org-manual.org (Priorities): Illustrate the use of
numeric values for priorities.
2020-01-30 23:01:29 +01:00
Bastien 1de5e80adf Rename `org-x-priority' functions and variables to `org-priority-x'
* lisp/org.el (org-priority-enable-commands)
(org-priority-start-cycle-with-default)
(org-set-regexps-and-options, org-sort-entries, org-priority)
(org-get-priority, org-entry-properties)
(org-property-get-allowed-values, org-shiftup, org-shiftdown):
Rename `org-[x]-priority' functions and variables to
`org-priority-[x]'.

* lisp/org-pcomplete.el (org-priority-default)
(org-priority-highest)
(pcomplete/org-mode/file-option/priorities): Ditto.

* lisp/org-mouse.el (org-mouse-get-priority)
(org-mouse-priority-list): Ditto.

* lisp/org-agenda.el (org-agenda-fontify-priorities)
(org-agenda-format-item, org-agenda-priority): Ditto.

* lisp/ox-icalendar.el (org-icalendar--vtodo): Ditto.

* doc/org-manual.org (Priorities, Summary of In-Buffer Settings): Ditto.

* testing/lisp/test-org.el (test-org/set-regexps-and-options)
(test-org/entry-properties): Ditto.
2020-01-30 14:56:38 +01:00
Bastien b476ffd266 Implement the `org-table-electric-header-mode' minor mode
* lisp/org-table.el (org-table-electric-header-p): New option.
(org-table-temp-header-line, org-table-electric-header-mode): New
variables.
(org-table-set-header-line-format)
(org-table-electric-header-mode): New minor mode to display the
table's current first row as the header line when this first row
is not visible anymore.

* doc/org-manual.org (Miscellaneous): Document
`org-table-electric-header-mode'.
2020-01-29 15:17:32 +01:00
Bastien 910bf48a14 org-manual.org: Mention the GNU Kind Communications Guidelines
* doc/org-manual.org (Feedback): Mention the GNU Kind
Communications Guidelines.
2020-01-27 12:04:03 +01:00
Bastien 8237a5d33b org-manual.org (Org Mobile): Mention `org-tag-persistent-alist'
* doc/org-manual.org (Org Mobile): Mention `org-tag-persistent-alist'.

Thanks to Jorge P. de Morais Neto for mentioning this.
2020-01-26 17:57:46 +01:00
Nicolas Goaziou 4141355492 Merge branch 'maint' 2020-01-26 09:45:28 +01:00
Bastien c6a34dc01f org-manual.org: Enhance documentation for Org Indent Mode
* doc/org-manual.org (Org Indent Mode): Document
`org-indent-mode-turns-on-hiding-stars' and
`org-indent-mode-turns-off-org-adapt-indentation' and add them to
the variable index.

See https://github.com/MatthewZMD/.emacs.d/issues/28 for details on
what was confusing.

Thanks to Neil Hansen for pointing this.
2020-01-26 08:58:44 +01:00
Gustav Wikström 7cf58a55da Document org-attach-commands option
* doc/org-manual.org (Attachment options): Mention
  org-attach-commands in the manual next to all other options for the
  attachment functionality.
2020-01-19 10:50:14 +01:00
Gustav Wikström edefb2835d Additional option for org-attach-store-link-p
* doc/org-manual.org (Attachment options)
* etc/ORG-NEWS (New option in ~org-attach-store-link-p~)
* lisp/org-attach.el (org-attach-store-link-p)
  (org-attach-attach): Add option to store a link to the attached file
  with a file link.
2020-01-19 10:50:14 +01:00
Kyle Meyer c9ee3d8a9b Merge branch 'maint' 2020-01-17 20:57:07 -05:00
Kyle Meyer 36cd249e75 guide: Match recommended global keybindings to manual's
* doc/org-guide.org (Activation): Match recommended global keybindings
to those in the manual.

In the guide's .texi to .org conversion in 1a678f184 (Generate compact
guide from an Org file, 2019-03-19), the leading "C-c"s of the
bindings were lost.  Restore them.

Also, drop org-switchb, which was pruned from the manual's suggested
bindings in d03515590, and tweak the surrounding text more closely
match the manual's.

Reported-by: Nick Dokos <ndokos@gmail.com>
2020-01-17 20:55:47 -05:00
Nicolas Goaziou 3a6061e787 Merge branch 'maint' 2020-01-09 17:55:08 +01:00
Nicolas Goaziou e3681b0b08 org-manual: Fix typo
* doc/org-manual.org (Hard indentation): Fix typo.
2020-01-09 17:54:51 +01:00
Nicolas Goaziou ffb3f9e568 Merge branch 'maint' 2020-01-09 17:49:56 +01:00
Nicolas Goaziou 2c598d7499 org-manual: Update "ol-man.el" example
* doc/org-manual.org (Adding Hyperlink Types): Remove
unnecessary (require 'org) in example and fix function name.
2020-01-09 17:49:15 +01:00
Tom Gillespie b1cd1595df org-manual: Use ol-man.el in "Adding Hyperlink Types"
doc/org-manual.org (Adding Hyperlink Types): Update the name of the
example file from org-man.el to ol-man.el to reflect the renaming of
files related to Org links.

I found this thoroughly confusing when trying to (require 'org-man)
since it was clearly referenced as being in "contrib/", hopefully this
change will prevent anyone else from encountering the same confusion.
2020-01-09 17:44:39 +01:00
Kyle Meyer 93c11da002 Merge branch 'maint' 2020-01-01 13:39:26 -05:00
Kyle Meyer ff5fc050d3 Update copyright year to 2020 2020-01-01 13:38:46 -05:00
Nicolas Goaziou c60a7afea1 Merge branch 'maint' 2019-12-24 14:42:58 +01:00
Nicolas Goaziou cac0e46559 org-manual: Refer to link format in "Escape Character"
* doc/org-manual.org (Escape Character): Mention Link Format section
for completeness.
2019-12-24 14:41:44 +01:00
Nicolas Goaziou 2b1b90f936 Merge branch 'maint' 2019-12-23 10:40:28 +01:00
Nicolas Goaziou 49c9cf2b6e org-manual: Tiny fix
* doc/org-manual.org (Internal Links): Tiny fix.
2019-12-23 10:39:59 +01:00
Nicolas Goaziou 2eeafcaf34 Merge branch 'maint' 2019-12-22 14:58:14 +01:00
Nicolas Goaziou 546cbad531 Link syntax require to escape every square bracket
* lisp/ol.el (org-link-make-regexps): Update regexp to forbid any
un-escaped square bracket in the URI.
(org-link-escape):
(org-link-unescape):
* testing/lisp/test-ol.el (test-ol/escape):
(test-ol/unescape):
(test-ol/store-link):
* testing/lisp/test-org.el (test-org/custom-id):
(test-org/fuzzy-links):
* testing/lisp/test-ox.el (test-org-export/resolve-fuzzy-link): Adapt
to new syntax.
* doc/org-manual.org (Link Format): Update documentation.

The new syntax allowed un-escaped opening square brackets in the URI
part of bracket links. Unfortunately, it led to bug as described here:

  <https://lists.gnu.org/archive/html/emacs-orgmode/2019-12/msg00312.html>

Now, we require to escape every square bracket in the URI.
2019-12-22 14:52:53 +01:00
Nicolas Goaziou e64323a108 Merge branch 'maint' 2019-12-17 10:34:10 +01:00
Nicolas Goaziou fa74fbb33c org-manual: Fix typo
* doc/org-manual.org (Field coordinates in formulas): Fix typo.
2019-12-17 10:33:41 +01:00
Nicolas Goaziou 2cec49554d Merge branch 'maint' 2019-12-17 10:18:16 +01:00
Nicolas Goaziou bc0d219e97 org-manual: Improve internal links documentation
* doc/org-manual.org (Internal Links): Document starred links.  Fix
documentation for text search.
2019-12-17 10:16:58 +01:00
Nicolas Goaziou 31d2f48f69 Merge branch 'maint' 2019-12-12 22:35:10 +01:00
Nicolas Goaziou b64a3308aa org-capture: Get capture templates from anonymous functions
* lisp/org-capture.el (org-capture-get-template): Allow specifying
template from an anonymous function.
* doc/org-manual.org (Template elements): Document it.
2019-12-12 22:33:22 +01:00
Kyle Meyer 955e531d24 Merge branch 'maint' 2019-12-11 21:24:45 -05:00
Paul Eggert f9a55cba31 Backport commit b0f20651e from Emacs
; Spelling fixes
b0f20651e3cbb8a66f11ffae4c18634019c20cd4
Paul Eggert
Tue Dec 10 20:05:49 2019 -0800
2019-12-11 21:22:50 -05:00
Paul Eggert ac90e86c32 Backport commit d1a791f8e from Emacs
Spelling fixes
d1a791f8edc1b8f2189b6f1b3be7b946fef1edbc
Paul Eggert
Mon Dec 9 18:45:18 2019 -0800
2019-12-11 21:19:55 -05:00
Marco Wahl e3046e22d4 Merge branch 'maint' 2019-12-11 23:11:20 +01:00
Marco Wahl 9b85eaa65a org-manual: Unify to two spaces after a dot 2019-12-11 23:10:42 +01:00
Marco Wahl 67e48de639 org-manual: Fix typo 2019-12-11 22:58:30 +01:00
Nicolas Goaziou 6504e6d35f Merge branch 'maint' 2019-12-11 22:08:04 +01:00
Nicolas Goaziou 74c9b11e80 org-manual: Fix typo
* doc/org-manual.org (Column Width and Alignment): Fix typo.
2019-12-11 22:07:42 +01:00
Nicolas Goaziou ea302ea5b5 Merge branch 'maint' 2019-12-11 21:52:14 +01:00
Nicolas Goaziou 2e6853e798 org-manual: Improve an example
* doc/org-manual.org (Computed tag filtering): Do not suggest using
one-armed `if' constructs.  Remove misleading "org" prefix, and source
block indentation.
2019-12-11 21:51:20 +01:00
Nicolas Goaziou 8d5803ced9 Merge branch 'maint' 2019-12-11 21:39:57 +01:00
Nicolas Goaziou a8da497261 org-manual: Suggest kbd macro for bindings
* doc/org-manual.org (Capture templates): Suggest kbd macro for
bindings.
2019-12-11 21:39:09 +01:00
Nicolas Goaziou 3e3819392e org-manual: Use proper markup
* doc/org-manual.org (Computed tag filtering): Use proper
markup. E.g., use verbatim for anything meant to appear in an Org
document.  Use fixed-width for single line examples. Fix spacing after
"e.g.". Use active voice and present tense.
2019-12-11 21:35:05 +01:00
Nicolas Goaziou 37a2eff212 Merge branch 'maint' 2019-12-11 21:28:42 +01:00
Nicolas Goaziou fffb57aa39 org-manual: Fix typo
* doc/org-manual.org (Computed tag filtering): Fix spacing after
"i.e.".
2019-12-11 21:27:52 +01:00
Marco Wahl ace6372a03 Merge branch 'maint' 2019-12-11 15:52:57 +01:00
Marco Wahl 5a7fadf59a manual: Fix in section [Computed tag filtering] 2019-12-11 15:50:56 +01:00
Jason Dunsmore a410413be8 org-capture: Add support for month trees
* doc/org-manual.org: Add `:tree-type month' option for capture
  templates.
* lisp/org-capture.el (org-capture-set-target-location): Add
  `:tree-type month' option to capture templates to group entries by
  month.
* lisp/org-datetree.el (org-datetree-find-month-create): Add
  `org-datetree-find-month-create' function to add datetree entries
  grouped by month.
* testing/lisp/test-org-datetree.el
  (test-org-datetree/find-month-create): Add test for new function.
2019-12-09 20:08:28 +01:00
Marco Wahl b8f43ecbf4 org,colview: Quit column-view with C-c C-c. manual,news: Update
* lisp/org-colview.el (org-columns-toggle-or-columns-quit): New
  function.  Takes the place of removed function
  org-columns-set-tags-or-toggle.
2019-12-04 23:36:33 +01:00
Marco Wahl 8ded89cc38 Merge branch 'master' into next 2019-11-26 22:45:10 +01:00
Nicolas Goaziou f4e5b75b47 org-manual: Fix `org-latex-subtitle-format' documentation
* doc/org-manual.org (LaTeX specific export settings): Fix
`org-latex-subtitle-format' documentation.
2019-11-23 17:45:23 +01:00
Kyle Meyer a4fa04bbd4 Merge branch 'master' into next 2019-11-16 17:19:11 -05:00
Kyle Meyer 6912382400 Merge branch 'maint' 2019-11-16 17:18:49 -05:00
Jonas Bernoulli 5117d8a159 Fix typos 2019-11-16 17:17:36 -05:00
Sebastian Miele 634880a2e9 org-manual: Dynamic Blocks: Fix explanation of :content
* doc/org-manual.org (Dynamic Blocks): Correct the information given
on :content in the plist passed to the writer function.
2019-11-16 17:17:21 -05:00
Gustav Wikström cffe44ba94 Merge branch 'master' into next 2019-10-21 14:58:39 +02:00
Gustav Wikström 42b8db0d34 Improve handling of org attach id to path functions
* doc/org-manual.org (Attachment options)
* etc/ORG-NEWS (Org-Attach has been refactored and extended)
(New ID method based on timestamp)
* lisp/org-attach.el (org-attach-id-uuid-folder-format)
(org-attach-id-ts-folder-format)
(org-attach-id-to-path-function-list, org-attach-dir)
(org-attach-dir-from-id): Better handling of id to path
functionality. At the same time adding an id-to-path function
for timestamp-based ID that easily can be promoted to the
primary function by customization of the user.
2019-10-20 02:49:48 +02:00
Gustav Wikström 1bdff9f73d Org document property-drawers
Add functionality to define property-blocks on document level, in
addition to at headline level.

* doc/org-manual.org:
* etc/ORG-NEWS: Document new functionality.

* lisp/org.el (org-keyword-regexp): Define constant instead of
  hardcoding.
(org-file-properties): Renamed, see next line.
(org-keyword-properties): Renamed from above.  Due to the fact that
  properties can be defined for the whole document using property
  drawers this local variable needs a rename to make its name less
  ambigous.
(org-refresh-properties, org-refresh-property, org-entry-properties)
(org-refresh-category-properties, org-get-property-block)
(org-entry-get-with-inheritance, org-entry-put)
(org-insert-property-drawer, org-end-of-subtree): Made to work before
  first headline.
(org-at-property-block-p): New function to validate if point is at the
start of a property block.
(org-property-global-value): Renamed, see next line.
(org-property-global-or-keyword-value): Renamed from above to match
  its functionality better.
(org-back-to-heading-or-point-min): New function to make a document
  work as a level 0 node in the outline.
(org-at-keyword-p): Predicate function to answer to if we're currently
at a keyword line or not.
(org-up-heading-or-point-min): New function to make a document work as
a level 0 node in the outline.

* lisp/org-element.el (org-element--current-element): Can now detect
  property-blocks before first headline according to it's positional
  rules.

* lisp/org-attach.el (org-attach): Make it possible to call the
  attachment dispatcher also before the first headline, since document
  property drawers make attachments possible for the whole document
  now.

* lisp/org-capture.el: Modified only due to rename of function in
  org.el.

* lisp/org-compat.el (org-file-properties)
(org-property-global-value): Renamed functions declared obsolete.

* testing/lisp/test-org.el (org/insert-property-drawer)
(org/set-property, org/delete-property, org/delete-property-globally):
  Additions of tests to check if they work before first headline.
(org/at-property-p, org/at-property-block-p, org/get-property-block)
(org/entry-get, org/refresh-properties): New tests

* testing/examples/property-inheritance.org: Switch from
  property-keywords to a property-drawer in the testfile.
  Functionality should be the same, but now using a document drawer
  instead of property-keywords.

  Reason for switching is that I'd like us to slowly depricate
  property-keywords.

* testing/lisp/test-org-element.el:

* contrib/lisp/ox-taskjuggler.el: A comment is modified only due to
  rename of function in org.el.
2019-10-19 14:07:58 +02:00
Nicolas Goaziou bd5f5ece55 org-manual: Document Help links
* doc/org-manual.org (External Links): Document Help links.
2019-10-13 09:41:30 +02:00
Jens Lechtenboerger 7735362101 ox-html: Control wrapping of source lines
* lisp/ox-html.el (org-html-format-code, org-html-do-format-code):
  Use new export option :html-wrap-src-lines with variable
  org-html-wrap-src-lines to control whether source code lines should
  be wrapped in code elements or not.
* doc/org-manual.org: Document the new option
2019-10-13 09:27:34 +02:00
Paul Eggert e3090573be Backport commit 946a56a10 from Emacs
* lisp/org.el (org-doi-server-url): Prefer https: to http: un URLs.

Update some URLs
946a56a10fed769646a8b7c4ebc53f53c84be896
Paul Eggert
Mon Sep 23 00:12:52 2019 -0700

Notes(km):

  - It's not mentioned in 946a56a10's message, but that commit also
    drops the dx subdomain, an "earlier syntax which continues to be
    supported" according to https://www.doi.org/factsheets/DOI_PURL.html.

  - 946a56a10 replaced a link in the manual with https://api.uva.nl/
    (which the previous link redirects to).  Here we instead use the
    replacement link from master's f4083eefd (manual: Fix URL,
    2019-06-01).
2019-09-29 15:47:58 -04:00
Carsten Dominik 6f32e7af88 Merge branch 'improve-consistency-in-filter-commands' 2019-09-09 07:36:06 +02:00
Carsten Dominik 7ac2707658 Small adaptions in the manual on filters 2019-09-09 07:34:23 +02:00
Carsten Dominik 711852ec67 Bug fix in tags filter: Treat SPC selection correctly.
* lisp/org-agenda.el (org-agenda-filter-make-matcher-tag-exp): Fix
filtering for any tag at all.
2019-09-07 15:04:03 +02:00
Carsten Dominik 5bd71d3052 Manual typo fixes 2019-09-07 14:12:37 +02:00
Carsten Dominik 20519fde4e Document the new meaning of prefix arguments in filtering commands
* doc/org-manual.org (Filtering in the agenda): Document how prefix
arguments change the bahavior of filtering commands.
2019-09-07 07:54:07 +02:00
Michaël Cadilhac 85c65b12ec Document :hidefiles in clocktable
* doc/org-manual.org (The clock table): Do it.
2019-09-05 18:56:32 +02:00
Carsten Dominik d1bdf6c789 Small fix in manual 2019-09-04 10:10:45 +02:00
Carsten Dominik 05cb7cb4ad Fix bugs in filtering 2019-09-04 09:41:29 +02:00
Carsten Dominik 7ee4cb0245 Revert `org-agenda-filter-by-category' to non-prompting state 2019-09-03 15:47:39 +02:00
Carsten Dominik f230b730c5 Make the new filter interface the default, and improve the manual
* lisp/org-agenda.el: Bind `org-agenda-filter' to `/` and move
`org-agenda-filter-by-tag' to `\`.
* doc/org-manual (Filtering/limiting agenda items): Improve the entire
section.
2019-09-01 09:12:47 +02:00
Carsten Dominik fcc0d8f509 Clarify the reach of top-level headline filtering.
* doc/org-manual.org (Filtering in the agenda): Clarify the reach of
top-level headline filtering.
2019-08-30 08:51:02 +02:00
Carsten Dominik 713a414713 Small improvements to filtering
* lisp/org-agenda.el (org-agenda-filter): Append new filter elements
instead of prepending them.  And allow an additional leading `+' to
signal that the new elements should be added to the current filter
instad of replacing them.
2019-08-30 08:35:27 +02:00
Carsten Dominik 26cde0972d Document the new additional filter interface
* doc/org-manual.org (Filtering in the agenda): Document new filter
function.
2019-08-29 21:33:11 +02:00
Nicolas Goaziou 5c55d3a53c manual: Remove erroneous footnote about :file header argument
* doc/org-manual.org (Type): :file header argument no longer
implies :results file.
2019-08-24 00:04:06 +02:00
Nicolas Goaziou 2befc22b26 org-manual: Fix zero width space example
* doc/org-manual.org (Escape Character): Fix zero width space example.

Link syntax tolerates white spaces anywhere within the square
brackets, so the example would still be a valid link.
2019-08-20 14:15:55 +02:00
Nicolas Goaziou 9ddba91b94 org-manual: Remove reference to a removed feature
* doc/org-manual.org (The Very Busy {{{kbd(C-c C-c)}}} Key): Remove
reference to "automatic table editor", which is always active anyways.
2019-08-19 12:27:57 +02:00
Nicolas Goaziou 4d8142b812 org-manual: Final changes to mode names
* doc/org-manual.org (Activation):
(Basic TODO Functionality):
(Multiple keyword sets in one file):
(Priorities):
(The global TODO list):
(Editing support):
(Summary of In-Buffer Settings):
(Packages that conflict with Org mode):
(Adding Hyperlink Types): Change Lisp symbol into its proper name.

In particular, there is no "shift-selection-mode" in Emacs, but
a "shift-selection" feature.  There is a "shift-select-mode" variable,
however, but the entry in the Emacs manual is really about
"shift-selection".
2019-08-19 10:58:33 +02:00
Nicolas Goaziou edefa0fac2 org-manual: Additional org-indent-mode -> Org Indent mode change
* doc/org-manual.org (Footnotes): When writing about a mode, use its
full name, not the Lisp symbol.
2019-08-19 10:47:06 +02:00
Nicolas Goaziou af572ace74 org-manual: Fix typo
* doc/org-manual.org (Org Indent Mode): Fix typo.
2019-08-19 10:38:20 +02:00
Nicolas Goaziou 576d6ab6c6 org-manual: Fix typo
* doc/org-manual.org (Deadlines and Scheduling): Fix typo.
2019-08-19 10:30:33 +02:00
Nicolas Goaziou 3244abbe6d org-manual: Fix minor mode name
* doc/org-manual.org (Headlines):
(A Cleaner Outline View):
(Org Indent Mode): Prefer real name instead of Lisp symbol.  Fix
typos.
2019-08-19 10:30:02 +02:00
Nicolas Goaziou 810860a613 org-manual: Fix indentation
* doc/org-manual.org (Summary of In-Buffer Settings): Remove spurious
indentation.
2019-08-19 10:20:47 +02:00
Carsten Dominik 4789fc3bfd Renumber and validate all footnotes in the manual 2019-08-19 09:46:08 +02:00
Carsten Dominik bca4f1792e Introduce an early reference to org-indent-mode into the manual
* doc/org-manual.org (Headlines): Introduce a reference to
`org-indent-mode'.
2019-08-18 12:23:26 +02:00
Carsten Dominik 81ca61f54f Document noindent STARTUP keyword 2019-08-18 11:20:38 +02:00
Carsten Dominik 6dfd4e38d0 Simplify the "Hard Indentation" section in the manual
* doc/org-manual.org (Hard Indentation): Simplify section.
2019-08-18 11:06:33 +02:00
Carsten Dominik 16f3fd69c3 Various small changes to the manual
* doc/org-manual.org: Compactify the summary of in-buffer
options. Move Org Protocol section to the Miscellaneous chapter.
2019-08-18 09:42:40 +02:00
Carsten Dominik f8d81f4aaa Fix indentation problem in manual that broke structure
* doc/org-manual.org (Summary of In-Buffer Settings): Fix indentation problem.
2019-08-17 22:11:32 +02:00
Carsten Dominik a37dee547e Make Attachment subsections unnumbered 2019-08-17 18:03:20 +02:00
Carsten Dominik 6b21c97bbe Rename sections in the manual
* doc/org-manual.org (Refiling and Archiving): Renamed from
Refile, Copy and Archiving.
(Capture and Attachments): Renamed from Capture, Attachments,
RSS Feeds and Protocols.
2019-08-17 18:01:01 +02:00
Carsten Dominik 1c9be12119 Restructure Miscellaneous section of the manual
doc/org-manual.org: Restructure Miscellaneous section of the manual,
remove Customization subsection
2019-08-17 17:55:52 +02:00
Nicolas Goaziou 552bb0764a org-manual: Fix typo
* doc/org-manual.org (Literal Examples): Fix typo.
2019-08-17 15:40:36 +02:00
Nicolas Goaziou 8229a59828 Merge branch 'maint' 2019-08-17 15:31:05 +02:00
Nicolas Goaziou 4cb3a37533 org-manual: Fix typo
* doc/org-manual.org (LaTeX specific export settings): Fix typo.

Reported-by: Emmanuel Charpentier <emm.charpentier@free.fr>
<http://lists.gnu.org/r/emacs-orgmode/2019-07/msg00153.html>
2019-08-17 15:29:16 +02:00
Nicolas Goaziou 9e083fdf42 org-manual: More visible information about "comma escape"
* doc/org-manual.org (Literal Examples): Move information about "comma
escape" outside of the footnote.  Delete related footnote.

Suggested-by: Štěpán Němec
2019-08-17 15:21:09 +02:00
Nicolas Goaziou d841b38086 org-manual: Slight rewording for indented source blocks
* doc/org-manual.org (Literal Examples): Slight rewording.  Merge
indentation information into the same paragraph.
2019-08-17 14:50:08 +02:00
Nicolas Goaziou d8778d9305 org-manual: Fix typo
* doc/org-manual.org (Literal Examples): The major mode name differs
from the symbol used.
(Footnotes): Fix typo.
2019-08-17 14:32:16 +02:00
Nicolas Goaziou c7bce7a986 org-manual: Fix typo
* doc/org-manual.org (Dynamic Headline Numbering): Fix typo.
2019-08-17 09:21:18 +02:00
Nicolas Goaziou 836f1396fc Clarify the difference between org-indent-mode and hard indentation
doc/org-manual.org (A Cleaner Outline View): Clarify the difference
between org-indent-mode and hard indentation.
2019-08-17 02:00:42 +02:00
Nicolas Goaziou 518691598d org-manual: Fix wrong footnote number
* doc/org-manual.org (External Links): Fix footnote number.
2019-08-17 01:52:09 +02:00
Nicolas Goaziou 00cf093dd1 Revert " Clarify the difference between org-indent-mode and hard indentation"
This reverts commit ebf10f126c.

The change propagates an error in a footnote number.
2019-08-17 01:51:21 +02:00
Carsten Dominik ebf10f126c Clarify the difference between org-indent-mode and hard indentation
doc/org-manual.org (A Cleaner Outline View): Clarify the difference
between org-indent-mode and hard indentation
2019-08-16 23:31:57 +02:00
Carsten Dominik bb275b85df Remove duplicate information from the manual
* doc/org-manual.org (Tracking TODO state changes): Remove duplicated
information.
2019-08-16 17:27:01 +02:00
Carsten Dominik 07e48a7af6 Merge branch 'fix-org-columns-formatdocumentation' 2019-08-16 09:37:54 +02:00
Carsten Dominik 6dda536f9f Clear up unclear setting of columns format for the agenda
* lisp/org.el (org-columns-default-format-for-agenda): New option.

* lisp/org-colview.el (org-overriding-columns-format): Updated documentation.
(org-agenda-columns): `Use org-columns-default-format-for-agenda'

* doc/org-manual.org (Using Column View in the Agenda): Fix the
description how to set the columns format for agenda views.
2019-08-16 09:34:55 +02:00
Carsten Dominik f1c030bed5 Prefix argument to `org-todo' forces stage change logging
* lisp/org.el (org-use-fast-todo-selection): Allow values
`auto' and `expert'.
(org-todo): Change the interpretation of the prefix argument.
A single `C-u' now forces taking a logging time stamp and note.
(org-fast-todo-selection): Implement the `expert' option of
`org-use-fast-todo-selection' and avoid showing the selection
window.  Instead, show the options in the prompt.

* doc/org-manual.org: (Basic TODO Functionality): Document that `C-u
C-c C-t' is the simplest way to log a TODO state change.
(TODO keywords as workflow states): Slightly simplify text.
(TODO keywords as types): Document that tags should be used instead.
(Progress Logging, Closing items, Tracking TODO state changes):
Document that `C-u C-c C-t' is the simplest way to log a TODO
state change.
(Remote editing): Document using a prefix to the `org-agenda-todo'
command logs the state change.
(Using CDLaTeX to enter math): Document that CDLaTeX is	available on
MELPA.

* doc/org-guide.org (Progress Logging): Document the use of a
prefix to `org-todo' to force logging.
2019-08-14 09:58:38 +02:00
Carsten Dominik 64739aa065 Implement force logging of a TODO state change
* lisp/org.el (org-todo): Make a tripple `C-u' prefix force
          logging the todo state change with timestamp and a note.
          Ignoting blocking a change now needs four `C-u' prefixes,
          because this is probably hardly ever used.

	* doc/org-manual.org (Tracking TODO state changes): Document
          forcing of state change logging with `C-u C-u C-u C-c C-t'.
2019-08-01 08:10:20 +02:00
Kyle Meyer 9a543b97a5 orgguide: Fix typo
* doc/orgguide.texi (Embedded @LaTeX{}): Fix typo.

Reported-by: Thomas Nguyen <thomas.nguyen1@okcps.org>
2019-07-23 23:24:31 -04:00
Marco Wahl 13442ab719 org-manual: Fix key to toggle persistent marks 2019-07-24 00:02:27 +02:00
Carsten Dominik e059c1c1da Improve formatting and alignment in the refernce card 2019-07-19 10:36:57 +02:00
Carsten Dominik df7c78220a Document org-indent-mode and template insertion in refcard 2019-07-19 10:19:22 +02:00
Carsten Dominik 9e1e682135 Improve the mention of indent-mode in the guide 2019-07-19 08:58:16 +02:00
Marco Wahl 96267295a6 org-manual.org: Clarification about keys in Search view 2019-07-15 11:03:44 +02:00
Marco Wahl dc2198971b org-agenda: Respect narrowing for agenda restricted to buffer
* lisp/org-agenda.el (org-agenda): Add a condition to check if
  narrowing is in effect and in case set the agenda restriction markers.
* etc/ORG-NEWS (Respect narrowing when agenda command is restricted to buffer):
* doc/org-manual.org (The Agenda Dispatcher): Mention the behavior.
2019-07-15 00:22:51 +02:00
Carsten Dominik 8a30e8efef Fix typos in org-guide.org 2019-07-14 22:56:51 +02:00
Carsten Dominik aaca138324 Apply the proper way to describe a key in the guide 2019-07-14 14:05:44 +02:00
Carsten Dominik e571ca8e9d Document structure template insertion in the compact guide 2019-07-14 14:02:12 +02:00
Marcin Borkowski c2ef61ffcf Explain the `org-agenda-todo-ignore-...` variables in the manual 2019-07-09 12:19:25 +02:00
Gustav Wikström ae9cd4370b org-attach*, org, org-manual, org-news, ox-html, testing/*
* lisp/org-attach.el

Changed the way attachments deal with property-inheritance.  It now
adheres to the =org-use-property-inheritance= setting by default but
it can be customized if needed (I recommend to enable it!).
The property ATTACH_DIR is deprecated in favour of the shorter and simpler
property DIR.

Added an explicit option to =org-attach= for unsetting
attachment-directories (i.e. remove DIR property and deal with the
attachments by interaction).

Added attachment link type with the prefix "attachment:".

Added customizations:
- org-attach-dir-relative
- org-attach-preferred-new-method
- org-attach-use-inheritance
- org-attach-id-to-path-function

Hooks added:
- org-attach-after-change-hook
- org-attach-open-hook

A new linktype "attachment" is added in order to reduce
link-duplication when wanting to link to files in attached folders of
nodes.  This works for both ID and DIR properties.  The goal is to
make the functionality for attachment links mirror the functionality
for file links.

* lisp/org-attach-git.el

New file, existing functionality.  Code here has been factored out
from org-attach.el and if GIT-functionality is to be used this module
needs to be required sepatately.  It extends org-attach by use of its
hooks.

Activating git functionality in org-attach is done by loading
org-attach-git from now on, instead of customizing a variable.

Naming of both functions and tests has been modified to match the move
of functionality into its own module.

* lisp/org.el

Inline images are shown also using attachment-links, exactly the same
as it works for file-links today.

Make org-open-at-point respect ARG when opening attachment-dir.

* lisp/org-compat.el

org-attach-directory has been deprecated in favour for
org-attach-id-dir.  The new name matches its purpose better.

* lisp/ox-html.el

Export attachment links to images as inline images, in the same way as
file links work today.

* etc/ORG-NEWS

Mention the changes in this patch.

* doc/org-manual.org

The chapter "Refile, Copy, Archive" has been split into two separate
chapters.
- "Refile, Copy and Archiving" for information related to moving
  existing data around.

- "Capture, Attachments, RSS Feeds and Protocols" for information
  related to working with external data.

The attachment-part has been rewritten and extended to match the
changes in this patch.

The new attachment link type is mentioned both inside the attachments
chapter and in the chapter dealing with links.

Documentation related to external links has been improved.

* testing/lisp/test-org-attach-annex.el

Require org-attach-git instead of org-attach, since this file tests
the GIT-functionality.

* testing/lisp/test-org-attach.el

Add tests for org-attach.

* testing/org-test.el

Define a symbol for a file to test attachments with.

* testing/examples/*

A bunch of new example files and folders are created and are used in
testing of org-attach to verify its functionality.
2019-07-07 19:55:49 +02:00
Nicolas Goaziou 9ddfe45314 org-table: Improve `org-table-copy-down'
* lisp/org-table.el (org-table--increment-field): New function.
(org-table-copy-down): Use new function.
* testing/lisp/test-org-table.el (test-org-table/copy-down): New test.
* doc/org-manual.org (Calculations): Update documentation.
2019-06-28 00:07:25 +02:00
Nicolas Goaziou 2263634823 org-manual: Fix typo
* doc/org-manual.org (From Carsten): Fix typo.
2019-06-22 09:33:33 +02:00
Kyle Meyer 81920b3f86 Merge branch 'maint' 2019-06-09 21:39:18 -04:00
Paul Eggert 65a6f54605 Backport commit 852d28176 from Emacs
Update author/maintainer info
852d28176990d035366142bfde36a0440a317228
Paul Eggert
Sun May 26 01:00:16 2019 -0700
2019-06-09 21:35:45 -04:00
Gregor Zattler f4083eefd8 manual: Fix URL
* doc/org-manual.org (External Links): Fix URL
2019-06-07 23:34:46 +02:00
Nicolas Goaziou fb50912228 org-manual: Fix link to CDLaTeX mode
* doc/org-manual.org (Using CDLaTeX to enter math): Fix link to
  CDLaTeX mode.

Reported-by: Qqwy/Wiebe-Marten <qqwy@gmx.com>
<http://lists.gnu.org/r/emacs-orgmode/2019-06/msg00028.html>
2019-06-05 23:15:49 +02:00
Sacha Chua a41e9950ae Add :target option for the TOC keyword
* doc/org-manual.org, etc/ORG_NEWS: Document :target option
  for the TOC keyword.

* lisp/ox.el (org-export-resolve-link): New function.

* lisp/ox-ascii.el (org-ascii-keyword): Added :target to the TOC
  keyword.
  (org-ascii--build-toc): Changed LOCAL argument to SCOPE.

* lisp/ox-html.el (org-html-keyword): Added :target to the TOC keyword.

* lisp/ox-md.el (org-md-keyword): Added :target to the TOC keyword.
  (org-md--build-toc): Changed LOCAL argument to SCOPE.

* lisp/ox-odt.el (org-odt-keyword): Added :target to the TOC keyword.

* testing/lisp/test-ox.el (test-org-export/collect-headlines): Added
  tests for specifying scope by CUSTOM_ID or by fuzzy matching.
  (test-org-export/resolve-link): New test.
2019-05-30 15:25:46 +02:00
Kyle Meyer 84a4b73fd6 Merge branch 'maint' 2019-05-16 21:23:18 -04:00
Cheong Yiu Fung 2c9f259d65 org-manual: Small fixes
* doc/org-manual.org (Handling Links): Update variable
`org-id-link-to-org-use-id', which was changed in v7.9.2.

TINYCHANGE
2019-05-16 21:22:19 -04:00
Nicolas Goaziou cd1af27a2a Merge branch 'maint' 2019-05-10 19:38:27 +02:00
Josiah Schwab 4df7051255 manual: Update ADS link abbreviation example
* doc/org-manual.org (Link Abbreviations): Change URL.

Reported-by: Alain Kalker <a.c.kalker@gmail.com>
<http://lists.gnu.org/r/emacs-orgmode/2019-05/msg00083.html>

TINYCHANGE
2019-05-10 19:36:58 +02:00
Nicolas Goaziou c47c686d5f Merge branch 'maint' 2019-05-08 14:19:04 +02:00
Nicolas Goaziou e95ac0bac3 org-manual: Delete reference to removed function
* doc/org-manual.org (Inserting deadlines or schedules): Remove
  reference to `org-mark-entry-for-agenda-action`.

Reported-by: Christian Heinrich <com-orgmode@gladbachcity.de>
<http://lists.gnu.org/r/emacs-orgmode/2019-05/msg00060.html>
2019-05-08 14:17:30 +02:00
Nicolas Goaziou 8db6f52c0d Merge branch 'maint' 2019-04-25 10:28:45 +02:00
Sebastian Miele 4ec550fd5a org-manual: Fix typo
* doc/org-manual.org (Footnotes): Fix typo.
2019-04-25 10:28:05 +02:00
Nicolas Goaziou 262bcb4557 org-manual: Add missing description for Beamer export
* doc/org-manual.org (Beamer Export): Add missing description.
2019-04-23 10:42:45 +02:00
Emmanuel Charpentier 5b7b0fa8fb ox-latex: Support a :scale parameter
* lisp/ox-latex.el (org-latex-image-default-scale): Nev variable.
(org-latex--inline-image): Handle new :scale parameter.
* doc/org-manual.org (Images in LaTeX export): document the new :scale

Introduce a :scale #+ATTR_LATEX parameter, as well as a "" default
value for it.  When present, it overrides :width and :height
parameters (as it does for ODT export and in ox-pandoc exporters).

Implementation: uses \scalebox for tikz/pgf images, "scale=" parameter
of \includegraphics in other cases.
2019-04-22 14:01:59 +02:00
Nicolas Goaziou 6d283dcade Merge branch 'maint' 2019-04-17 14:22:21 +02:00
Sebastian Miele 0803e2d0ea org-manual: Minor fixes
* doc/org-manual.org (Motion): Fix the names of the four functions
  bound to C-c C-n, C-c C-p, C-c C-f, and C-c C-b.
2019-04-17 14:20:48 +02:00
Nicolas Goaziou a9d3eaa9f3 Merge branch 'maint' 2019-03-27 15:34:16 +01:00
Nicolas Goaziou 03b8d1651c org-manual: Fix typo
* doc/org-manual.org (Agenda Views): Fix count.
2019-03-27 15:32:59 +01:00
Nicolas Goaziou d588274878 Factor out setup for doc
* doc/doc-setup.org: New file.
* doc/org-guide.org:
* doc/org-manual.org: Use new file.
2019-03-19 02:25:18 +01:00
Nicolas Goaziou 092f3f76b7 org-manual: Various fixes
* doc/org-manual.org (Activation):
(Formula syntax for Calc):
* doc/org-manual.org (External Links): Fix link.
(TODO dependencies):
(Closing items):
(Breaking Down Tasks into Subtasks):
(Deadlines and Scheduling): Use "marked as done" instead of "marked
DONE".
(Filtering/limiting agenda items): Fix typo.
(Creating Footnotes): Rewrite description.  Remove useless paragraph.
(Headings and sectioning structure):
(A Texinfo example): Fix link.
(Summary of In-Buffer Settings): Use "marked as done" instead of
"marked DONE".
(Packages that Org cooperates with):
(Footnotes): Fix link.
2019-03-19 02:25:18 +01:00
Nicolas Goaziou afd566e633 Add org-guide.org to the build process 2019-03-19 02:25:18 +01:00
Nicolas Goaziou 1a678f184f Generate compact guide from an Org file
* doc/orgguide.texi:
* doc/doclicense.texi:
* doc/docstyle.texi: Delete files.
* doc/org-guide.org: New file.
2019-03-19 02:25:01 +01:00
Marco Wahl 2e92b9abb9 org-habit: C-u K in agenda toggles display all/today habits
* lisp/org-habit.el (org-habit-toggle-display-in-agenda): New command.
2019-03-18 17:06:28 +01:00
Nicolas Goaziou 7d158baebe org-manual: Clarification for results header argument
* doc/org-manual.org (Results of Evaluation): Work around ambiguity
  between "format" and "handling" class.  Fix typography.
2019-03-17 08:57:21 +01:00
Nicolas Goaziou a70ab164f4 org-manual: Small fixes
* doc/org-manual.org (Emphasis and Monospace): Differentiate Org from
  Org mode.
(Images): Remove useless @noindent command.
(Export Settings): Use proper markup for CLOCK syntax.  Differentiate
DONE tasks from done tasks.
(Include Files): Clarify that <C-c '> does not allow to navigate back
from an included file.
(ASCII export commands): Fix FINDEX entry
(Triggering Publication): Fix keybindings.
(Editing Source Code): Turn major-mode into major mode.
2019-03-16 13:58:30 +01:00
Nicolas Goaziou 1466e93131 org-manual: Small fixes
* doc/org-manual.org (Plain Lists): Use =DONE= for specific DONE keyword.
(Timestamps): Fix node name.  Replace "sepx" with "expression", as in
the Elisp manual.
(Deadlines and Scheduling): Replace "sepx" with "expression", as in
the Elisp manual.
(Repeated tasks): Use "entry as done" instead of "entry DONE", since
DONE is not the only DONE keyword possible.
(Clocking commands): Use appropriate markup for "CLOCK" keyword.
(Capture templates): Remove unnecessary @noindent.
(Refile and Copy): Move `org-copy' binding below.
(Agenda Files): Use real library name: Iswitchb.
(The Agenda Dispatcher): Use :sep attribute.
(Calendar/Diary integration): Replace "sepx" with "expression", as in
the Elisp manual.
(The global TODO list): Update node change.
(Matching tags and properties): Fix markup for tags.
(Change display): Use "marked as done" instead of "marked DONE".
(Storing searches): Remove unnecessary @noindent command.  Prefer
present tense over future.
(Footnotes): Use "marked as done" instead of "marked DONE". Replace
"sepx" with "expression".  Apply node name change.
2019-03-16 09:27:07 +01:00
Nicolas Goaziou e73a7f87f9 org-manual: Remove redundant information
* doc/org-manual.org (Checkboxes): Remove redundant information.
2019-03-13 22:17:01 +01:00
Nicolas Goaziou d300028f85 org-manual: Include gfdl as an Org file
* doc/fdl.org: New file.
* doc/org-manual.org (GNU Free Documentation License): Include Org
  file instead of the Texinfo one.
(A Texinfo example): Update example.
2019-03-13 16:24:28 +01:00
Nicolas Goaziou 67de9a6865 ox-texinfo: Support lettered lists
* lisp/ox-texinfo.el (org-texinfo-plain-list): Add :enum attribute.
* doc/org-manual.org (Plain lists in Texinfo export): Document :enum
  attribute.
2019-03-13 15:38:43 +01:00
Nicolas Goaziou c3ce8d1c14 org-manual: Fix link escape syntax documentation
* doc/org-manual.org (Link Format): Add missing escape rule in links.
  Tiny rewording.  Add an entry in the main index.
2019-03-13 12:04:53 +01:00
Nicolas Goaziou 300f15bcbb org-manual: Tiny markup consistency fix
* doc/org-manual.org (Using Org's git repository): Use =...= for full
  commands.
2019-03-12 10:47:27 +01:00
Nicolas Goaziou 6bea4f4459 org-manual: Update file names
* doc/org-manual.org (Custom Searches):
(Anniversaries from BBDB):
(List of Contributions): Use "ol-" prefix for file names.
2019-03-12 10:46:31 +01:00
Nicolas Goaziou dccccee7fc org-manual: Move "Creating Footnotes" to "Markup for Rich Contents" 2019-03-10 18:00:36 +01:00
Nicolas Goaziou cf079592c4 org-manual: Move document keywords to the top of the file 2019-03-10 18:00:36 +01:00
Nicolas Goaziou 1c936fd2ac org-manual: Document new link syntax
* doc/org-manual.org (Link Format): Document rules for escaping
  sensitive characters in a link.
2019-03-10 18:00:36 +01:00
Nicolas Goaziou 4e4e5fbbf4 org-manual: Update link variables and functions
* doc/org-manual.org (Handling Links):
(Template expansion):
(Code Evaluation and Security Issues):
(Footnotes): Update link variables and functions.
2019-03-10 18:00:36 +01:00
Nicolas Goaziou 8060ca6727 org-manual: Fix footnotes
* doc/org-manual.org (Clocking commands): Fix footnote numbers.
2019-03-10 17:34:34 +01:00
Nicolas Goaziou 1f3bd5f62a Merge branch 'maint' 2019-03-10 17:32:47 +01:00
Nicolas Goaziou 5ac6ca24fa org-manual: Fix footnote
* doc/org-manual.org (A LaTeX example of radio tables): Fix footnote
  number.
2019-03-10 17:26:22 +01:00
Nicolas Goaziou 56b7c5ba59 Merge branch 'maint' 2019-03-10 11:05:37 +01:00
Nicolas Goaziou cebd6417b2 org-manual: Clarify clock table parameters value
* doc/org-manual.org (The clock table): Clarify boolean values.

Reported-by: Nikolay Kudryavtsev <nikolay.kudryavtsev@gmail.com>
<http://lists.gnu.org/r/emacs-orgmode/2019-03/msg00108.html>
2019-03-10 11:04:50 +01:00
Nicolas Goaziou 2e06d61915 org-manual: Slight change to mkdirp documentation
* doc/org-manual.org (Choosing a working directory): Document "mkdirp"
  in conjunction with "dir".
(Header arguments): Remove reference to "mkdirp" and "dir" combination.
2019-03-04 22:56:00 +01:00
stardiviner 8b5941330b ob-core: Make :mkdirp work for :dir too
* lisp/ob-core.el (org-babel-execute-src-block): Make directory if
  ":dir path" does not exist when ":mkdirp yes" exist.

* doc/org-manual.org (Header arguments): Document it.

* testing/lisp/test-ob.el: Add a specific testing file for ob-core.el,
  and add a testing for ":mkdir yes" work with :dir header argument
  usage.
2019-03-04 22:25:48 +01:00
Nicolas Goaziou c2c91f0589 Merge branch 'maint' 2019-02-28 00:24:30 +01:00
Nicolas Goaziou 2afca09936 org-manual: Remove unnecessary introductory section
* doc/org-manual.org (Outlines): Remove section.
2019-02-28 00:21:52 +01:00
Nicolas Goaziou 819864aebb Merge branch 'maint' 2019-02-27 21:56:36 +01:00
Nicolas Goaziou cc7c4a6732 Rationalize `org-link-(un)escape'
* contrib/lisp/org-contacts.el (org-contacts-vcard-format):
* contrib/lisp/org-link-edit.el (org-link-edit--link-data):
* contrib/lisp/org-notmuch.el (org-notmuch-search-store-link):
(org-notmuch-search-follow-link):
(org-notmuch-tree-follow-link):
* lisp/org-docview.el (org-docview-export):
* lisp/org-element.el (org-element-link-parser):
* lisp/org-lint.el (org-lint-link-to-local-file):
* lisp/org-protocol.el (org-protocol-split-data):
(org-protocol-parse-parameters):
* lisp/org.el (org-open-at-point):
(org-display-inline-images):
* lisp/ox-ascii.el (org-ascii-link):
* lisp/ox-html.el (org-html-link):
* lisp/ox-latex.el (org-latex--inline-image):
(org-latex-link):
* lisp/ox-publish.el (org-publish-resolve-external-link):
* lisp/ox.el (org-export-custom-protocol-maybe):
(org-export-resolve-fuzzy-link): Do not call `org-link-unescape' when
the link is obtained through the parser or as a user input.
* doc/org-manual.org (Link Format): Document escape syntax.

See <http://lists.gnu.org/r/emacs-orgmode/2019-02/msg00320.html>
2019-02-27 20:22:51 +01:00
Nicolas Goaziou 87a00b3595 Merge branch 'maint' 2019-02-25 13:47:40 +01:00
Allen Li cc020dbe4d Fix buffer local org-agenda-overriding-columns-format bug
* doc/org-manual.org (Using Column View in the Agenda): Updated
  reference to variable.
* lisp/org-agenda.el (org-agenda-finalize): Set buffer local variable
  instead.
* lisp/org-colview.el (org-overriding-columns-format): Renamed.
(org-agenda-overriding-columns-format): Renamed.
(org-local-columns-format): New buffer local variable.
(org-columns-edit-value): Updated reference to variable.
(org-columns-next-allowed-value): Updated reference to variable.
(org-agenda-columns): Updated reference to variable.

Setting org-agenda-overriding-columns-format as a buffer local value
interferes with how it is used as a dynamically scoped var, so use a
separate variable for buffer local setting.
2019-02-25 13:41:40 +01:00
Nicolas Goaziou a7cf12feb5 Merge branch 'maint' 2019-02-17 20:53:31 +01:00
Nicolas Goaziou 126a37c36c org-manual: Small fixes
* doc/org-manual.org (Macro Replacement): Shorten a macro. Fix a macro
  name.
(A Beamer example): Fix escape syntax.  Narrow example.
2019-02-17 20:52:35 +01:00
Nicolas Goaziou 1cdcf36a03 org-manual: Fix indentation in description lists
Fix indentation according to recent indentation rules changes in
description lists.
2019-02-14 01:15:20 +01:00
Nicolas Goaziou 6d9022df22 Make LaTeX preview toggle more useful and predictable
* lisp/org.el (org-remove-highlights-with-change):
(org-mode): Update.
(org--format-latex-make-overlay):
(org--list-latex-overlays): Remove functions.
(org--make-preview-overlay):
(org-clear-latex-preview):
(org--latex-preview-region):
(org-latex-preview): New functions.
(org-format-latex): Use new function
* lisp/org-compat.el (org-toggle-latex-fragment):
(org-remove-latex-fragment-image-overlays): Deprecate.
* doc/org-manual.org (Previewing LaTeX fragments): Update
  documentation about `org-latex-preview'.

See <http://lists.gnu.org/archive/html/emacs-orgmode/2019-02/msg00138.html>.
2019-02-14 00:14:25 +01:00
Marco Wahl c3bb0118be Merge branch 'maint' 2019-02-11 09:56:47 +01:00
Marco Wahl 476066b13c org-manual: Fix reference to binding of org-info-find-node
Reported by Ian Garmaise <ian.g@phorixsol.com>
Archived-At: <http://permalink.gmane.org/gmane.emacs.orgmode/123498>
2019-02-11 09:53:39 +01:00
Marco Wahl 56eacb4a68 Merge branch 'maint' 2019-02-09 16:28:51 +01:00
Marco Wahl 0985f72a4d org-manual: Fix documentation about org-agenda-bulk-toggle-all
Reported by Ian Garmaise.
Archived-At: <http://permalink.gmane.org/gmane.emacs.orgmode/123486>
2019-02-09 16:28:11 +01:00
Kyle Meyer 2d88cfbc08 Merge branch 'maint' 2019-02-03 12:05:49 -05:00
Kyle Meyer 1a16155d99 org-manual: Fix unbalanced parentheses in an example
* doc/org-manual.org (Attachments): Balance parentheses in code
snippet.
2019-02-03 12:03:54 -05:00
Nicolas Goaziou eefd0c99e8 Merge branch 'maint' 2019-02-02 22:48:45 +01:00
Nicolas Goaziou 7c00e4fbd8 orgguide: Fix typo
* doc/orgguide.texi (Refile and copy): Fix typo in `org-copy' binding.
2019-02-02 22:48:32 +01:00
Nicolas Goaziou eecfa010b4 Merge branch 'maint' 2019-01-30 22:49:35 +01:00
Nicolas Goaziou d3d9e0bfc0 org-manual: Specify that inactive timestamps are not repeated
* doc/org-manual.org (Repeated tasks): Specify that inactive
  timestamps are not repeated.  Fix markup and typo.
2019-01-30 22:46:47 +01:00
Kyle Meyer ba321d0e44 Merge branch 'maint' 2019-01-13 15:14:37 -05:00
Radon Rosborough 31a861e0d3 Backport commit 24acb31c0 from Emacs
* doc/org-manual.org: Don't recommend to call package-initialize in
the init file.

Add early init file, stop package-initialize insertion
24acb31c04b4048b85311d794e600ecd7ce60d3b
Radon Rosborough
Sat Feb 17 13:36:16 2018 +0200
2019-01-13 12:43:04 -05:00
Kyle Meyer 9ceb723602 org-clock: Simplify `untilnow' range logic
* lisp/org-clock.el (org-clock-special-range): Use nil to represent
`untilnow'.
* lisp/org-clock.el (org-clocktable-steps): For `untilnow' block, set
set timestamp to 2003.
* doc/org-manual.org (The clock table): Document `untilnow' floor when
used with :step.

For `untilnow', org-clock-special-range sets the start to
"<-50001-11-30 Tue 00:00>", but org-parse-time-string actually assumes
a YYYY-MM-DD format and parses the year as 0001.  By chance, this is
still a really old date, so no one noticed.  However, with the port of
Emacs's fde99c729c (Port recent org-clock fix to POSIX time_t,
2018-03-28), test-org-clock/clocktable/ranges would fail if the system
supports the oldest date tried, "<-67715-09-22 Tue 17:51>".

But this "encode-time -> format-time-string -> org-parse-time-string"
dance is mostly unnecessary.  All the current org-clock-special-range
callers except for org-clocktable-steps (1) explicitly check if the
starting time is nil, (2) don't use the starting time, or (3) pass it
directly to org-clock-sum, which handles nil values.  And
org-clock-sum executes the same codepath when nil is passed instead of
"really old date".

Update org-clocktable-steps to use 2003 (the year Org was created) as
the starting point when org-clock-special-range returns nil for the
starting time.  This is more efficient because we don't needlessly
calculate steps over a large chunk of time that almost certainly
doesn't have any clocked time.  And it won't run into the portability
issues like Emacs's fde99c729c.  2003 _should_ be an appropriate
effective starting date, since we don't expect clocked time before the
existence of Org.  If this turns out to be an issue (e.g., someone
converted reports from a pre-Org and still makes clock tables that
include those times), we can make this value configurable.
2019-01-13 12:41:29 -05:00
Nicolas Goaziou 2cf951cdfc org-manual: Remove deleted keybinding
* doc/org-manual.org (The clock table): Remove `C-c C-x r` reference.
2019-01-12 12:40:12 +01:00
stardiviner 34b71a0ca9 Add a dispatcher command for inserting dynamic blocks
* lisp/org.el (org-dynamic-block-insert-dblock,
  org-dynamic-block-alist, org-dynamic-block-functions,
  org-dynamic-block-types, org-dynamic-block-define,
  org-dynamic-block-function): New variables, New functions.

* lisp/org-keys.el (org-dynamic-block-insert-dblock): Add binding for
  the function.
(org-clock-report, org-columns-insert-dblock): Remove function
keybindings. Mark them as obsolete.

* doc/org-manual.org (Dynamic Blocks): : Add manual for dispatch
command `org-dynamic-block-insert-dblock'.

* testing/lisp/test-org-clock.el: New test.
2019-01-02 15:55:51 +01:00
Nicolas Goaziou 69c300bbf6 Add Org Num minor mode
* doc/org-manual.org (Headlines): Refer to new section.
(Dynamic Headline Numbering): New section.
* lisp/org-num.el:
* testing/lisp/test-org-num.el: New files.
2019-01-01 22:08:24 +01:00
Bastien 7a22b8f93b Merge branch 'maint' 2019-01-01 11:54:01 +01:00
Bastien f584d37a67 Update copyright year 2019-01-01 11:50:56 +01:00
Nicolas Goaziou c4e744ec8e Merge branch 'maint' 2018-12-29 15:51:18 +01:00
Nicolas Goaziou 19babce53f org-manual: Fix markup
* doc/org-manual.org (Field and range formulas): Use =...= markup for
  text meant to be inserted in an Org document.
2018-12-29 15:50:43 +01:00
Toon Claes e37412b5d2 ox-html: Make it possible to self link headlines
* lisp/ox-html.el (org-html-self-link-headlines): New variable.
(org-html-headline): Create a hyperlink on headlines
when :html-self-link-headlines is set.
2018-12-29 14:58:43 +01:00
Nicolas Goaziou 2154339e4b Merge branch 'maint' 2018-12-27 11:22:37 +01:00
Nicolas Goaziou be9bfd3ff4 org-manual: Small fixes
* doc/org-manual.org (Completion): Use @kbd markup in description.
(Context Dependent Documentation): Improve description and wording.
Add kindex entry.
2018-12-27 11:20:27 +01:00
Nicolas Goaziou f502203e76 Merge branch 'master' into next 2018-12-20 18:36:27 +01:00
Nicolas Goaziou 908b55124c org-manual: Fix markup
* doc/org-manual.org (Initial visibility): Fix markup.
2018-12-20 18:36:01 +01:00
Nicolas Goaziou 86a0659af8 Merge branch 'master' into next 2018-12-18 01:17:46 +01:00
Nicolas Goaziou cd0517da24 org-manual: Fix markup
* doc/org-manual.org (Handling Links):
(Using capture):
(Capture templates):
(Refile and Copy):
(Footnotes): Fix markup.
2018-12-18 01:17:15 +01:00
Nicolas Goaziou 6920c4390d Merge branch 'master' into next 2018-12-14 14:38:08 +01:00
Nicolas Goaziou dc74770706 org-manual: Fix typos
* doc/org-manual.org (Using Emacs packaging system):
(Formula syntax for Calc):
(Lookup functions):
(Weekly/daily agenda):
(Setting limits for the agenda):
(Export Settings):
(Other Built-in Back-ends):
(Structure Templates):
(Adding Hyperlink Types): Use correct markup for sexps.
(Using the Mapping API): Fix typo.  Use correct markup.
2018-12-14 14:37:01 +01:00
Nicolas Goaziou a34b43629b Merge branch 'master' into next 2018-12-14 14:23:09 +01:00
Nicolas Goaziou b3afd71a06 org-manual: Small fixes
* doc/org-manual.org (A LaTeX example of radio tables): Use correct
  markup, improve wording, fix typo.
2018-12-14 14:22:07 +01:00
Nicolas Goaziou 8fc4fcb8a7 org-manual: Fix markup
* doc/org-manual.org (Special Agenda Views): Use = markup for sexps.
2018-12-14 14:18:01 +01:00
Kaushal Modi bd2a666a17 Merge branch 'master' into next 2018-12-13 14:11:08 -05:00
Kaushal Modi a60a0edc6f Add :no-save keyword for Org capture templates
* lisp/org-capture.el (org-capture-finalize): Do not save the target
  capture file if :no-save keyword is non-nil in the capture template.
* doc/org-manual.org (Template elements),
  lisp/org-capture.el (org-capture-templates): Document :no-save.

Ref: https://lists.gnu.org/r/emacs-orgmode/2018-09/msg00325.html
2018-12-13 14:09:39 -05:00
Nicolas Goaziou 63e58ac22d Merge branch 'master' into next 2018-12-09 23:37:19 +01:00
Nicolas Goaziou adec504d5b org-manual: Improve %(sexp) capture template placeholder documentation
* doc/org-manual.org (Template expansion): Improve documentation for
%(sexp) documentation.
2018-12-09 23:36:04 +01:00
Allen Li 601f373e3f Document %i prefix in capture templates
* doc/org-manual.org (Template expansion): Fix documentation.
* lisp/org-capture.el (org-capture-templates): Fix docstring.
2018-12-09 23:34:20 +01:00
Nicolas Goaziou 2f00151020 org-manual: Small markup fixes
* doc/org-manual.org (Template elements):
(Template expansion):
(Attachments): Replace ~ with =.
2018-12-09 12:34:05 +01:00
Jens Lechtenboerger 94d2dbf95f ox-html: New property HTML_HEADLINE_CLASS for class of headline
* lisp/ox-html.el (org-html-headline): Add new property
HTML_HEADLINE_CLASS to assign class attribute to headline.

* doc/org-manual.org (CSS support): Document new property
HTML_HEADLINE_CLASS.
2018-12-08 12:45:22 +01:00
Nicolas Goaziou 63e8efda8d Merge branch 'master' into next 2018-12-06 23:20:18 +01:00
Nicolas Goaziou 4c23d83eed manual: Tiny rewording
* doc/org-manual.org (LaTeX math snippets): Tiny rewording.
2018-12-06 23:18:36 +01:00
Nicolas Goaziou fc464d7a72 manual: Fix footnote location
* doc/org-manual.org (Customizing tables in ODT export): Fix footnote location.
2018-12-06 23:11:14 +01:00
Emmanuel Charpentier e30aed8f0c manual: document the need for babel when setting LANGUAGE keyword
* doc/org-manual.org (Export Settings): Add a note to Export
Variables.
(LaTeX specific export settings): Describe the use of
org-latex-packages-alist for loading babel (or polyglossia) with the
right argument in LaTeX specific export settings.
2018-12-06 23:09:28 +01:00
Nicolas Goaziou 78901a6602 Merge branch 'master' into next 2018-11-19 23:25:17 +01:00
Nicolas Goaziou 4aa6a37d24 org-manual: Document "format" parameter for colview blocks
* doc/org-manual.org (Capturing column view): Document "format"
  parameter for colview blocks.
2018-11-19 23:23:52 +01:00
Nicolas Goaziou ae03104402 org-attach: Attach buffers to tasks
* lisp/org-attach.el (org-attach-buffer): New function.
(org-attach): Call new function.
* doc/org-manual.org (Attachments): Document new function.
2018-11-02 02:04:38 +01:00
Nicolas Goaziou 363df82b19 Change default value for `org-email-link-description-format'
* lisp/org.el (org-email-link-description-format): Change default
  value.  No longer truncate subject by default.  Add `:safe' keyword.
* doc/org-manual.org (Handling Links): Document change.

Reported-by: "Garreau, Alexandre" <galex-713@galex-713.eu>
<http://lists.gnu.org/r/emacs-orgmode/2018-10/msg00344.html>
2018-11-01 23:00:45 +01:00
Nicolas Goaziou 802272bfbc Merge branch 'master' into next 2018-10-27 13:30:40 +02:00
Nicolas Goaziou 643481fade org-manual: Insist on case-sensitive tags
* doc/org-manual.org (TODO keywords, tags, properties, etc.): Mention
  tags are case-sensitive.
(Setting Tags): Obey to typesetting convention.
2018-10-27 13:29:51 +02:00
Nicolas Goaziou f3711ff144 Merge branch 'master' into next 2018-10-27 11:21:16 +02:00
Nicolas Goaziou c6f012ee24 org-manual: Reference `org-email-link-description-format'
* doc/org-manual.org (Handling Links): Reference
  `org-email-link-description-format'.  Mention the subject may be
  truncated by default.
2018-10-27 11:20:37 +02:00
Nicolas Goaziou 9b9fa671b5 Merge branch 'master' into next 2018-10-25 16:55:17 +02:00
Nicolas Goaziou 4832a432f0 ox-ascii: Add missing ASCII and UTF-8 conversion functions
* lisp/ox-ascii.el (org-ascii-convert-region-to-ascii):
(org-ascii-convert-region-to-utf8): New functions.
* doc/org-manual.org (Export in Foreign Buffers): Document new
  functions.

Reported-by: Alexander Adolf <alexander.adolf@condition-alpha.com>
<http://lists.gnu.org/r/emacs-orgmode/2018-10/msg00294.html>
2018-10-25 16:53:30 +02:00
Nicolas Goaziou 7776482e36 Merge branch 'master' into next 2018-10-25 16:47:25 +02:00
Nicolas Goaziou 12232c5cd0 org-manual: Small rewording
* doc/org-manual.org (Link Format): Small rewording.
2018-10-24 14:25:40 +02:00
Nicolas Goaziou 2412044aa7 org-manual: Fix typo
* doc/org-manual.org (Exporting): Fix typo.
2018-10-24 09:02:32 +02:00
Nicolas Goaziou bddd287cce org-manual: Reference "davs" Tramp's protocol
* doc/org-manual.org (Setting up the staging area): Reference "davs"
  Tramp's protocol as an example to access a WebDAV server.
2018-10-22 14:12:48 +02:00
Nicolas Goaziou bb29ee41b3 org-manual: Reference "davs" Tramp's protocol
* doc/org-manual.org (Setting up the staging area): Reference "davs"
  Tramp's protocol as an example to access a WebDAV server.
2018-10-22 14:06:04 +02:00
Kyle Meyer 1c5339e974 Merge branch 'master' into next 2018-10-13 12:17:17 -04:00
Kyle Meyer d59ca13c20 org-manual: Correct suggested value for org-agenda-inhibit-startup
* doc/org-manual.org (Speeding Up Your Agendas): Adjust
org-agenda-inhibit-startup snippet to match the text.

This correpsonds to maint's 01c419426.
2018-10-13 12:16:08 -04:00
Nicolas Goaziou 100edaccd1 Implement `month' and `year' steps in clock tables
* doc/org-manual.org (The clock table): Update manual.
* lisp/org-clock.el (org-clocktable-steps): Rewrite function.  Add
  `month' and `year' steps.
* testing/lisp/test-org-clock.el (test-org-clock/clocktable/step): Add
  tests.
2018-10-13 16:22:43 +02:00
Nicolas Goaziou 6a12f65453 Merge branch 'master' into next 2018-10-09 18:27:39 +02:00
Nicolas Goaziou a85ba9fb9b org-manual: Remove unnecessary @noindent
* doc/org-manual.org (Feedback):
(Headlines):
(Initial visibility):
(Sparse Trees):
(Creating Footnotes):
(Column Width and Alignment):
(Named references):
(Formula syntax for Calc):
(Using multiple =TBLFM= lines):
(Link Format):
(External Links):
(Link Abbreviations):
(Basic TODO Functionality):
(Setting up keywords for individual files):
(Tracking TODO state changes):
(Priorities):
(Checkboxes):
(Tag Inheritance):
(Setting Tags):
(Property Syntax):
(Column attributes):
(Capturing column view):
(Custom time format):
(The clock table):
(Template elements):
(Template expansion):
(Attachments):
(Moving a tree to an archive file):
(Agenda Views):
(Agenda Files):
(Categories):
(Exporting Agenda Views):
(Exporting):
(Images in HTML export):
(JavaScript supported display of web pages):
(Images in LaTeX export):
(A Cleaner Outline View):
(Setting up the staging area):
(Radio tables):
(A LaTeX example of radio tables):
(Extracting Agenda Information):
(From Carsten): Remove unnecessary @noindent.
2018-10-07 23:16:59 +02:00
Nicolas Goaziou 01061ccb06 org-manual: Use "Important" quotations
* doc/org-manual.org (Advanced features):
(Inserting deadlines or schedules): Use "Important" quotations.
2018-10-07 23:16:24 +02:00
Nicolas Goaziou c088176c8b org-manual: Tiny change
* doc/org-manual.org (Using Emacs packaging system): Use a tagged
  quotation for the important remark.
2018-10-07 22:35:10 +02:00
Nicolas Goaziou cbe1d76dc2 ox-texinfo: Fix quotations
* lisp/ox-texinfo.el (org-texinfo-quote-block): Do not use NAME
  keyword as the emphasized tag.  Use a dedicated :tag attribute
  instead.  Also add :author attribute.
* doc/org-manual.org (Quotations in Texinfo export): New section.
2018-10-07 22:32:03 +02:00
Nicolas Goaziou 25b3fd06be org-manual: Fix typo
* doc/org-manual.org (Repeated tasks):
(Effort Estimates): Fix typos.
2018-10-07 18:36:28 +02:00
Nicolas Goaziou 58a13f58f5 org-manual: Remove reference to Orgstruct minor mode
* doc/org-manual.org (Export in Foreign Buffers): Remove reference to
  Orgstruct minor mode.
2018-10-07 18:35:32 +02:00
Nicolas Goaziou ee6bb635dc Merge branch 'master' into next 2018-10-06 12:09:22 +02:00
Nicolas Goaziou fdb36d07e4 org-manual: Fix typos
* doc/org-manual.org (Tag Hierarchy):
(~capture~ protocol): Add missing comma.
2018-10-06 12:08:33 +02:00
Nicolas Goaziou 8e33a9fdf8 Merge branch 'master' into next 2018-10-06 12:01:52 +02:00
Nicolas Goaziou 050e2bf509 org-manual: Fix typo
* doc/org-manual.org (Footnotes): Fix typo.
2018-10-06 12:01:30 +02:00
Nicolas Goaziou 0954d4c258 Merge branch 'master' into next 2018-10-04 22:52:53 +02:00
Kaushal Modi 5abfdeeb8f org-manual: Add cindex for include keyword options
* doc/org-manual.org (Include Files): Add cindex for :minlevel,
  :lines, :only-contents.
2018-10-04 10:55:10 -04:00
Benjamin Motz 3cb4ffe957 org-colview: Add property :exclude-tags to column view table
* lisp/org-colview.el (org-columns--capture-view): Add parameter.
(org-dblock-write:columnview): Add new property.
* doc/org-manual.org (Capturing column view): Document feature.
* testing/lisp/test-org-colview.el (test-org-colview/dblock): Add
  test.

This addition allows to specify a list of tags to exclude from column
view tables.

TINYCHANGE
2018-10-03 18:44:34 +02:00
Tobias Schlemmer 3b0c5f911a org-manual: Add support for the iCalendar CLASS property
* doc/org-manual.org (iCalendar export): Document the CLASS tag

    TINYCHANGE
2018-10-03 18:44:34 +02:00
Nicolas Goaziou fc5ee0f87b org-colview: Plain numbers are minutes instead of hours
* lisp/org-colview.el (org-columns--summary-apply-times): Use the same
  rule as everywhere else in Org.
* doc/org-manual.org (Column attributes): Document change.

Reported-by: Bernt Hansen <bernt@norang.ca>
<http://lists.gnu.org/r/emacs-orgmode/2018-05/msg00294.html>
2018-10-03 18:44:34 +02:00
Chris Kauffman 3109e2e02e orgguide.texi: Document single cell movement functions
* doc/orgguide.texi (Tables): Add keybindings for since cell movement.
2018-10-03 18:44:34 +02:00
Chris Kauffman d0a5308435 org-table: Adding single cell movement functions
* lisp/org-table.el (org-table--swap-cells):
(org-table--move-cell):
(org-table-move-cell-up):
(org-table-move-cell-down):
(org-table-move-cell-left):
(org-table-move-cell-right): New functions.

* testing/lisp/test-org-table.el (test-org-table/move-cell-down):
(test-org-table/move-cell-up):
(test-org-table/move-cell-right):
(test-org-table/move-cell-left): New tests.

* doc/org-manual.org (Column and row editing): Document functions and
  keybindings for single cell movement.
2018-10-03 18:44:34 +02:00
stardiviner 1b81d6e07b ob-eshell.el: Add Eshell support for Babel
* lisp/ob-eshell.el (org-babel-execute:eshell): Execute Eshell code in Babel.
(org-babel-prep-session:eshell):
(ob-eshell-session-live-p):
(org-babel-eshell-initiate-session):
(org-babel-variable-assignments:eshell):
(org-babel-load-session:eshell):

* testing/test-ob-eshell.el: Write test for ob-eshell.

* doc/org-manual.org (Languages): Add Babel language eshell identity.
2018-10-03 18:44:34 +02:00
Marco Wahl 4ec502fc98 Merge branch 'master' into contextual-docu 2018-10-02 16:34:58 +02:00
Marco Wahl b19e7737dd org,org-agenda: New: open info depending on context
* lisp/org.el (org-info-find-node): Function to jump to info depending
  on context.  For an org file the context is the element type at point.
2018-10-01 22:47:33 +02:00
Nicolas Goaziou 0b98efdcd9 org-manual: Fix suggested bindings
* doc/org-manual.org (Activation): Fix and clarify bindings, using
  `kbd' macro.
2018-10-01 18:16:46 +02:00
Nicolas Goaziou 8ef876053c org-manual: Fix typo
* doc/org-manual.org (Pulling from the mobile application): Fix typo.
2018-09-29 16:43:55 +02:00
Nicolas Goaziou 3f826b9f74 org-manual: Remove a reference to "MobileOrg"
* doc/org-manual.org (Footnotes): Remove a reference to "MobileOrg".
2018-09-29 16:40:42 +02:00
Nicolas Goaziou 46b49ab57d org-manual: Move "Org Mobile" into "Miscellaneous"
* doc/org-manual.org (Org Mobile): Moved into "Miscellaneous", much
  like Org Crypt library. No longer an appendix.
2018-09-29 16:38:50 +02:00
Nicolas Goaziou b929e5d774 org-manual: Rewrite Org Mobile section
* doc/org-manual.org (Org Mobile): Rewritten from "MobileOrg" section.
  Remove all references to non-free software.
2018-09-29 16:38:42 +02:00
Nicolas Goaziou a841aec7ed org-manual: Use "ID" instead of "id"
* doc/org-manual.org (CSS support): Use "ID" instead of "id".
2018-09-29 14:30:04 +02:00
Nicolas Goaziou 89f8cdedad org-manual: Add missing "Include Files" documentation
* doc/org-manual.org (Include Files): Add missing documentation.
2018-09-29 14:23:57 +02:00
Nicolas Goaziou 241eb8ea7a org-manual: Add URL for "listings" LaTeX package
* doc/org-manual.org (Footnotes): Add URL for "listings" LaTeX
  package.
2018-09-29 09:02:24 +02:00
Marco Wahl bef0b09296 org-manual.org: Correct documentation about bbdb and anniversaries
See also similar commit in maint.

Reported by

From: leandro@disroot.org
Subject: Anniversaries from BBDB
Newsgroups: gmane.emacs.orgmode
To: emacs-orgmode@gnu.org
Date: Thu, 20 Sep 2018 22:08:12
2018-09-23 16:40:47 +02:00
Nicolas Goaziou b197f851f7 org-manual: Shorten address for "comment" package
* doc/org-manual.org (Footnotes): Shorten address.
2018-09-22 23:40:25 +02:00
Nicolas Goaziou a86b2b4155 org-manual: Use CTAN URL for minted package.
* doc/org-manual.org (Footnotes): Use CTAN URL for minted package.
2018-09-22 23:39:21 +02:00
Nicolas Goaziou 69c2d102f8 org-manual: Remove reference to non-existing property
* doc/org-manual.org (Publishing action): Remove `:plain-source'
  reference.
2018-09-21 14:24:03 +02:00
Nicolas Goaziou 4c8b227144 org-manual: Fix :anchor values
* doc/org-manual.org (Anchoring of images): Remove wrong quotes around
  values.
2018-09-19 19:36:51 +02:00
Nicolas Goaziou 9d9a548cb4 org-manual: Tiny improvement
* doc/org-manual.org (Footnotes): Avoid displaying nested parenthesis.
2018-09-19 14:59:25 +02:00
Dominik Schrempf f644da6361 org-manual: Mention peculiarities of Math in HTML code
* doc/org-manual.org (Math formatting in HTML export): Add footnote
  about special symbols and MathJax conversion.

TINYCHANGE
2018-09-19 14:35:45 +02:00
pierwill f1269e4c14 Edit installation section
* doc/org-manual.org (Installation): Emphasize Org's near-universal
  distribution, reformat vertical list, minor grammar fix.
2018-09-02 14:33:50 +02:00
pierwill 38a89014ab org-manual: make revisions in export section
* make various revision for style and clarity.
2018-08-27 10:57:43 +02:00
pierwill 2c521d2f8c org-manual: revise markup section intro
* also fix typo (s/conjuction/conjunction)
2018-08-27 10:52:55 +02:00
Nicolas Goaziou 8f22ed2018 Revert "org-manual: Move "MobileOrg" into "Miscellaneous""
Revert commit b94e6e2b45.  MobileOrg is
described in an appendix, the motivation for the reverted commit no
longer holds.
2018-07-09 10:18:53 +02:00
Nicolas Goaziou 1d8616023d org-manual: Fix typo
* doc/org-manual.org (Capturing column view): Fix typo.
2018-07-07 09:12:02 +02:00
Nicolas Goaziou beb4709301 org-manual: Fix typo
* doc/org-manual.org (Capturing column view): Fix typo.
2018-07-07 09:11:07 +02:00
Nicolas Goaziou b13d8bf5f7 org-manual: Document zero width space
* doc/org-manual.org (Escape Character): New node.
2018-07-05 00:13:05 +02:00
Nicolas Goaziou 14420911f7 org-manual: Add a footnote about point movement on invisible text
* doc/org-manual.org (Link Format): Add a footnote about invisible
  text.

Reported-by: Alain.Cochard@unistra.fr
<http://lists.gnu.org/r/emacs-orgmode/2018-07/msg00015.html>
2018-07-04 23:46:58 +02:00
Nicolas Goaziou beaf58a815 org-manual: Do not document entities as a way to escape markup
* doc/org-manual.org (Special Symbols): Do not document entities as
  a way to escape markup.  In this example, a zero width space is more
  appropriate.
2018-07-04 23:37:48 +02:00
Nicolas Goaziou 9cc47f8853 org-manual: Tiny change
* doc/org-manual.org (Hacking): Tiny change.
2018-07-04 23:35:04 +02:00
Nicolas Goaziou b94e6e2b45 org-manual: Move "MobileOrg" into "Miscellaneous"
* doc/org-manual.org (MobileOrg): Moved into "Miscellaneous".

MobileOrg doesn't belong to Org proper.  It should be documented in
the manual, but not at the top level.
2018-07-04 23:35:04 +02:00
Nicolas Goaziou fb714739cb org-manual: Rename "Markup for Rich Export"
* doc/org-manual.org (Markup for Rich Contents): Renamed from "Markup
  for Rich Export".  Rewrite the introduction and the description.
(Exporting): Fix cross-reference.

At this point, the export framework hasn't been described so it could
be confusing to use it in the section name.
2018-07-04 23:35:04 +02:00
Nicolas Goaziou 53ec5f0a05 org-manual: Improve and relocate linter documentation
* doc/org-manual.org (Org Syntax): Move to "Miscellaneous".  Expound
  documentation about how to use the linter.

The syntax happens too early in the manual, before most elements are
even described.
2018-07-04 23:35:04 +02:00
Nicolas Goaziou b3e00f0c53 org-manual: Rename "Advanced Configuration"
* doc/org-manual.org (Advanced Export Configuration): Renamed from
  "Advanced Configuration".
(Example blocks in LaTeX export): Fix link.

When browsing the menu, "Advanced Configuration" is too vague, and
doesn't correlate immediately to Export.
2018-07-04 23:35:04 +02:00
Nicolas Goaziou dc41eb2bdc org-manual: Fix some typos and add a missing index entry
* doc/org-manual.org (Paragraphs): Fix markup typo.  Add missing "line
  breaks" index entry.
(Captions): Use plural form for index entry, as other occurrences in
the document.
(Literal Examples): Use "markup rules" instead of "markup", as other
occurrences in the document.
2018-07-04 23:35:04 +02:00
Nicolas Goaziou 1690c6597c org-manual: Remove wrong index entries
* doc/org-manual.org (Special Symbols): Remove index entries belonging
  to "Embedded LaTeX" section.
2018-07-04 23:35:03 +02:00
Nicolas Goaziou bedc1e6579 org-manual: Split "Images and Tables" section
* doc/org-manual.org (Built-in Table Editor): Add more information
  about table syntax.
(Handling Links): Move `org-toggle-inline-images' function to the new
"Images" section.
(Images and Tables): Remove section.
(Images):
(Captions): New sections.
(Tables in LaTeX export):
(Images in LaTeX export):
(Footnotes): Fix cross-references.

Also re-order "Markup for Rich Export" children.  The idea is to start
out with the paragraph definition, then describe the syntax for
objects that can be included in a paragraph.  Then, proceed with
elements that act as paragraph separators, and finish with less used
syntax.
2018-07-04 23:34:47 +02:00
Nicolas Goaziou 5057e39891 org-manual: Fix typo
* doc/org-manual.org (Modifying column view on-the-fly): Remove
  spurious colons.
2018-06-29 00:42:10 +02:00
Nicolas Goaziou d6a8188941 org-manual: Fix typo
* doc/org-manual.org (Property Syntax): Fix typo in Glenn Gloud's
  name.
2018-06-28 23:47:12 +02:00
Nicolas Goaziou 9e21814c65 org-manual: Remove last "C-c a" references
* doc/org-manual.org (Basic TODO Functionality):
(TODO keywords as types):
(Tag Searches):
(Property Searches): Remove "C-c a" bindings since we cannot, and
shouldn't, assume users bound this key combination to `org-agenda'.
2018-06-28 23:34:11 +02:00
Nicolas Goaziou 0480b9d8b6 org-manual: Fix aesthetics of a table
* doc/org-manual.org (External Links): Narrow the first column in
  a table.  Normalize capitalization in the table.
2018-06-28 22:59:18 +02:00
Nicolas Goaziou e801f6446d org-manual: Do not rely on `org-version'
* doc/org-manual.org (Export Setup): "version" macro does not rely on
  `org-version' anymore. It checks "Version" keyword in "org.el".
2018-06-28 22:54:59 +02:00
Nicolas Goaziou accf99cbc0 Deprecate `org-effort-durations'
* lisp/org.el (org-effort-duration): Remove unused variable.
* lisp/org-compat.el (org-effort-durations): Make
  `org-effort-duration' an alias for `org-duration-units'.
* lisp/org-clock.el (org-clock-modify-effort-estimate): Fix docstring.
* doc/org-manual.org (Footnotes): Clarify footnote.

The variable is inactive since introduction of "org-duration" library.
2018-06-25 17:13:04 +02:00
Siraphob Phipathananunth 2fcf55f273 org-manual: Fix "cursor" to "point", fix grammar and add cross-references
* doc/org-manual : More wording and grammar is fixed, cross-references
to other sections are added when key terms appear (e.g. agenda,
property, completion).
2018-06-25 16:51:21 +02:00
Nicolas Goaziou 58f2950167 org-manual: Add missing markup for properties
* doc/org-manual.org (The clock table): Add missing markup for
  properties.
2018-06-25 16:41:04 +02:00
Nicolas Goaziou 04cbfe3f31 org-manual: Add missing {{{var(...)}}} markup
* doc/org-manual.org (The clock table): Add missing {{{var(...)}}}
  markup.
2018-06-25 16:34:58 +02:00
Nicolas Goaziou 5c376ae4a7 org-manual: Fix case of a tag
* doc/org-manual.org (Setting options for custom commands): Use lower
  case for user defined example tags.
2018-06-24 22:42:09 +02:00
Nicolas Goaziou 5f78791b80 org-manual: Add missing markup
* doc/org-manual.org (The clock table): Add missing "=" markup for
  parts of an Org buffer.  Add "@noindent" directives.
2018-06-24 20:48:52 +02:00
Nicolas Goaziou e4ecd04dda org-manual: Fix formula markup
* doc/org-manual.org (Formula syntax for Calc): Add zero width spaces
  to avoid unwanted markup.
2018-06-24 20:40:41 +02:00
Nicolas Goaziou 5dd9d7adb3 org-manual: Remove references to "timeline"
* doc/org-manual.org (Basic TODO Functionality):
(Priorities):
(Timestamps, Deadlines and Scheduling):
(Agenda Views):
(Change display):
(Footnotes): Remove references to the now removed "timeline" feature.
2018-06-24 20:11:18 +02:00
Nicolas Goaziou 07b35fa906 org-manual: Fix internal links
* doc/org-manual.org (Code Evaluation and Security Issues):
(Structure of Code Blocks):
(Packages that Org cooperates with): Fix case.
2018-06-24 20:00:23 +02:00
Nicolas Goaziou 644d0259ce org-manual: Fix some info links
* doc/org-manual.org (Packages that Org cooperates with):
(Footnotes): Use "::" as node separator instead of ":".
2018-06-24 19:56:37 +02:00
Nicolas Goaziou 1bdee35231 org-manual: Add a missing cross reference
* doc/org-manual.org (Handling Links): Downcase tags.  Add a link to
  explicit what a "tags view" is.
2018-06-23 09:15:43 +02:00
Nicolas Goaziou 9b06cc975b org-manual: Add missing markup
* doc/org-manual.org (Using the Mapping API): Add `code' markup around
  ~save-excursion~, since this is an Elisp special form.
2018-06-23 09:15:43 +02:00
Ben Phipathananunth cccaca986e org-manual: Fix various grammatical errors and fix terminology
* doc/org-manual: All occurrences of "the cursor" are replaced with
  "point".  Begin changing "function" to "Lisp function" as used in
  the Emacs manual.
2018-06-23 09:15:43 +02:00
Nicolas Goaziou b563ef4762 Revert "org-manual: Fix link"
This reverts commit e61fddf4ce.
2018-06-19 10:44:49 +02:00
Nicolas Goaziou e61fddf4ce org-manual: Fix link
* doc/org-manual.org (Activation): Fix link.
2018-06-19 10:22:58 +02:00
Nicolas Goaziou 467b3f9728 org-manual: Shorten author field
* doc/org-manual.org (Export Setup): Shorten author field, which was
  larger than the width of the page, and not fair to all the people
  involved in the manual.
2018-06-17 10:22:47 +02:00
Nicolas Goaziou b2ffbf4b2f org-manual: Fix typos
* doc/org-manual.org (Subscripts and Superscripts):
(Initial visibility):
(Durations and time values):
(TODO dependencies):
(Tracking your habits):
(Deadlines and Scheduling):
(Literal Examples):
(The Export Dispatcher):
(Export Settings):
(Include Files): Fix typos.
2018-06-17 10:10:59 +02:00
Nicolas Goaziou ab8f90122a org-manual: Fix typo
* doc/org-manual.org (Internal archiving): Fix typo.
2018-06-17 09:52:00 +02:00
Nicolas Goaziou 05dcbfa2d4 org-manual: Fix typo
* doc/org-manual.org (Inserting deadlines or schedules): Fix typo.
2018-06-17 09:48:29 +02:00
Nicolas Goaziou f47917ce26 org-manual: Small fix
* doc/org-manual.org (Languages): Improve rendering in PDF
  output. Change Objective Caml into OCaml.
2018-06-15 00:24:40 +02:00
Nicolas Goaziou e943404735 org-manual: Remove reference to "verbatim" blocks
* doc/org-manual.org (Working with Source Code): Remove reference to
  "verbatim" blocks.
2018-06-14 23:56:39 +02:00
Nicolas Goaziou dcbb1acd92 org-manual: Fix typo
* doc/org-manual.org (Footnotes): Add missing "see" before
  cross-reference.
2018-06-14 21:24:22 +02:00
Nicolas Goaziou 69675967e9 org-manual: Add missing structure template key
* doc/org-manual.org (Structure Templates): Add "E" key.
2018-06-14 16:37:39 +02:00
Nicolas Goaziou c0e89ad4d5 org-manual: Fix typo
* doc/org-manual.org (Footnotes): Add missing "see" before
  cross-reference.
2018-06-13 21:41:50 +02:00
Nicolas Goaziou a0dacdc495 org-manual: Fix typo
* doc/org-manual.org (ASCII specific attributes): Use =...= markup for
  contents meant to be written in an Org document.
2018-06-12 08:53:05 +02:00
Kyle Meyer cecbe4ec8f org-manual: Fix typos
* doc/org-manual.org (Tag Hierarchy, ASCII specific attributes): Fix
typos.

These correspond to the org.texi typos in 89859f2bd.
2018-06-06 17:59:23 -04:00
Nicolas Goaziou b0e28fa4c6 org-manual: Document how to activate C++ and D languages
* doc/org-manual.org (Languages): Document how to activate C++ and
  D languages.
2018-05-30 12:46:55 +02:00
Nicolas Goaziou 97fb642a64 org-manual: Fix titlecase in second level section
* doc/org-manual.org (The Spreadsheet): Use titlecase.
2018-05-27 22:06:36 +02:00
Nicolas Goaziou 6bfa32eb58 org-manual: Fix footnote location
* doc/org-manual.org (Summary of In-Buffer Settings): Fix footnote
  location.
2018-05-27 22:05:25 +02:00
Nicolas Goaziou e43c7a3575 org-manual: Auto-adjust footnotes upon insertion
* doc/org-manual.org: Re-order footnotes.
* .dir-locals.el (org-mode): Auto-adjust footnotes.
2018-05-27 22:03:42 +02:00
Nicolas Goaziou 1f0561b63c org-manual: Use .dir-locals instead of file local variables
* .dir-locals.el (org-mode): Update settings.
* doc/org-manual.org (Local variables): Remove.
2018-05-27 21:41:18 +02:00
Nicolas Goaziou 4fde09061e org-manual: Fix last modification
* doc/org-manual.org (Results of Evaluation): Fix footnote reference.
Use regular quotes so smart quotes can kick in, rewrite "header arg"
to "header argument". Use present tense instead of future.
2018-05-27 21:37:20 +02:00
Aaron Ecay 1643f70d30 org-manual.org: Add a footnote about :file-ext
As suggested by Alex Fenton in
<https://lists.gnu.org/archive/cgi-bin/namazu.cgi?query=%2Bmessage-id%3A%3C6427e745-9ca4-2356-a262-ef257082a9ce%40pressure.to%3E&submit=Search&idxname=emacs-orgmode>.
2018-05-27 17:35:00 +01:00
Aaron Ecay 87c70f8101 org-manual.org: add file-local variables controlling footnotes
So that this fileʼs style remains consistent even if editors have
customized orgʼs footnote variables for their own use.
2018-05-27 17:34:10 +01:00
Nicolas Goaziou 2621db3ac2 Merge branch 'maint' 2018-05-22 11:29:36 +02:00
Nicolas Goaziou 8fbdf0ce1a orgguide.texi: Fix code and verbatim markup
* doc/orgguide.texi (Emphasis and monospace): Fix code and verbatim
  markup.

Reported-by: aldo ridhoni <aldoridhoni@gmail.com>
<http://lists.gnu.org/r/emacs-orgmode/2018-05/msg00429.html>
2018-05-22 11:22:11 +02:00
Nicolas Goaziou 8def68b723 org-manual: Document `org-complete-tags-always-offer-all-agenda-tags'
* doc/org-manual.org (Setting Tags): Document
  `org-complete-tags-always-offer-all-agenda-tags'.
2018-05-19 13:51:29 +02:00
Nicolas Goaziou 2ec5d36ecc org-manual: Use "source code block" instead of "src code block"
* doc/org-manual.org (Code Evaluation and Security Issues): Replace
  "src" with "source".
2018-05-13 22:47:44 +02:00
Marco Wahl eb49917bc4 org-manual: Fix a macro call 2018-05-11 22:01:18 +02:00
Marco Wahl 47dfa0e545 org-manual: Remove one trailing whitespace 2018-05-11 21:57:41 +02:00
Nicolas Goaziou 4fe6891cdf org-manual: Add non-breaking spaces
* doc/org-manual.org (Weekly/daily agenda):
* doc/org-manual.org (History and Acknowledgments): Add non-breaking
  spaces in names.
2018-05-11 19:53:33 +02:00
Gregor Zattler 4c41e1d03a Tiny doc fixes
* doc/org-manual.org (Dates and Times) (Timestamps, Deadlines and
  Scheduling): Document "diary-float" instead of obsolete "org-float".
* doc/Documentation_Standards.org (org-manual.org specific
  conventions): Fix file name and directory of Org manual.

Copyright-paperwork-exempt: yes
TINYCHANGE
2018-05-09 21:11:18 +02:00
Nicolas Goaziou 97a8eb00ef Makefile: Add "org-manual.org" as a pre-requisite
* doc/Makefile (org.texi): Makefile: Add "org-manual.org" as
  a pre-requisite.
2018-05-09 08:19:21 +02:00
Nicolas Goaziou 1289cfe218 Remove "org.texi" from source tree
* .gitignore: Ignore doc/org.texi
* doc/org.texi: Remove file.
2018-05-09 02:25:02 +02:00
Nicolas Goaziou c87d70439b "make doc" generate "org.texi"
* doc/Makefile (org.texi): New rule.
* mk/org-fixup.el (org-make-manuals): New function.
2018-05-09 02:23:10 +02:00
Nicolas Goaziou d4a8e3de84 org-manual: Document "sep" header argument
* doc/org-manual.org (Results of Evaluation): Document "sep" header
  argument.
2018-05-09 01:45:04 +02:00
Nicolas Goaziou c703ee1a23 org-manual: Tiny rewording
* doc/org-manual.org (Summary): Tiny rewording.
2018-05-02 15:03:00 +02:00
Nicolas Goaziou 66b8d813a0 org-manual: Fix typo
* doc/org-manual.org (Summary): Fix typo.
2018-05-02 14:56:21 +02:00
Nicolas Goaziou 0b8aa5b3cb org-manual: Document "tangle-mode" header argument
* doc/org-manual.org (Extracting Source Code): Document "tangle-mode"
  header argument.
2018-05-02 12:48:38 +02:00
Nicolas Goaziou c64cdff088 org-manual: Document :wrap header argument
* doc/org-manual.org (Results of Evaluation): Document :wrap header
  argument.
2018-05-02 12:44:01 +02:00
Nicolas Goaziou fa51fc2922 org-manual: Fix typo
* doc/org-manual.org (Exporting Code Blocks): Fix typo.
2018-05-02 12:18:59 +02:00
Nicolas Goaziou 94f902834a org-manual: Slight rewording
* doc/org-manual.org (Macro Replacement): Slight rewording.
2018-04-30 09:26:50 +02:00
Nicolas Goaziou 61cfd675f3 org-manual: Document "results" macro
* doc/org-manual.org (Macro Replacement): Document "results" macro.
2018-04-29 12:32:26 +02:00
Nicolas Goaziou 181b13cc57 org-manual: Use starred internal links for consistency
* doc/org-manual.org (Structure Editing):
(Plain Lists): Use starred internal links.
2018-04-28 17:00:47 +02:00
Bastien 2b6004f57e org-agenda.el: Update the logic of regexp filters
* lisp/org-agenda.el (org-agenda-filter-by-regexp): Remove
existing regexp filter.  Only cumulate filters when called
with two prefix arguments.

It seems more common and reasonable to hit "=" to filter
then hit "=" again to remove the filter.  Cumulative filters
are still accessible through hitting `C-u C-u ='.
2018-04-28 14:12:37 +02:00
Bastien 011f1c6181 Let `org-agenda-set-restriction-lock' remove restriction at point
* lisp/org-compat.el (org-speedbar-set-agenda-restriction):
* lisp/org-agenda.el (org-agenda-set-restriction-lock):
If there is an agenda restriction at point, remove it.

* doc/org-manual.org:
* etc/ORG-NEWS: Document the new feature.
2018-04-28 12:09:56 +02:00
Nicolas Goaziou 2a8d944c85 org-manual: Fix typo
* doc/org-manual.org (Org Crypt): Use correct environment for Org
  example.
2018-04-27 16:13:41 +02:00
Gregor Zattler 5d8b85e280 org-manual: Document CRYPTKEY property
doc/org-manual.org: Document CRYPTKEY property.

TINYCHANGE
2018-04-27 15:11:29 +02:00
Bastien f80f7ed98b org-clock.el: New option :tags to insert tags in clock reports
* lisp/org-clock.el (org-clocktable-defaults)
(org-clocktable-write-default, org-clock-get-table-data):
Rename :tags to :match and use :tags to insert a column with
the headline's tags.

Thanks to Raymond Zeitler for suggesting this.
2018-04-26 20:55:27 +02:00
Bastien 1ac57ccda0 org-manual.org: Small enhancement for org-timestamp-up/down 2018-04-26 14:42:09 +02:00
Bastien 4faa2e1a45 org-manual.org: Small rephrasing 2018-04-26 13:37:58 +02:00
Bastien e3794f6dce Continue previous commit 2018-04-26 11:42:04 +02:00
Bastien 889a075834 org-manual.org: Tiny enhancement for `org-toggle-ordered-property'
Thanks to Allen Li for pointing this.
2018-04-26 11:39:44 +02:00
Nicolas Goaziou 92785f7bf6 org-manual: Improve list of Babel languages
* doc/org-manual.org (Languages): Re-order table.  Use verbatim markup
  for identifiers.

* doc/org.texi: Sync file.
2018-04-25 10:19:02 +02:00
Nicolas Goaziou b4e82fb050 org-manual: Sync manual with org.texi 2018-04-24 23:26:27 +02:00
Nicolas Goaziou 0dc4ba22e2 org.texi: Document `org-agenda-search-headline-for-time'
* doc/org.texi (Time-of-day specifications): Document
  `org-agenda-search-headline-for-time'.

Reported-by: Rohit Patnaik <quanticle@quanticle.net>
<http://lists.gnu.org/r/emacs-orgmode/2018-04/msg00405.html>
2018-04-24 23:20:53 +02:00
Eli Zaretskii d13811cbc0 Backport commit 8f6293ca7 from Emacs
* doc/org.texi (Editing source code, Export settings)
(Closing items, Drawers, Structure editing): Fix use of
@key.  For the details, see
http://lists.gnu.org/archive/html/emacs-devel/2018-04/msg00390.html.

Fix use of @key in Texinfo manuals
8f6293ca789edf06ea8e7b4b80edf7558d590ca7
Eli Zaretskii
Thu Apr 19 12:21:06 2018 +0300
2018-04-22 10:58:56 -04:00
Nicolas Goaziou 222cfe7daf org-manual: Sync with maint
* doc/org-manual.org:
* doc/org.texi (Variable Index):
(Markdown Export): Sync with maint.
2018-04-20 11:16:06 +02:00
Nicolas Goaziou 7eeb396c7d Merge branch 'maint' 2018-04-20 11:13:17 +02:00
Nicolas Goaziou 14d3d59c44 Clarify `md' and `html' back-ends relationship
* doc/org.texi (Markdown export): Reword.

Reported-by: "Loris Bennett" <loris.bennett@fu-berlin.de>
<http://lists.gnu.org/r/emacs-orgmode/2018-04/msg00303.html>
2018-04-20 11:11:52 +02:00
Nicolas Goaziou 9a5557d715 org.texi: Re-generate file 2018-04-12 15:36:43 +02:00
Nicolas Goaziou 5b695bfa10 org-manual: Fix `org-insert-structure-template' documentation 2018-04-12 15:35:55 +02:00
Nicolas Goaziou 52cbeec20a org-manual: Re-order Babel result formats alphabetically 2018-04-12 15:29:52 +02:00
stardiviner b088389c6b ob-core: Add document and test for "graphics" format
* doc/org-manual.org: Document value.

* lisp/ob-core.el (org-babel-common-header-args-w-values): Handle
  symbol "graphics".

* testing/lisp/test-ob.el (test-ob/result-graphics-link-type-header-argument):
  New test.
2018-04-12 15:16:04 +02:00
stardiviner 296b0de4e8 ob-core: Add "link" results format
* lisp/ob-core.el (org-babel-execute-src-block): Handle "link" :results
  format.

* doc/org-manual.org: Add document for new result format "link".

* testing/lisp/test-ob.el (test-ob/result-file-link-type-header-argument):
  New test.
2018-04-12 15:15:59 +02:00
Rasmus 39837b4b31 org: Change org-insert-structure-template to C-c C-,
* lisp/org.el (org-mode-map):
* doc/org-manual.org (With): Change keybinding of
  org-insert-structure-template.

See the thread titled "Poll: new keybinding for
org-insert-structure-template?" in December 2017 for details.
2018-04-08 12:47:12 +02:00
Rasmus b56df737b7 org: org-structure-template-alist uses string keys
* lisp/org-tempo.el (org-tempo-keywords-alist):
  (org-tempo-setup):
  (org-tempo-add-templates):
* testing/lisp/test-org-tempo.el (test-org-tempo/add-new-templates):
* lisp/org.el (org-structure-template-alist): Use string keys.
  (org--insert-structure-template-mks):
  (org--insert-structure-template-unique-keys): New functions for block selection.
  (org-insert-structure-template): Use new functions.
* etc/ORG-NEWS:
* doc/org-manual.org: Reflect changes.
2018-04-08 12:47:12 +02:00
Nicolas Goaziou f8924a2393 org-manual: Improve accuracy of a paragraph
* doc/org-manual.org (Column Width and Alignment): Reword paragraph
  about shrunk columns.  Document that a column is expanded only when
  text near its shrunk part is displayed.
2018-04-02 20:30:40 +02:00
Kyle Meyer 8ead9e5ba3 org-manual: Fix clone instructions
The same fix was applied to org.texi in b1a6395df.
2018-04-01 17:39:50 -04:00
Michael Albinus b1a6395dfe Backport commit 9bff405d0 from Emacs
* doc/org.texi (Installation): Fix clone commands.

9bff405d09f6eeeb577e6e0111e49f35d3b95b52
Michael Albinus
Wed Mar 28 10:38:26 2018 +0200
2018-04-01 17:27:10 -04:00
Grégoire Jadi 452f4d8527 org-manual: Fix typo in variable name 2018-03-29 22:18:36 +02:00
Marco Wahl 00386b4924 org-manual: Fix typo in Tracking TODO state changes
Also update org.texi from org-manual.org export.
2018-03-29 12:56:34 +02:00
Nicolas Goaziou 7240f9c847 org.texi: Fix typo in capture protocol example
* doc/org.texi (@code{capture} protocol): Add missing protocol.

Reported-by: Буковская Агнесса <aggie@yandex.ru>
<http://lists.gnu.org/r/emacs-orgmode/2018-03/msg00528.html>
2018-03-28 17:16:57 +02:00
Nicolas Goaziou e01bc94506 org.texi: Overwrite with the one generated from "org-manual.org"
* doc/org.texi: Overwrite with the one generated from
  "org-manual.org".
2018-03-28 17:13:56 +02:00
Nicolas Goaziou bfd6d3c867 org-manual: Fix typo in capture protocol
Reported-by: Буковская Агнесса <aggie@yandex.ru>
<http://lists.gnu.org/r/emacs-orgmode/2018-03/msg00528.html>
2018-03-28 17:13:56 +02:00
Nicolas Goaziou a20ed49289 org-manual: Fix link to Calc manual 2018-03-28 16:27:57 +02:00
Nicolas Goaziou 661644aba7 org-manual: Fix typos in copying 2018-03-28 16:27:57 +02:00
Nicolas Goaziou 97fc9a79ec org-manual: Remove "email" keyword 2018-03-28 16:15:43 +02:00
Nicolas Goaziou 5ee6d18862 org-manual: Fix typo 2018-03-28 16:15:43 +02:00
Nicolas Goaziou 243608f153 org-manual: Normalize S-<cursor> keybindigs 2018-03-28 16:15:43 +02:00
Nicolas Goaziou b946c93865 org-manual: Fix typo 2018-03-28 16:15:43 +02:00
Nicolas Goaziou c154c3db02 org-manual: Fix whitespace issues 2018-03-28 16:15:43 +02:00
Nicolas Goaziou c1777f12a6 org-manual: Fix typo 2018-03-28 16:15:43 +02:00
Nicolas Goaziou fde21b962e org-manual: Fix table size 2018-03-28 16:15:43 +02:00
Nicolas Goaziou 6d4ae97103 Rename "manual.org" into "org-manual.org" 2018-03-28 16:15:40 +02:00
Nicolas Goaziou 7d2ed44f76 Move "manual.org" into "doc/" 2018-03-28 14:21:16 +02:00
Kyle Meyer be8f76cbe9 Merge branch 'maint' 2018-03-26 00:07:03 -04:00
Glenn Morris 8cf787cbad Backport commit 7d6c7d0b4 from Emacs
; Use GNU not Gnu in docs
7d6c7d0b461705fd67f7df1096b6f6376931f140
Glenn Morris
Fri Mar 23 16:01:12 2018 -0400
2018-03-26 00:05:57 -04:00
Bastien a06b72bb9d Merge branch 'maint' 2018-03-20 10:01:52 +01:00
Bastien cb46679eb2 org.texi: Fix typo
* doc/org.texi (Emphasis and monospace): Fix typo.

Thanks to Li Deng for reporting this.
2018-03-20 10:01:17 +01:00
Bastien 51b339105a Merge branch 'maint' 2018-03-10 22:38:59 +01:00
Bastien c0f423d434 orgguide.texi: Fix more links and references 2018-03-10 22:38:39 +01:00
Bastien 69e674f518 Merge branch 'maint' 2018-03-10 22:29:38 +01:00
Bastien 50550c8405 orgguide.texi: Fix broken or obsolete links 2018-03-10 22:29:23 +01:00
Kyle Meyer f74f55cc75 Merge branch 'maint' 2018-03-07 22:07:42 -05:00
Paul Eggert 9ac80ede5e Backport commit f2caf08ca from Emacs
; Spelling fixes
f2caf08ca625f64c7eeea8dfa8f65a5b1bac58e2
Paul Eggert
Sun Mar 4 17:10:34 2018 -0800
2018-03-07 22:07:25 -05:00
Bastien dd99ed7443 doc/Documentation_Standards.org: Major update
Thanks to Thomas Dye for providing a patch to enhance this page.
2018-03-04 21:46:44 +01:00
Bastien 66d2474ccb doc/Documentation_Standards.org: Clean indentation 2018-03-04 21:31:14 +01:00
Bastien 4d50d5c9a4 doc/Documentation_Standards.org: Don't set fill-column
It is already set in .dir-locals.el.
2018-03-04 21:29:47 +01:00
Bastien 902148a967 Merge branch 'maint' 2018-03-04 21:22:32 +01:00
Bastien a1dfd4ff20 org.texi: Fix typo
* doc/org.texi (Activation, Agenda files): Fix typo.

Thanks to Th. Rikl for reporting this.
2018-03-04 08:42:47 +01:00
Nicolas Goaziou 3ffc7d6903 Merge branch 'maint' 2018-03-03 13:42:35 +01:00
Nicolas Goaziou f8d758966c orgguide.texi: Fix typo
* doc/orgguide.texi (TODO Items): Fix typo.

Reported-by: siraben@disroot.org
<http://lists.gnu.org/r/emacs-orgmode/2018-03/msg00036.html>
2018-03-03 13:41:49 +01:00
Kyle Meyer 5cb1184447 Merge branch 'maint' 2018-02-26 22:11:56 -05:00
Michael Albinus e810e6e5f9 Backport commit 9743f48de from Emacs
* doc/org.texi: Mark keys consistently.

Mark keys consistently in manuals
9743f48de7325bd95a42e1a27acbf6635f8d086b
Michael Albinus
Mon Feb 26 13:53:37 2018 +0100
2018-02-26 21:42:25 -05:00
Michael Albinus c0de50216a Backport commit ce557a924 from Emacs
* doc/org.texi: Remove @key{} markups from @kindex entries.

Remove @key{} markups from @kindex entries in manuals
ce557a924a299650b5e0c93ba276f1ec651f7941
Michael Albinus
Mon Feb 26 09:24:39 2018 +0100
2018-02-26 21:40:38 -05:00
Michael Albinus 5c3a00575b Backport commit 7a069f35d from Emacs
* doc/org.texi: Fix @kindex entries.  Mark keys consistently.

Fix @kindex entries in manuals
7a069f35d4ce002dc10d666fde2850d8e6eee427
Michael Albinus
Sun Feb 25 16:29:39 2018 +0100
2018-02-26 21:38:43 -05:00
Michael Albinus bb2195a1c0 Backport commit e415309fe from Emacs
* doc/org.texi: Fix @cindex entries.  Use consistently
@code{} for keywords.

Fix @cindex entries in org.texi
e415309fef4077fe7e4dfe1a898d749c1136ca2c
Michael Albinus
Sat Feb 24 20:40:39 2018 +0100
2018-02-26 21:36:41 -05:00
Kyle Meyer 47908228e7 Merge branch 'maint' 2018-02-18 16:33:04 -05:00
Glenn Morris 5c3be1a298 Backport commit 35e5c57db from Emacs
; Fix doc typos related to indefinite articles
35e5c57db311c3d6c1c3a8dd4edc3d756d1d5d24
Glenn Morris
Fri Feb 16 14:11:51 2018 -0500
2018-02-18 16:32:40 -05:00
Paul Eggert a173d75145 Backport commit 7d90d2ece from Emacs
Proofread os.texi and files.texi
7d90d2ece041630e0c440a2b0216e43f82729844
Paul Eggert
Mon Jan 29 10:38:06 2018 -0800
2018-02-18 16:32:40 -05:00
Nicolas Goaziou 90607d1d18 Merge branch 'maint' 2018-02-13 17:36:36 +01:00
Nicolas Goaziou d5527699ab org.texi: Remove `org-enable-table-editor' remnant
* doc/org.texi (Built-in table editor): Remove reference to suppressed
  variable `org-enable-table-editor'.
2018-02-13 17:35:41 +01:00
Nicolas Goaziou 0155441358 Merge branch 'maint' 2018-01-19 18:22:00 +01:00
Tim Landscheidt e5055616f3 Add trailing slash to https://orgmode.org/worg/org-contrib/babel
TINYCHANGE
2018-01-19 18:15:09 +01:00
Tim Landscheidt b289a65be7 Use https for links to orgmode.org
TINYCHANGE
2018-01-19 18:14:58 +01:00