org

Description
Outline-based notes management and organizer
Latest
org-9.6pre0.20220927.142057.tar, 2022-Sep-27, 9.15 MiB
Maintainer
Bastien Guerry <bzg@gnu.org>
Website
https://orgmode.org
Browse ELPA's repository
CGit or Gitweb
Badge

To install this package, run in Emacs:

M-x package-install RET org RET

Full description

This is a distribution of Org Mode, a major mode for keeping notes, authoring documents, computational notebooks, literate programming, maintaining to-do lists, planning projects, and more — in a fast and effective plain text system.

Check the Org Mode website for more.

1 Install Org

Org is part of GNU Emacs: you probably don't need to install it.

To install a more recent version, please do it from GNU ELPA by running this command: M-x package-install RET org RET

2 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 http://www.gnu.org/help/evaluation.

Don't have a program to contribute? Look at all the other ways to help: https://www.gnu.org/help/help.html.

And to learn more about Free (libre) Software in general, please read and share this page: https://gnu.org/philosophy/free-sw.html

3 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 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with Org mode. If not, see https://www.gnu.org/licenses/.

Old versions

org-9.6pre0.20220926.124154.tar.lz2022-Sep-261.53 MiB
org-9.6snapshot0.20220922.64837.tar.lz2022-Sep-221.53 MiB
org-9.6snapshot0.20220921.74530.tar.lz2022-Sep-211.53 MiB
org-9.6snapshot0.20220918.134604.tar.lz2022-Sep-181.53 MiB
org-9.6snapshot0.20220831.33116.tar.lz2022-Aug-311.53 MiB
org-9.6snapshot0.20211229.225355.tar.lz2021-Dec-301.47 MiB
org-9.6snapshot0.20210930.173327.tar.lz2021-Sep-301.44 MiB
org-9.5.0.20210929.134035.tar.lz2021-Sep-291.44 MiB
org-0.20171225.tar.lz2017-Dec-251.17 MiB
org-0.20121231.tar.lz2012-Dec-311017 KiB

News

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

#+STARTUP: overview

#+LINK: doc https://orgmode.org/worg/doc.html#%s
#+LINK: msg https://list.orgmode.org/%s/
#+LINK: git https://git.savannah.gnu.org/cgit/emacs/org-mode.git/commit/?id=%s

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

Please send Org bug reports to mailto:emacs-orgmode@gnu.org.

* Version 9.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
~org-element-cache-persistent~.

*** Users experiencing performance issues can use new folding backend

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

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

#+begin_src emacs-lisp
(setq org-fold-core-style 'overlays)
#+end_src

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

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

**** Hidden parts of the links can now be searched and revealed during isearch

In the past, hidden parts of the links could not be searched using
isearch (=C-s=).  Now, they are searchable by default.  The hidden
match is also revealed temporarily during isearch.

To restore the old behaviour add the following core to your Emacs
config:

#+begin_src emacs-lisp
(defun org-hidden-link-ignore-isearch ()
  "Do not match hidden parts of links during isearch."
  (org-fold-core-set-folding-spec-property 'org-link :isearch-open nil)
  (org-fold-core-set-folding-spec-property 'org-link :isearch-ignore t))
(add-hook 'org-mode-hook #'org-hidden-link-ignore-isearch)
#+end_src

See docstring of =org-fold-core--specs= to see more details about
=:isearch-open= and =:isearch-ignore= properties.

**** =org-catch-invisible-edits= now works for hidden parts of the links and for emphasis markers

In the past, user could edit invisible parts of the links and emphasis markers.  Now, the editing is respecting the value of =org-catch-invisible-edits=.

Note that hidden parts of sub-/super-scripts are still not handled.

**** Breaking structure of folded elements automatically reveals the folded text

In the past, the user could be left with unfoldable text after breaking the org structure.

For example, if

#+begin_src org
:DRAWER:
like this
:END:
#+end_src

is folded and then edited into

#+begin_src org
DRAWER:
like this
:END:
#+end_src
The hidden text would not be revealed.

Now, breaking structure of drawers, blocks, and headings automatically
reveals the folded text.
...
...