Old Release notes | Org mode

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

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 customise 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 preceedes 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, emphasised 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 behaviour should change their face customisation explicitly stating that default face is inherited.

Example of old face customisation:

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

To preserve the old behaviour the above customisation 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 recognised 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>.

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.

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.

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.

Since Emacs 24.4, electric-indent-mode is enabled by default. In most major modes, this causes RET to reindent the current line and indent the new line, and C-j to insert a newline without indenting.

Org mode now obeys this minor mode: when electric-indent-mode is enabled, and point is neither in a table nor on a timestamp or a link:

• RET (bound to org-return) reindents the current line and indents the new line;
• C-j (bound to the new command org-return-and-maybe-indent) merely inserts a newline.

To get the previous behaviour back, disable electric-indent-mode explicitly:

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

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 2.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 behaviour 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, applied in order:

1. All consecutive \ characters at the end of the link must be escaped;
2. Any ] character at the very end of the link must be escaped;
3. All consecutive \ characters preceding ][ or ]] patterns must be escaped;
4. Any ] character followed by either [ or ] must be escaped;
5. Others ] and \ characters need not 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 behaviour 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 favour 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 behaviour 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 anyways!

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

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 udpate 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 4.2.10 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 behaviour 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.

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 "http://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 bellow.

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.

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 informations 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 sectionning commands anymore. Also, the sectionning 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.

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

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.

ZONE specifies the current time zone.

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 maintainance 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 a S-expresion 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 unconditionnally 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 projet. 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="http://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"))))))))))))

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

The key sequences C-c C-n and C-c C-p are now bound to org-next-visible-heading and org-next-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 point is before or after the headline title, insert a new line without changing the headline.

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

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 behaviour 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@.+. Good for example if tags for a certain project is tagged with a common project-identifier, i.e. P@2014_OrgTags.

Filtering in the agenda on grouptags filter all of the related tags. Exception if 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.

Thanks to Jarmo Hurri for this feature.

The new behaviour 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 appopriate 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, befor wrapping it within the template.

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 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 programatically, 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' behaviour 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 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.

This undocumented option defaulted to the value of shell-file-name at the time of loading ob-shell. The new behaviour is to use the value of shell-file-name directly when the shell langage 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 did not work properly in some environments as xdg-open is desktop specific.

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.

• rotating is now a default package, to support sideways tables.
• amsmath is a default package
• eucal package removed, no longer needed since amsmath is present

Furthermore, the manual now specifically notes if an additional package is needed for one of the documented attributes.

Thanks to Marc McLean for this patch.

When following a link that has an id: prefix, org-id.el will now automatically be loaded.

Thanks to Oleh for this patch

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.

Thanks to Nicolas Goaziou for the implementation.

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

Thanks to Michael Gauland for the implementation.

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

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.

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]{inputenc}, AUTO will automatically be replaced with a coding system derived from buffer-file-coding-system.
• The dependency on the latexsym LaTeX package has been removed, we now use amssymb symbols by default instead.

forward-paragraph and backward-paragraph are now remapped to org-forward-element and org-backward-element respectively. E.g. hitting C-<down> on a headline will move to the next headline.

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, preccurleyeq, succ, succeq, succurleyeq, setminus, nexist(s), mho, check, frown, diamond. Changes loz, vert, checkmark, smile and tilde.

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.

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.

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.

Achim implemented a new build system.

The basic method for installing Org is the same:

1. Download or clone Org.
2. run `make install' from the Org directory.
3. Add (require 'org-install) in your .emacs.el.

But the build system is now more flexible and can be more easily adapted to suit your needs.

See https://orgmode.org/worg/dev/org-build-system.html for details.

Note: The EXPERIMENTAL/ directory has been deleted. The files have been moved to the contrib/lisp/ directory.

Nicolas export engine org-export.el lives in the contrib/lisp/ directory. To use it:

Make sure contrib/lisp/ is in your load-path
M-: (require 'org-export) RET
M-: (require 'org-e-latex) RET ; or any other library
M-x org-export-dispatch RET

These are the currently available exporters:

• org-e-ascii.el by Nicolas
• org-e-beamer.el by Nicolas
• org-e-groff.el by Luis Anaya
• org-e-html.el by Jambunathan
• org-e-latex.el by Nicolas
• org-e-man.el by Luis Anaya
• org-e-odt.el by Jambunathan
• org-e-texinfo.el by Jonathan Leech-Pepin
• org-md.el by Nicolas

If we have enough testers, the new export engine is very likely to replace the current one for the next major release. Please report any problem on the mailing list!

If you want to write a new export backend based on this export engine, please check the online documentation.

org-element.el is a toolbox for parsing and analysing "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 particularily 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 http://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.

Jambunathan's Org to ODT exporter is now part of Org.

To use it, it `C-c C-e o' in an Org file. See the documentation for more information on how to customize it.

This replaces the earlier system org-remember. The manual only describes org-capture, but for people who prefer to continue to use org-remember, we keep a static copy of the former manual section chapter about remember.

The new system has a technically cleaner implementation and more possibilities for capturing different types of data. See Carsten's announcement for more details.

To switch over to the new system:

1. Run

   M-x org-capture-import-remember-templates RET
   

   to get a translated version of your remember templates into the new variable org-capture-templates. This will "mostly" work, but maybe not for all cases. At least it will give you a good place to modify your templates. After running this command, enter the customize buffer for this variable with

   M-x customize-variable RET org-capture-templates RET
   

   and convince yourself that everything is OK. Then save the customization.

2. Bind the command org-capture to a key, similar to what you did with org-remember:

   (define-key global-map "\C-cc" 'org-capture)
   

   If your fingers prefer C-c r, you can also use this key once you have decided to move over completely to the new implementation. During a test time, there is nothing wrong with using both system in parallel.

• ob-picolisp.el (Thorsten Jolitz)
• ob-fortran.el (Sergey Litvinov)
• ob-shen.el (Eric Schulte)
• ob-maxima.el (Eric S Fraga)
• ob-java.el (Eric Schulte)
• ob-lilypond.el (Martyn Jago)
• ob-awk.el (Eric Schulte)

Images can now be displayed inline. The key C-c C-x C-v does toggle the display of such images. Note that only image links that have no description part will be inlined.

If you want to start an ordered plain list with a number different from 1, you can now do it like this:

1. [@start:12] will star a lit a number 12

In org-babel, code is "expanded" prior to evaluation. I.e. the code that is actually evaluated comprises the code block contents, augmented with the extra code which assigns the referenced data to variables. It is now possible to preview expanded contents, and also to expand code during during tangling. This expansion takes into account all header arguments, and variables.

A new keybinding `C-c M-b p' bound to `org-babel-expand-src-block' can be used from inside of a source code block to preview its expanded contents (which can be very useful for debugging). tangling

The expanded body can now be tangled, this includes variable values which may be the results of other source-code blocks, or stored in headline properties or tables. One possible use for this is to allow those using org-babel for their emacs initialization to store values (e.g. usernames, passwords, etc…) in headline properties or in tables.

Org-babel now supports three new header arguments, and new default behavior for handling horizontal lines in tables (hlines), column names, and rownames across all languages.

Following a round of on-list discussion, many code block synonyms have been removed. You can safely move forward the following syntax:

• call lines are specified with #+call:
• code blocks are named with #+name:
• results are named with #+name:, however results generated by a code block may still be labeled with #+results:, and tables named with #+tblname: will be considered to be named results

The following function may be used to update an existing Org mode buffer to the new syntax:

(defun update-org-buffer ()
  "Update an Org mode buffer to the new data, code block and call line syntax."
  (interactive)
  (save-excursion
    (flet ((to-re (lst) (concat "^[ \t]*#\\+" (regexp-opt lst t)
                                "\\(\\[\\([[:alnum:]]+\\)\\]\\)?\\:[ \t]*"))
           (update (re new)
                   (goto-char (point-min))
                   (while (re-search-forward re nil t)
                     (replace-match new nil nil nil 1))))
      (let ((old-re (to-re '("RESULTS" "DATA" "SRCNAME" "SOURCE")))
            (lob-re (to-re '("LOB")))
            (case-fold-search t))
        (update old-re "name")
        (update lob-re "call")))))

Note: If an old version of Org mode (e.g., the one shipped with Emacs) is installed on your system, many of the important variables will be pre-defined with a defvar and will not have their values automatically updated – these include the following:

• org-babel-data-names
• org-babel-result-regexp
• org-babel-src-block-regexp
• org-babel-src-name-regexp
• org-babel-src-name-w-name-regexp

It may be necessary to either remove the source code of older versions of Org mode or to explicitly evaluate the ob.el file.

Code block header arguments may now be specified using the standard #+Property: keyword. See Property names ending in + accumulate for more information on the extended property syntax.

This function has been deleted: please update your hacks if you relied on it.

You can type "<2011-12-12 Mon>" or [2011-12-12 Mon] and modify this timestamps with S-<right> like other timestamps. Thanks to Carsten for implementing this.

The new function allows the user to refine the scope of entries to pass to org-agenda-get-day-entries and allows to filter out entries using a function.

Thanks to Peter Münster for raising a related issue and to Tassilo Horn for this idea. Also thanks to Peter Münster for fixing a small bug in the final implementation.

The command org-agenda-date-later (<S-right> in the Agenda Mode) directly jumps to today. Thanks to Carsten for implementing this.

See Carsten's comment: "Sometimes I want to quickly make a few TODOs done in the agenda and I want to bypass the note taking I have normally set up. With this change, I can press `0 t d' in the agenda to do this."

Thanks to Carsten for implementing this.

Nicolas Goaziou worked on refactoring and improving org-indent.el, which should now be faster. It also better combines with visual-line-mode.

This results in the following behavior.

  #+property: var  foo=1
  #+property: var+ bar=2

  #+begin_src emacs-lisp
     (+ foo bar)
  #+end_src

  #+results:
   : 3

  #+begin_src emacs-lisp
     (org-entry-get (point) "var" t)
  #+end_src

  #+results:
   : foo=1 bar=2

* overwriting a file-wide property
     :PROPERTIES:
     :var:      foo=7
     :END:

  #+begin_src emacs-lisp
     foo
  #+end_src

  #+results:
   : 7

  #+begin_src emacs-lisp
     (org-entry-get (point) "var" t)
  #+end_src

  #+results:
   : foo=7

* appending to a file-wide property
     :PROPERTIES:
     :var+:      baz=3
     :END:

  #+begin_src emacs-lisp
     (+ foo bar baz)
  #+end_src

  #+results:
   : 6

  #+begin_src emacs-lisp
     (org-entry-get (point) "var" t)
  #+end_src

  #+results:
   : foo=1 bar=2 baz=3

This option used to be `nil' by default. This now has a default value, displaying an agenda and all TODOs. See the docstring for details. Thanks to Carsten for this.

Users who use this outline commands in outline-mode will want them to behave the Org way in Org. Thanks to Michael Brand for the suggestion.

The option org-log-note-headings now supports %d and %D for inactive and active timestamps. This affect the behavior of the command org-store-log-note. Thanks to John J Foerch for a patch for this.