etc/ORG-NEWS: Explicit a few incompatible changes

This commit is contained in:
Bastien 2018-04-28 00:59:07 +02:00
parent 5071776f97
commit f42f15a2a1
1 changed files with 34 additions and 13 deletions

View File

@ -62,19 +62,39 @@ should become
,#+END_SRC
#+END_SRC
*** Change ~org-calendar-to-agenda-key~ value
*** Accepted values of ~org-structure-template-alist~
Default value and accepted value types changed. See [[doc:org-calendar-to-agenda-key][docstring]] for
details.
Org 9.2 comes with a new template expansion mechanism, combining
`org-insert-structure-template' and org-tempo.el
*** Change ~org-structure-template-alist~ value
The data types allowed for the ~org-structure-template-alist~ option
changed, see its docstring for details.
With the new template expansion mechanism (see
[[*~org-insert-structure-template~]] and =org-tempo.el=), the variable
changed its data type. See docstring for details.
*** Default/accepted values of ~org-calendar-to-agenda-key~
The default value and accepted value of ~org-calendar-to-agenda-key~
changed. This is an excerpt of the new docstring:
: When set to default, bind the function to c, but only if it is
: available in the Calendar keymap. This is the default choice because
: c can then be used to switch back and forth between agenda and calendar.
:
: When nil, org-calendar-goto-agenda is not bound to any key.
Check the full docstring for more.
*** Change the signature of the ~org-set-effort~ function
Here is the new docstring:
: (org-set-effort &optional INCREMENT VALUE)
:
: Set the effort property of the current entry.
: If INCREMENT is non-nil, set the property to the next allowed
: value. Otherwise, if optional argument VALUE is provided, use
: it. Eventually, prompt for the new value if none of the previous
: variables is set.
*** Change ~org-set-effort~ signature
See docstring for details.
*** Placeholders in =(eval ...)= macros are always strings
Within =(eval ...)= macros, =$1=-like placeholders are always replaced
@ -114,8 +134,8 @@ document, use =shrink= value instead, or in addition to align:
*** ~org-get-tags~ meaning change
Function ~org-get-tags~ used to return local tags to the current
headline. It now returns the all the inherited tags in addition to
the local tags. In order to get the old behaviour back, you can use:
headline. It now returns all the inherited tags in addition to the
local tags. In order to get the old behaviour back, you can use:
: (org-get-tags nil t)
@ -130,8 +150,8 @@ code-point.
The =:match= (renamed from =:tags=) option allows to limit clock entries
to those matching a todo-tags matcher.
The old =:tags= option can be set to =t= to display a headline's tags in
a dedicated column.
The old =:tags= option can be set to =t= to display a headline's tags in a
dedicated column.
This is consistent with the naming of =org-dblock-write:columnview=
options, where =:match= is also used as a headlines filter.
@ -273,6 +293,7 @@ parameters. See example bellow.
#+END_SRC
** New functions
*** ~org-insert-structure-template~
This function can be used to wrap existing text of Org elements in