summaryrefslogtreecommitdiff
path: root/elpa/org-9.5.2/etc/ORG-NEWS
diff options
context:
space:
mode:
authormattkae <mattkae@protonmail.com>2022-06-07 08:23:47 -0400
committermattkae <mattkae@protonmail.com>2022-06-07 08:23:47 -0400
commitbd18a38c2898548a3664a9ddab9f79c84f2caf4a (patch)
tree95b9933376770381bd8859782ae763be81c2d72b /elpa/org-9.5.2/etc/ORG-NEWS
parentb07628dddf418d4f47b858e6c35fd3520fbaeed2 (diff)
parentef160dea332af4b4fe5e2717b962936c67e5fe9e (diff)
Merge conflict
Diffstat (limited to 'elpa/org-9.5.2/etc/ORG-NEWS')
-rw-r--r--elpa/org-9.5.2/etc/ORG-NEWS6327
1 files changed, 0 insertions, 6327 deletions
diff --git a/elpa/org-9.5.2/etc/ORG-NEWS b/elpa/org-9.5.2/etc/ORG-NEWS
deleted file mode 100644
index 5e7813c..0000000
--- a/elpa/org-9.5.2/etc/ORG-NEWS
+++ /dev/null
@@ -1,6327 +0,0 @@
-ORG NEWS -- history of user-visible changes. -*- mode: org; coding: utf-8 -*-
-
-#+STARTUP: overview
-
-#+LINK: doc https://orgmode.org/worg/doc.html#%s
-#+LINK: msg https://list.orgmode.org/%s/
-#+LINK: git https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=%s
-
-Copyright (C) 2012-2021 Free Software Foundation, Inc.
-See the end of the file for license conditions.
-
-Please send Org bug reports to mailto:emacs-orgmode@gnu.org.
-
-* Version 9.5
-
-** Important announcements and breaking changes
-
-*** The =contrib/= now lives in a separate repository
-
-Org's repository has been trimmed from the =contrib/= directory.
-
-The old contents of the =contrib/= directory now lives in a separate
-repository at https://git.sr.ht/~bzg/org-contrib.
-
-You can install this repository by cloning it and updating your
-~load-path~ accordingly. You can also install =org-contrib= as a
-[[https://elpa.nongnu.org/nongnu/][NonGNU ELPA]] package.
-
-*** Org ELPA and Org archives won't be available for Org > 9.5
-
-[[https://orgmode.org/elpa.html][Org ELPA]] is still available for installing Org 9.5, either with or
-without contributed packages, but future versions won't be available
-via Org ELPA, as we are deprecating this installation method.
-
-Also, Org 9.5 is available as =tar.gz= and =zip= archives, but this
-installation method is also deprecated.
-
-If you want to install the latest stable versions of Org, please use
-the GNU ELPA package. If you want to install the contributed files,
-please use the NonGNU ELPA package. If you want to keep up with the
-latest unstable Org, please install from the Git repository.
-
-See https://orgmode.org/org.html#Installation for the details.
-
-*** =ditaa.jar= is not bundled with Org anymore
-
-=ditaa.jar= used to be bundled with Org but it is not anymore.
-See [[https://github.com/stathissideris/ditaa][the ditaa repository]] on how to install it.
-
-*** ~org-adapt-indentation~ now defaults to =nil=
-
-If you want to automatically indent headlines' metadata, set it to
-=headline-data=.
-
-If you want to automatically indent every line to the headline's
-current indentation, set it to =t=.
-
-Indent added by =RET= and =C-j= also depends on the value of
-~electric-indent-mode~. Enabling this mode by default in 9.4 revealed
-some bugs caused confusing behavior. If you disabled
-~electric-indent-mode~ for this reason, it is time to try it again.
-Hopefully problems have been fixed. See [[https://orgmode.org/worg/org-faq.html#indentation][this FAQ]] for more details.
-
-*** ~org-speed-commands-user~ is obsolete, use ~org-speed-commands~
-
-Setting ~org-speed-commands-user~ in your configuration won't have any
-effect. Please set ~org-speed-commands~ instead, which see.
-
-*** Some =ob-*.el= files have been moved to the org-contrib repo
-
-These files have been moved to https://git.sr.ht/~bzg/org-contrib:
-
-- ob-abc.el
-- ob-asymptote.el
-- ob-coq.el
-- ob-ebnf.el
-- ob-hledger.el
-- ob-io.el
-- ob-J.el
-- ob-ledger.el
-- ob-mscgen.el
-- ob-picolisp.el
-- ob-shen.el
-- ob-stan.el
-- ob-vala.el
-
-See the discussion [[msg::87bl9rq29m.fsf@gnu.org][here]].
-
-*** Compatibility with Emacs versions
-
-We made it explicit that we aim at keeping the latest stable version
-of Org compatible with at least Emacs V, V-1 and V-2, where V is the
-stable major version of Emacs.
-
-For example, if the current major version of Emacs is 28.x, then the
-latest stable version of Org should be compatible with Emacs 28.x,
-27.x and 26.x – but not with Emacs 25.x.
-
-See [[https://orgmode.org/worg/org-maintenance.html#emacs-compatibility][this note on Worg]] and [[git::519947e508e081e71bf67db99e27b1c171ba4dfe][this commit]].
-
-*** The keybinding for ~org-table-blank-field~ has been removed
-
-If you prefer to keep the keybinding, you can add it back to
-~org-mode-map~ like so:
-
-#+begin_src emacs-lisp
-(define-key org-mode-map (kbd "C-c SPC") #'org-table-blank-field)
-#+end_src
-
-** New features
-
-*** New citation engine
-
-Org 9.5 provides a new library =oc.el= which provides tooling to
-handle citations in Org, e.g., activate, follow, insert, and export
-them, respectively called "activate", "follow", "insert" and "export"
-capabilities. Libraries responsible for providing some, or all, of
-these capabilities are called "citation processors".
-
-The manual contains a few pointers to let you start and you may want
-to check [[https://blog.tecosaur.com/tmio/2021-07-31-citations.html][this blog post]]. If you need help using this new features,
-please ask on the mailing list.
-
-Thanks to Nicolas Goaziou for implementing this, to Bruce D’Arcus for
-helping him and to John Kitchin for paving the way with =org-ref.el=.
-
-*** Async session evaluation
-
-The =:async= header argument can be used for asynchronous evaluation
-in session blocks for certain languages.
-
-Currently, async evaluation is supported in Python. There is also
-functionality to implement async evaluation in other languages that
-use comint, but this needs to be done on a per-language basis.
-
-By default, async evaluation is disabled unless the =:async= header
-argument is present. You can also set =:async no= to force it off
-(for example if you've set =:async= in a property drawer).
-
-Async evaluation is disabled during export.
-*** ~ox-koma-letter.el~ is now part of Org's core
-
-~ox-koma-letter.el~ provides a KOMA scrlttr2 back-end for the Org
-export engine. It used to be in the =contrib/= directory but it is
-now part of Org's core.
-
-*** Support exporting DOI links
-
-Org now supports export for DOI links, through its new =ol-doi.el=
-library. For backward compatibility, it is loaded by default.
-
-*** Add a new ~:refile-targets~ template option
-
-When exiting capture mode via ~org-capture-refile~, the variable
-~org-refile-targets~ will be temporarily bound to the value of this
-template option.
-
-*** New startup options =#+startup: show<n>levels=
-
-These startup options complement the existing =overview=, =content=,
-=showall=, =showeverything= with a way to start the document with n
-levels shown, where n goes from 2 to 5.
-
-Example:
-
-: #+startup: show3levels
-
-*** New =u= table formula flag to enable Calc units simplification mode
-
-A new =u= mode flag for Calc formulas in Org tables has been added to
-enable Calc units simplification mode.
-
-*** Support fontification of inline export snippets
-
-See [[msg:87im57fh8j.fsf@gmail.com][this thread]].
-
-*** New command =org-refile-reverse= bound to =C-c C-M-w=
-
-You can now use =C-c C-M-w= to run ~org-refile-reverse~.
-
-It is almost identical to ~org-refile~, except that it temporarily
-toggles how ~org-reverse-note-order~ applies to the current buffer.
-So if ~org-refile~ would append the entry as the last entry under the
-target heading, ~org-refile-reverse~ will prepend it as the first
-entry, and vice-versa.
-
-*** LaTeX attribute ~:float~ now passes through arbitrary values
-
-LaTeX users are able to define arbitrary float types, e.g. with the
-float package. The Org mode LaTeX exporter is now able to process and
-export arbitrary float types. The user is responsible for ensuring
-that Org mode configures LaTeX to process any new float type.
-
-*** Support verse and quote blocks in LaTeX export
-
-The LaTeX export back-end accepts four attributes for verse blocks:
-=:lines=, =:center=, =:versewidth= and =:latexcode=. The three first
-require the external LaTeX package =verse.sty=, which is an extension
-of the standard LaTeX environment.
-
-The LaTeX export back-end accepts two attributes for quote blocks:
-=:environment=, for an arbitrary quoting environment (the default
-value is that of =org-latex-default-quote-environment=: ="quote"=) and
-=:options=.
-
-*** =org-set-tags-command= selects tags from ~org-global-tags-completion-table~
-
-Let ~org-set-tags-command~ TAB fast tag completion interface complete
-tags including from both buffer local and user defined persistent
-global list (~org-tag-alist~ and ~org-tag-persistent-alist~). Now
-option ~org-complete-tags-always-offer-all-agenda-tags~ is honored.
-
-*** Clocktable option =:formula %= now shows the per-file time percentages
-
-This change only has an effect when multiple files are contributing to
-a given clocktable (such as when =:scope agenda= has been specified).
-The existing behavior is that such tables have an extra 'File' column,
-and each individual file that contributes has its own summary line
-with the headline value '*File time*'. Those summary rows also
-produce a rollup time value for the file in the 'Time' column.
-
-Prior to this change, the built-in =%= formula did not produce a
-calculation for those per-file times in the '%' column (the relevant
-cells in the '%' column were blank). With this change, the percentage
-contribution of each individual file time to the total time is shown.
-
-The more agenda files you have, the more useful this behavior becomes.
-
-*** =ob-python.el= improvements to =:return= header argument
-
-The =:return= header argument in =ob-python= now works for session
-blocks as well as non-session blocks. Also, it now works with the
-=:epilogue= header argument -- previously, setting the =:return=
-header would cause the =:epilogue= to be ignored.
-
-This change allows more easily moving boilerplate out of the main code
-block and into the header. For example, for plotting, we need to add
-boilerplate to save the figure to a file and return the
-filename. Instead of doing this within the code block, we can now
-handle it through the header arguments as follows:
-
-#+BEGIN_SRC org
-,#+header: :var fname="/home/jack/tmp/plot.svg"
-,#+header: :epilogue plt.savefig(fname)
-,#+header: :return fname
-,#+begin_src python :results value file
- import matplotlib, numpy
- import matplotlib.pyplot as plt
- fig=plt.figure(figsize=(4,2))
- x=numpy.linspace(-15,15)
- plt.plot(numpy.sin(x)/x)
- fig.tight_layout()
-,#+end_src
-
-,#+RESULTS:
-[[file:/home/jack/tmp/plot.svg]]
-#+END_SRC
-
-As another example, we can use =:return= with the external [[https://pypi.org/project/tabulate/][tabulate]]
-package, to convert pandas Dataframes into orgmode tables:
-
-#+begin_src org
-,#+header: :prologue from tabulate import tabulate
-,#+header: :return tabulate(table, headers=table.columns, tablefmt="orgtbl")
-,#+begin_src python :results value raw :session
- import pandas as pd
- table = pd.DataFrame({
- "a": [1,2,3],
- "b": [4,5,6]
- })
-,#+end_src
-
-,#+RESULTS:
-| | a | b |
-|---+---+---|
-| 0 | 1 | 4 |
-| 1 | 2 | 5 |
-| 2 | 3 | 6 |
-#+end_src
-
-*** Display images with width proportional to the buffer text width
-
-Previously, if you used a =:width= attribute like =#+attr_html: :width 70%= or
-=#+attr_latex: :width 0.7\linewidth= this would be interpreted as a 70px wide and
-0.7px wide width specification respectively.
-
-Now, percentages are transformed into floats (i.e. 70% becomes 0.7),
-and float width specifications between 0.0 and 2.0 are now interpreted
-as that portion of the text width in the buffer. For instance, the
-above examples of =70%= and =0.7\linewidth= will result in an image
-with width equal to the pixel-width of the buffer text multiplied by 0.7.
-
-This functionality is implemented in a new function,
-~org-display-inline-image--width~ which contains the width
-determination logic previously in ~org-display-inline-images~ and the
-new behaviour.
-
-** New options
-*** Option ~org-hidden-keywords~ now also applies to #+SUBTITLE:
-
-The option ~org-hidden-keywords~ previously applied
-to #+TITLE:, #+AUTHOR:, #+DATE:, and #+EMAIL:. Now it can also be
-used to hide the #+SUBTITLE: keyword.
-
-*** New formatting directive ~%L~ for org-capture
-
-The new ~%L~ formatting directive contains the bare link target, and
-may be used to create links with programmatically generated
-descriptions.
-
-*** New option ~org-id-ts-format~
-
-Earlier, IDs generated using =ts= method had a hard-coded format (i.e. =20200923T160237.891616=).
-The new option allows user to customise the format.
-Defaults are unchanged.
-
-*** New argument for ~file-desc~ babel header
-
-It is now possible to provide the =file-desc= header argument for a
-babel source block but omit the description by passing an empty vector
-as an argument (i.e., :file-desc []). This can be useful because
-providing =file-desc= without an argument results in the result of
-=file= being used in the description. Previously, the only way to
-omit a file description was to omit the header argument entirely,
-which made it difficult/impossible to provide a default value for
-=file-desc=.
-
-*** New option to set ~org-link-file-path-type~ to a function
-
-~org-link-file-path-type~ can now be set to a function that takes the
-full filename as an argument and returns the path to link to.
-
-For example, if you use ~project.el~, you can set this function to use
-relative links within a project as follows:
-
-#+begin_src emacs-lisp
-(setq (org-link-file-path-type
- (lambda (path)
- (let* ((proj (project-current))
- (root (if proj (project-root proj) default-directory)))
- (if (string-prefix-p (expand-file-name root) path)
- (file-relative-name path)
- (abbreviate-file-name path))))))
-#+end_src
-
-*** New options and new behavior for babel LaTeX SVG image files
-
-Org babel now uses a two-stage process for converting latex source
-blocks to SVG image files (when the extension of the output file is
-~.svg~). The first stage in the process converts the latex block into
-a PDF file, which is then converted into an SVG file in the second
-stage. The TeX->PDF part uses the existing infrastructure for
-~org-babel-latex-tex-to-pdf~. The PDF->SVG part uses a command
-specified in a new customization,
-~org-babel-latex-pdf-svg-process~. By default, this uses inkscape for
-conversion, but since it is fully customizable, any other command can
-be used in its place. For instance, dvisvgm might be used here. This
-two-part processing replaces the previous use of htlatex to process
-LaTeX directly to SVG (htlatex is still used for HTML conversion).
-
-Conversion to SVG exposes a number of additional customizations that
-give the user full control over the contents of the latex source
-block. ~org-babel-latex-preamble~, ~org-babel-latex-begin-env~ and
-~org-babel-latex-end-env~ are new customization options added to allow
-the user to specify the preamble and code that preceedes and proceeds
-the contents of the source block.
-
-*** New option ~org-html-meta-tags~ allows for HTML meta tags customization
-
-New variable ~org-html-meta-tags~ makes it possible to customize the
-=<meta>= tags used in an HTML export. Accepts either a static list of
-values, or a function that generates such a list (see
-~org-html-meta-tags-default~ as an example of the latter).
-
-*** Option ~org-agenda-bulk-custom-functions~ now supports collecting bulk arguments
-
-When specifying a custom agenda bulk option, you can now also specify
-a function which collects the arguments to be used with each call to
-the custom function.
-
-*** New faces to improve the contextuality of Org agenda views
-
-Four new faces improve certain styles and offer more flexibility for
-some Org agenda views: ~org-agenda-date-weekend-today~,
-~org-imminent-deadline~, ~org-agenda-structure-secondary~,
-~org-agenda-structure-filter~. They inherit from existing faces in
-order to remain backward-compatible.
-
-Quoting from [[https://list.orgmode.org/87lf7q7gpq.fsf@protesilaos.com/][this thread]]:
-
-#+begin_quote
-+ The 'org-imminent-deadline' is useful to disambiguate generic
- warnings from deadlines. For example, a warning could be rendered
- in a yellow colored text and have a bold weight, whereas a deadline
- might be red and styled with italics.
-
-+ The 'org-agenda-structure-filter' applies to all tag/term filters
- in agenda views that search for keywords or patterns. It is
- designed to inherit from 'org-agenda-structure' in addition to the
- 'org-warning' face that was present before (and removes the
- generic 'warning' face from one place). This offers the benefit
- of consistency, as, say, an increase in font height or a change in
- font family in 'org-agenda-structure' will propagate to the filter
- as well. The whole header line thus looks part of a singular
- design.
-
-+ The 'org-agenda-structure-secondary' complements the above for those
- same views where a description follows the header. For instance, the
- tags view provides information to "Press N r" to filter by a
- numbered tag. Themes/users may prefer to disambiguate this line
- from the header above it, such as by using a less intense color or by
- reducing its height relative to the 'org-agenda-structure'.
-
-+ The 'org-agenda-date-weekend-today' provides the option to
- differentiate the current date on a weekend from the current date on
- weekdays.
-#+end_quote
-
-*** New option ~org-clock-ask-before-exiting~
-
-By default, a function is now added to ~kill-emacs-query-functions~
-that asks whether to clock out and save when there's a running clock.
-Customize ~org-clock-ask-before-exiting~~ to nil to disable this new
-behavior.
-
-*** Option ~org-html-inline-image-rules~ now includes .webp
-
-By default ox-html now inlines webp images.
-
-*** ~org-html-head-include-scripts~ is now =nil= by default
-
-See [[msg:498dbe2e-0cd2-c81e-7960-4a26c566a1f7@memebeam.org][this thread]].
-
-*** New option ~org-html-content-class~
-
-This is the CSS class name to use for the top level content wrapper.
-
-*** New option ~org-babel-plantuml-svg-text-to-path~
-
-This option, nil by default, allows to add a SVG-specific post-export
-step that runs inkscape text-to-path replacement over the output file.
-
-*** You can now configure ~org-html-scripts~ and ~org-html-style-default~
-
-~org-html-scripts~ and ~org-html-style-default~ used to be constants,
-you can now configure them.
-
-*** New option ~org-attach-git-dir~
-
-~org-attach-git-dir~ will decide whether to use ~org-attach-git-dir~
-(the default) or use the attachment directory of the current node, if
-it is correctly configured as a Git repository.
-
-*** Some faces now use fixed-pitch
-
-See [[msg:875z8njaol.fsf@protesilaos.com][this thread]].
-
-*** New option ~org-attach-sync-delete-empty-dir~
-
-~org-attach-sync-delete-empty-dir~ controls the deletion of an empty
-attachment directory at calls of ~org-attach-sync~. There is
-Never delete, Always delete and Query the user (default).
-
-*** ~org-babel-default-header-args~ can now be specified as closures or strings
-
-~org-babel-default-header-args~ now also accepts closures that
-evaluate to a string. Previously, only direct strings were
-supported. These closures are evaluated when point is at the source
-block, which allows them to make use of contextual information at the
-relevant source block. One example that illustrates the usefulness of
-this addition (also given in the documentation for
-~org-babel-default-header-args~) is:
-
-#+begin_src elisp
-(defun org-src-sha ()
- (let ((elem (org-element-at-point)))
- (concat (sha1 (org-element-property :value elem)) \".svg\")))
-
-(setq org-babel-default-header-args:latex
- `((:results . \"file link replace\")
- (:file . (lambda () (org-src-sha)))))
-#+end_src
-
-This will set the ~:file~ header argument to the sha1 checksum of the
-contents of the current latex source block.
-
-Finally, the closures are only evaluated if they're not overridden for
-a source block. This improves efficiency in cases where the result of
-a compute-expensive closure would otherwise be discarded.
-
-** Miscellaneous
-*** =org-bibtex= includes =doi= and =url= entries when exporting to BiBTeX
-=doi= and =url= entries have been made optional for some publication
-types and will be exported if present for those types.
-*** Missing or empty placeholders in "eval" macros are now =nil=
-They used to be the empty string.
-*** =org-goto-first-child= now works before first heading
-
-When point is before first heading =org-goto-first-child= will move
-point to the first child heading, or return nil if no heading exist
-in buffer. This is in line with the fact that everything before first
-heading is regarded as outline level 0, i.e. the parent level of all
-headings in the buffer.
-
-Previously =org-goto-first-child= would do nothing before first
-heading, except return nil.
-
-*** Faces of all the heading text elements now conform to the headline face
-
-In the past, faces of todo keywords, emphasised text, tags, and
-priority cookies inherited =default= face. The resulting headline
-fontification was not always consistent, as discussed in [[https://lists.gnu.org/archive/html/emacs-orgmode/2020-09/msg00331.html][this bug
-report]]. Now, the relevant faces adapt to face used to fontify the
-current headline level.
-
-Users who prefer to keep the old behaviour should change their face
-customisation explicitly stating that =default= face is inherited.
-
-Example of old face customisation:
-
-#+begin_src emacs-lisp
-(setq org-todo-keyword-faces '(("TODO"
- :background "chocolate"
- :height 0.75)))
-#+end_src
-
-To preserve the old behaviour the above customisation should be
-changed to
-
-#+begin_src emacs-lisp
-(setq org-todo-keyword-faces '(("TODO"
- :inherit default
- :background "chocolate"
- :height 0.75)))
-#+end_src
-
-*** Storing ID-links before first heading uses title as description
-
-Storing links to files using ~org-store-link~ (=<C-c l>=) when
-~org-id-link-to-org-use-id~ is not nil will now store the title as
-description of the link, if available. If no title exists it falls
-back to the filename as before.
-
-*** Change in =org-tags-expand= signature
-
-The function does not allow for a third optional parameter anymore.
-*** LaTeX environment =#+results= are now removed
-
-If a babel src block produces a raw LaTeX environment, it will now be
-recognised as a result, and so replaced when re-evaluated.
-
-*** Tag completion now uses =completing-read-multiple=
-
-Tag completion now uses =completing-read-multiple= with a simple
-completion table, which should allow better interoperability with
-custom completion functions.
-
-*** Providing =directory-empty-p= from Emacs 28 as =org-directory-empty-p=
-
-*** =org-get-last-sibling= marked as obsolete
-
-Use =org-get-previous-sibling= instead. This is just a rename to have
-a more consistent naming. E.g. recall the pair of funtctions
-=next-line= / =previous-line=.
-
-*** Make org-protocol compatible with =URLSearchParams= JavaScript class
-
-Decoder of query part of org-protocol URI recognizes "+" as an encoded
-space characters now, so it is possible to avoid call to =encodeURIComponent=
-for each parameter and use more readable expression in bookmarklet:
-
-#+begin_example
-'org-protocol://store-link?' + new URLSearchParams({
- url: location.href, title: document.title})
-#+end_example
-
-*** Remove obsolete LaTeX packages from ~org-latex-default-packages-alist~
-
-The LaTeX packages =grffile= and =textcomp= are redundant, with their
-capabilities being merged into =graphicx= and the LaTeX core
-respectively a while ago.
-
-* Version 9.4
-** Incompatible changes
-*** Possibly broken internal file links: please check and fix
-
-A bug has been affecting internal links to headlines, like
-
-: [[*Headline][A link to a headline]]
-
-Storing a link to a headline may have been broken in your setup and
-those links may appear as
-
-: [[*TODO Headline][A link to a headline]]
-
-Following the link above will result in an error: the TODO keyword
-should not be part of internal file links.
-
-You can use the following command to fix links in an Org buffer:
-
-#+begin_src emacs-lisp
-(defun org-fix-links ()
- "Fix ill-formatted internal links.
-E.g. replace [[*TODO Headline][headline]] by [[*Headline][headline]].
-Go through the buffer and ask for the replacement."
- (interactive)
- (visible-mode 1)
- (save-excursion
- (goto-char (point-min))
- (let ((regexp (format "\\[\\[\\*%s\\s-+"
- (regexp-opt org-todo-keywords-1 t))))
- (while (re-search-forward regexp nil t)
- (when (and (save-excursion
- (goto-char (match-beginning 0))
- (looking-at-p org-link-bracket-re))
- (y-or-n-p "Fix link (remove TODO keyword)? "))
- (replace-match "[[*")))))
- (visible-mode -1))
-#+end_src
-
-*** Calling conventions changes when opening or exporting custom links
-
-This changes affects export back-ends, and libraries providing new
-link types.
-
-Function used in ~:follow~ link parameter is required to accept a
-second argument. Likewise, function used in ~:export~ parameter needs
-to accept a fourth argument. See ~org-link-set-parameters~ for
-details.
-
-Eventually, the function ~org-export-custom-protocol-maybe~ is now
-called with a fourth argument. Even though the 3-arguments definition
-is still supported, at least for now, we encourage back-end developers
-to switch to the new signature.
-
-*** Python session return values must be top-level expression statements
-
-Python blocks with ~:session :results value~ header arguments now only
-return a value if the last line is a top-level expression statement.
-Also, when a None value is returned, "None" will be printed under
-"#+RESULTS:", as it already did with ~:results value~ for non-session
-blocks.
-
-*** In HTML export, change on how outline-container-* is set
-
-When the headline has a =CUSTOM_ID=, use this custom id to build the
-div id. For example, if you have =:CUSTOM_ID: my-headline= then the
-resulting <div> will be ~<div id="outline-container-my-headline">~.
-
-You may want to check whether your HTML files are rendered differently
-after this change.
-
-*** New keybinding =<C-c C-TAB>= for ~org-force-cycle-archived~
-
-~org-force-cycle-archived~ used to be associated with =<C-TAB>= but
-this keybinding is used in Emacs for navigating tabs in Emacs. The
-new keybinding is =<C-c C-TAB>=.
-
-** New default settings for some options
-
-These options now default to =t=:
-
-- ~org-loop-over-headlines-in-active-region~
-- ~org-fontify-done-headline~
-- ~org-src-tab-acts-natively~
-
-You may want to read the docstrings of these options to understand the
-consequences of this change.
-
-Also, ~org-startup-folded~ now defaults to ~showeverything~.
-
-** New features
-
-*** =RET= and =C-j= now obey ~electric-indent-mode~
-
-Since Emacs 24.4, ~electric-indent-mode~ is enabled by default. In
-most major modes, this causes =RET= to reindent the current line and
-indent the new line, and =C-j= to insert a newline without indenting.
-
-Org mode now obeys this minor mode: when ~electric-indent-mode~ is
-enabled, and point is neither in a table nor on a timestamp or a link:
-
-- =RET= (bound to ~org-return~) reindents the current line and indents
- the new line;
-- =C-j= (bound to the new command ~org-return-and-maybe-indent~)
- merely inserts a newline.
-
-To get the previous behaviour back, disable ~electric-indent-mode~
-explicitly:
-
-#+begin_src emacs-lisp
-(add-hook 'org-mode-hook (lambda () (electric-indent-local-mode -1)))
-#+end_src
-
-Alternatively, if you wish to keep =RET= as the "smart-return" key,
-but dislike Org's default indentation of sections, you may prefer to
-customize ~org-adapt-indentation~ to either nil or =headline-data=.
-
-*** New allowed value for ~org-adapt-indentation~
-
-~org-adapt-indentation~ now accepts a new value, =headline-data=.
-
-When set to this value, Org will only adapt indentation of headline
-data lines, such as planning/clock lines and property/logbook drawers.
-Also, with this setting, =org-indent-mode= will keep these data lines
-correctly aligned with the headline above.
-
-*** Looping agenda commands over headlines
-
-~org-agenda-loop-over-headlines-in-active-region~ allows you to loop
-agenda commands over the active region.
-
-When set to =t= (the default), loop over all headlines. When set to
-='start-level=, loop over headlines with the same level as the first
-headline in the region. When set to a string, loop over lines
-matching this regular expression.
-
-*** New minor mode ~org-table-header-line-mode~
-
-Turn on the display of the first data row of the table at point in the
-window header line when this first row is not visible anymore in the
-buffer.
-
-You can activate this minor mode by default by setting the option
-~org-table-header-line-p~ to =t=. You can also change the face for
-the header line by customizing the ~org-table-header~ face.
-
-*** New minor mode ~org-list-checkbox-radio-mode~
-
-When this minor mode is on, checkboxes behave as radio buttons: if a
-checkbox is turned on, other checkboxes at the same level are turned
-off.
-
-If you want to occasionally toggle a checkbox as a radio button
-without turning this minor mode on, you can use =<C-c C-x C-r>= to
-call ~org-toggle-radio-button~.
-
-You can also add =#+ATTR_ORG: :radio t= right before the list to tell
-Org to use radio buttons for this list only.
-
-*** Numeric priorities are now allowed (up to 65)
-
-You can now set ~org-priority-highest/lowest/default~ to integers to
-use numeric priorities globally or set, for example
-
-#+PRIORITIES: 1 10 5
-
-to define a buffer-local range and default for priorities. Priority
-commands should work as usual. You cannot use numbers superior to 64
-for numeric priorities, as it would clash with priorities like [#A]
-where the "A" is internally converted to its numeric value of 65.
-
-*** Property drawers allowed before first headline
-
-Property drawers are now allowed before the first headline.
-
-Org mode is moving more towards making things before the first
-headline behave just as if it was at outline level 0. Inheritance for
-properties will work also for this level. In other words: defining
-things in a property drawer before the first headline will make them
-"inheritable" for all headlines.
-
-*** Refinement in window behavior on exiting Org source buffer
-
-After editing a source block, Org will restore the window layout when
-~org-src-window-setup~ is set to a value that modifies the layout.
-
-*** Display remote inline images
-
-Org now knows how to display remote images inline.
-
-Whether the images are actually displayed is controlled by the new
-option ~org-display-remote-inline-images~.
-
-*** New option to resolve open clock at a provided time
-
-~org-resolve-clocks~ now has a `t' option, which works just like the
-`k' option, but the user specifies a time of day, not a number of
-minutes.
-
-*** New step value =semimonth= accepted for clock tables
-
-*** Allow text rescaling in column view
-
-You can now use =C-x C-+= in column view: the columns face size will
-increase or decrease, together with the column header size.
-
-*** New startup option =#+startup: num=
-
-When this startup option is set, display headings as numerated.
-
-Use =#+startup: nonum= to turn this off.
-
-*** New tool for custom links
-
-Org provides a new tool ~org-link-open-as-file~, useful when defining
-new link types similar to "file"-type links. See docstring for
-details.
-
-*** New optional numeric argument for ~org-return~
-
-In situations where ~org-return~ calls ~newline~, multiple newlines
-can now be inserted with this prefix argument.
-
-*** New source code block header argument =:file-mode=
-
-Source code block header argument =:file-mode= can set file
-permissions if =:file= argument is provided.
-
-*** =ob-C.el= allows the inclusion of non-system header files
-
-In C and C++ blocks, ~:includes~ arguments that do not start with a
-~<~ character will now be formatted as double-quoted ~#include~
-statements.
-
-*** =ob-clojure.el= supports inf-clojure.el and ClojureScript evaluation
-
-You can now set ~(setq org-babel-clojure-backend 'inf-clojure)~ and
-evaluate Clojure source blocks using [[https://github.com/clojure-emacs/inf-clojure][inf-clojure]]. With a header
-argument like =:alias "alias"= the Clojure REPL will boot with
-=clojure -Aalias=. Otherwise Clojure will boot with =lein=, =boot= or
-=tools.deps=, depending on whether the current directory contains a
-=project.clj=, =build.boot= or =deps.edn=, falling back on
-~inf-clojure-generic-cmd~ in case no such file is present.
-
-Also, when using [[https://github.com/clojure-emacs/cider][cider]], you can now use =#+begin_src clojurescript= to
-execute ClojureScript code from Org files. Note that this works only
-if your Org file is associated with a cider session that knows how to
-run ClojureScript code. A bare =lein repl= session outside of a
-directory configured for ClojureScript will /not/ work.
-
-*** =ob-java.el= supports Java command line arguments
-
-Babel Java blocks recognize header argument =:cmdargs= and pass its
-value in call to =java=.
-
-*** =ob-screen.el= now accepts =:screenrc= header argument
-
-Screen blocks now recognize the =:screenrc= header argument and pass
-its value to the screen command via the "-c" option. The default
-remains =/dev/null= (i.e. a clean screen session)
-
-*** =ob-plantuml=: now supports using PlantUML executable to generate diagrams
-
-Set =org-plantuml-exec-mode= to ='plantuml= in order to use the
-executable instead of JAR. When using an executable it is also
-possible to configure executable location as well as arguments via:
-=org-plantuml-executable-path= and =org-plantuml-executable-args=.
-
-** New commands
-*** ~org-table-header-line-mode~
-
-Turn on a minor mode to display the first data row of the table at
-point in the header-line when the beginning of the table is invisible.
-
-*** ~org-agenda-ctrl-c-ctrl-c~
-
-Hitting =<C-c C-c>= in an agenda view now calls ~org-agenda-set-tags~.
-
-*** ~org-hide-entry~
-
-This command is the counterpart of ~org-show-entry~.
-
-*** ~org-columns-toggle-or-columns-quit~
-
-=<C-c C-c>= bound to ~org-columns-toggle-or-columns-quit~ replaces the
-recent ~org-columns-set-tags-or-toggle~. Tag setting is still
-possible via column view value edit or with =<C-c C-q>=.
-
-*** ~org-datetree-find-month-create~
-
-Find or create a month entry for a date.
-
-** New options and settings
-*** New option ~org-html-prefer-user-labels~
-
-When non-nil, use =NAME= affiliated keyword, or raw target values, to
-generate anchor's ID. Otherwise, consistently use internal naming
-scheme.
-
-=CUSTOM_ID= values are still always used, when available.
-*** New option for using tabs in ~org-agenda-window-setup~
-
-Choosing ~other-tab~ for ~org-agenda-window-setup~ will open the
-agenda view in a new tab. This will work with versions of Emacs since
-27.1 when ~tab-bar-mode~ was introduced.
-
-*** New option ~org-table-header-line-p~
-
-Setting this option to =t= will activate ~org-table-header-line-mode~
-in org-mode buffers.
-
-*** New option ~org-startup-numerated~
-
-When this option is =t=, Org files will start using ~(org-num-mode 1)~
-and headings will be visually numerated.
-
-You can turn this on/off on a per-file basis with =#+startup: num= or
-=#+startup: nonum=.
-
-*** New option ~org-clock-auto-clockout-timer~
-
-When this option is set to a number and the user configuration
-contains =(org-clock-auto-clockout-insinuate)=, Org will clock out the
-currently clocked in task after that number of seconds of idle time.
-
-This is useful when you often forget to clock out before being idle
-and don't want to have to manually set the clocking time to take into
-account.
-
-*** New option to group captured datetime entries by month
-
-A new `:tree-type month' option was added to org-capture-templates to
-group new datetime entries by month.
-
-*** New option to show source buffers using "plain" display-buffer
-
-There is a new option ~plain~ to ~org-src-window-setup~ to show source
-buffers using ~display-buffer~. This allows users to control how
-source buffers are displayed by modifying ~display-buffer-alist~ or
-~display-buffer-base-action~.
-
-*** New option ~org-archive-subtree-save-file-p~
-
-Archiving a subtree used to always save the target archive buffer.
-Commit [[git::b186d1d7][b186d1d7]] changed this behavior by always not saving the target
-buffer, because batch archiving from agenda could take too much time.
-
-This new option ~org-archive-subtree-save-file-p~ defaults to the
-value =from-org= so that archiving a subtree will save the target
-buffer when done from an org-mode buffer, but not from the agenda.
-You can also set this option to =t= or to =from-agenda=.
-
-*** New option ~org-show-notification-timeout~
-
-This option will add a timeout to notifications.
-
-*** New option ~org-latex-to-html-convert-command~
-
-This new option allows you to convert a LaTeX fragment directly into
-HTML.
-
-*** New option ~org-babel-shell-results-defaults-to-output~
-
-By default, source code blocks are executed in "functional mode": it
-means that the results of executing them are the value of their last
-statement (see [[https://orgmode.org/manual/Results-of-Evaluation.html][the documentation]].)
-
-The value of a shell script's execution is its exit code. But most
-users expect the results of executing a shell script to be its output,
-not its exit code.
-
-So we introduced this option, that you can set to nil if you want to
-stick using ~:results value~ as the implicit header.
-
-In all Babel libraries, the absence of a ~:results~ header should
-produce the same result than setting ~:results value~, unless there is
-an option to explicitly create an exception.
-
-See [[msg:CA+A2iZaziAfMeGpBqL6qGrzrWEVvLvC0DUw++T4gCF3NGuW-DQ@mail.gmail.com][this thread]] for more context.
-
-*** New option in ~org-attach-store-link-p~
-
-~org-attach-store-link-p~ has a new option to store a file link to the
-attachment.
-*** New option ~org-fontify-todo-headline~
-
-This feature is the same as ~org-fontify-done-headline~, but for TODO
-headlines instead. This allows you to distinguish TODO headlines from
-normal headlines. The face can be customized via ~org-headline-todo~.
-
-*** New default value for ~org-file-apps~
-
-The new value uses Emacs as the application for opening directory.
-
-*** New hook ~org-agenda-filter-hook~
-
-Functions in this hook are run after ~org-agenda-filter~ is called.
-
-** Removed or renamed functions and variables
-*** Deprecated ~org-flag-drawer~ function
-
-Use ~org-hide-drawer-toggle~ instead.
-
-*** Deprecated ~org-hide-block-toggle-maybe~ function
-
-Use ~org-hide-block-toggle~ instead.
-
-*** Deprecated ~org-hide-block-toggle-all~ function
-
-This function was not used in the code base, and has no clear use
-either. It has been marked for future removal. Please contact the
-mailing list if you use this function.
-
-*** Deprecated ~org-return-indent~ function
-
-In Elisp code, use ~(org-return t)~ instead. Interactively, =C-j= is
-now bound to ~org-return-and-maybe-indent~, which indents the new line
-when ~electric-indent-mode~ is disabled.
-
-*** Removed ~org-maybe-keyword-time-regexp~
-
-The variable was not used in the code base.
-
-*** Removed ~org-export-special-keywords~
-
-The variable was not used in the code base.
-
-*** Renamed ~org-at-property-block-p~
-
-The new name is ~org-at-property-drawer-p~, which is less confusing.
-
-*** Renamed ~org-columns-set-tags-or-toggle~
-
-See [[*~org-columns-toggle-or-columns-quit~]].
-
-*** Renamed priority options
-
-From ~org-lowest-priority~ to ~org-priority-lowest~.
-From ~org-default-priority~ to ~org-priority-default~.
-From ~org-highest-priority~ to ~org-priority-highest~.
-From ~org-enable-priority-commands~ to ~org-priority-enable-commands~.
-From ~org-show-priority~ to ~org-priority-show~.
-
-** Miscellaneous
-*** =ob-screen.el= now respects screen =:session= name
-
-Screen babel session are now named based on the =:session= header
-argument (defaults to ~default~).
-
-Previously all session names had ~org-babel-session-~ prepended.
-
-*** Forward/backward paragraph functions in line with the rest of Emacs
-
-~org-forward-paragraph~ and ~org-backward-paragraph~, bound to
-~<C-UP>~ and ~<C-DOWN>~ functions mimic more closely behaviour of
-~forward-paragraph~ and ~backward-paragraph~ functions when
-available.
-
-They also accept an optional argument for multiple calls.
-
-See their docstring for details.
-*** ~org-table-to-lisp~ no longer checks if point is at a table
-
-The caller is now responsible for the check. It can use, e.g.,
-~org-at-table-p~.
-
-The function is also much more efficient than it used to be, even on
-very large tables.
-
-*** New function ~org-collect-keywords~
-*** Drawers' folding use an API similar to block's
-
-Tooling for folding drawers interactively or programmatically is now
-on par with block folding. In particular, ~org-hide-drawer-toggle~,
-a new function, is the central place for drawer folding.
-
-*** Duration can be read and written in compact form
-
-~org-duration-to-minutes~ understands =1d3h5min= as a duration,
-whereas ~org-duration-from-minutes~ can output this compact form if
-the duration format contains the symbol ~compact~.
-
-*** C-n, C-p, SPC and DEL in agenda commands dispatch window
-
-You can now use =<C-n>=, =<C-p>=, =<SPC>= and =<DEL>= key to scroll up
-and down the agenda and attach dispatch window.
-
-*** =<C-c C-c>= in agenda calls ~org-agenda-set-tags~
-
-Both =<C-c C-q>= and =<C-c C-c>= set the tags of the headline in the
-Org buffer. Both keybindings are now available from the agenda too.
-
-*** Allow to use an empty HTML extension
-
-Using =(setq org-html-extension "")= or setting the HTML extension in
-any fashion will produce the expected output, with no trailing period
-to the resulting HTML file.
-
-*** Handle repeated tasks with =.+= type and hours step
-
-A task using a =.+= repeater and hours step is repeated starting from
-now. E.g.,
-
-#+begin_example
-,,** TODO Wash my hands
- DEADLINE: <2019-04-05 08:00 Sun .+1h>
- Marking this DONE shifts the date to exactly one hour from now.
-#+end_example
-
-*** The format of equation reference in HTML export can now be specified
-
-By default, HTML (via MathJax) and LaTeX export equation references
-using different commands. LaTeX must use ~\ref{%s}~ because it is used
-for all labels; however, HTML (via MathJax) uses ~\eqref{%s}~ for
-equations producing inconsistent output. New option
-~org-html-equation-reference-format~ sets the command used in HTML
-export.
-
-*** =ob-haskell.el= supports compilation with =:compile= header argument
-
-By default, Haskell blocks are interpreted. By adding =:compile yes=
-to a Haskell source block, it will be compiled, executed and the
-results will be displayed.
-
-*** Support for ~org-edit-special~ with LaTeX fragments
-
-Calling ~org-edit-special~ on an inline LaTeX fragment calls a new
-function, ~org-edit-latex-fragment~. This functions in a comparable
-manner to editing inline source blocks, bringing up a minibuffer set
-to LaTeX mode. The math-mode deliminators are read only.
-
-*** ~org-capture-current-plist~ is now accessible during ~org-capture-mode-hook~
-*** New =org-refile.el= file
-
-Org refile variables and functions have been moved to a new file.
-
-*** The end of a 7 years old bug
-
-This bug [[https://lists.gnu.org/archive/html/emacs-orgmode/2013-08/msg00072.html][originally reported]] by Matt Lundin and investigated by Andrew
-Hyatt has been fixed. Thanks to both of them.
-
-* Version 9.3
-
-** Incompatible changes
-*** Change bracket link escaping syntax
-
-Org used to percent-encode sensitive characters in the URI part of the
-bracket links.
-
-Now, escaping mechanism uses the usual backslash character, according
-to the following rules:
-
-1. All =[= and =]= characters in the URI must be escaped;
-2. Every =\= character preceding either =[= or =]= must be escaped;
-3. Every =\= character at the end of the URI must be escaped.
-
-When in doubt, use the function ~org-link-escape~ in order to turn
-a link string into its properly escaped form.
-
-The following function will help switching your links to the new
-syntax:
-
-#+begin_src emacs-lisp
-(defun org-update-link-syntax (&optional no-query)
- "Update syntax for links in current buffer.
-Query before replacing a link, unless optional argument NO-QUERY
-is non-nil."
- (interactive "P")
- (org-with-point-at 1
- (let ((case-fold-search t))
- (while (re-search-forward "\\[\\[[^]]*?%\\(?:2[05]\\|5[BD]\\)" nil t)
- (let ((object (save-match-data (org-element-context))))
- (when (and (eq 'link (org-element-type object))
- (= (match-beginning 0)
- (org-element-property :begin object)))
- (goto-char (org-element-property :end object))
- (let* ((uri-start (+ 2 (match-beginning 0)))
- (uri-end (save-excursion
- (goto-char uri-start)
- (re-search-forward "\\][][]" nil t)
- (match-beginning 0)))
- (uri (buffer-substring-no-properties uri-start uri-end)))
- (when (or no-query
- (y-or-n-p
- (format "Possibly obsolete URI syntax: %S. Fix? "
- uri)))
- (setf (buffer-substring uri-start uri-end)
- (org-link-escape (org-link-decode uri)))))))))))
-#+end_src
-
-The old ~org-link-escape~ and ~org-link-unescape~ functions have been
-renamed into ~org-link-encode~ and ~org-link-decode~.
-
-*** Change match group number in ~org-link-bracket-re~
-
-Link description, if any, is located in match group 2 instead of match
-group 3.
-
-*** ob-clojure does not auto prepend ~(ns ..)~ statement anymore
-
-When tangling, user usually just wants to tangle literally code instead
-of prepend inserting a ~(ns ..)~ statement before source block
-code. Now, when you have no ~:ns~ header argument specified, this
-behavior will not happen automatically.
-
-*** Change in behavior on exit from an Org edit buffer
-
-Org will no longer attempt to restore the window configuration in the
-frame to which the user returns after editing a source block with
-~org-edit-src-code~. Instead, the window configuration will remain as
-it is.
-
-*** Change default value for ~org-email-link-description-format~
-
-When linking from a mail buffer, Org used to truncate the subject of
-the message to 30 characters in order to build the description of the
-link. This behavior was considered as too surprising. As
-a consequence, Org no longer truncates subjects.
-
-You can get the old behavior back with the following:
-
-: (setq org-email-link-description-format "Email %c: %.30s")
-
-*** ~:file~ header argument no longer assume "file" ~:results~
-
-The "file" ~:results~ value is now mandatory for a code block
-returning a link to a file. The ~:file~ or ~:file-ext~ header
-arguments no longer imply a "file" result is expected.
-
-*** Plain numbers are hours in Column View mode
-
-See [[git:3367ac9457]] for details.
-
-*** All LaTeX preview backends use now xcolor
-
-The dvipng backend was previously relying on fg and bg parameters to
-be passed to the CLI. This didn't work when xcolor was directly or
-indirectly used in the document (e.g. tkiz is a user of xcolor). Since
-every other backend was already using xcolor to set fg and bg, the CLI
-alternative was removed and there is no more a :use-xcolor options
-since now it's implicitly always true.
-
-*** Org-Attach Git commit
-
-[[*Org-Attach has been refactored and extended][Refactoring of Org-Attach]] affected the Git commit functionality. Not
-much, but the following changes are required if you still need to
-auto-commit attachments to git:
-
-- Customization of ~org-attach-annex-auto-get~ needs to be renamed to
- ~org-attach-git-annex-auto-get~.
-
-- Customization of ~org-attach-commit~ is no longer needed. Instead
- one need to require the =org-attach-git= module in the startup.
-
-** New features
-*** New option to wrap source code lines in HTML export
-
-When new option ~html-wrap-src-lines~ (with variable
-~org-html-wrap-src-lines~) is non-nil, HTML export wraps source code
-lines in HTML ~code~ elements.
-
-*** New option to handle schedules and deadlines in iCalendar export
-
-Export ignore done tasks with a deadline when
-~org-icalendar-use-deadline~ contains ~event-if-todo-not-done~.
-Likewise, scheduled done tasks are also ignored when
-~org-icalendar-use-scheduled~ contains the same symbol.
-
-*** Add ~split-window-right~ option for src block edit window placement
-
-Given the increasing popularity of wide screen monitors, splitting
-horizontally may make more sense than splitting vertically. An
-option, ~split-window-right~, to request horizontal splitting has been
-added to ~org-src-window-setup~.
-
-*** Org-Attach has been refactored and extended
-
-Org attach has been refactored and the functionality extended. It
-should now be easier to understand how it works. A few improvements
-and extra options have been added as well.
-
-From the initial comment in org-attach source-code:
-
-- Attachments are managed either by using a custom property DIR or by
- using property ID from org-id. When DIR is defined, a location in
- the filesystem is directly attached to the outline node. When
- org-id is used, attachments are stored in a folder named after the
- ID, in a location defined by ~org-attach-id-dir~. DIR has
- precedence over ID when both parameters are defined for the current
- outline node (also when inherited parameters are taken into
- account).
-
-From now on inheritance requires no extra property and will adhere to
-~org-attach-use-inheritance~ by default. Inheritance can be
-customized to always be activated or never be activated in
-~org-attach-use-inheritance~.
-
-The ATTACH_DIR property is deprecated in favor of the shorter
-property DIR. Links to folders inside the DIR property can now be
-declared as relative links. This is not enabled by default, but can
-be set in ~org-attach-dir-relative~.
-
-When adding new attachment to the outline node the preferred way of
-doing so can be customized. Take a look at
-~org-attach-preferred-new-method~. It defaults to using ID since that
-was the behavior before this change.
-
-If both DIR and ID properties are set on the same node, DIR has
-precedence and will be used.
-
-One can now also choose to build attachment-directory-paths in a
-customized way. This is an advanced topic, but in some case it makes
-sense to parse an ID in a different way than the default one. Create
-your own function and add it to the beginning of
-~org-attach-id-to-path-function~list~ if you want to customize the ID
-based folder structure.
-
-If you've used ATTACH_DIR properties to manage attachments, use the
-following code to rename that property to DIR which supports the same
-functionality. ATTACH_DIR_INHERIT is no longer supported and is
-removed.
-
-#+begin_src emacs-lisp
- (defun org-update-attach-properties ()
- "Change properties for Org-Attach."
- (interactive)
- (org-with-point-at 1
- (while (outline-next-heading)
- (let ((DIR (org--property-local-values "ATTACH_DIR" nil)))
- (when DIR
- (org-set-property "DIR" (car DIR))
- (org-delete-property "ATTACH_DIR"))))
- (org-delete-property-globally "ATTACH_DIR_INHERIT")))
-#+end_src
-
-For those who hate breaking changes, even though the changes are made
-to clean things up; fear not. ATTACH_DIR will still continue to work.
-It's just not documented any longer. When you get the chance, run the
-code above to clean things up anyway!
-
-**** New hooks
-Two hooks are added to org-attach:
-- org-attach-after-change-hook
-- org-attach-open-hook
-
-They are added mostly for internal restructuring purposes, but can
-ofc. be used for other things as well.
-
-*** New link-type: Attachment
-
-Attachment-links are now first-class citizens. They mimic file-links
-in everything they do but use the existing attachment-folder as a base
-when expanding the links. Both =DIR= and =ID= properties are used to
-try to resolve the links, in exactly the same way as Org-Attach uses
-those properties.
-
-*** Handle overlay specification for notes in Beamer export
-
-This aligns Beamer notes with slide overlays.
-
-*** Add support for lettered lists in Texinfo
-
-Using =:enum A= or =:enum a= Texinfo attribute switches an otherwise
-numbered list to a lettered list.
-
-*** Add a dispatcher command to insert dynamic blocks
-
-You can add new dynamic blocks with function
-~org-dynamic-block-define~. All such dynamic blocks can be used by
-~org-dynamic-block-insert-dblock~ command.
-
-*** Babel
-
-**** ob-emacs-lisp sets ~lexical-binding~ in Org edit buffers
-
-When editing an Elisp src block, the editing buffer's
-~lexical-binding~ is set according to the src block's =:lexical=
-parameter.
-
-**** Add LaTeX output support in PlantUML
-
-*** New minor mode to display headline numbering
-
-Use =<M-x org-num-mode>= to get a visual indication of the numbering
-in the outline. The numbering is also automatically updated upon
-changes in the buffer.
-
-*** New property =HTML_HEADLINE_CLASS= in HTML export
-
-The new property =HTML_HEADLINE_CLASS= assigns a class attribute to
-a headline.
-
-*** Allow LaTeX attributes and captions for "table.el" tables
-
-Supported LaTeX attributes are ~:float~, ~:center~, ~:font~ and
-~:caption~.
-
-*** Attach buffer contents to headline
-
-With =<b>= key from attachment dispatcher (=<C-c C-a>=), it is now
-possible to write the contents of a buffer to a file in the headline
-attachment directory.
-
-*** iCalendar export respects a =CLASS= property
-
-Set the =CLASS= property on an entry to specify a visibility class for
-that entry only during iCalendar export. The property can be set to
-anything the calendar server supports. The iCalendar standard defines
-the values =PUBLIC=, =CONFIDENTIAL=, =PRIVATE=, which can be
-interpreted as publicly visible, accessible to a specific group, and
-private respectively.
-
-This property can be inherited during iCalendar export, depending on
-the value of ~org-use-property-inheritance~.
-
-*** New parameter for =INCLUDE= keyword
-
-Add =:coding CODING-SYSTEM= to include files using a different coding
-system than the main Org document. For example:
-
-#+begin_example
-,#+INCLUDE: "myfile.cmd" src cmd :coding cp850-dos
-#+end_example
-
-*** New values in clock tables' step: =month= and =year=
-*** ODT export handles numbers cookies in lists
-*** New cell movement functions in tables
-
-~S-<UP>~, ~S-<DOWN>~, ~S-<RIGHT>~, and ~S-<LEFT>~ now move cells in
-the corresponding direction by swapping with the adjacent cell.
-
-*** New option to natively fontify LaTeX snippets and environments
-
-A 'native option was added to org-highlight-latex-and-related. It
-matches the same structures than 'latex but it calls
-org-src-font-lock-fontify-block instead, thus bringing about full
-LaTeX font locking.
-
-*** ~org-clone-subtree-with-time-shift~ learned to shift backward in time
-
-=<C-c C-x c>= (~org-clone-subtree-with-time-shift~) now takes a
-negative value as a valid repeater to shift time stamps in backward
-in cloned subtrees. You can give, for example, ‘-3d’ to shift three
-days in the past.
-
-*** Toggle display of all vs. undone scheduled habits conveniently
-
-=<C-u K>= (~org-habit-toggle-display-in-agenda~) in an agenda toggles
-the display of all habits to those which are undone and scheduled.
-This is a function for convenience.
-
-*** New parameter for SQL Babel blocks: ~:dbconnection~
-
-The new parameter ~:dbconnection~ allows to specify a connection name
-in a SQL block header: this name is used to look up connection
-parameters in ~sql-connection-alist~.
-
-*** New =:scale= attribute supported by LaTeX exporters
-
-The builtin "latex" exporters now accept and use a =:scale= attribute,
-which scales an image by a given factor.
-
-This attribute is wrapped around the =scale= parameter of LaTeX's
-=\includegraphics= (bitmap images) or a TiKZ's =\scalebox=.
-Therefore, its value should be some string palatable to LaTeX as
-a positive float Its default value is an empty string (i.e. disabled).
-
-This attribute overrides the =:width= and =:height= attributes.
-
-#+begin_example
-,#+name: Beastie
-,#+caption: I think I saw this curious horse already, but where ?
-,#+LATEX_ATTR: :scale 2
-[[https://orgmode.org/img/org-mode-unicorn-logo.png]]
-#+end_example
-
-*** Allow specifying the target for a table of contents
-
-The =+TOC= keyword now accepts a =:target:= attribute that specifies
-the headline to use for making the table of contents.
-
-#+begin_example
-,* Target
- :PROPERTIES:
- :CUSTOM_ID: TargetSection
- :END:
-,** Heading A
-,** Heading B
-,* Another section
-,#+TOC: headlines 1 :target "#TargetSection"
-#+end_example
-** New functions
-*** ~org-dynamic-block-insert-dblock~
-
-Use default keybinding =<C-c C-x x>= to run command
-~org-dynamic-block-insert-dblock~. It will prompt user to select
-dynamic block in ~org-dynamic-block-alist~.
-
-*** ~org-table-cell-up~
-*** ~org-table-cell-down~
-*** ~org-table-cell-left~
-*** ~org-table-cell-right~
-*** ~org-habit-toggle-display-in-agenda~
-** Removed functions and variables
-*** Removed Org Drill
-
-You can install it back from MELPA.
-
-*** ~org-babel-set-current-result-hash~
-*** ~org-capture-insert-template-here~
-*** ~org-attach-directory~
-
-It has been deprecated in favor of ~org-attach-id-dir~ which is less
-ambiguous given the restructured org-attach.
-
-*** ~org-enable-fixed-width-editor~
-
-This variable was not used through the code base.
-
-** Miscellaneous
-*** Change signature for ~org-list-to-subtree~
-
-The function now accepts the level of the subtree as an optional
-argument. It no longer deduces it from the current level.
-
-*** LaTeX preview is simplified
-
-Function ~org-latex-preview~, formerly known as
-~org-toggle-latex-fragment~, has a hopefully simpler and more
-predictable behavior. See its docstring for details.
-
-*** ~org-table-copy-down~ supports patterns
-
-When ~org-table-copy-increment~ is non-nil, it is now possible to
-increment fields like =A1=, or =0A=, i.e., any string prefixed or
-suffixed with a whole number.
-
-*** No more special indentation for description items
-
-Descriptions items are indented like regular ones, i.e., text starts
-after the bullet. Special indentation used to introduce bugs when
-inserting sub-items in a description list.
-
-*** New hook: ~org-todo-repeat-hook~
-
-This hook was actually introduced in Org 9.2.1, but wasn't advertised.
-
-*** Org Table reads numbers starting with 0 as strings
-*** Disable fast tag selection interface via prefix arg
-
-A call of ~org-set-tags-command~ with prefix argument C-u C-u avoids
-the fast tag selection interface and instead offers the plain
-interface.
-
-*** ~:mkdirp~ now supports create directory for ~:dir~ path
-
-The ~:mkdirp~ header argument used to only work for ~:tangle~ tangle
-files. Now ~:mkdirp~ works for ~:dir~ too. This is more convenient for
-specify default directory and with ~:file~ header argument.
-
-*** New variable: ~org-agenda-breadcrumbs-separator~
-
-If breadcrumbs are showed in org-agenda with the help of "%b" format
-in ~org-agenda-prefix-format~, user can customize breadcrumbs's
-separator using ~org-agenda-breadcrumbs-separator~.
-
-*** New variable ~org-attach-commands~
-
-This variable makes it possible to customize the list of commands for
-the attachment dispatcher.
-
-*** New ID method based on timestamp
-
-If one chooses, it is now possible to create ID's based on timestamp
-(ISO8601) instead of UUID by changing org-id-method to ts.
-
-For an improved folder structure when using timestamp as ID, make sure
-to promote ~org-attach-id-ts-folder-format~ to the first element of
-~org-attach-id-to-path-function-list~ in your configuration at the
-same time.
-
-*** New customization: ~org-id-locations-relative~
-
-New customization to make the persisting of org-id-locations between
-sessions to store links to files as relative instead of absolute. The
-links will be stored as relative to the path of org-id-locations-file.
-
-*** ~org-ctrl-c-tab~ is functional before the first headline
-
-I.e. treat the whole file as if it was a subtree.
-
-Also fold everything below the chosen level. Former behavior was to
-leave unfolded subtrees unfolded.
-
-*** ~org-kill-note-or-show-branches~ is functional before the first headline
-
-I.e. treat the whole file as if it was a subtree.
-
-*** Respect narrowing when agenda command is restricted to buffer
-
-*** ~org-table-insert-column~ inserts the column at point position
-
-Before, the new column was inserted to the right of the column at
-point position.
-
-*** Table column deletion now consistent with row deletion
-
-Point stays in the column at deletion, except when deleting the
-rightmost column.
-
-* Version 9.2
-** Incompatible changes
-*** Removal of OrgStruct mode mode and radio lists
-
-OrgStruct minor mode and radio lists mechanism (~org-list-send-list~
-and ~org-list-radio-lists-templates~) are removed from the code base.
-
-Note that only radio /lists/ have been removed, not radio tables.
-
-If you want to manipulate lists like in Org in other modes, we suggest
-to use =orgalist.el=, which you can install from GNU ELPA.
-
-If you want to use Org folding outside of Org buffers, you can have a
-look at the outshine package in the MELPA repository.
-
-*** Change in the structure template expansion
-
-Org 9.2 comes with a new template expansion mechanism, combining
-~org-insert-structure-template~ bound to ~C-c C-,~.
-
-If you customized the ~org-structure-template-alist~ option manually,
-you probably need to update it, see the docstring for accepted values.
-
-If you prefer using previous patterns, e.g. =<s=, you can activate
-them again by requiring Org Tempo library:
-
-: (require 'org-tempo)
-
-or add it to ~org-modules~.
-
-If you need complex templates, look at the ~tempo-define-template~
-function or at solutions like Yasnippet.
-
-*** Change to Noweb expansion
-
-Expansion check =:noweb-ref= only if no matching named block is found
-in the buffer. As a consequence, any =:noweb-ref= value matching the
-name of a source block in the buffer is ignored. A simple fix is to
-give every concerned source-block, including the named one, a new,
-unique, Noweb reference.
-
-#+BEGIN_SRC org
- ,#+NAME: foo
- ,#+BEGIN_SRC emacs-lisp
- 1
- ,#+END_SRC
-
- ,#+BEGIN_SRC emacs-lisp :noweb-ref foo
- 2
- ,#+END_SRC
-
- ,#+BEGIN_SRC emacs-lisp :noweb yes
- <<foo>>
- ,#+END_SRC
-#+END_SRC
-
-should become
-
-#+BEGIN_SRC org
- ,#+NAME: foo
- ,#+BEGIN_SRC emacs-lisp :noweb-ref bar
- 1
- ,#+END_SRC
-
- ,#+BEGIN_SRC emacs-lisp :noweb-ref bar
- 2
- ,#+END_SRC
-
- ,#+BEGIN_SRC emacs-lisp :noweb yes
- <<bar>>
- ,#+END_SRC
-#+END_SRC
-
-*** Default/accepted values of ~org-calendar-to-agenda-key~
-
-The default value and accepted value of ~org-calendar-to-agenda-key~
-changed. This is an excerpt of the new docstring:
-
-: When set to ‘default’, bind the function to ‘c’, but only if it is
-: available in the Calendar keymap. This is the default choice because
-: ‘c’ can then be used to switch back and forth between agenda and calendar.
-:
-: When nil, ‘org-calendar-goto-agenda’ is not bound to any key.
-
-Check the full docstring for more.
-
-*** Change the signature of the ~org-set-effort~ function
-
-Here is the new docstring:
-
-: (org-set-effort &optional INCREMENT VALUE)
-:
-: Set the effort property of the current entry.
-: If INCREMENT is non-nil, set the property to the next allowed
-: value. Otherwise, if optional argument VALUE is provided, use
-: it. Eventually, prompt for the new value if none of the previous
-: variables is set.
-
-*** Placeholders in =(eval ...)= macros are always strings
-
-Within =(eval ...)= macros, =$1=-like placeholders are always replaced
-with a string. As a consequence, they must not be enclosed within
-quotes. As an illustration, consider the following, now valid,
-examples:
-
-#+begin_example
- ,#+macro: join (eval (concat $1 $2))
- ,#+macro: sum (eval (+ (string-to-number $1) (string-to-number $2)))
-
- {{{join(a,b)}}} => ab
- {{{sum(1,2)}}} => 3
-#+end_example
-
-However, there is no change in non-eval macros:
-
-#+begin_example
- ,#+macro: disp argument: $1
-
- {{{disp(text)}}} => argument: text
-#+end_example
-
-*** =align= STARTUP value no longer narrow table columns
-
-Columns narrowing (or shrinking) is now dynamic. See [[*Dynamically
-narrow table columns]] for details. In particular, it is decoupled from
-aligning.
-
-If you need to automatically shrink columns upon opening an Org
-document, use =shrink= value instead, or in addition to align:
-
-#+BEGIN_EXAMPLE
-,#+STARTUP: align shrink
-#+END_EXAMPLE
-
-*** ~org-get-tags~ meaning change
-
-Function ~org-get-tags~ used to return local tags to the current
-headline. It now returns all the inherited tags in addition to the
-local tags. In order to get the old behavior back, you can use:
-
-: (org-get-tags nil t)
-
-*** Alphabetic sorting in tables and lists
-
-When sorting alphabetically, ~org-table-sort-lines~ and ~org-sort-list~
-now sort according to the locale’s collation rules instead of by
-code-point.
-
-*** Change the name of the :tags clocktable option to :match
-
-The =:match= (renamed from =:tags=) option allows to limit clock entries
-to those matching a todo-tags matcher.
-
-The old =:tags= option can be set to =t= to display a headline's tags in a
-dedicated column.
-
-This is consistent with the naming of =org-dblock-write:columnview=
-options, where =:match= is also used as a headlines filter.
-
-** New features
-*** Add ~:session~ support of ob-clojure for CIDER
-You can initialize source block session with Babel default keybinding
-=[C-c C-v C-z]= to use =sesman= session manager to link current
-project, directory or buffer with specific Clojure session, or
-=cider-jack-in= a new CIDER REPL if no CIDER REPLs available. In older
-CIDER version which has not =sesman= integrated, only has
-=cider-jack-in= without Clojure project is supported.
-#+begin_src clojure :session
-(dissoc Clojure 'JVM)
-(conj clojurists "stardiviner")
-#+end_src
-*** Add ~:results link~ support for Babel
-
-With this output format, create a link to the file specified in
-~:file~ header argument, without actually writing any result to it:
-
-#+begin_example
-,#+begin_src shell :dir "data/tmp" :results link :file "crackzor_1.0.c.gz"
-wget -c "https://ben.akrin.com/crackzor/crackzor_1.0.c.gz"
-,#+end_src
-
-,#+results:
-[[file:data/tmp/crackzor_1.0.c.gz]]
-#+end_example
-
-*** Add ~:session~ support of ob-js for js-comint
-#+begin_src js :session "*Javascript REPL*"
-console.log("stardiviner")
-#+end_src
-*** Add ~:session~ support of ob-js for Indium
-#+begin_src js :session "*JS REPL*"
-console.log("stardiviner")
-#+end_src
-*** Add ~:session~ support of ob-js for skewer-mode
-#+begin_src js :session "*skewer-repl*"
-console.log("stardiviner")
-#+end_src
-*** Add support for links to LaTeX equations in HTML export
-Use MathJax links when enabled (by ~org-html-with-latex~), otherwise
-add a label to the rendered equation.
-*** Org Tempo may used for snippet expansion of structure template.
-See manual and the commentary section in ~org-tempo.el~ for details.
-*** Exclude unnumbered headlines from table of contents
-Set their =UNNUMBERED= property to the special =notoc= value. See
-manual for details.
-*** ~org-archive~ functions update status cookies
-
-Archiving headers through ~org-archive-subtree~ and
-~org-archive-to-archive-sibling~ such as the ones listed below:
-
-#+BEGIN_SRC org
- ,* Top [1/2]
- ,** DONE Completed
- ,** TODO Working
-#+END_SRC
-
-Will update the status cookie in the top level header.
-
-*** Disable =org-agenda-overriding-header= by setting to empty string
-
-The ~org-agenda-overriding-header~ inserted into agenda views can now
-be disabled by setting it to an empty string.
-
-*** Dynamically narrow table columns
-
-With ~C-c TAB~, it is now possible to narrow a column to the width
-specified by a width cookie in the column, or to 1 character if there
-is no such cookie. The same keybinding expands a narrowed column to
-its previous state.
-
-Editing the column automatically expands the whole column to its full
-size.
-
-*** =org-columns-summary-types= entries can take an optional COLLECT function
-
-You can use this to make collection of a property from an entry
-conditional on another entry. E.g. given this configuration:
-
-#+BEGIN_SRC emacs-lisp
- (defun custom/org-collect-confirmed (property)
- "Return `PROPERTY' for `CONFIRMED' entries"
- (let ((prop (org-entry-get nil property))
- (confirmed (org-entry-get nil "CONFIRMED")))
- (if (and prop (string= "[X]" confirmed))
- prop
- "0")))
-
- (setq org-columns-summary-types
- '(("X+" org-columns--summary-sum
- custom/org-collect-confirmed)))
-#+END_SRC
-
-You can have a file =bananas.org= containing:
-
-#+BEGIN_SRC org
- ,#+columns: %ITEM %CONFIRMED %Bananas{+} %Bananas(Confirmed Bananas){X+}
-
- ,* All shipments
- ,** Shipment 1
- :PROPERTIES:
- :CONFIRMED: [X]
- :Bananas: 4
- :END:
-
- ,** Shipment 2
- :PROPERTIES:
- :CONFIRMED: [ ]
- :BANANAS: 7
- :END:
-#+END_SRC
-
-... and when going to the top of that file and entering column view
-you should expect to see something like:
-
-| ITEM | CONFIRMED | Bananas | Confirmed Bananas |
-|---------------+-----------+---------+-------------------|
-| All shipments | | 11 | 4 |
-| Shipment 1 | [X] | 4 | 4 |
-| Shipment 2 | [ ] | 7 | 7 |
-
-#+BEGIN_EXAMPLE
- ,#+STARTUP: shrink
-#+END_EXAMPLE
-*** Allow to filter by tags/property when capturing colview
-
-You can now use =:match= to filter entries using a todo/tags/properties
-matcher.
-
-*** Add support for Oracle's database alias in Babel blocks
-=ob-sql= library already support running SQL blocks against an Oracle
-database using ~sqlplus~. Now it's possible to use alias names
-defined in =TNSNAMES= file instead of specifying full connection
-parameters. See example below.
-
-#+BEGIN_SRC org
- you can use the previous full connection parameters
- ,#+BEGIN_SRC sql :engine oracle :dbuser me :dbpassword my_insecure_password :database my_db_name :dbhost my_db_host :dbport 1521
- select sysdate from dual;
- ,#+END_SRC
-
- or the alias defined in your TNSNAMES file
- ,#+BEGIN_SRC sql :engine oracle :dbuser me :dbpassword my_insecure_password :database my_tns_alias
- select sysdate from dual;
- ,#+END_SRC
-#+END_SRC
-
-*** ~org-agenda-set-restriction-lock~ toggle agenda restriction at point
-
-You can set an agenda restriction lock with =C-x C-x <= or with =<= at the
-beginning of a headline when using Org speed commands. Now, if there
-is already a restriction at point, hitting =<= again (or =C-x C-x <=) will
-remove it.
-
-*** Headlines can now link to themselves in HTML export
-
-When enabling ~org-html-self-link-headlines~ the headlines exported to
-HTML contain a hyperlink to themselves.
-
-** New commands and functions
-
-*** ~org-insert-structure-template~
-
-This function can be used to wrap existing text of Org elements in
-a #+BEGIN_FOO/#+END_FOO block. Bound to C-c C-x w by default.
-
-*** ~org-export-excluded-from-toc-p~
-
-See docstring for details.
-
-*** ~org-timestamp-to-time~
-*** ~org-timestamp-from-string~
-*** ~org-timestamp-from-time~
-*** ~org-attach-dired-to-subtree~
-
-See docstring for details.
-
-*** ~org-toggle-narrow-to-subtree~
-
-Toggle the narrowing state of the buffer: when in a narrowed state,
-widen, otherwise call ~org-narrow-to-subtree~ to narrow.
-
-This is attached to the "s" speed command, so that hitting "s" twice
-will go back to the widen state.
-
-*** ~org-browse-news~
-
-Browse https://orgmode.org/Changes.html to let users read information
-about the last major release.
-
-There is a new menu entry for this in the "Documentation" menu item.
-
-*** ~org-info-find-node~
-
-From an Org file or an agenda switch to a suitable info page depending
-on the context.
-
-The function is bound to =C-c C-x I=.
-
-** Removed commands and functions
-*** ~org-outline-overlay-data~
-Use ~org-save-outline-visibility~ instead.
-*** ~org-set-outline-overlay-data~
-Use ~org-save-outline-visibility~ instead.
-*** ~org-get-string-indentation~
-It was not used throughout the code base.
-*** ~org-fix-indentation~
-It was not used throughout code base.
-*** ~org-context-p~
-Use ~org-element-at-point~ instead.
-*** ~org-preserve-lc~
-It is no longer used in the code base.
-*** ~org-try-structure-completion~
-Org Tempo may be used as a replacement. See details above.
-** Removed options
-
-*** org-babel-use-quick-and-dirty-noweb-expansion
-
-See [[*Change to Noweb expansion][Change to Noweb expansion]] for explanations.
-
-** Miscellaneous
-
-*** New default value for ~org-texinfo-table-scientific-notation~
-
-It is now nil, which means numbers in scientific notation are not
-handled specially by default.
-
-*** New default value for ~org-latex-table-scientific-notation~
-
-It is now nil, which means numbers in scientific notation are not
-handled specially by default.
-
-*** New face: ~org-upcoming-distant-deadline~
-
-It is meant to be used as the face for distant deadlines, see
-~org-agenda-deadline-faces~
-
-*** ~org-paste-subtree~ no longer breaks sections
-
-Unless point is at the beginning of a headline, ~org-paste-subtree~
-now pastes the tree before the next visible headline. If you need to
-break the section, use ~org-yank~ instead.
-
-*** ~org-table-insert-column~ inserts a column to the right
-
-It used to insert it on the left. With this change,
-~org-table-insert-column~ and ~org-table-delete-column~ are
-reciprocal.
-
-*** ~org-publish-resolve-external-link~ accepts a new optional argument.
-*** ~org-irc.el~ now supports exporting =irc:= links properly
-
-Previously, irc links were exported by ~ox-md~ and ~ox-html~ as normal
-file links, which lead to them being broken in web browsers. Now both
-of these exporters will properly export to =irc:= links, which will
-open properly in irc clients from web browsers.
-
-*** ~org-comment-dwim~ (bound to =M-;=) now comments headings, if point is on a heading
-*** Add support for open source block in window below
-
-Set option ~org-src-window-setup~ to ~split-window-below~.
-
-*** Alphabetic sorting in headings and tags now uses the locale’s sorting rules
-
-When sorting alphabetically, ~org-sort-entries~ and
-~org-tags-sort-function~ now sort according to the locale’s collation
-rules instead of by code-point.
-*** New speed command "k" to kill (cut) the subtree at point
-* Version 9.1
-
-** Incompatible changes
-
-*** Variables relative to clocksum duration are obsolete
-
-~org-time-clocksum-format~, ~org-time-clocksum-use-fractional~ and
-~org-time-clocksum-fractional-format~ are obsolete. If you changed
-them, consider modifying ~org-duration-format~ instead.
-
-Variable ~org-time-clocksum-use-effort-durations~ is also obsolete.
-Consider setting ~org-duration-units~ instead.
-
-*** ~org-at-timestamp-p~ optional argument accepts different values
-
-See docstrings for the allowed values. For backward compatibility,
-~(org-at-timestamp-p t)~ is still supported, but should be updated
-accordingly.
-
-*** ~org-capture-templates~ no longer accepts S-expressions as file names
-
-Since functions are allowed there, a straightforward way to migrate
-is to turn, e.g.,
-
-: (file (sexp))
-
-into
-
-: (file (lambda () (sexp)))
-
-*** Deleted contributed packages
-
-=org-ebib.el, =org-bullets.el= and =org-mime.el= have been deleted
-from the contrib/ directory.
-
-You can now find them here :
-
-- https://github.com/joostkremers/ebib
-- https://github.com/sabof/org-bullets
-- https://github.com/org-mime/org-mime
-
-*** Change ~org-texinfo-classes~ value
-The value cannot support functions to create sectioning commands
-anymore. Also, the sectioning commands should include commands for
-appendices. See the docstring for more information.
-*** Removal of ~:sitemap-sans-extension~
-
-The publishing property is no longer recognized, as a consequence of
-changes to site-map generation.
-
-You can get the same functionality by setting ~:sitemap-format-entry~
-to the following
-
-#+BEGIN_SRC elisp
-(lambda (entry style project)
- (cond ((not (directory-name-p entry))
- (format "[[file:%s][%s]]"
- (file-name-sans-extension entry)
- (org-publish-find-title entry project)))
- ((eq style 'tree) (file-name-nondirectory (directory-file-name entry)))
- (t entry)))
-#+END_SRC
-
-*** Change signature for ~:sitemap-function~
-
-~:sitemap-function~ now expects to be called with two arguments. See
-~org-publish-project-alist~ for details.
-
-*** Change signature for some properties in ~org-list-to-generic~
-
-~:istart~, ~:icount~, ~:iend~ and ~:isep~ now expect the type of the
-list as their first argument.
-
-*** Change signature for ~org-get-repeater~
-The optional argument is now a string to extract the repeater from.
-See docstring for details.
-
-*** Change signature for ~org-time-string-to-time~
-See docstring for changes.
-
-*** Change order of items in ~org-agenda-time-grid~
-~org-agenda-time-grid~ gained an extra item to allow users to customize
-the string displayed after times in the agenda. See docstring for
-details.
-
-*** ~tags-todo~ custom searches now include DONE keywords
-
-Use "/!" markup when filtering TODO keywords to get only not-done TODO
-keywords.
-
-*** ~org-split-string~ returns ~("")~ when called on an empty string
-
-It used to return nil.
-
-*** Removal of =ob-scala.el=
-
-See [[https://github.com/ensime/emacs-scala-mode/issues/114][this github issue]].
-
-You can use =ob-scala.el= as packaged in scala-mode, available from the
-MELPA repository.
-
-** New features
-*** iCalendar export uses inheritance for TIMEZONE and LOCATION properties
-Both these properties can be inherited during iCalendar export,
-depending on the value of ~org-use-property-inheritance~.
-*** iCalendar export respects a TIMEZONE property
-Set the TIMEZONE property on an entry to specify a time zone for that
-entry only during iCalendar export. The property value should be
-specified as in "Europe/London".
-*** ~org-attach~ can move directory contents
-When setting a new directory for an entry, org-attach offers to move
-files over from the old directory. Using a prefix arg will reset the
-directory to old, ID based one.
-*** New Org duration library
-This new library implements tools to read and print time durations in
-various formats (e.g., "H:MM", or "1d 2h 3min"...).
-
-See ~org-duration-to-minutes~ and ~org-duration-from-minutes~
-docstrings.
-
-*** Agenda
-**** New variable : ~org-agenda-show-future-repeats~
-**** New variable : ~org-agenda-prefer-last-repeat~
-**** New variable : ~org-deadline-past-days~
-See docstring for details.
-**** Binding C-c C-x < for ~org-agenda-set-restriction-lock-from-agenda~
-**** New auto-align default setting for =org-agenda-tags-column=
-
-=org-agenda-tags-column= can now be set to =auto=, which will
-automatically align tags to the right edge of the window. This is now
-the default setting.
-*** New value for ~org-publish-sitemap-sort-folders~
-
-The new ~ignore~ value effectively allows toggling inclusion of
-directories in published site-maps.
-
-*** Babel
-
-**** Scheme: support for tables
-**** Scheme: new variable: ~org-babel-scheme-null-to~
-
-This new custom option allows you to use an empty list or null symbol to
-format the table output, initially assigned to ~hlines~.
-
-**** Scheme: new header ~:prologue~
-
-A new block code header has been created for Org Babel that enables
-developers to prepend code to the scheme block being processed.
-
-Multiple ~:prologue~ headers can be added each of them using a string
-with the content to be added.
-
-The scheme blocks are prepared by surrounding the code in the block
-with a let form. The content of the ~:prologue~ headers are prepended
-before this let form.
-
-**** Support for hledger accounting reports added
-**** Clojure: new setting ~org-babel-clojure-sync-nrepl-timeout~
-
-Creation of a new setting to specify the Cider timeout. By setting
-the =org-babel-clojure-sync-nrepl-timeout= setting option. The value
-is in seconds and if set to nil then no timeout will occur.
-
-**** Clojure: new header ~:show-process~
-
-A new block code header has been created for Org Babel that enables
-developers to output the process of an ongoing process into a new
-window/buffer.
-
-You can tell Org Babel to output the process of a running code block.
-
-To show that output you only have to specify the =:show-process=
-option in the code block's header like this:
-
-#+begin_example
-,#+BEGIN_SRC clojure :results output :show-process t
- (dotimes [n 10]
- (println n ".")
- (Thread/sleep 500))
-,#+END_SRC
-#+end_example
-
-If =:show-process= is specified that way, then when you will run the
-code using =C-c C-c= a new window will open in Emacs. Everything that
-is output by the REPL will immediately be added to that new window.
-
-When the processing of the code is finished, then the window and its
-buffer will be closed and the results will be reported in the
-=#+RESULTS= section.
-
-Note that the =:results= parameter's behavior is *not* changed. If
-=silent= is specified, then no result will be displayed. If =output=
-is specified then all the output from the window will appears in the
-results section. If =value= is specified, then only the last returned
-value of the code will be displayed in the results section.
-
-**** Maxima: new headers ~:prologue~ and ~:epilogue~
-Babel options ~:prologue~ and ~:epilogue~ have been implemented for
-Maxima source blocks which prepend and append, respectively, the given
-code strings. This can be useful for specifying formatting settings
-which would add clutter to exported code. For instance, you can use
-this ~:prologue "fpprintprec: 2; linel: 50;"~ for presenting Maxima
-results in a beamer presentation.
-**** PlantUML: add support for header arguments
-
-[[https://plantuml.com/][Plantuml]] source blocks now support the [[https://orgmode.org/manual/prologue.html#prologue][~:prologue~]], [[https://orgmode.org/manual/epilogue.html#epilogue][~:epilogue~]] and
-[[https://orgmode.org/manual/var.html#var][~:var~]] header arguments.
-
-**** SQL: new engine added ~sqsh~
-
-A new engine was added to support ~sqsh~ command line utility for use
-against Microsoft SQL Server or Sybase SQL server.
-
-More information on ~sqsh~ can be found here: [[https://sourceforge.net/projects/sqsh/][sourceforge/sqsh]]
-
-To use ~sqsh~ in an *sql* =SRC_BLK= set the =:engine= like this:
-
-#+begin_example
-,#+BEGIN_SRC sql :engine sqsh :dbhost my_host :dbuser master :dbpassword pass :database support
-Select * From Users
-Where clue > 0
-,#+END_SRC
-#+end_example
-
-**** SQL: new engine added =vertica=
-
-A new engine was added to support vsql command line utility for use
-against HP Vertica.
-
-More information on =vsql= can be found here: [[https://my.vertica.com/docs/7.2.x/HTML/index.htm#Authoring/ConnectingToHPVertica/vsql/UsingVsql.htm][my.vertica.com]]
-
-To use =vertica= in an sql =SRC_BLK= set the =:engine= like this:
-
-#+BEGIN_EXAMPLE
- ,#+BEGIN_SRC sql :engine vertica :dbhost my_host :dbuser dbadmin :dbpassword pw :database vmart
- SELECT * FROM nodes;
- ,#+END_SRC
-#+END_EXAMPLE
-**** C++: New header ~:namespaces~
-
-The new ~:namespaces~ export option can be used to specify namespaces
-to be used within a C++ org source block. Its usage is similar to
-~:includes~, in that it can accept multiple, space-separated
-namespaces to use. This header is equivalent to adding ~using
-namespace <name>;~ in the source block. Here is a "Hello World" in C++
-using ~:namespaces~:
-
-#+begin_example
- ,#+BEGIN_SRC C++ :results output :namespaces std :includes <iostream>
- cout << "Hello World" << endl;
- ,#+END_SRC
-#+end_example
-
-**** Support for Vala language
-
-[[https://wiki.gnome.org/Projects/Vala][Vala]] language blocks support two special header arguments:
-
-- ~:flags~ passes arguments to the compiler
-- ~:cmdline~ passes commandline arguments to the generated executable
-
-Support for [[https://orgmode.org/manual/var.html#var][~:var~]] does not exist yet, also there is no [[https://orgmode.org/manual/session.html#session][~:session~]]
-support because Vala is a compiled language.
-
-The Vala compiler binary can be changed via the ~defcustom~
-~org-babel-vala-compiler~.
-
-*** New ~function~ scope argument for the Clock Table
-Added a nullary function that returns a list of files as a possible
-argument for the scope of the clock table.
-*** Export
-**** Implement vernacular table of contents in Markdown exporter
-Global table of contents are generated using vanilla Markdown syntax
-instead of HTML. Also #+TOC keyword, including local table of
-contents, are now supported.
-**** Add Slovenian translations
-**** Implement ~org-export-insert-image-links~
-This new function is meant to be used in back-ends supporting images
-as descriptions of links, a.k.a. image links. See its docstring for
-details.
-**** New macro : ~{{{n}}}~
-This macro creates and increment multiple counters in a document. See
-manual for details.
-**** Add global macros through ~org-export-global-macros~
-With this variable, one can define macros available for all documents.
-**** New keyword ~#+EXPORT_FILE_NAME~
-Similarly to ~:EXPORT_FILE_NAME:~ property, this keyword allows the
-user to specify the name of the output file upon exporting the
-document. This also has an effect on publishing.
-**** Horizontal rules are no longer ignored in LaTeX table math mode
-**** Use ~compilation-mode~ for compilation output
-**** Plain lists accept a new ~:separator~ attribute in Texinfo
-
-The new ~:separator~ attribute splits a tag from a description list
-item into multiple parts. This allows to have two-column tables with
-multiple entries in the first column. See manual for more details.
-
-**** ~latex-environment~ elements support ~caption~ keywords for LaTeX export
-*** ~org-edit-special~ can edit LaTeX environments
-
-Using ~C-c '~ on a LaTeX environment opens a sub-editing buffer. By
-default, major mode in that buffer is ~latex-mode~, but it can be
-changed by configuring ~org-src-lang-modes~.
-
-*** ~org-list-to-generic~ includes a new property: ~:ifmt~
-
-~:ifmt~ is a function to be called on the body of each item. See
-~org-list-to-generic~ documentation for details.
-
-*** New variable : ~org-bibtex-headline-format-function~
-This allow to use a different title than entry title.
-
-*** ~org-attach~ supports attaching files from URLs
-
-Using ~C-c C-a u~ prompts for a URL pointing to a file to be attached
-to the document.
-
-*** New option for ~org-refile-use-outline-path~
-~org-refile-use-outline-path~ now supports the setting ~buffer-name~,
-which causes refile targets to be prefixed with the buffer’s
-name. This is particularly useful when used in conjunction with
-~uniquify.el~.
-
-*** ~org-file-contents~ now allows the FILE argument to be a URL.
-This allows ~#+SETUPFILE:~ to accept a URL instead of a local file
-path. The URL contents are auto-downloaded and saved to a temporary
-cache ~org--file-cache~. A new optional argument ~NOCACHE~ is added
-to ~org-file-contents~.
-
-*** ~org-mode-restart~ now resets the newly added ~org--file-cache~.
-Using ~C-c C-c~ on any keyword (like ~#+SETUPFILE~) will reset the
-that file cache.
-
-*** New option : ~org-table-duration-hour-zero-padding~
-This variable allow computed durations in tables to be zero-padded.
-
-*** New mode switch for table formulas : =U=
-This mode omits seconds in durations.
-
-** Removed functions
-
-*** Org Timeline
-
-This feature has been removed. Use a custom agenda view, possibly
-narrowed to current buffer to achieve a similar functionality.
-
-*** ~org-agenda-skip-entry-when-regexp-matches~ is obsolete
-
-Use ~org-agenda-skip-if~ instead.
-
-*** ~org-agenda-skip-subtree-when-regexp-matches~ is obsolete
-
-Use ~org-agenda-skip-if~ instead.
-
-*** ~org-agenda-skip-entry-when-regexp-matches-in-subtree~ is obsolete
-
-Use ~org-agenda-skip-if~ instead.
-
-*** ~org-minutes-to-clocksum-string~ is obsolete
-
-Use ~org-duration-from-minutes~ instead.
-
-*** ~org-hh:mm-string-to-minutes~ is obsolete
-
-Use ~org-duration-to-minutes~ instead.
-
-*** ~org-duration-string-to-minutes~ is obsolete
-
-Use ~org-duration-to-minutes~ instead.
-
-*** ~org-gnus-nnimap-cached-article-number~ is removed.
-
-This function relied on ~nnimap-group-overview-filename~, which was
-removed from Gnus circa September 2010.
-
-** Removed options
-
-*** ~org-agenda-repeating-timestamp-show-all~ is removed.
-
-For an equivalent to a nil value, set ~org-agenda-show-future-repeats~
-to nil and ~org-agenda-prefer-last-repeat~ to =t=.
-
-*** ~org-gnus-nnimap-query-article-no-from-file~ is removed.
-
-This variable has no effect, as it was relying on a function that was
-removed from Gnus circa September 2010.
-
-*** ~org-usenet-links-prefer-google~ is obsolete.
-
-Use ~org-gnus-prefer-web-links~ instead.
-
-*** ~org-publish-sitemap-file-entry-format~ is deprecated
-
-One can provide new ~:sitemap-format-entry~ property for a function
-equivalent to the removed format string.
-
-*** ~org-enable-table-editor~ is removed.
-
-Setting it to a nil value broke some other features (e.g., speed
-keys).
-
-*** ~org-export-use-babel~ cannot be set to ~inline-only~
-
-The variable is now a boolean.
-
-*** ~org-texinfo-def-table-markup~ is obsolete
-
-Use ~org-texinfo-table-default-markup~ instead.
-
-** New functions
-
-*** ~org-publish-find-property~
-
-This function can be used as a tool to format entries in a site-map,
-in addition to ~org-publish-find-title~ and ~org-publish-find-date~.
-
-*** ~org-list-to-org~
-
-It is the reciprocal of ~org-list-to-lisp~, which see.
-
-*** ~org-agenda-set-restriction-lock-from-agenda~
-
-Call ~org-agenda-set-restriction-lock~ from the agenda.
-
-** Miscellaneous
-
-*** The Library of Babel now on Worg
-
-The library-of-babel.org used to be accessible from the =doc/=
-directory, distributed with Org’s core. It is now accessible
-from the Worg community-driven documentation [[https://orgmode.org/worg/library-of-babel.html][here]].
-
-If you want to contribute to it, please see [[https://orgmode.org/worg/org-contribute.html][how to contribute]].
-
-*** Allow multiple columns view
-
-Columns view is not limited to a single buffer anymore.
-*** Org Attach obeys ~dired-dwim-target~
-
-When a Dired buffer is opened next to the Org document being edited,
-the prompt for file to attach can start in the Dired buffer's
-directory if `dired-dwim-target' in non-nil.
-
-*** ~org-fill-paragraph~ can now fill a whole region
-*** More specific anniversary descriptions
-
-Anniversary descriptions (used in the agenda view, for instance)
-include the point in time, when the anniversary appears. This is,
-in its most general form, just the date of the anniversary. Or
-more specific terms, like "today", "tomorrow" or "in n days" are
-used to describe the time span.
-
-This feature allows to automatically change the description of an
-anniversary, depending on if it occurs in the next few days or
-far away in the future.
-
-*** Computed dates in tables appear as inactive time stamps
-
-*** Save point before opening a file with an unknown search option
-
-When following a file link with a search option (e.g., =::#custom-id=)
-that doesn't exist in the target file, save position before raising an
-error. As a consequence, it is possible to jump back to the original
-document with ~org-mark-ring-goto~ (default binding =C-c &=).
-
-*** ~org-get-heading~ accepts two more optional arguments
-
-See docstring for details.
-
-*** New option ~org-babel-uppercase-example-markers~
-
-This variable is a ~defcustom~ and replaces the variable
-~org-babel-capitalize-example-region-markers~, which is a ~defvar~ and
-is now obsolete.
-*** =INCLUDE= keywords in commented trees are now ignored.
-*** Default value for ~org-texinfo-text-markup-alist~ changed.
-
-Now ~=...=~ markup uses ~@samp{}~ instead of ~@verb{}~. You can use
-~@verb{}~ again by customizing the variable.
-
-*** Texinfo exports example blocks as ~@example~
-*** Texinfo exports inline source blocks as ~@code{}~
-*** Texinfo default table markup is ~@asis~
-
-It used to be ~@samp~ but ~@asis~ is neutral and, therefore, more
-suitable as a default value.
-
-*** Texinfo default process includes ~--no-split~ option
-*** New entities : ~\dollar~ and ~\USD~
-*** Support for date style URLs in =org-protocol://open-source=
-
-URLs like =https://cool-blog.com/2017/05/20/cool-post/= are covered by
-rewrite rules.
-
-*** Add (C) =COMMENT= support to ~org-structure-template-alist~
-
-* Version 9.0
-
-** Incompatible changes
-
-*** Emacs 23 support has been dropped
-
-From now on, Org expects at least Emacs 24.3, although Emacs 24.4 or
-above is suggested.
-
-*** XEmacs support has been dropped
-
-Incomplete compatibility layer with XEmacs has been removed. If you
-want to take over maintenance of this compatibility, please contact
-our mailing list.
-
-*** New syntax for export blocks
-
-Export blocks are explicitly marked as such at the syntax level to
-disambiguate their parsing from special blocks. The new syntax is
-
-#+BEGIN_SRC org
-,#+BEGIN_EXPORT backend
-...
-,#+END_EXPORT
-#+END_SRC
-
-instead of
-
-#+BEGIN_SRC org
-,#+BEGIN_backend
-...
-,#+END_backend
-#+END_SRC
-
-As a consequence, =INCLUDE= keywords syntax is modified, e.g.,
-
-#+BEGIN_SRC org
-,#+INCLUDE: "file.org" HTML
-#+END_SRC
-
-becomes
-
-#+BEGIN_SRC org
-,#+INCLUDE: "file.org" export html
-#+END_SRC
-
-The following function repairs export blocks and =INCLUDE= keywords
-using previous syntax:
-
-#+BEGIN_SRC emacs-lisp
-(defun org-repair-export-blocks ()
- "Repair export blocks and INCLUDE keywords in current buffer."
- (interactive)
- (when (eq major-mode 'org-mode)
- (let ((case-fold-search t)
- (back-end-re (regexp-opt
- '("HTML" "ASCII" "LATEX" "ODT" "MARKDOWN" "MD" "ORG"
- "MAN" "BEAMER" "TEXINFO" "GROFF" "KOMA-LETTER")
- t)))
- (org-with-wide-buffer
- (goto-char (point-min))
- (let ((block-re (concat "^[ \t]*#\\+BEGIN_" back-end-re)))
- (save-excursion
- (while (re-search-forward block-re nil t)
- (let ((element (save-match-data (org-element-at-point))))
- (when (eq (org-element-type element) 'special-block)
- (save-excursion
- (goto-char (org-element-property :end element))
- (save-match-data (search-backward "_"))
- (forward-char)
- (insert "EXPORT")
- (delete-region (point) (line-end-position)))
- (replace-match "EXPORT \\1" nil nil nil 1))))))
- (let ((include-re
- (format "^[ \t]*#\\+INCLUDE: .*?%s[ \t]*$" back-end-re)))
- (while (re-search-forward include-re nil t)
- (let ((element (save-match-data (org-element-at-point))))
- (when (and (eq (org-element-type element) 'keyword)
- (string= (org-element-property :key element) "INCLUDE"))
- (replace-match "EXPORT \\1" nil nil nil 1)))))))))
-#+END_SRC
-
-Moreover, ~:export-block~ keyword used in ~org-export-define-backend~ and
-~org-export-define-derived-backend~ is no longer used and needs to be
-removed.
-
-*** Footnotes changes
-
-**** [1]-like constructs are not valid footnotes
-
-Using =[1]= as a footnote was already discouraged in the manual, since
-it introduced too many false-positives in many Org documents. These
-constructs are now unsupported.
-
-If you used =[N]= in some of your documents, consider turning them into
-=[fn:N]=.
-
-**** /Org Footnote/ library doesn't handle non-Org buffers
-
-Commands for footnotes in an Org document no longer try to do
-something in non-Org ones. If you need to have footnotes there,
-consider using the =footnote.el= library, shipped with Emacs.
-
-In particular, ~org-footnote-tag-for-non-org-mode-files~ no longer
-exists.
-
-*** ~org-file-apps~ no longer accepts S-expressions as commands
-
-The variable now accepts functions of two arguments instead of plain
-S-expressions. Replacing an S-expression with an appropriate function
-is straightforward. For example
-
-: ("pdf" . (foo))
-
-becomes
-
-: ("pdf" . (lambda (file link) (foo)))
-
-*** The ~{{{modification-time}}}~ macro can get time via =vc=
-
-The modification time will be determined via =vc.el= if the second
-argument is non-nil. See the manual for details.
-
-*** Preparation and completion functions in publishing projects change signature
-
-Preparation and completion functions are now called with an argument,
-which is the project property list. It used to be dynamically scoped
-through the ~project-plist~ variable.
-
-*** Old Babel header properties are no longer supported
-
-Using header arguments as property names is no longer possible. As
-such, the following
-
-#+BEGIN_EXAMPLE
-,* Headline
-:PROPERTIES:
-:exports: code
-:var: a=1 b=2
-:var+: c=3
-:END:
-#+END_EXAMPLE
-
-should be written instead
-
-#+BEGIN_EXAMPLE
-,* Headline
-:PROPERTIES:
-:header-args: :exports code
-:header-args+: :var a=1 b=2
-:header-args+: :var c=3
-:END:
-#+END_EXAMPLE
-
-Please note that, however, old properties were defined at the source
-block definition. Current ones are defined where the block is called.
-
-** New features
-
-*** ~org-eww~ has been moved into core
-*** New org-protocol key=value syntax
-
-Org-protocol can now handle query-style parameters such as:
-
-#+begin_example
-org-protocol://store-link?url=http:%2F%2Flocalhost%2Findex.html&title=The%20title
-org-protocol://capture?template=x&title=Hello&body=World&url=http:%2F%2Fexample.com
-#+end_example
-
-Old-style links such as
-: org-protocol://store-link:/http:%2F%2Flocalhost%2Findex.html/The%20title
-continue to be supported.
-
-If you have defined your own handler functions for
-~org-protocol-protocol-alist~, change them to accept either a property
-list (for new-style links) or a string (for old-style links). Use
-~org-protocol-parse-parameters~ to convert old-style links into property
-lists.
-
-*** New Org linter library
-
-~org-lint~ can check syntax and report common issues in Org documents.
-
-*** New option ~date-tree-last~ for ~org-agenda-insert-diary-strategy~
-
-When ~org-agenda-insert-diary-strategy~ is set to ~date-tree-last~, diary
-entries are added to last in the date tree.
-
-*** New ~vbar~ entity
-
-~\vbar~ or ~\vbar{}~ will be exported unconditionally as a =|=,
-unlike to existing ~\vert~, which is expanded as ~&vert;~ when using
-a HTML derived export back-end.
-
-*** Export
-
-**** New =#+latex_compiler= keyword to set LaTeX compiler.
-
-PDFLaTeX, XeLaTeX, and LuaLaTeX are supported. See the manual for
-details.
-
-**** New option ~org-export-with-broken-links~
-
-This option tells the export process how to behave when encountering
-a broken internal link. See its docstring for more information.
-
-**** Attributes support in custom language environments for LaTeX export
-
-Custom language environments for LaTeX export can now define the
-string to be inserted during export, using attributes to indicate the
-position of the elements. See variable ~org-latex-custom-lang-environments~
-for more details.
-
-**** New Texinfo ~options~ attribute on special blocks
-
-Using ~:options~ as a Texinfo attribute, it is possible to add
-information to custom environments. See manual for details.
-
-**** New HTML ~id~ attributes on special, example and quote blocks
-
-If the block has a =#+NAME:= attribute assigned, then the HTML element
-will have an ~id~ attribute with that name in the HTML export. This
-enables one to create links to these elements in other places, e.g.,
-~<a href="#name">text</a>~.
-
-**** Listings with captions are now numbered in HTML export
-
-The class associated to the numbering is "listing-number". If you
-don't want these blocks to be numbered, as it was the case until now,
-You may want to add ~.listing-number { display: none; }~ to the CSS
-used.
-
-**** Line Numbering in SRC/EXAMPLE blocks support arbitrary start number
-
-The ~-n~ option to ~SRC~ and ~EXAMPLE~ blocks can now take a numeric
-argument to specify the staring line number for the source or example
-block. The ~+n~ option can now take a numeric argument that will be
-added to the last line number from the previous block as the starting
-point for the SRC/EXAMPLE block.
-
-#+BEGIN_SRC org
-,#+BEGIN_SRC emacs-lisp -n 20
-;; this will export with line number 20
-(message "This is line 21")
-,#+END_SRC
-,#+BEGIN_SRC emacs-lisp +n 10
-;; This will be listed as line 31
-(message "This is line 32")
-,#+END_SRC
-#+END_SRC
-
-**** Allow toggling center for images in LaTeX export
-
-With the global variable ~org-latex-images-centered~ or the local
-attribute ~:center~ it is now possible to center an image in LaTeX
-export.
-
-**** Default CSS class ~org-svg~ for SVG images in HTML export
-
-SVG images exported in HTML are now by default assigned a CSS class
-~org-svg~ if no CSS class is specified with the ~:class~ attribute. By
-default, the CSS styling of class ~org-svg~ specifies an image width of
-90\thinsp{}% of the container the image.
-
-**** Markdown footnote export customization
-
-Variables ~org-md-footnotes-section~ and ~org-md-footnote-format~
-introduced for =ox-md.el=. Both new variables define template strings
-which can be used to customize the format of the exported footnotes
-section and individual footnotes, respectively.
-
-*** Babel
-
-**** Blocks with coderefs labels can now be evaluated
-
-The labels are removed prior to evaluating the block.
-
-**** Support for Lua language
-**** Support for SLY in Lisp blocks
-
-See ~org-babel-lisp-eval-fn~ to activate it.
-
-**** Support for Stan language
-
-New ob-stan.el library.
-
-Evaluating a Stan block can produce two different results.
-
-1. Dump the source code contents to a file.
-
- This file can then be used as a variable in other blocks, which
- allows interfaces like RStan to use the model.
-
-2. Compile the contents to a model file.
-
- This provides access to the CmdStan interface. To use this, set
- ~org-babel-stan-cmdstan-directory~ and provide a ~:file~ argument
- that does not end in ".stan".
-
-For more information and usage examples, visit
-https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-stan.html
-
-**** Support for Oracle databases via ~sqlplus~
-
-=ob-sql= library supports running SQL blocks against an Oracle
-database using ~sqlplus~. Use with properties like this (all
-mandatory):
-
-#+BEGIN_EXAMPLE
-:engine oracle
-:dbhost <host.com>
-:dbport <1521>
-:dbuser <username>
-:database <database>
-:dbpassword <secret>
-#+END_EXAMPLE
-
-**** Improved support to Microsoft SQL Server via ~sqlcmd~
-
-=ob-sql= library removes support to the ~msosql~ engine which uses the
-deprecated ~osql~ command line tool, and replaces it with ~mssql~
-engine which uses the ~sqlcmd~ command line tool. Use with properties
-like this:
-
-#+BEGIN_EXAMPLE
-:engine mssql
-:dbhost <host.com>
-:dbuser <username>
-:dbpassword <secret>
-:database <database>
-#+END_EXAMPLE
-
-If you want to use the *trusted connection* feature, omit *both* the
-=dbuser= and =dbpassword= properties and add =cmdline -E= to the properties.
-
-If your Emacs is running in a Cygwin environment, the =ob-sql= library
-can pass the converted path to the =sqlcmd= tool.
-
-**** Improved support of header arguments for postgresql
-
-The postgresql engine in a sql code block supports now ~:dbport~ nd
-~:dbpassword~ as header arguments.
-
-**** Support for additional plantuml output formats
-
-The support for output formats of [[https://plantuml.com/][plantuml]] has been extended to now
-include:
-
-All Diagrams:
-- png ::
-- svg ::
-- eps ::
-- pdf ::
-- vdx ::
-- txt :: ASCII art
-- utxt :: ASCII art using unicode characters
-
-Class Diagrams:
-- xmi ::
-- html ::
-
-State Diagrams:
-- scxml ::
-
-The output formats are determined by the file extension specified
-using the :file property, e.g.:
-
-#+begin_src plantuml :file diagram.png
-@startuml
-Alice -> Bob: Authentication Request
-Bob --> Alice: Authentication Response
-
-Alice -> Bob: Another authentication Request
-Alice <-- Bob: another authentication Response
-@enduml
-#+end_src
-
-Please note that *pdf* *does not work out of the box* and needs additional
-setup in addition to plantuml. See [[https://plantuml.com/pdf.html]] for
-details and setup information.
-
-*** Rewrite of radio lists
-
-Radio lists, i.e, Org plain lists in foreign buffers, have been
-rewritten to be on par with Radio tables. You can use a large set of
-parameters to control how a given list should be rendered. See manual
-for details.
-
-*** org-bbdb-anniversaries-future
-
-Used like ~org-bbdb-anniversaries~, it provides a few days warning for
-upcoming anniversaries (default: 7 days).
-
-*** Clear non-repeated SCHEDULED upon repeating a task
-
-If the task is repeated, and therefore done at least one, scheduling
-information is no longer relevant. It is therefore removed.
-
-See [[git:481719fbd5751aaa9c672b762cb43aea8ee986b0][commit message]] for more information.
-
-*** Support for ISO week trees
-
-ISO week trees are an alternative date tree format that orders entries
-by ISO week and not by month.
-
-For example:
-
-: * 2015
-: ** 2015-W35
-: ** 2015-W36
-: *** 2015-08-31 Monday
-
-They are supported in org-capture via ~file+weektree~ and
-~file+weektree+prompt~ target specifications.
-
-*** Accept ~:indent~ parameter when capturing column view
-
-When defining a "columnview" dynamic block, it is now possible to add
-an :indent parameter, much like the one in the clock table.
-
-On the other hand, stars no longer appear in an ITEM field.
-
-*** Columns view
-
-**** ~org-columns~ accepts a prefix argument
-
-When called with a prefix argument, ~org-columns~ apply to the whole
-buffer unconditionally.
-
-**** New variable : ~org-agenda-view-columns-initially~
-
-The variable used to be a ~defvar~, it is now a ~defcustom~.
-
-**** Allow custom summaries
-
-It is now possible to add new summary types, or override those
-provided by Org by customizing ~org-columns-summary-types~, which see.
-
-**** Allow multiple summaries for any property
-
-Columns can now summarize the same property using different summary
-types.
-
-*** Preview LaTeX snippets in buffers not visiting files
-*** New option ~org-attach-commit~
-
-When non-nil, commit attachments with git, assuming the document is in
-a git repository.
-
-*** Allow conditional case-fold searches in ~org-occur~
-
-When set to ~smart~, the new variable ~org-occur-case-fold-search~ allows
-to mimic =isearch.el=: if the regexp searched contains any upper case
-character (or character class), the search is case sensitive.
-Otherwise, it is case insensitive.
-
-*** More robust repeated =ox-latex= footnote handling
-
-Repeated footnotes are now numbered by referring to a label in the
-first footnote.
-
-*** The ~org-block~ face is inherited by ~src-blocks~
-
-This works also when =org-src-fontify-natively= is non-nil. It is also
-possible to specify per-languages faces. See =org-src-block-faces= and
-the manual for details.
-
-*** Links are now customizable
-
-Links can now have custom colors, tooltips, keymaps, display behavior,
-etc. Links are now centralized in ~org-link-parameters~.
-
-** New functions
-
-*** ~org-next-line-empty-p~
-
-It replaces the deprecated ~next~ argument to ~org-previous-line-empty-p~.
-
-*** ~org-show-children~
-
-It is a faster implementation of ~outline-show-children~.
-
-** Removed functions
-
-*** ~org-agenda-filter-by-tag-refine~ has been removed.
-
-Use ~org-agenda-filter-by-tag~ instead.
-
-*** ~org-agenda-todayp~ is deprecated.
-
-Use ~org-agenda-today-p~ instead.
-
-*** ~org-babel-get-header~ is removed.
-
-Use ~org-babel--get-vars~ or ~assq~ instead, as applicable.
-
-*** ~org-babel-trim~ is deprecated.
-
-Use ~org-trim~ instead.
-
-*** ~org-element-remove-indentation~ is deprecated.
-
-Use ~org-remove-indentation~ instead.
-
-*** ~org-image-file-name-regexp~ is deprecated
-
-Use ~image-file-name-regexp~ instead.
-The never-used-in-core ~extensions~ argument has been dropped.
-
-*** ~org-list-parse-list~ is deprecated
-
-Use ~org-list-to-lisp~ instead.
-
-*** ~org-on-heading-p~ is deprecated
-
-A comment to this effect was in the source code since 7.8.03, but
-now a byte-compiler warning will be generated as well.
-
-*** ~org-table-p~ is deprecated
-
-Use ~org-at-table-p~ instead.
-
-*** ~org-table-recognize-table.el~ is deprecated
-
-It was not called by any org code since 2010.
-
-*** Various reimplementations of cl-lib functions are deprecated
-
-The affected functions are:
-- ~org-count~
-- ~org-remove-if~
-- ~org-remove-if-not~
-- ~org-reduce~
-- ~org-every~
-- ~org-some~
-
-Additionally, ~org-sublist~ is deprecated in favor of ~cl-subseq~. Note
-the differences in indexing conventions: ~org-sublist~ is 1-based and
-end-inclusive; ~cl-subseq~ is 0-based and end-exclusive.
-
-** Removed options
-
-*** Remove all options related to ~ido~ or ~iswitchb~
-
-This includes ~org-completion-use-iswitchb~ and ~org-completion-use-ido~.
-Instead Org uses regular functions, e.g., ~completion-read~ so as to
-let those libraries operate.
-
-*** Remove ~org-list-empty-line-terminates-plain-lists~
-
-Two consecutive blank lines always terminate all levels of current
-plain list.
-
-*** ~fixltx2e~ is removed from ~org-latex-default-packages-alist~
-
-fixltx2e is obsolete, see LaTeX News 22.
-
-** Miscellaneous
-*** Add Icelandic smart quotes
-*** Allow multiple receiver locations in radio tables and lists
-*** Allow angular links within link descriptions
-
-It is now allowed to write, e.g.,
-~[[http:orgmode.org][<file:unicorn.png>]]~ as an equivalent to
-~[[http:orgmode.org][file:unicorn.png]]~. The advantage of the former
-is that spaces are allowed within the path.
-
-*** Beamer export back-ends uses ~org-latex-prefer-user-labels~
-*** ~:preparation-function~ called earlier during publishing
-
-Functions in this list are called before any file is associated to the
-current project. Thus, they can be used to generate to be published
-Org files.
-
-*** Function ~org-remove-indentation~ changes.
-
-The new algorithm doesn't remove TAB characters not used for
-indentation.
-
-*** Secure placeholders in capture templates
-
-Placeholders in capture templates are no longer expanded recursively.
-However, ~%(...)~ constructs are expanded very late, so you can fill
-the contents of the S-exp with the replacement text of non-interactive
-placeholders. As before, interactive ones are still expanded as the
-very last step, so the previous statement doesn't apply to them.
-
-Note that only ~%(...)~ placeholders initially present in the
-template, or introduced using a file placeholder, i.e., ~%[...]~ are
-expanded. This prevents evaluating potentially malicious code when
-another placeholder, e.g., ~%i~ expands to a S-exp.
-
-*** Links stored by ~org-gnus-store-link~ in nnir groups
-
-Since gnus nnir groups are temporary, ~org-gnus-store-link~ now refers
-to the article's original group.
-
-*** ~org-babel-check-confirm-evaluate~ is now a function instead of a macro
-
-The calling convention has changed.
-
-*** HTML export table row customization changes
-
-Variable ~org-html-table-row-tags~ has been split into
-~org-html-table-row-open-tag~ and ~org-html-table-row-close-tag~.
-Both new variables can be either a string or a function which will be
-called with 6 parameters.
-
-*** =ITEM= special property returns headline without stars
-*** Rename ~org-insert-columns-dblock~ into ~org-columns-insert-dblock~
-
-The previous name is, for the time being, kept as an obsolete alias.
-
-*** ~org-trim~ can preserve leading indentation.
-
-When setting a new optional argument to a non-nil value, ~org-trim~
-preserves leading indentation while removing blank lines at the
-beginning of the string. The behavior is identical for white space at
-the end of the string.
-
-*** Function ~org-info-export~ changes.
-
-HTML links created from certain info links now point to =gnu.org= URL's rather
-than just to local files. For example info links such as =info:emacs#List
-Buffers= used to be converted to HTML links like this:
-
-: <a href="emacs.html#List-Buffers">emacs#List Buffers</a>
-
-where local file =emacs.html= is referenced.
-For most folks this file does not exist.
-Thus the new behavior is to generate this HTML link instead:
-
-: <a href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#List-Buffers">emacs#List Buffers</a>
-
-All emacs related info links are similarly translated plus few other
-=gnu.org= manuals.
-
-*** Repeaters with a ~++~ interval and a time can be shifted to later today
-
-Previously, if a recurring task had a timestamp of
-~<2016-01-01 Fri 20:00 ++1d>~ and was completed on =2016-01-02= at
-=08:00=, the task would skip =2016-01-02= and would be rescheduled for
-=2016-01-03=. Timestamps with ~++~ cookies and a specific time will
-now shift to the first possible future occurrence, even if the
-occurrence is later the same day the task is completed. (Timestamps
-already in the future are still shifted one time further into the
-future.)
-
-*** ~org-mobile-action-alist~ is now a defconst
-
-It used to be a defcustom, with a warning that it shouldn't be
-modified anyway.
-
-*** ~file+emacs~ and ~file+sys~ link types are deprecated
-
-They are still supported in Org 9.0 but will eventually be removed in
-a later release. Use ~file~ link type along with universal arguments
-to force opening it in either Emacs or with system application.
-
-*** New defcustom ~org-babel-J-command~ stores the j command
-*** New defalias ~org-babel-execute:j~
-
-Allows J source blocks be indicated by letter j. Previously the
-indication letter was solely J.
-
-*** ~org-open-line~ ignores tables at the very beginning of the buffer
-
-When ~org-special-ctrl-o~ is non-nil, it is impractical to create
-a blank line above a table at the beginning of the document. Now, as
-a special case, ~org-open-line~ behaves normally in this situation.
-
-*** ~org-babel-hash-show-time~ is now customizable
-
-The experimental variable used to be more or less confidential, as
-a ~defvar~.
-
-*** New ~:format~ property to parsed links
-
-It defines the format of the original link. Possible values are:
-~plain~, ~bracket~ and ~angle~.
-
-* Version 8.3
-
-** Incompatible changes
-
-*** Properties drawers syntax changes
-
-Properties drawers are now required to be located right after a
-headline and its planning line, when applicable.
-
-It will break some documents as TODO states changes were sometimes
-logged before the property drawer.
-
-The following function will repair them:
-
-#+BEGIN_SRC emacs-lisp
-(defun org-repair-property-drawers ()
- "Fix properties drawers in current buffer.
-Ignore non Org buffers."
- (when (eq major-mode 'org-mode)
- (org-with-wide-buffer
- (goto-char (point-min))
- (let ((case-fold-search t)
- (inline-re (and (featurep 'org-inlinetask)
- (concat (org-inlinetask-outline-regexp)
- "END[ \t]*$"))))
- (org-map-entries
- (lambda ()
- (unless (and inline-re (org-looking-at-p inline-re))
- (save-excursion
- (let ((end (save-excursion (outline-next-heading) (point))))
- (forward-line)
- (when (org-looking-at-p org-planning-line-re) (forward-line))
- (when (and (< (point) end)
- (not (org-looking-at-p org-property-drawer-re))
- (save-excursion
- (and (re-search-forward org-property-drawer-re end t)
- (eq (org-element-type
- (save-match-data (org-element-at-point)))
- 'drawer))))
- (insert (delete-and-extract-region
- (match-beginning 0)
- (min (1+ (match-end 0)) end)))
- (unless (bolp) (insert "\n"))))))))))))
-#+END_SRC
-
-*** Using "COMMENT" is now equivalent to commenting with "#"
-
-If you used "COMMENT" in headlines to prevent a subtree from being
-exported, you can still do it but all information within the subtree
-is now commented out, i.e. no #+OPTIONS line will be parsed or taken
-into account when exporting.
-
-If you want to exclude a headline from export while using its contents
-for setting options, use =:noexport:= (see =org-export-exclude-tags=.)
-
-*** =#+CATEGORY= keywords no longer apply partially to document
-
-It was possible to use several such keywords and have them apply to
-the text below until the next one, but strongly deprecated since Org
-5.14 (2008).
-
-=#+CATEGORY= keywords are now global to the document. You can use node
-properties to set category for a subtree, e.g.,
-
-#+BEGIN_SRC org
-,* Headline
- :PROPERTIES:
- :CATEGORY: some category
- :END:
-#+END_SRC
-
-*** New variable to control visibility when revealing a location
-
-~org-show-following-heading~, ~org-show-siblings~, ~org-show-entry-below~
-and ~org-show-hierarchy-above~ no longer exist. Instead, visibility is
-controlled through a single variable: ~org-show-context-detail~, which
-see.
-
-*** Replace disputed keys again when reading a date
-
-~org-replace-disputed-keys~ has been ignored when reading date since
-version 8.1, but the former behavior is restored again.
-
-Keybinding for reading date can be customized with a new variable
-~org-read-date-minibuffer-local-map~.
-
-*** No default title is provided when =TITLE= keyword is missing
-
-Skipping =TITLE= keyword no longer provides the current file name, or
-buffer name, as the title. Instead, simply ignore the title.
-
-*** Default bindings of =C-c C-n= and =C-c C-p= changed
-
-The key sequences =C-c C-n= and =C-c C-p= are now bound to
-~org-next-visible-heading~ and ~org-previous-visible-heading~
-respectively, rather than the =outline-mode= versions of these
-functions. The Org version of these functions skips over inline tasks
-(and even-level headlines when ~org-odd-levels-only~ is set).
-
-*** ~org-element-context~ no longer return objects in keywords
-
-~org-element-context~ used to return objects on some keywords, i.e.,
-=TITLE=, =DATE= and =AUTHOR=. It now returns only the keyword.
-
-*** ~org-timer-default-timer~ type changed from number to string
-
-If you have, in your configuration, something like =(setq
-org-timer-default-timer 10)= replace it with =(setq
-org-timer-default-timer "10")=.
-
-*** Functions signature changes
-
-The following functions require an additional argument. See their
-docstring for more information.
-
-- ~org-export-collect-footnote-definitions~
-- ~org-html-format-headline-function~
-- ~org-html-format-inlinetask-function~
-- ~org-latex-format-headline-function~
-- ~org-latex-format-inlinetask-function~
-- ~org-link-search~
-
-** New features
-
-*** Default lexical evaluation of emacs-lisp source blocks
-
-Emacs-lisp source blocks in Babel are now evaluated using lexical
-scoping. There is a new header to control this behavior.
-
-The default results in an eval with lexical scoping.
-:lexical yes
-
-This turns lexical scoping off in the eval (the former behavior).
-:lexical no
-
-This uses the lexical environment with x=42 in the eval.
-:lexical '((x . 42))
-
-*** Behavior of ~org-return~ changed
-
-If point is before or after the headline title, insert a new line
-without changing the headline.
-
-*** Hierarchies of tags
-
-The functionality of nesting tags in hierarchies is added to Org mode.
-This is the generalization of what was previously called "Tag groups"
-in the manual. That term is now changed to "Tag hierarchy".
-
-The following in-buffer definition:
-
-#+BEGIN_SRC org
- ,#+TAGS: [ Group : SubOne SubTwo ]
- ,#+TAGS: [ SubOne : SubOne1 SubOne2 ]
- ,#+TAGS: [ SubTwo : SubTwo1 SubTwo2 ]
-#+END_SRC
-
-Should be seen as the following tree of tags:
-
-- Group
- - SubOne
- - SubOne1
- - SubOne2
- - SubTwo
- - SubTwo1
- - SubTwo2
-
-Searching for "Group" should return all tags defined above. Filtering
-on SubOne filters also it's sub-tags. Etc.
-
-There is no limit on the depth for the tag hierarchy.
-
-*** Additional syntax for non-unique grouptags
-
-Additional syntax is defined for grouptags if the tags in the group
-don't have to be distinct on a heading.
-
-Grouptags had to previously be defined with { }. This syntax is
-already used for exclusive tags and Grouptags need their own,
-non-exclusive syntax. This behavior is achieved with [ ]. Note: { }
-can still be used also for Grouptags but then only one of the given
-tags can be used on the headline at the same time. Example:
-
-[ group : sub1 sub2 ]
-
-#+BEGIN_SRC org
-,* Test :sub1:sub2:
-#+END_SRC
-
-This is a more general case than the already existing syntax for
-grouptags; { }.
-
-*** Define regular expression patterns as tags
-
-Tags can be defined as grouptags with regular expressions as
-"sub-tags".
-
-The regular expressions in the group must be marked up within { }.
-Example use:
-
-: #+TAGS: [ Project : {P@.+} ]
-
-Searching for the tag Project will now list all tags also including
-regular expression matches for P@.+. This is good for example for
-projects tagged with a common identifier, i.e. P@2014_OrgTags.
-
-*** Filtering in the agenda on grouptags (Tag hierarchies)
-
-Filtering in the agenda on grouptags filters all of the related tags.
-Except if a filter is applied with a (double) prefix-argument.
-
-Filtering in the agenda on subcategories does not filter the "above"
-levels anymore.
-
-If a grouptag contains a regular expression the regular expression
-is also used as a filter.
-
-*** Minor refactoring of ~org-agenda-filter-by-tag~
-
-Now uses the argument ARG and optional argument exclude instead of
-strip and narrow. ARG because the argument has multiple purposes and
-makes more sense than strip now. The term "narrowing" is changed to
-exclude.
-
-The main purpose is for the function to make more logical sense when
-filtering on tags now when tags can be structured in hierarchies.
-
-*** Babel: support for sed scripts
-
-Thanks to Bjarte Johansen for this feature.
-
-*** Babel: support for Processing language
-
-New ob-processing.el library.
-
-This library implements necessary functions for implementing editing
-of Processing code blocks, viewing the resulting sketches in an
-external viewer, and HTML export of the sketches.
-
-Check the documentation for more details.
-
-Thanks to Jarmo Hurri for this feature.
-
-*** New behavior for ~org-toggle-latex-fragment~
-
-The new behavior is the following:
-
-- With a double prefix argument or with a single prefix argument when
- point is before the first headline, toggle overlays in the whole
- buffer;
-
-- With a single prefix argument, toggle overlays in the current
- subtree;
-
-- On latex code, toggle overlay at point;
-
-- Otherwise, toggle overlays in the current section.
-
-*** Additional markup with =#+INCLUDE= keyword
-
-The content of the included file can now be optionally marked up, for
-instance as HTML. See the documentation for details.
-
-*** File links with =#+INCLUDE= keyword
-
-Objects can be extracted via =#+INCLUDE= using file links. It is
-possible to include only the contents of the object. See manual for
-more information.
-
-*** Drawers do not need anymore to be referenced in =#+DRAWERS=
-
-One can use a drawer without listing it in the =#+DRAWERS= keyword,
-which is now obsolete. As a consequence, this change also deprecates
-~org-drawers~ variable.
-
-*** ~org-edit-special~ can edit export blocks
-
-Using C-c ' on an export block now opens a sub-editing buffer. Major
-mode in that buffer is determined by export backend name (e.g.,
-"latex" \to "latex-mode"). You can define exceptions to this rule by
-configuring ~org-src-lang-modes~, which see.
-
-*** Additional =:hline= processing to ob-shell
-
-If the argument =:hlines yes= is present in a babel call, an optional
-argument =:hlines-string= can be used to define a string to use as a
-representation for the lisp symbol ='hline= in the shell program. The
-default is =hline=.
-
-*** Markdown export supports switches in source blocks
-
-For example, it is now possible to number lines using the =-n= switch in
-a source block.
-
-*** New option in ASCII export
-
-Plain lists can have an extra margin by setting ~org-ascii-list-margin~
-variable to an appropriate integer.
-
-*** New blocks in ASCII export
-
-ASCII export now supports =#+BEGIN_JUSTIFYRIGHT= and =#+BEGIN_JUSTIFYLEFT=
-blocks. See documentation for details.
-
-*** More back-end specific publishing options
-
-The number of publishing options specific to each back-end has been
-increased. See manual for details.
-
-*** Export inline source blocks
-
-Inline source code was used to be removed upon exporting. They are
-now handled as standard code blocks, i.e., the source code can appear
-in the output, depending on the parameters.
-
-*** Extend ~org-export-first-sibling-p~ and ~org-export-last-sibling-p~
-
-These functions now support any element or object, not only headlines.
-
-*** New function: ~org-export-table-row-in-header-p~
-
-*** New function: ~org-export-get-reference~
-
-*** New function: ~org-element-lineage~
-
-This function deprecates ~org-export-get-genealogy~. It also provides
-more features. See docstring for details.
-
-*** New function: ~org-element-copy~
-
-*** New filter: ~org-export-filter-body-functions~
-
-Functions in this filter are applied on the body of the exported
-document, before wrapping it within the template.
-
-*** New :environment parameter when exporting example blocks to LaTeX
-
-: #+ATTR_LATEX: :environment myverbatim
-: #+BEGIN_EXAMPLE
-: This sentence is false.
-: #+END_EXAMPLE
-
-will be exported using =@samp(myverbatim)= instead of =@samp(verbatim)=.
-
-*** Various improvements on radio tables
-
-Radio tables feature now relies on Org's export framework ("ox.el").
-~:no-escape~ parameter no longer exists, but additional global
-parameters are now supported: ~:raw~, ~:backend~. Moreover, there are new
-parameters specific to some pre-defined translators, e.g.,
-~:environment~ and ~:booktabs~ for ~orgtbl-to-latex~. See translators
-docstrings (including ~orgtbl-to-generic~) for details.
-
-*** Non-floating minted listings in Latex export
-
-It is not possible to specify =#+attr_latex: :float nil= in conjunction
-with source blocks exported by the minted package.
-
-*** Field formulas can now create columns as needed
-
-Previously, evaluating formulas that referenced out-of-bounds columns
-would throw an error. A new variable ~org-table-formula-create-columns~
-was added to adjust this behavior. It is now possible to silently add
-new columns, to do so with a warning or to explicitly ask the user
-each time.
-
-*** ASCII plot
-
-Ability to plot values in a column through ASCII-art bars. See manual
-for details.
-
-*** New hook: ~org-archive-hook~
-
-This hook is called after successfully archiving a subtree, with point
-on the original subtree, not yet deleted.
-
-*** New option: ~org-attach-archive-delete~
-
-When non-nil, attachments from archived subtrees are removed.
-
-*** New option: ~org-latex-caption-above~
-
-This variable generalizes ~org-latex-table-caption-above~, which is now
-deprecated. In addition to tables, it applies to source blocks,
-special blocks and images. See docstring for more information.
-
-*** New option: ~org-latex-prefer-user-labels~
-
-See the docstring for more information.
-
-*** Export unnumbered headlines
-
-Headlines, for which the property ~UNNUMBERED~ is non-nil, are now
-exported without section numbers irrespective of their levels. The
-property is inherited by children.
-
-*** Tables can be sorted with an arbitrary function
-
-It is now possible to specify a function, both programmatically,
-through a new optional argument, and interactively with ~f~ or ~F~ keys,
-to sort a table.
-
-*** Table of contents can be local to a section
-
-The ~TOC~ keywords now accepts an optional ~local~ parameter. See manual
-for details.
-
-*** Countdown timers can now be paused
-
-~org-timer-pause-time~ now pauses and restarts both relative and
-countdown timers.
-
-*** New option ~only-window~ for ~org-agenda-window-setup~
-
-When ~org-agenda-window-setup~ is set to ~only-window~, the agenda is
-displayed as the sole window of the current frame.
-
-*** ~{{{date}}}~ macro supports optional formatting argument
-
-It is now possible to supply and optional formatting argument to
-~{{{date}}}~. See manual for details.
-
-*** ~{{{property}}}~ macro supports optional search argument
-
-It is now possible to supply an optional search option to
-~{{{property}}}~ in order to retrieve remote properties optional. See
-manual for details.
-
-*** New option ~org-export-with-title~
-
-It is possible to suppress the title insertion with ~#+OPTIONS:
-title:nil~ or globally using the variable ~org-export-with-title~.
-
-*** New entities family: "\_ "
-
-"\_ " are used to insert up to 20 contiguous spaces in various
-back-ends. In particular, this family can be used to introduce
-leading spaces within table cells.
-
-*** New MathJax configuration options
-
-Org uses the MathJax CDN by default. See the manual and the docstring
-of ~org-html-mathjax-options~ for details.
-
-*** New behavior in `org-export-options-alist'
-
-When defining a back-end, it is now possible to specify to give
-`parse' behavior on a keyword. It is equivalent to call
-`org-element-parse-secondary-string' on the value.
-
-However, parsed =KEYWORD= is automatically associated to an
-=:EXPORT_KEYWORD:= property, which can be used to override the keyword
-value during a subtree export. Moreover, macros are expanded in such
-keywords and properties.
-
-*** Viewport support in html export
-
-Viewport for mobile-optimized website is now automatically inserted
-when exporting to html. See ~org-html-viewport~ for details.
-
-*** New ~#+SUBTITLE~ export keyword
-
-Org can typeset a subtitle in some export backends. See the manual
-for details.
-
-*** Remotely edit a footnote definition
-
-Calling ~org-edit-footnote-reference~ (C-c ') on a footnote reference
-allows to edit its definition, as long as it is not anonymous, in a
-dedicated buffer. It works even if buffer is currently narrowed.
-
-*** New function ~org-delete-indentation~ bound to ~M-^~
-
-Work as ~delete-indentation~ unless at heading, in which case text is
-added to headline text.
-
-*** Support for images in Texinfo export
-
-~Texinfo~ back-end now handles images. See the manual for details.
-
-*** Support for captions in Texinfo export
-
-Tables and source blocks can now have captions. Additionally, lists
-of tables and lists of listings can be inserted in the document with
-=#+TOC= keyword.
-
-*** Countdown timer support hh:mm:ss format
-
-In addition to setting countdown timers in minutes, they can also be
-set using the hh:mm:ss format.
-
-*** Extend ~org-clone-subtree-with-time-shift~
-
-~org-clone-subtree-with-time-shift~ now accepts 0 as an argument for the
-number of clones, which removes the repeater from the original subtree
-and creates one shifted, repeating clone.
-
-*** New time block for clock tables: ~untilnow~
-
-It encompasses all past closed clocks.
-
-*** Support for the ~polyglossia~ LaTeX package
-
-See the docstring of ~org-latex-classes~ and
-~org-latex-guess-polyglossia-language~ for details.
-
-*** None-floating tables, graphics and blocks can have captions
-
-*** `org-insert-heading' can be forced to insert top-level headline
-
-** Removed functions
-
-*** Removed function ~org-translate-time~
-
-Use ~org-timestamp-translate~ instead.
-
-*** Removed function ~org-beamer-insert-options-template~
-
-This function inserted a Beamer specific template at point or in
-current subtree. Use ~org-export-insert-default-template~ instead, as
-it provides more features and covers all export back-ends. It is also
-accessible from the export dispatcher.
-
-*** Removed function ~org-timer-cancel-timer~
-
-~org-timer-stop~ now stops both relative and countdown timers.
-
-*** Removed function ~org-export-solidify-link-text~
-
-This function, being non-bijective, introduced bug in internal
-references. Use ~org-export-get-reference~ instead.
-
-*** Removed function ~org-end-of-meta-data-and-drawers~
-
-The function is superseded by ~org-end-of-meta-data~, called with an
-optional argument.
-
-*** Removed functions ~org-table-colgroup-line-p~, ~org-table-cookie-line-p~
-
-These functions were left-over from pre 8.0 era. They are not correct
-anymore. Since they are not needed, they have no replacement.
-
-** Removed options
-
-*** ~org-list-empty-line-terminates-plain-lists~ is deprecated
-
-It will be kept in code base until next release, for backward
-compatibility.
-
-If you need to separate consecutive lists with blank lines, always use
-two of them, as if this option was nil (default value).
-
-*** ~org-export-with-creator~ is a boolean
-
-Special ~comment~ value is no longer allowed. It is possible to use a
-body filter to add comments about the creator at the end of the
-document instead.
-
-*** Removed option =org-html-use-unicode-chars=
-
-Setting this to non-nil was problematic as it converted characters
-everywhere in the buffer, possibly corrupting URLs.
-
-*** Removed option =org-babel-sh-command=
-
-This undocumented option defaulted to the value of =shell-file-name= at
-the time of loading =ob-shell=. The new behavior is to use the value
-of =shell-file-name= directly when the shell language is =shell=. To chose
-a different shell, either customize =shell-file-name= or bind this
-variable locally.
-
-*** Removed option =org-babel-sh-var-quote-fmt=
-
-This undocumented option was supposed to provide different quoting
-styles when changing the shell type. Changing the shell type can now
-be done directly from the source block and the quoting style has to be
-compatible across all shells, so a customization doesn't make sense
-anymore. The chosen hard coded quoting style conforms to POSIX.
-
-*** Removed option ~org-insert-labeled-timestamps-at-point~
-
-Setting this option to anything else that the default value (nil)
-would create invalid planning info. This dangerous option is now
-removed.
-
-*** Removed option ~org-koma-letter-use-title~
-
-Use org-export-with-title instead. See also below.
-
-*** Removed option ~org-entities-ascii-explanatory~
-
-This variable has no effect since Org 8.0.
-
-*** Removed option ~org-table-error-on-row-ref-crossing-hline~
-
-This variable has no effect since August 2009.
-
-*** Removed MathML-related options from ~org-html-mathjax-options~
-
-MathJax automatically chooses the best display technology based on the
-end-users browser. You may force initial usage of MathML via
-~org-html-mathjax-template~ or by setting the ~path~ property of
-~org-html-mathjax-options~.
-
-*** Removed comment-related filters
-
-~org-export-filter-comment-functions~ and
-~org-export-filter-comment-block-functions~ variables do not exist
-anymore.
-
-** Miscellaneous
-
-*** Strip all meta data from ITEM special property
-
-ITEM special property does not contain TODO, priority or tags anymore.
-
-*** File names in links accept are now compatible with URI syntax
-
-Absolute file names can now start with =///= in addition to =/=. E.g.,
-=[[file:///home/me/unicorn.jpg]]=.
-
-*** Footnotes in included files are now local to the file
-
-As a consequence, it is possible to include multiple Org files with
-footnotes in a master document without being concerned about footnote
-labels colliding.
-
-*** Mailto links now use regular URI syntax
-
-This change deprecates old Org syntax for mailto links:
-=mailto:user@domain::Subject=.
-
-*** =QUOTE= keywords do not exist anymore
-
-=QUOTE= keywords have been deprecated since Org 8.2.
-
-*** Select tests to perform with the build system
-
-The build system has been enhanced to allow test selection with a
-regular expression by defining =BTEST_RE= during the test invocation.
-This is especially useful during bisection to find just when a
-particular test failure was introduced.
-
-*** Exact heading search for external links ignore spaces and cookies
-
-Exact heading search for links now ignore spaces and cookies. This is
-the case for links of the form ~file:projects.org::*task title~, as well
-as links of the form ~file:projects.org::some words~ when
-~org-link-search-must-match-exact-headline~ is not nil.
-
-*** ~org-latex-hyperref-template~, ~org-latex-title-command~ formatting
-
-New formatting keys are supported. See the respective docstrings.
-Note, ~org-latex-hyperref-template~ has a new default value.
-
-*** ~float, wasysym, marvosym~ are removed from ~org-latex-default-packages-alist~
-
-If you require any of these package add them to your preamble via
-~org-latex-packages-alist~. Org also uses default LaTeX ~\tolerance~ now.
-
-*** When exporting, throw an error on unresolved id/fuzzy links and code refs
-
-This helps spotting wrong links.
-
-* Version 8.2
-
-** Incompatible changes
-*** =ob-sh.el= renamed to =ob-shell=
-This may require two changes in user config.
-
-1. In =org-babel-do-load-languages=, change =(sh . t)= to =(shell . t)=.
-2. Edit =local.mk= files to change the value of =BTEST_OB_LANGUAGES=
- to remove "sh" and include "shell".
-
-*** Combine org-mac-message.el and org-mac-link-grabber into org-mac-link.el
-
-Please remove calls to =(require 'org-mac-message)= and =(require
-'org-mac-link-grabber)= in your =.emacs= initialization file. All you
-need now is =(require 'org-mac-link)=.
-
-Additionally, replace any calls to =ogml-grab-link= to
-=org-mac-grab-link=. For example, replace this line:
-
-: (define-key org-mode-map (kbd "C-c g") 'omgl-grab-link)
-
-with this:
-
-: (define-key org-mode-map (kbd "C-c g") 'org-mac-grab-link)
-
-*** HTML export: Replace =HTML_HTML5_FANCY= by =:html-html5-fancy= (...)
-
-Some of the HTML specific export options in Org <8.1 are either nil or
-t, like =#+HTML_INCLUDE_STYLE=. We replaced these binary options with
-option keywords like :html-include-style.
-
-So you need to replace
-
-: #+HTML_INCLUDE_STYLE: t
-
-by
-
-: #+OPTIONS: :html-include-style t
-
-Options affected by this change: =HTML5_FANCY=, =HTML_INCLUDE_SCRIPTS=
-and =HTML_INCLUDE_STYLE=.
-
-*** Add an argument to ~org-export-to-file~ and ~org-export-to-buffer~
-
-~org-export-to-file~ and ~org-export-to-file~ can run in a different
-process when provided a non-nil =ASYNC= optional argument, without
-relying on ~org-export-async-start~ macro.
-
-Since =ASYNC= is the first of optional arguments, you have to shift
-the other optional arguments accordingly.
-
-*** Export back-ends are now structures
-
-Export back-ends are now structures, and stored as such in the
-communication channel during an export process. In other words, from
-now on, ~(plist-get info :back-end)~ will return a structure instead
-of a symbol.
-
-Arguments in hooks and in filters are still symbols, though.
-
-** Important bugfixes
-
-*** [[doc:org-insert-heading][org-insert-heading]] has been rewritten and bugs are now fixed
-*** The replacement of disputed keys is now turned of when reading a date
-
-*** Match string for sparse trees can now contain a slash in a property value
-
- You can now have searches like SOMEPROP="aaa/bbb". Until now,
- this would break because the slash would be interpreted as the
- separator starting a TOTO match string.
-** New features
-
-*** =C-c ^ x= will now sort checklist items by their checked status
-
-See [[doc:org-sort-list][org-sort-list]]: hitting =C-c ^ x= will put checked items at the end
-of the list.
-*** Various LaTeX export enhancements
-
-- Support SVG images
-- Support for .pgf files
-- LaTeX Babel blocks can now be exported as =.tikz= files
-- Allow =latexmk= as an option for [[doc:org-latex-pdf-process][org-latex-pdf-process]]
-- When using =\usepackage[AUTO]{babel}=, AUTO will automatically be
- replaced with a value compatible with ~org-export-default-language~
- or ~LANGUAGE~ keyword.
-- The dependency on the =latexsym= LaTeX package has been removed, we
- now use =amssymb= symbols by default instead.
-
-*** New functions for paragraph motion
-
- The commands =C-down= and =C-up= now invoke special commands
- that use knowledge from the org-elements parser to move the cursor
- in a paragraph-like way.
-
-*** New entities in =org-entities.el=
-
-Add support for ell, imath, jmath, varphi, varpi, aleph, gimel, beth,
-dalet, cdots, S (§), dag, ddag, colon, therefore, because, triangleq,
-leq, geq, lessgtr, lesseqgtr, ll, lll, gg, ggg, prec, preceq,
-preccurlyeq, succ, succeq, succurlyeq, setminus, nexist(s), mho,
-check, frown, diamond. Changes loz, vert, checkmark, smile and tilde.
-
-*** Anonymous export back-ends
-
-~org-export-create-backend~ can create anonymous export back-ends,
-which can then be passed to export functions like
-~org-export-to-file~, ~org-export-to-buffer~ or ~org-export-as~.
-
-It allows for quick translation of Org syntax without the overhead of
-registering a new back-end.
-
-*** New agenda fortnight view
-
- The agenda has not, in addition to day, week, month, and year
- views, also a fortnight view covering 14 days.
-** New options
-
-*** New option [[doc:org-bookmark-names-plist][org-bookmark-names-plist]]
-
-This allows to specify the names of automatic bookmarks.
-*** New option [[doc:org-agenda-ignore-drawer-properties][org-agenda-ignore-drawer-properties]]
-
-This allows more flexibility when optimizing the agenda generation.
-See https://orgmode.org/worg/agenda-optimization.html for details.
-*** New option: [[doc:org-html-link-use-abs-url][org-html-link-use-abs-url]] to force using absolute URLs
-
-This is an export/publishing option, and should be used either within
-the =#+OPTIONS= line(s) or within a [[doc:org-publish-project-alist][org-publish-project-alist]].
-
-Setting this option to =t= is needed when the HTML output does not
-allow relative URLs. For example, the =contrib/lisp/ox-rss.el=
-library produces a RSS feed, and RSS feeds need to use absolute URLs,
-so a combination of =:html-link-home "..." and :html-link-use-abs-url
-t= is required---see the configuration example in the comment section
-of =ox-rss.el=.
-
-*** New option [[doc:org-babel-ditaa-java-cmd][org-babel-ditaa-java-cmd]]
-
-This makes java executable configurable for ditaa blocks.
-
-*** New options [[doc:org-babel-latex-htlatex][org-babel-latex-htlatex]] and [[doc:org-babel-latex-htlatex-packages][org-babel-latex-htlatex-packages]]
-
-This enables SVG generation from latex code blocks.
-
-*** New option: [[doc:org-habit-show-done-always-green][org-habit-show-done-always-green]]
-
-See [[https://lists.gnu.org/r/emacs-orgmode/2013-05/msg00214.html][this message]] from Max Mikhanosha.
-
-*** New option: [[doc:org-babel-inline-result-wrap][org-babel-inline-result-wrap]]
-
-If you set this to the following
-
-: (setq org-babel-inline-result-wrap "$%s$")
-
-then inline code snippets will be wrapped into the formatting string.
-
-*** New option: [[doc:org-special-ctrl-o][org-special-ctrl-o]]
-
- This variable can be used to turn off the special behavior of
- =C-o= in tables.
-** New contributed packages
-
-- =ox-bibtex.el= by Nicolas Goaziou :: an utility to handle BibTeX
- export to both LaTeX and HTML exports. It uses the [[https://www.lri.fr/~filliatr/bibtex2html/][bibtex2html]]
- software.
-
-- =org-screenshot.el= by Max Mikhanosha :: an utility to handle
- screenshots easily from Org, using the external tool [[https://freecode.com/projects/scrot][scrot]].
-
-** Miscellaneous
-
-*** "QUOTE" keywords in headlines are deprecated
-
-"QUOTE" keywords are an undocumented feature in Org. When a headline
-starts with the keyword "QUOTE", its contents are parsed as
-a ~quote-section~ and treated as an example block. You can achieve
-the same with example blocks.
-
-This feature is deprecated and will be removed in the next Org
-release.
-
-* Version 8.0.1
-
-** Installation
-
-Installation instructions have been updated and simplified.
-
-If you have troubles installing or updating Org, focus on these
-instructions:
-
-- when updating via a =.zip/.tar.gz= file, you only need to set the
- =load-path= in your =.emacs=. Set it before any other Org
- customization that would call autoloaded Org functions.
-
-- when updating by pulling Org's Git repository, make sure to create the
- correct autoloads. You can do this by running =~$ make autoloads= (to
- only create the autoloads) or by running =~$ make= (to also compile
- the Emacs lisp files.) =~$ make help= and =~$ make helpall= gives you
- detailed explanations.
-
-- when updating through ELPA (either from GNU ELPA or from Org ELPA),
- you have to install Org's ELPA package in a session where no Org
- function has been called already.
-
-When in doubt, run =M-x org-version RET= and see if you have a mixed-up
-installation.
-
-See https://orgmode.org/org.html#Installation for details.
-
-** Incompatible changes
-
-Org 8.0 is the most disruptive major version of Org.
-
-If you configured export options, you will have to update some of them.
-
-If you used =#+ATTR_*= keywords, the syntax of the attributes changed and
-you will have to update them.
-
-Below is a list of changes for which you need to take action.
-
-See https://orgmode.org/worg/org-8.0.html for the most recent version of
-this list and for detailed instructions on how to migrate.
-
-**** New export engine
-
-Org 8.0 comes with a new export engine written by Nicolas Goaziou. This
-export engine relies on ~org-element.el~ (Org's syntax parser), which was
-already in Org's core. This new export engine triggered the rewriting of
-/all/ export back-ends.
-
-The most visible change is the export dispatcher, accessible through the
-keybinding =C-c C-e=. By default, this menu only shows some of the
-built-in export formats, but you can add more formats by loading them
-directly (e.g., =(require 'ox-texinfo)= or by configuring the option
-[[doc:org-export-backends][org-export-backends]].
-
-More contributed back-ends are available from the =contrib/= directory, the
-corresponding files start with the =ox-= prefix.
-
-If you customized an export back-end (like HTML or LaTeX), you will need to
-rename some options so that your customization is not lost. Typically, an
-option starting with =org-export-html-= is now named =org-html-=. See the
-manual for details and check [[https://orgmode.org/worg/org-8.0.html][this Worg page]] for directions.
-
-**** New syntax for #+ATTR_HTML/LaTeX/... options
-
- : #+ATTR_HTML width="200px"
-
- should now be written
-
- : #+ATTR_HTML :width 200px
-
- Keywords like =#+ATTR_HTML= and =#+ATTR_LaTeX= are defined in their
- respective back-ends, and the list of supported parameters depends on
- each backend. See Org's manual for details.
-
-**** ~org-remember.el~ has been removed
-
- You cannot use =remember.el= anymore to capture notes.
-
- Support for remember templates has been obsoleted since long, it is
- now fully removed.
-
- Use =M-x org-capture-import-remember-templates RET= to import your
- remember templates into capture templates.
-
-**** ~org-jsinfo.el~ has been merged into ~ox-html.el~
-
- If you were requiring ~ox-jsinfo.el~ in your ~.emacs.el~ file, you
- will have to remove this requirement from your initialization file.
-
-**** Note for third-party developers
-
- The name of the files for export back-end have changed: we now use the
- prefix =ox-= for those files (like we use the =ob-= prefix for Babel
- files.) For example ~org-html.el~ is now ~ox-html.el~.
-
- If your code relies on these files, please update the names in your
- code.
-
-**** Packages moved from core to contrib
-
- Since packages in Org's core are meant to be part of GNU Emacs, we try
- to be minimalist when it comes to adding files into core. For 8.0, we
- moved some contributions into the =contrib/= directory.
-
- The rationale for deciding that these files should live in =contrib/=
- is either because they rely on third-party software that is not
- included in Emacs, or because they are not targeting a significant
- user-base.
-
- - org-colview-xemacs.el
- - org-mac-message.el
- - org-mew.el
- - org-wl.el
- - ox-freedmind.el
- - ox-taskjuggler.el
-
- Note that ~ox-freedmind.el~ has been rewritten by Jambunathan,
- ~org-mew.el~ has been enhanced by Tokuya Kameshima and
- ~ox-taskjuggler.el~ by Nicolas Goaziou and others.
-
- Also, the Taskjuggler exporter now uses TJ3 by default. John Hendy
- wrote [[https://orgmode.org/worg/org-tutorials/org-taskjuggler3.html][a tutorial on Worg]] for the TJ3 export.
-
-** New packages in core
-
-*** ~ob-makefile.el~ by Eric Schulte and Thomas S. Dye
-
- =ob-makefile.el= implements Org Babel support for Makefile tangling.
-
-*** ~ox-man.el~ by Luis Anaya
-
- =ox-man.el= allows you to export Org files to =man= pages.
-
-*** ~ox-md.el~ by Nicolas Goaziou
-
- =ox-md.el= allows you to export Org files to Markdown files, using the
- vanilla [[https://daringfireball.net/projects/markdown/][Markdown syntax]].
-
-*** ~ox-texinfo.el~ by Jonathan Leech-Pepin
-
- =ox-texinfo.el= allows you to export Org files to [[https://www.gnu.org/software/texinfo/][Texinfo]] files.
-
-** New packages in contrib
-
-*** ~ob-julia.el~ by G. Jay Kerns
-
- [[https://julialang.org/][Julia]] is a new programming language.
-
- =ob-julia.el= provides Org Babel support for evaluating Julia source
- code.
-
-*** ~ob-mathomatic.el~ by Luis Anaya
-
- [[https://www.mathomatic.org/][mathomatic]] a portable, command-line, educational CAS and calculator
- software, written entirely in the C programming language.
-
- ~ob-mathomatic.el~ provides Org Babel support for evaluating mathomatic
- entries.
-
-*** ~ob-tcl.el~ by Luis Anaya
-
- ~ob-tcl.el~ provides Org Babel support for evaluating [[https://www.tcl.tk/][Tcl]] source code.
-
-*** ~org-bullets.el~ by Evgeni Sabof
-
- Display bullets instead of stars for headlines.
-
- Also see [[https://orgmode.org/worg/org-faq.html#sec-8-12][this updated FAQ]] on how to display another character than "*"
- for starting headlines.
-
-*** ~org-favtable.el~ by Marc-Oliver Ihm
-
- ~org-favtable.el~ helps you to create and update a table of favorite
- locations in org, keeping the most frequently visited lines right at
- the top. This table is called "favtable". See the documentation on
- [[https://orgmode.org/worg/org-contrib/org-favtable.html][Worg]].
-
-*** ~ox-confluence.el~ by Sébastien Delafond
-
- ~ox-confluence.el~ lets you convert Org files to [[https://confluence.atlassian.com/display/DOC/Confluence%2BWiki%2BMarkup][Confluence Wiki]] files.
-
-*** ~ox-deck.el~ and ~ox-s5.el~ by Rick Frankel
-
- [[http://imakewebthings.com/deck.js/][deck.js]] is a javascript library for displaying HTML ages as
- presentations. ~ox-deck.el~ exports Org files to HTML presentations
- using =deck.js=.
-
- [[https://meyerweb.com/eric/tools/s5/][s5]] is a set of scripts which also allows to display HTML pages as
- presentations. ~ox-s5.el~ exports Org files to HTML presentations
- using =s5=.
-
-*** ~ox-groff.el~ by Luis Anaya and Nicolas Goaziou
-
- The [[https://www.gnu.org/software/groff/][groff]] (GNU troff) software is a typesetting package which reads
- plain text mixed with formatting commands and produces formatted
- output.
-
- Luis Anaya and Nicolas Goaziou implemented ~ox-groff.el~ to allow
- conversion from Org files to groff.
-
-*** ~ox-koma-letter.el~ by Nicolas Goaziou and Alan Schmitt
-
- This back-end allow to export Org pages to the =KOMA Scrlttr2= format.
-
-*** ~ox-rss.el~ by Bastien
-
- This back-end lets you export Org pages to RSS 2.0 feeds. Combined
- with the HTML publishing feature, this allows you to build a blog
- entirely with Org.
-
-** New features
-
-*** Export
-
-**** New export generic options
-
-If you use Org exporter, we advise you to re-read [[https://orgmode.org/org.html#Exporting][the manual section about
-it]]. It has been updated and includes new options.
-
-Among the new/updated export options, three are of particular importance:
-
-- [[doc:org-export-allow-bind-keywords][org-export-allow-bind-keywords]] :: This option replaces the old option
- =org-export-allow-BIND= and the default value is =nil=, not =confirm=.
- You will need to explicitly set this to =t= in your initialization
- file if you want to allow =#+BIND= keywords.
-
-- [[doc:org-export-with-planning][org-export-with-planning]] :: This new option controls the export of
- =SCHEDULED:, DEADLINE:, CLOSED:= lines, and planning information is
- now skipped by default during export. This use to be the job of
- [[doc:org-export-with-timestamps][org-export-with-timestamps]], but this latter option has been given a
- new role: it controls the export of /standalone time-stamps/. When
- set to =nil=, Org will not export active and inactive time-stamps
- standing on a line by themselves or within a paragraph that only
- contains time-stamps.
-
-To check if an option has been introduced or its default value changed in
-Org 8.0, do =C-h v [option] RET= and check if the documentation says that
-the variable has been introduced (or changed) in version 24.4 of Emacs.
-
-**** Enhanced default stylesheet for the HTML exporter
-
-See the new default value of [[doc:org-html-style-default][org-html-style-default]].
-
-**** New tags, classes and ids for the HTML exporter
-
-See the new default value of [[doc:org-html-divs][org-html-divs]].
-
-**** Support for tikz pictures in LaTeX export
-**** ~org-man.el~: New export function for "man" links
-**** ~org-docview.el~: New export function for docview links
-*** Structure editing
-
-**** =C-u C-u M-RET= inserts a heading at the end of the parent subtree
-**** Cycling to the =CONTENTS= view keeps inline tasks folded
-
-[[doc:org-cycle-hook][org-cycle-hook]] as a new function [[doc:org-cycle-hide-inline-tasks][org-cycle-hide-inline-tasks]] which
-prevents the display of inline tasks when showing the content of a subtree.
-
-**** =C-c -= in a region makes a list item for each line
-
-This is the opposite of the previous behavior, where =C-c -= on a region
-would create one item for the whole region, and where =C-u C-c -= would
-create an item for each line. Now =C-c -= on the selected region creates
-an item per line, and =C-u C-c -= creates a single item for the whole
-region.
-
-**** When transposing words, markup characters are now part of the words
-
-In Emacs, you can transpose words with =M-t=. Transposing =*these*
-_words__= will preserve markup.
-
-**** New command [[doc:org-set-property-and-value][org-set-property-and-value]] bound to =C-c C-x P=
-
-This command allows you to quickly add both the property and its value. It
-is useful in buffers where there are many properties and where =C-c C-x p=
-can slow down the flow of editing too much.
-
-**** New commands [[doc:org-next-block][org-next-block]] and [[doc:org-previous-block][org-previous-block]]
-
-These commands allow you to go to the previous block (=C-c M-b= or the
-speedy key =B=) or to the next block (=C-c M-f= or the speedy key =F=.)
-
-**** New commands [[doc:org-drag-line-forward][org-drag-line-forward]] and [[doc:org-drag-line-backward][org-drag-line-backward]]
-
-These commands emulate the old behavior of =M-<down>= and =M-<up>= but are
-now bound to =S-M-<down>= and =S-M-<up>= respectively, since =M-<down>= and
-=M-<up>= now drag the whole element at point (a paragraph, a table, etc.)
-forward and backward.
-
-**** When a list item has a checkbox, inserting a new item uses a checkbox too
-**** When sorting entries/items, only the description of links is considered
-
-Now Org will sort this list
-
-: - [[https://abc.org][B]]
-: - [[https://def.org][A]]
-
-like this:
-
-: - [[https://def.org][A]]
-: - [[https://abc.org][B]]
-
-by comparing the descriptions, not the links.
-Same when sorting headlines instead of list items.
-**** New option =orgstruct-heading-prefix-regexp=
-
-For example, setting this option to "^;;; " in Emacs lisp files and using
-=orgstruct-mode= in those files will allow you to cycle through visibility
-states as if lines starting with ";;; *..." where headlines.
-
-In general, you want to set =orgstruct-heading-prefix-regexp= as a file
-local variable.
-
-**** New behavior of [[doc:org-clone-subtree-with-time-shift][org-clone-subtree-with-time-shift]]
-
-The default is now to ask for a time-shift only when there is a time-stamp.
-When called with a universal prefix argument =C-u=, it will not ask for a
-time-shift even if there is a time-stamp.
-
-**** New option [[doc:org-agenda-restriction-lock-highlight-subtree][org-agenda-restriction-lock-highlight-subtree]]
-
-This defaults to =t= so that the whole subtree is highlighted when you
-restrict the agenda view to it with =C-c C-x <= (or the speed command =<=).
-The default setting helps ensuring that you are not adding tasks after the
-restricted region. If you find this highlighting too intrusive, set this
-option to =nil=.
-**** New option [[doc:org-closed-keep-when-no-todo][org-closed-keep-when-no-todo]]
-
-When switching back from a =DONE= keyword to a =TODO= keyword, Org now
-removes the =CLOSED= planning information, if any. It also removes this
-information when going back to a non-TODO state (e.g., with =C-c C-t SPC=).
-If you want to keep the =CLOSED= planning information when removing the
-TODO keyword, set [[doc:org-closed-keep-when-no-todo][org-closed-keep-when-no-todo]] to =t=.
-
-**** New option [[doc:org-image-actual-width][org-image-actual-width]]
-
-This option allows you to change the width of in-buffer displayed images.
-The default is to use the actual width of the image, but you can use a
-fixed value for all images, or fall back on an attribute like
-
-: #+attr_html: :width 300px
-*** Scheduled/deadline
-
-**** Implement "delay" cookies for scheduled items
-
-If you want to delay the display of a scheduled task in the agenda, you can
-now use a delay cookie like this: =SCHEDULED: <2004-12-25 Sat -2d>=. The
-task is still scheduled on the 25th but will appear in your agenda starting
-from two days later (i.e. from March 27th.)
-
-Imagine for example that your co-workers are not done in due time and tell
-you "we need two more days". In that case, you may want to delay the
-display of the task in your agenda by two days, but you still want the task
-to appear as scheduled on March 25th.
-
-In case the task contains a repeater, the delay is considered to affect all
-occurrences; if you want the delay to only affect the first scheduled
-occurrence of the task, use =--2d= instead. See [[doc:org-scheduled-delay-days][org-scheduled-delay-days]]
-and [[doc:org-agenda-skip-scheduled-delay-if-deadline][org-agenda-skip-scheduled-delay-if-deadline]] for details on how to
-control this globally or per agenda.
-
-**** Use =C-u C-u C-c C-s= will insert a delay cookie for scheduled tasks
-
-See the previous section for why delay cookies may be useful.
-
-**** Use =C-u C-u C-c C-d= will insert a warning delay for deadline tasks
-
-=C-u C-u C-c C-d= now inserts a warning delay to deadlines.
-*** Calendar, diary and appts
-
-**** New variable [[doc:org-read-date-minibuffer-local-map][org-read-date-minibuffer-local-map]]
-
-By default, this new local map uses "." to go to today's date, like in the
-normal =M-x calendar RET=. If you want to deactivate this and to reassign
-the "@" key to =calendar-goto-today=, use this:
-
-#+BEGIN_SRC emacs-lisp
- ;; Unbind "." in Org's calendar:
- (define-key org-read-date-minibuffer-local-map (kbd ".") nil)
-
- ;; Bind "@" to `calendar-goto-today':
- (define-key org-read-date-minibuffer-local-map
- (kbd "@")
- (lambda () (interactive) (org-eval-in-calendar '(calendar-goto-today))))
-#+END_SRC
-
-**** In Org's calendar, =!= displays diary entries of the date at point
-
-This is useful when you want to check if you don't already have an
-appointment when setting new ones with =C-c .= or =C-c s=. =!= will
-call =diary-view-entries= and display the diary in a separate buffer.
-
-**** [[doc:org-diary][org-diary]]: only keep the descriptions of links
-
-[[doc:org-diary][org-diary]] returns diary information from Org files, but it returns it
-in a diary buffer, not in an Org mode buffer. When links are displayed,
-only show their description, not the full links.
-*** Agenda
-
-**** New agenda type =agenda*= and entry types =:scheduled* :deadline*=
-
-When defining agenda custom commands, you can now use =agenda*=: this will
-list entries that have both a date and a time. This is useful when you
-want to build a list of appointments.
-
-You can also set [[doc:org-agenda-entry-types][org-agenda-entry-types]] either globally or locally in
-each agenda custom command and use =:timestamp*= and/or =:deadline*= there.
-
-Another place where this is useful is your =.diary= file:
-
-: %%(org-diary :scheduled*) ~/org/rdv.org
-
-This will list only entries from =~/org/rdv.org= that are scheduled with a
-time value (i.e. appointments).
-
-**** New agenda sorting strategies
-
-[[doc:org-agenda-sorting-strategy][org-agenda-sorting-strategy]] allows these new sorting strategies:
-
-| Strategy | Explanations |
-|----------------+------------------------------------------|
-| timestamp-up | Sort by any timestamp, early first |
-| timestamp-down | Sort by any timestamp, late first |
-| scheduled-up | Sort by scheduled timestamp, early first |
-| scheduled-down | Sort by scheduled timestamp, late first |
-| deadline-up | Sort by deadline timestamp, early first |
-| deadline-down | Sort by deadline timestamp, late first |
-| ts-up | Sort by active timestamp, early first |
-| ts-down | Sort by active timestamp, late first |
-| tsia-up | Sort by inactive timestamp, early first |
-| tsia-down | Sort by inactive timestamp, late first |
-
-**** New options to limit the number of agenda entries
-
-You can now limit the number of entries in an agenda view. This is
-different from filters: filters only /hide/ the entries in the agenda,
-while limits are set while generating the list of agenda entries.
-
-These new options are available:
-
-- [[doc:org-agenda-max-entries][org-agenda-max-entries]] :: limit by number of entries.
-- [[doc:org-agenda-max-todos][org-agenda-max-todos]] :: limit by number of TODOs.
-- [[doc:org-agenda-max-tags][org-agenda-max-tags]] :: limit by number of tagged entries.
-- [[doc:org-agenda-max-effort][org-agenda-max-effort]] :: limit by effort (minutes).
-
-For example, if you locally set [[doc:org-agenda-max-todos][org-agenda-max-todos]] to 3 in an agenda
-view, the agenda will be limited to the first three todos. Other entries
-without a TODO keyword or beyond the third TODO headline will be ignored.
-
-When setting a limit (e.g. about an effort's sum), the default behavior is
-to exclude entries that cannot be checked against (e.g. entries that have
-no effort property.) To include other entries too, you can set the limit
-to a negative number. For example =(setq org-agenda-max-tags -3)= will not
-show the fourth tagged headline (and beyond), but it will also show
-non-tagged headlines.
-
-**** =~= in agenda view sets temporary limits
-
-You can hit =~= in the agenda to temporarily set limits: this will
-regenerate the agenda as if the limits were set. This is useful for
-example when you want to only see a list of =N= tasks, or a list of tasks
-that take only =N= minutes.
-
-**** "=" in agenda view filters by regular expressions
-
-You can now filter agenda entries by regular expressions using ~=~. =C-u
-== will filter entries out. Regexp filters are cumulative. You can set
-[[doc:org-agenda-regexp-filter-preset][org-agenda-regexp-filter-preset]] to suit your needs in each agenda view.
-
-**** =|= in agenda view resets all filters
-
-Since it's common to combine tag filters, category filters, and now regexp
-filters, there is a new command =|= to reset all filters at once.
-
-**** Allow writing an agenda to an =.org= file
-
-You can now write an agenda view to an =.org= file. It copies the
-headlines and their content (but not subheadings) into the new file.
-
-This is useful when you want to quickly share an agenda containing the full
-list of notes.
-
-**** New commands to drag an agenda line forward (=M-<down>=) or backward (=M-<up>=)
-
-It sometimes handy to move agenda lines around, just to quickly reorganize
-your tasks, or maybe before saving the agenda to a file. Now you can use
-=M-<down>= and =M-<up>= to move the line forward or backward.
-
-This does not persist after a refresh of the agenda, and this does not
-change the =.org= files who contribute to the agenda.
-
-**** Use =%b= for displaying "breadcrumbs" in the agenda view
-
-[[doc:org-agenda-prefix-format][org-agenda-prefix-format]] now allows to use a =%b= formatter to tell Org
-to display "breadcrumbs" in the agenda view.
-
-This is useful when you want to display the task hierarchy in your agenda.
-
-**** Use =%l= for displaying the headline's level in the agenda view
-
-[[doc:org-agenda-prefix-format][org-agenda-prefix-format]] allows to use a =%l= formatter to tell Org to
-display entries with additional spaces corresponding to their level in the
-outline tree.
-
-**** [[doc:org-agenda-write][org-agenda-write]] will ask before overwriting an existing file
-
-=M-x org-agenda-write RET= (or =C-c C-w= from an agenda buffer) used to
-overwrite preexisting file with the same name without confirmation. It now
-asks for a confirmation.
-
-**** New commands =M-m= and =M-*= to toggle (all) mark(s) for bulk action
-
-- [[doc:org-agenda-bulk-toggle][org-agenda-bulk-toggle]] :: this command is bound to =M-m= and toggles
- the mark of the entry at point.
-
-- [[doc:org-agenda-bulk-toggle-all][org-agenda-bulk-toggle-all]] :: this command is bound to =M-*= and
- toggles all the marks in the current agenda.
-
-**** New option [[doc:org-agenda-search-view-max-outline-level][org-agenda-search-view-max-outline-level]]
-
-This option sets the maximum outline level to display in search view.
-E.g. when this is set to 1, the search view will only show headlines of
-level 1.
-
-**** New option [[doc:org-agenda-todo-ignore-time-comparison-use-seconds][org-agenda-todo-ignore-time-comparison-use-seconds]]
-
-This allows to compare times using seconds instead of days when honoring
-options like =org-agenda-todo-ignore-*= in the agenda display.
-
-**** New option [[doc:org-agenda-entry-text-leaders][org-agenda-entry-text-leaders]]
-
-This allows you to get rid of the ">" character that gets added in front of
-entries excerpts when hitting =E= in the agenda view.
-
-**** New formatting string for past deadlines in [[doc:org-agenda-deadline-leaders][org-agenda-deadline-leaders]]
-
-The default formatting for past deadlines is ="%2d d. ago: "=, which makes
-it explicit that the deadline is in the past. You can configure this via
-[[doc:org-agenda-deadline-leaders][org-agenda-deadline-leaders]]. Note that the width of the formatting
-string is important to keep the agenda alignment clean.
-
-**** New allowed value =repeated-after-deadline= for [[doc:org-agenda-skip-scheduled-if-deadline-is-shown][org-agenda-skip-scheduled-if-deadline-is-shown]]
-
-When [[doc:org-agenda-skip-scheduled-if-deadline-is-shown][org-agenda-skip-scheduled-if-deadline-is-shown]] is set to
-=repeated-after-deadline=, the agenda will skip scheduled items if they are
-repeated beyond the current deadline.
-
-**** New option for [[doc:org-agenda-skip-deadline-prewarning-if-scheduled][org-agenda-skip-deadline-prewarning-if-scheduled]]
-
-This variable may be set to nil, t, the symbol `pre-scheduled', or a number
-which will then give the number of days before the actual deadline when the
-prewarnings should resume. The symbol `pre-scheduled' eliminates the
-deadline prewarning only prior to the scheduled date.
-
-Read the full docstring for details.
-
-**** [[doc:org-class][org-class]] now supports holiday strings in the skip-weeks parameter
-
-For example, this task will now be skipped only on new year's day:
-
- : * Task
- : <%%(org-class 2012 1 1 2013 12 12 2 "New Year's Day")>
-*** Capture
-
-**** Allow =C-1= as a prefix for [[doc:org-agenda-capture][org-agenda-capture]] and [[doc:org-capture][org-capture]]
-
-With a =C-1= prefix, the capture mechanism will use the =HH:MM= value at
-point (if any) or the current =HH:MM= time as the default time for the
-capture template.
-
-**** Expand keywords within %(sexp) placeholder in capture templates
-
-If you use a =%:keyword= construct within a =%(sexp)= construct, Org will
-expand the keywords before expanding the =%(sexp)=.
-
-**** Allow to contextualize capture (and agenda) commands by checking the name of the buffer
-
-[[doc:org-capture-templates-contexts][org-capture-templates-contexts]] and [[doc:org-agenda-custom-commands-contexts][org-agenda-custom-commands-contexts]]
-allow you to define what capture templates and what agenda commands should
-be available in various contexts. It is now possible for the context to
-check against the name of the buffer.
-*** Tag groups
-
-Using =#+TAGS: { Tag1 : Tag2 Tag3 }= will define =Tag1= as a /group tag/
-(note the colon after =Tag1=). If you search for =Tag1=, it will return
-headlines containing either =Tag1=, =Tag2= or =Tag3= (or any combination
-of those tags.)
-
-You can use group tags for sparse tree in an Org buffer, for creating
-agenda views, and for filtering.
-
-See https://orgmode.org/org.html#Tag-groups for details.
-
-*** Links
-
-**** =C-u C-u M-x org-store-link RET= will ignore non-core link functions
-
-Org knows how to store links from Org buffers, from info files and from
-other Emacs buffers. Org can be taught how to store links from any buffer
-through new link protocols (see [[https://orgmode.org/org.html#Adding-hyperlink-types]["Adding hyperlink types"]] in the manual.)
-
-Sometimes you want Org to ignore added link protocols and store the link
-as if the protocol was not known.
-
-You can now do this with =C-u C-u M-x org-store-link RET=.
-
-**** =C-u C-u C-u M-x org-store-link RET= on an active region will store links for each lines
-
-Imagine for example that you want to store a link for every message in a
-Gnus summary buffer. In that case =C-x h C-u C-u C-u M-x org-store-link
-RET= will store a link for every line (i.e. message) if the region is
-active.
-
-**** =C-c C-M-l= will add a default description for links which don't have one
-
-=C-c C-M-l= inserts all stored links. If a link does not have a
-description, this command now adds a default one, so that we are not mixing
-with-description and without-description links when inserting them.
-
-**** No curly braces to bracket links within internal links
-
-When storing a link to a headline like
-
-: * See [[https://orgmode.org][Org website]]
-
-[[doc:org-store-link][org-store-link]] used to convert the square brackets into curly brackets.
-It does not anymore, taking the link description or the link path, when
-there is no description.
-*** Table
-
-**** Switching between #+TBLFM lines
-
-If you have several =#+TBLFM= lines below a table, =C-c C-c= on a line will
-apply the formulas from this line, and =C-c C-c= on another line will apply
-those other formulas.
-
-**** You now use "nan" for empty fields in Calc formulas
-
-If empty fields are of interest, it is recommended to reread the section
-[[https://orgmode.org/org.html#Formula-syntax-for-Calc][3.5.2 Formula syntax for Calc]] of the manual because the description for the
-mode strings has been clarified and new examples have been added towards
-the end.
-
-**** Handle localized time-stamps in formulas evaluation
-
-If your =LOCALE= is set so that Org time-stamps use another language than
-english, and if you make time computations in Org's table, it now works by
-internally converting the time-stamps with a temporary =LOCALE=C= before
-doing computation.
-
-**** New lookup functions
-
-There are now three lookup functions:
-
-- [[doc:org-loopup-first][org-loopup-first]]
-- [[doc:org-loopup-last][org-loopup-last]]
-- [[doc:org-loopup-all][org-loopup-all]]
-
-See [[https://orgmode.org/org.html#Lookup-functions][the manual]] for details.
-*** Startup keywords
-
-These new startup keywords are now available:
-
-| Startup keyword | Option |
-|----------------------------------+---------------------------------------------|
-| =#+STARTUP: logdrawer= | =(setq org-log-into-drawer t)= |
-| =#+STARTUP: nologdrawer= | =(setq org-log-into-drawer nil)= |
-|----------------------------------+---------------------------------------------|
-| =#+STARTUP: logstatesreversed= | =(setq org-log-states-order-reversed t)= |
-| =#+STARTUP: nologstatesreversed= | =(setq org-log-states-order-reversed nil)= |
-|----------------------------------+---------------------------------------------|
-| =#+STARTUP: latexpreview= | =(setq org-startup-with-latex-preview t)= |
-| =#+STARTUP: nolatexpreview= | =(setq org-startup-with-latex-preview nil)= |
-
-*** Clocking
-
-**** New option [[doc:org-clock-rounding-minutes][org-clock-rounding-minutes]]
-
-E.g. if [[doc:org-clock-rounding-minutes][org-clock-rounding-minutes]] is set to 5, time is 14:47 and you
-clock in: then the clock starts at 14:45. If you clock out within the next
-5 minutes, the clock line will be removed; if you clock out 8 minutes after
-your clocked in, the clock out time will be 14:50.
-
-**** New option [[doc:org-time-clocksum-use-effort-durations][org-time-clocksum-use-effort-durations]]
-
-When non-nil, =C-c C-x C-d= uses effort durations. E.g., by default, one
-day is considered to be a 8 hours effort, so a task that has been clocked
-for 16 hours will be displayed as during 2 days in the clock display or in
-the clocktable.
-
-See [[doc:org-effort-durations][org-effort-durations]] on how to set effort durations and
-[[doc:org-time-clocksum-format][org-time-clocksum-format]] for more on time clock formats.
-
-**** New option [[doc:org-clock-x11idle-program-name][org-clock-x11idle-program-name]]
-
-This allows to set the name of the program which prints X11 idle time in
-milliseconds. The default is to use =x11idle=.
-
-**** New option [[doc:org-use-last-clock-out-time-as-effective-time][org-use-last-clock-out-time-as-effective-time]]
-
-When non-nil, use the last clock out time for [[doc:org-todo][org-todo]]. Note that this
-option has precedence over the combined use of [[doc:org-use-effective-time][org-use-effective-time]] and
-[[doc:org-extend-today-until][org-extend-today-until]].
-
-**** =S-<left/right>= on a clocksum column will update the sum by updating the last clock
-**** =C-u 3 C-S-<up/down>= will update clock timestamps synchronously by 3 units
-**** New parameter =:wstart= for clocktables to define the week start day
-**** New parameter =:mstart= to state the starting day of the month
-**** Allow relative times in clocktable tstart and tend options
-**** The clocktable summary is now a caption
-**** =:tstart= and =:tend= and friends allow relative times like "<-1w>" or "<now>"
-*** Babel
-
-**** You can now use =C-c C-k= for [[doc:org-edit-src-abort][org-edit-src-abort]]
-
-This allows you to quickly cancel editing a source block.
-
-**** =C-u C-u M-x org-babel-tangle RET= tangles by the target file of the block at point
-
-This is handy if you want to tangle all source code blocks that have the
-same target than the block at point.
-
-**** New options for auto-saving the base buffer or the source block editing buffer
-
-When [[doc:org-edit-src-turn-on-auto-save][org-edit-src-turn-on-auto-save]] is set to =t=, editing a source block
-in a new window will turn on =auto-save-mode= and save the code in a new
-file under the same directory than the base Org file.
-
-When [[doc:org-edit-src-auto-save-idle-delay][org-edit-src-auto-save-idle-delay]] is set to a number of minutes =N=,
-the base Org buffer will be saved after this number of minutes of idle
-time.
-
-**** New =:post= header argument post-processes results
-
- This header argument may be used to pass the results of the current
- code block through another code block for post-processing. See the
- manual for a usage example.
-
-**** Commented out heading are ignored when collecting blocks for tangling
-
-If you comment out a heading (with =C-c ;= anywhere on the heading or in
-the subtree), code blocks from within this heading are now ignored when
-collecting blocks for tangling.
-
-**** New option [[doc:org-babel-hash-show-time][org-babel-hash-show-time]] to show a time-stamp in the result hash
-**** Do not ask for confirmation if cached value is current
-
-Do not run [[doc:org-babel-confirm-evaluate][org-babel-confirm-evaluate]] if source block has a cache and the
-cache value is current as there is no evaluation involved in this case.
-**** =ob-sql.el= and =ob-python.el= have been improved.
-**** New Babel files only need to =(require 'ob)=
-
-When writing a new Babel file, you now only need to use =(require 'ob)=
-instead of requiring each Babel library one by one.
-*** Faces
-
-- Org now fontifies radio link targets by default
-- In the agenda, use [[doc:org-todo-keyword-faces][org-todo-keyword-faces]] to highlight selected TODO keywords
-- New face [[doc:org-priority][org-priority]], enhanced fontification of priority cookies in agenda
-- New face [[doc:org-tag-group][org-tag-group]] for group tags
-
-** Miscellaneous
-
-- New speedy key =s= pour [[doc:org-narrow-to-subtree][org-narrow-to-subtree]]
-- Handling of [[doc:org-html-table-row][org-html-table-row]] has been updated (incompatible change)
-- [[doc:org-export-html-table-tag][org-export-html-table-tag]] is replaced by [[doc:org-html-table-default-attributes][org-html-table-default-attributes]]
-- Support using =git-annex= with Org attachments
-- org-protocol: Pass optional value using query in url to capture from protocol
-- When the refile history is empty, use the current filename as default
-- When you cannot change the TODO state of a task, Org displays the blocking task
-- New option [[doc:org-mobile-allpriorities][org-mobile-allpriorities]]
-- org-bibtex.el now use =visual-line-mode= instead of the deprecated =longlines-mode=
-- [[doc:org-format-latex-options][org-format-latex-options]] allows to set the foreground/background colors automatically
-- New option [[doc:org-archive-file-header-format][org-archive-file-header-format]]
-- New "neg" entity in [[doc:org-entities][org-entities]]
-- New function [[doc:org-docview-export][org-docview-export]] to export docview links
-- New =:eps= header argument for ditaa code blocks
-- New option [[doc:org-gnus-no-server][org-gnus-no-server]] to start Gnus with =gnus-no-server=
-- Org is now distributed with =htmlize.el= version 1.43
-- ~org-drill.el~ has been updated to version 2.3.7
-- ~org-mac-iCal.el~ now supports OS X versions up to 10.8
-- Various improvements to ~org-contacts.el~ and =orgpan.el=
-
-** Outside Org
-
-*** Spanish translation of the Org guide by David Arroyo Menéndez
-
-David (and others) translated the Org compact guide in spanish:
-
-You can read the [[https://orgmode.org/worg/orgguide/orgguide.es.pdf][PDF guide]].
-
-*** ~poporg.el~ and ~outorg.el~
-
-Two new libraries (~poporg.el~ by François Pinard and ~outorg.el~ by
-Thorsten Jolitz) now enable editing of comment-sections from source-code
-buffers in temporary Org-mode buffers, making the full editing power of
-Org-mode available. ~outorg.el~ comes together with ~outshine.el~ and
-~navi-mode.el~, two more libraries by Thorsten Jolitz with the goal to give
-source-code buffers the /look & feel/ of Org-mode buffers while greatly
-improving navigation and structure editing. A detailed description can be
-found here: https://orgmode.org/worg/org-tutorials/org-outside-org.html
-
-Here are two screencasts demonstrating Thorsten's tools:
-
-- [[https://youtu.be/nqE6YxlY0rw]["Modern conventions for Emacs Lisp files"]]
-- [[https://www.youtube.com/watch?v%3DII-xYw5VGFM][Exploring Bernt Hansen's Org-mode tutorial with 'navi-mode']]
-
-*** MobileOrg for iOS
-
-MobileOrg for iOS back in the App Store The 1.6.0 release was focused on
-the new Dropbox API and minor bug fixes but also includes a new ability to
-launch in Capture mode. Track development and contribute [[https://github.com/MobileOrg/mobileorg/issues][on github]].
-
-* Version 7.9.3
-
-** New option [[doc::org-agenda-use-tag-inheritance][org-agenda-use-tag-inheritance]]
-
-[[doc::org-use-tag-inheritance][org-use-tag-inheritance]] controls whether tags are inherited when
-org-tags-view is called (either in =tags=, =tags-tree= or =tags-todo=
-agenda views.)
-
-When generating other agenda types such as =agenda=, =todo= and
-=todo-tree=, tags inheritance is not used when selecting the entries
-to display. Still, you might want to have all tag information correct
-in the agenda buffer, e.g. for tag filtering. In that case, add the
-agenda type to this variable.
-
-Setting this variable to nil should considerably speeds up the agenda
-generation.
-
-Note that the default was to display inherited tags in the agenda
-lines even if `org-use-tag-inheritance' was nil. The default is now
-to *never* display inherited tags in agenda lines, but to /know/ about
-them when the agenda type is listed in [[doc::org-agenda-use-tag-inheritance][org-agenda-use-tag-inheritance]].
-
-** New default value =nil= for [[doc::org-agenda-dim-blocked-tasks][org-agenda-dim-blocked-tasks]]
-
-Using `nil' as the default value speeds up the agenda generation. You
-can hit `#' (or `C-u #') in agenda buffers to temporarily dim (or turn
-invisible) blocked tasks.
-
-** New speedy keys for [[doc::org-speed-commands-default][org-speed-commands-default]]
-
-You can now use `:' (instead of `;') for setting tags---this is
-consistent with using the `:' key in agenda view.
-
-You can now use `=' for [[doc::org-columns][org-columns]].
-
-** =org-float= is now obsolete, use =diary-float= instead
-** No GPL manual anymore
-
-There used to be a GPL version of the Org manual, but this is not the
-case anymore, the Free Software Foundation does not permit this.
-
-The GNU FDL license is now included in the manual directly.
-
-** Enhanced compatibility with Emacs 22 and XEmacs
-
-Thanks to Achim for his work on enhancing Org's compatibility with
-various Emacsen. Things may not be perfect, but Org should work okay
-in most environments.
-
-* Version 7.9.2
-
-** New ELPA repository for Org packages
-
-You can now add the Org ELPA repository like this:
-
-#+BEGIN_SRC emacs-lisp
-(add-to-list 'package-archives '("org" . "https://orgmode.org/elpa/") t)
-#+END_SRC
-
-It contains both the =org-*.tar= package (the core Org distribution, also
-available through https://elpa.gnu.org) and the =org-plus*.tar= package (the
-extended Org distribution, with non-GNU packages from the =contrib/=
-directory.)
-
-See https://orgmode.org/elpa/
-
-** Overview of the new keybindings
-
- | Keybinding | Speedy | Command |
- |-----------------+--------+-----------------------------|
- | =C-c C-x C-z= | | [[doc::org-clock-resolve][org-clock-resolve]] |
- | =C-c C-x C-q= | | [[doc::org-clock-cancel][org-clock-cancel]] |
- | =C-c C-x C-x= | | [[doc::org-clock-in-last][org-clock-in-last]] |
- | =M-h= | | [[doc::org-mark-element][org-mark-element]] |
- | =*= | | [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]] |
- | =C-c C-M-l= | | [[doc::org-insert-all-links][org-insert-all-links]] |
- | =C-c C-x C-M-v= | | [[doc::org-redisplay-inline-images][org-redisplay-inline-images]] |
- | =C-c C-x E= | =E= | [[doc::org-inc-effort][org-inc-effort]] |
- | | =#= | [[doc::org-toggle-comment][org-toggle-comment]] |
- | | =:= | [[doc::org-columns][org-columns]] |
- | | =W= | Set =APPT_WARNTIME= |
- | =k= | | [[doc::org-agenda-capture][org-agenda-capture]] |
- | C-c , | , | [[doc::org-priority][org-priority]] |
-
-** New package and Babel language
-
-*** =org-eshell.el= by Konrad Hinsen is now in Org
-
- =org-eshell.el= allows you to create links from [[https://www.gnu.org/software/emacs/manual/html_node/eshell/index.html][Eshell]].
-
-*** Support for execution of Scala code blocks (see ob-scala.el)
-*** Support for execution of IO code blocks (see ob-io.el)
-
-** Incompatible changes
-
- - If your code relies on =org-write-agenda=, please use
- [[doc::org-agenda-write][org-agenda-write]] from now on.
-
- - If your code relies on =org-make-link=, please use =concat=
- instead.
-
- - =org-link-to-org-use-id= has been renamed to
- =org-id-link-to-org-use-id= and its default value is nil. The
- previous default was =create-if-interactive-and-no-custom-id=.
-
-** New features and user-visible changes
-
-*** Org Element
-
- =org-element.el= is a toolbox for parsing and analyzing "elements"
- in an Org-mode buffer. This has been written by Nicolas Goaziou
- and has been tested for quite some time. It is now part of Org's
- core and many core functions rely on this package.
-
- Two functions might be particularly handy for users:
- =org-element-at-point= and =org-element-context=.
-
- See the docstrings for more details.
-
- Below is a list of editing and navigating commands that now rely
- on =org-element.el=.
-
-**** [[doc::org-fill-paragraph][org-fill-paragraph]] has been completely rewritten
-
- The filling mechanisms now rely on org-element, trying to do the
- right thing on each element in various contexts. E.g. filling in
- a list item will preserve indentation; filling in message-mode
- will fall back on the relevant filling functions; etc.
-
-**** [[doc::org-metaup][org-metaup]] and [[doc::org-metadown][org-metadown]] will drag the element backward/forward
-
- If you want to get the old behavior (i.e. moving a line up and
- down), you can first select the line as an active region, then
- =org-metaup= or =org-metadown= to move the region backward or
- forward. This also works with regions bigger than just one line.
-
-**** [[doc::org-up-element][org-up-element]] and [[doc::org-down-element][org-down-element]] (respectively =C-c C-^= and =C-c C-_=)
-
- This will move the point up/down in the hierarchy of elements.
-
-**** [[doc::org-backward-element][org-backward-element]] and [[doc::org-forward-element][org-forward-element]] (respectively =M-{= and =M-}=)
-
- This will move the point backward/forward in the hierarchy of
- elements.
-
-**** [[doc::org-narrow-to-element][org-narrow-to-element]] will narrow to the element at point
-**** [[doc::org-mark-element][org-mark-element]] will mark the element at point
-
- This command is bound to =M-h= and will mark the element at
- point. If the point is at a paragraph, it will mark the
- paragraph. If the point is at a list item, it will mark the list
- item. Etc.
-
- Note that if point is at the beginning of a list, it will mark
- the whole list.
-
- To mark a subtree, you can either use =M-h= on the headline
- (since there is no ambiguity about the element you're at) or
- [[doc::org-mark-subtree][org-mark-subtree]] (=C-c @=) anywhere in the subtree.
-
- Invoking [[doc::org-mark-element][org-mark-element]] repeatedly will try to mark the next
- element on top of the previous one(s). E.g. hitting =M-h= twice
- on a headline will mark the current subtree and the next one on
- the same level.
-
-*** Org Agenda
-
-**** New option [[doc::org-agenda-sticky][org-agenda-sticky]]
-
- There is a new option =org-agenda-sticky= which enables "sticky"
- agendas. Sticky agendas remain opened in the background so that
- you don't need to regenerate them each time you hit the
- corresponding keystroke. This is a big time saver.
-
- When [[doc::org-agenda-sticky][org-agenda-sticky]] is =non-nil=, the agenda buffer will be
- named using the agenda key and its description. In sticky
- agendas, the =q= key will just bury the agenda buffers and
- further agenda commands will show existing buffer instead of
- generating new ones.
-
- If [[doc::org-agenda-sticky][org-agenda-sticky]] is set to =nil=, =q= will kill the single
- agenda buffer.
-
-**** New option [[doc::org-agenda-custom-commands-contexts][org-agenda-custom-commands-contexts]]
-
- Setting this option allows you to define specific context where
- agenda commands should be available from. For example, when set
- to this value
-
- #+BEGIN_SRC emacs-lisp
- (setq org-agenda-custom-commands-contexts
- '(("p" (in-file . "\\.txt"))))
-#+END_SRC
-
- then the =p= agenda command will only be available from buffers
- visiting *.txt files. See the docstring and the manual for more
- details on how to use this.
-
-**** Changes in bulk actions
-
- The set of commands starting with =k ...= as been deleted and the
- features have been merged into the "bulk action" feature.
-
- After you marked some entries in the agenda, if you call =B s=,
- the agenda entries will be rescheduled using the date at point if
- on a date header. If you are on an entry with a timestamp, you
- will be prompted for a date to reschedule your marked entries to,
- using the timestamp at point as the default prompt.
-
- You can now use =k= to capture the marked entry and use the date
- at point as an overriding date for the capture template.
-
- To bind this behavior to =M-x org-capture RET= (or its
- keybinding), set the new option [[doc::org-capture-use-agenda-date][org-capture-use-agenda-date]] to
- =t=.
-
-**** =N= and =P= in the agenda will move to the next/previous item
-
-**** New command [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]] to mark all items
-
- This new command is bound to =*= in agenda mode.
-
- There is also a new option [[doc::org-agenda-bulk-mark-char][org-agenda-bulk-mark-char]] to set the
- character to use as a mark for bulk actions.
-
-**** New option [[doc::org-agenda-persistent-marks][org-agenda-persistent-marks]]
-
- When set to =non-nil=, marks will remain visible after a bulk
- action. You can temporarily toggle this by pressing =p= when
- invoking [[doc::org-agenda-bulk-action][org-agenda-bulk-action]]. Marks are deleted if your
- rebuild the agenda buffer or move to another date/span (e.g. with
- =f= or =w=).
-
-**** New option [[doc::org-agenda-skip-timestamp-if-deadline-is-shown][org-agenda-skip-timestamp-if-deadline-is-shown]]
-
- =Non-nil= means skip timestamp line if same entry shows because
- of deadline.
-
- In the agenda of today, an entry can show up multiple times
- because it has both a plain timestamp and has a nearby deadline.
- When this variable is t, then only the deadline is shown and the
- fact that the entry has a timestamp for or including today is not
- shown. When this variable is =nil=, the entry will be shown
- several times.
-
-**** New =todo-unblocked= and =nottodo-unblocked= skip conditions
-
- See the [[https://orgmode.org/cgit.cgi/org-mode.git/commit/?id=f426da][git commit]] for more explanations.
-
-**** Allow category filtering in the agenda
-
- You can now filter the agenda by category. Pressing "<" will
- filter by the category of the item on the current line, and
- pressing "<" again will remove the filter. You can combine tag
- filters and category filters.
-
- You can use =org-agenda-category-filter= in your custom agenda
- views and =org-agenda-category-filter-preset= in your main
- configuration.
-
- See also the new command [[doc::org-agenda-filter-by-top-category][org-agenda-filter-by-top-category]]:
- hitting =^= will filter by "Top" category: only show entries that
- are of the same category than the Top category of the entry at
- point.
-
-*** Org Links
-
-**** Inserting links
-
- When inserting links through [[doc::org-insert-link][org-insert-link]], the description is
- now displayed first, followed by the literal link, as the
- description is often more useful when you look for the link you
- want to insert.
-
- Completion now complete both literal links and description. If
- you complete a description, the literal link and its description
- will be inserted directly, whereas when you complete the literal
- link, you will be prompted for a description (as with Org 7.8.)
-
- In the completion buffer, links to the current buffer are now
- highlighted.
-
-**** New templates =%h= and =%(sexp)= for abbreviated links
-
- On top of =%s= template, which is replaced by the link tag in
- abbreviated links, you can now use =%h= (which does the same than =%s=
- but does not hexify the tag) and =%(sexp)= (which can run a function
- that takes the tag as its own argument.)
-
-**** New link type =help=
-
- You can now create links from =help= buffers.
-
- For example, if you request help for the command [[doc::org-agenda][org-agenda]] with
- =C-h f org-agenda RET=, creating a link from this buffer will let
- you go back to the same buffer.
-
-**** New command [[doc::org-insert-all-links][org-insert-all-links]]
-
- This will insert all links as list items. With a universal
- prefix argument, links will not be deleted from the variable
- =org-stored-links=.
-
- This new command is bound to =C-c C-M-l=.
-
-**** New option [[doc::org-url-hexify-p][org-url-hexify-p]]
-
- When set to =nil=, the =URL= part of a link will not be hexified.
-
-**** Org can now open multiple shell links
-
-**** New option [[doc::org-doi-server-url][org-doi-server-url]] to specify an alternate DOI server
-
-**** RET now follows time stamps links
-
-*** Org Editing
-
-**** [[doc::org-todo][org-todo]] and =org-archive-*= can now loop in the active region
-
- When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, using
- [[doc::org-todo][org-todo]] or =org-archive-*= commands in the active region will
- loop over headlines. This is handy if you want to set the TODO
- keyword for several items, or archive them quickly.
-
-**** You can now set tags for headlines in a region
-
- If [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, then
- selecting the region and hitting =C-c C-q= will set the tags for
- all headlines in the region.
-
-**** New command [[doc::org-insert-drawer][org-insert-drawer]] to insert a drawer interactively
-
-**** Comments start with "^[ \t]*# " anywhere on a line
-
- Note that the space after the hashtag is mandatory. Comments
- with "^#+" are not supported anymore.
-
-**** New speed key =#= to toggle the COMMENT cookie on a headline
-
-**** =indent-region-function= is now set to [[doc::org-indent-region][org-indent-region]]
-
- =C-M-\= should now produce useful results.
-
- You can unindent the buffer with [[doc::org-unindent-buffer][org-unindent-buffer]].
-
-**** New option [[doc::org-allow-promoting-top-level-subtree][org-allow-promoting-top-level-subtree]]
-
- When =non-nil=, =S-M-<left>= will promote level-1 subtrees
- containing other subtrees. The level-1 headline will be
- commented out. You can revert to the previous state with =M-x
- undo RET=.
-
-*** Org Clock
-
-**** New keybinding =C-c C-x C-z= for [[doc::org-clock-resolve][org-clock-resolve]]
-
-**** New keybinding =C-c C-x C-q= for [[doc::org-clock-cancel][org-clock-cancel]]
-
-**** New command [[doc::org-clock-in-last][org-clock-in-last]] to clock in the last clocked item
-
- This command is bound to =C-c C-x C-x= and will clock in the last
- clocked entry, if any.
-
-**** =C-u M-x= [[doc::org-clock-out][org-clock-out]] =RET= now prompts for a state to switch to
-
-**** =S-M-<up/down>= on a clock timestamps adjusts the previous/next clock
-
-**** New option [[doc::org-clock-continuously][org-clock-continuously]]
-
- When set to =nil=, clocking in a task will first try to find the
- last clocked out task and restart from when that task was clocked
- out.
-
- You can temporarily activate continuous clocking with =C-u C-u
- C-u M-x= [[doc::org-clock-in][org-clock-in]] =RET= (three universal prefix arguments)
- and =C-u C-u M-x= [[doc::org-clock-in-last][org-clock-in-last]] =RET= (two universal prefix
- arguments).
-
-
-**** New option [[doc::org-clock-frame-title-format][org-clock-frame-title-format]]
-
- This option sets the value of =frame-title-format= when clocking
- in.
-
-**** New options for controlling the clockreport display
-
- [[doc::org-clock-file-time-cell-format][org-clock-file-time-cell-format]]: Format string for the file time
- cells in clockreport.
-
- [[doc::org-clock-total-time-cell-format][org-clock-total-time-cell-format]]: Format string for the total
- time cells in clockreport.
-
-
-**** New options for controlling the clock/timer display
-
- [[doc::org-clock-clocked-in-display][org-clock-clocked-in-display]]: control whether the current clock
- is displayed in the mode line and/or frame title.
-
- [[doc::org-timer-display][org-timer-display]]: control whether the current timer is displayed
- in the mode line and/or frame title.
-
- This allows the clock and timer to be displayed in the frame
- title instead of, or as well as, the mode line. This is useful
- for people with limited space in the mode line but with ample
- space in the frame title.
-
-*** Org Appearance
-
-**** New option [[doc::org-custom-properties][org-custom-properties]]
-
- The visibility of properties listed in this options can be turn
- on/off with [[doc::org-toggle-custom-properties-visibility][org-toggle-custom-properties-visibility]]. This might
- be useful for properties used by third-part tools or that you
- don't want to see temporarily.
-
-**** New command [[doc::org-redisplay-inline-images][org-redisplay-inline-images]]
-
- This will redisplay all images. It is bound to =C-c C-x C-M-v=.
-
-**** New entities in =org-entities.el=
-
- There are these new entities:
-
- : ("tilde" "\\~{}" nil "&tilde;" "~" "~" "~")
- : ("slash" "/" nil "/" "/" "/" "/")
- : ("plus" "+" nil "+" "+" "+" "+")
- : ("under" "\\_" nil "_" "_" "_" "_")
- : ("equal" "=" nil "=" "=" "=" "=")
- : ("asciicirc" "\\textasciicircum{}" nil "^" "^" "^" "^")
-
-**** New face =org-list-dt= for definition terms
-**** New face =org-date-selected= for the selected calendar day
-**** New face value for =org-document-title=
-
- The face is back to a normal height.
-
-*** Org Columns
-
-**** New speed command =:= to activate the column view
-**** New special property =CLOCKSUM_T= to display today's clocked time
-
- You can use =CLOCKSUM_T= the same way you use =CLOCKSUM=. It
- will display the time spent on tasks for today only.
-
-**** Use the =:COLUMNS:= property in columnview dynamic blocks
-
- If the =:COLUMNS:= is set in a subtree, the columnview dynamic
- block will use its value as the column format.
-
-**** Consider inline tasks when computing a sum
-
-*** Org Dates and Time Stamps
-
-**** Enhanced [[doc::org-sparse-tree][org-sparse-tree]]
-
- =C-c /= can now check for time ranges.
-
- When checking for dates with =C-c /= it is useful to change the
- type of dates that you are interested in. You can now do this
- interactively with =c= after =C-c /= and/or by setting
- [[doc::org-sparse-tree-default-date-type][org-sparse-tree-default-date-type]] to the default value you want.
-
-**** Support for hourly repeat cookies
-
- You can now use
-
- : SCHEDULED: <2012-08-20 lun. 08:00 +1h>
-
- if you want to add an hourly repeater to an entry.
-
-**** =C-u C-u C-c .= inserts a time-stamp with no prompt
-
-**** When (setq [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] 'time), accept days in the prompt
-
- "8am Wed" and "Wed 8am" are now acceptable values when entering a
- date from the prompt. If [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] is set to
- =time=, this will produce the expected prompt indication.
-
-**** New option [[doc::org-datetree-add-timestamp][org-datetree-add-timestamp]]
-
- When set to =non-nil=, datetree entries will also have a
- timestamp. This is useful if you want to see these entries in a
- sparse tree with =C-c /=.
-
-*** Org Capture
-
-**** New command [[doc::org-capture-string][org-capture-string]]
-
- M-x [[doc::org-capture-string][org-capture-string]] RET will prompt for a string and a capture
- template. The string will be used as an annotation for the
- template. This is useful when capturing in batch mode as it lets
- you define the content of the template without being in Emacs.
-
-**** New option [[doc::org-capture-templates-contexts][org-capture-templates-contexts]]
-
- Setting this option allows you to define specific context where
- capture templates should be available from. For example, when
- set to this value
-
- #+BEGIN_SRC emacs-lisp
- (setq org-capture-templates-contexts
- '(("c" (in-mode . "message-mode"))))
-#+END_SRC
-
- then the =c= capture template will only be available from
- =message-mode= buffers. See the docstring and the manual for
- more details on how to use this.
-
-**** New =%l= template to insert the literal link
-**** New option [[doc::org-capture-bookmark][org-capture-bookmark]]
-
- Org used to automatically add a bookmark with capture a note.
- You can now turn this on by setting [[doc::org-capture-bookmark][org-capture-bookmark]] to
- =nil=.
-
-**** Expand =%<num>= escape sequences into text entered for <num>'th =%^{PROMPT}= escape
-
- See the manual for more explanations.
-
-**** More control over empty lines
-
- You can use =:empty-lines-before= and =:empty-lines-after= to
- control the insertion of empty lines. Check the manual for more
- explanations.
-
-**** New hook [[doc::org-capture-prepare-finalize-hook][org-capture-prepare-finalize-hook]]
-
- This new hook runs before the finalization process starts.
-
-*** Org Export
-
-**** New functions =orgtbl-to-table.el= and =orgtbl-to-unicode=
-
- =orgtbl-to-table.el= convert the table to a =table.el= table, and
- =orgtbl-to-unicode= will use =ascii-art-to-unicode.el= (when
- available) to print beautiful tables.
-
-**** [[doc::org-table-export][org-table-export]] now a bit clever about the target format
-
- When you specify a file name like =table.csv=, [[doc::org-table-export][org-table-export]]
- will now suggest =orgtbl-to-csv= the default method for exporting
- the table.
-
-**** New option [[doc::org-export-date-timestamp-format][org-export-date-timestamp-format]]
-
- The option allows to set a time string format for Org timestamps
- in the #+DATE option.
-
-**** LaTeX: New options for exporting table rules :tstart, :hline and :tend
-
- See [[doc::org-export-latex-tables-hline][org-export-latex-tables-hline]] and [[doc::org-export-latex-tables-tend][org-export-latex-tables-tend]].
-
-**** LaTeX: You can now set =:hfmt= from =#+ATTR_LaTeX=
-**** Beamer: Add support and keybinding for the =exampleblock= environment
-
- Add support for these languages in [[doc::org-export-language-setup][org-export-language-setup]].
- More languages are always welcome.
-
-**** Beamer: New option [[doc::org-beamer-inherited-properties][org-beamer-inherited-properties]]
-
- This option allows Beamer export to inherit some properties.
- Thanks to Carsten for implementing this.
-
-**** ODT: Add support for ODT export in org-bbdb.el
-**** ODT: Add support for indented tables (see [[https://orgmode.org/cgit.cgi/org-mode.git/commit/?id=e9fd33][this commit]] for details)
-**** ODT: Improve the conversion from ODT to other formats
-**** ASCII: Swap the level-1/level-2 characters to underline the headlines
-**** Support for Chinese, simplified Chinese, Russian, Ukrainian and Japanese
-**** HTML: New option [[doc::org-export-html-date-format-string][org-export-html-date-format-string]]
-
- Format string to format the date and time in HTML export. Thanks
- to Sébastien Vauban for this patch.
-
-*** Org Babel
-
-**** New =:results drawer= parameter
-
-=:results drawer= replaces =:results wrap=, which is deprecated but still
-supported.
-
-**** =:results org= now put results in a =#+BEGIN_SRC org= block
-
-=:results org= used to put results in a =#+BEGIN_ORG= block but it now puts
-results in a =#+BEGIN_SRC org= block, with comma-escaped lines.
-
-=#+BEGIN_ORG= blocks are obsolete.
-
-**** Exporting =#+BEGIN_SRC org= blocks exports the code
-
-It used to exports the results of the code.
-
-*** Miscellaneous
-
-**** New menu entry for [[doc::org-refile][org-refile]]
-**** Allow capturing to encrypted entries
-
-If you capture to an encrypted entry, it will be decrypted before
-inserting the template then re-encrypted after finalizing the capture.
-
-**** Inactive timestamps are now handled in tables
-
-Calc can do computation on active time-stamps like <2012-09-29 sat.>.
-Inactive time-stamps in a table's cell are now internally deactivated so
-that Calc formulas can operate on them.
-
-**** [[doc::org-table-number-regexp][org-table-number-regexp]] can now accept comma as decimal mark
-**** Org allows a new property =APPT_WARNTIME=
-
- You can set it with the =W= speedy key or set it manually. When
- set, exporting to iCalendar and [[doc::org-agenda-to-appt][org-agenda-to-appt]] will use the
- value of this property as the number of minutes for the warning
- alarm.
-
-**** New command [[doc::org-inc-effort][org-inc-effort]]
-
- This will increment the effort value.
-
- It is bound to =C-c C-x E= and to =E= as a speedy command.
-
-**** Attach: Add support for creating symbolic links
-
- =org-attach-method= now supports a new method =lns=, allowing to
- attach symbolic links.
-
-**** Archive: you can now archive to a datetree
-
-**** New option [[doc::org-inlinetask-show-first-star][org-inlinetask-show-first-star]]
-
- =Non-nil= means display the first star of an inline task as
- additional marker. When =nil=, the first star is not shown.
-
-**** New option [[doc::org-latex-preview-ltxpng-directory][org-latex-preview-ltxpng-directory]]
-
- This lets you define the path for the =ltxpng/= directory.
-
-**** You can now use imagemagick instead of dvipng to preview LaTeX fragments
-**** You can now turn off [[doc::orgstruct++-mode][orgstruct++-mode]] safely
-**** =C-u C-c C-c= on list items to add check boxes
-
- =C-u C-c C-c= will add an empty check box on a list item.
-
- When hit from the top of the list, it will add check boxes for
- all top level list items.
-
-**** =org-list-ending-method= and =org-list-end-regexp= are now obsolete
-
- Fall back on using =org-list-end-re= only, which see.
-
-**** org-feed.el now expands =%(sexp)= templates
-**** New option [[doc::org-protocol-data-separator][org-protocol-data-separator]]
-
-**** New option [[doc::org-ditaa-jar-option][org-ditaa-jar-option]] to specify the ditaa jar file
-
-**** New possible value for [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]]
-
- When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is set to
- =start-level=, the command will loop over the active region but
- will only act upon entries that are of the same level than the
- first headline in the region.
-
-**** New option [[doc::org-habit-show-all-today][org-habit-show-all-today]]
-
- When set to =t=, show all (even unscheduled) habits on today's
- agenda.
-
-** Important bug fixes
-
-*** M-TAB on options keywords perform completion correctly again
-
- If you hit =M-TAB= on keywords like =#+TITLE=, Org will try to
- perform completion with meaningful values.
-
-*** Add licenses to javascript embedded and external code snippets
-
- Embedded javascript code produced when exporting an Org file to
- HTML is now licensed under GPLv3 (or later), and the copyright is
- owned by the Free Software Foundation, Inc.
-
- The javascript code for embedding MathJax in the browser mentions
- the MathJax copyright and the Apache 2.0 license.
-
- The javascript code for embedding =org-injo.js= in the browser
- mentions the copyright of Sebastian Rose and the GPLv3 (or later)
- license.
-
- =org-export-html-scripts= is now a variable, so that you can adapt
- the code and the license to your needs.
-
- See https://www.gnu.org/philosophy/javascript-trap.html for
- explanations on why these changes were necessary.
-
-* Version 7.8.11
-
-** Incompatible changes
-
-*** Emacs 21 support has been dropped
-
- Do not use Org mode 7.xx with Emacs 21, use [[https://orgmode.org/org-6.36c.zip][version 6.36c]] instead.
-
-*** XEmacs support requires the XEmacs development version
-
- To use Org mode 7.xx with XEmacs, you need to run the developer
- version of XEmacs. We were about to drop XEmacs support entirely,
- but Michael Sperber stepped in and made changes to XEmacs that
- made it easier to keep the support. Thanks to Michael for this
- last-minute save.
-
-*** New keys for TODO sparse trees
-
- The key =C-c C-v= is now reserved for Org Babel action. TODO
- sparse trees can still be made with =C-c / t= (all not-done
- states) and =C-c / T= (specific states).
-
-*** The Agenda =org-agenda-ndays= is now obsolete
-
- The variable =org-agenda-ndays= is obsolete - please use
- =org-agenda-span= instead.
-
- Thanks to Julien Danjou for this.
-
-*** Changes to the intended use of =org-export-latex-classes=
-
- So far this variable has been used to specify the complete header
- of the LaTeX document, including all the =\usepackage= calls
- necessary for the document. This setup makes it difficult to
- maintain the list of packages that Org itself would like to call,
- for example for the special symbol support it needs.
-
- First of all, you can *opt out of this change* in the following
- way: You can say: /I want to have full control over headers, and I
- will take responsibility to include the packages Org needs/. If
- that is what you want, add this to your configuration and skip the
- rest of this section (except maybe for the description of the
- =[EXTRA]= place holder):
-
- #+begin_src emacs-lisp
- (setq org-export-latex-default-packages-alist nil
- org-export-latex-packages-alist nil)
- #+end_src
-
- /Continue to read here if you want to go along with the modified
- setup./
-
- There are now two variables that should be used to list the LaTeX
- packages that need to be included in all classes. The header
- definition in =org-export-latex-classes= should then not contain
- the corresponding =\usepackage= calls (see below).
-
- The two new variables are:
-
- 1. =org-export-latex-default-packages-alist= :: This is the
- variable where Org-mode itself puts the packages it needs.
- Normally you should not change this variable. The only
- reason to change it anyway is when one of these packages
- causes a conflict with another package you want to use. Then
- you can remove that packages and hope that you are not using
- Org-mode functionality that needs it.
-
- 2. =org-export-latex-packages-alist= :: This is the variable where
- you can put the packages that you'd like to use across all
- classes.
-
- The sequence how these customizations will show up in the LaTeX
- document are:
-
- 1. Header from =org-export-latex-classes=
- 2. =org-export-latex-default-packages-alist=
- 3. =org-export-latex-packages-alist=
- 4. Buffer-specific things set with =#+LaTeX_HEADER:=
-
- If you want more control about which segment is placed where, or
- if you want, for a specific class, have full control over the
- header and exclude some of the automatic building blocks, you can
- put the following macro-like place holders into the header:
-
- #+begin_example
- [DEFAULT-PACKAGES] \usepackage statements for default packages
- [NO-DEFAULT-PACKAGES] do not include any of the default packages
- [PACKAGES] \usepackage statements for packages
- [NO-PACKAGES] do not include the packages
- [EXTRA] the stuff from #+LaTeX_HEADER
- [NO-EXTRA] do not include #+LaTeX_HEADER stuff
- #+end_example
-
- If you have currently customized =org-export-latex-classes=, you
- should revise that customization and remove any package calls that
- are covered by =org-export-latex-default-packages-alist=. This
- applies to the following packages:
-
- - inputenc
- - fontenc
- - fixltx2e
- - graphicx
- - longtable
- - float
- - wrapfig
- - soul
- - t1enc
- - textcomp
- - marvosym
- - wasysym
- - latexsym
- - amssymb
- - hyperref
-
- If one of these packages creates a conflict with another package
- you are using, you can remove it from
- =org-export-latex-default-packages-alist=. But then you risk that
- some of the advertised export features of Org will not work
- properly.
-
- You can also consider moving packages that you use in all classes
- to =org-export-latex-packages-alist=. If necessary, put the place
- holders so that the packages get loaded in the right sequence. As
- said above, for backward compatibility, if you omit the place
- holders, all the variables will dump their content at the end of
- the header.
-
-*** The constant =org-html-entities= is obsolete
-
- Its content is now part of the new constant =org-entities=, which
- is defined in the file org-entities.el. =org-html-entities= was
- an internal variable, but it is possible that some users did write
- code using it.
-
-*** =org-bbdb-anniversary-format-alist= has changed
-
- Please check the docstring and update your settings accordingly.
-
-*** Deleted =org-mode-p=
-
- This function has been deleted: please update your code.
-
-** Important new features
-
-*** New Org to ODT exporter
-
- Jambunathan's Org to ODT exporter is now part of Org.
-
- To use it, it `C-c C-e o' in an Org file. See the documentation
- for more information on how to customize it.
-
-*** org-capture.el is now the default capture system
-
- This replaces the earlier system org-remember. The manual only
- describes org-capture, but for people who prefer to continue to
- use org-remember, we keep a static copy of the former manual
- section [[https://orgmode.org/org-remember.pdf][chapter about remember]].
-
- The new system has a technically cleaner implementation and more
- possibilities for capturing different types of data. See
- [[msg:C46F10DC-DE51-43D4-AFFE-F71E440D1E1F@gmail.com][Carsten's announcement]] for more details.
-
- To switch over to the new system:
-
- 1. Run
-
- : M-x org-capture-import-remember-templates RET
-
- to get a translated version of your remember templates into the
- new variable =org-capture-templates=. This will "mostly" work,
- but maybe not for all cases. At least it will give you a good
- place to modify your templates. After running this command,
- enter the customize buffer for this variable with
-
- : M-x customize-variable RET org-capture-templates RET
-
- and convince yourself that everything is OK. Then save the
- customization.
-
- 2. Bind the command =org-capture= to a key, similar to what you did
- with org-remember:
-
- : (define-key global-map "\C-cc" 'org-capture)
-
- If your fingers prefer =C-c r=, you can also use this key once
- you have decided to move over completely to the new
- implementation. During a test time, there is nothing wrong
- with using both system in parallel.
-
-** New libraries
-
-*** New Org libraries
-**** org-eshell.el (Konrad Hinsen)
-
- Implement links to eshell buffers.
-
-**** org-special-blocks (Carsten Dominik)
-
- This package generalizes the #+begin_foo and #+end_foo tokens.
-
- To use, put the following in your init file:
-
- #+BEGIN_EXAMPLE
-(require 'org-special-blocks)
-#+END_EXAMPLE
-
- The tokens #+begin_center, #+begin_verse, etc. existed
- previously. This package generalizes them (at least for the
- LaTeX and html exporters). When a #+begin_foo token is
- encountered by the LaTeX exporter, it is expanded
- into \begin{foo}. The text inside the environment is not
- protected, as text inside environments generally is.
- When #+begin_foo is encountered by the html exporter, a div with
- class foo is inserted into the HTML file. It is up to the user
- to add this class to his or her stylesheet if this div is to mean
- anything.
-
-**** org-taskjuggler.el (Christian Egli)
-
- Christian Egli's /org-taskjuggler.el/ module is now part of Org.
- He also wrote a [[https://orgmode.org/worg/org-tutorials/org-taskjuggler.php][tutorial]] for it.
-
-**** org-ctags.el (Paul Sexton)
-
- Targets like =<<my target>>= can now be found by Emacs' etag
- functionality, and Org-mode links can be used to to link to
- etags, also in non-Org-mode files. For details, see the file
- /org-ctags.el/.
-
- This feature uses a new hook =org-open-link-functions= which will
- call function to do something special with text links.
-
- Thanks to Paul Sexton for this contribution.
-
-**** org-docview.el (Jan Böcker)
-
- This new module allows links to various file types using docview, where
- Emacs displays images of document pages. Docview link types can point
- to a specific page in a document, for example to page 131 of the
- Org-mode manual:
-
- : [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]]
-
- Thanks to Jan Böcker for this contribution.
-
-*** New Babel libraries
-
-- ob-picolisp.el (Thorsten Jolitz)
-- ob-fortran.el (Sergey Litvinov)
-- ob-shen.el (Eric Schulte)
-- ob-maxima.el (Eric S Fraga)
-- ob-java.el (Eric Schulte)
-- ob-lilypond.el (Martyn Jago)
-- ob-awk.el (Eric Schulte)
-
-** Other new features and various enhancements
-
-*** Hyperlinks
-
-**** Org-Bibtex -- major improvements
-
- Provides support for managing bibtex bibliographical references
- data in headline properties. Each headline corresponds to a
- single reference and the relevant bibliographic meta-data is
- stored in headline properties, leaving the body of the headline
- free to hold notes and comments. Org-bibtex is aware of all
- standard bibtex reference types and fields.
-
- The key new functions are
-
- - org-bibtex-check :: queries the user to flesh out all required
- (and with prefix argument optional) bibtex fields available
- for the specific reference =type= of the current headline.
-
- - org-bibtex-create :: Create a new entry at the given level,
- using org-bibtex-check to flesh out the relevant fields.
-
- - org-bibtex-yank :: Yank a bibtex entry on the kill ring as a
- formatted Org-mode headline into the current buffer
-
- - org-bibtex-export-to-kill-ring :: Export the current headline
- to the kill ring as a formatted bibtex entry.
-
-**** org-gnus.el now allows link creation from messages
-
- You can now create links from messages. This is particularly
- useful when the user wants to stored messages that he sends, for
- later check. Thanks to Ulf Stegemann for the patch.
-
-**** Modified link escaping
-
- David Maus worked on `org-link-escape'. See [[msg:87k4gysacq.wl%dmaus@ictsoc.de][his message]]:
-
- : Percent escaping is used in Org mode to escape certain characters
- : in links that would either break the parser (e.g. square brackets
- : in link target or description) or are not allowed to appear in
- : a particular link type (e.g. non-ascii characters in a http:
- : link).
- :
- : With this change in place Org will apply percent escaping and
- : unescaping more consistently especially for non-ascii characters.
- : Additionally some of the outstanding bugs or glitches concerning
- : percent escaped links are solved.
-
- Thanks a lot to David for this work.
-
-**** Make =org-store-link= point to directory in a dired buffer
-
- When, in a dired buffer, the cursor is not in a line listing a
- file, `org-store-link' will store a link to the directory.
-
- Patch by Stephen Eglen.
-
-**** Allow regexps in =org-file-apps= to capture link parameters
-
- The way extension regexps in =org-file-apps= are handled has
- changed. Instead of matching against the file name, the regexps
- are now matched against the whole link, and you can use grouping
- to extract link parameters which you can then use in a command
- string to be executed.
-
- For example, to allow linking to PDF files using the syntax
- =file:/doc.pdf::<page number>=, you can add the following entry
- to org-file-apps:
-
- #+begin_example
- Extension: \.pdf::\([0-9]+\)\'
- Command: evince "%s" -p %1
- #+end_example
-
- Thanks to Jan Böcker for a patch to this effect.
-
-*** Dates and time
-
-**** Allow relative time when scheduling/adding a deadline
-
- You can now use relative duration strings like "-2d" or "++3w"
- when calling =org-schedule= or =org-deadline=: it will schedule
- (or set the deadline for) the item respectively two days before
- today and three weeks after the current timestamp, if any.
-
- You can use this programmatically: =(org-schedule nil "+2d")=
- will work on the current entry.
-
- You can also use this while (bulk-)rescheduling and
- (bulk-)resetting the deadline of (several) items from the agenda.
-
- Thanks to Memnon Anon for a heads up about this!
-
-**** American-style dates are now understood by =org-read-date=
-
- So when you are prompted for a date, you can now answer like this
-
- #+begin_example
- 2/5/3 --> 2003-02-05
- 2/5 --> <CURRENT-YEAR>-02-05
- #+end_example
-
-*** Agenda
-
-**** =org-agenda-custom-commands= has a default value
-
- This option used to be `nil' by default. This now has a default
- value, displaying an agenda and all TODOs. See the docstring for
- details. Thanks to Carsten for this.
-
-**** Improved filtering through =org-agenda-to-appt=
-
- The new function allows the user to refine the scope of entries
- to pass to =org-agenda-get-day-entries= and allows to filter out
- entries using a function.
-
- Thanks to Peter Münster for raising a related issue and to
- Tassilo Horn for this idea. Also thanks to Peter Münster for
- [[git:68ffb7a7][fixing a small bug]] in the final implementation.
-
-**** Allow ap/pm times in agenda time grid
-
- Times in the agenda can now be displayed in am/pm format. See
- the new variable =org-agenda-timegrid-use-ampm=. Thanks to
- C. A. Webber for a patch to this effect.
-
-**** Agenda: Added a bulk "scattering" command
-
- =B S= in the agenda buffer will cause tasks to be rescheduled a
- random number of days into the future, with 7 as the default.
- This is useful if you've got a ton of tasks scheduled for today,
- you realize you'll never deal with them all, and you just want
- them to be distributed across the next N days. When called with
- a prefix arg, rescheduling will avoid weekend days.
-
- Thanks to John Wiegley for this.
-
-*** Exporting
-
-**** Simplification of org-export-html-preamble/postamble
-
- When set to `t', export the preamble/postamble as usual, honoring
- the =org-export-email/author/creator-info= variables.
-
- When set to a formatting string, insert this string. See the
- docstring of these variable for details about available
- %-sequences.
-
- You can set =:html-preamble= in publishing project in the same
- way: `t' means to honor =:email/creator/author-info=, and a
- formatting string will insert a string.
-
-**** New exporters to Latin-1 and UTF-8
-
- While Ulf Stegemann was going through the entities list to
- improve the LaTeX export, he had the great idea to provide
- representations for many of the entities in Latin-1, and for all
- of them in UTF-8. This means that we can now export files rich
- in special symbols to Latin-1 and to UTF-8 files. These new
- exporters can be reached with the commands =C-c C-e n= and =C-c
- C-e u=, respectively.
-
- When there is no representation for a given symbol in the
- targeted coding system, you can choose to keep the TeX-macro-like
- representation, or to get an "explanatory" representation. For
- example, =\simeq= could be represented as "[approx. equal to]".
- Please use the variable =org-entities-ascii-explanatory= to state
- your preference.
-
-**** HTML export: Add class to outline containers using property
-
- The =HTML_CONTAINER_CLASS= property can now be used to add a
- class name to the outline container of a node in HTML export.
-
-**** Throw an error when creating an image from a LaTeX snippet fails
-
- This behavior can be configured with the new option variable
- =org-format-latex-signal-error=.
-
-**** Support for creating BEAMER presentations from Org-mode documents
-
- Org-mode documents or subtrees can now be converted directly in
- to BEAMER presentation. Turning a tree into a simple
- presentations is straight forward, and there is also quite some
- support to make richer presentations as well. See the [[https://orgmode.org/manual/Beamer-class-export.html#Beamer-class-export][BEAMER
- section]] in the manual for more details.
-
- Thanks to everyone who has contributed to the discussion about
- BEAMER support and how it should work. This was a great example
- for how this community can achieve a much better result than any
- individual could.
-
-*** Refiling
-
-**** Refile targets can now be cached
-
- You can turn on caching of refile targets by setting the variable
- =org-refile-use-cache=. This should speed up refiling if you
- have many eligible targets in many files. If you need to update
- the cache because Org misses a newly created entry or still
- offers a deleted one, press =C-0 C-c C-w=.
-
-**** New logging support for refiling
-
- Whenever you refile an item, a time stamp and even a note can be
- added to this entry. For details, see the new option
- =org-log-refile=.
-
- Thanks to Charles Cave for this idea.
-
-*** Completion
-
-**** In-buffer completion is now done using John Wiegley's pcomplete.el
-
- Thanks to John Wiegley for much of this code.
-
-*** Tables
-
-**** New command =org-table-transpose-table-at-point=
-
- See the docstring. This hack from Juan Pechiar is now part of
- Org's core. Thanks to Juan!
-
-**** Display field's coordinates when editing it with =C-c `=
-
- When editing a field with =C-c `=, the field's coordinate will
- the displayed in the buffer.
-
- Thanks to Michael Brand for a patch to this effect.
-
-**** Spreadsheet computation of durations and time values
-
- If you want to compute time values use the =T= flag, either in
- Calc formulas or Elisp formulas:
-
- | Task 1 | Task 2 | Total |
- |--------+--------+---------|
- | 35:00 | 35:00 | 1:10:00 |
- #+TBLFM: @2$3=$1+$2;T
-
- Values must be of the form =[HH:]MM:SS=, where hours are
- optional.
-
- Thanks to Martin Halder, Eric Schulte and Carsten for code and
- feedback on this.
-
-**** Implement formulas applying to field ranges
-
- Carsten implemented this field-ranges formulas.
-
- : A frequently requested feature for tables has been to be able to define
- : row formulas in a way similar to column formulas. The patch below allows
- : things like
- :
- : @3=
- : @2$2..@5$7=
- : @I$2..@II$4=
- :
- : as the left hand side for table formulas in order to write a formula that
- : is valid for an entire column or for a rectangular section in a
- : table.
-
- Thanks a lot to Carsten for this.
-
-**** Sending radio tables from org buffers is now allowed
-
- Org radio tables can no also be sent inside Org buffers. Also,
- there is a new hook which get called after a table has been sent.
-
- Thanks to Seweryn Kokot.
-
-*** Lists
-
-**** Improved handling of lists
-
- Nicolas Goaziou extended and improved the way Org handles lists.
-
- 1. Indentation of text determines again end of items in
- lists. So, some text less indented than the previous item
- doesn't close the whole list anymore, only all items more
- indented than it.
-
- 2. Alphabetical bullets are implemented, through the use of the
- variable `org-alphabetical-lists'. This also adds alphabetical
- counters like [@c] or [@W].
-
- 3. Lists can now safely contain drawers, inline tasks, or various
- blocks, themselves containing lists. Two variables are
- controlling this: `org-list-forbidden-blocks', and
- `org-list-export-context'.
-
- 4. Improve `newline-and-indent' (C-j): used in an item, it will
- keep text from moving at column 0. This allows to split text
- and make paragraphs and still not break the list.
-
- 5. Improve `org-toggle-item' (C-c -): used on a region with
- standard text, it will change the region into one item. With a
- prefix argument, it will fallback to the previous behavior and
- make every line in region an item. It permits to easily
- integrate paragraphs inside a list.
-
- 6. `fill-paragraph' (M-q) now understands lists. It can freely be
- used inside items, or on text just after a list, even with no
- blank line around, without breaking list structure.
-
- Thanks a lot to Nicolas for all this!
-
-*** Inline display of linked images
-
- Images can now be displayed inline. The key C-c C-x C-v does
- toggle the display of such images. Note that only image links
- that have no description part will be inlined.
-
-*** Implement offsets for ordered lists
-
- If you want to start an ordered plain list with a number different
- from 1, you can now do it like this:
-
- : 1. [@start:12] will star a lit a number 12
-
-*** Babel: code block body expansion for table and preview
-
- In org-babel, code is "expanded" prior to evaluation. I.e. the
- code that is actually evaluated comprises the code block contents,
- augmented with the extra code which assigns the referenced data to
- variables. It is now possible to preview expanded contents, and
- also to expand code during during tangling. This expansion takes
- into account all header arguments, and variables.
-
- A new keybinding `C-c M-b p' bound to `org-babel-expand-src-block'
- can be used from inside of a source code block to preview its
- expanded contents (which can be very useful for debugging).
- tangling
-
- The expanded body can now be tangled, this includes variable
- values which may be the results of other source-code blocks, or
- stored in headline properties or tables. One possible use for this
- is to allow those using org-babel for their emacs initialization
- to store values (e.g. usernames, passwords, etc...) in headline
- properties or in tables.
-
- Org-babel now supports three new header arguments, and new default
- behavior for handling horizontal lines in tables (hlines), column
- names, and rownames across all languages.
-
-*** Editing Convenience and Appearance
-
-**** New command =org-copy-visible= (=C-c C-x v=)
-
- This command will copy the visible text in the region into the
- kill ring. Thanks to Florian Beck for this function and to
- Carsten for adding it to org.el and documenting it!
-
-**** Make it possible to protect hidden subtrees from being killed by =C-k=
-
- See the new variable =org-ctrl-k-protect-subtree=. This was a
- request by Scott Otterson.
-
-**** Implement pretty display of entities, sub-, and superscripts.
-
- The command =C-c C-x \= toggles the display of Org's special
- entities like =\alpha= as pretty unicode characters. Also, sub
- and superscripts are displayed in a pretty way (raised/lower
- display, in a smaller font). If you want to exclude sub- and
- superscripts, see the variable
- =org-pretty-entities-include-sub-superscripts=.
-
- Thanks to Eric Schulte and Ulf Stegeman for making this possible.
-
-**** New faces for title, date, author and email address lines
-
- The keywords in these lines are now dimmed out, and the title is
- displayed in a larger font, and a special font is also used for
- author, date, and email information. This is implemented by the
- following new faces:
-
- =org-document-title=
- =org-document-info=
- =org-document-info-keyword=
-
- In addition, the variable =org-hidden-keywords= can be used to
- make the corresponding keywords disappear.
-
- Thanks to Dan Davison for this feature.
-
-**** Simpler way to specify faces for tags and todo keywords
-
- The variables =org-todo-keyword-faces=, =org-tag-faces=, and
- =org-priority-faces= now accept simple color names as
- specifications. The colors will be used as either foreground or
- background color for the corresponding keyword. See also the
- variable =org-faces-easy-properties=, which governs which face
- property is affected by this setting.
-
- This is really a great simplification for setting keyword faces.
- The change is based on an idea and patch by Ryan Thompson.
-
-**** <N> in tables now means fixed width, not maximum width
-
- Requested by Michael Brand.
-
-**** Better level cycling function
-
- =TAB= in an empty headline cycles the level of that headline
- through likely states. Ryan Thompson implemented an improved
- version of this function, which does not depend upon when exactly
- this command is used. Thanks to Ryan for this improvement.
-
-**** Adaptive filling
-
- For paragraph text, =org-adaptive-fill-function= did not handle
- the base case of regular text which needed to be filled. This is
- now fixed. Among other things, it allows email-style ">"
- comments to be filled correctly.
-
- Thanks to Dan Hackney for this patch.
-
-**** `org-reveal' (=C-c C-r=) also decrypts encrypted entries (org-crypt.el)
-
- Thanks to Richard Riley for triggering this change.
-
-**** Better automatic letter selection for TODO keywords
-
- When all first letters of keywords have been used, Org now
- assigns more meaningful characters based on the keywords.
-
- Thanks to Mikael Fornius for this patch.
-
-*** Clocking
-
-**** Clock: Allow synchronous update of timestamps in CLOCK log
-
- Using =S-M-<up/down>= on CLOCK log timestamps will
- increase/decrease the two timestamps on this line so that
- duration will keep the same. Note that duration can still be
- slightly modified in case a timestamp needs some rounding.
-
- Thanks to Rainer Stengele for this idea.
-
-**** Localized clock tables
-
- Clock tables now support a new new =:lang= parameter, allowing
- the user to customize the localization of the table headers. See
- the variable =org-clock-clocktable-language-setup= which controls
- available translated strings.
-
-**** Show clock overruns in mode line
-
- When clocking an item with a planned effort, overrunning the
- planned time is now made visible in the mode line, for example
- using the new face =org-mode-line-clock-overrun=, or by adding an
- extra string given by =org-task-overrun-text=.
-
- Thanks to Richard Riley for a patch to this effect.
-
-**** Clock reports can now include the running, incomplete clock
-
- If you have a clock running, and the entry being clocked falls
- into the scope when creating a clock table, the time so far spent
- can be added to the total. This behavior depends on the setting
- of =org-clock-report-include-clocking-task=. The default is
- =nil=.
-
- Thanks to Bernt Hansen for this useful addition.
-
-*** Misc
-
-**** Improvements with inline tasks and indentation
-
- There is now a configurable way on how to export inline tasks.
- See the new variable =org-inlinetask-export-templates=.
-
- Thanks to Nicolas Goaziou for coding these changes.
-
-**** A property value of =nil= now means to unset a property
-
- This can be useful in particular with property inheritance, if
- some upper level has the property, and some grandchild of it
- would like to have the default settings (i.e. not overruled by a
- property) back.
-
- Thanks to Robert Goldman and Bernt Hansen for suggesting this
- change.
-
-**** New helper functions in org-table.el
-
- There are new functions to access and write to a specific table field.
- This is for hackers, and maybe for the org-babel people.
-
- #+begin_example
- org-table-get
- org-table-put
- org-table-current-line
- org-table-goto-line
- #+end_example
-
-**** Archiving: Allow to reverse order in target node
-
- The new option =org-archive-reversed-order= allows to have
- archived entries inserted in a last-on-top fashion in the target
- node.
-
- This was requested by Tom.
-
-**** Org-reveal: Double prefix arg shows the entire subtree of the parent
-
- This can help to get out of an inconsistent state produced for
- example by viewing from the agenda.
-
- This was a request by Matt Lundin.
-
-* License
-
- This file is part of GNU Emacs.
-
- GNU Emacs is free software: you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published by
- the Free Software Foundation, either version 3 of the License, or
- (at your option) any later version.
-
- GNU Emacs is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
- GNU General Public License for more details.
-
- You should have received a copy of the GNU General Public License
- along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.