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.

*** 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.

*** 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
~org-preview-latex-process-alist~.  Now, it defaults to using
=latexmk= (when available), or running =latex= multiple times, so that
all the references are resolved in the generated png.

*** New option ~org-cite-csl-bibtex-titles-to-sentence-case~

When this option is non-nil then title fields in bibtex bibliography
entries are converted to sentence-case before being formatted
according to a CSL style, except for entries with a =langid= field
specifying a non-English language.  When nil, this conversion is
limited to entries having a =langid= field specifying a variant of
English.  The default value is ~t~ as the CSL standard assumes that
English titles are specified in sentence-case but the bibtex
bibliography format requires them to be written in title-case.

** New functions and changes in function arguments

# This also includes changes in function behavior from Elisp perspective.

*** ob-sqlite: Added ability to open a database in readonly mode

Added option :readonly to ob-sqlite.

When :readonly=true the database is opened in readonly mode. For example:

#+begin_src sqlite :db /tmp/rip.db  :readonly yes  :exports both
create table rip(a,b);
#+end_src

This results in an error such as:

#+begin_example
Runtime error near line 2: attempt to write a readonly database (8)
[ Babel evaluation exited with code 1 ]
#+end_example
...
...