gnu-emacs-sources
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[GNU ELPA] Org version 9.6.13


From: ELPA update
Subject: [GNU ELPA] Org version 9.6.13
Date: Sun, 10 Dec 2023 17:07:14 -0500

Version 9.6.13 of package Org has just been released in GNU ELPA.
You can now find it in M-x list-packages RET.

Org describes itself as:

  ============================================
  Outline-based notes management and organizer
  ============================================

More at https://elpa.gnu.org/packages/org.html

## Summary:

  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 Mode website] <https://orgmode.org>


  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'


  [GNU ELPA] <https://elpa.gnu.org/packages/org.html>


  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.

## Recent 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-2023 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.7 (not released yet)
** Important announcements and breaking changes
*** ~org-src-associate-babel-session~ and ~org-babel-<lang>-associate-session~ 
are now obsolete

This functionality is not documented, rarely used and can be achieved
via ~org-babel-edit-prep-<lang>~ function.  The latter is the
new recommended way to setup session in Org src buffers.

*** ~org-print-speed-command~ is now an internal function

The old name is marked obsolete and the new name is
~org--print-speed-command~.

This function was always aimed for internal use when building speed
command help buffer.  Now, it is stated explicitly.

*** Babel references =FILE:REFERENCE= now search current buffer when =FILE= 
does not exist

When =FILE= does not exist, the reference is searched in the current
file, using the verbatim reference.  This way,
=:var table=tbl:example= will be searched inside the current buffer.

*** ~tab-width~ value is now assumed to be 8

Org mode now assumes tab width to be 8 characters, when calculating
list and other indentation.  ~tab-width~ is also set to 8 when Org
major mode is loaded.

This is done to improve consistency of the markup for lists, where
indentation affects list items.

Users with non-default values of ~tab-width~ should avoid overriding
the value of 8 set by Org mode.  If the custom ~tab-width~ value is
_smaller_ than 8, the existing Org documents can be converted to the
new standard tab width using the following helper command:

#+begin_src emacs-lisp
(defun org-compat-adjust-tab-width-in-buffer (old-width)
  "Adjust visual indentation from `tab-width' equal OLD-WIDTH to 8."
  (interactive "nOld `tab-width': ")
  (cl-assert (derived-mode-p 'org-mode))
  (unless (= old-width 8)
    (org-with-wide-buffer
     (goto-char (point-min))
     (let (bound
           (repl (if (< old-width 8)
                     (make-string old-width ?\s)
                   (concat "\t" (make-string (- old-width 8) ?\s)))))
       (while (re-search-forward "^ *\t" nil t)
         (skip-chars-forward " \t")
         (setq bound (point-marker))
         (forward-line 0)
         (while (search-forward "\t" bound t)
           (replace-match repl)))))))
#+end_src

*** New export option ~org-export-expand-links~

The new option makes Org expand environment variables in link and INCLUDE paths.
The option is on by default.

Users who do not want variable expansion can set
~org-export-expand-links~ variable to nil or provide
=expand-links:nil= in-file export option.

*** ~org-store-link~ now moves an already stored link to front of the 
~org-stored-links~

Previously, when the link to be stored were stored already,
~org-store-link~ displayed a message and did nothing.

Now, ~org-store-link~ moves the stored link to front of the list of
stored links.  This way, the link will show up first in the completion
and when inserting all the stored links with ~org-insert-all-links~.

*** Major changes and additions to Org API
**** New term: "syntax node"

To reduce confusion with "element" referring to both "syntax element"
and "element/object" class, we now prefer using "syntax node" when
referring to generic Org syntax elements.  "Elements" and "objects"
now refer to different syntax node classes of paragraph-like nodes and
markup-like nodes.

**** New element type ~anonymous~

Secondary strings can now be recognized as ~anonymous~ type to
distinguish from non-elements.  With a new optional argument,
~org-element-type~ will return ~anonymous~ for secondary strings
instead of nil.

The new element type can be used in ~org-element-lineage~,
~org-element-map~, and other functions that filter by element type.
...
...



reply via email to

[Prev in Thread] Current Thread [Next in Thread]