.emacs.d.git - Gitblit

Chizi123

2018-11-21 e75a20334813452c6912c090d70a0de2c805f94d

commit \| author \| age
76bbd0	1	ORG NEWS -- history of user-visible changes. -- mode: org; coding: utf-8 --
C	2
	3	#+LINK: doc https://orgmode.org/worg/doc.html#%s
	4	#+LINK: git https://code.orgmode.org/bzg/org-mode/commit/%s
	5
	6	Copyright (C) 2012-2018 Free Software Foundation, Inc.
	7	See the end of the file for license conditions.
	8
	9	Please send Org bug reports to mailto:emacs-orgmode@gnu.org.
	10
	11	* Version 9.1
	12
	13	** Incompatible changes
	14
	15	*** Variables relative to clocksum duration are obsolete
	16
	17	~org-time-clocksum-format~, ~org-time-clocksum-use-fractional~ and
	18	~org-time-clocksum-fractional-format~ are obsolete. If you changed
	19	them, consider modifying ~org-duration-format~ instead.
	20
	21	Variable ~org-time-clocksum-use-effort-durations~ is also obsolete.
	22	Consider setting ~org-duration-units~ instead.
	23
	24	*** ~org-at-timestamp-p~ optional argument accepts different values
	25
	26	See docstrings for the allowed values. For backward compatibility,
	27	~(org-at-timestamp-p t)~ is still supported, but should be updated
	28	accordingly.
	29
	30	*** ~org-capture-templates~ no longer accepts S-expressions as file names
	31
	32	Since functions are allowed there, a straightforward way to migrate
	33	is to turn, e.g.,
	34
	35	: (file (sexp))
	36
	37	into
	38
	39	: (file (lambda () (sexp)))
	40
	41	*** Deleted contributed packages
	42
	43	=org-ebib.el, =org-bullets.el= and =org-mime.el= have been deleted
	44	from the contrib/ directory.
	45
	46	You can now find them here :
	47
	48	- https://github.com/joostkremers/ebib
	49	- https://github.com/sabof/org-bullets
	50	- https://github.com/org-mime/org-mime
	51
	52	*** Change ~org-texinfo-classes~ value
	53	The value cannot support functions to create sectioning commands
	54	anymore. Also, the sectioning commands should include commands for
	55	appendices. See the docstring for more information.
	56	*** Removal of ~:sitemap-sans-extension~
	57
	58	The publishing property is no longer recognized, as a consequence of
	59	changes to site-map generation.
	60
	61	You can get the same functionality by setting ~:sitemap-format-entry~
	62	to the following
	63
	64	#+BEGIN_SRC elisp
	65	(lambda (entry style project)
	66	(cond ((not (directory-name-p entry))
	67	(format "[[file:%s][%s]]"
	68	(file-name-sans-extension entry)
	69	(org-publish-find-title entry project)))
	70	((eq style 'tree) (file-name-nondirectory (directory-file-name entry)))
	71	(t entry)))
	72	#+END_SRC
	73
	74	*** Change signature for ~:sitemap-function~
	75
	76	~:sitemap-function~ now expects to be called with two arguments. See
	77	~org-publish-project-alist~ for details.
	78
	79	*** Change signature for some properties in ~org-list-to-generic~
	80
	81	~:istart~, ~:icount~, ~:iend~ and ~:isep~ now expect the type of the
	82	list as their first argument.
	83
	84	*** Change signature for ~org-get-repeater~
	85	The optional argument is now a string to extract the repeater from.
	86	See docstring for details.
	87
	88	*** Change signature for ~org-time-string-to-time~
	89	See docstring for changes.
	90
	91	*** Change order of items in ~org-agenda-time-grid~
	92	~org-agenda-time-grid~ gained an extra item to allow users to customize
	93	the string displayed after times in the agenda. See docstring for
	94	details.
	95
	96	*** ~tags-todo~ custom searches now include DONE keywords
	97
	98	Use "/!" markup when filtering TODO keywords to get only not-done TODO
	99	keywords.
	100
	101	*** ~org-split-string~ returns ~("")~ when called on an empty string
	102	It used to return nil.
	103	*** Removal of =ob-scala.el=
	104
	105	See [[https://github.com/ensime/emacs-scala-mode/issues/114][this github issue]].
	106
	107	You can use =ob-scala.el= as packaged in scala-mode, available from the
	108	MELPA repository.
	109
	110	** New features
	111	*** iCalendar export uses inheritance for TIMEZONE and LOCATION properties
	112	Both these properties can be inherited during iCalendar export,
	113	depending on the value of ~org-use-property-inheritance~.
	114	*** iCalendar export respects a TIMEZONE property
	115	Set the TIMEZONE property on an entry to specify a time zone for that
	116	entry only during iCalendar export. The property value should be
	117	specified as in "Europe/London".
	118	*** ~org-attach~ can move directory contents
	119	When setting a new directory for an entry, org-attach offers to move
	120	files over from the old directory. Using a prefix arg will reset the
	121	directory to old, ID based one.
	122	*** New Org duration library
	123	This new library implements tools to read and print time durations in
	124	various formats (e.g., "H:MM", or "1d 2h 3min"...).
	125
	126	See ~org-duration-to-minutes~ and ~org-duration-from-minutes~
	127	docstrings.
	128
	129	*** Agenda
	130	**** New variable : ~org-agenda-show-future-repeats~
	131	**** New variable : ~org-agenda-prefer-last-repeat~
	132	**** New variable : ~org-deadline-past-days~
	133	See docstring for details.
	134	**** Binding C-c C-x < for ~org-agenda-set-restriction-lock-from-agenda~
	135	**** New auto-align default setting for =org-agenda-tags-column=
	136
	137	=org-agenda-tags-column= can now be set to =auto=, which will
	138	automatically align tags to the right edge of the window. This is now
	139	the default setting.
	140
	141	*** New value for ~org-publish-sitemap-sort-folders~
	142
	143	The new ~ignore~ value effectively allows toggling inclusion of
	144	directories in published site-maps.
	145
	146	*** Babel
	147
	148	**** Scheme: support for tables
	149	**** Scheme: new variable: ~org-babel-scheme-null-to~
	150
	151	This new custom option allows you to use an empty list or null symbol to
	152	format the table output, initially assigned to ~hlines~.
	153
	154	**** Scheme: new header ~:prologue~
	155
	156	A new block code header has been created for Org Babel that enables
	157	developers to prepend code to the scheme block being processed.
	158
	159	Multiple ~:prologue~ headers can be added each of them using a string
	160	with the content to be added.
	161
	162	The scheme blocks are prepared by surrounding the code in the block
	163	with a let form. The content of the ~:prologue~ headers are prepended
	164	before this let form.
	165
	166	**** Support for hledger accounting reports added
	167	**** Clojure: new setting ~org-babel-clojure-sync-nrepl-timeout~
	168
	169	Creation of a new setting to specify the Cider timeout. By setting
	170	the =org-babel-clojure-sync-nrepl-timeout= setting option. The value
	171	is in seconds and if set to =nil= then no timeout will occur.
	172	**** Clojure: new header ~:show-process~
	173
	174	A new block code header has been created for Org Babel that enables
	175	developers to output the process of an ongoing process into a new
	176	window/buffer.
	177
	178	You can tell Org Babel to output the process of a running code block.
	179
	180	To show that output you only have to specify the =:show-process=
	181	option in the code block's header like this:
	182
	183	#+begin_example
	184	,#+BEGIN_SRC clojure :results output :show-process t
	185	(dotimes [n 10]
	186	(println n ".")
	187	(Thread/sleep 500))
	188	,#+END_SRC
	189	#+end_example
	190
	191	If =:show-process= is specified that way, then when you will run the
	192	code using =C-c C-c= a new window will open in Emacs. Everything that
	193	is output by the REPL will immediately be added to that new window.
	194
	195	When the processing of the code is finished, then the window and its
	196	buffer will be closed and the results will be reported in the
	197	=#+RESULTS= section.
	198
	199	Note that the =:results= parameter's behavior is not changed. If
	200	=silent= is specified, then no result will be displayed. If =output=
	201	is specified then all the output from the window will appears in the
	202	results section. If =value= is specified, then only the last returned
	203	value of the code will be displayed in the results section.
	204
	205	**** Maxima: new headers ~:prologue~ and ~:epilogue~
	206	Babel options ~:prologue~ and ~:epilogue~ have been implemented for
	207	Maxima src blocks which prepend and append, respectively, the given
	208	code strings. This can be useful for specifying formatting settings
	209	which would add clutter to exported code. For instance, you can use
	210	this ~:prologue "fpprintprec: 2; linel: 50;"~ for presenting Maxima
	211	results in a beamer presentation.
	212	**** PlantUML: add support for header arguments
	213
	214	[[http://plantuml.com/][Plantuml]] source blocks now support the [[https://orgmode.org/manual/prologue.html#prologue][~:prologue~]], [[https://orgmode.org/manual/epilogue.html#epilogue][~:epilogue~]] and
	215	[[https://orgmode.org/manual/var.html#var][~:var~]] header arguments.
	216
	217	**** SQL: new engine added ~sqsh~
	218
	219	A new engine was added to support ~sqsh~ command line utility for use
	220	against Microsoft SQL Server or Sybase SQL server.
	221
	222	More information on ~sqsh~ can be found here: [[https://sourceforge.net/projects/sqsh/][sourceforge/sqsh]]
	223
	224	To use ~sqsh~ in an sql =SRC_BLK= set the =:engine= like this:
	225
	226	#+begin_example
	227	,#+BEGIN_SRC sql :engine sqsh :dbhost my_host :dbuser master :dbpassword pass :database support
	228	Select * From Users
	229	Where clue > 0
	230	,#+END_SRC
	231	#+end_example
	232
	233	**** SQL: new engine added =vertica=
	234
	235	A new engine was added to support vsql command line utility for use
	236	against HP Vertica.
	237
	238	More information on =vsql= can be found here: [[https://my.vertica.com/docs/7.2.x/HTML/index.htm#Authoring/ConnectingToHPVertica/vsql/UsingVsql.htm][my.vertica.com]]
	239
	240	To use =vertica= in an sql =SRC_BLK= set the =:engine= like this:
	241
	242	#+BEGIN_EXAMPLE
	243	,#+BEGIN_SRC sql :engine vertica :dbhost my_host :dbuser dbadmin :dbpassword pw :database vmart
	244	SELECT * FROM nodes;
	245	,#+END_SRC
	246	#+END_EXAMPLE
	247	**** C++: New header ~:namespaces~
	248
	249	The new ~:namespaces~ export option can be used to specify namespaces
	250	to be used within a C++ org source block. Its usage is similar to
	251	~:includes~, in that it can accept multiple, space-separated
	252	namespaces to use. This header is equivalent to adding ~using
	253	namespace <name>;~ in the source block. Here is a "Hello World" in C++
	254	using ~:namespaces~:
	255
	256	#+begin_example
	257	,#+BEGIN_SRC C++ :results output :namespaces std :includes <iostream>
	258	cout << "Hello World" << endl;
	259	,#+END_SRC
	260	#+end_example
	261
	262	**** Support for Vala language
	263
	264	[[https://wiki.gnome.org/Projects/Vala][Vala]] language blocks support two special header arguments:
	265
	266	- ~:flags~ passes arguments to the compiler
	267	- ~:cmdline~ passes commandline arguments to the generated executable
	268
	269	Support for [[https://orgmode.org/manual/var.html#var][~:var~]] does not exist yet, also there is no [[https://orgmode.org/manual/session.html#session][~:session~]]
	270	support because Vala is a compiled language.
	271
	272	The Vala compiler binary can be changed via the ~defcustom~
	273	~org-babel-vala-compiler~.
	274
	275	*** New ~function~ scope argument for the Clock Table
	276	Added a nullary function that returns a list of files as a possible
	277	argument for the scope of the clock table.
	278	*** Export
	279	**** Implement vernacular table of contents in Markdown exporter
	280	Global table of contents are generated using vanilla Markdown syntax
	281	instead of HTML. Also #+TOC keyword, including local table of
	282	contents, are now supported.
	283	**** Add Slovenian translations
	284	**** Implement ~org-export-insert-image-links~
	285	This new function is meant to be used in back-ends supporting images
	286	as descriptions of links, a.k.a. image links. See its docstring for
	287	details.
	288	**** New macro : ~{{{n}}}~
	289	This macro creates and increment multiple counters in a document. See
	290	manual for details.
	291	**** Add global macros through ~org-export-global-macros~
	292	With this variable, one can define macros available for all documents.
	293	**** New keyword ~#+EXPORT_FILE_NAME~
	294	Similarly to ~:EXPORT_FILE_NAME:~ property, this keyword allows the
	295	user to specify the name of the output file upon exporting the
	296	document. This also has an effect on publishing.
	297	**** Horizontal rules are no longer ignored in LaTeX table math mode
	298	**** Use ~compilation-mode~ for compilation output
	299	**** Plain lists accept a new ~:separator~ attribute in Texinfo
	300
	301	The new ~:separator~ attribute splits a tag from a description list
	302	item into multiple parts. This allows to have two-column tables with
	303	multiple entries in the first column. See manual for more details.
	304
	305	**** ~latex-environment~ elements support ~caption~ keywords for LaTeX export
	306	*** ~org-edit-special~ can edit LaTeX environments
	307
	308	Using ~C-c '~ on a LaTeX environment opens a sub-editing buffer. By
	309	default, major mode in that buffer is ~latex-mode~, but it can be
	310	changed by configuring ~org-src-lang-modes~.
	311
	312	*** ~org-list-to-generic~ includes a new property: ~:ifmt~
	313
	314	~:ifmt~ is a function to be called on the body of each item. See
	315	~org-list-to-generic~ documentation for details.
	316
	317	*** New variable : ~org-bibtex-headline-format-function~
	318	This allow to use a different title than entry title.
	319
	320	*** ~org-attach~ supports attaching files from URLs
	321
	322	Using ~C-c C-a u~ prompts for a URL pointing to a file to be attached
	323	to the document.
	324
	325	*** New option for ~org-refile-use-outline-path~
	326	~org-refile-use-outline-path~ now supports the setting ~buffer-name~,
	327	which causes refile targets to be prefixed with the buffer’s
	328	name. This is particularly useful when used in conjunction with
	329	~uniquify.el~.
	330
	331	*** ~org-file-contents~ now allows the FILE argument to be a URL.
	332	This allows ~#+SETUPFILE:~ to accept a URL instead of a local file
	333	path. The URL contents are auto-downloaded and saved to a temporary
	334	cache ~org--file-cache~. A new optional argument ~NOCACHE~ is added
	335	to ~org-file-contents~.
	336
	337	*** ~org-mode-restart~ now resets the newly added ~org--file-cache~.
	338	Using ~C-c C-c~ on any keyword (like ~#+SETUPFILE~) will reset the
	339	that file cache.
	340
	341	*** New option : ~org-table-duration-hour-zero-padding~
	342	This variable allow computed durations in tables to be zero-padded.
	343
	344	*** New mode switch for table formulas : =U=
	345	This mode omits seconds in durations.
	346
	347	** Removed functions
	348
	349	*** Org Timeline
	350
	351	This feature has been removed. Use a custom agenda view, possibly
	352	narrowed to current buffer to achieve a similar functionality.
	353
	354	*** ~org-agenda-skip-entry-when-regexp-matches~ is obsolete
	355
	356	Use ~org-agenda-skip-if~ instead.
	357
	358	*** ~org-agenda-skip-subtree-when-regexp-matches~ is obsolete
	359
	360	Use ~org-agenda-skip-if~ instead.
	361
	362	*** ~org-agenda-skip-entry-when-regexp-matches-in-subtree~ is obsolete
	363
	364	Use ~org-agenda-skip-if~ instead.
	365
	366	*** ~org-minutes-to-clocksum-string~ is obsolete
	367
	368	Use ~org-duration-from-minutes~ instead.
	369
	370	*** ~org-hh:mm-string-to-minutes~ is obsolete
	371
	372	Use ~org-duration-to-minutes~ instead.
	373
	374	*** ~org-duration-string-to-minutes~ is obsolete
	375
	376	Use ~org-duration-to-minutes~ instead.
	377
	378	*** ~org-gnus-nnimap-cached-article-number~ is removed.
	379
	380	This function relied on ~nnimap-group-overview-filename~, which was
	381	removed from Gnus circa September 2010.
	382
	383	** Removed options
	384
	385	*** ~org-agenda-repeating-timestamp-show-all~ is removed.
	386
	387	For an equivalent to a ~nil~ value, set
	388	~org-agenda-show-future-repeats~ to nil and
	389	~org-agenda-prefer-last-repeat~ to ~t~.
	390
	391	*** ~org-gnus-nnimap-query-article-no-from-file~ is removed.
	392
	393	This variable has no effect, as it was relying on a function that was
	394	removed from Gnus circa September 2010.
	395
	396	*** ~org-usenet-links-prefer-google~ is obsolete.
	397
	398	Use ~org-gnus-prefer-web-links~ instead.
	399
	400	*** ~org-publish-sitemap-file-entry-format~ is deprecated
	401
	402	One can provide new ~:sitemap-format-entry~ property for a function
	403	equivalent to the removed format string.
	404
	405	*** ~org-enable-table-editor~ is removed.
	406
	407	Setting it to a ~nil~ value broke some other features (e.g., speed
	408	keys).
	409
	410	*** ~org-export-use-babel~ cannot be set to ~inline-only~
	411
	412	The variable is now a boolean.
	413
	414	*** ~org-texinfo-def-table-markup~ is obsolete
	415
	416	Use ~org-texinfo-table-default-markup~ instead.
	417
	418	** New functions
	419
	420	*** ~org-publish-find-property~
	421
	422	This function can be used as a tool to format entries in a site-map,
	423	in addition to ~org-publish-find-title~ and ~org-publish-find-date~.
	424
	425	*** ~org-list-to-org~
	426
	427	It is the reciprocal of ~org-list-to-lisp~, which see.
	428
	429	*** ~org-agenda-set-restriction-lock-from-agenda~
	430
	431	Call ~org-agenda-set-restriction-lock~ from the agenda.
	432
	433	** Miscellaneous
	434
	435	*** The Library of Babel now on Worg
	436
	437	The library-of-babel.org used to be accessible from the =doc/=
	438	directory, distributed with Org’s core. It is now accessible
	439	from the Worg community-driven documentation [[https://orgmode.org/worg/library-of-babel.html][here]].
	440
	441	If you want to contribute to it, please see [[https://orgmode.org/worg/org-contribute.html][how to contribute]].
	442
	443	*** Allow multiple columns view
	444
	445	Columns view is not limited to a single buffer anymore.
	446	*** Org Attach obeys ~dired-dwim-target~
	447
	448	When a Dired buffer is opened next to the Org document being edited,
	449	the prompt for file to attach can start in the Dired buffer's
	450	directory if `dired-dwim-target' in non-nil.
	451
	452	*** ~org-fill-paragraph~ can now fill a whole region
	453	*** More specific anniversary descriptions
	454
	455	Anniversary descriptions (used in the agenda view, for instance)
	456	include the point in time, when the anniversary appears. This is,
	457	in its most general form, just the date of the anniversary. Or
	458	more specific terms, like "today", "tomorrow" or "in n days" are
	459	used to describe the time span.
	460
	461	This feature allows to automatically change the description of an
	462	anniversary, depending on if it occurs in the next few days or
	463	far away in the future.
	464
	465	*** Computed dates in tables appear as inactive time stamps
	466
	467	*** Save point before opening a file with an unknown search option
	468
	469	When following a file link with a search option (e.g., =::#custom-id=)
	470	that doesn't exist in the target file, save position before raising an
	471	error. As a consequence, it is possible to jump back to the original
	472	document with ~org-mark-ring-goto~ (default binding =C-c &=).
	473
	474	*** ~org-get-heading~ accepts two more optional arguments
	475
	476	See docstring for details.
	477
	478	*** New option ~org-babel-uppercase-example-markers~
	479
	480	This variable is a ~defcustom~ and replaces the variable
	481	~org-babel-capitalize-example-region-markers~, which is a ~defvar~ and
	482	is now obsolete.
	483	*** =INCLUDE= keywords in commented trees are now ignored.
	484	*** Default value for ~org-texinfo-text-markup-alist~ changed.
	485
	486	Now ~=...=~ markup uses ~@samp{}~ instead of ~@verb{}~. You can use
	487	~@verb{}~ again by customizing the variable.
	488	*** Texinfo exports example blocks as ~@example~
	489	*** Texinfo exports inline src blocks as ~@code{}~
	490	*** Texinfo default table markup is ~@asis~
	491	It used to be ~@samp~ but ~@asis~ is neutral and, therefore, more
	492	suitable as a default value.
	493	*** Texinfo default process includes ~--no-split~ option
	494	*** New entities : ~\dollar~ and ~\USD~
	495	*** Support for date style URLs in =org-protocol://open-source=
	496	URLs like =https://cool-blog.com/2017/05/20/cool-post/= are
	497	covered by rewrite rules.
	498
	499	*** Add (C) =COMMENT= support to ~org-structure-template-alist~
	500
	501	* Version 9.0
	502
	503	** Incompatible changes
	504
	505	*** Emacs 23 support has been dropped
	506
	507	From now on, Org expects at least Emacs 24.3, although Emacs 24.4 or
	508	above is suggested.
	509
	510	*** XEmacs support has been dropped
	511
	512	Incomplete compatibility layer with XEmacs has been removed. If you
	513	want to take over maintenance of this compatibility, please contact
	514	our mailing list.
	515
	516	*** New syntax for export blocks
	517
	518	Export blocks are explicitly marked as such at the syntax level to
	519	disambiguate their parsing from special blocks. The new syntax is
	520
	521	#+BEGIN_SRC org
	522	,#+BEGIN_EXPORT backend
	523	...
	524	,#+END_EXPORT
	525	#+END_SRC
	526
	527	instead of
	528
	529	#+BEGIN_SRC org
	530	,#+BEGIN_backend
	531	...
	532	,#+END_backend
	533	#+END_SRC
	534
	535	As a consequence, =INCLUDE= keywords syntax is modified, e.g.,
	536
	537	#+BEGIN_SRC org
	538	,#+INCLUDE: "file.org" HTML
	539	#+END_SRC
	540
	541	becomes
	542
	543	#+BEGIN_SRC org
	544	,#+INCLUDE: "file.org" export html
	545	#+END_SRC
	546
	547	The following function repairs export blocks and =INCLUDE= keywords
	548	using previous syntax:
	549
	550	#+BEGIN_SRC emacs-lisp
	551	(defun org-repair-export-blocks ()
	552	"Repair export blocks and INCLUDE keywords in current buffer."
	553	(interactive)
	554	(when (eq major-mode 'org-mode)
	555	(let ((case-fold-search t)
	556	(back-end-re (regexp-opt
	557	'("HTML" "ASCII" "LATEX" "ODT" "MARKDOWN" "MD" "ORG"
	558	"MAN" "BEAMER" "TEXINFO" "GROFF" "KOMA-LETTER")
	559	t)))
	560	(org-with-wide-buffer
	561	(goto-char (point-min))
	562	(let ((block-re (concat "^[ \t]*#\\+BEGIN_" back-end-re)))
	563	(save-excursion
	564	(while (re-search-forward block-re nil t)
	565	(let ((element (save-match-data (org-element-at-point))))
	566	(when (eq (org-element-type element) 'special-block)
	567	(save-excursion
	568	(goto-char (org-element-property :end element))
	569	(save-match-data (search-backward "_"))
	570	(forward-char)
	571	(insert "EXPORT")
	572	(delete-region (point) (line-end-position)))
	573	(replace-match "EXPORT \\1" nil nil nil 1))))))
	574	(let ((include-re
	575	(format "^[ \t]#\\+INCLUDE: .?%s[ \t]*$" back-end-re)))
	576	(while (re-search-forward include-re nil t)
	577	(let ((element (save-match-data (org-element-at-point))))
	578	(when (and (eq (org-element-type element) 'keyword)
	579	(string= (org-element-property :key element) "INCLUDE"))
	580	(replace-match "EXPORT \\1" nil nil nil 1)))))))))
	581	#+END_SRC
	582
	583	Moreover, ~:export-block~ keyword used in ~org-export-define-backend~ and
	584	~org-export-define-derived-backend~ is no longer used and needs to be
	585	removed.
	586
	587	*** Footnotes
	588
	589	**** [1]-like constructs are not valid footnotes
	590
	591	Using =[1]= as a footnote was already discouraged in the manual, since
	592	it introduced too many false-positives in many Org documents. These
	593	constructs are now unsupported.
	594
	595	If you used =[N]= in some of your documents, consider turning them into
	596	=[fn:N]=.
	597
	598	**** /Org Footnote/ library doesn't handle non-Org buffers
	599
	600	Commands for footnotes in an Org document no longer try to do
	601	something in non-Org ones. If you need to have footnotes there,
	602	consider using the =footnote.el= library, shipped with Emacs.
	603
	604	In particular, ~org-footnote-tag-for-non-org-mode-files~ no longer
	605	exists.
	606
	607	*** ~org-file-apps~ no longer accepts S-expressions as commands
	608
	609	The variable now accepts functions of two arguments instead of plain
	610	S-expressions. Replacing an S-expression with an appropriate function
	611	is straightforward. For example
	612
	613	: ("pdf" . (foo))
	614
	615	becomes
	616
	617	: ("pdf" . (lambda (file link) (foo)))
	618
	619	*** The ~{{{modification-time}}}~ macro can get time via =vc=
	620
	621	The modification time will be determined via =vc.el= if the second
	622	argument is non-nil. See the manual for details.
	623
	624	*** Preparation and completion functions in publishing projects change signature
	625
	626	Preparation and completion functions are now called with an argument,
	627	which is the project property list. It used to be dynamically scoped
	628	through the ~project-plist~ variable.
	629
	630	*** Old Babel header properties are no longer supported
	631
	632	Using header arguments as property names is no longer possible. As
	633	such, the following
	634
	635	#+BEGIN_EXAMPLE
	636	,* Headline
	637	:PROPERTIES:
	638	:exports: code
	639	:var: a=1 b=2
	640	:var+: c=3
	641	:END:
	642	#+END_EXAMPLE
	643
	644	should be written instead
	645
	646	#+BEGIN_EXAMPLE
	647	,* Headline
	648	:PROPERTIES:
	649	:header-args: :exports code
	650	:header-args+: :var a=1 b=2
	651	:header-args+: :var c=3
	652	:END:
	653	#+END_EXAMPLE
	654
	655	Please note that, however, old properties were defined at the source
	656	block definition. Current ones are defined where the block is called.
	657
	658	** New features
	659
	660	*** ~org-eww~ has been moved into core
	661	*** New org-protocol key=value syntax
	662
	663	Org-protocol can now handle query-style parameters such as:
	664
	665	#+begin_example
	666	org-protocol://store-link?url=http:%2F%2Flocalhost%2Findex.html&title=The%20title
	667	org-protocol://capture?template=x&title=Hello&body=World&url=http:%2F%2Fexample.com
	668	#+end_example
	669
	670	Old-style links such as
	671	: org-protocol://store-link:/http:%2F%2Flocalhost%2Findex.html/The%20title
	672	continue to be supported.
	673
	674	If you have defined your own handler functions for
	675	~org-protocol-protocol-alist~, change them to accept either a property
	676	list (for new-style links) or a string (for old-style links). Use
	677	~org-protocol-parse-parameters~ to convert old-style links into property
	678	lists.
	679
	680	*** New Org linter library
	681
	682	~org-lint~ can check syntax and report common issues in Org documents.
	683
	684	*** New option ~date-tree-last~ for ~org-agenda-insert-diary-strategy~
	685
	686	When ~org-agenda-insert-diary-strategy~ is set to ~date-tree-last~, diary
	687	entries are added to last in the date tree.
	688
	689	*** New ~vbar~ entity
	690
	691	~\vbar~ or ~\vbar{}~ will be exported unconditionally as a =\|=,
	692	unlike to existing ~\vert~, which is expanded as ~\|~ when using
	693	a HTML derived export back-end.
	694
	695	*** Export
	696
	697	**** New =#+latex_compiler= keyword to set LaTeX compiler.
	698
	699	PDFLaTeX, XeLaTeX, and LuaLaTeX are supported. See the manual for
	700	details.
	701
	702	**** New option ~org-export-with-broken-links~
	703
	704	This option tells the export process how to behave when encountering
	705	a broken internal link. See its docstring for more information.
	706
	707	**** Attributes support in custom language environments for LaTeX export
	708
	709	Custom language environments for LaTeX export can now define the
	710	string to be inserted during export, using attributes to indicate the
	711	position of the elements. See variable ~org-latex-custom-lang-environments~
	712	for more details.
	713
	714	**** New Texinfo ~options~ attribute on special blocks
	715
	716	Using ~:options~ as a Texinfo attribute, it is possible to add
	717	information to custom environments. See manual for details.
	718
	719	**** New HTML ~id~ attributes on special, example and quote blocks
	720
	721	If the block has a =#+NAME:= attribute assigned, then the HTML element
	722	will have an ~id~ attribute with that name in the HTML export. This
	723	enables one to create links to these elements in other places, e.g.,
	724	~<a href="#name">text</a>~.
	725
	726	**** Listings with captions are now numbered in HTML export
	727
	728	The class associated to the numbering is "listing-number". If you
	729	don't want these blocks to be numbered, as it was the case until now,
	730	You may want to add ~.listing-number { display: none; }~ to the CSS
	731	used.
	732
	733	**** Line Numbering in SRC/EXAMPLE blocks support arbitrary start number
	734
	735	The ~-n~ option to ~SRC~ and ~EXAMPLE~ blocks can now take a numeric
	736	argument to specify the staring line number for the source or example
	737	block. The ~+n~ option can now take a numeric argument that will be
	738	added to the last line number from the previous block as the starting
	739	point for the SRC/EXAMPLE block.
	740
	741	#+BEGIN_SRC org
	742	,#+BEGIN_SRC emacs-lisp -n 20
	743	;; this will export with line number 20
	744	(message "This is line 21")
	745	,#+END_SRC
	746	,#+BEGIN_SRC emacs-lisp +n 10
	747	;; This will be listed as line 31
	748	(message "This is line 32")
	749	,#+END_SRC
	750	#+END_SRC
	751
	752	**** Allow toggling center for images in LaTeX export
	753
	754	With the global variable ~org-latex-images-centered~ or the local
	755	attribute ~:center~ it is now possible to center an image in LaTeX
	756	export.
	757
	758	**** Default CSS class ~org-svg~ for SVG images in HTML export
	759
	760	SVG images exported in HTML are now by default assigned a CSS class
	761	~org-svg~ if no CSS class is specified with the ~:class~ attribute. By
	762	default, the CSS styling of class ~org-svg~ specifies an image width of
	763	90\thinsp{}% of the container the image.
	764
	765	**** Markdown footnote export customization
	766
	767	Variables ~org-md-footnotes-section~ and ~org-md-footnote-format~
	768	introduced for =ox-md.el=. Both new variables define template strings
	769	which can be used to customize the format of the exported footnotes
	770	section and individual footnotes, respectively.
	771
	772	*** Babel
	773
	774	**** Blocks with coderefs labels can now be evaluated
	775
	776	The labels are removed prior to evaluating the block.
	777
	778	**** Support for Lua language
	779	**** Support for SLY in Lisp blocks
	780
	781	See ~org-babel-lisp-eval-fn~ to activate it.
	782
	783	**** Support for Stan language
	784
	785	New ob-stan.el library.
	786
	787	Evaluating a Stan block can produce two different results.
	788
	789	1. Dump the source code contents to a file.
	790
	791	This file can then be used as a variable in other blocks, which
	792	allows interfaces like RStan to use the model.
	793
	794	2. Compile the contents to a model file.
	795
	796	This provides access to the CmdStan interface. To use this, set
	797	~org-babel-stan-cmdstan-directory~ and provide a ~:file~ argument
	798	that does not end in ".stan".
	799
	800	For more information and usage examples, visit
	801	https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-stan.html
	802
	803	**** Support for Oracle databases via ~sqlplus~
	804
	805	=ob-sql= library supports running SQL blocks against an Oracle
	806	database using ~sqlplus~. Use with properties like this (all
	807	mandatory):
	808
	809	#+BEGIN_EXAMPLE
	810	:engine oracle
	811	:dbhost <host.com>
	812	:dbport <1521>
	813	:dbuser <username>
	814	:database <database>
	815	:dbpassword <secret>
	816	#+END_EXAMPLE
	817
	818	**** Improved support to Microsoft SQL Server via ~sqlcmd~
	819
	820	=ob-sql= library removes support to the ~msosql~ engine which uses the
	821	deprecated ~osql~ command line tool, and replaces it with ~mssql~
	822	engine which uses the ~sqlcmd~ command line tool. Use with properties
	823	like this:
	824
	825	#+BEGIN_EXAMPLE
	826	:engine mssql
	827	:dbhost <host.com>
	828	:dbuser <username>
	829	:dbpassword <secret>
	830	:database <database>
	831	#+END_EXAMPLE
	832
	833	If you want to use the trusted connection feature, omit both the
	834	=dbuser= and =dbpassword= properties and add =cmdline -E= to the properties.
	835
	836	If your Emacs is running in a Cygwin environment, the =ob-sql= library
	837	can pass the converted path to the =sqlcmd= tool.
	838
	839	**** Improved support of header arguments for postgresql
	840
	841	The postgresql engine in a sql code block supports now ~:dbport~ nd
	842	~:dbpassword~ as header arguments.
	843
	844	**** Support for additional plantuml output formats
	845
	846	The support for output formats of [[http://plantuml.com/][plantuml]] has been extended to now
	847	include:
	848
	849	All Diagrams:
	850	- png ::
	851	- svg ::
	852	- eps ::
	853	- pdf ::
	854	- vdx ::
	855	- txt :: ASCII art
	856	- utxt :: ASCII art using unicode characters
	857
	858	Class Diagrams:
	859	- xmi ::
	860	- html ::
	861
	862	State Diagrams:
	863	- scxml ::
	864
	865	The output formats are determined by the file extension specified
	866	using the :file property, e.g.:
	867
	868	#+begin_src plantuml :file diagram.png
	869	@startuml
	870	Alice -> Bob: Authentication Request
	871	Bob --> Alice: Authentication Response
	872
	873	Alice -> Bob: Another authentication Request
	874	Alice <-- Bob: another authentication Response
	875	@enduml
	876	#+end_src
	877
	878	Please note that pdf does not work out of the box and needs additional
	879	setup in addition to plantuml. See [[http://plantuml.com/pdf.html]] for
	880	details and setup information.
	881
	882	*** Rewrite of radio lists
	883
	884	Radio lists, i.e, Org plain lists in foreign buffers, have been
	885	rewritten to be on par with Radio tables. You can use a large set of
	886	parameters to control how a given list should be rendered. See manual
	887	for details.
	888
	889	*** org-bbdb-anniversaries-future
	890
	891	Used like ~org-bbdb-anniversaries~, it provides a few days warning for
	892	upcoming anniversaries (default: 7 days).
	893
	894	*** Clear non-repeated SCHEDULED upon repeating a task
	895
	896	If the task is repeated, and therefore done at least one, scheduling
	897	information is no longer relevant. It is therefore removed.
	898
	899	See [[git:481719fbd5751aaa9c672b762cb43aea8ee986b0][commit message]] for more information.
	900
	901	*** Support for ISO week trees
	902
	903	ISO week trees are an alternative date tree format that orders entries
	904	by ISO week and not by month.
	905
	906	For example:
	907
	908	: * 2015
	909	: ** 2015-W35
	910	: ** 2015-W36
	911	: *** 2015-08-31 Monday
	912
	913	They are supported in org-capture via ~file+weektree~ and
	914	~file+weektree+prompt~ target specifications.
	915
	916	*** Accept ~:indent~ parameter when capturing column view
	917
	918	When defining a "columnview" dynamic block, it is now possible to add
	919	an :indent parameter, much like the one in the clock table.
	920
	921	On the other hand, stars no longer appear in an ITEM field.
	922
	923	*** Columns view
	924
	925	**** ~org-columns~ accepts a prefix argument
	926
	927	When called with a prefix argument, ~org-columns~ apply to the whole
	928	buffer unconditionally.
	929
	930	**** New variable : ~org-agenda-view-columns-initially~
	931
	932	The variable used to be a ~defvar~, it is now a ~defcustom~.
	933
	934	**** Allow custom summaries
	935
	936	It is now possible to add new summary types, or override those
	937	provided by Org by customizing ~org-columns-summary-types~, which see.
	938
	939	**** Allow multiple summaries for any property
	940
	941	Columns can now summarize the same property using different summary
	942	types.
	943
	944	*** Preview LaTeX snippets in buffers not visiting files
	945	*** New option ~org-attach-commit~
	946
	947	When non-nil, commit attachments with git, assuming the document is in
	948	a git repository.
	949
	950	*** Allow conditional case-fold searches in ~org-occur~
	951
	952	When set to ~smart~, the new variable ~org-occur-case-fold-search~ allows
	953	to mimic =isearch.el=: if the regexp searched contains any upper case
	954	character (or character class), the search is case sensitive.
	955	Otherwise, it is case insensitive.
	956
	957	*** More robust repeated =ox-latex= footnote handling
	958
	959	Repeated footnotes are now numbered by referring to a label in the
	960	first footnote.
	961
	962	*** The ~org-block~ face is inherited by ~src-blocks~
	963
	964	This works also when =org-src-fontify-natively= is non-nil. It is also
	965	possible to specify per-languages faces. See =org-src-block-faces= and
	966	the manual for details.
	967
	968	*** Links are now customizable
	969
	970	Links can now have custom colors, tooltips, keymaps, display behavior,
	971	etc. Links are now centralized in ~org-link-parameters~.
	972
	973	** New functions
	974
	975	*** ~org-next-line-empty-p~
	976
	977	It replaces the deprecated ~next~ argument to ~org-previous-line-empty-p~.
	978
	979	*** ~org-show-children~
	980
	981	It is a faster implementation of ~outline-show-children~.
	982
	983	** Removed functions
	984
	985	*** ~org-agenda-filter-by-tag-refine~ has been removed.
	986
	987	Use ~org-agenda-filter-by-tag~ instead.
	988
	989	*** ~org-agenda-todayp~ is deprecated.
	990
	991	Use ~org-agenda-today-p~ instead.
	992
	993	*** ~org-babel-get-header~ is removed.
	994
	995	Use ~org-babel--get-vars~ or ~assq~ instead, as applicable.
	996
	997	*** ~org-babel-trim~ is deprecated.
	998
	999	Use ~org-trim~ instead.
	1000
	1001	*** ~org-element-remove-indentation~ is deprecated.
	1002
	1003	Use ~org-remove-indentation~ instead.
	1004
	1005	*** ~org-image-file-name-regexp~ is deprecated
	1006
	1007	Use ~image-file-name-regexp~ instead.
	1008	The never-used-in-core ~extensions~ argument has been dropped.
	1009
	1010	*** ~org-list-parse-list~ is deprecated
	1011
	1012	Use ~org-list-to-lisp~ instead.
	1013
	1014	*** ~org-on-heading-p~ is deprecated
	1015
	1016	A comment to this effect was in the source code since 7.8.03, but
	1017	now a byte-compiler warning will be generated as well.
	1018
	1019	*** ~org-table-p~ is deprecated
	1020
	1021	Use ~org-at-table-p~ instead.
	1022
	1023	*** ~org-table-recognize-table.el~ is deprecated
	1024
	1025	It was not called by any org code since 2010.
	1026
	1027	*** Various reimplementations of cl-lib functions are deprecated
	1028
	1029	The affected functions are:
	1030	- ~org-count~
	1031	- ~org-remove-if~
	1032	- ~org-remove-if-not~
	1033	- ~org-reduce~
	1034	- ~org-every~
	1035	- ~org-some~
	1036
	1037	Additionally, ~org-sublist~ is deprecated in favor of ~cl-subseq~. Note
	1038	the differences in indexing conventions: ~org-sublist~ is 1-based and
	1039	end-inclusive; ~cl-subseq~ is 0-based and end-exclusive.
	1040
	1041	** Removed options
	1042
	1043	*** Remove all options related to ~ido~ or ~iswitchb~
	1044
	1045	This includes ~org-completion-use-iswitchb~ and ~org-completion-use-ido~.
	1046	Instead Org uses regular functions, e.g., ~completion-read~ so as to
	1047	let those libraries operate.
	1048
	1049	*** Remove ~org-list-empty-line-terminates-plain-lists~
	1050
	1051	Two consecutive blank lines always terminate all levels of current
	1052	plain list.
	1053
	1054	*** ~fixltx2e~ is removed from ~org-latex-default-packages-alist~
	1055
	1056	fixltx2e is obsolete, see LaTeX News 22.
	1057
	1058	** Miscellaneous
	1059	*** Add Icelandic smart quotes
	1060	*** Allow multiple receiver locations in radio tables and lists
	1061	*** Allow angular links within link descriptions
	1062
	1063	It is now allowed to write, e.g.,
	1064	~[[http:orgmode.org][<file:unicorn.png>]]~ as an equivalent to
	1065	~[[http:orgmode.org][file:unicorn.png]]~. The advantage of the former
	1066	is that spaces are allowed within the path.
	1067
	1068	*** Beamer export back-ends uses ~org-latex-prefer-user-labels~
	1069	*** ~:preparation-function~ called earlier during publishing
	1070
	1071	Functions in this list are called before any file is associated to the
	1072	current project. Thus, they can be used to generate to be published
	1073	Org files.
	1074
	1075	*** Function ~org-remove-indentation~ changes.
	1076
	1077	The new algorithm doesn't remove TAB characters not used for
	1078	indentation.
	1079
	1080	*** Secure placeholders in capture templates
	1081
	1082	Placeholders in capture templates are no longer expanded recursively.
	1083	However, ~%(...)~ constructs are expanded very late, so you can fill
	1084	the contents of the S-exp with the replacement text of non-interactive
	1085	placeholders. As before, interactive ones are still expanded as the
	1086	very last step, so the previous statement doesn't apply to them.
	1087
	1088	Note that only ~%(...)~ placeholders initially present in the
	1089	template, or introduced using a file placeholder, i.e., ~%[...]~ are
	1090	expanded. This prevents evaluating potentially malicious code when
	1091	another placeholder, e.g., ~%i~ expands to a S-exp.
	1092
	1093	*** Links stored by ~org-gnus-store-link~ in nnir groups
	1094
	1095	Since gnus nnir groups are temporary, ~org-gnus-store-link~ now refers
	1096	to the article's original group.
	1097
	1098	*** ~org-babel-check-confirm-evaluate~ is now a function instead of a macro
	1099
	1100	The calling convention has changed.
	1101
	1102	*** HTML export table row customization changes
	1103
	1104	Variable ~org-html-table-row-tags~ has been split into
	1105	~org-html-table-row-open-tag~ and ~org-html-table-row-close-tag~.
	1106	Both new variables can be either a string or a function which will be
	1107	called with 6 parameters.
	1108
	1109	*** =ITEM= special property returns headline without stars
	1110	*** Rename ~org-insert-columns-dblock~ into ~org-columns-insert-dblock~
	1111
	1112	The previous name is, for the time being, kept as an obsolete alias.
	1113
	1114	*** ~org-trim~ can preserve leading indentation.
	1115
	1116	When setting a new optional argument to a non-nil value, ~org-trim~
	1117	preserves leading indentation while removing blank lines at the
	1118	beginning of the string. The behavior is identical for white space at
	1119	the end of the string.
	1120
	1121	*** Function ~org-info-export~ changes.
	1122
	1123	HTML links created from certain info links now point to =gnu.org= URL's rather
	1124	than just to local files. For example info links such as =info:emacs#List
	1125	Buffers= used to be converted to HTML links like this:
	1126
	1127	: <a href="emacs.html#List-Buffers">emacs#List Buffers</a>
	1128
	1129	where local file =emacs.html= is referenced.
	1130	For most folks this file does not exist.
	1131	Thus the new behavior is to generate this HTML link instead:
	1132
	1133	: <a href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#List-Buffers">emacs#List Buffers</a>
	1134
	1135	All emacs related info links are similarly translated plus few other
	1136	=gnu.org= manuals.
	1137
	1138	*** Repeaters with a ~++~ interval and a time can be shifted to later today
	1139
	1140	Previously, if a recurring task had a timestamp of
	1141	~<2016-01-01 Fri 20:00 ++1d>~ and was completed on =2016-01-02= at
	1142	=08:00=, the task would skip =2016-01-02= and would be rescheduled for
	1143	=2016-01-03=. Timestamps with ~++~ cookies and a specific time will
	1144	now shift to the first possible future occurrence, even if the
	1145	occurrence is later the same day the task is completed. (Timestamps
	1146	already in the future are still shifted one time further into the
	1147	future.)
	1148
	1149	*** ~org-mobile-action-alist~ is now a defconst
	1150
	1151	It used to be a defcustom, with a warning that it shouldn't be
	1152	modified anyway.
	1153
	1154	*** ~file+emacs~ and ~file+sys~ link types are deprecated
	1155
	1156	They are still supported in Org 9.0 but will eventually be removed in
	1157	a later release. Use ~file~ link type along with universal arguments
	1158	to force opening it in either Emacs or with system application.
	1159
	1160	*** New defcustom ~org-babel-J-command~ stores the j command
	1161	*** New defalias ~org-babel-execute:j~
	1162
	1163	Allows J source blocks be indicated by letter j. Previously the
	1164	indication letter was solely J.
	1165
	1166	*** ~org-open-line~ ignores tables at the very beginning of the buffer
	1167
	1168	When ~org-special-ctrl-o~ is non-nil, it is impractical to create
	1169	a blank line above a table at the beginning of the document. Now, as
	1170	a special case, ~org-open-line~ behaves normally in this situation.
	1171
	1172	*** ~org-babel-hash-show-time~ is now customizable
	1173
	1174	The experimental variable used to be more or less confidential, as
	1175	a ~defvar~.
	1176
	1177	*** New ~:format~ property to parsed links
	1178
	1179	It defines the format of the original link. Possible values are:
	1180	~plain~, ~bracket~ and ~angle~.
	1181
	1182	* Version 8.3
	1183
	1184	** Incompatible changes
	1185
	1186	*** Properties drawers syntax changes
	1187
	1188	Properties drawers are now required to be located right after a
	1189	headline and its planning line, when applicable.
	1190
	1191	It will break some documents as TODO states changes were sometimes
	1192	logged before the property drawer.
	1193
	1194	The following function will repair them:
	1195
	1196	#+BEGIN_SRC emacs-lisp
	1197	(defun org-repair-property-drawers ()
	1198	"Fix properties drawers in current buffer.
	1199	Ignore non Org buffers."
	1200	(when (eq major-mode 'org-mode)
	1201	(org-with-wide-buffer
	1202	(goto-char (point-min))
	1203	(let ((case-fold-search t)
	1204	(inline-re (and (featurep 'org-inlinetask)
	1205	(concat (org-inlinetask-outline-regexp)
	1206	"END[ \t]*$"))))
	1207	(org-map-entries
	1208	(lambda ()
	1209	(unless (and inline-re (org-looking-at-p inline-re))
	1210	(save-excursion
	1211	(let ((end (save-excursion (outline-next-heading) (point))))
	1212	(forward-line)
	1213	(when (org-looking-at-p org-planning-line-re) (forward-line))
	1214	(when (and (< (point) end)
	1215	(not (org-looking-at-p org-property-drawer-re))
	1216	(save-excursion
	1217	(and (re-search-forward org-property-drawer-re end t)
	1218	(eq (org-element-type
	1219	(save-match-data (org-element-at-point)))
	1220	'drawer))))
	1221	(insert (delete-and-extract-region
	1222	(match-beginning 0)
	1223	(min (1+ (match-end 0)) end)))
	1224	(unless (bolp) (insert "\n"))))))))))))
	1225	#+END_SRC
	1226
	1227	*** Using "COMMENT" is now equivalent to commenting with "#"
	1228
	1229	If you used "COMMENT" in headlines to prevent a subtree from being
	1230	exported, you can still do it but all information within the subtree
	1231	is now commented out, i.e. no #+OPTIONS line will be parsed or taken
	1232	into account when exporting.
	1233
	1234	If you want to exclude a headline from export while using its contents
	1235	for setting options, use =:noexport:= (see =org-export-exclude-tags=.)
	1236
	1237	*** =#+CATEGORY= keywords no longer apply partially to document
	1238
	1239	It was possible to use several such keywords and have them apply to
	1240	the text below until the next one, but strongly deprecated since Org
	1241	5.14 (2008).
	1242
	1243	=#+CATEGORY= keywords are now global to the document. You can use node
	1244	properties to set category for a subtree, e.g.,
	1245
	1246	#+BEGIN_SRC org
	1247	,* Headline
	1248	:PROPERTIES:
	1249	:CATEGORY: some category
	1250	:END:
	1251	#+END_SRC
	1252
	1253	*** New variable to control visibility when revealing a location
	1254
	1255	~org-show-following-heading~, ~org-show-siblings~, ~org-show-entry-below~
	1256	and ~org-show-hierarchy-above~ no longer exist. Instead, visibility is
	1257	controlled through a single variable: ~org-show-context-detail~, which
	1258	see.
	1259
	1260	*** Replace disputed keys again when reading a date
	1261
	1262	~org-replace-disputed-keys~ has been ignored when reading date since
	1263	version 8.1, but the former behavior is restored again.
	1264
	1265	Keybinding for reading date can be customized with a new variable
	1266	~org-read-date-minibuffer-local-map~.
	1267
	1268	*** No default title is provided when =TITLE= keyword is missing
	1269
	1270	Skipping =TITLE= keyword no longer provides the current file name, or
	1271	buffer name, as the title. Instead, simply ignore the title.
	1272
	1273	*** Default bindings of =C-c C-n= and =C-c C-p= changed
	1274
	1275	The key sequences =C-c C-n= and =C-c C-p= are now bound to
	1276	~org-next-visible-heading~ and ~org-previous-visible-heading~
	1277	respectively, rather than the =outline-mode= versions of these
	1278	functions. The Org version of these functions skips over inline tasks
	1279	(and even-level headlines when ~org-odd-levels-only~ is set).
	1280
	1281	*** ~org-element-context~ no longer return objects in keywords
	1282
	1283	~org-element-context~ used to return objects on some keywords, i.e.,
	1284	=TITLE=, =DATE= and =AUTHOR=. It now returns only the keyword.
	1285
	1286	*** ~org-timer-default-timer~ type changed from number to string
	1287
	1288	If you have, in your configuration, something like =(setq
	1289	org-timer-default-timer 10)= replace it with =(setq
	1290	org-timer-default-timer "10")=.
	1291
	1292	*** Functions signature changes
	1293
	1294	The following functions require an additional argument. See their
	1295	docstring for more information.
	1296
	1297	- ~org-export-collect-footnote-definitions~
	1298	- ~org-html-format-headline-function~
	1299	- ~org-html-format-inlinetask-function~
	1300	- ~org-latex-format-headline-function~
	1301	- ~org-latex-format-inlinetask-function~
	1302	- ~org-link-search~
	1303
	1304	** New features
	1305
	1306	*** Default lexical evaluation of emacs-lisp src blocks
	1307
	1308	Emacs-lisp src blocks in babel are now evaluated using lexical
	1309	scoping. There is a new header to control this behavior.
	1310
	1311	The default results in an eval with lexical scoping.
	1312	:lexical yes
	1313
	1314	This turns lexical scoping off in the eval (the former behavior).
	1315	:lexical no
	1316
	1317	This uses the lexical environment with x=42 in the eval.
	1318	:lexical '((x . 42))
	1319
	1320	*** Behavior of ~org-return~ changed
	1321
	1322	If point is before or after the headline title, insert a new line
	1323	without changing the headline.
	1324
	1325	*** Hierarchies of tags
	1326
	1327	The functionality of nesting tags in hierarchies is added to org-mode.
	1328	This is the generalization of what was previously called "Tag groups"
	1329	in the manual. That term is now changed to "Tag hierarchy".
	1330
	1331	The following in-buffer definition:
	1332
	1333	#+BEGIN_SRC org
	1334	,#+TAGS: [ Group : SubOne SubTwo ]
	1335	,#+TAGS: [ SubOne : SubOne1 SubOne2 ]
	1336	,#+TAGS: [ SubTwo : SubTwo1 SubTwo2 ]
	1337	#+END_SRC
	1338
	1339	Should be seen as the following tree of tags:
	1340
	1341	- Group
	1342	- SubOne
	1343	- SubOne1
	1344	- SubOne2
	1345	- SubTwo
	1346	- SubTwo1
	1347	- SubTwo2
	1348
	1349	Searching for "Group" should return all tags defined above. Filtering
	1350	on SubOne filters also it's sub-tags. Etc.
	1351
	1352	There is no limit on the depth for the tag hierarchy.
	1353
	1354	*** Additional syntax for non-unique grouptags
	1355
	1356	Additional syntax is defined for grouptags if the tags in the group
	1357	don't have to be distinct on a heading.
	1358
	1359	Grouptags had to previously be defined with { }. This syntax is
	1360	already used for exclusive tags and Grouptags need their own,
	1361	non-exclusive syntax. This behavior is achieved with [ ]. Note: { }
	1362	can still be used also for Grouptags but then only one of the given
	1363	tags can be used on the headline at the same time. Example:
	1364
	1365	[ group : sub1 sub2 ]
	1366
	1367	#+BEGIN_SRC org
	1368	,* Test :sub1:sub2:
	1369	#+END_SRC
	1370
	1371	This is a more general case than the already existing syntax for
	1372	grouptags; { }.
	1373
	1374	*** Define regular expression patterns as tags
	1375
	1376	Tags can be defined as grouptags with regular expressions as
	1377	"sub-tags".
	1378
	1379	The regular expressions in the group must be marked up within { }.
	1380	Example use:
	1381
	1382	: #+TAGS: [ Project : {P@.+} ]
	1383
	1384	Searching for the tag Project will now list all tags also including
	1385	regular expression matches for P@.+. This is good for example for
	1386	projects tagged with a common identifier, i.e. P@2014_OrgTags.
	1387
	1388	*** Filtering in the agenda on grouptags (Tag hierarchies)
	1389
	1390	Filtering in the agenda on grouptags filters all of the related tags.
	1391	Except if a filter is applied with a (double) prefix-argument.
	1392
	1393	Filtering in the agenda on subcategories does not filter the "above"
	1394	levels anymore.
	1395
	1396	If a grouptag contains a regular expression the regular expression
	1397	is also used as a filter.
	1398
	1399	*** Minor refactoring of ~org-agenda-filter-by-tag~
	1400
	1401	Now uses the argument ARG and optional argument exclude instead of
	1402	strip and narrow. ARG because the argument has multiple purposes and
	1403	makes more sense than strip now. The term "narrowing" is changed to
	1404	exclude.
	1405
	1406	The main purpose is for the function to make more logical sense when
	1407	filtering on tags now when tags can be structured in hierarchies.
	1408
	1409	*** Babel: support for sed scripts
	1410
	1411	Thanks to Bjarte Johansen for this feature.
	1412
	1413	*** Babel: support for Processing language
	1414
	1415	New ob-processing.el library.
	1416
	1417	This library implements necessary functions for implementing editing
	1418	of Processing code blocks, viewing the resulting sketches in an
	1419	external viewer, and HTML export of the sketches.
	1420
	1421	Check the documentation for more details.
	1422
	1423	Thanks to Jarmo Hurri for this feature.
	1424
	1425	*** New behavior for ~org-toggle-latex-fragment~
	1426
	1427	The new behavior is the following:
	1428
	1429	- With a double prefix argument or with a single prefix argument when
	1430	point is before the first headline, toggle overlays in the whole
	1431	buffer;
	1432
	1433	- With a single prefix argument, toggle overlays in the current
	1434	subtree;
	1435
	1436	- On latex code, toggle overlay at point;
	1437
	1438	- Otherwise, toggle overlays in the current section.
	1439
	1440	*** Additional markup with =#+INCLUDE= keyword
	1441
	1442	The content of the included file can now be optionally marked up, for
	1443	instance as HTML. See the documentation for details.
	1444
	1445	*** File links with =#+INCLUDE= keyword
	1446
	1447	Objects can be extracted via =#+INCLUDE= using file links. It is
	1448	possible to include only the contents of the object. See manual for
	1449	more information.
	1450
	1451	*** Drawers do not need anymore to be referenced in =#+DRAWERS=
	1452
	1453	One can use a drawer without listing it in the =#+DRAWERS= keyword,
	1454	which is now obsolete. As a consequence, this change also deprecates
	1455	~org-drawers~ variable.
	1456
	1457	*** ~org-edit-special~ can edit export blocks
	1458
	1459	Using C-c ' on an export block now opens a sub-editing buffer. Major
	1460	mode in that buffer is determined by export backend name (e.g.,
	1461	"latex" \to "latex-mode"). You can define exceptions to this rule by
	1462	configuring ~org-src-lang-modes~, which see.
	1463
	1464	*** Additional =:hline= processing to ob-shell
	1465
	1466	If the argument =:hlines yes= is present in a babel call, an optional
	1467	argument =:hlines-string= can be used to define a string to use as a
	1468	representation for the lisp symbol ='hline= in the shell program. The
	1469	default is =hline=.
	1470
	1471	*** Markdown export supports switches in source blocks
	1472
	1473	For example, it is now possible to number lines using the =-n= switch in
	1474	a source block.
	1475
	1476	*** New option in ASCII export
	1477
	1478	Plain lists can have an extra margin by setting ~org-ascii-list-margin~
	1479	variable to an appropriate integer.
	1480
	1481	*** New blocks in ASCII export
	1482
	1483	ASCII export now supports =#+BEGIN_JUSTIFYRIGHT= and =#+BEGIN_JUSTIFYLEFT=
	1484	blocks. See documentation for details.
	1485
	1486	*** More back-end specific publishing options
	1487
	1488	The number of publishing options specific to each back-end has been
	1489	increased. See manual for details.
	1490
	1491	*** Export inline source blocks
	1492
	1493	Inline source code was used to be removed upon exporting. They are
	1494	now handled as standard code blocks, i.e., the source code can appear
	1495	in the output, depending on the parameters.
	1496
	1497	*** Extend ~org-export-first-sibling-p~ and ~org-export-last-sibling-p~
	1498
	1499	These functions now support any element or object, not only headlines.
	1500
	1501	*** New function: ~org-export-table-row-in-header-p~
	1502
	1503	*** New function: ~org-export-get-reference~
	1504
	1505	*** New function: ~org-element-lineage~
	1506
	1507	This function deprecates ~org-export-get-genealogy~. It also provides
	1508	more features. See docstring for details.
	1509
	1510	*** New function: ~org-element-copy~
	1511
	1512	*** New filter: ~org-export-filter-body-functions~
	1513
	1514	Functions in this filter are applied on the body of the exported
	1515	document, before wrapping it within the template.
	1516
	1517	*** New :environment parameter when exporting example blocks to LaTeX
	1518
	1519	: #+ATTR_LATEX: :environment myverbatim
	1520	: #+BEGIN_EXAMPLE
	1521	: This sentence is false.
	1522	: #+END_EXAMPLE
	1523
	1524	will be exported using =@samp(myverbatim)= instead of =@samp(verbatim)=.
	1525
	1526	*** Various improvements on radio tables
	1527
	1528	Radio tables feature now relies on Org's export framework ("ox.el").
	1529	~:no-escape~ parameter no longer exists, but additional global
	1530	parameters are now supported: ~:raw~, ~:backend~. Moreover, there are new
	1531	parameters specific to some pre-defined translators, e.g.,
	1532	~:environment~ and ~:booktabs~ for ~orgtbl-to-latex~. See translators
	1533	docstrings (including ~orgtbl-to-generic~) for details.
	1534
	1535	*** Non-floating minted listings in Latex export
	1536
	1537	It is not possible to specify =#+attr_latex: :float nil= in conjunction
	1538	with source blocks exported by the minted package.
	1539
	1540	*** Field formulas can now create columns as needed
	1541
	1542	Previously, evaluating formulas that referenced out-of-bounds columns
	1543	would throw an error. A new variable ~org-table-formula-create-columns~
	1544	was added to adjust this behavior. It is now possible to silently add
	1545	new columns, to do so with a warning or to explicitly ask the user
	1546	each time.
	1547
	1548	*** ASCII plot
	1549
	1550	Ability to plot values in a column through ASCII-art bars. See manual
	1551	for details.
	1552
	1553	*** New hook: ~org-archive-hook~
	1554
	1555	This hook is called after successfully archiving a subtree, with point
	1556	on the original subtree, not yet deleted.
	1557
	1558	*** New option: ~org-attach-archive-delete~
	1559
	1560	When non-nil, attachments from archived subtrees are removed.
	1561
	1562	*** New option: ~org-latex-caption-above~
	1563
	1564	This variable generalizes ~org-latex-table-caption-above~, which is now
	1565	deprecated. In addition to tables, it applies to source blocks,
	1566	special blocks and images. See docstring for more information.
	1567
	1568	*** New option: ~org-latex-prefer-user-labels~
	1569
	1570	See the docstring for more information.
	1571
	1572	*** Export unnumbered headlines
	1573
	1574	Headlines, for which the property ~UNNUMBERED~ is non-nil, are now
	1575	exported without section numbers irrespective of their levels. The
	1576	property is inherited by children.
	1577
	1578	*** Tables can be sorted with an arbitrary function
	1579
	1580	It is now possible to specify a function, both programmatically,
	1581	through a new optional argument, and interactively with ~f~ or ~F~ keys,
	1582	to sort a table.
	1583
	1584	*** Table of contents can be local to a section
	1585
	1586	The ~TOC~ keywords now accepts an optional ~local~ parameter. See manual
	1587	for details.
	1588
	1589	*** Countdown timers can now be paused
	1590
	1591	~org-timer-pause-time~ now pauses and restarts both relative and
	1592	countdown timers.
	1593
	1594	*** New option ~only-window~ for ~org-agenda-window-setup~
	1595
	1596	When ~org-agenda-window-setup~ is set to ~only-window~, the agenda is
	1597	displayed as the sole window of the current frame.
	1598
	1599	*** ~{{{date}}}~ macro supports optional formatting argument
	1600
	1601	It is now possible to supply and optional formatting argument to
	1602	~{{{date}}}~. See manual for details.
	1603
	1604	*** ~{{{property}}}~ macro supports optional search argument
	1605
	1606	It is now possible to supply an optional search option to
	1607	~{{{property}}}~ in order to retrieve remote properties optional. See
	1608	manual for details.
	1609
	1610	*** New option ~org-export-with-title~
	1611
	1612	It is possible to suppress the title insertion with ~#+OPTIONS:
	1613	title:nil~ or globally using the variable ~org-export-with-title~.
	1614
	1615	*** New entities family: "\_ "
	1616
	1617	"\_ " are used to insert up to 20 contiguous spaces in various
	1618	back-ends. In particular, this family can be used to introduce
	1619	leading spaces within table cells.
	1620
	1621	*** New MathJax configuration options
	1622
	1623	Org uses the MathJax CDN by default. See the manual and the docstring
	1624	of ~org-html-mathjax-options~ for details.
	1625
	1626	*** New behavior in `org-export-options-alist'
	1627
	1628	When defining a back-end, it is now possible to specify to give
	1629	`parse' behavior on a keyword. It is equivalent to call
	1630	`org-element-parse-secondary-string' on the value.
	1631
	1632	However, parsed =KEYWORD= is automatically associated to an
	1633	=:EXPORT_KEYWORD:= property, which can be used to override the keyword
	1634	value during a subtree export. Moreover, macros are expanded in such
	1635	keywords and properties.
	1636
	1637	*** Viewport support in html export
	1638
	1639	Viewport for mobile-optimized website is now automatically inserted
	1640	when exporting to html. See ~org-html-viewport~ for details.
	1641
	1642	*** New ~#+SUBTITLE~ export keyword
	1643
	1644	Org can typeset a subtitle in some export backends. See the manual
	1645	for details.
	1646
	1647	*** Remotely edit a footnote definition
	1648
	1649	Calling ~org-edit-footnote-reference~ (C-c ') on a footnote reference
	1650	allows to edit its definition, as long as it is not anonymous, in a
	1651	dedicated buffer. It works even if buffer is currently narrowed.
	1652
	1653	*** New function ~org-delete-indentation~ bound to ~M-^~
	1654
	1655	Work as ~delete-indentation~ unless at heading, in which case text is
	1656	added to headline text.
	1657
	1658	*** Support for images in Texinfo export
	1659
	1660	~Texinfo~ back-end now handles images. See the manual for details.
	1661
	1662	*** Support for captions in Texinfo export
	1663
	1664	Tables and source blocks can now have captions. Additionally, lists
	1665	of tables and lists of listings can be inserted in the document with
	1666	=#+TOC= keyword.
	1667
	1668	*** Countdown timer support hh:mm:ss format
	1669
	1670	In addition to setting countdown timers in minutes, they can also be
	1671	set using the hh:mm:ss format.
	1672
	1673	*** Extend ~org-clone-subtree-with-time-shift~
	1674
	1675	~org-clone-subtree-with-time-shift~ now accepts 0 as an argument for the
	1676	number of clones, which removes the repeater from the original subtree
	1677	and creates one shifted, repeating clone.
	1678
	1679	*** New time block for clock tables: ~untilnow~
	1680
	1681	It encompasses all past closed clocks.
	1682
	1683	*** Support for the ~polyglossia~ LaTeX package
	1684
	1685	See the docstring of ~org-latex-classes~ and
	1686	~org-latex-guess-polyglossia-language~ for details.
	1687
	1688	*** None-floating tables, graphics and blocks can have captions
	1689
	1690	*** `org-insert-heading' can be forced to insert top-level headline
	1691
	1692	** Removed functions
	1693
	1694	*** Removed function ~org-translate-time~
	1695
	1696	Use ~org-timestamp-translate~ instead.
	1697
	1698	*** Removed function ~org-beamer-insert-options-template~
	1699
	1700	This function inserted a Beamer specific template at point or in
	1701	current subtree. Use ~org-export-insert-default-template~ instead, as
	1702	it provides more features and covers all export back-ends. It is also
	1703	accessible from the export dispatcher.
	1704
	1705	*** Removed function ~org-timer-cancel-timer~
	1706
	1707	~org-timer-stop~ now stops both relative and countdown timers.
	1708
	1709	*** Removed function ~org-export-solidify-link-text~
	1710
	1711	This function, being non-bijective, introduced bug in internal
	1712	references. Use ~org-export-get-reference~ instead.
	1713
	1714	*** Removed function ~org-end-of-meta-data-and-drawers~
	1715
	1716	The function is superseded by ~org-end-of-meta-data~, called with an
	1717	optional argument.
	1718
	1719	*** Removed functions ~org-table-colgroup-line-p~, ~org-table-cookie-line-p~
	1720
	1721	These functions were left-over from pre 8.0 era. They are not correct
	1722	anymore. Since they are not needed, they have no replacement.
	1723
	1724	** Removed options
	1725
	1726	*** ~org-list-empty-line-terminates-plain-lists~ is deprecated
	1727
	1728	It will be kept in code base until next release, for backward
	1729	compatibility.
	1730
	1731	If you need to separate consecutive lists with blank lines, always use
	1732	two of them, as if this option was nil (default value).
	1733
	1734	*** ~org-export-with-creator~ is a boolean
	1735
	1736	Special ~comment~ value is no longer allowed. It is possible to use a
	1737	body filter to add comments about the creator at the end of the
	1738	document instead.
	1739
	1740	*** Removed option =org-html-use-unicode-chars=
	1741
	1742	Setting this to non-nil was problematic as it converted characters
	1743	everywhere in the buffer, possibly corrupting URLs.
	1744
	1745	*** Removed option =org-babel-sh-command=
	1746
	1747	This undocumented option defaulted to the value of =shell-file-name= at
	1748	the time of loading =ob-shell=. The new behavior is to use the value
	1749	of =shell-file-name= directly when the shell langage is =shell=. To chose
	1750	a different shell, either customize =shell-file-name= or bind this
	1751	variable locally.
	1752
	1753	*** Removed option =org-babel-sh-var-quote-fmt=
	1754
	1755	This undocumented option was supposed to provide different quoting
	1756	styles when changing the shell type. Changing the shell type can now
	1757	be done directly from the source block and the quoting style has to be
	1758	compatible across all shells, so a customization doesn't make sense
	1759	anymore. The chosen hard coded quoting style conforms to POSIX.
	1760
	1761	*** Removed option ~org-insert-labeled-timestamps-at-point~
	1762
	1763	Setting this option to anything else that the default value (nil)
	1764	would create invalid planning info. This dangerous option is now
	1765	removed.
	1766
	1767	*** Removed option ~org-koma-letter-use-title~
	1768
	1769	Use org-export-with-title instead. See also below.
	1770
	1771	*** Removed option ~org-entities-ascii-explanatory~
	1772
	1773	This variable has no effect since Org 8.0.
	1774
	1775	*** Removed option ~org-table-error-on-row-ref-crossing-hline~
	1776
	1777	This variable has no effect since August 2009.
	1778
	1779	*** Removed MathML-related options from ~org-html-mathjax-options~
	1780
	1781	MathJax automatically chooses the best display technology based on the
	1782	end-users browser. You may force initial usage of MathML via
	1783	~org-html-mathjax-template~ or by setting the ~path~ property of
	1784	~org-html-mathjax-options~.
	1785
	1786	*** Removed comment-related filters
	1787
	1788	~org-export-filter-comment-functions~ and
	1789	~org-export-filter-comment-block-functions~ variables do not exist
	1790	anymore.
	1791
	1792	** Miscellaneous
	1793
	1794	*** Strip all meta data from ITEM special property
	1795
	1796	ITEM special property does not contain TODO, priority or tags anymore.
	1797
	1798	*** File names in links accept are now compatible with URI syntax
	1799
	1800	Absolute file names can now start with =///= in addition to =/=. E.g.,
	1801	=[[file:///home/me/unicorn.jpg]]=.
	1802
	1803	*** Footnotes in included files are now local to the file
	1804
	1805	As a consequence, it is possible to include multiple Org files with
	1806	footnotes in a master document without being concerned about footnote
	1807	labels colliding.
	1808
	1809	*** Mailto links now use regular URI syntax
	1810
	1811	This change deprecates old Org syntax for mailto links:
	1812	=mailto:user@domain::Subject=.
	1813
	1814	*** =QUOTE= keywords do not exist anymore
	1815
	1816	=QUOTE= keywords have been deprecated since Org 8.2.
	1817
	1818	*** Select tests to perform with the build system
	1819
	1820	The build system has been enhanced to allow test selection with a
	1821	regular expression by defining =BTEST_RE= during the test invocation.
	1822	This is especially useful during bisection to find just when a
	1823	particular test failure was introduced.
	1824
	1825	*** Exact heading search for external links ignore spaces and cookies
	1826
	1827	Exact heading search for links now ignore spaces and cookies. This is
	1828	the case for links of the form ~file:projects.org::*task title~, as well
	1829	as links of the form ~file:projects.org::some words~ when
	1830	~org-link-search-must-match-exact-headline~ is not nil.
	1831
	1832	*** ~org-latex-hyperref-template~, ~org-latex-title-command~ formatting
	1833
	1834	New formatting keys are supported. See the respective docstrings.
	1835	Note, ~org-latex-hyperref-template~ has a new default value.
	1836
	1837	*** ~float, wasysym, marvosym~ are removed from ~org-latex-default-packages-alist~
	1838
	1839	If you require any of these package add them to your preamble via
	1840	~org-latex-packages-alist~. Org also uses default LaTeX ~\tolerance~ now.
	1841
	1842	*** When exporting, throw an error on unresolved id/fuzzy links and code refs
	1843
	1844	This helps spotting wrong links.
	1845
	1846	* Version 8.2
	1847
	1848	** Incompatible changes
	1849	*** =ob-sh.el= renamed to =ob-shell=
	1850	This may require two changes in user config.
	1851
	1852	1. In =org-babel-do-load-languages=, change =(sh . t)= to =(shell . t)=.
	1853	2. Edit =local.mk= files to change the value of =BTEST_OB_LANGUAGES=
	1854	to remove "sh" and include "shell".
	1855
	1856	*** Combine org-mac-message.el and org-mac-link-grabber into org-mac-link.el
	1857
	1858	Please remove calls to =(require 'org-mac-message)= and =(require
	1859	'org-mac-link-grabber)= in your =.emacs= initialization file. All you
	1860	need now is =(require 'org-mac-link)=.
	1861
	1862	Additionally, replace any calls to =ogml-grab-link= to
	1863	=org-mac-grab-link=. For example, replace this line:
	1864
	1865	: (define-key org-mode-map (kbd "C-c g") 'omgl-grab-link)
	1866
	1867	with this:
	1868
	1869	: (define-key org-mode-map (kbd "C-c g") 'org-mac-grab-link)
	1870
	1871	*** HTML export: Replace =HTML_HTML5_FANCY= by =:html-html5-fancy= (...)
	1872
	1873	Some of the HTML specific export options in Org <8.1 are either nil or
	1874	t, like =#+HTML_INCLUDE_STYLE=. We replaced these binary options with
	1875	option keywords like :html-include-style.
	1876
	1877	So you need to replace
	1878
	1879	: #+HTML_INCLUDE_STYLE: t
	1880
	1881	by
	1882
	1883	: #+OPTIONS: :html-include-style t
	1884
	1885	Options affected by this change: =HTML5_FANCY=, =HTML_INCLUDE_SCRIPTS=
	1886	and =HTML_INCLUDE_STYLE=.
	1887
	1888	*** Add an argument to ~org-export-to-file~ and ~org-export-to-buffer~
	1889
	1890	~org-export-to-file~ and ~org-export-to-file~ can run in a different
	1891	process when provided a non-nil =ASYNC= optional argument, without
	1892	relying on ~org-export-async-start~ macro.
	1893
	1894	Since =ASYNC= is the first of optional arguments, you have to shift
	1895	the other optional arguments accordingly.
	1896
	1897	*** Export back-ends are now structures
	1898
	1899	Export back-ends are now structures, and stored as such in the
	1900	communication channel during an export process. In other words, from
	1901	now on, ~(plist-get info :back-end)~ will return a structure instead
	1902	of a symbol.
	1903
	1904	Arguments in hooks and in filters are still symbols, though.
	1905
	1906	** Important bugfixes
	1907
	1908	*** [[doc:org-insert-heading][org-insert-heading]] has been rewritten and bugs are now fixed
	1909	*** The replacement of disputed keys is now turned of when reading a date
	1910
	1911	*** Match string for sparse trees can now contain a slash in a property value
	1912
	1913	You can now have searches like SOMEPROP="aaa/bbb". Until now,
	1914	this would break because the slash would be interpreted as the
	1915	separator starting a TOTO match string.
	1916	** New features
	1917
	1918	*** =C-c ^ x= will now sort checklist items by their checked status
	1919
	1920	See [[doc:org-sort-list][org-sort-list]]: hitting =C-c ^ x= will put checked items at the end
	1921	of the list.
	1922	*** Various LaTeX export enhancements
	1923
	1924	- Support SVG images
	1925	- Support for .pgf files
	1926	- LaTeX Babel blocks can now be exported as =.tikz= files
	1927	- Allow =latexmk= as an option for [[doc:org-latex-pdf-process][org-latex-pdf-process]]
	1928	- When using =\usepackage[AUTO]{babel}=, AUTO will automatically be
	1929	replaced with a value compatible with ~org-export-default-language~
	1930	or ~LANGUAGE~ keyword.
	1931	- The dependency on the =latexsym= LaTeX package has been removed, we
	1932	now use =amssymb= symbols by default instead.
	1933
	1934	*** New functions for paragraph motion
	1935
	1936	The commands =C-down= and =C-up= now invoke special commands
	1937	that use knowledge from the org-elements parser to move the cursor
	1938	in a paragraph-like way.
	1939
	1940	*** New entities in =org-entities.el=
	1941
	1942	Add support for ell, imath, jmath, varphi, varpi, aleph, gimel, beth,
	1943	dalet, cdots, S (§), dag, ddag, colon, therefore, because, triangleq,
	1944	leq, geq, lessgtr, lesseqgtr, ll, lll, gg, ggg, prec, preceq,
	1945	preccurlyeq, succ, succeq, succurlyeq, setminus, nexist(s), mho,
	1946	check, frown, diamond. Changes loz, vert, checkmark, smile and tilde.
	1947
	1948	*** Anonymous export back-ends
	1949
	1950	~org-export-create-backend~ can create anonymous export back-ends,
	1951	which can then be passed to export functions like
	1952	~org-export-to-file~, ~org-export-to-buffer~ or ~org-export-as~.
	1953
	1954	It allows for quick translation of Org syntax without the overhead of
	1955	registering a new back-end.
	1956
	1957	*** New agenda fortnight view
	1958
	1959	The agenda has not, in addition to day, week, month, and year
	1960	views, also a fortnight view covering 14 days.
	1961	** New options
	1962
	1963	*** New option [[doc:org-bookmark-names-plist][org-bookmark-names-plist]]
	1964
	1965	This allows to specify the names of automatic bookmarks.
	1966	*** New option [[doc:org-agenda-ignore-drawer-properties][org-agenda-ignore-drawer-properties]]
	1967
	1968	This allows more flexibility when optimizing the agenda generation.
	1969	See https://orgmode.org/worg/agenda-optimization.html for details.
	1970	*** New option: [[doc:org-html-link-use-abs-url][org-html-link-use-abs-url]] to force using absolute URLs
	1971
	1972	This is an export/publishing option, and should be used either within
	1973	the =#+OPTIONS= line(s) or within a [[doc:org-publish-project-alist][org-publish-project-alist]].
	1974
	1975	Setting this option to =t= is needed when the HTML output does not
	1976	allow relative URLs. For example, the =contrib/lisp/ox-rss.el=
	1977	library produces a RSS feed, and RSS feeds need to use absolute URLs,
	1978	so a combination of =:html-link-home "..." and :html-link-use-abs-url
	1979	t= is required---see the configuration example in the comment section
	1980	of =ox-rss.el=.
	1981
	1982	*** New option [[doc:org-babel-ditaa-java-cmd][org-babel-ditaa-java-cmd]]
	1983
	1984	This makes java executable configurable for ditaa blocks.
	1985
	1986	*** New options [[doc:org-babel-latex-htlatex][org-babel-latex-htlatex]] and [[doc:org-babel-latex-htlatex-packages][org-babel-latex-htlatex-packages]]
	1987
	1988	This enables SVG generation from latex code blocks.
	1989
	1990	*** New option: [[doc:org-habit-show-done-always-green][org-habit-show-done-always-green]]
	1991
	1992	See [[https://lists.gnu.org/r/emacs-orgmode/2013-05/msg00214.html][this message]] from Max Mikhanosha.
	1993
	1994	*** New option: [[doc:org-babel-inline-result-wrap][org-babel-inline-result-wrap]]
	1995
	1996	If you set this to the following
	1997
	1998	: (setq org-babel-inline-result-wrap "$%s$")
	1999
	2000	then inline code snippets will be wrapped into the formatting string.
	2001
	2002	*** New option: [[doc:org-special-ctrl-o][org-special-ctrl-o]]
	2003
	2004	This variable can be used to turn off the special behavior of
	2005	=C-o= in tables.
	2006	** New contributed packages
	2007
	2008	- =ox-bibtex.el= by Nicolas Goaziou :: an utility to handle BibTeX
	2009	export to both LaTeX and HTML exports. It uses the [[http://www.lri.fr/~filliatr/bibtex2html/][bibtex2html]]
	2010	software.
	2011
	2012	- =org-screenshot.el= by Max Mikhanosha :: an utility to handle
	2013	screenshots easily from Org, using the external tool [[http://freecode.com/projects/scrot][scrot]].
	2014
	2015	** Miscellaneous
	2016
	2017	*** "QUOTE" keywords in headlines are deprecated
	2018
	2019	"QUOTE" keywords are an undocumented feature in Org. When a headline
	2020	starts with the keyword "QUOTE", its contents are parsed as
	2021	a ~quote-section~ and treated as an example block. You can achieve
	2022	the same with example blocks.
	2023
	2024	This feature is deprecated and will be removed in the next Org
	2025	release.
	2026
	2027	* Version 8.0.1
	2028
	2029	** Installation
	2030
	2031	Installation instructions have been updated and simplified.
	2032
	2033	If you have troubles installing or updating Org, focus on these
	2034	instructions:
	2035
	2036	- when updating via a =.zip/.tar.gz= file, you only need to set the
	2037	=load-path= in your =.emacs=. Set it before any other Org
	2038	customization that would call autoloaded Org functions.
	2039
	2040	- when updating by pulling Org's Git repository, make sure to create the
	2041	correct autoloads. You can do this by running =~$ make autoloads= (to
	2042	only create the autoloads) or by running =~$ make= (to also compile
	2043	the Emacs lisp files.) =~$ make help= and =~$ make helpall= gives you
	2044	detailed explanations.
	2045
	2046	- when updating through ELPA (either from GNU ELPA or from Org ELPA),
	2047	you have to install Org's ELPA package in a session where no Org
	2048	function has been called already.
	2049
	2050	When in doubt, run =M-x org-version RET= and see if you have a mixed-up
	2051	installation.
	2052
	2053	See https://orgmode.org/org.html#Installation for details.
	2054
	2055	** Incompatible changes
	2056
	2057	Org 8.0 is the most disruptive major version of Org.
	2058
	2059	If you configured export options, you will have to update some of them.
	2060
	2061	If you used =#+ATTR_*= keywords, the syntax of the attributes changed and
	2062	you will have to update them.
	2063
	2064	Below is a list of changes for which you need to take action.
	2065
	2066	See https://orgmode.org/worg/org-8.0.html for the most recent version of
	2067	this list and for detailed instructions on how to migrate.
	2068
	2069	**** New export engine
	2070
	2071	Org 8.0 comes with a new export engine written by Nicolas Goaziou. This
	2072	export engine relies on ~org-element.el~ (Org's syntax parser), which was
	2073	already in Org's core. This new export engine triggered the rewriting of
	2074	/all/ export back-ends.
	2075
	2076	The most visible change is the export dispatcher, accessible through the
	2077	keybinding =C-c C-e=. By default, this menu only shows some of the
	2078	built-in export formats, but you can add more formats by loading them
	2079	directly (e.g., =(require 'ox-texinfo)= or by configuring the option
	2080	[[doc:org-export-backends][org-export-backends]].
	2081
	2082	More contributed back-ends are available from the =contrib/= directory, the
	2083	corresponding files start with the =ox-= prefix.
	2084
	2085	If you customized an export back-end (like HTML or LaTeX), you will need to
	2086	rename some options so that your customization is not lost. Typically, an
	2087	option starting with =org-export-html-= is now named =org-html-=. See the
	2088	manual for details and check [[https://orgmode.org/worg/org-8.0.html][this Worg page]] for directions.
	2089
	2090	**** New syntax for #+ATTR_HTML/LaTeX/... options
	2091
	2092	: #+ATTR_HTML width="200px"
	2093
	2094	should now be written
	2095
	2096	: #+ATTR_HTML :width 200px
	2097
	2098	Keywords like =#+ATTR_HTML= and =#+ATTR_LaTeX= are defined in their
	2099	respective back-ends, and the list of supported parameters depends on
	2100	each backend. See Org's manual for details.
	2101
	2102	**** ~org-remember.el~ has been removed
	2103
	2104	You cannot use =remember.el= anymore to capture notes.
	2105
	2106	Support for remember templates has been obsoleted since long, it is
	2107	now fully removed.
	2108
	2109	Use =M-x org-capture-import-remember-templates RET= to import your
	2110	remember templates into capture templates.
	2111
	2112	**** ~org-jsinfo.el~ has been merged into ~ox-html.el~
	2113
	2114	If you were requiring ~ox-jsinfo.el~ in your ~.emacs.el~ file, you
	2115	will have to remove this requirement from your initialization file.
	2116
	2117	**** Note for third-party developers
	2118
	2119	The name of the files for export back-end have changed: we now use the
	2120	prefix =ox-= for those files (like we use the =ob-= prefix for Babel
	2121	files.) For example ~org-html.el~ is now ~ox-html.el~.
	2122
	2123	If your code relies on these files, please update the names in your
	2124	code.
	2125
	2126	**** Packages moved from core to contrib
	2127
	2128	Since packages in Org's core are meant to be part of GNU Emacs, we try
	2129	to be minimalist when it comes to adding files into core. For 8.0, we
	2130	moved some contributions into the =contrib/= directory.
	2131
	2132	The rationale for deciding that these files should live in =contrib/=
	2133	is either because they rely on third-party software that is not
	2134	included in Emacs, or because they are not targeting a significant
	2135	user-base.
	2136
	2137	- org-colview-xemacs.el
	2138	- org-mac-message.el
	2139	- org-mew.el
	2140	- org-wl.el
	2141	- ox-freedmind.el
	2142	- ox-taskjuggler.el
	2143
	2144	Note that ~ox-freedmind.el~ has been rewritten by Jambunathan,
	2145	~org-mew.el~ has been enhanced by Tokuya Kameshima and
	2146	~ox-taskjuggler.el~ by Nicolas Goaziou and others.
	2147
	2148	Also, the Taskjuggler exporter now uses TJ3 by default. John Hendy
	2149	wrote [[https://orgmode.org/worg/org-tutorials/org-taskjuggler3.html][a tutorial on Worg]] for the TJ3 export.
	2150
	2151	** New packages in core
	2152
	2153	*** ~ob-makefile.el~ by Eric Schulte and Thomas S. Dye
	2154
	2155	=ob-makefile.el= implements Org Babel support for Makefile tangling.
	2156
	2157	*** ~ox-man.el~ by Luis Anaya
	2158
	2159	=ox-man.el= allows you to export Org files to =man= pages.
	2160
	2161	*** ~ox-md.el~ by Nicolas Goaziou
	2162
	2163	=ox-md.el= allows you to export Org files to Markdown files, using the
	2164	vanilla [[http://daringfireball.net/projects/markdown/][Markdown syntax]].
	2165
	2166	*** ~ox-texinfo.el~ by Jonathan Leech-Pepin
	2167
	2168	=ox-texinfo.el= allows you to export Org files to [[https://www.gnu.org/software/texinfo/][Texinfo]] files.
	2169
	2170	** New packages in contrib
	2171
	2172	*** ~ob-julia.el~ by G. Jay Kerns
	2173
	2174	[[http://julialang.org/][Julia]] is a new programming language.
	2175
	2176	=ob-julia.el= provides Org Babel support for evaluating Julia source
	2177	code.
	2178
	2179	*** ~ob-mathomatic.el~ by Luis Anaya
	2180
	2181	[[http://www.mathomatic.org/][mathomatic]] a portable, command-line, educational CAS and calculator
	2182	software, written entirely in the C programming language.
	2183
	2184	~ob-mathomatic.el~ provides Org Babel support for evaluating mathomatic
	2185	entries.
	2186
	2187	*** ~ob-tcl.el~ by Luis Anaya
	2188
	2189	~ob-tcl.el~ provides Org Babel support for evaluating [[http://www.tcl.tk/][Tcl]] source code.
	2190
	2191	*** ~org-bullets.el~ by Evgeni Sabof
	2192
	2193	Display bullets instead of stars for headlines.
	2194
	2195	Also see [[https://orgmode.org/worg/org-faq.html#sec-8-12][this updated FAQ]] on how to display another character than "*"
	2196	for starting headlines.
	2197
	2198	*** ~org-favtable.el~ by Marc-Oliver Ihm
	2199
	2200	~org-favtable.el~ helps you to create and update a table of favorite
	2201	locations in org, keeping the most frequently visited lines right at
	2202	the top. This table is called "favtable". See the documentation on
	2203	[[https://orgmode.org/worg/org-contrib/org-favtable.html][Worg]].
	2204
	2205	*** ~ox-confluence.el~ by Sébastien Delafond
	2206
	2207	~ox-confluence.el~ lets you convert Org files to [[https://confluence.atlassian.com/display/DOC/Confluence%2BWiki%2BMarkup][Confluence Wiki]] files.
	2208
	2209	*** ~ox-deck.el~ and ~ox-s5.el~ by Rick Frankel
	2210
	2211	[[http://imakewebthings.com/deck.js/][deck.js]] is a javascript library for displaying HTML ages as
	2212	presentations. ~ox-deck.el~ exports Org files to HTML presentations
	2213	using =deck.js=.
	2214
	2215	[[http://meyerweb.com/eric/tools/s5/][s5]] is a set of scripts which also allows to display HTML pages as
	2216	presentations. ~ox-s5.el~ exports Org files to HTML presentations
	2217	using =s5=.
	2218
	2219	*** ~ox-groff.el~ by Luis Anaya and Nicolas Goaziou
	2220
	2221	The [[https://www.gnu.org/software/groff/][groff]] (GNU troff) software is a typesetting package which reads
	2222	plain text mixed with formatting commands and produces formatted
	2223	output.
	2224
	2225	Luis Anaya and Nicolas Goaziou implemented ~ox-groff.el~ to allow
	2226	conversion from Org files to groff.
	2227
	2228	*** ~ox-koma-letter.el~ by Nicolas Goaziou and Alan Schmitt
	2229
	2230	This back-end allow to export Org pages to the =KOMA Scrlttr2= format.
	2231
	2232	*** ~ox-rss.el~ by Bastien
	2233
	2234	This back-end lets you export Org pages to RSS 2.0 feeds. Combined
	2235	with the HTML publishing feature, this allows you to build a blog
	2236	entirely with Org.
	2237
	2238	** New features
	2239
	2240	*** Export
	2241
	2242	**** New export generic options
	2243
	2244	If you use Org exporter, we advise you to re-read [[https://orgmode.org/org.html#Exporting][the manual section about
	2245	it]]. It has been updated and includes new options.
	2246
	2247	Among the new/updated export options, three are of particular importance:
	2248
	2249	- [[doc:org-export-allow-bind-keywords][org-export-allow-bind-keywords]] :: This option replaces the old option
	2250	=org-export-allow-BIND= and the default value is =nil=, not =confirm=.
	2251	You will need to explicitly set this to =t= in your initialization
	2252	file if you want to allow =#+BIND= keywords.
	2253
	2254	- [[doc:org-export-with-planning][org-export-with-planning]] :: This new option controls the export of
	2255	=SCHEDULED:, DEADLINE:, CLOSED:= lines, and planning information is
	2256	now skipped by default during export. This use to be the job of
	2257	[[doc:org-export-with-timestamps][org-export-with-timestamps]], but this latter option has been given a
	2258	new role: it controls the export of /standalone time-stamps/. When
	2259	set to =nil=, Org will not export active and inactive time-stamps
	2260	standing on a line by themselves or within a paragraph that only
	2261	contains time-stamps.
	2262
	2263	To check if an option has been introduced or its default value changed in
	2264	Org 8.0, do =C-h v [option] RET= and check if the documentation says that
	2265	the variable has been introduced (or changed) in version 24.4 of Emacs.
	2266
	2267	**** Enhanced default stylesheet for the HTML exporter
	2268
	2269	See the new default value of [[doc:org-html-style-default][org-html-style-default]].
	2270
	2271	**** New tags, classes and ids for the HTML exporter
	2272
	2273	See the new default value of [[doc:org-html-divs][org-html-divs]].
	2274
	2275	**** Support for tikz pictures in LaTeX export
	2276	**** ~org-man.el~: New export function for "man" links
	2277	**** ~org-docview.el~: New export function for docview links
	2278	*** Structure editing
	2279
	2280	**** =C-u C-u M-RET= inserts a heading at the end of the parent subtree
	2281	**** Cycling to the =CONTENTS= view keeps inline tasks folded
	2282
	2283	[[doc:org-cycle-hook][org-cycle-hook]] as a new function [[doc:org-cycle-hide-inline-tasks][org-cycle-hide-inline-tasks]] which
	2284	prevents the display of inline tasks when showing the content of a subtree.
	2285
	2286	**** =C-c -= in a region makes a list item for each line
	2287
	2288	This is the opposite of the previous behavior, where =C-c -= on a region
	2289	would create one item for the whole region, and where =C-u C-c -= would
	2290	create an item for each line. Now =C-c -= on the selected region creates
	2291	an item per line, and =C-u C-c -= creates a single item for the whole
	2292	region.
	2293
	2294	**** When transposing words, markup characters are now part of the words
	2295
	2296	In Emacs, you can transpose words with =M-t=. Transposing =these
	2297	_words__= will preserve markup.
	2298
	2299	**** New command [[doc:org-set-property-and-value][org-set-property-and-value]] bound to =C-c C-x P=
	2300
	2301	This command allows you to quickly add both the property and its value. It
	2302	is useful in buffers where there are many properties and where =C-c C-x p=
	2303	can slow down the flow of editing too much.
	2304
	2305	**** New commands [[doc:org-next-block][org-next-block]] and [[doc:org-previous-block][org-previous-block]]
	2306
	2307	These commands allow you to go to the previous block (=C-c M-b= or the
	2308	speedy key =B=) or to the next block (=C-c M-f= or the speedy key =F=.)
	2309
	2310	**** New commands [[doc:org-drag-line-forward][org-drag-line-forward]] and [[doc:org-drag-line-backward][org-drag-line-backward]]
	2311
	2312	These commands emulate the old behavior of =M-<down>= and =M-<up>= but are
	2313	now bound to =S-M-<down>= and =S-M-<up>= respectively, since =M-<down>= and
	2314	=M-<up>= now drag the whole element at point (a paragraph, a table, etc.)
	2315	forward and backward.
	2316
	2317	**** When a list item has a checkbox, inserting a new item uses a checkbox too
	2318	**** When sorting entries/items, only the description of links is considered
	2319
	2320	Now Org will sort this list
	2321
	2322	: - [[http://abc.org][B]]
	2323	: - [[http://def.org][A]]
	2324
	2325	like this:
	2326
	2327	: - [[http://def.org][A]]
	2328	: - [[http://abc.org][B]]
	2329
	2330	by comparing the descriptions, not the links.
	2331	Same when sorting headlines instead of list items.
	2332	**** New option =orgstruct-heading-prefix-regexp=
	2333
	2334	For example, setting this option to "^;;; " in Emacs lisp files and using
	2335	=orgstruct-mode= in those files will allow you to cycle through visibility
	2336	states as if lines starting with ";;; *..." where headlines.
	2337
	2338	In general, you want to set =orgstruct-heading-prefix-regexp= as a file
	2339	local variable.
	2340
	2341	**** New behavior of [[doc:org-clone-subtree-with-time-shift][org-clone-subtree-with-time-shift]]
	2342
	2343	The default is now to ask for a time-shift only when there is a time-stamp.
	2344	When called with a universal prefix argument =C-u=, it will not ask for a
	2345	time-shift even if there is a time-stamp.
	2346
	2347	**** New option [[doc:org-agenda-restriction-lock-highlight-subtree][org-agenda-restriction-lock-highlight-subtree]]
	2348
	2349	This defaults to =t= so that the whole subtree is highlighted when you
	2350	restrict the agenda view to it with =C-c C-x <= (or the speed command =<=).
	2351	The default setting helps ensuring that you are not adding tasks after the
	2352	restricted region. If you find this highlighting too intrusive, set this
	2353	option to =nil=.
	2354	**** New option [[doc:org-closed-keep-when-no-todo][org-closed-keep-when-no-todo]]
	2355
	2356	When switching back from a =DONE= keyword to a =TODO= keyword, Org now
	2357	removes the =CLOSED= planning information, if any. It also removes this
	2358	information when going back to a non-TODO state (e.g., with =C-c C-t SPC=).
	2359	If you want to keep the =CLOSED= planning information when removing the
	2360	TODO keyword, set [[doc:org-closed-keep-when-no-todo][org-closed-keep-when-no-todo]] to =t=.
	2361
	2362	**** New option [[doc:org-image-actual-width][org-image-actual-width]]
	2363
	2364	This option allows you to change the width of in-buffer displayed images.
	2365	The default is to use the actual width of the image, but you can use a
	2366	fixed value for all images, or fall back on an attribute like
	2367
	2368	: #+attr_html: :width 300px
	2369	*** Scheduled/deadline
	2370
	2371	**** Implement "delay" cookies for scheduled items
	2372
	2373	If you want to delay the display of a scheduled task in the agenda, you can
	2374	now use a delay cookie like this: =SCHEDULED: <2004-12-25 Sat -2d>=. The
	2375	task is still scheduled on the 25th but will appear in your agenda starting
	2376	from two days later (i.e. from March 27th.)
	2377
	2378	Imagine for example that your co-workers are not done in due time and tell
	2379	you "we need two more days". In that case, you may want to delay the
	2380	display of the task in your agenda by two days, but you still want the task
	2381	to appear as scheduled on March 25th.
	2382
	2383	In case the task contains a repeater, the delay is considered to affect all
	2384	occurrences; if you want the delay to only affect the first scheduled
	2385	occurrence of the task, use =--2d= instead. See [[doc:org-scheduled-delay-days][org-scheduled-delay-days]]
	2386	and [[doc:org-agenda-skip-scheduled-delay-if-deadline][org-agenda-skip-scheduled-delay-if-deadline]] for details on how to
	2387	control this globally or per agenda.
	2388
	2389	**** Use =C-u C-u C-c C-s= will insert a delay cookie for scheduled tasks
	2390
	2391	See the previous section for why delay cookies may be useful.
	2392
	2393	**** Use =C-u C-u C-c C-d= will insert a warning delay for deadline tasks
	2394
	2395	=C-u C-u C-c C-d= now inserts a warning delay to deadlines.
	2396	*** Calendar, diary and appts
	2397
	2398	**** New variable [[doc:org-read-date-minibuffer-local-map][org-read-date-minibuffer-local-map]]
	2399
	2400	By default, this new local map uses "." to go to today's date, like in the
	2401	normal =M-x calendar RET=. If you want to deactivate this and to reassign
	2402	the "@" key to =calendar-goto-today=, use this:
	2403
	2404	#+BEGIN_SRC emacs-lisp
	2405	;; Unbind "." in Org's calendar:
	2406	(define-key org-read-date-minibuffer-local-map (kbd ".") nil)
	2407
	2408	;; Bind "@" to `calendar-goto-today':
	2409	(define-key org-read-date-minibuffer-local-map
	2410	(kbd "@")
	2411	(lambda () (interactive) (org-eval-in-calendar '(calendar-goto-today))))
	2412	#+END_SRC
	2413
	2414	**** In Org's calendar, =!= displays diary entries of the date at point
	2415
	2416	This is useful when you want to check if you don't already have an
	2417	appointment when setting new ones with =C-c .= or =C-c s=. =!= will
	2418	call =diary-view-entries= and display the diary in a separate buffer.
	2419
	2420	**** [[doc:org-diary][org-diary]]: only keep the descriptions of links
	2421
	2422	[[doc:org-diary][org-diary]] returns diary information from Org files, but it returns it
	2423	in a diary buffer, not in an Org mode buffer. When links are displayed,
	2424	only show their description, not the full links.
	2425	*** Agenda
	2426
	2427	**** New agenda type =agenda= and entry types =:scheduled :deadline*=
	2428
	2429	When defining agenda custom commands, you can now use =agenda*=: this will
	2430	list entries that have both a date and a time. This is useful when you
	2431	want to build a list of appointments.
	2432
	2433	You can also set [[doc:org-agenda-entry-types][org-agenda-entry-types]] either globally or locally in
	2434	each agenda custom command and use =:timestamp= and/or =:deadline= there.
	2435
	2436	Another place where this is useful is your =.diary= file:
	2437
	2438	: %%(org-diary :scheduled*) ~/org/rdv.org
	2439
	2440	This will list only entries from =~/org/rdv.org= that are scheduled with a
	2441	time value (i.e. appointments).
	2442
	2443	**** New agenda sorting strategies
	2444
	2445	[[doc:org-agenda-sorting-strategy][org-agenda-sorting-strategy]] allows these new sorting strategies:
	2446
	2447	\| Strategy \| Explanations \|
	2448	\|----------------+------------------------------------------\|
	2449	\| timestamp-up \| Sort by any timestamp, early first \|
	2450	\| timestamp-down \| Sort by any timestamp, late first \|
	2451	\| scheduled-up \| Sort by scheduled timestamp, early first \|
	2452	\| scheduled-down \| Sort by scheduled timestamp, late first \|
	2453	\| deadline-up \| Sort by deadline timestamp, early first \|
	2454	\| deadline-down \| Sort by deadline timestamp, late first \|
	2455	\| ts-up \| Sort by active timestamp, early first \|
	2456	\| ts-down \| Sort by active timestamp, late first \|
	2457	\| tsia-up \| Sort by inactive timestamp, early first \|
	2458	\| tsia-down \| Sort by inactive timestamp, late first \|
	2459
	2460	**** New options to limit the number of agenda entries
	2461
	2462	You can now limit the number of entries in an agenda view. This is
	2463	different from filters: filters only /hide/ the entries in the agenda,
	2464	while limits are set while generating the list of agenda entries.
	2465
	2466	These new options are available:
	2467
	2468	- [[doc:org-agenda-max-entries][org-agenda-max-entries]] :: limit by number of entries.
	2469	- [[doc:org-agenda-max-todos][org-agenda-max-todos]] :: limit by number of TODOs.
	2470	- [[doc:org-agenda-max-tags][org-agenda-max-tags]] :: limit by number of tagged entries.
	2471	- [[doc:org-agenda-max-effort][org-agenda-max-effort]] :: limit by effort (minutes).
	2472
	2473	For example, if you locally set [[doc:org-agenda-max-todos][org-agenda-max-todos]] to 3 in an agenda
	2474	view, the agenda will be limited to the first three todos. Other entries
	2475	without a TODO keyword or beyond the third TODO headline will be ignored.
	2476
	2477	When setting a limit (e.g. about an effort's sum), the default behavior is
	2478	to exclude entries that cannot be checked against (e.g. entries that have
	2479	no effort property.) To include other entries too, you can set the limit
	2480	to a negative number. For example =(setq org-agenda-max-tags -3)= will not
	2481	show the fourth tagged headline (and beyond), but it will also show
	2482	non-tagged headlines.
	2483
	2484	**** =~= in agenda view sets temporary limits
	2485
	2486	You can hit =~= in the agenda to temporarily set limits: this will
	2487	regenerate the agenda as if the limits were set. This is useful for
	2488	example when you want to only see a list of =N= tasks, or a list of tasks
	2489	that take only =N= minutes.
	2490
	2491	**** "=" in agenda view filters by regular expressions
	2492
	2493	You can now filter agenda entries by regular expressions using ~=~. =C-u
	2494	== will filter entries out. Regexp filters are cumulative. You can set
	2495	[[doc:org-agenda-regexp-filter-preset][org-agenda-regexp-filter-preset]] to suit your needs in each agenda view.
	2496
	2497	**** =\|= in agenda view resets all filters
	2498
	2499	Since it's common to combine tag filters, category filters, and now regexp
	2500	filters, there is a new command =\|= to reset all filters at once.
	2501
	2502	**** Allow writing an agenda to an =.org= file
	2503
	2504	You can now write an agenda view to an =.org= file. It copies the
	2505	headlines and their content (but not subheadings) into the new file.
	2506
	2507	This is useful when you want to quickly share an agenda containing the full
	2508	list of notes.
	2509
	2510	**** New commands to drag an agenda line forward (=M-<down>=) or backward (=M-<up>=)
	2511
	2512	It sometimes handy to move agenda lines around, just to quickly reorganize
	2513	your tasks, or maybe before saving the agenda to a file. Now you can use
	2514	=M-<down>= and =M-<up>= to move the line forward or backward.
	2515
	2516	This does not persist after a refresh of the agenda, and this does not
	2517	change the =.org= files who contribute to the agenda.
	2518
	2519	**** Use =%b= for displaying "breadcrumbs" in the agenda view
	2520
	2521	[[doc:org-agenda-prefix-format][org-agenda-prefix-format]] now allows to use a =%b= formatter to tell Org
	2522	to display "breadcrumbs" in the agenda view.
	2523
	2524	This is useful when you want to display the task hierarchy in your agenda.
	2525
	2526	**** Use =%l= for displaying the headline's level in the agenda view
	2527
	2528	[[doc:org-agenda-prefix-format][org-agenda-prefix-format]] allows to use a =%l= formatter to tell Org to
	2529	display entries with additional spaces corresponding to their level in the
	2530	outline tree.
	2531
	2532	**** [[doc:org-agenda-write][org-agenda-write]] will ask before overwriting an existing file
	2533
	2534	=M-x org-agenda-write RET= (or =C-c C-w= from an agenda buffer) used to
	2535	overwrite preexisting file with the same name without confirmation. It now
	2536	asks for a confirmation.
	2537
	2538	**** New commands =M-m= and =M-*= to toggle (all) mark(s) for bulk action
	2539
	2540	- [[doc:org-agenda-bulk-toggle][org-agenda-bulk-toggle]] :: this command is bound to =M-m= and toggles
	2541	the mark of the entry at point.
	2542
	2543	- [[doc:org-agenda-bulk-toggle-all][org-agenda-bulk-toggle-all]] :: this command is bound to =M-*= and
	2544	toggles all the marks in the current agenda.
	2545
	2546	**** New option [[doc:org-agenda-search-view-max-outline-level][org-agenda-search-view-max-outline-level]]
	2547
	2548	This option sets the maximum outline level to display in search view.
	2549	E.g. when this is set to 1, the search view will only show headlines of
	2550	level 1.
	2551
	2552	**** New option [[doc:org-agenda-todo-ignore-time-comparison-use-seconds][org-agenda-todo-ignore-time-comparison-use-seconds]]
	2553
	2554	This allows to compare times using seconds instead of days when honoring
	2555	options like =org-agenda-todo-ignore-*= in the agenda display.
	2556
	2557	**** New option [[doc:org-agenda-entry-text-leaders][org-agenda-entry-text-leaders]]
	2558
	2559	This allows you to get rid of the ">" character that gets added in front of
	2560	entries excerpts when hitting =E= in the agenda view.
	2561
	2562	**** New formatting string for past deadlines in [[doc:org-agenda-deadline-leaders][org-agenda-deadline-leaders]]
	2563
	2564	The default formatting for past deadlines is ="%2d d. ago: "=, which makes
	2565	it explicit that the deadline is in the past. You can configure this via
	2566	[[doc:org-agenda-deadline-leaders][org-agenda-deadline-leaders]]. Note that the width of the formatting
	2567	string is important to keep the agenda alignment clean.
	2568
	2569	**** New allowed value =repeated-after-deadline= for [[doc:org-agenda-skip-scheduled-if-deadline-is-shown][org-agenda-skip-scheduled-if-deadline-is-shown]]
	2570
	2571	When [[doc:org-agenda-skip-scheduled-if-deadline-is-shown][org-agenda-skip-scheduled-if-deadline-is-shown]] is set to
	2572	=repeated-after-deadline=, the agenda will skip scheduled items if they are
	2573	repeated beyond the current deadline.
	2574
	2575	**** New option for [[doc:org-agenda-skip-deadline-prewarning-if-scheduled][org-agenda-skip-deadline-prewarning-if-scheduled]]
	2576
	2577	This variable may be set to nil, t, the symbol `pre-scheduled', or a number
	2578	which will then give the number of days before the actual deadline when the
	2579	prewarnings should resume. The symbol `pre-scheduled' eliminates the
	2580	deadline prewarning only prior to the scheduled date.
	2581
	2582	Read the full docstring for details.
	2583
	2584	**** [[doc:org-class][org-class]] now supports holiday strings in the skip-weeks parameter
	2585
	2586	For example, this task will now be skipped only on new year's day:
	2587
	2588	: * Task
	2589	: <%%(org-class 2012 1 1 2013 12 12 2 "New Year's Day")>
	2590	*** Capture
	2591
	2592	**** Allow =C-1= as a prefix for [[doc:org-agenda-capture][org-agenda-capture]] and [[doc:org-capture][org-capture]]
	2593
	2594	With a =C-1= prefix, the capture mechanism will use the =HH:MM= value at
	2595	point (if any) or the current =HH:MM= time as the default time for the
	2596	capture template.
	2597
	2598	**** Expand keywords within %(sexp) placeholder in capture templates
	2599
	2600	If you use a =%:keyword= construct within a =%(sexp)= construct, Org will
	2601	expand the keywords before expanding the =%(sexp)=.
	2602
	2603	**** Allow to contextualize capture (and agenda) commands by checking the name of the buffer
	2604
	2605	[[doc:org-capture-templates-contexts][org-capture-templates-contexts]] and [[doc:org-agenda-custom-commands-contexts][org-agenda-custom-commands-contexts]]
	2606	allow you to define what capture templates and what agenda commands should
	2607	be available in various contexts. It is now possible for the context to
	2608	check against the name of the buffer.
	2609	*** Tag groups
	2610
	2611	Using =#+TAGS: { Tag1 : Tag2 Tag3 }= will define =Tag1= as a /group tag/
	2612	(note the colon after =Tag1=). If you search for =Tag1=, it will return
	2613	headlines containing either =Tag1=, =Tag2= or =Tag3= (or any combination
	2614	of those tags.)
	2615
	2616	You can use group tags for sparse tree in an Org buffer, for creating
	2617	agenda views, and for filtering.
	2618
	2619	See https://orgmode.org/org.html#Tag-groups for details.
	2620
	2621	*** Links
	2622
	2623	**** =C-u C-u M-x org-store-link RET= will ignore non-core link functions
	2624
	2625	Org knows how to store links from Org buffers, from info files and from
	2626	other Emacs buffers. Org can be taught how to store links from any buffer
	2627	through new link protocols (see [[https://orgmode.org/org.html#Adding-hyperlink-types]["Adding hyperlink types"]] in the manual.)
	2628
	2629	Sometimes you want Org to ignore added link protocols and store the link
	2630	as if the protocol was not known.
	2631
	2632	You can now do this with =C-u C-u M-x org-store-link RET=.
	2633
	2634	**** =C-u C-u C-u M-x org-store-link RET= on an active region will store links for each lines
	2635
	2636	Imagine for example that you want to store a link for every message in a
	2637	Gnus summary buffer. In that case =C-x h C-u C-u C-u M-x org-store-link
	2638	RET= will store a link for every line (i.e. message) if the region is
	2639	active.
	2640
	2641	**** =C-c C-M-l= will add a default description for links which don't have one
	2642
	2643	=C-c C-M-l= inserts all stored links. If a link does not have a
	2644	description, this command now adds a default one, so that we are not mixing
	2645	with-description and without-description links when inserting them.
	2646
	2647	**** No curly braces to bracket links within internal links
	2648
	2649	When storing a link to a headline like
	2650
	2651	: * See [[https://orgmode.org][Org website]]
	2652
	2653	[[doc:org-store-link][org-store-link]] used to convert the square brackets into curly brackets.
	2654	It does not anymore, taking the link description or the link path, when
	2655	there is no description.
	2656	*** Table
	2657
	2658	**** Switching between #+TBLFM lines
	2659
	2660	If you have several =#+TBLFM= lines below a table, =C-c C-c= on a line will
	2661	apply the formulas from this line, and =C-c C-c= on another line will apply
	2662	those other formulas.
	2663
	2664	**** You now use "nan" for empty fields in Calc formulas
	2665
	2666	If empty fields are of interest, it is recommended to reread the section
	2667	[[https://orgmode.org/org.html#Formula-syntax-for-Calc][3.5.2 Formula syntax for Calc]] of the manual because the description for the
	2668	mode strings has been clarified and new examples have been added towards
	2669	the end.
	2670
	2671	**** Handle localized time-stamps in formulas evaluation
	2672
	2673	If your =LOCALE= is set so that Org time-stamps use another language than
	2674	english, and if you make time computations in Org's table, it now works by
	2675	internally converting the time-stamps with a temporary =LOCALE=C= before
	2676	doing computation.
	2677
	2678	**** New lookup functions
	2679
	2680	There are now three lookup functions:
	2681
	2682	- [[doc:org-loopup-first][org-loopup-first]]
	2683	- [[doc:org-loopup-last][org-loopup-last]]
	2684	- [[doc:org-loopup-all][org-loopup-all]]
	2685
	2686	See [[https://orgmode.org/org.html#Lookup-functions][the manual]] for details.
	2687	*** Startup keywords
	2688
	2689	These new startup keywords are now available:
	2690
	2691	\| Startup keyword \| Option \|
	2692	\|----------------------------------+---------------------------------------------\|
	2693	\| =#+STARTUP: logdrawer= \| =(setq org-log-into-drawer t)= \|
	2694	\| =#+STARTUP: nologdrawer= \| =(setq org-log-into-drawer nil)= \|
	2695	\|----------------------------------+---------------------------------------------\|
	2696	\| =#+STARTUP: logstatesreversed= \| =(setq org-log-states-order-reversed t)= \|
	2697	\| =#+STARTUP: nologstatesreversed= \| =(setq org-log-states-order-reversed nil)= \|
	2698	\|----------------------------------+---------------------------------------------\|
	2699	\| =#+STARTUP: latexpreview= \| =(setq org-startup-with-latex-preview t)= \|
	2700	\| =#+STARTUP: nolatexpreview= \| =(setq org-startup-with-latex-preview nil)= \|
	2701
	2702	*** Clocking
	2703
	2704	**** New option [[doc:org-clock-rounding-minutes][org-clock-rounding-minutes]]
	2705
	2706	E.g. if [[doc:org-clock-rounding-minutes][org-clock-rounding-minutes]] is set to 5, time is 14:47 and you
	2707	clock in: then the clock starts at 14:45. If you clock out within the next
	2708	5 minutes, the clock line will be removed; if you clock out 8 minutes after
	2709	your clocked in, the clock out time will be 14:50.
	2710
	2711	**** New option [[doc:org-time-clocksum-use-effort-durations][org-time-clocksum-use-effort-durations]]
	2712
	2713	When non-nil, =C-c C-x C-d= uses effort durations. E.g., by default, one
	2714	day is considered to be a 8 hours effort, so a task that has been clocked
	2715	for 16 hours will be displayed as during 2 days in the clock display or in
	2716	the clocktable.
	2717
	2718	See [[doc:org-effort-durations][org-effort-durations]] on how to set effort durations and
	2719	[[doc:org-time-clocksum-format][org-time-clocksum-format]] for more on time clock formats.
	2720
	2721	**** New option [[doc:org-clock-x11idle-program-name][org-clock-x11idle-program-name]]
	2722
	2723	This allows to set the name of the program which prints X11 idle time in
	2724	milliseconds. The default is to use =x11idle=.
	2725
	2726	**** New option [[doc:org-use-last-clock-out-time-as-effective-time][org-use-last-clock-out-time-as-effective-time]]
	2727
	2728	When non-nil, use the last clock out time for [[doc:org-todo][org-todo]]. Note that this
	2729	option has precedence over the combined use of [[doc:org-use-effective-time][org-use-effective-time]] and
	2730	[[doc:org-extend-today-until][org-extend-today-until]].
	2731
	2732	**** =S-<left/right>= on a clocksum column will update the sum by updating the last clock
	2733	**** =C-u 3 C-S-<up/down>= will update clock timestamps synchronously by 3 units
	2734	**** New parameter =:wstart= for clocktables to define the week start day
	2735	**** New parameter =:mstart= to state the starting day of the month
	2736	**** Allow relative times in clocktable tstart and tend options
	2737	**** The clocktable summary is now a caption
	2738	**** =:tstart= and =:tend= and friends allow relative times like "<-1w>" or "<now>"
	2739	*** Babel
	2740
	2741	**** You can now use =C-c C-k= for [[doc:org-edit-src-abort][org-edit-src-abort]]
	2742
	2743	This allows you to quickly cancel editing a source block.
	2744
	2745	**** =C-u C-u M-x org-babel-tangle RET= tangles by the target file of the block at point
	2746
	2747	This is handy if you want to tangle all source code blocks that have the
	2748	same target than the block at point.
	2749
	2750	**** New options for auto-saving the base buffer or the source block editing buffer
	2751
	2752	When [[doc:org-edit-src-turn-on-auto-save][org-edit-src-turn-on-auto-save]] is set to =t=, editing a source block
	2753	in a new window will turn on =auto-save-mode= and save the code in a new
	2754	file under the same directory than the base Org file.
	2755
	2756	When [[doc:org-edit-src-auto-save-idle-delay][org-edit-src-auto-save-idle-delay]] is set to a number of minutes =N=,
	2757	the base Org buffer will be saved after this number of minutes of idle
	2758	time.
	2759
	2760	**** New =:post= header argument post-processes results
	2761
	2762	This header argument may be used to pass the results of the current
	2763	code block through another code block for post-processing. See the
	2764	manual for a usage example.
	2765
	2766	**** Commented out heading are ignored when collecting blocks for tangling
	2767
	2768	If you comment out a heading (with =C-c ;= anywhere on the heading or in
	2769	the subtree), code blocks from within this heading are now ignored when
	2770	collecting blocks for tangling.
	2771
	2772	**** New option [[doc:org-babel-hash-show-time][org-babel-hash-show-time]] to show a time-stamp in the result hash
	2773	**** Do not ask for confirmation if cached value is current
	2774
	2775	Do not run [[doc:org-babel-confirm-evaluate][org-babel-confirm-evaluate]] if source block has a cache and the
	2776	cache value is current as there is no evaluation involved in this case.
	2777	**** =ob-sql.el= and =ob-python.el= have been improved.
	2778	**** New Babel files only need to =(require 'ob)=
	2779
	2780	When writing a new Babel file, you now only need to use =(require 'ob)=
	2781	instead of requiring each Babel library one by one.
	2782	*** Faces
	2783
	2784	- Org now fontifies radio link targets by default
	2785	- In the agenda, use [[doc:org-todo-keyword-faces][org-todo-keyword-faces]] to highlight selected TODO keywords
	2786	- New face [[doc:org-priority][org-priority]], enhanced fontification of priority cookies in agenda
	2787	- New face [[doc:org-tag-group][org-tag-group]] for group tags
	2788
	2789	** Miscellaneous
	2790
	2791	- New speedy key =s= pour [[doc:org-narrow-to-subtree][org-narrow-to-subtree]]
	2792	- Handling of [[doc:org-html-table-row][org-html-table-row]] has been updated (incompatible change)
	2793	- [[doc:org-export-html-table-tag][org-export-html-table-tag]] is replaced by [[doc:org-html-table-default-attributes][org-html-table-default-attributes]]
	2794	- Support using =git-annex= with Org attachments
	2795	- org-protocol: Pass optional value using query in url to capture from protocol
	2796	- When the refile history is empty, use the current filename as default
	2797	- When you cannot change the TODO state of a task, Org displays the blocking task
	2798	- New option [[doc:org-mobile-allpriorities][org-mobile-allpriorities]]
	2799	- org-bibtex.el now use =visual-line-mode= instead of the deprecated =longlines-mode=
	2800	- [[doc:org-format-latex-options][org-format-latex-options]] allows to set the foreground/background colors automatically
	2801	- New option [[doc:org-archive-file-header-format][org-archive-file-header-format]]
	2802	- New "neg" entity in [[doc:org-entities][org-entities]]
	2803	- New function [[doc:org-docview-export][org-docview-export]] to export docview links
	2804	- New =:eps= header argument for ditaa code blocks
	2805	- New option [[doc:org-gnus-no-server][org-gnus-no-server]] to start Gnus with =gnus-no-server=
	2806	- Org is now distributed with =htmlize.el= version 1.43
	2807	- ~org-drill.el~ has been updated to version 2.3.7
	2808	- ~org-mac-iCal.el~ now supports OS X versions up to 10.8
	2809	- Various improvements to ~org-contacts.el~ and =orgpan.el=
	2810
	2811	** Outside Org
	2812
	2813	*** Spanish translation of the Org guide by David Arroyo Menéndez
	2814
	2815	David (and others) translated the Org compact guide in spanish:
	2816
	2817	You can read the [[https://orgmode.org/worg/orgguide/orgguide.es.pdf][PDF guide]].
	2818
	2819	*** ~poporg.el~ and ~outorg.el~
	2820
	2821	Two new libraries (~poporg.el~ by François Pinard and ~outorg.el~ by
	2822	Thorsten Jolitz) now enable editing of comment-sections from source-code
	2823	buffers in temporary Org-mode buffers, making the full editing power of
	2824	Org-mode available. ~outorg.el~ comes together with ~outshine.el~ and
	2825	~navi-mode.el~, two more libraries by Thorsten Jolitz with the goal to give
	2826	source-code buffers the /look & feel/ of Org-mode buffers while greatly
	2827	improving navigation and structure editing. A detailed description can be
	2828	found here: https://orgmode.org/worg/org-tutorials/org-outside-org.html
	2829
	2830	Here are two screencasts demonstrating Thorsten's tools:
	2831
	2832	- [[http://youtu.be/nqE6YxlY0rw]["Modern conventions for Emacs Lisp files"]]
	2833	- [[http://www.youtube.com/watch?v%3DII-xYw5VGFM][Exploring Bernt Hansen's Org-mode tutorial with 'navi-mode']]
	2834
	2835	*** MobileOrg for iOS
	2836
	2837	MobileOrg for iOS back in the App Store The 1.6.0 release was focused on
	2838	the new Dropbox API and minor bug fixes but also includes a new ability to
	2839	launch in Capture mode. Track development and contribute [[https://github.com/MobileOrg/mobileorg/issues][on github]].
	2840
	2841	* Version 7.9.3
	2842
	2843	** New option [[doc::org-agenda-use-tag-inheritance][org-agenda-use-tag-inheritance]]
	2844
	2845	[[doc::org-use-tag-inheritance][org-use-tag-inheritance]] controls whether tags are inherited when
	2846	org-tags-view is called (either in =tags=, =tags-tree= or =tags-todo=
	2847	agenda views.)
	2848
	2849	When generating other agenda types such as =agenda=, =todo= and
	2850	=todo-tree=, tags inheritance is not used when selecting the entries
	2851	to display. Still, you might want to have all tag information correct
	2852	in the agenda buffer, e.g. for tag filtering. In that case, add the
	2853	agenda type to this variable.
	2854
	2855	Setting this variable to nil should considerably speeds up the agenda
	2856	generation.
	2857
	2858	Note that the default was to display inherited tags in the agenda
	2859	lines even if `org-use-tag-inheritance' was nil. The default is now
	2860	to never display inherited tags in agenda lines, but to /know/ about
	2861	them when the agenda type is listed in [[doc::org-agenda-use-tag-inheritance][org-agenda-use-tag-inheritance]].
	2862
	2863	** New default value nil for [[doc::org-agenda-dim-blocked-tasks][org-agenda-dim-blocked-tasks]]
	2864
	2865	Using `nil' as the default value speeds up the agenda generation. You
	2866	can hit `#' (or `C-u #') in agenda buffers to temporarily dim (or turn
	2867	invisible) blocked tasks.
	2868
	2869	** New speedy keys for [[doc::org-speed-commands-default][org-speed-commands-default]]
	2870
	2871	You can now use `:' (instead of `;') for setting tags---this is
	2872	consistent with using the `:' key in agenda view.
	2873
	2874	You can now use `=' for [[doc::org-columns][org-columns]].
	2875
	2876	** =org-float= is now obsolete, use =diary-float= instead
	2877	** No GPL manual anymore
	2878
	2879	There used to be a GPL version of the Org manual, but this is not the
	2880	case anymore, the Free Software Foundation does not permit this.
	2881
	2882	The GNU FDL license is now included in the manual directly.
	2883
	2884	** Enhanced compatibility with Emacs 22 and XEmacs
	2885
	2886	Thanks to Achim for his work on enhancing Org's compatibility with
	2887	various Emacsen. Things may not be perfect, but Org should work okay
	2888	in most environments.
	2889
	2890	* Version 7.9.2
	2891
	2892	** New ELPA repository for Org packages
	2893
	2894	You can now add the Org ELPA repository like this:
	2895
	2896	#+BEGIN_SRC emacs-lisp
	2897	(add-to-list 'package-archives '("org" . "https://orgmode.org/elpa/") t)
	2898	#+END_SRC
	2899
	2900	It contains both the =org-*.tar= package (the core Org distribution, also
	2901	available through https://elpa.gnu.org) and the =org-plus*.tar= package (the
	2902	extended Org distribution, with non-GNU packages from the =contrib/=
	2903	directory.)
	2904
	2905	See https://orgmode.org/elpa/
	2906
	2907	** Overview of the new keybindings
	2908
	2909	\| Keybinding \| Speedy \| Command \|
	2910	\|-----------------+--------+-----------------------------\|
	2911	\| =C-c C-x C-z= \| \| [[doc::org-clock-resolve][org-clock-resolve]] \|
	2912	\| =C-c C-x C-q= \| \| [[doc::org-clock-cancel][org-clock-cancel]] \|
	2913	\| =C-c C-x C-x= \| \| [[doc::org-clock-in-last][org-clock-in-last]] \|
	2914	\| =M-h= \| \| [[doc::org-mark-element][org-mark-element]] \|
	2915	\| =*= \| \| [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]] \|
	2916	\| =C-c C-M-l= \| \| [[doc::org-insert-all-links][org-insert-all-links]] \|
	2917	\| =C-c C-x C-M-v= \| \| [[doc::org-redisplay-inline-images][org-redisplay-inline-images]] \|
	2918	\| =C-c C-x E= \| =E= \| [[doc::org-inc-effort][org-inc-effort]] \|
	2919	\| \| =#= \| [[doc::org-toggle-comment][org-toggle-comment]] \|
	2920	\| \| =:= \| [[doc::org-columns][org-columns]] \|
	2921	\| \| =W= \| Set =APPT_WARNTIME= \|
	2922	\| =k= \| \| [[doc::org-agenda-capture][org-agenda-capture]] \|
	2923	\| C-c , \| , \| [[doc::org-priority][org-priority]] \|
	2924
	2925	** New package and Babel language
	2926
	2927	*** =org-eshell.el= by Konrad Hinsen is now in Org
	2928
	2929	=org-eshell.el= allows you to create links from [[https://www.gnu.org/software/emacs/manual/html_node/eshell/index.html][Eshell]].
	2930
	2931	*** Support for execution of Scala code blocks (see ob-scala.el)
	2932	*** Support for execution of IO code blocks (see ob-io.el)
	2933
	2934	** Incompatible changes
	2935
	2936	- If your code relies on =org-write-agenda=, please use
	2937	[[doc::org-agenda-write][org-agenda-write]] from now on.
	2938
	2939	- If your code relies on =org-make-link=, please use =concat=
	2940	instead.
	2941
	2942	- =org-link-to-org-use-id= has been renamed to
	2943	=org-id-link-to-org-use-id= and its default value is nil. The
	2944	previous default was =create-if-interactive-and-no-custom-id=.
	2945
	2946	** New features and user-visible changes
	2947
	2948	*** Org Element
	2949
	2950	=org-element.el= is a toolbox for parsing and analyzing "elements"
	2951	in an Org-mode buffer. This has been written by Nicolas Goaziou
	2952	and has been tested for quite some time. It is now part of Org's
	2953	core and many core functions rely on this package.
	2954
	2955	Two functions might be particularly handy for users:
	2956	=org-element-at-point= and =org-element-context=.
	2957
	2958	See the docstrings for more details.
	2959
	2960	Below is a list of editing and navigating commands that now rely
	2961	on =org-element.el=.
	2962
	2963	**** [[doc::org-fill-paragraph][org-fill-paragraph]] has been completely rewritten
	2964
	2965	The filling mechanisms now rely on org-element, trying to do the
	2966	right thing on each element in various contexts. E.g. filling in
	2967	a list item will preserve indentation; filling in message-mode
	2968	will fall back on the relevant filling functions; etc.
	2969
	2970	**** [[doc::org-metaup][org-metaup]] and [[doc::org-metadown][org-metadown]] will drag the element backward/forward
	2971
	2972	If you want to get the old behavior (i.e. moving a line up and
	2973	down), you can first select the line as an active region, then
	2974	=org-metaup= or =org-metadown= to move the region backward or
	2975	forward. This also works with regions bigger than just one line.
	2976
	2977	**** [[doc::org-up-element][org-up-element]] and [[doc::org-down-element][org-down-element]] (respectively =C-c C-^= and =C-c C-_=)
	2978
	2979	This will move the point up/down in the hierarchy of elements.
	2980
	2981	**** [[doc::org-backward-element][org-backward-element]] and [[doc::org-forward-element][org-forward-element]] (respectively =M-{= and =M-}=)
	2982
	2983	This will move the point backward/forward in the hierarchy of
	2984	elements.
	2985
	2986	**** [[doc::org-narrow-to-element][org-narrow-to-element]] will narrow to the element at point
	2987	**** [[doc::org-mark-element][org-mark-element]] will mark the element at point
	2988
	2989	This command is bound to =M-h= and will mark the element at
	2990	point. If the point is at a paragraph, it will mark the
	2991	paragraph. If the point is at a list item, it will mark the list
	2992	item. Etc.
	2993
	2994	Note that if point is at the beginning of a list, it will mark
	2995	the whole list.
	2996
	2997	To mark a subtree, you can either use =M-h= on the headline
	2998	(since there is no ambiguity about the element you're at) or
	2999	[[doc::org-mark-subtree][org-mark-subtree]] (=C-c @=) anywhere in the subtree.
	3000
	3001	Invoking [[doc::org-mark-element][org-mark-element]] repeatedly will try to mark the next
	3002	element on top of the previous one(s). E.g. hitting =M-h= twice
	3003	on a headline will mark the current subtree and the next one on
	3004	the same level.
	3005
	3006	*** Org Agenda
	3007
	3008	**** New option [[doc::org-agenda-sticky][org-agenda-sticky]]
	3009
	3010	There is a new option =org-agenda-sticky= which enables "sticky"
	3011	agendas. Sticky agendas remain opened in the background so that
	3012	you don't need to regenerate them each time you hit the
	3013	corresponding keystroke. This is a big time saver.
	3014
	3015	When [[doc::org-agenda-sticky][org-agenda-sticky]] is =non-nil=, the agenda buffer will be
	3016	named using the agenda key and its description. In sticky
	3017	agendas, the =q= key will just bury the agenda buffers and
	3018	further agenda commands will show existing buffer instead of
	3019	generating new ones.
	3020
	3021	If [[doc::org-agenda-sticky][org-agenda-sticky]] is set to =nil=, =q= will kill the single
	3022	agenda buffer.
	3023
	3024	**** New option [[doc::org-agenda-custom-commands-contexts][org-agenda-custom-commands-contexts]]
	3025
	3026	Setting this option allows you to define specific context where
	3027	agenda commands should be available from. For example, when set
	3028	to this value
	3029
	3030	#+BEGIN_SRC emacs-lisp
	3031	(setq org-agenda-custom-commands-contexts
	3032	'(("p" (in-file . "\\.txt"))))
	3033	#+END_SRC
	3034
	3035	then the =p= agenda command will only be available from buffers
	3036	visiting *.txt files. See the docstring and the manual for more
	3037	details on how to use this.
	3038
	3039	**** Changes in bulk actions
	3040
	3041	The set of commands starting with =k ...= as been deleted and the
	3042	features have been merged into the "bulk action" feature.
	3043
	3044	After you marked some entries in the agenda, if you call =B s=,
	3045	the agenda entries will be rescheduled using the date at point if
	3046	on a date header. If you are on an entry with a timestamp, you
	3047	will be prompted for a date to reschedule your marked entries to,
	3048	using the timestamp at point as the default prompt.
	3049
	3050	You can now use =k= to capture the marked entry and use the date
	3051	at point as an overriding date for the capture template.
	3052
	3053	To bind this behavior to =M-x org-capture RET= (or its
	3054	keybinding), set the new option [[doc::org-capture-use-agenda-date][org-capture-use-agenda-date]] to
	3055	=t=.
	3056
	3057	**** =N= and =P= in the agenda will move to the next/previous item
	3058
	3059	**** New command [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]] to mark all items
	3060
	3061	This new command is bound to =*= in agenda mode.
	3062
	3063	There is also a new option [[doc::org-agenda-bulk-mark-char][org-agenda-bulk-mark-char]] to set the
	3064	character to use as a mark for bulk actions.
	3065
	3066	**** New option [[doc::org-agenda-persistent-marks][org-agenda-persistent-marks]]
	3067
	3068	When set to =non-nil=, marks will remain visible after a bulk
	3069	action. You can temporarily toggle this by pressing =p= when
	3070	invoking [[doc::org-agenda-bulk-action][org-agenda-bulk-action]]. Marks are deleted if your
	3071	rebuild the agenda buffer or move to another date/span (e.g. with
	3072	=f= or =w=).
	3073
	3074	**** New option [[doc::org-agenda-skip-timestamp-if-deadline-is-shown][org-agenda-skip-timestamp-if-deadline-is-shown]]
	3075
	3076	=Non-nil= means skip timestamp line if same entry shows because
	3077	of deadline.
	3078
	3079	In the agenda of today, an entry can show up multiple times
	3080	because it has both a plain timestamp and has a nearby deadline.
	3081	When this variable is t, then only the deadline is shown and the
	3082	fact that the entry has a timestamp for or including today is not
	3083	shown. When this variable is =nil=, the entry will be shown
	3084	several times.
	3085
	3086	**** New =todo-unblocked= and =nottodo-unblocked= skip conditions
	3087
	3088	See the [[https://orgmode.org/cgit.cgi/org-mode.git/commit/?id=f426da][git commit]] for more explanations.
	3089
	3090	**** Allow category filtering in the agenda
	3091
	3092	You can now filter the agenda by category. Pressing "<" will
	3093	filter by the category of the item on the current line, and
	3094	pressing "<" again will remove the filter. You can combine tag
	3095	filters and category filters.
	3096
	3097	You can use =org-agenda-category-filter= in your custom agenda
	3098	views and =org-agenda-category-filter-preset= in your main
	3099	configuration.
	3100
	3101	See also the new command [[doc::org-agenda-filter-by-top-category][org-agenda-filter-by-top-category]]:
	3102	hitting =^= will filter by "Top" category: only show entries that
	3103	are of the same category than the Top category of the entry at
	3104	point.
	3105
	3106	*** Org Links
	3107
	3108	**** Inserting links
	3109
	3110	When inserting links through [[doc::org-insert-link][org-insert-link]], the description is
	3111	now displayed first, followed by the literal link, as the
	3112	description is often more useful when you look for the link you
	3113	want to insert.
	3114
	3115	Completion now complete both literal links and description. If
	3116	you complete a description, the literal link and its description
	3117	will be inserted directly, whereas when you complete the literal
	3118	link, you will be prompted for a description (as with Org 7.8.)
	3119
	3120	In the completion buffer, links to the current buffer are now
	3121	highlighted.
	3122
	3123	**** New templates =%h= and =%(sexp)= for abbreviated links
	3124
	3125	On top of =%s= template, which is replaced by the link tag in
	3126	abbreviated links, you can now use =%h= (which does the same than =%s=
	3127	but does not hexify the tag) and =%(sexp)= (which can run a function
	3128	that takes the tag as its own argument.)
	3129
	3130	**** New link type =help=
	3131
	3132	You can now create links from =help= buffers.
	3133
	3134	For example, if you request help for the command [[doc::org-agenda][org-agenda]] with
	3135	=C-h f org-agenda RET=, creating a link from this buffer will let
	3136	you go back to the same buffer.
	3137
	3138	**** New command [[doc::org-insert-all-links][org-insert-all-links]]
	3139
	3140	This will insert all links as list items. With a universal
	3141	prefix argument, links will not be deleted from the variable
	3142	=org-stored-links=.
	3143
	3144	This new command is bound to =C-c C-M-l=.
	3145
	3146	**** New option [[doc::org-url-hexify-p][org-url-hexify-p]]
	3147
	3148	When set to =nil=, the =URL= part of a link will not be hexified.
	3149
	3150	**** Org can now open multiple shell links
	3151
	3152	**** New option [[doc::org-doi-server-url][org-doi-server-url]] to specify an alternate DOI server
	3153
	3154	**** RET now follows time stamps links
	3155
	3156	*** Org Editing
	3157
	3158	**** [[doc::org-todo][org-todo]] and =org-archive-*= can now loop in the active region
	3159
	3160	When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, using
	3161	[[doc::org-todo][org-todo]] or =org-archive-*= commands in the active region will
	3162	loop over headlines. This is handy if you want to set the TODO
	3163	keyword for several items, or archive them quickly.
	3164
	3165	**** You can now set tags for headlines in a region
	3166
	3167	If [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, then
	3168	selecting the region and hitting =C-c C-q= will set the tags for
	3169	all headlines in the region.
	3170
	3171	**** New command [[doc::org-insert-drawer][org-insert-drawer]] to insert a drawer interactively
	3172
	3173	**** Comments start with "^[ \t]*# " anywhere on a line
	3174
	3175	Note that the space after the hashtag is mandatory. Comments
	3176	with "^#+" are not supported anymore.
	3177
	3178	**** New speed key =#= to toggle the COMMENT cookie on a headline
	3179
	3180	**** =indent-region-function= is now set to [[doc::org-indent-region][org-indent-region]]
	3181
	3182	=C-M-\= should now produce useful results.
	3183
	3184	You can unindent the buffer with [[doc::org-unindent-buffer][org-unindent-buffer]].
	3185
	3186	**** New option [[doc::org-allow-promoting-top-level-subtree][org-allow-promoting-top-level-subtree]]
	3187
	3188	When =non-nil=, =S-M-<left>= will promote level-1 subtrees
	3189	containing other subtrees. The level-1 headline will be
	3190	commented out. You can revert to the previous state with =M-x
	3191	undo RET=.
	3192
	3193	*** Org Clock
	3194
	3195	**** New keybinding =C-c C-x C-z= for [[doc::org-clock-resolve][org-clock-resolve]]
	3196
	3197	**** New keybinding =C-c C-x C-q= for [[doc::org-clock-cancel][org-clock-cancel]]
	3198
	3199	**** New command [[doc::org-clock-in-last][org-clock-in-last]] to clock in the last clocked item
	3200
	3201	This command is bound to =C-c C-x C-x= and will clock in the last
	3202	clocked entry, if any.
	3203
	3204	**** =C-u M-x= [[doc::org-clock-out][org-clock-out]] =RET= now prompts for a state to switch to
	3205
	3206	**** =S-M-<up/down>= on a clock timestamps adjusts the previous/next clock
	3207
	3208	**** New option [[doc::org-clock-continuously][org-clock-continuously]]
	3209
	3210	When set to =nil=, clocking in a task will first try to find the
	3211	last clocked out task and restart from when that task was clocked
	3212	out.
	3213
	3214	You can temporarily activate continuous clocking with =C-u C-u
	3215	C-u M-x= [[doc::org-clock-in][org-clock-in]] =RET= (three universal prefix arguments)
	3216	and =C-u C-u M-x= [[org-clock-in-last][org-clock-in-last]] =RET= (two universal prefix
	3217	arguments).
	3218
	3219
	3220	**** New option [[doc::org-clock-frame-title-format][org-clock-frame-title-format]]
	3221
	3222	This option sets the value of =frame-title-format= when clocking
	3223	in.
	3224
	3225	**** New options for controlling the clockreport display
	3226
	3227	[[doc::org-clock-file-time-cell-format][org-clock-file-time-cell-format]]: Format string for the file time
	3228	cells in clockreport.
	3229
	3230	[[doc::org-clock-total-time-cell-format][org-clock-total-time-cell-format]]: Format string for the total
	3231	time cells in clockreport.
	3232
	3233
	3234	**** New options for controlling the clock/timer display
	3235
	3236	[[doc::org-clock-clocked-in-display][org-clock-clocked-in-display]]: control whether the current clock
	3237	is displayed in the mode line and/or frame title.
	3238
	3239	[[doc::org-timer-display][org-timer-display]]: control whether the current timer is displayed
	3240	in the mode line and/or frame title.
	3241
	3242	This allows the clock and timer to be displayed in the frame
	3243	title instead of, or as well as, the mode line. This is useful
	3244	for people with limited space in the mode line but with ample
	3245	space in the frame title.
	3246
	3247	*** Org Appearance
	3248
	3249	**** New option [[doc::org-custom-properties][org-custom-properties]]
	3250
	3251	The visibility of properties listed in this options can be turn
	3252	on/off with [[doc::org-toggle-custom-properties-visibility][org-toggle-custom-properties-visibility]]. This might
	3253	be useful for properties used by third-part tools or that you
	3254	don't want to see temporarily.
	3255
	3256	**** New command [[doc::org-redisplay-inline-images][org-redisplay-inline-images]]
	3257
	3258	This will redisplay all images. It is bound to =C-c C-x C-M-v=.
	3259
	3260	**** New entities in =org-entities.el=
	3261
	3262	There are these new entities:
	3263
	3264	: ("tilde" "\\~{}" nil "&tilde;" "~" "~" "~")
	3265	: ("slash" "/" nil "/" "/" "/" "/")
	3266	: ("plus" "+" nil "+" "+" "+" "+")
	3267	: ("under" "\\_" nil "_" "_" "_" "_")
	3268	: ("equal" "=" nil "=" "=" "=" "=")
	3269	: ("asciicirc" "\\textasciicircum{}" nil "^" "^" "^" "^")
	3270
	3271	**** New face =org-list-dt= for definition terms
	3272	**** New face =org-date-selected= for the selected calendar day
	3273	**** New face value for =org-document-title=
	3274
	3275	The face is back to a normal height.
	3276
	3277	*** Org Columns
	3278
	3279	**** New speed command =:= to activate the column view
	3280	**** New special property =CLOCKSUM_T= to display today's clocked time
	3281
	3282	You can use =CLOCKSUM_T= the same way you use =CLOCKSUM=. It
	3283	will display the time spent on tasks for today only.
	3284
	3285	**** Use the =:COLUMNS:= property in columnview dynamic blocks
	3286
	3287	If the =:COLUMNS:= is set in a subtree, the columnview dynamic
	3288	block will use its value as the column format.
	3289
	3290	**** Consider inline tasks when computing a sum
	3291
	3292	*** Org Dates and Time Stamps
	3293
	3294	**** Enhanced [[doc::org-sparse-tree][org-sparse-tree]]
	3295
	3296	=C-c /= can now check for time ranges.
	3297
	3298	When checking for dates with =C-c /= it is useful to change the
	3299	type of dates that you are interested in. You can now do this
	3300	interactively with =c= after =C-c /= and/or by setting
	3301	[[doc::org-sparse-tree-default-date-type][org-sparse-tree-default-date-type]] to the default value you want.
	3302
	3303	**** Support for hourly repeat cookies
	3304
	3305	You can now use
	3306
	3307	: SCHEDULED: <2012-08-20 lun. 08:00 +1h>
	3308
	3309	if you want to add an hourly repeater to an entry.
	3310
	3311	**** =C-u C-u C-c .= inserts a time-stamp with no prompt
	3312
	3313	**** When (setq [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] 'time), accept days in the prompt
	3314
	3315	"8am Wed" and "Wed 8am" are now acceptable values when entering a
	3316	date from the prompt. If [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] is set to
	3317	=time=, this will produce the expected prompt indication.
	3318
	3319	**** New option [[doc::org-datetree-add-timestamp][org-datetree-add-timestamp]]
	3320
	3321	When set to =non-nil=, datetree entries will also have a
	3322	timestamp. This is useful if you want to see these entries in a
	3323	sparse tree with =C-c /=.
	3324
	3325	*** Org Capture
	3326
	3327	**** New command [[doc::org-capture-string][org-capture-string]]
	3328
	3329	M-x [[doc::org-capture-string][org-capture-string]] RET will prompt for a string and a capture
	3330	template. The string will be used as an annotation for the
	3331	template. This is useful when capturing in batch mode as it lets
	3332	you define the content of the template without being in Emacs.
	3333
	3334	**** New option [[doc::org-capture-templates-contexts][org-capture-templates-contexts]]
	3335
	3336	Setting this option allows you to define specific context where
	3337	capture templates should be available from. For example, when
	3338	set to this value
	3339
	3340	#+BEGIN_SRC emacs-lisp
	3341	(setq org-capture-templates-contexts
	3342	'(("c" (in-mode . "message-mode"))))
	3343	#+END_SRC
	3344
	3345	then the =c= capture template will only be available from
	3346	=message-mode= buffers. See the docstring and the manual for
	3347	more details on how to use this.
	3348
	3349	**** New =%l= template to insert the literal link
	3350	**** New option [[doc::org-capture-bookmark][org-capture-bookmark]]
	3351
	3352	Org used to automatically add a bookmark with capture a note.
	3353	You can now turn this on by setting [[doc::org-capture-bookmark][org-capture-bookmark]] to
	3354	=nil=.
	3355
	3356	**** Expand =%<num>= escape sequences into text entered for <num>'th =%^{PROMPT}= escape
	3357
	3358	See the manual for more explanations.
	3359
	3360	**** More control over empty lines
	3361
	3362	You can use =:empty-lines-before= and =:empty-lines-after= to
	3363	control the insertion of empty lines. Check the manual for more
	3364	explanations.
	3365
	3366	**** New hook [[doc::org-capture-prepare-finalize-hook][org-capture-prepare-finalize-hook]]
	3367
	3368	This new hook runs before the finalization process starts.
	3369
	3370	*** Org Export
	3371
	3372	**** New functions =orgtbl-to-table.el= and =orgtbl-to-unicode=
	3373
	3374	=orgtbl-to-table.el= convert the table to a =table.el= table, and
	3375	=orgtbl-to-unicode= will use =ascii-art-to-unicode.el= (when
	3376	available) to print beautiful tables.
	3377
	3378	**** [[doc::org-table-export][org-table-export]] now a bit clever about the target format
	3379
	3380	When you specify a file name like =table.csv=, [[doc::org-table-export][org-table-export]]
	3381	will now suggest =orgtbl-to-csv= the default method for exporting
	3382	the table.
	3383
	3384	**** New option [[doc::org-export-date-timestamp-format][org-export-date-timestamp-format]]
	3385
	3386	The option allows to set a time string format for Org timestamps
	3387	in the #+DATE option.
	3388
	3389	**** LaTeX: New options for exporting table rules :tstart, :hline and :tend
	3390
	3391	See [[doc::org-export-latex-tables-hline][org-export-latex-tables-hline]] and [[doc::org-export-latex-tables-tend][org-export-latex-tables-tend]].
	3392
	3393	**** LaTeX: You can now set =:hfmt= from =#+ATTR_LaTeX=
	3394	**** Beamer: Add support and keybinding for the =exampleblock= environment
	3395
	3396	Add support for these languages in [[doc::org-export-language-setup][org-export-language-setup]].
	3397	More languages are always welcome.
	3398
	3399	**** Beamer: New option [[doc::org-beamer-inherited-properties][org-beamer-inherited-properties]]
	3400
	3401	This option allows Beamer export to inherit some properties.
	3402	Thanks to Carsten for implementing this.
	3403
	3404	**** ODT: Add support for ODT export in org-bbdb.el
	3405	**** ODT: Add support for indented tables (see [[https://orgmode.org/cgit.cgi/org-mode.git/commit/?id=e9fd33][this commit]] for details)
	3406	**** ODT: Improve the conversion from ODT to other formats
	3407	**** ASCII: Swap the level-1/level-2 characters to underline the headlines
	3408	**** Support for Chinese, simplified Chinese, Russian, Ukrainian and Japanese
	3409	**** HTML: New option [[doc::org-export-html-date-format-string][org-export-html-date-format-string]]
	3410
	3411	Format string to format the date and time in HTML export. Thanks
	3412	to Sébastien Vauban for this patch.
	3413
	3414	*** Org Babel
	3415
	3416	**** New =:results drawer= parameter
	3417
	3418	=:results drawer= replaces =:results wrap=, which is deprecated but still
	3419	supported.
	3420
	3421	**** =:results org= now put results in a =#+BEGIN_SRC org= block
	3422
	3423	=:results org= used to put results in a =#+BEGIN_ORG= block but it now puts
	3424	results in a =#+BEGIN_SRC org= block, with comma-escaped lines.
	3425
	3426	=#+BEGIN_ORG= blocks are obsolete.
	3427
	3428	**** Exporting =#+BEGIN_SRC org= blocks exports the code
	3429
	3430	It used to exports the results of the code.
	3431
	3432	*** Miscellaneous
	3433
	3434	**** New menu entry for [[doc::org-refile][org-refile]]
	3435	**** Allow capturing to encrypted entries
	3436
	3437	If you capture to an encrypted entry, it will be decrypted before
	3438	inserting the template then re-encrypted after finalizing the capture.
	3439
	3440	**** Inactive timestamps are now handled in tables
	3441
	3442	Calc can do computation on active time-stamps like <2012-09-29 sat.>.
	3443	Inactive time-stamps in a table's cell are now internally deactivated so
	3444	that Calc formulas can operate on them.
	3445
	3446	**** [[doc::org-table-number-regexp][org-table-number-regexp]] can now accept comma as decimal mark
	3447	**** Org allows a new property =APPT_WARNTIME=
	3448
	3449	You can set it with the =W= speedy key or set it manually. When
	3450	set, exporting to iCalendar and [[doc::org-agenda-to-appt][org-agenda-to-appt]] will use the
	3451	value of this property as the number of minutes for the warning
	3452	alarm.
	3453
	3454	**** New command [[doc::org-inc-effort][org-inc-effort]]
	3455
	3456	This will increment the effort value.
	3457
	3458	It is bound to =C-c C-x E= and to =E= as a speedy command.
	3459
	3460	**** Attach: Add support for creating symbolic links
	3461
	3462	=org-attach-method= now supports a new method =lns=, allowing to
	3463	attach symbolic links.
	3464
	3465	**** Archive: you can now archive to a datetree
	3466
	3467	**** New option [[doc::org-inlinetask-show-first-star][org-inlinetask-show-first-star]]
	3468
	3469	=Non-nil= means display the first star of an inline task as
	3470	additional marker. When =nil=, the first star is not shown.
	3471
	3472	**** New option [[doc::org-latex-preview-ltxpng-directory][org-latex-preview-ltxpng-directory]]
	3473
	3474	This lets you define the path for the =ltxpng/= directory.
	3475
	3476	**** You can now use imagemagick instead of dvipng to preview LaTeX fragments
	3477	**** You can now turn off [[doc::orgstruct++-mode][orgstruct++-mode]] safely
	3478	**** =C-u C-c C-c= on list items to add check boxes
	3479
	3480	=C-u C-c C-c= will add an empty check box on a list item.
	3481
	3482	When hit from the top of the list, it will add check boxes for
	3483	all top level list items.
	3484
	3485	**** =org-list-ending-method= and =org-list-end-regexp= are now obsolete
	3486
	3487	Fall back on using =org-list-end-re= only, which see.
	3488
	3489	**** org-feed.el now expands =%(sexp)= templates
	3490	**** New option [[doc::org-protocol-data-separator][org-protocol-data-separator]]
	3491
	3492	**** New option [[doc::org-ditaa-jar-option][org-ditaa-jar-option]] to specify the ditaa jar file
	3493
	3494	**** New possible value for [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]]
	3495
	3496	When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is set to
	3497	=start-level=, the command will loop over the active region but
	3498	will only act upon entries that are of the same level than the
	3499	first headline in the region.
	3500
	3501	**** New option [[doc::org-habit-show-all-today][org-habit-show-all-today]]
	3502
	3503	When set to =t=, show all (even unscheduled) habits on today's
	3504	agenda.
	3505
	3506	** Important bug fixes
	3507
	3508	*** M-TAB on options keywords perform completion correctly again
	3509
	3510	If you hit =M-TAB= on keywords like =#+TITLE=, Org will try to
	3511	perform completion with meaningful values.
	3512
	3513	*** Add licenses to javascript embedded and external code snippets
	3514
	3515	Embedded javascript code produced when exporting an Org file to
	3516	HTML is now licensed under GPLv3 (or later), and the copyright is
	3517	owned by the Free Software Foundation, Inc.
	3518
	3519	The javascript code for embedding MathJax in the browser mentions
	3520	the MathJax copyright and the Apache 2.0 license.
	3521
	3522	The javascript code for embedding =org-injo.js= in the browser
	3523	mentions the copyright of Sebastian Rose and the GPLv3 (or later)
	3524	license.
	3525
	3526	=org-export-html-scripts= is now a variable, so that you can adapt
	3527	the code and the license to your needs.
	3528
	3529	See https://www.gnu.org/philosophy/javascript-trap.html for
	3530	explanations on why these changes were necessary.
	3531
	3532	* Version 7.8.11
	3533
	3534	** Incompatible changes
	3535
	3536	*** Emacs 21 support has been dropped
	3537
	3538	Do not use Org mode 7.xx with Emacs 21, use [[https://orgmode.org/org-6.36c.zip][version 6.36c]] instead.
	3539
	3540	*** XEmacs support requires the XEmacs development version
	3541
	3542	To use Org mode 7.xx with XEmacs, you need to run the developer
	3543	version of XEmacs. We were about to drop XEmacs support entirely,
	3544	but Michael Sperber stepped in and made changes to XEmacs that
	3545	made it easier to keep the support. Thanks to Michael for this
	3546	last-minute save.
	3547
	3548	*** New keys for TODO sparse trees
	3549
	3550	The key =C-c C-v= is now reserved for Org Babel action. TODO
	3551	sparse trees can still be made with =C-c / t= (all not-done
	3552	states) and =C-c / T= (specific states).
	3553
	3554	*** The Agenda =org-agenda-ndays= is now obsolete
	3555
	3556	The variable =org-agenda-ndays= is obsolete - please use
	3557	=org-agenda-span= instead.
	3558
	3559	Thanks to Julien Danjou for this.
	3560
	3561	*** Changes to the intended use of =org-export-latex-classes=
	3562
	3563	So far this variable has been used to specify the complete header
	3564	of the LaTeX document, including all the =\usepackage= calls
	3565	necessary for the document. This setup makes it difficult to
	3566	maintain the list of packages that Org itself would like to call,
	3567	for example for the special symbol support it needs.
	3568
	3569	First of all, you can opt out of this change in the following
	3570	way: You can say: /I want to have full control over headers, and I
	3571	will take responsibility to include the packages Org needs/. If
	3572	that is what you want, add this to your configuration and skip the
	3573	rest of this section (except maybe for the description of the
	3574	=[EXTRA]= place holder):
	3575
	3576	#+begin_src emacs-lisp
	3577	(setq org-export-latex-default-packages-alist nil
	3578	org-export-latex-packages-alist nil)
	3579	#+end_src
	3580
	3581	/Continue to read here if you want to go along with the modified
	3582	setup./
	3583
	3584	There are now two variables that should be used to list the LaTeX
	3585	packages that need to be included in all classes. The header
	3586	definition in =org-export-latex-classes= should then not contain
	3587	the corresponding =\usepackage= calls (see below).
	3588
	3589	The two new variables are:
	3590
	3591	1. =org-export-latex-default-packages-alist= :: This is the
	3592	variable where Org-mode itself puts the packages it needs.
	3593	Normally you should not change this variable. The only
	3594	reason to change it anyway is when one of these packages
	3595	causes a conflict with another package you want to use. Then
	3596	you can remove that packages and hope that you are not using
	3597	Org-mode functionality that needs it.
	3598
	3599	2. =org-export-latex-packages-alist= :: This is the variable where
	3600	you can put the packages that you'd like to use across all
	3601	classes.
	3602
	3603	The sequence how these customizations will show up in the LaTeX
	3604	document are:
	3605
	3606	1. Header from =org-export-latex-classes=
	3607	2. =org-export-latex-default-packages-alist=
	3608	3. =org-export-latex-packages-alist=
	3609	4. Buffer-specific things set with =#+LaTeX_HEADER:=
	3610
	3611	If you want more control about which segment is placed where, or
	3612	if you want, for a specific class, have full control over the
	3613	header and exclude some of the automatic building blocks, you can
	3614	put the following macro-like place holders into the header:
	3615
	3616	#+begin_example
	3617	[DEFAULT-PACKAGES] \usepackage statements for default packages
	3618	[NO-DEFAULT-PACKAGES] do not include any of the default packages
	3619	[PACKAGES] \usepackage statements for packages
	3620	[NO-PACKAGES] do not include the packages
	3621	[EXTRA] the stuff from #+LaTeX_HEADER
	3622	[NO-EXTRA] do not include #+LaTeX_HEADER stuff
	3623	#+end_example
	3624
	3625	If you have currently customized =org-export-latex-classes=, you
	3626	should revise that customization and remove any package calls that
	3627	are covered by =org-export-latex-default-packages-alist=. This
	3628	applies to the following packages:
	3629
	3630	- inputenc
	3631	- fontenc
	3632	- fixltx2e
	3633	- graphicx
	3634	- longtable
	3635	- float
	3636	- wrapfig
	3637	- soul
	3638	- t1enc
	3639	- textcomp
	3640	- marvosym
	3641	- wasysym
	3642	- latexsym
	3643	- amssymb
	3644	- hyperref
	3645
	3646	If one of these packages creates a conflict with another package
	3647	you are using, you can remove it from
	3648	=org-export-latex-default-packages-alist=. But then you risk that
	3649	some of the advertised export features of Org will not work
	3650	properly.
	3651
	3652	You can also consider moving packages that you use in all classes
	3653	to =org-export-latex-packages-alist=. If necessary, put the place
	3654	holders so that the packages get loaded in the right sequence. As
	3655	said above, for backward compatibility, if you omit the place
	3656	holders, all the variables will dump their content at the end of
	3657	the header.
	3658
	3659	*** The constant =org-html-entities= is obsolete
	3660
	3661	Its content is now part of the new constant =org-entities=, which
	3662	is defined in the file org-entities.el. =org-html-entities= was
	3663	an internal variable, but it is possible that some users did write
	3664	code using it.
	3665
	3666	*** =org-bbdb-anniversary-format-alist= has changed
	3667
	3668	Please check the docstring and update your settings accordingly.
	3669
	3670	*** Deleted =org-mode-p=
	3671
	3672	This function has been deleted: please update your code.
	3673
	3674	** Important new features
	3675
	3676	*** New Org to ODT exporter
	3677
	3678	Jambunathan's Org to ODT exporter is now part of Org.
	3679
	3680	To use it, it `C-c C-e o' in an Org file. See the documentation
	3681	for more information on how to customize it.
	3682
	3683	*** org-capture.el is now the default capture system
	3684
	3685	This replaces the earlier system org-remember. The manual only
	3686	describes org-capture, but for people who prefer to continue to
	3687	use org-remember, we keep a static copy of the former manual
	3688	section [[https://orgmode.org/org-remember.pdf][chapter about remember]].
	3689
	3690	The new system has a technically cleaner implementation and more
	3691	possibilities for capturing different types of data. See
	3692	[[http://thread.gmane.org/gmane.emacs.orgmode/26441/focus%3D26441][Carsten's announcement]] for more details.
	3693
	3694	To switch over to the new system:
	3695
	3696	1. Run
	3697
	3698	: M-x org-capture-import-remember-templates RET
	3699
	3700	to get a translated version of your remember templates into the
	3701	new variable =org-capture-templates=. This will "mostly" work,
	3702	but maybe not for all cases. At least it will give you a good
	3703	place to modify your templates. After running this command,
	3704	enter the customize buffer for this variable with
	3705
	3706	: M-x customize-variable RET org-capture-templates RET
	3707
	3708	and convince yourself that everything is OK. Then save the
	3709	customization.
	3710
	3711	2. Bind the command =org-capture= to a key, similar to what you did
	3712	with org-remember:
	3713
	3714	: (define-key global-map "\C-cc" 'org-capture)
	3715
	3716	If your fingers prefer =C-c r=, you can also use this key once
	3717	you have decided to move over completely to the new
	3718	implementation. During a test time, there is nothing wrong
	3719	with using both system in parallel.
	3720
	3721	** New libraries
	3722
	3723	*** New Org libraries
	3724	**** org-eshell.el (Konrad Hinsen)
	3725
	3726	Implement links to eshell buffers.
	3727
	3728	**** org-special-blocks (Carsten Dominik)
	3729
	3730	This package generalizes the #+begin_foo and #+end_foo tokens.
	3731
	3732	To use, put the following in your init file:
	3733
	3734	#+BEGIN_EXAMPLE
	3735	(require 'org-special-blocks)
	3736	#+END_EXAMPLE
	3737
	3738	The tokens #+begin_center, #+begin_verse, etc. existed
	3739	previously. This package generalizes them (at least for the
	3740	LaTeX and html exporters). When a #+begin_foo token is
	3741	encountered by the LaTeX exporter, it is expanded
	3742	into \begin{foo}. The text inside the environment is not
	3743	protected, as text inside environments generally is.
	3744	When #+begin_foo is encountered by the html exporter, a div with
	3745	class foo is inserted into the HTML file. It is up to the user
	3746	to add this class to his or her stylesheet if this div is to mean
	3747	anything.
	3748
	3749	**** org-taskjuggler.el (Christian Egli)
	3750
	3751	Christian Egli's /org-taskjuggler.el/ module is now part of Org.
	3752	He also wrote a [[https://orgmode.org/worg/org-tutorials/org-taskjuggler.php][tutorial]] for it.
	3753
	3754	**** org-ctags.el (Paul Sexton)
	3755
	3756	Targets like =<<my target>>= can now be found by Emacs' etag
	3757	functionality, and Org-mode links can be used to to link to
	3758	etags, also in non-Org-mode files. For details, see the file
	3759	/org-ctags.el/.
	3760
	3761	This feature uses a new hook =org-open-link-functions= which will
	3762	call function to do something special with text links.
	3763
	3764	Thanks to Paul Sexton for this contribution.
	3765
	3766	**** org-docview.el (Jan Böcker)
	3767
	3768	This new module allows links to various file types using docview, where
	3769	Emacs displays images of document pages. Docview link types can point
	3770	to a specific page in a document, for example to page 131 of the
	3771	Org-mode manual:
	3772
	3773	: [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]]
	3774
	3775	Thanks to Jan Böcker for this contribution.
	3776
	3777	*** New Babel libraries
	3778
	3779	- ob-picolisp.el (Thorsten Jolitz)
	3780	- ob-fortran.el (Sergey Litvinov)
	3781	- ob-shen.el (Eric Schulte)
	3782	- ob-maxima.el (Eric S Fraga)
	3783	- ob-java.el (Eric Schulte)
	3784	- ob-lilypond.el (Martyn Jago)
	3785	- ob-awk.el (Eric Schulte)
	3786
	3787	** Other new features and various enhancements
	3788
	3789	*** Hyperlinks
	3790
	3791	**** Org-Bibtex -- major improvements
	3792
	3793	Provides support for managing bibtex bibliographical references
	3794	data in headline properties. Each headline corresponds to a
	3795	single reference and the relevant bibliographic meta-data is
	3796	stored in headline properties, leaving the body of the headline
	3797	free to hold notes and comments. Org-bibtex is aware of all
	3798	standard bibtex reference types and fields.
	3799
	3800	The key new functions are
	3801
	3802	- org-bibtex-check :: queries the user to flesh out all required
	3803	(and with prefix argument optional) bibtex fields available
	3804	for the specific reference =type= of the current headline.
	3805
	3806	- org-bibtex-create :: Create a new entry at the given level,
	3807	using org-bibtex-check to flesh out the relevant fields.
	3808
	3809	- org-bibtex-yank :: Yank a bibtex entry on the kill ring as a
	3810	formatted Org-mode headline into the current buffer
	3811
	3812	- org-bibtex-export-to-kill-ring :: Export the current headline
	3813	to the kill ring as a formatted bibtex entry.
	3814
	3815	**** org-gnus.el now allows link creation from messages
	3816
	3817	You can now create links from messages. This is particularly
	3818	useful when the user wants to stored messages that he sends, for
	3819	later check. Thanks to Ulf Stegemann for the patch.
	3820
	3821	**** Modified link escaping
	3822
	3823	David Maus worked on `org-link-escape'. See [[http://article.gmane.org/gmane.emacs.orgmode/37888][his message]]:
	3824
	3825	: Percent escaping is used in Org mode to escape certain characters
	3826	: in links that would either break the parser (e.g. square brackets
	3827	: in link target oder description) or are not allowed to appear in
	3828	: a particular link type (e.g. non-ascii characters in a http:
	3829	: link).
	3830	:
	3831	: With this change in place Org will apply percent escaping and
	3832	: unescaping more consistently especially for non-ascii characters.
	3833	: Additionally some of the outstanding bugs or glitches concerning
	3834	: percent escaped links are solved.
	3835
	3836	Thanks a lot to David for this work.
	3837
	3838	**** Make =org-store-link= point to directory in a dired buffer
	3839
	3840	When, in a dired buffer, the cursor is not in a line listing a
	3841	file, `org-store-link' will store a link to the directory.
	3842
	3843	Patch by Stephen Eglen.
	3844
	3845	**** Allow regexps in =org-file-apps= to capture link parameters
	3846
	3847	The way extension regexps in =org-file-apps= are handled has
	3848	changed. Instead of matching against the file name, the regexps
	3849	are now matched against the whole link, and you can use grouping
	3850	to extract link parameters which you can then use in a command
	3851	string to be executed.
	3852
	3853	For example, to allow linking to PDF files using the syntax
	3854	=file:/doc.pdf::<page number>=, you can add the following entry
	3855	to org-file-apps:
	3856
	3857	#+begin_example
	3858	Extension: \.pdf::$[0-9]+$\'
	3859	Command: evince "%s" -p %1
	3860	#+end_example
	3861
	3862	Thanks to Jan Böcker for a patch to this effect.
	3863
	3864	*** Dates and time
	3865
	3866	**** Allow relative time when scheduling/adding a deadline
	3867
	3868	You can now use relative duration strings like "-2d" or "++3w"
	3869	when calling =org-schedule= or =org-deadline=: it will schedule
	3870	(or set the deadline for) the item respectively two days before
	3871	today and three weeks after the current timestamp, if any.
	3872
	3873	You can use this programmatically: =(org-schedule nil "+2d")=
	3874	will work on the current entry.
	3875
	3876	You can also use this while (bulk-)rescheduling and
	3877	(bulk-)resetting the deadline of (several) items from the agenda.
	3878
	3879	Thanks to Memnon Anon for a heads up about this!
	3880
	3881	**** American-style dates are now understood by =org-read-date=
	3882
	3883	So when you are prompted for a date, you can now answer like this
	3884
	3885	#+begin_example
	3886	2/5/3 --> 2003-02-05
	3887	2/5 --> <CURRENT-YEAR>-02-05
	3888	#+end_example
	3889
	3890	*** Agenda
	3891
	3892	**** =org-agenda-custom-commands= has a default value
	3893
	3894	This option used to be `nil' by default. This now has a default
	3895	value, displaying an agenda and all TODOs. See the docstring for
	3896	details. Thanks to Carsten for this.
	3897
	3898	**** Improved filtering through =org-agenda-to-appt=
	3899
	3900	The new function allows the user to refine the scope of entries
	3901	to pass to =org-agenda-get-day-entries= and allows to filter out
	3902	entries using a function.
	3903
	3904	Thanks to Peter Münster for raising a related issue and to
	3905	Tassilo Horn for this idea. Also thanks to Peter Münster for
	3906	[[git:68ffb7a7][fixing a small bug]] in the final implementation.
	3907
	3908	**** Allow ap/pm times in agenda time grid
	3909
	3910	Times in the agenda can now be displayed in am/pm format. See
	3911	the new variable =org-agenda-timegrid-use-ampm=. Thanks to
	3912	C. A. Webber for a patch to this effect.
	3913
	3914	**** Agenda: Added a bulk "scattering" command
	3915
	3916	=B S= in the agenda buffer will cause tasks to be rescheduled a
	3917	random number of days into the future, with 7 as the default.
	3918	This is useful if you've got a ton of tasks scheduled for today,
	3919	you realize you'll never deal with them all, and you just want
	3920	them to be distributed across the next N days. When called with
	3921	a prefix arg, rescheduling will avoid weekend days.
	3922
	3923	Thanks to John Wiegley for this.
	3924
	3925	*** Exporting
	3926
	3927	**** Simplification of org-export-html-preamble/postamble
	3928
	3929	When set to `t', export the preamble/postamble as usual, honoring
	3930	the =org-export-email/author/creator-info= variables.
	3931
	3932	When set to a formatting string, insert this string. See the
	3933	docstring of these variable for details about available
	3934	%-sequences.
	3935
	3936	You can set =:html-preamble= in publishing project in the same
	3937	way: `t' means to honor =:email/creator/author-info=, and a
	3938	formatting string will insert a string.
	3939
	3940	**** New exporters to Latin-1 and UTF-8
	3941
	3942	While Ulf Stegemann was going through the entities list to
	3943	improve the LaTeX export, he had the great idea to provide
	3944	representations for many of the entities in Latin-1, and for all
	3945	of them in UTF-8. This means that we can now export files rich
	3946	in special symbols to Latin-1 and to UTF-8 files. These new
	3947	exporters can be reached with the commands =C-c C-e n= and =C-c
	3948	C-e u=, respectively.
	3949
	3950	When there is no representation for a given symbol in the
	3951	targeted coding system, you can choose to keep the TeX-macro-like
	3952	representation, or to get an "explanatory" representation. For
	3953	example, =\simeq= could be represented as "[approx. equal to]".
	3954	Please use the variable =org-entities-ascii-explanatory= to state
	3955	your preference.
	3956
	3957	**** HTML export: Add class to outline containers using property
	3958
	3959	The =HTML_CONTAINER_CLASS= property can now be used to add a
	3960	class name to the outline container of a node in HTML export.
	3961
	3962	**** Throw an error when creating an image from a LaTeX snippet fails
	3963
	3964	This behavior can be configured with the new option variable
	3965	=org-format-latex-signal-error=.
	3966
	3967	**** Support for creating BEAMER presentations from Org-mode documents
	3968
	3969	Org-mode documents or subtrees can now be converted directly in
	3970	to BEAMER presentation. Turning a tree into a simple
	3971	presentations is straight forward, and there is also quite some
	3972	support to make richer presentations as well. See the [[https://orgmode.org/manual/Beamer-class-export.html#Beamer-class-export][BEAMER
	3973	section]] in the manual for more details.
	3974
	3975	Thanks to everyone who has contributed to the discussion about
	3976	BEAMER support and how it should work. This was a great example
	3977	for how this community can achieve a much better result than any
	3978	individual could.
	3979
	3980	*** Refiling
	3981
	3982	**** Refile targets can now be cached
	3983
	3984	You can turn on caching of refile targets by setting the variable
	3985	=org-refile-use-cache=. This should speed up refiling if you
	3986	have many eligible targets in many files. If you need to update
	3987	the cache because Org misses a newly created entry or still
	3988	offers a deleted one, press =C-0 C-c C-w=.
	3989
	3990	**** New logging support for refiling
	3991
	3992	Whenever you refile an item, a time stamp and even a note can be
	3993	added to this entry. For details, see the new option
	3994	=org-log-refile=.
	3995
	3996	Thanks to Charles Cave for this idea.
	3997
	3998	*** Completion
	3999
	4000	**** In-buffer completion is now done using John Wiegley's pcomplete.el
	4001
	4002	Thanks to John Wiegley for much of this code.
	4003
	4004	*** Tables
	4005
	4006	**** New command =org-table-transpose-table-at-point=
	4007
	4008	See the docstring. This hack from Juan Pechiar is now part of
	4009	Org's core. Thanks to Juan!
	4010
	4011	**** Display field's coordinates when editing it with =C-c `=
	4012
	4013	When editing a field with =C-c `=, the field's coordinate will
	4014	the displayed in the buffer.
	4015
	4016	Thanks to Michael Brand for a patch to this effect.
	4017
	4018	**** Spreadsheet computation of durations and time values
	4019
	4020	If you want to compute time values use the =T= flag, either in
	4021	Calc formulas or Elisp formulas:
	4022
	4023	\| Task 1 \| Task 2 \| Total \|
	4024	\|--------+--------+---------\|
	4025	\| 35:00 \| 35:00 \| 1:10:00 \|
	4026	#+TBLFM: @2$3=$1+$2;T
	4027
	4028	Values must be of the form =[HH:]MM:SS=, where hours are
	4029	optional.
	4030
	4031	Thanks to Martin Halder, Eric Schulte and Carsten for code and
	4032	feedback on this.
	4033
	4034	**** Implement formulas applying to field ranges
	4035
	4036	Carsten implemented this field-ranges formulas.
	4037
	4038	: A frequently requested feature for tables has been to be able to define
	4039	: row formulas in a way similar to column formulas. The patch below allows
	4040	: things like
	4041	:
	4042	: @3=
	4043	: @2$2..@5$7=
	4044	: @I$2..@II$4=
	4045	:
	4046	: as the left hand side for table formulas in order to write a formula that
	4047	: is valid for an entire column or for a rectangular section in a
	4048	: table.
	4049
	4050	Thanks a lot to Carsten for this.
	4051
	4052	**** Sending radio tables from org buffers is now allowed
	4053
	4054	Org radio tables can no also be sent inside Org buffers. Also,
	4055	there is a new hook which get called after a table has been sent.
	4056
	4057	Thanks to Seweryn Kokot.
	4058
	4059	*** Lists
	4060
	4061	**** Improved handling of lists
	4062
	4063	Nicolas Goaziou extended and improved the way Org handles lists.
	4064
	4065	1. Indentation of text determines again end of items in
	4066	lists. So, some text less indented than the previous item
	4067	doesn't close the whole list anymore, only all items more
	4068	indented than it.
	4069
	4070	2. Alphabetical bullets are implemented, through the use of the
	4071	variable `org-alphabetical-lists'. This also adds alphabetical
	4072	counters like [@c] or [@W].
	4073
	4074	3. Lists can now safely contain drawers, inline tasks, or various
	4075	blocks, themselves containing lists. Two variables are
	4076	controlling this: `org-list-forbidden-blocks', and
	4077	`org-list-export-context'.
	4078
	4079	4. Improve `newline-and-indent' (C-j): used in an item, it will
	4080	keep text from moving at column 0. This allows to split text
	4081	and make paragraphs and still not break the list.
	4082
	4083	5. Improve `org-toggle-item' (C-c -): used on a region with
	4084	standard text, it will change the region into one item. With a
	4085	prefix argument, it will fallback to the previous behavior and
	4086	make every line in region an item. It permits to easily
	4087	integrate paragraphs inside a list.
	4088
	4089	6. `fill-paragraph' (M-q) now understands lists. It can freely be
	4090	used inside items, or on text just after a list, even with no
	4091	blank line around, without breaking list structure.
	4092
	4093	Thanks a lot to Nicolas for all this!
	4094
	4095	*** Inline display of linked images
	4096
	4097	Images can now be displayed inline. The key C-c C-x C-v does
	4098	toggle the display of such images. Note that only image links
	4099	that have no description part will be inlined.
	4100
	4101	*** Implement offsets for ordered lists
	4102
	4103	If you want to start an ordered plain list with a number different
	4104	from 1, you can now do it like this:
	4105
	4106	: 1. [@start:12] will star a lit a number 12
	4107
	4108	*** Babel: code block body expansion for table and preview
	4109
	4110	In org-babel, code is "expanded" prior to evaluation. I.e. the
	4111	code that is actually evaluated comprises the code block contents,
	4112	augmented with the extra code which assigns the referenced data to
	4113	variables. It is now possible to preview expanded contents, and
	4114	also to expand code during during tangling. This expansion takes
	4115	into account all header arguments, and variables.
	4116
	4117	A new keybinding `C-c M-b p' bound to `org-babel-expand-src-block'
	4118	can be used from inside of a source code block to preview its
	4119	expanded contents (which can be very useful for debugging).
	4120	tangling
	4121
	4122	The expanded body can now be tangled, this includes variable
	4123	values which may be the results of other source-code blocks, or
	4124	stored in headline properties or tables. One possible use for this
	4125	is to allow those using org-babel for their emacs initialization
	4126	to store values (e.g. usernames, passwords, etc...) in headline
	4127	properties or in tables.
	4128
	4129	Org-babel now supports three new header arguments, and new default
	4130	behavior for handling horizontal lines in tables (hlines), column
	4131	names, and rownames across all languages.
	4132
	4133	*** Editing Convenience and Appearance
	4134
	4135	**** New command =org-copy-visible= (=C-c C-x v=)
	4136
	4137	This command will copy the visible text in the region into the
	4138	kill ring. Thanks to Florian Beck for this function and to
	4139	Carsten for adding it to org.el and documenting it!
	4140
	4141	**** Make it possible to protect hidden subtrees from being killed by =C-k=
	4142
	4143	See the new variable =org-ctrl-k-protect-subtree=. This was a
	4144	request by Scott Otterson.
	4145
	4146	**** Implement pretty display of entities, sub-, and superscripts.
	4147
	4148	The command =C-c C-x \= toggles the display of Org's special
	4149	entities like =\alpha= as pretty unicode characters. Also, sub
	4150	and superscripts are displayed in a pretty way (raised/lower
	4151	display, in a smaller font). If you want to exclude sub- and
	4152	superscripts, see the variable
	4153	=org-pretty-entities-include-sub-superscripts=.
	4154
	4155	Thanks to Eric Schulte and Ulf Stegeman for making this possible.
	4156
	4157	**** New faces for title, date, author and email address lines
	4158
	4159	The keywords in these lines are now dimmed out, and the title is
	4160	displayed in a larger font, and a special font is also used for
	4161	author, date, and email information. This is implemented by the
	4162	following new faces:
	4163
	4164	=org-document-title=
	4165	=org-document-info=
	4166	=org-document-info-keyword=
	4167
	4168	In addition, the variable =org-hidden-keywords= can be used to
	4169	make the corresponding keywords disappear.
	4170
	4171	Thanks to Dan Davison for this feature.
	4172
	4173	**** Simpler way to specify faces for tags and todo keywords
	4174
	4175	The variables =org-todo-keyword-faces=, =org-tag-faces=, and
	4176	=org-priority-faces= now accept simple color names as
	4177	specifications. The colors will be used as either foreground or
	4178	background color for the corresponding keyword. See also the
	4179	variable =org-faces-easy-properties=, which governs which face
	4180	property is affected by this setting.
	4181
	4182	This is really a great simplification for setting keyword faces.
	4183	The change is based on an idea and patch by Ryan Thompson.
	4184
	4185	**** <N> in tables now means fixed width, not maximum width
	4186
	4187	Requested by Michael Brand.
	4188
	4189	**** Better level cycling function
	4190
	4191	=TAB= in an empty headline cycles the level of that headline
	4192	through likely states. Ryan Thompson implemented an improved
	4193	version of this function, which does not depend upon when exactly
	4194	this command is used. Thanks to Ryan for this improvement.
	4195
	4196	**** Adaptive filling
	4197
	4198	For paragraph text, =org-adaptive-fill-function= did not handle
	4199	the base case of regular text which needed to be filled. This is
	4200	now fixed. Among other things, it allows email-style ">"
	4201	comments to be filled correctly.
	4202
	4203	Thanks to Dan Hackney for this patch.
	4204
	4205	**** `org-reveal' (=C-c C-r=) also decrypts encrypted entries (org-crypt.el)
	4206
	4207	Thanks to Richard Riley for triggering this change.
	4208
	4209	**** Better automatic letter selection for TODO keywords
	4210
	4211	When all first letters of keywords have been used, Org now
	4212	assigns more meaningful characters based on the keywords.
	4213
	4214	Thanks to Mikael Fornius for this patch.
	4215
	4216	*** Clocking
	4217
	4218	**** Clock: Allow synchronous update of timestamps in CLOCK log
	4219
	4220	Using =S-M-<up/down>= on CLOCK log timestamps will
	4221	increase/decrease the two timestamps on this line so that
	4222	duration will keep the same. Note that duration can still be
	4223	slightly modified in case a timestamp needs some rounding.
	4224
	4225	Thanks to Rainer Stengele for this idea.
	4226
	4227	**** Localized clock tables
	4228
	4229	Clock tables now support a new new =:lang= parameter, allowing
	4230	the user to customize the localization of the table headers. See
	4231	the variable =org-clock-clocktable-language-setup= which controls
	4232	available translated strings.
	4233
	4234	**** Show clock overruns in mode line
	4235
	4236	When clocking an item with a planned effort, overrunning the
	4237	planned time is now made visible in the mode line, for example
	4238	using the new face =org-mode-line-clock-overrun=, or by adding an
	4239	extra string given by =org-task-overrun-text=.
	4240
	4241	Thanks to Richard Riley for a patch to this effect.
	4242
	4243	**** Clock reports can now include the running, incomplete clock
	4244
	4245	If you have a clock running, and the entry being clocked falls
	4246	into the scope when creating a clock table, the time so far spent
	4247	can be added to the total. This behavior depends on the setting
	4248	of =org-clock-report-include-clocking-task=. The default is
	4249	=nil=.
	4250
	4251	Thanks to Bernt Hansen for this useful addition.
	4252
	4253	*** Misc
	4254
	4255	**** Improvements with inline tasks and indentation
	4256
	4257	There is now a configurable way on how to export inline tasks.
	4258	See the new variable =org-inlinetask-export-templates=.
	4259
	4260	Thanks to Nicolas Goaziou for coding these changes.
	4261
	4262	**** A property value of "nil" now means to unset a property
	4263
	4264	This can be useful in particular with property inheritance, if
	4265	some upper level has the property, and some grandchild of it
	4266	would like to have the default settings (i.e. not overruled by a
	4267	property) back.
	4268
	4269	Thanks to Robert Goldman and Bernt Hansen for suggesting this
	4270	change.
	4271
	4272	**** New helper functions in org-table.el
	4273
	4274	There are new functions to access and write to a specific table field.
	4275	This is for hackers, and maybe for the org-babel people.
	4276
	4277	#+begin_example
	4278	org-table-get
	4279	org-table-put
	4280	org-table-current-line
	4281	org-table-goto-line
	4282	#+end_example
	4283
	4284	**** Archiving: Allow to reverse order in target node
	4285
	4286	The new option =org-archive-reversed-order= allows to have
	4287	archived entries inserted in a last-on-top fashion in the target
	4288	node.
	4289
	4290	This was requested by Tom.
	4291
	4292	**** Org-reveal: Double prefix arg shows the entire subtree of the parent
	4293
	4294	This can help to get out of an inconsistent state produced for
	4295	example by viewing from the agenda.
	4296
	4297	This was a request by Matt Lundin.
	4298
	4299	* License
	4300
	4301	This file is part of GNU Emacs.
	4302
	4303	GNU Emacs is free software: you can redistribute it and/or modify
	4304	it under the terms of the GNU General Public License as published by
	4305	the Free Software Foundation, either version 3 of the License, or
	4306	(at your option) any later version.
	4307
	4308	GNU Emacs is distributed in the hope that it will be useful,
	4309	but WITHOUT ANY WARRANTY; without even the implied warranty of
	4310	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	4311	GNU General Public License for more details.
	4312
	4313	You should have received a copy of the GNU General Public License
	4314	along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>.