mirrors
/
org-mode
mirror of https://git.savannah.gnu.org/git/emacs/org-mode.git
0
0
Fork 1
Code Releases Activity

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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

47
etc/ORG-NEWS
View File

@ -62,19 +62,39 @@ should become
,#+END_SRC ,#+END_SRC
#+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 Org 9.2 comes with a new template expansion mechanism, combining
details. `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 *** Default/accepted values of ~org-calendar-to-agenda-key~
[[*~org-insert-structure-template~]] and =org-tempo.el=), the variable
changed its data type. See docstring for details. 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 *** Placeholders in =(eval ...)= macros are always strings
Within =(eval ...)= macros, =$1=-like placeholders are always replaced 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 *** ~org-get-tags~ meaning change
Function ~org-get-tags~ used to return local tags to the current Function ~org-get-tags~ used to return local tags to the current
headline. It now returns the all the inherited tags in addition to headline. It now returns all the inherited tags in addition to the
the local tags. In order to get the old behaviour back, you can use: local tags. In order to get the old behaviour back, you can use:
: (org-get-tags nil t) : (org-get-tags nil t)
@ -130,8 +150,8 @@ code-point.
The =:match= (renamed from =:tags=) option allows to limit clock entries The =:match= (renamed from =:tags=) option allows to limit clock entries
to those matching a todo-tags matcher. to those matching a todo-tags matcher.
The old =:tags= option can be set to =t= to display a headline's tags in The old =:tags= option can be set to =t= to display a headline's tags in a
a dedicated column. dedicated column.
This is consistent with the naming of =org-dblock-write:columnview= This is consistent with the naming of =org-dblock-write:columnview=
options, where =:match= is also used as a headlines filter. options, where =:match= is also used as a headlines filter.
@ -273,6 +293,7 @@ parameters. See example bellow.
#+END_SRC #+END_SRC
** New functions ** New functions
*** ~org-insert-structure-template~ *** ~org-insert-structure-template~
This function can be used to wrap existing text of Org elements in This function can be used to wrap existing text of Org elements in