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-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.8 (not released yet)
** Important announcements and breaking changes

# Here, we list the *most important* changes and changes that _likely_
# require user action for most Org mode users.
# Sorted from most important to least important.

*** =C-c C-x C-v= command toggling inline image display has been reworked

Previously, =C-c C-x C-v= always toggled image display in the whole
buffer (or narrowed part of the buffer).  With prefix argument, it
also forced displaying image links with description.

Now, =C-c C-x C-v= is bound to a new command ~org-link-preview~, which
uses different defaults:

1. When the region is active, images in the region are previewed

2. Otherwise, if there is an image at point, it is toggled.  If there
   is no image at point, images in the current entry are previewed

3. With the =C-u= argument, image previews in the active region or at
   point are cleared instead

4. The =C-u C-u= argument unconditionally shows all images in the
   accessible portion of the buffer

5. The =C-u C-u C-u= argument unconditionally clears all images in the
   accessible portion of the buffer

6. Displaying images over links with description can be forced using
   numeric argument:
   - ~C-u 1~ for toggling all images at point/current entry
   - ~C-u 11~ for toggling all images in buffer

(The first five of these prefix arg behaviors are the same as that of
the ~org-latex-preview~ command.)

In addition to images, ~org-link-preview~ can also be used to preview
Org links of all types for which preview behavior is defined, see
[[#link-preview][previews for arbitrary link types]].

The old ~org-toggle-inline-images~ command is obsolete but still
available.  You can bind it back to =C-c C-x C-v= by adding the
following to your config:
#+begin_src emacs-lisp
(eval-after-load 'org-keys
  (org-defkey org-mode-map (kbd "C-c C-x C-v") #'org-toggle-inline-images))
#+end_src

*** Org mode may throw an error when attempting to include remote unsafe resource noninteractively

Previously, when ~org-resource-download-policy~ is ~ask~ (default),
and Emacs is running in batch mode, Org mode simply skipped unsafe
remote resources in the =#+include:='s.  Now, an error is thrown to
avoid seemingly ignored =#+include= statements when publishing via
batch scripts.

*** Diary-style timestamps are exported together with active timestamps

~org-export-with-timestamps~ and ~org-icalendar-with-timestamps~ now
treat diary-style timestamps as a type of active timestamp for
purposes of export.

This mainly affects iCalendar export, where diary timestamps will now
be included when only active timestamps are exported (the default).

This should have minimal impact on non-iCalendar exporters, since
~org-export-with-timestamps~ was already ~t~ by default.  However,
users who manually set ~org-export-with-timestamps~ to ~active~ will
now have diary timestamps included as well.

** New features

# We list the most important features, and the features that may
# require user action to be used.

*** All Org link types can be previewed
:PROPERTIES:
:CUSTOM_ID: link-preview
:END:

Org links support a new parameter =:preview= that can be used to
preview arbitrary link types.  The value of this parameter should be a
function that is called to preview links of the corresponding type
(see ~org-link-parameters~).

*** Alignment of image previews can be customized

This is not a new feature.  It has been added in Org 9.7, but not
documented in the news.  See [[#preview-align][restrospectively added news entry]].

*** Beamer export supports setting frame subtitles
...
...