GNU ELPA - org


Outline-based notes management and organizer
org-9.4.6.tar, 2021-May-19, 8.26 MiB
Bastien Guerry <>
Home page
Browse ELPA's repository
CGit or Gitweb

To install this package, run in Emacs:

M-x package-install RET org RET

Full description

-*- mode: org; fill-column:70 -*-

This is a distribution of Org, a plain text notes and project planning
tool for Emacs.

Check the [[][homepage of Org]] and the [[][installations instructions]].

* Contents of this distribution

- README :: This file.

- COPYING :: The GNU General Public License.

- Makefile :: The makefile to compile and install Org.  For installation
  instructions, see the manual or [[][the more detailed procedure on Worg]].
- mk/ :: Files needed for building Org.

- lisp/ :: Directory with all the Emacs Lisp files that make up Org.

- doc/ :: The documentation files.  org.texi is the source of the
  documentation, org.html and org.pdf are formatted versions of it.

- contrib/ :: A directory with third-party additions for Org.  Some
  really cool stuff is in there.

- etc/ :: Files needed for the ODT exporter.

- testing/ :: Testing suite for Org.

- request-assign-future.txt :: The form that contributors have to sign
  and get processed with the FSF before contributed changes can be
  integrated into the Org core.  All files in this distribution except
  the contrib/ directory have copyright assigned to the FSF.

* License

Org-mode is published under [[][the GNU GPLv3 license]] or any later
version, the same as GNU Emacs.  See the COPYING file in this

Old versions

org-9.4.5.tar.lz2021-Mar-281.38 MiB
org-9.4.4.tar.lz2020-Dec-221.38 MiB
org-9.4.3.tar.lz2020-Dec-221.91 MiB
org-9.4.2.tar.lz2020-Dec-131.23 MiB
org-9.4.tar.lz2020-Sep-141.23 MiB
org-9.3.8.tar.lz2020-Sep-071.21 MiB
org-9.3.7.tar.lz2020-Sep-071.21 MiB
org-9.3.6.tar.lz2020-Feb-131.21 MiB
org-9.3.5.tar.lz2020-Feb-121.21 MiB
org-9.3.3.tar.lz2020-Feb-051.21 MiB
org-9.3.2.tar.lz2020-Jan-261.21 MiB
org-9.3.1.tar.lz2019-Dec-261.21 MiB
org-9.3.tar.lz2019-Dec-051.21 MiB
org-9.2.6.tar.lz2019-Sep-041.19 MiB
org-9.2.1.tar.lz2019-Feb-031.19 MiB
org-9.2.tar.lz2018-Dec-311.18 MiB
org-9.1.14.tar.lz2018-Aug-271.17 MiB
org-9.1.9.tar.lz2018-Mar-271.17 MiB
org-9.1.8.tar.lz2018-Mar-261.17 MiB
org-9.1.7.tar.lz2018-Mar-211.17 MiB


ORG NEWS -- history of user-visible changes.   -*- mode: org; coding: utf-8 -*-

#+STARTUP: overview

#+LINK: doc
#+LINK: git

Copyright (C) 2012-2021 Free Software Foundation, Inc.
See the end of the file for license conditions.

Please send Org bug reports to

* Version 9.5 (not yet released)
* Version 9.4
** Incompatible changes
*** Possibly broken internal file links: please check and fix

A bug has been affecting internal links to headlines, like

: [[*Headline][A link to a headline]]

Storing a link to a headline may have been broken in your setup and
those links may appear as

: [[*TODO Headline][A link to a headline]]

Following the link above will result in an error: the TODO keyword
should not be part of internal file links.

You can use the following command to fix links in an Org buffer:

#+begin_src emacs-lisp
(defun org-fix-links ()
  "Fix ill-formatted internal links.
E.g. replace [[*TODO Headline][headline]] by [[*Headline][headline]].
Go through the buffer and ask for the replacement."
  (visible-mode 1)
    (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))

*** Calling conventions changes when opening or exporting custom links

This changes affects export back-ends, and libraries providing new
link types.

Function used in ~:follow~ link parameter is required to accept a
second argument.  Likewise, function used in ~:export~ parameter needs
to accept a fourth argument.  See ~org-link-set-parameters~ for

Eventually, the function ~org-export-custom-protocol-maybe~ is now
called with a fourth argument.  Even though the 3-arguments definition
is still supported, at least for now, we encourage back-end developers
to switch to the new signature.

*** Python session return values must be top-level expression statements

Python blocks with ~:session :results value~ header arguments now only
return a value if the last line is a top-level expression statement.
Also, when a None value is returned, "None" will be printed under
"#+RESULTS:", as it already did with ~:results value~ for non-session

*** In HTML export, change on how outline-container-* is set

When the headline has a =CUSTOM_ID=, use this custom id to build the
div id.  For example, if you have =:CUSTOM_ID: my-headline= then the
resulting <div> will be ~<div id="outline-container-my-headline">~.

You may want to check whether your HTML files are rendered differently
after this change.

*** New keybinding =<C-c C-TAB>= for ~org-force-cycle-archived~

~org-force-cycle-archived~ used to be associated with =<C-TAB>= but
this keybinding is used in Emacs for navigating tabs in Emacs.  The
new keybinding is =<C-c C-TAB>=.

** New default settings for some options

These options now default to =t=:

- ~org-loop-over-headlines-in-active-region~
- ~org-fontify-done-headline~
- ~org-src-tab-acts-natively~

You may want to read the docstrings of these options to understand the
consequences of this change.

Also, ~org-startup-folded~ now defaults to ~showeverything~.

** New features

*** =RET= and =C-j= now obey ~electric-indent-mode~

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

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

- =RET= (bound to ~org-return~) reind...