Old Release notes | Org mode

We no longer aim to support third-party python-mode.el implementation of Python REPL. Only the built-in python.el will be supported from now on.

We still keep the old, partially broken, code in ob-python.el for the time being. It will be removed in the next release.

See https://orgmode.org/list/87r0yk7bx8.fsf@localhost for more details.

The old element cache code has been refactored. Emacs does not hang anymore when the cache is enabled.

When cache is enabled, org-element-at-point for headings is guaranteed to return valid :parent property. The highest-level headings contain new org-data element as their parent.

The new org-data element provides properties from top-level property drawer, buffer-global category, and :path property containing file path for file Org buffers.

The new cache still need to be tested extensively. Please, report any warning coming from element cache. If you see warnings regularly, it would be helpful to set org-element--cache-self-verify to 'backtrace and provide the backtrace to Org mailing list.

The cache state is saved between Emacs sessions. Enabled by default.

The cache persistence can be controlled via org-element-cache-persistent.

The old folding backend used in Org is poorly scalable when the file size increases beyond few Mbs. The symptoms usually include slow cursor motion, especially in long-running Emacs sessions.

A new optimized folding backend is now available, and enabled by default. To disable it, put the following to the Emacs config before loading Org:

(setq org-fold-core-style 'overlays)

Even more performance optimization can be enabled by customizing org-fold-core--optimise-for-huge-buffers. However, this option may be dangerous. Please, read the variable docstring carefully to understand the possible consequences.

When org-fold-core-style is set to text-properties, several new features will become available and several notable changes will happen to the Org behavior. The new features and changes are listed below.

Org now uses MathJax 3 by default instead of MathJax 2. During HTML exports, Org automatically converts all legacy MathJax 2 options to the corresponding MathJax 3+ options, except for the path option in which now must point to a file containing MathJax version 3 or later. The new Org does not work with the legacy MathJax 2.

Further, if you need to use a non-default font or linebreaks (now overflow), then the path must point to MathJax 4 or later.

See the updated org-html-mathjax-options for more details.

MathJax 3, a ground-up rewrite of MathJax 2 came out in 2019. The new version brings modularity, better and faster rendering, improved LaTeX support, and more.

For more information about new features, see:

https://docs.mathjax.org/en/latest/upgrading/whats-new-3.0.html https://docs.mathjax.org/en/latest/upgrading/whats-new-3.1.html https://docs.mathjax.org/en/latest/upgrading/whats-new-3.2.html

MathJax 3 comes with useful extensions. For instance, you can typeset calculus with the physics extension or chemistry with the mhchem extension, like in LaTeX.

Note that the Org manual does not discuss loading of MathJax extensions via +HTML_MATHJAX anymore. It has never worked anyway. To actually load extensions, consult the official documentation:

https://docs.mathjax.org/en/latest/input/tex/extensions.html

Lastly, MathJax 3 changed the default JavaScript content delivery network (CDN) provider from CloudFlare to jsDelivr. You can find the new terms of service, including the privacy policy, at https://www.jsdelivr.com/terms.

List representation of named lists is now converted to a simple list as promised by the manual section org#Environment of a Code Block. Previously, it was converted to a list of lists.

Before:

#+NAME: example-list
- simple
  - not
  - nested
- list

#+BEGIN_SRC emacs-lisp :var x=example-list :results value
(format "%S" x)
#+END_SRC

#+RESULTS:
: (("simple" (unordered ("not") ("nested"))) ("list"))

After:

#+BEGIN_SRC emacs-lisp :var x=example-list :results value
(format "%S" x)
#+END_SRC

#+RESULTS:
: ("simple" "list")

You can move rows up & down in column view with org-columns-move-row-up and org-columns-move-row-down. Keybindings are the same as org-move-subtree-up and org-move-subtree-down M-<up> and M-<down>.

:step clock table parameter can now be set to quarter.

Links to other published Org files are automatically converted to the corresponding html links. Now, this feature is also available when links point to encrypted Org files, like [[file:foo.org.gpg::Heading]].

org-edit-special and org-insert-structure-template now handle comment blocks.

See 1.4.3.

A new alist variable to control how properties are combined.

If a property is specified multiple times with a +, like

:PROPERTIES:
:EXPORT_FILE_NAME: some/path
:EXPORT_FILE_NAME+: to/file
:END:

the old behavior was to always combine them with a single space (some/path to/file). For the new variable, the car of each item in the alist should be either a list of property names or a regular expression, while the cdr should be the separator to use when combining that property.

The default value for the separator is a single space, if none of the provided items in the alist match a given property.

For example, in order to combine EXPORT_FILE_NAME properties with a forward slash /, one can use

(setq org-property-separators '((("EXPORT_FILE_NAME") . "/")))

The example above would then produce the property value some/path/to/file.

The library stores variable data in org-persist-directory (set to XDG cache dir by default).

The entry points are org-persist-register, org-persist-unregister, org-persist-read, and org-persist-read-all. Storing circular structures is supported. Storing references between different variables is also supported (see :inherit key in org-persist-register).

The library permits storing buffer-local variables. Such variables are linked to the buffer text, file inode, and file path.

The :options attribute allows adding an optional argument with a list of various table options (between brackets in LaTeX export), since certain tabular environments, such as longtblr of the tabularray LaTeX package, provides this structure.

The :compact attribute allows exporting multiple description list items to one @item command and one or more @itemx commands. This feature can also be enabled for all description lists in a file using the compact-itemx export option, or globally using the org-texinfo-compact-itemx variable.

Items in a description list that begin with Function:, Variable: or certain related prefixes are converted using Texinfo definition commands.

:noweb-prefix can be set to no to prevent the prefix characters from being repeated when expanding a multiline noweb reference.

:noweb can be set to strip-tangle to strip the noweb syntax references before tangling.

When org-latex-src-block-backend is set to engraved, engrave-faces-latex from engrave-faces is used to transcode source blocks to LaTeX. This requires the fvextra, float, and (by default, but not necessarily) tcolorbox LaTeX packages be installed. It uses Emacs's font-lock information, and so tends to produce results superior to Minted or Listings.

#+include: FILE will now accept URLs as the file.

The block type in org-structure-template-alist is not case-sensitive. When the block type starts from the upper case, structure template will now insert #+BEGIN_TYPE. Previously, lower-case #+begin_type was inserted unconditionally.

LaTeX tables can now be exported to the latex tabbing environment tabbing environment]]. This is done by adding #+ATTR_LATEX: :mode tabbing at the top of the table. The default column width is set to 1/n times the latex textwidth, where n is the number of columns. This behavior can be changed by supplying a :align parameter.

The tabbing environment can be useful when generating simple tables which can be span multiple pages and when table cells are allowed to overflow.

The "csl" citation export processor now supports nocite style citations that add items to the printed bibliography without visible references in the text. Using the key * in a nocite citation, for instance,

[cite/n:@*]

includes all available items in the printed bibliography.

The "csl" export processor now also supports sub-bibliographies that show only a subset of the references based on some criterion. For example,

#+print_bibliography: :type book :keyword ai

prints a sub-bibliography containing the book entries with ai among their keywords.

The :filetitle option for clock tables can be set to t to show org file title (set by #+title:) in the File column instead of the file name. For example:

#+BEGIN: clocktable :scope agenda :maxlevel 2 :block thisweek :filetitle t

If a file does not have a title, the table will show the file name instead.

The org-md-toplevel-hlevel customization variable sets the heading level used for top level headings, much like how org-html-toplevel-hlevel sets the heading level used for top level headings in HTML export.

Use the header argument :var x=code-block[] or

#+CALL: fn(x=code-block[])

to pass the contents of a named code block as a string argument.

The new property ORG-IMAGE-ACTUAL-WIDTH can override the global variable org-image-actual-width value for inline images display width.

New org-cycle-hook function org-cycle-display-inline-images for auto-displaying inline images in the visible parts of the subtree. This behavior is controlled by new custom option org-cycle-inline-images-display.

This provides a proper counterpart to org-babel-pre-tangle-hook, as org-babel-post-tangle-hook is run per-tangle-destination. org-babel-tangle-finished-hook is just run once after the post tangle hooks.

The :backend header argument on clojure code blocks can override the value of org-babel-clojure-backend. For example:

(range 2)

Unlike :results none, the return value of code blocks called with :results discard header argument is always nil. Org does not attempt to analyze the results and simply returns nil. This can be useful when the code block is used for side effects only but generates large outputs that may be slow to analyze for Org.

Capture templates can now attach template specific hooks via the following properties: :hook, :prepare-finalize, :before-finalize, :after-finalize. These nullary functions run prior to their global counterparts for the selected template.

This would allow to use more than two states ("[ ]", "[X]") in columns with SUMMARY-TYPE that use checkbox ("X", "X/", "X%"). For example you can add an intermediate state ("[-]"). Or empty state ("") to remove checkbox.

Setting org-refile-use-outline-path to 'title will show title instead of the file name in refile targets. If the document do not have a title, the filename will be used, similar to 'file option.

Setting org-agenda-show-outline-path to 'title will show title instead of the file name at the beginning of the outline. The title of the document can be set by special keyword #+title:.

These settings allow users to define prefixes for exported summary lines in ICS exports. The customization can be used to disable the prefixes completely or make them a little bit more verbose (e.g. "Deadline: " instead of the default "DL: ").

The same settings can also be applied via corresponding exporter options: :icalendar-scheduled-summary-prefix, :icalendar-deadline-summary-prefix

Previously, all the drawers were always folded when opening an Org file. This only had an effect on the drawers outside folded headlines. The drawers inside folded headlines were re-folded because org-cycle-hide-drawers was present inside org-cycle-hook.

With the new folding backend, running org-cycle-hide-drawers is no longer needed if all the drawers are truly folded on startup: 1.1.4.4. However, this has an unwanted effect when a user does not want the drawers to be folded (see this bug report).

The new custom setting gives more control over initial folding state of the drawers. When set to nil (default is t), the drawers are not folded on startup.

The folding state can also be controlled on per-file basis using STARTUP keyword:

#+startup: hidedrawers
#+startup: nohidedrawers

The new setting, when set to non-nil, makes Org create alarm at the event time when the alarm time is set to 0. The default value is nil – do not create alarms at the event time.

Passing the symbol attach or string "'attach" (with quotes) to the :dir option of a src block is now equivalent to :dir (org-attach-dir) :mkdir yes and any file results with a path descended from the attachment directory will use attachment: style links instead of the standard file: link type.

A function to collect the document title from the org-mode buffer.

org-fold-show-entry now accepts an optional argument HIDE-DRAWERS. When the argument is non-nil, the function folds all the drawers inside entry. This was the default previously.

Now, org-fold-show-entry does not fold drawers by default.

As the contents of comments blocks is not parsed as Org markup, the headlines and keywords inside should be escaped, similar to src blocks, example blocks, and export blocks. This in inconvenient to do manually and org-edit-special is usually advised to edit text in such kind of blocks.

Now, comment block editing is also supported via this new function.

When element cache is enabled, the new function provides the best possible performance to map across large Org buffers.

It is recommended to provide :next-re and :fail-re parameters for best speed.

Diagnostic information about execution speed can be provided according to org-element--cache-map-statistics and org-element--cache-map-statistics-threshold.

org-scan-tags and tag views in agenda utilize the new function.

This function is like org-element-at-point, but it does not try to update the cache and does not guarantee correct :parent properties for headline elements.

This function is faster than org-element-at-point when used together with frequent buffer edits.

org-in-archived-heading-p, org-in-commented-heading-p, org-up-heading-safe, org-end-of-subtree, org-goto-first-child, org-back-to-heading, org-entry-get-with-inheritance, and org-narrow-to-subtree all accept Org element as an extra optional argument.

org-get-tags now accepts Org element or buffer position as first argument.

This function is intended for us in the definition of a kbd macro in files that are exported to Texinfo.

org-at-heading-p now returns t by default on headings inside folds. Passing optional argument will produce the old behavior.

Previously, executing PlantUML src blocks always exported to a file. Now, if :results is set to a value which does not include "file", no file will be exported and an ASCII graph will be inserted below the src block.

The new variable name is org-plantuml-args. It now applies to both jar PlantUML file and executable.

Leading < and trailing > in the default values of org-time-stamp-formats and org-time-stamp-custom-formats are stripped.

The Org functions that are using these variables also ignore leading and trailing brackets (<...> and [...], if present).

This change makes the Org code more consistent and also makes the docstring for org-time-stamp-custom-formats accurate.

No changes on the user side are needed if org-time-stamp-custom-formats was customized.

The old function name is similar to other org-time-stamp-format function. The new name emphasizes that org-format-timestamp works on timestamp objects.

New custom argument in org-time-stamp-format makes the function use org-time-stamp-custom-formats instead of org-time-stamp-formats to determine the format.

Optional argument long is renamed to with-time, emphasizing that it refers to time stamp format with time specification.

Optional argument inactive can now have a value no-brackets to return format string with brackets stripped.

Before you could either specify SQL parameters like :dbhost, :dbuser, :database, etc or a :dbconnection parameter which looks up all other parameters from the sql-connection-alist variable. Now it's possible to specify a :dbconnection and additionally other parameters that will add or overwrite the parameters coming from sql-connection-alist.

E.g. if you have a connection in your sql-connection-alist to a server that has many databases, you don't need an entry for every database but instead can just specify :database next to your :dbconnection parameter.

When the result of a regular code block is nil, then that was already treated as an empty list. Now that is also the case for code blocks that post-process the result of another block.

It is now possible to add new styles or modify old ones in biblatex citation processor. See org-cite-biblatex-styles for more information.

When a citation processor is registered, it is now possible to set :cite-styles key to a function, which will be called whenever the list of styles is required.

When CSL style file name is relative, Org first looks into default-directory before trying org-cite-csl-styles-dir.

The function org-lint-add-checker allows one to add personal checks when calling org-lint. See its docstring for more information.

The dvipng option in org-preview-latex-process-alist has a new property transparent-image-converter which is used instead of image-converter when producing transparent images.

Previously :tangle-mode (identity #o755) was the only reasonable way to set the file mode. org-babel-interpret-file-mode has been introduced which will accept three new formats:

• Short octals, e.g. :tangle-mode o755
• ls-style, e.g. :tangle-mode rwxrw-rw-
• chmod-style, e.g. :tangle-mode u+x

Chmod-style permissions are based on the new variable org-babel-tangle-default-file-mode.

org-latex-listings has been renamed to better reflect the current purpose of the variable. The replacement variable org-latex-src-block-backend acts in exactly the same way, however it accepts listings and verbatim in place of t and nil (which still work, but are no longer listed as valid options).

The value of :insert-description is used as the initial input when prompting for a link description. It can be a string (used as-is) or a function (called with the same arguments as org-make-link-description-function to return a string to use).

An example of a such function for info: links is org-info-description-as-command. To access a manual section outside of Org, description may be pasted to shell prompt or evaluated within Emacs using M-: (wrapped into parenthesis). For example, description of the info:org#Tags link is info "(org) Tags". To restore earlier behavior add to your Emacs init file the following:

(with-eval-after-load 'ol-info
  (org-link-set-parameters "info" :insert-description nil))

org-latex-language-alist unifies into a single list the old language lists for the babel and polyglossia LaTeX packages: org-latex-babel-language-alist and org-latex-polyglossia-language-alist, respectively, which are declared obsolete.

This new list captures the current state of art regarding language support in LaTeX. The new babel syntax for loading languages via ini files and the new command \babelprovide (see: https://mirrors.ctan.org/macros/latex/required/babel/base/babel.pdf) are also supported.

With the new customization option org-texinfo-with-latex set to (its default value) 'detect, if the system runs Texinfo 6.8 (3 July 2021) or newer, Org will export all LaTeX fragments and environments using Texinfo @math and @displaymath commands respectively.

List entries may return nil if they are unable to handle the passed ID. So, responsibility is passed to the next item in the list. Default entries org-attach-id-uuid-folder-format and org-attach-id-ts-folder-format now return nil for too short IDs. Earlier an obscure error has been thrown.

After the change, error text suggests adjusting org-attach-id-to-path-function-list value. The org-attach-dir-from-id function is adapted to ignore nil values and to take first non-nil value instead of the value returned by first org-attach-id-to-path-function-list item.

New policy allows mixing different ID styles while keeping subfolder layout suited best for each one. For example, one can use the following snippet to allow multiple different ID formats in Org files.

(setq org-attach-id-to-path-function-list
      '(;; When ID looks like an UUIDs or Org internal ID, use
        ;; `org-attach-id-uuid-folder-format'.
        (lambda (id)
          (and (or (org-uuidgen-p id)
                   (string-match-p "[0-9a-z]\\{12\\}" id))
               (org-attach-id-uuid-folder-format id)))
        ;; When ID looks like a timestamp-based ID. Group by year-month
        ;; folders.
        (lambda (id)
          (and (string-match-p "[0-9]\\{8\\}T[0-9]\\{6\\}\.[0-9]\\{6\\}" id)
               (org-attach-id-ts-folder-format id)))
        ;; Any other ID goes into "important" folder.
        (lambda (id) (format "important/%s/%s" (substring id 0 1) id))
        ;; Fallback to detect existing attachments for old defaults.
        ;; All the above functions, even when return non-nil, would
        ;; point to non-existing folders.
        org-attach-id-uuid-folder-format
        org-attach-id-ts-folder-format))

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 NonGNU ELPA package.

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 used to be bundled with Org but it is not anymore. See the ditaa repository on how to install it.

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 this FAQ for more details.

Setting org-speed-commands-user in your configuration won't have any effect. Please set org-speed-commands instead, which see.

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 here.

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 this note on Worg and this commit.

If you prefer to keep the keybinding, you can add it back to org-mode-map like so:

(define-key org-mode-map (kbd "C-c SPC") #'org-table-blank-field)

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 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.

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 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.

Org now supports export for DOI links, through its new ol-doi.el library. For backward compatibility, it is loaded by default.

When exiting capture mode via org-capture-refile, the variable org-refile-targets will be temporarily bound to the value of this template option.

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

A new u mode flag for Calc formulas in Org tables has been added to enable Calc units simplification mode.

See this thread.

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 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.

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.

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.

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.

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:

#+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

As another example, we can use :return with the external tabulate package, to convert pandas Dataframes into orgmode tables:

#+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 |

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 behavior.

The option org-hidden-keywords previously applied to #+TITLE:, #+AUTHOR:, #+DATE:, and #+EMAIL:. Now it can also be used to hide the #+SUBTITLE: keyword.

The new %L formatting directive contains the bare link target, and may be used to create links with programmatically generated descriptions.

Earlier, IDs generated using ts method had a hard-coded format (i.e. 20200923T160237.891616). The new option allows user to customize the format. Defaults are unchanged.

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.

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:

(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))))))

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 precedes and proceeds the contents of the source block.

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).

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.

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 this thread:

• 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.

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.

By default ox-html now inlines webp images.

See this thread.

This is the CSS class name to use for the top level content wrapper.

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.

org-html-scripts and org-html-style-default used to be constants, you can now configure them.

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.

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 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:

(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)))))

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.

doi and url entries have been made optional for some publication types and will be exported if present for those types.

They used to be the empty string.

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.

In the past, faces of todo keywords, emphasized text, tags, and priority cookies inherited default face. The resulting headline fontification was not always consistent, as discussed in this bug report. Now, the relevant faces adapt to face used to fontify the current headline level.

Users who prefer to keep the old behavior should change their face customization explicitly stating that default face is inherited.

Example of old face customization:

(setq org-todo-keyword-faces '(("TODO"
                                :background "chocolate"
                                :height 0.75)))

To preserve the old behavior the above customization should be changed to

(setq org-todo-keyword-faces '(("TODO"
                                :inherit default
                                :background "chocolate"
                                :height 0.75)))

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.

The function does not allow for a third optional parameter anymore.

If a babel src block produces a raw LaTeX environment, it will now be recognized as a result, and so replaced when re-evaluated.

Tag completion now uses completing-read-multiple with a simple completion table, which should allow better interoperability with custom completion functions.

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.

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:

'org-protocol://store-link?' + new URLSearchParams({
      url: location.href, title: document.title})

The LaTeX packages grffile and textcomp are redundant, with their capabilities being merged into graphicx and the LaTeX core respectively a while ago.

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:

(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))

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 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.

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.

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>.

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 behavior back, disable electric-indent-mode explicitly:

(add-hook 'org-mode-hook (lambda () (electric-indent-local-mode -1)))

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.

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.

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.

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.

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.

You can now set org-priority-highest/lowest/default to integers to use numeric priorities globally or set, for example

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 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.

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.

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.

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.

You can now use C-x C-+ in column view: the columns face size will increase or decrease, together with the column header size.

When this startup option is set, display headings as numerated.

Use #+startup: nonum to turn this off.

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.

In situations where org-return calls newline, multiple newlines can now be inserted with this prefix argument.

Source code block header argument :file-mode can set file permissions if :file argument is provided.

In C and C++ blocks, :includes arguments that do not start with a < character will now be formatted as double-quoted #include statements.

You can now set (setq org-babel-clojure-backend 'inf-clojure) and evaluate Clojure source blocks using 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 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.

Babel Java blocks recognize header argument :cmdargs and pass its value in call to java.

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)

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.

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.

Hitting <C-c C-c> in an agenda view now calls org-agenda-set-tags.

This command is the counterpart of org-show-entry.

<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>.

Find or create a month entry for a date.

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.

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.

Setting this option to t will activate org-table-header-line-mode in org-mode buffers.

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.

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.

A new `:tree-type month' option was added to org-capture-templates to group new datetime entries by month.

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.

Archiving a subtree used to always save the target archive buffer. Commit 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.

This option will add a timeout to notifications.

This new option allows you to convert a LaTeX fragment directly into HTML.

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 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 this thread for more context.

org-attach-store-link-p has a new option to store a file link to the attachment.

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.

The new value uses Emacs as the application for opening directory.

Functions in this hook are run after org-agenda-filter is called.

Use org-hide-drawer-toggle instead.

Use org-hide-block-toggle instead.

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.

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.

The variable was not used in the code base.

The variable was not used in the code base.

The new name is org-at-property-drawer-p, which is less confusing.

See 3.4.4.

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.

Screen babel session are now named based on the :session header argument (defaults to default).

Previously all session names had org-babel-session- prepended.

org-forward-paragraph and org-backward-paragraph, bound to <C-UP> and <C-DOWN> functions mimic more closely behavior of forward-paragraph and backward-paragraph functions when available.

They also accept an optional argument for multiple calls.

See their docstring for details.

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.

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.

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.

You can now use <C-n>, <C-p>, <SPC> and <DEL> key to scroll up and down the agenda and attach dispatch window.

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.

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.

A task using a .+ repeater and hours step is repeated starting from now. E.g.,

,** TODO Wash my hands
   DEADLINE: <2019-04-05 08:00 Sun .+1h>
   Marking this DONE shifts the date to exactly one hour from now.

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.

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.

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 refile variables and functions have been moved to a new file.

This bug originally reported by Matt Lundin and investigated by Andrew Hyatt has been fixed. Thanks to both of them.

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:

(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)))))))))))

The old org-link-escape and org-link-unescape functions have been renamed into org-link-encode and org-link-decode.

Link description, if any, is located in match group 2 instead of match group 3.

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.

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.

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")

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.

See https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=3367ac9457 for details.

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.

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.

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.

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.

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 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_DIRINHERIT is no longer supported and is removed.

(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")))

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!

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.

This aligns Beamer notes with slide overlays.

Using :enum A or :enum a Texinfo attribute switches an otherwise numbered list to a lettered list.

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.

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.

The new property HTML_HEADLINE_CLASS assigns a class attribute to a headline.

Supported LaTeX attributes are :float, :center, :font and :caption.

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.

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.

Add :coding CODING-SYSTEM to include files using a different coding system than the main Org document. For example:

#+INCLUDE: "myfile.cmd" src cmd :coding cp850-dos

S-<UP>, S-<DOWN>, S-<RIGHT>, and S-<LEFT> now move cells in the corresponding direction by swapping with the adjacent cell.

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.

<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.

<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.

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.

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.

#+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]]

The +TOC keyword now accepts a :target: attribute that specifies the headline to use for making the table of contents.

* Target
  :PROPERTIES:
  :CUSTOM_ID: TargetSection
  :END:
** Heading A
** Heading B
* Another section
#+TOC: headlines 1 :target "#TargetSection"

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.

You can install it back from MELPA.

It has been deprecated in favor of org-attach-id-dir which is less ambiguous given the restructured org-attach.

This variable was not used through the code base.

The function now accepts the level of the subtree as an optional argument. It no longer deduces it from the current level.

Function org-latex-preview, formerly known as org-toggle-latex-fragment, has a hopefully simpler and more predictable behavior. See its docstring for details.

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.

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.

This hook was actually introduced in Org 9.2.1, but wasn't advertised.

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.

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.

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.

This variable makes it possible to customize the list of commands for the attachment dispatcher.

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 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.

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.

I.e. treat the whole file as if it was a subtree.

Before, the new column was inserted to the right of the column at point position.

Point stays in the column at deletion, except when deleting the rightmost column.

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.

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.

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.

#+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

should become

#+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

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.

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.

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:

#+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

However, there is no change in non-eval macros:

#+macro: disp argument: $1

{{{disp(text)}}} => argument: text

Columns narrowing (or shrinking) is now dynamic. See 5.2.11 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:

#+STARTUP: align shrink

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)

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.

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.

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.

(dissoc Clojure 'JVM)
(conj clojurists "stardiviner")

With this output format, create a link to the file specified in :file header argument, without actually writing any result to it:

#+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]]

Use MathJax links when enabled (by org-html-with-latex), otherwise add a label to the rendered equation.

See manual and the commentary section in org-tempo.el for details.

Set their UNNUMBERED property to the special notoc value. See manual for details.

Archiving headers through org-archive-subtree and org-archive-to-archive-sibling such as the ones listed below:

* Top [1/2]
** DONE Completed
** TODO Working

Will update the status cookie in the top level header.

The org-agenda-overriding-header inserted into agenda views can now be disabled by setting it to an empty string.

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.

You can use this to make collection of a property from an entry conditional on another entry. E.g. given this configuration:

(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)))

You can have a file bananas.org containing:

#+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:

… and when going to the top of that file and entering column view you should expect to see something like:

#+STARTUP: shrink

You can now use :match to filter entries using a todo/tags/properties matcher.

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.

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

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.

When enabling org-html-self-link-headlines the headlines exported to HTML contain a hyperlink to themselves.

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.

See docstring for details.

See docstring for details.

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.

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.

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.

Use org-save-outline-visibility instead.

Use org-save-outline-visibility instead.

It was not used throughout the code base.

It was not used throughout code base.

Use org-element-at-point instead.

It is no longer used in the code base.

Org Tempo may be used as a replacement. See details above.

See Change to Noweb expansion for explanations.

It is now nil, which means numbers in scientific notation are not handled specially by default.

It is now nil, which means numbers in scientific notation are not handled specially by default.

It is meant to be used as the face for distant deadlines, see org-agenda-deadline-faces

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.

It used to insert it on the left. With this change, org-table-insert-column and org-table-delete-column are reciprocal.

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.

Set option org-src-window-setup to split-window-below.

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.

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.

See docstrings for the allowed values. For backward compatibility, (org-at-timestamp-p t) is still supported, but should be updated accordingly.

Since functions are allowed there, a straightforward way to migrate is to turn, e.g.,

(file (sexp))

into

(file (lambda () (sexp)))

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

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.

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

(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)))

:sitemap-function now expects to be called with two arguments. See org-publish-project-alist for details.

:istart, :icount, :iend and :isep now expect the type of the list as their first argument.

The optional argument is now a string to extract the repeater from. See docstring for details.

See docstring for changes.

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.

Use "/!" markup when filtering TODO keywords to get only not-done TODO keywords.

It used to return nil.

See this github issue.

You can use ob-scala.el as packaged in scala-mode, available from the MELPA repository.

Both these properties can be inherited during iCalendar export, depending on the value of org-use-property-inheritance.

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".

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.

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.

The new ignore value effectively allows toggling inclusion of directories in published site-maps.

Added a nullary function that returns a list of files as a possible argument for the scope of the clock table.

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.

:ifmt is a function to be called on the body of each item. See org-list-to-generic documentation for details.

This allow to use a different title than entry title.

Using C-c C-a u prompts for a URL pointing to a file to be attached to the document.

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.

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.

Using C-c C-c on any keyword (like #+SETUPFILE) will reset the that file cache.

This variable allow computed durations in tables to be zero-padded.

This mode omits seconds in durations.

This feature has been removed. Use a custom agenda view, possibly narrowed to current buffer to achieve a similar functionality.

Use org-agenda-skip-if instead.

Use org-agenda-skip-if instead.

Use org-agenda-skip-if instead.

Use org-duration-from-minutes instead.

Use org-duration-to-minutes instead.

Use org-duration-to-minutes instead.

This function relied on nnimap-group-overview-filename, which was removed from Gnus circa September 2010.

For an equivalent to a nil value, set org-agenda-show-future-repeats to nil and org-agenda-prefer-last-repeat to t.

This variable has no effect, as it was relying on a function that was removed from Gnus circa September 2010.

Use org-gnus-prefer-web-links instead.

One can provide new :sitemap-format-entry property for a function equivalent to the removed format string.

Setting it to a nil value broke some other features (e.g., speed keys).

The variable is now a boolean.

Use org-texinfo-table-default-markup instead.

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.

It is the reciprocal of org-list-to-lisp, which see.

Call org-agenda-set-restriction-lock from the agenda.

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 here.

If you want to contribute to it, please see how to contribute.

Columns view is not limited to a single buffer anymore.

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.

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.

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 &).

See docstring for details.

This variable is a defcustom and replaces the variable org-babel-capitalize-example-region-markers, which is a defvar and is now obsolete.

Now =...= markup uses @samp{} instead of @verb{}. You can use @verb{} again by customizing the variable.

It used to be @samp but @asis is neutral and, therefore, more suitable as a default value.

URLs like https://cool-blog.com/2017/05/20/cool-post/ are covered by rewrite rules.

From now on, Org expects at least Emacs 24.3, although Emacs 24.4 or above is suggested.

Incomplete compatibility layer with XEmacs has been removed. If you want to take over maintenance of this compatibility, please contact our mailing list.

Export blocks are explicitly marked as such at the syntax level to disambiguate their parsing from special blocks. The new syntax is

#+BEGIN_EXPORT backend
...
#+END_EXPORT

instead of

#+BEGIN_backend
...
#+END_backend

As a consequence, INCLUDE keywords syntax is modified, e.g.,

#+INCLUDE: "file.org" HTML

becomes

#+INCLUDE: "file.org" export html

The following function repairs export blocks and INCLUDE keywords using previous syntax:

(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)))))))))

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.

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 will be determined via vc.el if the second argument is non-nil. See the manual for details.

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.

Using header arguments as property names is no longer possible. As such, the following

* Headline
:PROPERTIES:
:exports: code
:var: a=1 b=2
:var+: c=3
:END:

should be written instead

* Headline
:PROPERTIES:
:header-args: :exports code
:header-args+: :var a=1 b=2
:header-args+: :var c=3
:END:

Please note that, however, old properties were defined at the source block definition. Current ones are defined where the block is called.

Org-protocol can now handle query-style parameters such as:

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

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.

org-lint can check syntax and report common issues in Org documents.

When org-agenda-insert-diary-strategy is set to date-tree-last, diary entries are added to last in the date tree.

\vbar or \vbar{} will be exported unconditionally as a |, unlike to existing \vert, which is expanded as | when using a HTML derived export back-end.

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.

Used like org-bbdb-anniversaries, it provides a few days warning for upcoming anniversaries (default: 7 days).

If the task is repeated, and therefore done at least one, scheduling information is no longer relevant. It is therefore removed.

See commit message for more information.

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.

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.

When non-nil, commit attachments with git, assuming the document is in a git repository.

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.

Repeated footnotes are now numbered by referring to a label in the first footnote.

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 can now have custom colors, tooltips, keymaps, display behavior, etc. Links are now centralized in org-link-parameters.

It replaces the deprecated next argument to org-previous-line-empty-p.

It is a faster implementation of outline-show-children.

Use org-agenda-filter-by-tag instead.

Use org-agenda-today-p instead.

Use org-babel--get-vars or assq instead, as applicable.

Use org-trim instead.

Use org-remove-indentation instead.

Use image-file-name-regexp instead. The never-used-in-core extensions argument has been dropped.

Use org-list-to-lisp instead.

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.

Use org-at-table-p instead.

It was not called by any org code since 2010.

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.

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.

Two consecutive blank lines always terminate all levels of current plain list.

fixltx2e is obsolete, see LaTeX News 22.

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.

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.

The new algorithm doesn't remove TAB characters not used for indentation.

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.

Since gnus nnir groups are temporary, org-gnus-store-link now refers to the article's original group.

The calling convention has changed.

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.

The previous name is, for the time being, kept as an obsolete alias.

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.

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.

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.)

It used to be a defcustom, with a warning that it shouldn't be modified anyway.

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.

Allows J source blocks be indicated by letter j. Previously the indication letter was solely J.

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.

The experimental variable used to be more or less confidential, as a defvar.

It defines the format of the original link. Possible values are: plain, bracket and angle.

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:

(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"))))))))))))

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.)

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.,

* Headline
   :PROPERTIES:
   :CATEGORY: some category
   :END:

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.

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.

Skipping TITLE keyword no longer provides the current file name, or buffer name, as the title. Instead, simply ignore the title.

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 used to return objects on some keywords, i.e., TITLE, DATE and AUTHOR. It now returns only the keyword.

If you have, in your configuration, something like (setq org-timer-default-timer 10) replace it with (setq org-timer-default-timer "10").

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

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))

If point is before or after the headline title, insert a new line without changing the headline.

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:

#+TAGS: [ Group : SubOne SubTwo ]
#+TAGS: [ SubOne : SubOne1 SubOne2 ]
#+TAGS: [ SubTwo : SubTwo1 SubTwo2 ]

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 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 ]

* Test                                                            :sub1:sub2:

This is a more general case than the already existing syntax for grouptags; { }.

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 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.

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.

Thanks to Bjarte Johansen for this feature.

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.

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.

The content of the included file can now be optionally marked up, for instance as HTML. See the documentation for details.

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.

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.

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" → "latex-mode"). You can define exceptions to this rule by configuring org-src-lang-modes, which see.

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.

For example, it is now possible to number lines using the -n switch in a source block.

Plain lists can have an extra margin by setting org-ascii-list-margin variable to an appropriate integer.

ASCII export now supports #+BEGIN_JUSTIFYRIGHT and #+BEGIN_JUSTIFYLEFT blocks. See documentation for details.

The number of publishing options specific to each back-end has been increased. See manual for details.

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.

These functions now support any element or object, not only headlines.

This function deprecates org-export-get-genealogy. It also provides more features. See docstring for details.

Functions in this filter are applied on the body of the exported document, before wrapping it within the template.

#+ATTR_LATEX: :environment myverbatim
#+BEGIN_EXAMPLE
This sentence is false.
#+END_EXAMPLE

will be exported using @samp(myverbatim) instead of @samp(verbatim).

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.

It is not possible to specify #+attr_latex: :float nil in conjunction with source blocks exported by the minted package.

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.

Ability to plot values in a column through ASCII-art bars. See manual for details.

This hook is called after successfully archiving a subtree, with point on the original subtree, not yet deleted.

When non-nil, attachments from archived subtrees are removed.

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.

See the docstring for more information.

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.

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.

The TOC keywords now accepts an optional local parameter. See manual for details.

org-timer-pause-time now pauses and restarts both relative and countdown timers.

When org-agenda-window-setup is set to only-window, the agenda is displayed as the sole window of the current frame.

It is now possible to supply and optional formatting argument to {{{date}}}. See manual for details.

It is now possible to supply an optional search option to {{{property}}} in order to retrieve remote properties optional. See manual for details.

It is possible to suppress the title insertion with #+OPTIONS: title:nil or globally using the variable org-export-with-title.

" " 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.

Org uses the MathJax CDN by default. See the manual and the docstring of org-html-mathjax-options for details.

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 for mobile-optimized website is now automatically inserted when exporting to html. See org-html-viewport for details.

Org can typeset a subtitle in some export backends. See the manual for details.

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.

Work as delete-indentation unless at heading, in which case text is added to headline text.

Texinfo back-end now handles images. See the manual for details.

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.

In addition to setting countdown timers in minutes, they can also be set using the hh:mm:ss format.

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.

It encompasses all past closed clocks.

See the docstring of org-latex-classes and org-latex-guess-polyglossia-language for details.

Use org-timestamp-translate instead.

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.

org-timer-stop now stops both relative and countdown timers.

This function, being non-bijective, introduced bug in internal references. Use org-export-get-reference instead.

The function is superseded by org-end-of-meta-data, called with an optional argument.

These functions were left-over from pre 8.0 era. They are not correct anymore. Since they are not needed, they have no replacement.

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).

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.

Setting this to non-nil was problematic as it converted characters everywhere in the buffer, possibly corrupting URLs.

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.

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.

Setting this option to anything else that the default value (nil) would create invalid planning info. This dangerous option is now removed.

Use org-export-with-title instead. See also below.

This variable has no effect since Org 8.0.

This variable has no effect since August 2009.

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.

org-export-filter-comment-functions and org-export-filter-comment-block-functions variables do not exist anymore.

ITEM special property does not contain TODO, priority or tags anymore.

Absolute file names can now start with /// in addition to /. E.g., [[file:///home/me/unicorn.jpg]].

As a consequence, it is possible to include multiple Org files with footnotes in a master document without being concerned about footnote labels colliding.

This change deprecates old Org syntax for mailto links: mailto:user@domain::Subject.

QUOTE keywords have been deprecated since Org 8.2.

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 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.

New formatting keys are supported. See the respective docstrings. Note, org-latex-hyperref-template has a new default value.

If you require any of these package add them to your preamble via org-latex-packages-alist. Org also uses default LaTeX \tolerance now.

This helps spotting wrong links.

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".

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)

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.

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, 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.

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.

See org-sort-list: hitting C-c ^ x will put checked items at the end of the list.

• Support SVG images
• Support for .pgf files
• LaTeX Babel blocks can now be exported as .tikz files
• Allow latexmk as an option for 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.

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.

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.

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.

The agenda has not, in addition to day, week, month, and year views, also a fortnight view covering 14 days.

This allows to specify the names of automatic bookmarks.

This allows more flexibility when optimizing the agenda generation. See https://orgmode.org/worg/agenda-optimization.html for details.

This is an export/publishing option, and should be used either within the #+OPTIONS line(s) or within a 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.

This makes java executable configurable for ditaa blocks.

This enables SVG generation from latex code blocks.

See this message from Max Mikhanosha.

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.

This variable can be used to turn off the special behavior of C-o in tables.

"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.

ob-makefile.el implements Org Babel support for Makefile tangling.

ox-man.el allows you to export Org files to man pages.

ox-md.el allows you to export Org files to Markdown files, using the vanilla Markdown syntax.

ox-texinfo.el allows you to export Org files to Texinfo files.

Julia is a new programming language.

ob-julia.el provides Org Babel support for evaluating Julia source code.

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 provides Org Babel support for evaluating Tcl source code.

Display bullets instead of stars for headlines.

Also see this updated FAQ on how to display another character than "*" for starting headlines.

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 Worg.

ox-confluence.el lets you convert Org files to Confluence Wiki files.

deck.js is a javascript library for displaying HTML ages as presentations. ox-deck.el exports Org files to HTML presentations using deck.js.

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.

The 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.

This back-end allow to export Org pages to the KOMA Scrlttr2 format.

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.

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.

These new startup keywords are now available:

• Org now fontifies radio link targets by default
• In the agenda, use org-todo-keyword-faces to highlight selected TODO keywords
• New face org-priority, enhanced fontification of priority cookies in agenda
• New face org-tag-group for group tags

David (and others) translated the Org compact guide in spanish:

You can read the PDF guide.

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:

• "Modern conventions for Emacs Lisp files"
• Exploring Bernt Hansen's Org-mode tutorial with 'navi-mode'

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 on github.

org-eshell.el allows you to create links from Eshell.

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.

If you hit M-TAB on keywords like #+TITLE, Org will try to perform completion with meaningful values.

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.

Do not use Org mode 7.xx with Emacs 21, use version 6.36c instead.

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.

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 variable org-agenda-ndays is obsolete - please use org-agenda-span instead.

Thanks to Julien Danjou for this.

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):

(setq org-export-latex-default-packages-alist nil
      org-export-latex-packages-alist nil)

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:

[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

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.

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.

Please check the docstring and update your settings accordingly.

This function has been deleted: please update your code.