Commit Graph

98 Commits

Author SHA1 Message Date
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