GNU ELPA - org

org

Description
Outline-based notes management and organizer
Latest
org-9.6.21.tar (.sig), 2024-Mar-08, 9.23 MiB
Maintainer
Bastien Guerry <bzg@gnu.org>
Website
https://orgmode.org
Browse ELPA's repository
CGit or Gitweb
Badge

To install this package from Emacs, use package-install or list-packages.

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 use command: M-x list-packages, find "org" in the list, click on it, and click "Install" in the popped up window.

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.6.20.tar.lz2024-Feb-281.54 MiB
org-9.6.19.tar.lz2024-Feb-111.54 MiB
org-9.6.18.tar.lz2024-Feb-041.54 MiB
org-9.6.9.tar.lz2023-Sep-031.54 MiB
org-9.6.8.tar.lz2023-Aug-221.54 MiB
org-9.6.7.tar.lz2023-Jun-261.54 MiB
org-9.6.6.tar.lz2023-May-141.54 MiB
org-9.6.5.tar.lz2023-Apr-301.54 MiB
org-9.6.4.tar.lz2023-Apr-161.54 MiB
org-9.6.3.tar.lz2023-Apr-021.54 MiB
org-9.6.2.tar.lz2023-Mar-271.54 MiB
org-9.6.1.tar.lz2023-Jan-111.54 MiB
org-9.6.tar.lz2022-Nov-291.54 MiB
org-9.5.5.tar.lz2022-Sep-031.45 MiB
org-9.5.3.tar.lz2022-Apr-191.44 MiB
org-9.5.tar.lz2021-Sep-291.44 MiB
org-9.4.6.tar.lz2021-May-191.38 MiB
org-9.3.8.tar.lz2020-Sep-071.21 MiB
org-9.2.6.tar.lz2019-Sep-041.19 MiB
org-9.1.14.tar.lz2018-Aug-271.17 MiB

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

** Important announcements and breaking changes
*** =python-mode.el (MELPA)= support in =ob-python.el= is deprecated

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

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

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

*** Element cache is enabled by default and works 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 optimized 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 optimization can be enabled by customizing
=org-fold-core--optimise-for-huge-buffers=.  However, this option may
be dangerous.  Please, read the variable docstring carefully to
understand the possible consequences.

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

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