GNU-devel ELPA - org

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
*** "Priority" used to sort items in agenda is renamed to "urgency"

Previously, ~priority-up~ and ~priority-down~ in
~org-agenda-sorting-strategy~ used a composite rank depending on
item's priority (=[#A]=, =[#B]=, =[#C]=, etc) and overdue time to
order agenda items (see "11.4.3 Sorting of agenda items" section of
Org manual).

Now, this composite rank is renamed to =urgency= and the relevant
sorting strategies are renamed to ~urgency-up~ and ~urgency-down~.
~priority-up~ and ~priority-down~ sort by item's priority only.

Users relying on the previous composite ranking should adjust their
agenda sorting settings.

*** =python-mode.el (MELPA)= support in =ob-python.el= is removed

=python-mode.el= support has been removed from =ob-python.el=.  The
related customization =org-babel-python-mode= has been changed to a
constant.

If you still want to use python-mode with ob-python, you might
consider [[https://gitlab.com/jackkamm/ob-python-mode-mode][ob-python-mode-mode]], where the code to support python-mode
has been ported to.

*** =ox-icalendar.el= line ending fix may affect downstream packages

iCalendar export now uses dos-style CRLF ("\r\n") line endings
throughout, as required by the iCalendar specification (RFC 5545).
Previously, the export used an inconsistent mix of dos and unix line
endings.

This might cause errors in external packages that parse output from
ox-icalendar.  In particular, older versions of org-caldav may
encounter issues, and users are advised to update to the most recent
version of org-caldav.  See [[https://github.com/dengste/org-caldav/commit/618bf4cdc9be140ca1993901d017b7f18297f1b8][this org-caldav commit]] for more information.

** New and changed options
*** Commands affected by ~org-fold-catch-invisible-edits~ can now be customized

New user option ~org-fold-catch-invisible-edits-commands~ controls
which commands trigger checking for invisible edits.

The full list of affected commands is:
- ~org-self-insert-command~
- ~org-delete-backward-char~
- ~org-delete-char~
- ~org-meta-return~
- ~org-return~ (not checked in earlier Org versions)

*** New customization ~org-image-max-width~ limiting the displayed inline image width

New custom variable ~org-image-max-width~ limits the maximum inline
image width, but only when the inline image width is not explicitly
set via ~org-image-actual-width~, =ORG-IMAGE-ACTUAL-WIDTH= property,
or =#+ATTR*= keyword.

By default, when ~org-image-actual-width~ is set to t,
~org-image-max-width~ takes effect.  Its default value is set to
~fill-column~, limiting the image previews to ~fill-column~ number of
characters.

To fall back to previous defaults, where the inline image width is not
constrained, set ~org-image-max-width~ to nil.

*** ~org-src-block-faces~ now accepts empty string ~""~ as language name

It is now possible to customize face of source blocks without language specifier.

: #+begin_src
: Source block with no language
: #+end_src

For example, to set ~highlight~ face, use

#+begin_src emacs-lisp
(setq org-src-fontify-natively t)
(add-to-list 'org-src-block-faces '("" highlight))
#+end_src

*** New ~org-cite-natbib-export-bibliography~ option defining fallback bibliography style

~natbib~ citation export processor now uses
~org-cite-natbib-export-bibliography~ (defaults to ~unsrtnat~) as a
fallback bibliography style if none is specified by user in
=#+cite_export:= keyword.

Previously, export would fail without explicitly selected bibliography
style.
...
...