[GNU ELPA] Org version 9.7.10

[ELPA update]

Version 9.7.10 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 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.

## 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-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-toggle-inline-images-command~, which uses different defaults:

1. By default, it toggles image at point or, if there is no image at
   point, images in current entry

2. When region is active, it is honored

3. =C-u= argument changed its meaning.  Now, it forces toggling images
   in the whole buffer

4. =C-u C-u= argument unconditionally hides all the images in buffer

5. 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 old ~org-toggle-inline-images~ command is still available.  You
can bind it back to =C-c C-x C-v= by adding the following to you 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.

** New features

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

*** 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
If a headline is exported as a frame, and has its =BEAMER_SUBTITLE=
property set, the value is used as the subtitle.

*** =ol.el=: New =shortdoc= link type

You can now create links to =shortdoc= documentation groups for Emacs
Lisp functions (see =M-x shortdoc-display-group=).  Requires Emacs 28
or newer.

** New and changed options

# Chanes deadling with changing default values of customizations,
# adding new customizations, or changing the interpretation of the
# existing customizations.

*** Allow disabling macro replacement during export

New custom option ~org-export-replace-macros~ controls whether Org
mode replaces macros in the buffer before export.  Set it to nil to
disable macro replacement.

This variable has no effect on the ={{{results...}}}= macros for inline
code block results.

*** Allow headline/olp target in ~org-capture-templates~ to be a 
function/variable

The variable ~org-capture-templates~ accepts a target specification as
function or symbol for headline (~file+headline~) and olp (~file+olp~
and ~file+olp+datetree~).

*** New =%\*N= placeholder in ~org-capture-templates~

The new placeholder is like =%\N=, gives access not only to the
=%^{prompt}= values, but also to =%^{prompt}X= values.

*** The default value of ~org-babel-latex-process-alist~ is no longer taken 
from ~org-preview-latex-process-alist~

The default value used to be pulled from =dvipng= process type from
...
...