Commit Graph

21614 Commits

Author SHA1 Message Date
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 3f601e218d org-src: Fix auto-saving of remote editing buffers
* lisp/org-src.el (org-src--auto-save-timer): No longer buffer-local.
(org-src-mode): Tiny refactoring so as to keep code under 80 columns.

Reported-by: Andreas Fuchs <asf@boinkor.net>
http://lists.gnu.org/archive/html/emacs-orgmode/2018-07/msg00002.html
2018-07-02 00:45:12 +02:00
Nicolas Goaziou 7d9e4da447 Prevent spurious newline character in fixed-width area value
* lisp/org-element.el (org-element-fixed-width-parser): Prevent
  spurious newline character at the end of the value.
* lisp/ox-latex.el (org-latex-fixed-width):
* lisp/ox-man.el (org-man-fixed-width):
* lisp/ox-texinfo.el (org-texinfo-fixed-width):
* contrib/lisp/ox-groff.el (org-groff-fixed-width): Adapt to change.
* testing/lisp/test-org-element.el (test-org-element/fixed-width-parser):
  Update tests.

Reported-by: 孙振祥 <sunznx@icloud.com>
<http://lists.gnu.org/archive/html/emacs-orgmode/2018-07/msg00003.html>
2018-07-02 00:24:38 +02:00
Nicolas Goaziou 937e7ce76b org-macs: Fix last commit
* lisp/org-macs.el (org-parse-time-string): Fix typo in last commit.
* testing/lisp/test-org-element.el (test-org-element/timestamp):
  Rename to `test-org-element/timestamp-parser'.
2018-07-02 00:18:44 +02:00
Nicolas Goaziou e1884a0985 org-macs: Tiny refactoring
* lisp/org-macs.el (org-parse-time-string): Refactor code.

`org-parse-time-string' does not need to handle non-Org timestamps,
like "<tomorrow>" or "<+2d>" so we remove the cond branch.
2018-07-01 23:25:56 +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 6f8fdabf35 org-macs: Fix circular dependency
* lisp/org-macs.el (org-matcher-time): Fix circular dependency between
  `org-parse-time-string', `org-matcher-time' and `org-2ft'.  Improve
  docstring.

Reported-by: Allen Li <vianchielfaura@gmail.com>
<http://lists.gnu.org/r/emacs-orgmode/2017-11/msg00023.html>
2018-06-28 22:40:51 +02:00
Grant Rettke 27381411ca ox-koma-letter: Add FROM_LOGO examples
FROM_LOGO uses LaTeX markup probably unfamiliar to the user.

This example provides detailed documentation and examples of its use.
2018-06-27 16:20:44 +02:00
Robert Irelan e1f197aec7 org-clock: Test clocktable behavior under `org-extend-today-until'
* testing/lisp/test-org-clock.el (test-org-clock/clocktable/extend-today-until):
  New test.
2018-06-27 08:31:47 +02:00
Robert Irelan fda1d27610 org-clock: Properly handle `org-extend-today-until' in clock tables
* lisp/org-clock.el (org-clock-special-range): Handle non-default
   `org-extend-today-until' when generating a clock table with the
   `:block` directive.

 Reported-by: Robert Irelan <rirelan@gmail.com>
 <http://lists.gnu.org/archive/html/emacs-orgmode/2018-04/msg00294.html>
2018-06-27 08:31:38 +02:00
Nicolas Goaziou cad692c276 ox: Fix Italian translation for "Figure"
* lisp/ox.el (org-export-dictionary): Fix Italian translation for
  "Figure".

Reported-by: Franco Pasut <franco.pasut@gmail.com>
<http://lists.gnu.org/r/emacs-orgmode/2018-06/msg00373.html>
2018-06-26 12:00:30 +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 7c14efd3e9 org-info: Fix typo
* lisp/org-info.el (org-info-follow-link): Fix typo in regexp.
2018-06-24 19:55:11 +02:00
Nicolas Goaziou 1f9e1cce62 org-footnote: Fix last commit
* lisp/org-footnote.el (org-footnote-next-reference-or-definition):
  Fix typo introduced in last commit.
2018-06-24 19:47:41 +02:00
Nicolas Goaziou c37c6bda3c org-footnote: Fix footnote predicates
* lisp/org-footnote.el (org-footnote-at-reference-p):
(org-footnote-at-definition-p): Rewrite using Elements library.
(org-footnote-get-next-reference): Use `org-footnote-at-reference-p'.
(org-footnote-next-reference-or-definition): Use old definition for
`org-footnote-at-definition-p' and `org-footnote-at-definition-p'.

This patch aims at reducing the calls to the inaccurate
`org-footnote-in-valid-context-p' function.  However,
`org-footnote-next-reference-or-definition' still uses it because the
function is for fontification only, so 1. accuracy matters less
2. Elements has a slower worse case scenario.
2018-06-24 14:57:49 +02:00
Nicolas Goaziou 627cb7f578 org-footnote: Fix `org-footnote-goto-previous-reference'
* lisp/org-footnote.el (org-footnote-goto-previous-reference): Only
  add to mark ring on a successful match.  Improve error message when
  reference is outside visible part of buffer.
(org-footnote-get-next-reference): Avoid using
`org-footnote-at-reference-p', which is inaccurate, due to
`org-footnote-in-valid-context-p'.
* testing/lisp/test-org-footnote.el (test-org-footnote/goto-previous-reference):
  New test.
2018-06-24 11:25:15 +02:00
Marco Wahl 9553896b11 Merge branch 'keep-text-scale-in-agenda-at-reload' 2018-06-24 09:58:01 +02:00
Marco Wahl a6b4cec691 org-agenda: Refactored. Add test.
* lisp/org-agenda.el (org-agenda-mode): Factored out a function for a
  loop occuring two times.
* testing/lisp/test-org-agenda.el: test the text scale after
  agenda-undo.
2018-06-24 09:52:29 +02:00
Nicolas Goaziou 58b512013e org-clock: Fix `org-clock-display'
* lisp/org-clock.el (org-clock-put-overlay): Do not expand links when
  displaying clocked times.

Reported-by: Sheng Yang (杨圣) <yangsheng6810@gmail.com>
<http://lists.gnu.org/r/emacs-orgmode/2018-06/msg00024.html>
2018-06-23 23:55:01 +02:00
Nicolas Goaziou f5d5a95018 ox-koma-letter: Tiny refactoring and cosmetics 2018-06-23 23:33:37 +02:00
Nicolas Goaziou a8677adb49 ox-koma-letter: Fix closing part
* contrib/lisp/ox-koma-letter.el (org-koma-letter--build-settings): Do
  not translate closing part twice.

Reported-by: Tobias Zawada <i_inbox@tn-home.de>
<http://lists.gnu.org/r/emacs-orgmode/2018-06/msg00315.html>
2018-06-23 23:22:03 +02:00
Nicolas Goaziou 8e54cafeb2 Fix noweb expansion during export
* lisp/ob-core.el (org-babel-sha1-hash): Add optional argument to
  specify context.
(org-babel-execute-src-block): Use new argument.
* lisp/ob-exp.el (org-babel-exp-src-block): Use new argument.
(org-babel-exp-results): Fix context.

Reported-by: Ken Mankoff <mankoff@gmail.com>
<http://lists.gnu.org/r/emacs-orgmode/2018-06/msg00117.html>
2018-06-23 23:04:45 +02:00
Marco Wahl d6ebe38e2c Merge branch 'keep-some-local-variables-at-rebuild' into keep-text-scale-in-agenda-at-reload 2018-06-23 20:36:04 +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 62dd2cc829 Fix regression in tags alignment
* lisp/org.el (org--align-tags-here): Correctly preserve column.
* testing/lisp/test-org.el (test-org/tag-align): Add test.

The regression was introduced in
593058e4a6.

Reported-by: Bernt Hansen <bernt@norang.ca>
<http://lists.gnu.org/r/emacs-orgmode/2018-06/msg00245.html>
2018-06-22 18:49:11 +02:00
Henry Blevins f2500e06f3 ob-scheme: Add tests for scheme result types
* test-ob-scheme.el (test-ob-scheme/verbatim, test-ob-scheme/list):
  New tests.
2018-06-21 22:00:50 +02:00