Commit Graph

2771 Commits

Author SHA1 Message Date
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
Kyle Meyer d94f7024bc Merge branch 'maint' 2018-01-07 00:28:35 -05:00
Kyle Meyer 3e1641ef0a Update copyright years 2018-01-07 00:27:54 -05:00
Nicolas Goaziou 8a2914f458 Merge branch 'maint' 2018-01-06 10:09:39 +01:00
Nicolas Goaziou e00bbc6ec2 org.texi: Add `org-capture-templates' to variables index
* doc/org.texi (Capture templates): Add `org-capture-templates' to
  variables index.
2018-01-06 10:08:49 +01:00
Nicolas Goaziou e8cd52dee0 Merge branch 'maint' 2018-01-04 19:51:46 +01:00
Nicolas Goaziou 6c19b2db51 org.texi: Fix protocol for read-only repository
* doc/org.texi (Installation): Fix protocol for read-only repository.
2018-01-04 19:50:46 +01:00
Nicolas Goaziou 931406855e Merge branch 'maint' 2018-01-04 19:11:57 +01:00
Nicolas Goaziou b762c2dcc8 org.texi: Fix git repository location
* doc/org.texi (Installation): Fix git repository location.
2018-01-04 19:11:14 +01:00
Nicolas Goaziou e2b47eb5e7 Merge branch 'maint' 2018-01-04 16:35:24 +01:00
Nicolas Goaziou 5838838288 org.texi: Use https instead of http for orgmode.org
* doc/org.texi (Summary):
(Installation):
(Footnotes):
(Org syntax):
(Lookup functions):
(Org-Plot):
(Capturing column view):
(@code{open-source} protocol):
(Links in HTML export):
(JavaScript support):
(Images in ODT export):
(Library of Babel):
(Languages):
(Language-specific header arguments):
(Hooks):
(Add-on packages):
(Adding export back-ends):
(Speeding up your agendas):
(Setting up the staging area): Use https instead of http for
orgmode.org.
2018-01-04 16:34:07 +01:00
Nicolas Goaziou 20491f2e7c org.texi: Remove references to Radio lists
* doc/org.texi (Sitemap): Remove reference to Radio lists.
(Radio lists): Remove node.
2017-12-31 12:33:22 +01:00
Nicolas Goaziou eeb4c22090 Remove OrgStruct mode
* lisp/org.el (org-overview): Use `org-outline-regexp-bol' instead of
  `outline-regexp'.
(org-heading-components): Ignore orgstruct-mode.
(orgstruct-heading-prefix-regexp):
(orgstruct-setup-hook):
(org-local-vars):
(orgstruct-mode):
(turn-on-orgstruct):
(orgstruct-is-++):
(org-fb-vars):
(orgstruct++-mode):
(turn-on-orgstruct++):
(orgstruct-error):
(orgstruct-setup):
(orgstruct-make-binding):
(org-run-like-in-org-mode):
(org-indent-line):
(org-fill-paragraph):
(org-show-children): Remove Orgstruct mode

* doc/org.texi (Orgstruct mode): Remove node.
2017-12-30 10:28:50 +01:00
Bastien 29dd9a6605 org.el: New value for `org-todo-repeat-to-state'
* lisp/org.el (org-todo-repeat-to-state): Allow `t' to use
the previous TODO state.

* doc/org.texi (Repeated tasks): Document the new optional
value of `org-todo-repeat-to-state'.
2017-12-29 18:36:27 +01:00
Marco Wahl 993f76a7b4 org.texi: Document how to attach from a dired buffer 2017-12-13 14:16:38 +01:00
Rasmus 94f1a58438 org-tempo.el: New file for expansion of templates
* lisp/org-tempo.el: New file.
* doc/org.texi (Structure templates):
* lisp/org.el (org-modules): Add org-tempo.
* testing/lisp/test-org-tempo.el: New file.
2017-12-08 00:29:08 +01:00
Nicolas Goaziou 62112f5a86 Merge branch 'maint' 2017-12-03 17:37:48 +01:00
Nicolas Goaziou c2c301c9cc org.texi: Fix typo
* doc/org.texi (Global and local cycling): Fix typo.
2017-12-03 17:37:20 +01:00
Nicolas Goaziou 1bb9cf1597 Merge branch 'maint' 2017-11-29 23:02:42 +01:00
Nicolas Goaziou 6fe212a3ec org.texi: Fix incorrect statement about dynamic blocks
* doc/org.texi (Capturing column view):
(The clock table): Correct statement.

Reported-by: Jorge Morais Neto <jorge13515@gmail.com>
<http://lists.gnu.org/r/emacs-orgmode/2017-11/msg00429.html>
2017-11-29 23:01:43 +01:00
Nicolas Goaziou 51234f9555 org-macro: Implement "keyword" macro
* lisp/org-macro.el (org-macro-initialize-templates): Implement
  "keyword" macro.
* doc/org.texi (Macro replacement): Document new macro.

* testing/lisp/test-org-macro.el (test-org-macro/keyword): New test.
2017-11-21 23:38:24 +01:00
Nicolas Goaziou 3226129036 org.texi: Fix typo
* doc/org.texi (Export settings): Fix typo introduced in last commit.
2017-11-20 00:14:22 +01:00
Nicolas Goaziou f482cfa785 Merge branch 'maint' 2017-11-20 00:14:05 +01:00
Nicolas Goaziou 82812ff086 ox: Fix UNNUMBERED strict inheritance
* lisp/ox.el (org-export-numbered-headline-p): Use a less opinionated
  definition of inheritance.

* testing/lisp/test-ox.el (test-org-export/numbered-headline-p):
  Update test.

* doc/org.texi (Export settings): Insist on UNNUMBERED inheritance.

It is now possible to number a headline within an unnumbered tree.
2017-11-20 00:09:59 +01:00
Eric Abrahamsen c04e357f3d Replace easy templates with org-insert-structure-template
* lisp/org.el (org-insert-structure-template): New function for
  wrapping region (or element at point) in a begin/end block.
  (org-structure-predefined-blocks): New option holding predefined
  blocks, for completion.
  (org-try-structure-completion,
  org-complete-expand-structure-template): Remove functions.
* doc/org.texi (Inserting structure templates): Document.
* testing/lisp/test-org.el (test-org/insert-template): New test.
2017-11-05 09:56:26 +01:00
Nicolas Goaziou 99dbca3d4f Remove `org-babel-use-quick-and-dirty-noweb-expansion'
* lisp/ob-core.el (org-babel-use-quick-and-dirty-noweb-expansion):
  Remove variable.
(org-babel-expand-noweb-references): Update function.

* doc/org.texi (noweb-ref): Document new behaviour.
(Noweb reference syntax): Delete reference to removed variable.

`org-babel-use-quick-and-dirty-noweb-expansion' main use is to speed
up Noweb expansion when expanding only by name.  By distinguishing
name and reference expansion, we no longer need this variable.  In the
first case, the expansion is quicker anyway, and in the second case,
we most certainly need an accurate expansion.
2017-10-26 13:09:23 +02:00
Marco Wahl 78c6a299d2 org-agenda: Bulk mark lines in region
* lisp/org-agenda.el (org-agenda-bulk-mark): Added bulk mark for entries
  in region.  This is like in dired now.

* doc/org.texi (Agenda commands): Document bulk mark entries in region
2017-10-25 15:13:13 +02:00
Nicolas Goaziou 52d4ca4b29 Merge branch 'maint' 2017-10-17 23:31:45 +02:00
Allen Li 90d283f189 Update documentation on org-protocol template placeholders
* doc/org.texi (@code{capture} protocol): Fix placeholder names
(Template expansion): Add org-protocol placeholders

* lisp/org.el (org-store-link-plist): Fix docstring grammar
(org-store-link-props): Fix docstring grammar
2017-10-17 23:28:53 +02:00
Nicolas Goaziou 9b13e44ad7 ox: Implement "notoc" UNNUMBERED value
* lisp/ox.el (org-export-collect-headlines): Exclude headlines with
  UNNUMBERED property set to "notoc".

* doc/org.texi (Export settings):
(Table of contents): Document new value.

* testing/lisp/test-ox.el (test-org-export/collect-headlines): Add
  test.
2017-10-15 16:51:10 +02:00
Kyle Meyer 86e6ab697c Merge branch 'maint' 2017-10-12 01:28:25 -04:00
Kyle Meyer 8c44a3f23d org.texi: Correct keys for subtree movement commands
* doc/org.texi (Structure editing): Correct bindings for
org-move-subtree-up and org-move-subtree-down.

Reported-by: Johann Höchtl <<johann.hoechtl@gmail.com>>
<https://lists.gnu.org/archive/html/emacs-orgmode/2017-10/msg00203.html>
2017-10-12 01:27:42 -04:00
Kyle Meyer 7a2b642ad1 Merge branch 'maint' 2017-10-02 09:41:35 -04:00
Martin Rudalics 8ed303fdfe Backport commit 07ea5ef99 from Emacs
* doc/org.texi (A Texinfo example): Fix reference style.

Fix reference style in org.texi
07ea5ef99a509622981a8ca69aadff15cbc0ef10
Martin Rudalics
Sun Oct 1 10:30:33 2017 +0200

<https://lists.gnu.org/archive/html/emacs-devel/2017-10/msg00019.html>
2017-10-02 09:37:40 -04:00
Nicolas Goaziou 9cfa907971 Merge branch 'maint' 2017-09-28 16:25:36 +02:00
Nicolas Goaziou a563ccabe3 org.texi: Add missing information about `org-cycle-global-at-bob'
* doc/org.texi (Global and local cycling): Document special situation
  when buffer begins with a headline.

Reported-by: Alain.Cochard@unistra.fr
<http://lists.gnu.org/archive/html/emacs-orgmode/2017-09/msg00456.html>
2017-09-28 16:25:12 +02:00
Nicolas Goaziou 4f619fc200 Merge branch 'maint' 2017-09-28 16:06:57 +02:00
Nicolas Goaziou 40b82fdb8a org.texi: Remove reference to removed variable
* doc/org.texi (Plain lists): Remove reference to
  `org-list-empty-line-terminates-plain-lists'.

Reported-by: Alain.Cochard@unistra.fr
<http://lists.gnu.org/archive/html/emacs-orgmode/2017-09/msg00603.html>
2017-09-28 16:06:11 +02:00
Marco Wahl 80eca1d31f org.texi: Delete misplaced colon 2017-09-26 13:56:30 +02:00
Nicolas Goaziou 039004ddee Merge branch 'maint' 2017-09-21 21:17:04 +02:00
Nick Dokos 196ed7feff Add publishing function to "Simple example"
The simple example project definition is missing a publishing
function. Added org-html-publish-to-html as the publishing function.
2017-09-21 21:16:45 +02:00
Nicolas Goaziou ad0662bbe7 Revert "Table of contents ignore unnumbered headlines"
This reverts commit bd2378161e.
2017-09-21 21:14:41 +02:00
Nicolas Goaziou 2faebbd2f0 Merge branch 'maint' 2017-09-20 12:56:17 +02:00
Nicolas Goaziou 1ef71bf7e0 Rephrase `org-cycle-global-at-bob' documantion
* doc/org.texi (Global and local cycling): Rephrase
  `org-cycle-global-at-bob' documantion.

Reported-by: Alain.Cochard@unistra.fr
<http://lists.gnu.org/archive/html/emacs-orgmode/2017-09/msg00447.html>
2017-09-20 12:55:50 +02:00
Kyle Meyer 297acd7517 Merge branch 'maint' 2017-09-17 01:17:10 -04:00
Paul Eggert ff0dcf52a5 Backport commit bc511a64f from Emacs
Prefer HTTPS to FTP and HTTP in documentation
bc511a64f6da9ab51acc7c8865e80c4a4cb655c2
Paul Eggert
Wed Sep 13 15:54:37 2017 -0700
2017-09-17 00:28:38 -04:00
Kyle Meyer 3df23ef80c Merge branch 'maint' 2017-09-15 18:59:45 -04:00
Kyle Meyer 042fa9970e org.texi: Update for library-of-babel.org move
* doc/org.texi (Library of Babel): Point to library-of-babel.org's new
location (as of 517637012).
2017-09-15 18:58:41 -04:00