Commit Graph

2703 Commits

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