Commit Graph

2669 Commits

Author SHA1 Message Date
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 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
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
Bastien f584d37a67 Update copyright year 2019-01-01 11:50:56 +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
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 908b55124c org-manual: Fix markup
* doc/org-manual.org (Initial visibility): Fix markup.
2018-12-20 18:36:01 +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 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 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 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 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
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 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 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 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 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 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
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 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 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 050e2bf509 org-manual: Fix typo
* doc/org-manual.org (Footnotes): Fix typo.
2018-10-06 12:01:30 +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
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