Outline-based notes management and organizer
org-9.6snapshot0.20220124.145418.tar, 2022-Jan-24, 8.81 MiB
Bastien Guerry <>
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 [[][this 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.

- 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 have
  copyright assigned to the FSF.

* Join the GNU Project

Org is part of GNU Emacs and GNU Emacs is part of the GNU Operating
System, developed by the GNU Project.

If you are the author of an awesome program and want to join us in
writing Free (libre) Software, please consider making it an official
GNU program and become a GNU Maintainer.  Instructions on how to do
this are here

Don't have a program to contribute?  Look at all the other ways to

And to learn more about Free (libre) Software in general, please
read and share this page:

* License

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

Org-mode is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Org mode.  If not, see <>.

Old versions

org-9.6snapshot0.20220123.132655.tar.lz2022-Jan-231.47 MiB
org-9.6snapshot0.20220123.94112.tar.lz2022-Jan-231.47 MiB
org-9.6snapshot0.20220122.145143.tar.lz2022-Jan-221.47 MiB
org-9.6snapshot0.20220119.93734.tar.lz2022-Jan-191.47 MiB
org-9.6snapshot0.20220109.163832.tar.lz2022-Jan-091.47 MiB
org-9.6snapshot0.20211229.225355.tar.lz2021-Dec-301.47 MiB
org-9.6snapshot0.20210930.173327.tar.lz2021-Sep-301.44 MiB
org- MiB
org-0.20171225.tar.lz2017-Dec-251.17 MiB
org-0.20121231.tar.lz2012-Dec-311017 KiB


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

#+STARTUP: overview

#+LINK: doc
#+LINK: msg
#+LINK: git

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

Please send Org bug reports to

* Version 9.6 (not yet released)

** Important announcements and breaking changes

*** Element cache is enabled by default and work for headings

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

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

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

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

*** Element cache persists across Emacs sessions

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

The cache persistence can be controlled via

** New features

*** New library =org-persist.el= implements variable persistence across Emacs sessions

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

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

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

*** New =:options= attribute when exporting tables to LaTeX

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

** New functions and changes in function arguments

*** New function ~org-element-cache-map~ for quick mapping across Org elements

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

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

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

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

*** New function ~org-element-at-point-no-context~

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

This function is faster than ~org-element-at-point~ when used together
with frequent buffer edits.
*** Various Org API functions now use cache and accept Org elements as optional arguments

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

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

** Miscellaneous

*** Styles are customizable in ~biblatex~ citation processor

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

*** Citation processors can declare styles dynamically