To install this package from Emacs, use
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.
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
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
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/.
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-2023 Free Software Foundation, Inc. See the end of the file for license conditions. Please send Org bug reports to mailto:firstname.lastname@example.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 ... ...