Improve `org-fix-tags-on-the-fly'
[org-mode/org-tableheadings.git] / etc / ORG-NEWS
1 ORG NEWS -- history of user-visible changes.   -*- mode: org; coding: utf-8 -*-
3 #+STARTUP: overview
5 #+LINK: doc
6 #+LINK: git
8 Copyright (C) 2012-2018 Free Software Foundation, Inc.
9 See the end of the file for license conditions.
11 Please send Org bug reports to
13 * Version 9.2
14 ** Incompatible changes
15 *** Removal of OrgStruct mode mode and radio lists
17 OrgStruct minor mode and radio lists mechanism (~org-list-send-list~ and
18 ~org-list-radio-lists-templates~) are removed from the code base.
20 Note that only radio /lists/ have been removed, not radio tables.
22 If you want to manipulate lists like in Org in other modes, we suggest
23 to use orgalist.el, which you can install from GNU ELPA.
25 *** Change in the structure template expansion
27 Org 9.2 comes with a new template expansion mechanism, combining
28 ~org-insert-structure-template~ bound to ~C-c C-'~.
30 If you customized the ~org-structure-template-alist~ option manually,
31 you probably need to udpate it, see the docstring for accepted values.
33 If you prefer using previous patterns, e.g. =<s=, you can activate
34 them again by requiring Org Tempo library:
36 : (require 'org-tempo)
38 or add it to ~org-modules~.
40 If you need complex templates, look at the ~tempo-define-template~
41 function or at solutions like Yasnippet.
43 *** Change to Noweb expansion
45 Expansion check =:noweb-ref= only if no matching named block is found
46 in the buffer.  As a consequence, any =:noweb-ref= value matching the
47 name of a source block in the buffer is ignored. A simple fix is to
48 give every concerned source-block, including the named one, a new,
49 unique, Noweb reference.
51 #+BEGIN_SRC org
52   ,#+NAME: foo
53   ,#+BEGIN_SRC emacs-lisp
54     1
55   ,#+END_SRC
57   ,#+BEGIN_SRC emacs-lisp :noweb-ref foo
58     2
59   ,#+END_SRC
61   ,#+BEGIN_SRC emacs-lisp :noweb yes
62     <<foo>>
63   ,#+END_SRC
64 #+END_SRC
66 should become
68 #+BEGIN_SRC org
69   ,#+NAME: foo
70   ,#+BEGIN_SRC emacs-lisp :noweb-ref bar
71     1
72   ,#+END_SRC
74   ,#+BEGIN_SRC emacs-lisp :noweb-ref bar
75     2
76   ,#+END_SRC
78   ,#+BEGIN_SRC emacs-lisp :noweb yes
79     <<bar>>
80   ,#+END_SRC
81 #+END_SRC
83 *** Default/accepted values of ~org-calendar-to-agenda-key~
85 The default value and accepted value of  ~org-calendar-to-agenda-key~
86 changed.  This is an excerpt of the new docstring:
88 : When set to ‘default’, bind the function to ‘c’, but only if it is
89 : available in the Calendar keymap.  This is the default choice because
90 : ‘c’ can then be used to switch back and forth between agenda and calendar.
92 : When nil, ‘org-calendar-goto-agenda’ is not bound to any key.
94 Check the full docstring for more.
96 *** Change the signature of the ~org-set-effort~ function
98 Here is the new docstring:
100 : (org-set-effort &optional INCREMENT VALUE)
102 : Set the effort property of the current entry.
103 : If INCREMENT is non-nil, set the property to the next allowed
104 : value.  Otherwise, if optional argument VALUE is provided, use
105 : it.  Eventually, prompt for the new value if none of the previous
106 : variables is set.
108 *** Placeholders in =(eval ...)= macros are always strings
110 Within =(eval ...)= macros, =$1=-like placeholders are always replaced
111 with a string.  As a consequence, they must not be enclosed within
112 quotes. As an illustration, consider the following, now valid,
113 examples:
115 #+begin_example
116   ,#+macro: join (eval (concat $1 $2))
117   ,#+macro: sum (eval (+ (string-to-number $1) (string-to-number $2)))
119   {{{join(a,b)}}} => ab
120   {{{sum(1,2)}}}  => 3
121 #+end_example
123 However, there is no change in non-eval macros:
125 #+begin_example
126   ,#+macro: disp argument: $1
128   {{{disp(text)}}} => argument: text
129 #+end_example
131 *** =align= STARTUP value no longer narrow table columns
133 Columns narrowing (or shrinking) is now dynamic. See [[*Dynamically
134 narrow table columns]] for details. In particular, it is decoupled from
135 aligning.
137 If you need to automatically shrink columns upon opening an Org
138 document, use =shrink= value instead, or in addition to align:
141 ,#+STARTUP: align shrink
144 *** ~org-get-tags~ meaning change
146 Function ~org-get-tags~ used to return local tags to the current
147 headline.  It now returns all the inherited tags in addition to the
148 local tags.  In order to get the old behaviour back, you can use:
150 : (org-get-tags nil t)
152 *** Alphabetic sorting in tables and lists
154 When sorting alphabetically, ~org-table-sort-lines~ and ~org-sort-list~
155 now sort according to the locale’s collation rules instead of by
156 code-point.
158 *** Change the name of the :tags clocktable option to :match
160 The =:match= (renamed from =:tags=) option allows to limit clock entries
161 to those matching a todo-tags matcher.
163 The old =:tags= option can be set to =t= to display a headline's tags in a
164 dedicated column.
166 This is consistent with the naming of =org-dblock-write:columnview=
167 options, where =:match= is also used as a headlines filter.
169 ** New features
170 *** Add ~:results link~ support for Babel
172 With this output format, create a link to the file specified in
173 ~:file~ header argument, without actually writing any result to it:
175 #+begin_example
176 ,#+begin_src shell :dir "data/tmp" :results link :file "crackzor_1.0.c.gz"
177 wget -c ""
178 ,#+end_src
180 ,#+results:
181 [[file:data/tmp/crackzor_1.0.c.gz]]
182 #+end_example
184 *** Add ~:session~ support of ob-js for js-comint
185 #+begin_src js :session "*Javascript REPL*"
186 console.log("stardiviner")
187 #+end_src
188 *** Add ~:session~ support of ob-js for Indium
189 #+begin_src js :session "*JS REPL*"
190 console.log("stardiviner")
191 #+end_src
192 *** Add ~:session~ support of ob-js for skewer-mode
193 #+begin_src js :session "*skewer-repl*"
194 console.log("stardiviner")
195 #+end_src
196 *** Add support for links to LaTeX equations in HTML export
197 Use MathJax links when enabled (by ~org-html-with-latex~), otherwise
198 add a label to the rendered equation.
199 *** Org Tempo may used for snippet expansion of structure template.
200 See manual and the commentary section in ~org-tempo.el~ for details.
201 *** Exclude unnumbered headlines from table of contents
202 Set their =UNNUMBERED= property to the special =notoc= value.  See
203 manual for details.
204 *** ~org-archive~ functions update status cookies
206 Archiving headers through ~org-archive-subtree~ and
207 ~org-archive-to-archive-sibling~ such as the ones listed below:
209 #+BEGIN_SRC org
210   ,* Top [1/2]
211   ,** DONE Completed
212   ,** TODO Working
213 #+END_SRC
215 Will update the status cookie in the top level header.
217 *** Disable =org-agenda-overriding-header= by setting to empty string
219 The ~org-agenda-overriding-header~ inserted into agenda views can now
220 be disabled by setting it to an empty string.
222 *** Dynamically narrow table columns
224 With ~C-c TAB~, it is now possible to narrow a column to the width
225 specified by a width cookie in the column, or to 1 character if there
226 is no such cookie.  The same keybinding expands a narrowed column to
227 its previous state.
229 Editing the column automatically expands the whole column to its full
230 size.
232 *** =org-columns-summary-types= entries can take an optional COLLECT function
234 You can use this to make collection of a property from an entry
235 conditional on another entry. E.g. given this configuration:
237 #+BEGIN_SRC emacs-lisp
238   (defun custom/org-collect-confirmed (property)
239     "Return `PROPERTY' for `CONFIRMED' entries"
240     (let ((prop (org-entry-get nil property))
241           (confirmed (org-entry-get nil "CONFIRMED")))
242       (if (and prop (string= "[X]" confirmed))
243           prop
244         "0")))
246   (setq org-columns-summary-types
247         '(("X+" org-columns--summary-sum
248            custom/org-collect-confirmed)))
249 #+END_SRC
251 You can have a file containing:
253 #+BEGIN_SRC org
254   ,#+columns: %ITEM %CONFIRMED %Bananas{+} %Bananas(Confirmed Bananas){X+}
256   ,* All shipments
257   ,** Shipment 1
258      :PROPERTIES:
259      :CONFIRMED: [X]
260      :Bananas:  4
261      :END:
263   ,** Shipment 2
264      :PROPERTIES:
265      :CONFIRMED: [ ]
266      :BANANAS:  7
267      :END:
268 #+END_SRC
270 ... and when going to the top of that file and entering column view
271 you should expect to see something like:
273 | ITEM          | CONFIRMED | Bananas | Confirmed Bananas |
274 |---------------+-----------+---------+-------------------|
275 | All shipments |           |      11 |                 4 |
276 | Shipment 1    | [X]       |       4 |                 4 |
277 | Shipment 2    | [ ]       |       7 |                 7 |
280   ,#+STARTUP: shrink
282 *** Allow to filter by tags/property when capturing colview
284 You can now use =:match= to filter entries using a todo/tags/properties
285 matcher.
287 *** Add support for Oracle's database alias in Babel blocks
288 =ob-sql= library already support running SQL blocks against an Oracle
289 database using ~sqlplus~.  Now it's possible to use alias names
290 defined in =TNSNAMES= file instead of specifying full connection
291 parameters.  See example bellow.
293 #+BEGIN_SRC org
294   you can use the previous full connection parameters
295   ,#+BEGIN_SRC sql :engine oracle :dbuser me :dbpassword my_insecure_password :database my_db_name :dbhost my_db_host :dbport 1521
296   select sysdate from dual;
297   ,#+END_SRC
299   or the alias defined in your TNSNAMES file
300   ,#+BEGIN_SRC sql :engine oracle :dbuser me :dbpassword my_insecure_password :database my_tns_alias
301   select sysdate from dual;
302   ,#+END_SRC
303 #+END_SRC
305 *** ~org-agenda-set-restriction-lock~ toggle agenda restriction at point
307 You can set an agenda restriction lock with =C-x C-x <= or with =<= at the
308 beginning of a headline when using Org speed commands.  Now, if there
309 is already a restriction at point, hitting =<= again (or =C-x C-x <=) will
310 remove it.
312 ** New commands and functions
314 *** ~org-insert-structure-template~
316 This function can be used to wrap existing text of Org elements in
317 a #+BEGIN_FOO/#+END_FOO block.  Bound to C-c C-x w by default.
319 *** ~org-export-excluded-from-toc-p~
321 See docstring for details.
323 *** ~org-timestamp-to-time~
324 *** ~org-timestamp-from-string~
325 *** ~org-timestamp-from-time~
326 *** ~org-attach-dired-to-subtree~
328 See docstring for details.
330 *** ~org-toggle-narrow-to-subtree~
332 Toggle the narrowing state of the buffer: when in a narrowed state,
333 widen, otherwise call ~org-narrow-to-subtree~ to narrow.
335 This is attached to the "s" speed command, so that hitting "s" twice
336 will go back to the widen state.
338 ** Removed commands and functions
339 *** ~org-outline-overlay-data~
340 Use ~org-save-outline-visibility~ instead.
341 *** ~org-set-outline-overlay-data~
342 Use ~org-save-outline-visibility~ instead.
343 *** ~org-get-string-indentation~
344 It was not used throughout the code base.
345 *** ~org-fix-indentation~
346 It was not used throughout code base.
347 *** ~org-context-p~
348 Use ~org-element-at-point~ instead.
349 *** ~org-try-structure-completion~
350 Org Tempo may be used as a replacement.  See details above.
351 ** Removed options
353 *** org-babel-use-quick-and-dirty-noweb-expansion
355 See [[*Change to Noweb expansion][Change to Noweb expansion]] for explanations.
357 ** Miscellaneous
359 *** New default value for ~org-texinfo-table-scientific-notation~
361 It is now nil, which means numbers in scientific notation are not
362 handled specially by default.
364 *** New default value for ~org-latex-table-scientific-notation~
366 It is now nil, which means numbers in scientific notation are not
367 handled specially by default.
369 *** New face: ~org-upcoming-distant-deadline~
371 It is meant to be used as the face for distant deadlines, see
372 ~org-agenda-deadline-faces~
374 *** ~org-paste-subtree~ no longer breaks sections
376 Unless point is at the beginning of a headline, ~org-paste-subtree~
377 now pastes the tree before the next visible headline.  If you need to
378 break the section, use ~org-yank~ instead.
380 *** ~org-table-insert-column~ inserts a column to the right
382 It used to insert it on the left.  With this change,
383 ~org-table-insert-column~ and ~org-table-delete-column~ are
384 reciprocal.
386 *** ~org-publish-resolve-external-link~ accepts a new optional argument.
387 *** ~org-irc.el~ now supports exporting =irc:= links properly
389 Previously, irc links were exported by ~ox-md~ and ~ox-html~ as normal
390 file links, which lead to them being broken in web browsers. Now both
391 of these exporters will properly export to =irc:= links, which will
392 open properly in irc clients from web browsers.
394 *** ~org-comment-dwim~ (bound to =M-;=) now comments headings, if point is on a heading
395 *** Add support for open source block in window below
397 Set option ~org-src-window-setup~ to ~split-window-below~.
399 *** Alphabetic sorting in headings and tags now uses the locale’s sorting rules
401 When sorting alphabetically, ~org-sort-entries~ and
402 ~org-tags-sort-function~ now sort according to the locale’s collation
403 rules instead of by code-point.
404 *** New speed command "k" to kill (cut) the subtree at point
405 * Version 9.1
407 ** Incompatible changes
409 *** Variables relative to clocksum duration are obsolete
411 ~org-time-clocksum-format~, ~org-time-clocksum-use-fractional~ and
412 ~org-time-clocksum-fractional-format~ are obsolete.  If you changed
413 them, consider modifying ~org-duration-format~ instead.
415 Variable ~org-time-clocksum-use-effort-durations~ is also obsolete.
416 Consider setting ~org-duration-units~ instead.
418 *** ~org-at-timestamp-p~ optional argument accepts different values
420 See docstrings for the allowed values.  For backward compatibility,
421 ~(org-at-timestamp-p t)~ is still supported, but should be updated
422 accordingly.
424 *** ~org-capture-templates~ no longer accepts S-expressions as file names
426 Since functions are allowed there, a straightforward way to migrate
427 is to turn, e.g.,
429 : (file (sexp))
431 into
433 : (file (lambda () (sexp)))
435 *** Deleted contributed packages
437 =org-ebib.el, =org-bullets.el= and =org-mime.el= have been deleted
438 from the contrib/ directory.
440 You can now find them here :
442 -
443 -
444 -
446 *** Change ~org-texinfo-classes~ value
447 The value cannot support functions to create sectioning commands
448 anymore.  Also, the sectioning commands should include commands for
449 appendices.  See the docstring for more information.
450 *** Removal of ~:sitemap-sans-extension~
452 The publishing property is no longer recognized, as a consequence of
453 changes to site-map generation.
455 You can get the same functionality by setting ~:sitemap-format-entry~
456 to the following
458 #+BEGIN_SRC elisp
459 (lambda (entry style project)
460   (cond ((not (directory-name-p entry))
461          (format "[[file:%s][%s]]"
462                  (file-name-sans-extension entry)
463                  (org-publish-find-title entry project)))
464         ((eq style 'tree) (file-name-nondirectory (directory-file-name entry)))
465         (t entry)))
466 #+END_SRC
468 *** Change signature for ~:sitemap-function~
470 ~:sitemap-function~ now expects to be called with two arguments.  See
471 ~org-publish-project-alist~ for details.
473 *** Change signature for some properties in ~org-list-to-generic~
475 ~:istart~, ~:icount~, ~:iend~ and ~:isep~ now expect the type of the
476 list as their first argument.
478 *** Change signature for ~org-get-repeater~
479 The optional argument is now a string to extract the repeater from.
480 See docstring for details.
482 *** Change signature for ~org-time-string-to-time~
483 See docstring for changes.
485 *** Change order of items in ~org-agenda-time-grid~
486 ~org-agenda-time-grid~ gained an extra item to allow users to customize
487 the string displayed after times in the agenda. See docstring for
488 details.
490 *** ~tags-todo~ custom searches now include DONE keywords
492 Use "/!" markup when filtering TODO keywords to get only not-done TODO
493 keywords.
495 *** ~org-split-string~ returns ~("")~ when called on an empty string
496 It used to return nil.
497 *** Removal of =ob-scala.el=
499 See [[][this github issue]].
501 You can use =ob-scala.el= as packaged in scala-mode, available from the
502 MELPA repository.
504 ** New features
505 *** iCalendar export uses inheritance for TIMEZONE and LOCATION properties
506 Both these properties can be inherited during iCalendar export,
507 depending on the value of ~org-use-property-inheritance~.
508 *** iCalendar export respects a TIMEZONE property
509 Set the TIMEZONE property on an entry to specify a time zone for that
510 entry only during iCalendar export.  The property value should be
511 specified as in "Europe/London".
512 *** ~org-attach~ can move directory contents
513 When setting a new directory for an entry, org-attach offers to move
514 files over from the old directory.  Using a prefix arg will reset the
515 directory to old, ID based one.
516 *** New Org duration library
517 This new library implements tools to read and print time durations in
518 various formats (e.g., "H:MM", or "1d 2h 3min"...).
520 See ~org-duration-to-minutes~ and ~org-duration-from-minutes~
521 docstrings.
523 *** Agenda
524 **** New variable : ~org-agenda-show-future-repeats~
525 **** New variable : ~org-agenda-prefer-last-repeat~
526 **** New variable : ~org-deadline-past-days~
527 See docstring for details.
528 **** Binding C-c C-x < for ~org-agenda-set-restriction-lock-from-agenda~
529 **** New auto-align default setting for =org-agenda-tags-column=
531 =org-agenda-tags-column= can now be set to =auto=, which will
532 automatically align tags to the right edge of the window.  This is now
533 the default setting.
534 *** New value for ~org-publish-sitemap-sort-folders~
536 The new ~ignore~ value effectively allows toggling inclusion of
537 directories in published site-maps.
539 *** Babel
541 **** Scheme: support for tables
542 **** Scheme: new variable: ~org-babel-scheme-null-to~
544 This new custom option allows you to use an empty list or null symbol to
545 format the table output, initially assigned to ~hlines~.
547 **** Scheme: new header ~:prologue~
549 A new block code header has been created for Org Babel that enables
550 developers to prepend code to the scheme block being processed.
552 Multiple ~:prologue~ headers can be added each of them using a string
553 with the content to be added.
555 The scheme blocks are prepared by surrounding the code in the block
556 with a let form. The content of the ~:prologue~ headers are prepended
557 before this let form.
559 **** Support for hledger accounting reports added
560 **** Clojure: new setting ~org-babel-clojure-sync-nrepl-timeout~
562 Creation of a new setting to specify the Cider timeout.  By setting
563 the =org-babel-clojure-sync-nrepl-timeout= setting option.  The value
564 is in seconds and if set to =nil= then no timeout will occur.
565 **** Clojure: new header ~:show-process~
567 A new block code header has been created for Org Babel that enables
568 developers to output the process of an ongoing process into a new
569 window/buffer.
571 You can tell Org Babel to output the process of a running code block.
573 To show that output you only have to specify the =:show-process=
574 option in the code block's header like this:
576 #+begin_example
577 ,#+BEGIN_SRC clojure :results output :show-process t
578   (dotimes [n 10]
579     (println n ".")
580     (Thread/sleep 500))
581 ,#+END_SRC
582 #+end_example
584 If =:show-process= is specified that way, then when you will run the
585 code using =C-c C-c= a new window will open in Emacs.  Everything that
586 is output by the REPL will immediately be added to that new window.
588 When the processing of the code is finished, then the window and its
589 buffer will be closed and the results will be reported in the
590 =#+RESULTS= section.
592 Note that the =:results= parameter's behavior is *not* changed.  If
593 =silent= is specified, then no result will be displayed.  If =output=
594 is specified then all the output from the window will appears in the
595 results section.  If =value= is specified, then only the last returned
596 value of the code will be displayed in the results section.
598 **** Maxima: new headers ~:prologue~ and ~:epilogue~
599 Babel options ~:prologue~ and ~:epilogue~ have been implemented for
600 Maxima src blocks which prepend and append, respectively, the given
601 code strings.  This can be useful for specifying formatting settings
602 which would add clutter to exported code.  For instance, you can use
603 this ~:prologue "fpprintprec: 2; linel: 50;"~ for presenting Maxima
604 results in a beamer presentation.
605 **** PlantUML: add support for header arguments
607 [[][Plantuml]] source blocks now support the [[][~:prologue~]], [[][~:epilogue~]] and
608 [[][~:var~]] header arguments.
610 **** SQL: new engine added ~sqsh~
612 A new engine was added to support ~sqsh~ command line utility for use
613 against Microsoft SQL Server or Sybase SQL server.
615 More information on ~sqsh~ can be found here: [[][sourceforge/sqsh]]
617 To use ~sqsh~ in an *sql* =SRC_BLK= set the =:engine= like this:
619 #+begin_example
620 ,#+BEGIN_SRC sql :engine sqsh :dbhost my_host :dbuser master :dbpassword pass :database support
621 Select * From Users
622 Where clue > 0
623 ,#+END_SRC
624 #+end_example
626 **** SQL: new engine added =vertica=
628 A new engine was added to support vsql command line utility for use
629 against HP Vertica.
631 More information on =vsql= can be found here: [[][]]
633 To use =vertica= in an sql =SRC_BLK= set the =:engine= like this:
636   ,#+BEGIN_SRC sql :engine vertica :dbhost my_host :dbuser dbadmin :dbpassword pw :database vmart
637   SELECT * FROM nodes;
638   ,#+END_SRC
640 **** C++: New header ~:namespaces~
642 The new ~:namespaces~ export option can be used to specify namespaces
643 to be used within a C++ org source block.  Its usage is similar to
644 ~:includes~, in that it can accept multiple, space-separated
645 namespaces to use.  This header is equivalent to adding ~using
646 namespace <name>;~ in the source block. Here is a "Hello World" in C++
647 using ~:namespaces~:
649 #+begin_example
650   ,#+BEGIN_SRC C++ :results output :namespaces std :includes <iostream>
651     cout << "Hello World" << endl;
652   ,#+END_SRC
653 #+end_example
655 **** Support for Vala language
657 [[][Vala]] language blocks support two special header arguments:
659 - ~:flags~ passes arguments to the compiler
660 - ~:cmdline~ passes commandline arguments to the generated executable
662 Support for [[][~:var~]] does not exist yet, also there is no [[][~:session~]]
663 support because Vala is a compiled language.
665 The Vala compiler binary can be changed via the ~defcustom~
666 ~org-babel-vala-compiler~.
668 *** New ~function~ scope argument for the Clock Table
669 Added a nullary function that returns a list of files as a possible
670 argument for the scope of the clock table.
671 *** Export
672 **** Implement vernacular table of contents in Markdown exporter
673 Global table of contents are generated using vanilla Markdown syntax
674 instead of HTML.  Also #+TOC keyword, including local table of
675 contents, are now supported.
676 **** Add Slovenian translations
677 **** Implement ~org-export-insert-image-links~
678 This new function is meant to be used in back-ends supporting images
679 as descriptions of links, a.k.a. image links.  See its docstring for
680 details.
681 **** New macro : ~{{{n}}}~
682 This macro creates and increment multiple counters in a document.  See
683 manual for details.
684 **** Add global macros through ~org-export-global-macros~
685 With this variable, one can define macros available for all documents.
686 **** New keyword ~#+EXPORT_FILE_NAME~
687 Similarly to ~:EXPORT_FILE_NAME:~ property, this keyword allows the
688 user to specify the name of the output file upon exporting the
689 document.  This also has an effect on publishing.
690 **** Horizontal rules are no longer ignored in LaTeX table math mode
691 **** Use ~compilation-mode~ for compilation output
692 **** Plain lists accept a new ~:separator~ attribute in Texinfo
694 The new ~:separator~ attribute splits a tag from a description list
695 item into multiple parts.  This allows to have two-column tables with
696 multiple entries in the first column.  See manual for more details.
698 **** ~latex-environment~ elements support ~caption~ keywords for LaTeX export
699 *** ~org-edit-special~ can edit LaTeX environments
701 Using ~C-c '~ on a LaTeX environment opens a sub-editing buffer.  By
702 default, major mode in that buffer is ~latex-mode~, but it can be
703 changed by configuring ~org-src-lang-modes~.
705 *** ~org-list-to-generic~ includes a new property: ~:ifmt~
707 ~:ifmt~ is a function to be called on the body of each item.  See
708 ~org-list-to-generic~ documentation for details.
710 *** New variable : ~org-bibtex-headline-format-function~
711 This allow to use a different title than entry title.
713 *** ~org-attach~ supports attaching files from URLs
715 Using ~C-c C-a u~ prompts for a URL pointing to a file to be attached
716 to the document.
718 *** New option for ~org-refile-use-outline-path~
719 ~org-refile-use-outline-path~ now supports the setting ~buffer-name~,
720 which causes refile targets to be prefixed with the buffer’s
721 name. This is particularly useful when used in conjunction with
722 ~uniquify.el~.
724 *** ~org-file-contents~ now allows the FILE argument to be a URL.
725 This allows ~#+SETUPFILE:~ to accept a URL instead of a local file
726 path.  The URL contents are auto-downloaded and saved to a temporary
727 cache ~org--file-cache~.  A new optional argument ~NOCACHE~ is added
728 to ~org-file-contents~.
730 *** ~org-mode-restart~ now resets the newly added ~org--file-cache~.
731 Using ~C-c C-c~ on any keyword (like ~#+SETUPFILE~) will reset the
732 that file cache.
734 *** New option : ~org-table-duration-hour-zero-padding~
735 This variable allow computed durations in tables to be zero-padded.
737 *** New mode switch for table formulas : =U=
738 This mode omits seconds in durations.
740 ** Removed functions
742 *** Org Timeline
744 This feature has been removed.  Use a custom agenda view, possibly
745 narrowed to current buffer to achieve a similar functionality.
747 *** ~org-agenda-skip-entry-when-regexp-matches~ is obsolete
749 Use ~org-agenda-skip-if~ instead.
751 *** ~org-agenda-skip-subtree-when-regexp-matches~ is obsolete
753 Use ~org-agenda-skip-if~ instead.
755 *** ~org-agenda-skip-entry-when-regexp-matches-in-subtree~ is obsolete
757 Use ~org-agenda-skip-if~ instead.
759 *** ~org-minutes-to-clocksum-string~ is obsolete
761 Use ~org-duration-from-minutes~ instead.
763 *** ~org-hh:mm-string-to-minutes~ is obsolete
765 Use ~org-duration-to-minutes~ instead.
767 *** ~org-duration-string-to-minutes~ is obsolete
769 Use ~org-duration-to-minutes~ instead.
771 *** ~org-gnus-nnimap-cached-article-number~ is removed.
773 This function relied on ~nnimap-group-overview-filename~, which was
774 removed from Gnus circa September 2010.
776 ** Removed options
778 *** ~org-agenda-repeating-timestamp-show-all~ is removed.
780 For an equivalent to a ~nil~ value, set
781 ~org-agenda-show-future-repeats~ to nil and
782 ~org-agenda-prefer-last-repeat~ to ~t~.
784 *** ~org-gnus-nnimap-query-article-no-from-file~ is removed.
786 This variable has no effect, as it was relying on a function that was
787 removed from Gnus circa September 2010.
789 *** ~org-usenet-links-prefer-google~ is obsolete.
791 Use ~org-gnus-prefer-web-links~ instead.
793 *** ~org-publish-sitemap-file-entry-format~ is deprecated
795 One can provide new ~:sitemap-format-entry~ property for a function
796 equivalent to the removed format string.
798 *** ~org-enable-table-editor~ is removed.
800 Setting it to a ~nil~ value broke some other features (e.g., speed
801 keys).
803 *** ~org-export-use-babel~ cannot be set to ~inline-only~
805 The variable is now a boolean.
807 *** ~org-texinfo-def-table-markup~ is obsolete
809 Use ~org-texinfo-table-default-markup~ instead.
811 ** New functions
813 *** ~org-publish-find-property~
815 This function can be used as a tool to format entries in a site-map,
816 in addition to ~org-publish-find-title~ and ~org-publish-find-date~.
818 *** ~org-list-to-org~
820 It is the reciprocal of ~org-list-to-lisp~, which see.
822 *** ~org-agenda-set-restriction-lock-from-agenda~
824 Call ~org-agenda-set-restriction-lock~ from the agenda.
826 ** Miscellaneous
828 *** The Library of Babel now on Worg
830 The used to be accessible from the =doc/=
831 directory, distributed with Org’s core.  It is now accessible
832 from the Worg community-driven documentation [[][here]].
834 If you want to contribute to it, please see [[][how to contribute]].
836 *** Allow multiple columns view
838 Columns view is not limited to a single buffer anymore.
839 *** Org Attach obeys ~dired-dwim-target~
841 When a Dired buffer is opened next to the Org document being edited,
842 the prompt for file to attach can start in the Dired buffer's
843 directory if `dired-dwim-target' in non-nil.
845 *** ~org-fill-paragraph~ can now fill a whole region
846 *** More specific anniversary descriptions
848 Anniversary descriptions (used in the agenda view, for instance)
849 include the point in time, when the anniversary appears.  This is,
850 in its most general form, just the date of the anniversary.  Or
851 more specific terms, like "today", "tomorrow" or "in n days" are
852 used to describe the time span.
854 This feature allows to automatically change the description of an
855 anniversary, depending on if it occurs in the next few days or
856 far away in the future.
858 *** Computed dates in tables appear as inactive time stamps
860 *** Save point before opening a file with an unknown search option
862 When following a file link with a search option (e.g., =::#custom-id=)
863 that doesn't exist in the target file, save position before raising an
864 error.  As a consequence, it is possible to jump back to the original
865 document with ~org-mark-ring-goto~ (default binding =C-c &=).
867 *** ~org-get-heading~ accepts two more optional arguments
869 See docstring for details.
871 *** New option ~org-babel-uppercase-example-markers~
873 This variable is a ~defcustom~ and replaces the variable
874 ~org-babel-capitalize-example-region-markers~, which is a ~defvar~ and
875 is now obsolete.
876 *** =INCLUDE= keywords in commented trees are now ignored.
877 *** Default value for ~org-texinfo-text-markup-alist~ changed.
879 Now ~=...=~ markup uses ~@samp{}~ instead of ~@verb{}~.  You can use
880 ~@verb{}~ again by customizing the variable.
881 *** Texinfo exports example blocks as ~@example~
882 *** Texinfo exports inline src blocks as ~@code{}~
883 *** Texinfo default table markup is ~@asis~
884 It used to be ~@samp~ but ~@asis~ is neutral and, therefore, more
885 suitable as a default value.
886 *** Texinfo default process includes ~--no-split~ option
887 *** New entities : ~\dollar~ and ~\USD~
888 *** Support for date style URLs in =org-protocol://open-source=
889     URLs like = are
890     covered by rewrite rules.
892 *** Add (C) =COMMENT= support to ~org-structure-template-alist~
894 * Version 9.0
896 ** Incompatible changes
898 *** Emacs 23 support has been dropped
900 From now on, Org expects at least Emacs 24.3, although Emacs 24.4 or
901 above is suggested.
903 *** XEmacs support has been dropped
905 Incomplete compatibility layer with XEmacs has been removed.  If you
906 want to take over maintenance of this compatibility, please contact
907 our mailing list.
909 *** New syntax for export blocks
911 Export blocks are explicitly marked as such at the syntax level to
912 disambiguate their parsing from special blocks.  The new syntax is
914 #+BEGIN_SRC org
915 ,#+BEGIN_EXPORT backend
918 #+END_SRC
920 instead of
922 #+BEGIN_SRC org
923 ,#+BEGIN_backend
925 ,#+END_backend
926 #+END_SRC
928 As a consequence, =INCLUDE= keywords syntax is modified, e.g.,
930 #+BEGIN_SRC org
931 ,#+INCLUDE: "" HTML
932 #+END_SRC
934 becomes
936 #+BEGIN_SRC org
937 ,#+INCLUDE: "" export html
938 #+END_SRC
940 The following function repairs export blocks and =INCLUDE= keywords
941 using previous syntax:
943 #+BEGIN_SRC emacs-lisp
944 (defun org-repair-export-blocks ()
945   "Repair export blocks and INCLUDE keywords in current buffer."
946   (interactive)
947   (when (eq major-mode 'org-mode)
948     (let ((case-fold-search t)
949           (back-end-re (regexp-opt
950                         '("HTML" "ASCII" "LATEX" "ODT" "MARKDOWN" "MD" "ORG"
951                           "MAN" "BEAMER" "TEXINFO" "GROFF" "KOMA-LETTER")
952                         t)))
953       (org-with-wide-buffer
954        (goto-char (point-min))
955        (let ((block-re (concat "^[ \t]*#\\+BEGIN_" back-end-re)))
956          (save-excursion
957            (while (re-search-forward block-re nil t)
958              (let ((element (save-match-data (org-element-at-point))))
959                (when (eq (org-element-type element) 'special-block)
960                  (save-excursion
961                    (goto-char (org-element-property :end element))
962                    (save-match-data (search-backward "_"))
963                    (forward-char)
964                    (insert "EXPORT")
965                    (delete-region (point) (line-end-position)))
966                  (replace-match "EXPORT \\1" nil nil nil 1))))))
967        (let ((include-re
968               (format "^[ \t]*#\\+INCLUDE: .*?%s[ \t]*$" back-end-re)))
969          (while (re-search-forward include-re nil t)
970            (let ((element (save-match-data (org-element-at-point))))
971              (when (and (eq (org-element-type element) 'keyword)
972                         (string= (org-element-property :key element) "INCLUDE"))
973                (replace-match "EXPORT \\1" nil nil nil 1)))))))))
974 #+END_SRC
976 Moreover, ~:export-block~ keyword used in ~org-export-define-backend~ and
977 ~org-export-define-derived-backend~ is no longer used and needs to be
978 removed.
980 *** Footnotes
982 **** [1]-like constructs are not valid footnotes
984 Using =[1]= as a footnote was already discouraged in the manual, since
985 it introduced too many false-positives in many Org documents.  These
986 constructs are now unsupported.
988 If you used =[N]= in some of your documents, consider turning them into
989 =[fn:N]=.
991 **** /Org Footnote/ library doesn't handle non-Org buffers
993 Commands for footnotes in an Org document no longer try to do
994 something in non-Org ones.  If you need to have footnotes there,
995 consider using the =footnote.el= library, shipped with Emacs.
997 In particular, ~org-footnote-tag-for-non-org-mode-files~ no longer
998 exists.
1000 *** ~org-file-apps~ no longer accepts S-expressions as commands
1002 The variable now accepts functions of two arguments instead of plain
1003 S-expressions.  Replacing an S-expression with an appropriate function
1004 is straightforward.  For example
1006 : ("pdf" . (foo))
1008 becomes
1010 : ("pdf" . (lambda (file link) (foo)))
1012 *** The ~{{{modification-time}}}~ macro can get time via =vc=
1014 The modification time will be determined via =vc.el= if the second
1015 argument is non-nil.  See the manual for details.
1017 *** Preparation and completion functions in publishing projects change signature
1019 Preparation and completion functions are now called with an argument,
1020 which is the project property list.  It used to be dynamically scoped
1021 through the ~project-plist~ variable.
1023 *** Old Babel header properties are no longer supported
1025 Using header arguments as property names is no longer possible.  As
1026 such, the following
1029 ,* Headline
1031 :exports: code
1032 :var: a=1 b=2
1033 :var+: c=3
1034 :END:
1037 should be written instead
1040 ,* Headline
1042 :header-args: :exports code
1043 :header-args+: :var a=1 b=2
1044 :header-args+: :var c=3
1045 :END:
1048 Please note that, however, old properties were defined at the source
1049 block definition.  Current ones are defined where the block is called.
1051 ** New features
1053 *** ~org-eww~ has been moved into core
1054 *** New org-protocol key=value syntax
1056 Org-protocol can now handle query-style parameters such as:
1058 #+begin_example
1059 org-protocol://store-link?url=http:%2F%2Flocalhost%2Findex.html&title=The%20title
1060 org-protocol://capture?template=x&title=Hello&body=World&
1061 #+end_example
1063 Old-style links such as
1064 : org-protocol://store-link:/http:%2F%2Flocalhost%2Findex.html/The%20title
1065 continue to be supported.
1067 If you have defined your own handler functions for
1068 ~org-protocol-protocol-alist~, change them to accept either a property
1069 list (for new-style links) or a string (for old-style links).  Use
1070 ~org-protocol-parse-parameters~ to convert old-style links into property
1071 lists.
1073 *** New Org linter library
1075 ~org-lint~ can check syntax and report common issues in Org documents.
1077 *** New option ~date-tree-last~ for ~org-agenda-insert-diary-strategy~
1079 When ~org-agenda-insert-diary-strategy~ is set to ~date-tree-last~, diary
1080 entries are added to last in the date tree.
1082 *** New ~vbar~ entity
1084 ~\vbar~ or ~\vbar{}~ will be exported unconditionally as a =|=,
1085 unlike to existing ~\vert~, which is expanded as ~&vert;~ when using
1086 a HTML derived export back-end.
1088 *** Export
1090 **** New =#+latex_compiler= keyword to set LaTeX compiler.
1092 PDFLaTeX, XeLaTeX, and LuaLaTeX are supported.  See the manual for
1093 details.
1095 **** New option ~org-export-with-broken-links~
1097 This option tells the export process how to behave when encountering
1098 a broken internal link.  See its docstring for more information.
1100 **** Attributes support in custom language environments for LaTeX export
1102 Custom language environments for LaTeX export can now define the
1103 string to be inserted during export, using attributes to indicate the
1104 position of the elements. See variable ~org-latex-custom-lang-environments~
1105 for more details.
1107 **** New Texinfo ~options~ attribute on special blocks
1109 Using ~:options~ as a Texinfo attribute, it is possible to add
1110 information to custom environments.  See manual for details.
1112 **** New HTML ~id~ attributes on special, example and quote blocks
1114 If the block has a =#+NAME:= attribute assigned, then the HTML element
1115 will have an ~id~ attribute with that name in the HTML export. This
1116 enables one to create links to these elements in other places, e.g.,
1117 ~<a href="#name">text</a>~.
1119 **** Listings with captions are now numbered in HTML export
1121 The class associated to the numbering is "listing-number".  If you
1122 don't want these blocks to be numbered, as it was the case until now,
1123 You may want to add ~.listing-number { display: none; }~ to the CSS
1124 used.
1126 **** Line Numbering in SRC/EXAMPLE blocks support arbitrary start number
1128 The ~-n~ option to ~SRC~ and ~EXAMPLE~ blocks can now take a numeric
1129 argument to specify the staring line number for the source or example
1130 block.  The ~+n~ option can now take a numeric argument that will be
1131 added to the last line number from the previous block as the starting
1132 point for the SRC/EXAMPLE block.
1134 #+BEGIN_SRC org
1135 ,#+BEGIN_SRC emacs-lisp -n 20
1136 ;; this will export with line number 20
1137 (message "This is line 21")
1138 ,#+END_SRC
1139 ,#+BEGIN_SRC emacs-lisp +n 10
1140 ;; This will be listed as line 31
1141 (message "This is line 32")
1142 ,#+END_SRC
1143 #+END_SRC
1145 **** Allow toggling center for images in LaTeX export
1147 With the global variable ~org-latex-images-centered~ or the local
1148 attribute ~:center~ it is now possible to center an image in LaTeX
1149 export.
1151 **** Default CSS class ~org-svg~ for SVG images in HTML export
1153 SVG images exported in HTML are now by default assigned a CSS class
1154 ~org-svg~ if no CSS class is specified with the ~:class~ attribute. By
1155 default, the CSS styling of class ~org-svg~ specifies an image width of
1156 90\thinsp{}% of the container the image.
1158 **** Markdown footnote export customization
1160 Variables ~org-md-footnotes-section~ and ~org-md-footnote-format~
1161 introduced for =ox-md.el=.  Both new variables define template strings
1162 which can be used to customize the format of the exported footnotes
1163 section and individual footnotes, respectively.
1165 *** Babel
1167 **** Blocks with coderefs labels can now be evaluated
1169 The labels are removed prior to evaluating the block.
1171 **** Support for Lua language
1172 **** Support for SLY in Lisp blocks
1174 See ~org-babel-lisp-eval-fn~ to activate it.
1176 **** Support for Stan language
1178 New ob-stan.el library.
1180 Evaluating a Stan block can produce two different results.
1182 1. Dump the source code contents to a file.
1184    This file can then be used as a variable in other blocks, which
1185    allows interfaces like RStan to use the model.
1187 2. Compile the contents to a model file.
1189    This provides access to the CmdStan interface.  To use this, set
1190    ~org-babel-stan-cmdstan-directory~ and provide a ~:file~ argument
1191    that does not end in ".stan".
1193 For more information and usage examples, visit
1196 **** Support for Oracle databases via ~sqlplus~
1198 =ob-sql= library supports running SQL blocks against an Oracle
1199 database using ~sqlplus~.  Use with properties like this (all
1200 mandatory):
1203 :engine oracle
1204 :dbhost <>
1205 :dbport <1521>
1206 :dbuser <username>
1207 :database <database>
1208 :dbpassword <secret>
1211 **** Improved support to Microsoft SQL Server via ~sqlcmd~
1213 =ob-sql= library removes support to the ~msosql~ engine which uses the
1214 deprecated ~osql~ command line tool, and replaces it with ~mssql~
1215 engine which uses the ~sqlcmd~ command line tool.  Use with properties
1216 like this:
1219 :engine mssql
1220 :dbhost <>
1221 :dbuser <username>
1222 :dbpassword <secret>
1223 :database <database>
1226 If you want to use the *trusted connection* feature, omit *both* the
1227 =dbuser= and =dbpassword= properties and add =cmdline -E= to the properties.
1229 If your Emacs is running in a Cygwin environment, the =ob-sql= library
1230 can pass the converted path to the =sqlcmd= tool.
1232 **** Improved support of header arguments for postgresql
1234 The postgresql engine in a sql code block supports now ~:dbport~ nd
1235 ~:dbpassword~ as header arguments.
1237 **** Support for additional plantuml output formats
1239 The support for output formats of [[][plantuml]] has been extended to now
1240 include:
1242 All Diagrams:
1243 - png ::
1244 - svg ::
1245 - eps ::
1246 - pdf ::
1247 - vdx ::
1248 - txt :: ASCII art
1249 - utxt :: ASCII art using unicode characters
1251 Class Diagrams:
1252 - xmi ::
1253 - html ::
1255 State Diagrams:
1256 - scxml ::
1258 The output formats are determined by the file extension specified
1259 using the :file property, e.g.:
1261 #+begin_src plantuml :file diagram.png
1262 @startuml
1263 Alice -> Bob: Authentication Request
1264 Bob --> Alice: Authentication Response
1266 Alice -> Bob: Another authentication Request
1267 Alice <-- Bob: another authentication Response
1268 @enduml
1269 #+end_src
1271 Please note that *pdf* *does not work out of the box* and needs additional
1272 setup in addition to plantuml.  See [[]] for
1273 details and setup information.
1275 *** Rewrite of radio lists
1277 Radio lists, i.e, Org plain lists in foreign buffers, have been
1278 rewritten to be on par with Radio tables.  You can use a large set of
1279 parameters to control how a given list should be rendered.  See manual
1280 for details.
1282 *** org-bbdb-anniversaries-future
1284 Used like ~org-bbdb-anniversaries~, it provides a few days warning for
1285 upcoming anniversaries (default: 7 days).
1287 *** Clear non-repeated SCHEDULED upon repeating a task
1289 If the task is repeated, and therefore done at least one, scheduling
1290 information is no longer relevant.  It is therefore removed.
1292 See [[git:481719fbd5751aaa9c672b762cb43aea8ee986b0][commit message]] for more information.
1294 *** Support for ISO week trees
1296 ISO week trees are an alternative date tree format that orders entries
1297 by ISO week and not by month.
1299 For example:
1301 : * 2015
1302 : ** 2015-W35
1303 : ** 2015-W36
1304 : *** 2015-08-31 Monday
1306 They are supported in org-capture via ~file+weektree~ and
1307 ~file+weektree+prompt~ target specifications.
1309 *** Accept ~:indent~ parameter when capturing column view
1311 When defining a "columnview" dynamic block, it is now possible to add
1312 an :indent parameter, much like the one in the clock table.
1314 On the other hand, stars no longer appear in an ITEM field.
1316 *** Columns view
1318 **** ~org-columns~ accepts a prefix argument
1320 When called with a prefix argument, ~org-columns~ apply to the whole
1321 buffer unconditionally.
1323 **** New variable : ~org-agenda-view-columns-initially~
1325 The variable used to be a ~defvar~, it is now a ~defcustom~.
1327 **** Allow custom summaries
1329 It is now possible to add new summary types, or override those
1330 provided by Org by customizing ~org-columns-summary-types~, which see.
1332 **** Allow multiple summaries for any property
1334 Columns can now summarize the same property using different summary
1335 types.
1337 *** Preview LaTeX snippets in buffers not visiting files
1338 *** New option ~org-attach-commit~
1340 When non-nil, commit attachments with git, assuming the document is in
1341 a git repository.
1343 *** Allow conditional case-fold searches in ~org-occur~
1345 When set to ~smart~, the new variable ~org-occur-case-fold-search~ allows
1346 to mimic =isearch.el=: if the regexp searched contains any upper case
1347 character (or character class), the search is case sensitive.
1348 Otherwise, it is case insensitive.
1350 *** More robust repeated =ox-latex= footnote handling
1352 Repeated footnotes are now numbered by referring to a label in the
1353 first footnote.
1355 *** The ~org-block~ face is inherited by ~src-blocks~
1357 This works also when =org-src-fontify-natively= is non-nil.  It is also
1358 possible to specify per-languages faces.  See =org-src-block-faces= and
1359 the manual for details.
1361 *** Links are now customizable
1363 Links can now have custom colors, tooltips, keymaps, display behavior,
1364 etc.  Links are now centralized in ~org-link-parameters~.
1366 ** New functions
1368 *** ~org-next-line-empty-p~
1370 It replaces the deprecated ~next~ argument to ~org-previous-line-empty-p~.
1372 *** ~org-show-children~
1374 It is a faster implementation of ~outline-show-children~.
1376 ** Removed functions
1378 *** ~org-agenda-filter-by-tag-refine~ has been removed.
1380 Use ~org-agenda-filter-by-tag~ instead.
1382 *** ~org-agenda-todayp~ is deprecated.
1384 Use ~org-agenda-today-p~ instead.
1386 *** ~org-babel-get-header~ is removed.
1388 Use ~org-babel--get-vars~ or ~assq~ instead, as applicable.
1390 *** ~org-babel-trim~ is deprecated.
1392 Use ~org-trim~ instead.
1394 *** ~org-element-remove-indentation~ is deprecated.
1396 Use ~org-remove-indentation~ instead.
1398 *** ~org-image-file-name-regexp~ is deprecated
1400 Use ~image-file-name-regexp~ instead.
1401 The never-used-in-core ~extensions~ argument has been dropped.
1403 *** ~org-list-parse-list~ is deprecated
1405 Use ~org-list-to-lisp~ instead.
1407 *** ~org-on-heading-p~ is deprecated
1409 A comment to this effect was in the source code since 7.8.03, but
1410 now a byte-compiler warning will be generated as well.
1412 *** ~org-table-p~ is deprecated
1414 Use ~org-at-table-p~ instead.
1416 *** ~org-table-recognize-table.el~ is deprecated
1418 It was not called by any org code since 2010.
1420 *** Various reimplementations of cl-lib functions are deprecated
1422 The affected functions are:
1423 - ~org-count~
1424 - ~org-remove-if~
1425 - ~org-remove-if-not~
1426 - ~org-reduce~
1427 - ~org-every~
1428 - ~org-some~
1430 Additionally, ~org-sublist~ is deprecated in favor of ~cl-subseq~.  Note
1431 the differences in indexing conventions: ~org-sublist~ is 1-based and
1432 end-inclusive; ~cl-subseq~ is 0-based and end-exclusive.
1434 ** Removed options
1436 *** Remove all options related to ~ido~ or ~iswitchb~
1438 This includes ~org-completion-use-iswitchb~ and ~org-completion-use-ido~.
1439 Instead Org uses regular functions, e.g., ~completion-read~ so as to
1440 let those libraries operate.
1442 *** Remove ~org-list-empty-line-terminates-plain-lists~
1444 Two consecutive blank lines always terminate all levels of current
1445 plain list.
1447 *** ~fixltx2e~ is removed from ~org-latex-default-packages-alist~
1449 fixltx2e is obsolete, see LaTeX News 22.
1451 ** Miscellaneous
1452 *** Add Icelandic smart quotes
1453 *** Allow multiple receiver locations in radio tables and lists
1454 *** Allow angular links within link descriptions
1456 It is now allowed to write, e.g.,
1457 ~[[][<file:unicorn.png>]]~ as an equivalent to
1458 ~[[][file:unicorn.png]]~.  The advantage of the former
1459 is that spaces are allowed within the path.
1461 *** Beamer export back-ends uses ~org-latex-prefer-user-labels~
1462 *** ~:preparation-function~ called earlier during publishing
1464 Functions in this list are called before any file is associated to the
1465 current project.  Thus, they can be used to generate to be published
1466 Org files.
1468 *** Function ~org-remove-indentation~ changes.
1470 The new algorithm doesn't remove TAB characters not used for
1471 indentation.
1473 *** Secure placeholders in capture templates
1475 Placeholders in capture templates are no longer expanded recursively.
1476 However, ~%(...)~ constructs are expanded very late, so you can fill
1477 the contents of the S-exp with the replacement text of non-interactive
1478 placeholders.  As before, interactive ones are still expanded as the
1479 very last step, so the previous statement doesn't apply to them.
1481 Note that only ~%(...)~ placeholders initially present in the
1482 template, or introduced using a file placeholder, i.e., ~%[...]~ are
1483 expanded.  This prevents evaluating potentially malicious code when
1484 another placeholder, e.g., ~%i~ expands to a S-exp.
1486 *** Links stored by ~org-gnus-store-link~ in nnir groups
1488 Since gnus nnir groups are temporary, ~org-gnus-store-link~ now refers
1489 to the article's original group.
1491 *** ~org-babel-check-confirm-evaluate~ is now a function instead of a macro
1493 The calling convention has changed.
1495 *** HTML export table row customization changes
1497 Variable ~org-html-table-row-tags~ has been split into
1498 ~org-html-table-row-open-tag~ and ~org-html-table-row-close-tag~.
1499 Both new variables can be either a string or a function which will be
1500 called with 6 parameters.
1502 *** =ITEM= special property returns headline without stars
1503 *** Rename ~org-insert-columns-dblock~ into ~org-columns-insert-dblock~
1505 The previous name is, for the time being, kept as an obsolete alias.
1507 *** ~org-trim~ can preserve leading indentation.
1509 When setting a new optional argument to a non-nil value, ~org-trim~
1510 preserves leading indentation while removing blank lines at the
1511 beginning of the string.  The behavior is identical for white space at
1512 the end of the string.
1514 *** Function ~org-info-export~ changes.
1516 HTML links created from certain info links now point to URL's rather
1517 than just to local files. For example info links such as =info:emacs#List
1518 Buffers= used to be converted to HTML links like this:
1520 : <a href="emacs.html#List-Buffers">emacs#List Buffers</a>
1522 where local file =emacs.html= is referenced.
1523 For most folks this file does not exist.
1524 Thus the new behavior is to generate this HTML link instead:
1526 : <a href="">emacs#List Buffers</a>
1528 All emacs related info links are similarly translated plus few other
1529 manuals.
1531 *** Repeaters with a ~++~ interval and a time can be shifted to later today
1533 Previously, if a recurring task had a timestamp of
1534 ~<2016-01-01 Fri 20:00 ++1d>~ and was completed on =2016-01-02= at
1535 =08:00=, the task would skip =2016-01-02= and would be rescheduled for
1536 =2016-01-03=.  Timestamps with ~++~ cookies and a specific time will
1537 now shift to the first possible future occurrence, even if the
1538 occurrence is later the same day the task is completed.  (Timestamps
1539 already in the future are still shifted one time further into the
1540 future.)
1542 *** ~org-mobile-action-alist~ is now a defconst
1544 It used to be a defcustom, with a warning that it shouldn't be
1545 modified anyway.
1547 *** ~file+emacs~ and ~file+sys~ link types are deprecated
1549 They are still supported in Org 9.0 but will eventually be removed in
1550 a later release.  Use ~file~ link type along with universal arguments
1551 to force opening it in either Emacs or with system application.
1553 *** New defcustom ~org-babel-J-command~ stores the j command
1554 *** New defalias ~org-babel-execute:j~
1556 Allows J source blocks be indicated by letter j.  Previously the
1557 indication letter was solely J.
1559 *** ~org-open-line~ ignores tables at the very beginning of the buffer
1561 When ~org-special-ctrl-o~ is non-nil, it is impractical to create
1562 a blank line above a table at the beginning of the document. Now, as
1563 a special case, ~org-open-line~ behaves normally in this situation.
1565 *** ~org-babel-hash-show-time~ is now customizable
1567 The experimental variable used to be more or less confidential, as
1568 a ~defvar~.
1570 *** New ~:format~ property to parsed links
1572 It defines the format of the original link.  Possible values are:
1573 ~plain~, ~bracket~ and ~angle~.
1575 * Version 8.3
1577 ** Incompatible changes
1579 *** Properties drawers syntax changes
1581 Properties drawers are now required to be located right after a
1582 headline and its planning line, when applicable.
1584 It will break some documents as TODO states changes were sometimes
1585 logged before the property drawer.
1587 The following function will repair them:
1589 #+BEGIN_SRC emacs-lisp
1590 (defun org-repair-property-drawers ()
1591   "Fix properties drawers in current buffer.
1592 Ignore non Org buffers."
1593   (when (eq major-mode 'org-mode)
1594     (org-with-wide-buffer
1595      (goto-char (point-min))
1596      (let ((case-fold-search t)
1597            (inline-re (and (featurep 'org-inlinetask)
1598                            (concat (org-inlinetask-outline-regexp)
1599                                    "END[ \t]*$"))))
1600        (org-map-entries
1601         (lambda ()
1602           (unless (and inline-re (org-looking-at-p inline-re))
1603             (save-excursion
1604               (let ((end (save-excursion (outline-next-heading) (point))))
1605                 (forward-line)
1606                 (when (org-looking-at-p org-planning-line-re) (forward-line))
1607                 (when (and (< (point) end)
1608                            (not (org-looking-at-p org-property-drawer-re))
1609                            (save-excursion
1610                              (and (re-search-forward org-property-drawer-re end t)
1611                                   (eq (org-element-type
1612                                        (save-match-data (org-element-at-point)))
1613                                       'drawer))))
1614                   (insert (delete-and-extract-region
1615                            (match-beginning 0)
1616                            (min (1+ (match-end 0)) end)))
1617                   (unless (bolp) (insert "\n"))))))))))))
1618 #+END_SRC
1620 *** Using "COMMENT" is now equivalent to commenting with "#"
1622 If you used "COMMENT" in headlines to prevent a subtree from being
1623 exported, you can still do it but all information within the subtree
1624 is now commented out, i.e. no #+OPTIONS line will be parsed or taken
1625 into account when exporting.
1627 If you want to exclude a headline from export while using its contents
1628 for setting options, use =:noexport:= (see =org-export-exclude-tags=.)
1630 *** =#+CATEGORY= keywords no longer apply partially to document
1632 It was possible to use several such keywords and have them apply to
1633 the text below until the next one, but strongly deprecated since Org
1634 5.14 (2008).
1636 =#+CATEGORY= keywords are now global to the document.  You can use node
1637 properties to set category for a subtree, e.g.,
1639 #+BEGIN_SRC org
1640 ,* Headline
1641    :PROPERTIES:
1642    :CATEGORY: some category
1643    :END:
1644 #+END_SRC
1646 *** New variable to control visibility when revealing a location
1648 ~org-show-following-heading~, ~org-show-siblings~, ~org-show-entry-below~
1649 and ~org-show-hierarchy-above~ no longer exist.  Instead, visibility is
1650 controlled through a single variable: ~org-show-context-detail~, which
1651 see.
1653 *** Replace disputed keys again when reading a date
1655 ~org-replace-disputed-keys~ has been ignored when reading date since
1656 version 8.1, but the former behavior is restored again.
1658 Keybinding for reading date can be customized with a new variable
1659 ~org-read-date-minibuffer-local-map~.
1661 *** No default title is provided when =TITLE= keyword is missing
1663 Skipping =TITLE= keyword no longer provides the current file name, or
1664 buffer name, as the title.  Instead, simply ignore the title.
1666 *** Default bindings of =C-c C-n= and =C-c C-p= changed
1668 The key sequences =C-c C-n= and =C-c C-p= are now bound to
1669 ~org-next-visible-heading~ and ~org-previous-visible-heading~
1670 respectively, rather than the =outline-mode= versions of these
1671 functions.  The Org version of these functions skips over inline tasks
1672 (and even-level headlines when ~org-odd-levels-only~ is set).
1674 *** ~org-element-context~ no longer return objects in keywords
1676 ~org-element-context~ used to return objects on some keywords, i.e.,
1677 =TITLE=, =DATE= and =AUTHOR=.  It now returns only the keyword.
1679 *** ~org-timer-default-timer~ type changed from number to string
1681 If you have, in your configuration, something like =(setq
1682 org-timer-default-timer 10)= replace it with =(setq
1683 org-timer-default-timer "10")=.
1685 *** Functions signature changes
1687 The following functions require an additional argument.  See their
1688 docstring for more information.
1690 - ~org-export-collect-footnote-definitions~
1691 - ~org-html-format-headline-function~
1692 - ~org-html-format-inlinetask-function~
1693 - ~org-latex-format-headline-function~
1694 - ~org-latex-format-inlinetask-function~
1695 - ~org-link-search~
1697 ** New features
1699 *** Default lexical evaluation of emacs-lisp src blocks
1701 Emacs-lisp src blocks in babel are now evaluated using lexical
1702 scoping.  There is a new header to control this behavior.
1704 The default results in an eval with lexical scoping.
1705 :lexical yes
1707 This turns lexical scoping off in the eval (the former behavior).
1708 :lexical no
1710 This uses the lexical environment with x=42 in the eval.
1711 :lexical '((x . 42))
1713 *** Behavior of ~org-return~ changed
1715 If point is before or after the headline title, insert a new line
1716 without changing the headline.
1718 *** Hierarchies of tags
1720 The functionality of nesting tags in hierarchies is added to org-mode.
1721 This is the generalization of what was previously called "Tag groups"
1722 in the manual.  That term is now changed to "Tag hierarchy".
1724 The following in-buffer definition:
1726 #+BEGIN_SRC org
1727   ,#+TAGS: [ Group : SubOne SubTwo ]
1728   ,#+TAGS: [ SubOne : SubOne1 SubOne2 ]
1729   ,#+TAGS: [ SubTwo : SubTwo1 SubTwo2 ]
1730 #+END_SRC
1732 Should be seen as the following tree of tags:
1734 - Group
1735   - SubOne
1736     - SubOne1
1737     - SubOne2
1738   - SubTwo
1739     - SubTwo1
1740     - SubTwo2
1742 Searching for "Group" should return all tags defined above.  Filtering
1743 on SubOne filters also it's sub-tags.  Etc.
1745 There is no limit on the depth for the tag hierarchy.
1747 *** Additional syntax for non-unique grouptags
1749 Additional syntax is defined for grouptags if the tags in the group
1750 don't have to be distinct on a heading.
1752 Grouptags had to previously be defined with { }.  This syntax is
1753 already used for exclusive tags and Grouptags need their own,
1754 non-exclusive syntax.  This behavior is achieved with [ ].  Note: { }
1755 can still be used also for Grouptags but then only one of the given
1756 tags can be used on the headline at the same time.  Example:
1758 [ group : sub1 sub2 ]
1760 #+BEGIN_SRC org
1761 ,* Test                                                            :sub1:sub2:
1762 #+END_SRC
1764 This is a more general case than the already existing syntax for
1765 grouptags; { }.
1767 *** Define regular expression patterns as tags
1769 Tags can be defined as grouptags with regular expressions as
1770 "sub-tags".
1772 The regular expressions in the group must be marked up within { }.
1773 Example use:
1775 : #+TAGS: [ Project : {P@.+} ]
1777 Searching for the tag Project will now list all tags also including
1778 regular expression matches for P@.+.  This is good for example for
1779 projects tagged with a common identifier, i.e. P@2014_OrgTags.
1781 *** Filtering in the agenda on grouptags (Tag hierarchies)
1783 Filtering in the agenda on grouptags filters all of the related tags.
1784 Except if a filter is applied with a (double) prefix-argument.
1786 Filtering in the agenda on subcategories does not filter the "above"
1787 levels anymore.
1789 If a grouptag contains a regular expression the regular expression
1790 is also used as a filter.
1792 *** Minor refactoring of ~org-agenda-filter-by-tag~
1794 Now uses the argument ARG and optional argument exclude instead of
1795 strip and narrow.  ARG because the argument has multiple purposes and
1796 makes more sense than strip now.  The term "narrowing" is changed to
1797 exclude.
1799 The main purpose is for the function to make more logical sense when
1800 filtering on tags now when tags can be structured in hierarchies.
1802 *** Babel: support for sed scripts
1804 Thanks to Bjarte Johansen for this feature.
1806 *** Babel: support for Processing language
1808 New ob-processing.el library.
1810 This library implements necessary functions for implementing editing
1811 of Processing code blocks, viewing the resulting sketches in an
1812 external viewer, and HTML export of the sketches.
1814 Check the documentation for more details.
1816 Thanks to Jarmo Hurri for this feature.
1818 *** New behavior for ~org-toggle-latex-fragment~
1820 The new behavior is the following:
1822 - With a double prefix argument or with a single prefix argument when
1823   point is before the first headline, toggle overlays in the whole
1824   buffer;
1826 - With a single prefix argument, toggle overlays in the current
1827   subtree;
1829 - On latex code, toggle overlay at point;
1831 - Otherwise, toggle overlays in the current section.
1833 *** Additional markup with =#+INCLUDE= keyword
1835 The content of the included file can now be optionally marked up, for
1836 instance as HTML.  See the documentation for details.
1838 *** File links with =#+INCLUDE= keyword
1840 Objects can be extracted via =#+INCLUDE= using file links.  It is
1841 possible to include only the contents of the object.  See manual for
1842 more information.
1844 *** Drawers do not need anymore to be referenced in =#+DRAWERS=
1846 One can use a drawer without listing it in the =#+DRAWERS= keyword,
1847 which is now obsolete.  As a consequence, this change also deprecates
1848 ~org-drawers~ variable.
1850 *** ~org-edit-special~ can edit export blocks
1852 Using C-c ' on an export block now opens a sub-editing buffer.  Major
1853 mode in that buffer is determined by export backend name (e.g.,
1854 "latex" \to "latex-mode").  You can define exceptions to this rule by
1855 configuring ~org-src-lang-modes~, which see.
1857 *** Additional =:hline= processing to ob-shell
1859 If the argument =:hlines yes= is present in a babel call, an optional
1860 argument =:hlines-string= can be used to define a string to use as a
1861 representation for the lisp symbol ='hline= in the shell program.  The
1862 default is =hline=.
1864 *** Markdown export supports switches in source blocks
1866 For example, it is now possible to number lines using the =-n= switch in
1867 a source block.
1869 *** New option in ASCII export
1871 Plain lists can have an extra margin by setting ~org-ascii-list-margin~
1872 variable to an appropriate integer.
1874 *** New blocks in ASCII export
1876 ASCII export now supports =#+BEGIN_JUSTIFYRIGHT= and =#+BEGIN_JUSTIFYLEFT=
1877 blocks.  See documentation for details.
1879 *** More back-end specific publishing options
1881 The number of publishing options specific to each back-end has been
1882 increased.  See manual for details.
1884 *** Export inline source blocks
1886 Inline source code was used to be removed upon exporting.  They are
1887 now handled as standard code blocks, i.e., the source code can appear
1888 in the output, depending on the parameters.
1890 *** Extend ~org-export-first-sibling-p~ and ~org-export-last-sibling-p~
1892 These functions now support any element or object, not only headlines.
1894 *** New function: ~org-export-table-row-in-header-p~
1896 *** New function: ~org-export-get-reference~
1898 *** New function: ~org-element-lineage~
1900 This function deprecates ~org-export-get-genealogy~.  It also provides
1901 more features.  See docstring for details.
1903 *** New function: ~org-element-copy~
1905 *** New filter: ~org-export-filter-body-functions~
1907 Functions in this filter are applied on the body of the exported
1908 document, before wrapping it within the template.
1910 *** New :environment parameter when exporting example blocks to LaTeX
1912 : #+ATTR_LATEX: :environment myverbatim
1914 : This sentence is false.
1915 : #+END_EXAMPLE
1917 will be exported using =@samp(myverbatim)= instead of =@samp(verbatim)=.
1919 *** Various improvements on radio tables
1921 Radio tables feature now relies on Org's export framework ("ox.el").
1922 ~:no-escape~ parameter no longer exists, but additional global
1923 parameters are now supported: ~:raw~, ~:backend~.  Moreover, there are new
1924 parameters specific to some pre-defined translators, e.g.,
1925 ~:environment~ and ~:booktabs~ for ~orgtbl-to-latex~.  See translators
1926 docstrings (including ~orgtbl-to-generic~) for details.
1928 *** Non-floating minted listings in Latex export
1930 It is not possible to specify =#+attr_latex: :float nil= in conjunction
1931 with source blocks exported by the minted package.
1933 *** Field formulas can now create columns as needed
1935 Previously, evaluating formulas that referenced out-of-bounds columns
1936 would throw an error. A new variable ~org-table-formula-create-columns~
1937 was added to adjust this behavior. It is now possible to silently add
1938 new columns, to do so with a warning or to explicitly ask the user
1939 each time.
1941 *** ASCII plot
1943 Ability to plot values in a column through ASCII-art bars.  See manual
1944 for details.
1946 *** New hook: ~org-archive-hook~
1948 This hook is called after successfully archiving a subtree, with point
1949 on the original subtree, not yet deleted.
1951 *** New option: ~org-attach-archive-delete~
1953 When non-nil, attachments from archived subtrees are removed.
1955 *** New option: ~org-latex-caption-above~
1957 This variable generalizes ~org-latex-table-caption-above~, which is now
1958 deprecated.  In addition to tables, it applies to source blocks,
1959 special blocks and images.  See docstring for more information.
1961 *** New option: ~org-latex-prefer-user-labels~
1963 See the docstring for more information.
1965 *** Export unnumbered headlines
1967 Headlines, for which the property ~UNNUMBERED~ is non-nil, are now
1968 exported without section numbers irrespective of their levels.  The
1969 property is inherited by children.
1971 *** Tables can be sorted with an arbitrary function
1973 It is now possible to specify a function, both programmatically,
1974 through a new optional argument, and interactively with ~f~ or ~F~ keys,
1975 to sort a table.
1977 *** Table of contents can be local to a section
1979 The ~TOC~ keywords now accepts an optional ~local~ parameter.  See manual
1980 for details.
1982 *** Countdown timers can now be paused
1984 ~org-timer-pause-time~ now pauses and restarts both relative and
1985 countdown timers.
1987 *** New option ~only-window~ for ~org-agenda-window-setup~
1989 When ~org-agenda-window-setup~ is set to ~only-window~, the agenda is
1990 displayed as the sole window of the current frame.
1992 *** ~{{{date}}}~ macro supports optional formatting argument
1994 It is now possible to supply and optional formatting argument to
1995 ~{{{date}}}~. See manual for details.
1997 *** ~{{{property}}}~ macro supports optional search argument
1999 It is now possible to supply an optional search option to
2000 ~{{{property}}}~ in order to retrieve remote properties optional.  See
2001 manual for details.
2003 *** New option ~org-export-with-title~
2005 It is possible to suppress the title insertion with ~#+OPTIONS:
2006 title:nil~ or globally using the variable ~org-export-with-title~.
2008 *** New entities family: "\_ "
2010 "\_ " are used to insert up to 20 contiguous spaces in various
2011 back-ends.  In particular, this family can be used to introduce
2012 leading spaces within table cells.
2014 *** New MathJax configuration options
2016 Org uses the MathJax CDN by default.  See the manual and the docstring
2017 of ~org-html-mathjax-options~ for details.
2019 *** New behavior in `org-export-options-alist'
2021 When defining a back-end, it is now possible to specify to give
2022 `parse' behavior on a keyword.  It is equivalent to call
2023 `org-element-parse-secondary-string' on the value.
2025 However, parsed =KEYWORD= is automatically associated to an
2026 =:EXPORT_KEYWORD:= property, which can be used to override the keyword
2027 value during a subtree export.  Moreover, macros are expanded in such
2028 keywords and properties.
2030 *** Viewport support in html export
2032 Viewport for mobile-optimized website is now automatically inserted
2033 when exporting to html.  See ~org-html-viewport~ for details.
2035 *** New ~#+SUBTITLE~ export keyword
2037 Org can typeset a subtitle in some export backends.  See the manual
2038 for details.
2040 *** Remotely edit a footnote definition
2042 Calling ~org-edit-footnote-reference~ (C-c ') on a footnote reference
2043 allows to edit its definition, as long as it is not anonymous, in a
2044 dedicated buffer.  It works even if buffer is currently narrowed.
2046 *** New function ~org-delete-indentation~ bound to ~M-^~
2048 Work as ~delete-indentation~ unless at heading, in which case text is
2049 added to headline text.
2051 *** Support for images in Texinfo export
2053 ~Texinfo~ back-end now handles images.  See the manual for details.
2055 *** Support for captions in Texinfo export
2057 Tables and source blocks can now have captions.  Additionally, lists
2058 of tables and lists of listings can be inserted in the document with
2059 =#+TOC= keyword.
2061 *** Countdown timer support hh:mm:ss format
2063 In addition to setting countdown timers in minutes, they can also be
2064 set using the hh:mm:ss format.
2066 *** Extend ~org-clone-subtree-with-time-shift~
2068 ~org-clone-subtree-with-time-shift~ now accepts 0 as an argument for the
2069 number of clones, which removes the repeater from the original subtree
2070 and creates one shifted, repeating clone.
2072 *** New time block for clock tables: ~untilnow~
2074 It encompasses all past closed clocks.
2076 *** Support for the ~polyglossia~ LaTeX package
2078 See the docstring of ~org-latex-classes~ and
2079 ~org-latex-guess-polyglossia-language~ for details.
2081 *** None-floating tables, graphics and blocks can have captions
2083 *** `org-insert-heading' can be forced to insert top-level headline
2085 ** Removed functions
2087 *** Removed function ~org-translate-time~
2089 Use ~org-timestamp-translate~ instead.
2091 *** Removed function ~org-beamer-insert-options-template~
2093 This function inserted a Beamer specific template at point or in
2094 current subtree.  Use ~org-export-insert-default-template~ instead, as
2095 it provides more features and covers all export back-ends.  It is also
2096 accessible from the export dispatcher.
2098 *** Removed function ~org-timer-cancel-timer~
2100 ~org-timer-stop~ now stops both relative and countdown timers.
2102 *** Removed function ~org-export-solidify-link-text~
2104 This function, being non-bijective, introduced bug in internal
2105 references.  Use ~org-export-get-reference~ instead.
2107 *** Removed function ~org-end-of-meta-data-and-drawers~
2109 The function is superseded by ~org-end-of-meta-data~, called with an
2110 optional argument.
2112 *** Removed functions ~org-table-colgroup-line-p~, ~org-table-cookie-line-p~
2114 These functions were left-over from pre 8.0 era.  They are not correct
2115 anymore.  Since they are not needed, they have no replacement.
2117 ** Removed options
2119 *** ~org-list-empty-line-terminates-plain-lists~ is deprecated
2121 It will be kept in code base until next release, for backward
2122 compatibility.
2124 If you need to separate consecutive lists with blank lines, always use
2125 two of them, as if this option was nil (default value).
2127 *** ~org-export-with-creator~ is a boolean
2129 Special ~comment~ value is no longer allowed.  It is possible to use a
2130 body filter to add comments about the creator at the end of the
2131 document instead.
2133 *** Removed option =org-html-use-unicode-chars=
2135 Setting this to non-nil was problematic as it converted characters
2136 everywhere in the buffer, possibly corrupting URLs.
2138 *** Removed option =org-babel-sh-command=
2140 This undocumented option defaulted to the value of =shell-file-name= at
2141 the time of loading =ob-shell=.  The new behavior is to use the value
2142 of =shell-file-name= directly when the shell langage is =shell=.  To chose
2143 a different shell, either customize =shell-file-name= or bind this
2144 variable locally.
2146 *** Removed option =org-babel-sh-var-quote-fmt=
2148 This undocumented option was supposed to provide different quoting
2149 styles when changing the shell type.  Changing the shell type can now
2150 be done directly from the source block and the quoting style has to be
2151 compatible across all shells, so a customization doesn't make sense
2152 anymore.  The chosen hard coded quoting style conforms to POSIX.
2154 *** Removed option ~org-insert-labeled-timestamps-at-point~
2156 Setting this option to anything else that the default value (nil)
2157 would create invalid planning info.  This dangerous option is now
2158 removed.
2160 *** Removed option ~org-koma-letter-use-title~
2162 Use org-export-with-title instead.  See also below.
2164 *** Removed option ~org-entities-ascii-explanatory~
2166 This variable has no effect since Org 8.0.
2168 *** Removed option ~org-table-error-on-row-ref-crossing-hline~
2170 This variable has no effect since August 2009.
2172 *** Removed MathML-related options from ~org-html-mathjax-options~
2174 MathJax automatically chooses the best display technology based on the
2175 end-users browser.  You may force initial usage of MathML via
2176 ~org-html-mathjax-template~ or by setting the ~path~ property of
2177 ~org-html-mathjax-options~.
2179 *** Removed comment-related filters
2181 ~org-export-filter-comment-functions~ and
2182 ~org-export-filter-comment-block-functions~ variables do not exist
2183 anymore.
2185 ** Miscellaneous
2187 *** Strip all meta data from ITEM special property
2189 ITEM special property does not contain TODO, priority or tags anymore.
2191 *** File names in links accept are now compatible with URI syntax
2193 Absolute file names can now start with =///= in addition to =/=. E.g.,
2194 =[[file:///home/me/unicorn.jpg]]=.
2196 *** Footnotes in included files are now local to the file
2198 As a consequence, it is possible to include multiple Org files with
2199 footnotes in a master document without being concerned about footnote
2200 labels colliding.
2202 *** Mailto links now use regular URI syntax
2204 This change deprecates old Org syntax for mailto links:
2205 =mailto:user@domain::Subject=.
2207 *** =QUOTE= keywords do not exist anymore
2209 =QUOTE= keywords have been deprecated since Org 8.2.
2211 *** Select tests to perform with the build system
2213 The build system has been enhanced to allow test selection with a
2214 regular expression by defining =BTEST_RE= during the test invocation.
2215 This is especially useful during bisection to find just when a
2216 particular test failure was introduced.
2218 *** Exact heading search for external links ignore spaces and cookies
2220 Exact heading search for links now ignore spaces and cookies. This is
2221 the case for links of the form*task title~, as well
2222 as links of the form words~ when
2223 ~org-link-search-must-match-exact-headline~ is not nil.
2225 *** ~org-latex-hyperref-template~, ~org-latex-title-command~ formatting
2227 New formatting keys are supported.  See the respective docstrings.
2228 Note, ~org-latex-hyperref-template~ has a new default value.
2230 *** ~float, wasysym, marvosym~ are removed from ~org-latex-default-packages-alist~
2232 If you require any of these package add them to your preamble via
2233 ~org-latex-packages-alist~. Org also uses default LaTeX ~\tolerance~ now.
2235 *** When exporting, throw an error on unresolved id/fuzzy links and code refs
2237 This helps spotting wrong links.
2239 * Version 8.2
2241 ** Incompatible changes
2242 *** =ob-sh.el= renamed to =ob-shell=
2243 This may require two changes in user config.
2245 1. In =org-babel-do-load-languages=, change =(sh . t)= to =(shell . t)=.
2246 2. Edit files to change the value of =BTEST_OB_LANGUAGES=
2247    to remove "sh" and include "shell".
2249 *** Combine org-mac-message.el and org-mac-link-grabber into org-mac-link.el
2251 Please remove calls to =(require 'org-mac-message)= and =(require
2252 'org-mac-link-grabber)= in your =.emacs= initialization file.  All you
2253 need now is =(require 'org-mac-link)=.
2255 Additionally, replace any calls to =ogml-grab-link= to
2256 =org-mac-grab-link=.  For example, replace this line:
2258 : (define-key org-mode-map (kbd "C-c g") 'omgl-grab-link)
2260 with this:
2262 : (define-key org-mode-map (kbd "C-c g") 'org-mac-grab-link)
2264 *** HTML export: Replace =HTML_HTML5_FANCY= by =:html-html5-fancy= (...)
2266 Some of the HTML specific export options in Org <8.1 are either nil or
2267 t, like =#+HTML_INCLUDE_STYLE=.  We replaced these binary options with
2268 option keywords like :html-include-style.
2270 So you need to replace
2276 : #+OPTIONS: :html-include-style t
2278 Options affected by this change: =HTML5_FANCY=, =HTML_INCLUDE_SCRIPTS=
2281 *** Add an argument to ~org-export-to-file~ and ~org-export-to-buffer~
2283 ~org-export-to-file~ and ~org-export-to-file~ can run in a different
2284 process when provided a non-nil =ASYNC= optional argument, without
2285 relying on ~org-export-async-start~ macro.
2287 Since =ASYNC= is the first of optional arguments, you have to shift
2288 the other optional arguments accordingly.
2290 *** Export back-ends are now structures
2292 Export back-ends are now structures, and stored as such in the
2293 communication channel during an export process.  In other words, from
2294 now on, ~(plist-get info :back-end)~ will return a structure instead
2295 of a symbol.
2297 Arguments in hooks and in filters are still symbols, though.
2299 ** Important bugfixes
2301 *** [[doc:org-insert-heading][org-insert-heading]] has been rewritten and bugs are now fixed
2302 *** The replacement of disputed keys is now turned of when reading a date
2304 *** Match string for sparse trees can now contain a slash in a property value
2306     You can now have searches like SOMEPROP="aaa/bbb".  Until now,
2307     this would break because the slash would be interpreted as the
2308     separator starting a TOTO match string.
2309 ** New features
2311 *** =C-c ^ x= will now sort checklist items by their checked status
2313 See [[doc:org-sort-list][org-sort-list]]: hitting =C-c ^ x= will put checked items at the end
2314 of the list.
2315 *** Various LaTeX export enhancements
2317 - Support SVG images
2318 - Support for .pgf files
2319 - LaTeX Babel blocks can now be exported as =.tikz= files
2320 - Allow =latexmk= as an option for [[doc:org-latex-pdf-process][org-latex-pdf-process]]
2321 - When using =\usepackage[AUTO]{babel}=, AUTO will automatically be
2322   replaced with a value compatible with ~org-export-default-language~
2323   or ~LANGUAGE~ keyword.
2324 - The dependency on the =latexsym= LaTeX package has been removed, we
2325   now use =amssymb= symbols by default instead.
2327 *** New functions for paragraph motion
2329     The commands =C-down= and =C-up= now invoke special commands
2330     that use knowledge from the org-elements parser to move the cursor
2331     in a paragraph-like way.
2333 *** New entities in =org-entities.el=
2335 Add support for ell, imath, jmath, varphi, varpi, aleph, gimel, beth,
2336 dalet, cdots, S (§), dag, ddag, colon, therefore, because, triangleq,
2337 leq, geq, lessgtr, lesseqgtr, ll, lll, gg, ggg, prec, preceq,
2338 preccurlyeq, succ, succeq, succurlyeq, setminus, nexist(s), mho,
2339 check, frown, diamond.  Changes loz, vert, checkmark, smile and tilde.
2341 *** Anonymous export back-ends
2343 ~org-export-create-backend~ can create anonymous export back-ends,
2344 which can then be passed to export functions like
2345 ~org-export-to-file~, ~org-export-to-buffer~ or ~org-export-as~.
2347 It allows for quick translation of Org syntax without the overhead of
2348 registering a new back-end.
2350 *** New agenda fortnight view
2352     The agenda has not, in addition to day, week, month, and year
2353     views, also a fortnight view covering 14 days.
2354 ** New options
2356 *** New option [[doc:org-bookmark-names-plist][org-bookmark-names-plist]]
2358 This allows to specify the names of automatic bookmarks.
2359 *** New option [[doc:org-agenda-ignore-drawer-properties][org-agenda-ignore-drawer-properties]]
2361 This allows more flexibility when optimizing the agenda generation.
2362 See for details.
2363 *** New option: [[doc:org-html-link-use-abs-url][org-html-link-use-abs-url]] to force using absolute URLs
2365 This is an export/publishing option, and should be used either within
2366 the =#+OPTIONS= line(s) or within a [[doc:org-publish-project-alist][org-publish-project-alist]].
2368 Setting this option to =t= is needed when the HTML output does not
2369 allow relative URLs.  For example, the =contrib/lisp/ox-rss.el=
2370 library produces a RSS feed, and RSS feeds need to use absolute URLs,
2371 so a combination of =:html-link-home "..." and :html-link-use-abs-url
2372 t= is required---see the configuration example in the comment section
2373 of =ox-rss.el=.
2375 *** New option [[doc:org-babel-ditaa-java-cmd][org-babel-ditaa-java-cmd]]
2377 This makes java executable configurable for ditaa blocks.
2379 *** New options [[doc:org-babel-latex-htlatex][org-babel-latex-htlatex]] and [[doc:org-babel-latex-htlatex-packages][org-babel-latex-htlatex-packages]]
2381 This enables SVG generation from latex code blocks.
2383 *** New option: [[doc:org-habit-show-done-always-green][org-habit-show-done-always-green]]
2385 See [[][this message]] from Max Mikhanosha.
2387 *** New option: [[doc:org-babel-inline-result-wrap][org-babel-inline-result-wrap]]
2389 If you set this to the following
2391 : (setq org-babel-inline-result-wrap "$%s$")
2393 then inline code snippets will be wrapped into the formatting string.
2395 *** New option: [[doc:org-special-ctrl-o][org-special-ctrl-o]]
2397     This variable can be used to turn off the special behavior of
2398     =C-o= in tables.
2399 ** New contributed packages
2401 - =ox-bibtex.el= by Nicolas Goaziou :: an utility to handle BibTeX
2402      export to both LaTeX and HTML exports.  It uses the [[][bibtex2html]]
2403      software.
2405 - =org-screenshot.el= by Max Mikhanosha :: an utility to handle
2406      screenshots easily from Org, using the external tool [[][scrot]].
2408 ** Miscellaneous
2410 *** "QUOTE" keywords in headlines are deprecated
2412 "QUOTE" keywords are an undocumented feature in Org.  When a headline
2413 starts with the keyword "QUOTE", its contents are parsed as
2414 a ~quote-section~ and treated as an example block.  You can achieve
2415 the same with example blocks.
2417 This feature is deprecated and will be removed in the next Org
2418 release.
2420 * Version 8.0.1
2422 ** Installation
2424 Installation instructions have been updated and simplified.
2426 If you have troubles installing or updating Org, focus on these
2427 instructions:
2429 - when updating via a file, you only need to set the
2430   =load-path= in your =.emacs=.  Set it before any other Org
2431   customization that would call autoloaded Org functions.
2433 - when updating by pulling Org's Git repository, make sure to create the
2434   correct autoloads.  You can do this by running =~$ make autoloads= (to
2435   only create the autoloads) or by running =~$ make= (to also compile
2436   the Emacs lisp files.)  =~$ make help= and =~$ make helpall= gives you
2437   detailed explanations.
2439 - when updating through ELPA (either from GNU ELPA or from Org ELPA),
2440   you have to install Org's ELPA package in a session where no Org
2441   function has been called already.
2443 When in doubt, run =M-x org-version RET= and see if you have a mixed-up
2444 installation.
2446 See for details.
2448 ** Incompatible changes
2450 Org 8.0 is the most disruptive major version of Org.
2452 If you configured export options, you will have to update some of them.
2454 If you used =#+ATTR_*= keywords, the syntax of the attributes changed and
2455 you will have to update them.
2457 Below is a list of changes for which you need to take action.
2459 See for the most recent version of
2460 this list and for detailed instructions on how to migrate.
2462 **** New export engine
2464 Org 8.0 comes with a new export engine written by Nicolas Goaziou.  This
2465 export engine relies on ~org-element.el~ (Org's syntax parser), which was
2466 already in Org's core.  This new export engine triggered the rewriting of
2467 /all/ export back-ends.
2469 The most visible change is the export dispatcher, accessible through the
2470 keybinding =C-c C-e=.  By default, this menu only shows some of the
2471 built-in export formats, but you can add more formats by loading them
2472 directly (e.g., =(require 'ox-texinfo)= or by configuring the option
2473 [[doc:org-export-backends][org-export-backends]].
2475 More contributed back-ends are available from the =contrib/= directory, the
2476 corresponding files start with the =ox-= prefix.
2478 If you customized an export back-end (like HTML or LaTeX), you will need to
2479 rename some options so that your customization is not lost.  Typically, an
2480 option starting with =org-export-html-= is now named =org-html-=.  See the
2481 manual for details and check [[][this Worg page]] for directions.
2483 **** New syntax for #+ATTR_HTML/LaTeX/... options
2485      : #+ATTR_HTML width="200px"
2487      should now be written
2489      : #+ATTR_HTML :width 200px
2491      Keywords like =#+ATTR_HTML= and =#+ATTR_LaTeX= are defined in their
2492      respective back-ends, and the list of supported parameters depends on
2493      each backend.  See Org's manual for details.
2495 **** ~org-remember.el~ has been removed
2497      You cannot use =remember.el= anymore to capture notes.
2499      Support for remember templates has been obsoleted since long, it is
2500      now fully removed.
2502      Use =M-x org-capture-import-remember-templates RET= to import your
2503      remember templates into capture templates.
2505 **** ~org-jsinfo.el~ has been merged into ~ox-html.el~
2507      If you were requiring ~ox-jsinfo.el~ in your ~.emacs.el~ file, you
2508      will have to remove this requirement from your initialization file.
2510 **** Note for third-party developers
2512      The name of the files for export back-end have changed: we now use the
2513      prefix =ox-= for those files (like we use the =ob-= prefix for Babel
2514      files.)  For example ~org-html.el~ is now ~ox-html.el~.
2516      If your code relies on these files, please update the names in your
2517      code.
2519 **** Packages moved from core to contrib
2521      Since packages in Org's core are meant to be part of GNU Emacs, we try
2522      to be minimalist when it comes to adding files into core.  For 8.0, we
2523      moved some contributions into the =contrib/= directory.
2525      The rationale for deciding that these files should live in =contrib/=
2526      is either because they rely on third-party software that is not
2527      included in Emacs, or because they are not targeting a significant
2528      user-base.
2530      - org-colview-xemacs.el
2531      - org-mac-message.el
2532      - org-mew.el
2533      - org-wl.el
2534      - ox-freedmind.el
2535      - ox-taskjuggler.el
2537      Note that ~ox-freedmind.el~ has been rewritten by Jambunathan,
2538      ~org-mew.el~ has been enhanced by Tokuya Kameshima and
2539      ~ox-taskjuggler.el~ by Nicolas Goaziou and others.
2541      Also, the Taskjuggler exporter now uses TJ3 by default.  John Hendy
2542      wrote [[][a tutorial on Worg]] for the TJ3 export.
2544 ** New packages in core
2546 *** ~ob-makefile.el~ by Eric Schulte and Thomas S. Dye
2548     =ob-makefile.el= implements Org Babel support for Makefile tangling.
2550 *** ~ox-man.el~ by Luis Anaya
2552     =ox-man.el= allows you to export Org files to =man= pages.
2554 *** ~ox-md.el~ by Nicolas Goaziou
2556     =ox-md.el= allows you to export Org files to Markdown files, using the
2557     vanilla [[][Markdown syntax]].
2559 *** ~ox-texinfo.el~ by Jonathan Leech-Pepin
2561     =ox-texinfo.el= allows you to export Org files to [[][Texinfo]] files.
2563 ** New packages in contrib
2565 *** ~ob-julia.el~ by G. Jay Kerns
2567     [[][Julia]] is a new programming language.
2569     =ob-julia.el= provides Org Babel support for evaluating Julia source
2570     code.
2572 *** ~ob-mathomatic.el~ by Luis Anaya
2574     [[][mathomatic]] a portable, command-line, educational CAS and calculator
2575     software, written entirely in the C programming language.
2577     ~ob-mathomatic.el~ provides Org Babel support for evaluating mathomatic
2578     entries.
2580 *** ~ob-tcl.el~ by Luis Anaya
2582     ~ob-tcl.el~ provides Org Babel support for evaluating [[][Tcl]] source code.
2584 *** ~org-bullets.el~ by Evgeni Sabof
2586     Display bullets instead of stars for headlines.
2588     Also see [[][this updated FAQ]] on how to display another character than "*"
2589     for starting headlines.
2591 *** ~org-favtable.el~ by Marc-Oliver Ihm
2593     ~org-favtable.el~ helps you to create and update a table of favorite
2594     locations in org, keeping the most frequently visited lines right at
2595     the top.  This table is called "favtable".  See the documentation on
2596     [[][Worg]].
2598 *** ~ox-confluence.el~ by Sébastien Delafond
2600     ~ox-confluence.el~ lets you convert Org files to [[][Confluence Wiki]] files.
2602 *** ~ox-deck.el~ and ~ox-s5.el~ by Rick Frankel
2604     [[][deck.js]] is a javascript library for displaying HTML ages as
2605     presentations.  ~ox-deck.el~ exports Org files to HTML presentations
2606     using =deck.js=.
2608     [[][s5]] is a set of scripts which also allows to display HTML pages as
2609     presentations.  ~ox-s5.el~ exports Org files to HTML presentations
2610     using =s5=.
2612 *** ~ox-groff.el~ by Luis Anaya and Nicolas Goaziou
2614     The [[][groff]] (GNU troff) software is a typesetting package which reads
2615     plain text mixed with formatting commands and produces formatted
2616     output.
2618     Luis Anaya and Nicolas Goaziou implemented ~ox-groff.el~ to allow
2619     conversion from Org files to groff.
2621 *** ~ox-koma-letter.el~ by Nicolas Goaziou and Alan Schmitt
2623     This back-end allow to export Org pages to the =KOMA Scrlttr2= format.
2625 *** ~ox-rss.el~ by Bastien
2627     This back-end lets you export Org pages to RSS 2.0 feeds.  Combined
2628     with the HTML publishing feature, this allows you to build a blog
2629     entirely with Org.
2631 ** New features
2633 *** Export
2635 **** New export generic options
2637 If you use Org exporter, we advise you to re-read [[][the manual section about
2638 it]].  It has been updated and includes new options.
2640 Among the new/updated export options, three are of particular importance:
2642 - [[doc:org-export-allow-bind-keywords][org-export-allow-bind-keywords]] :: This option replaces the old option
2643      =org-export-allow-BIND= and the default value is =nil=, not =confirm=.
2644      You will need to explicitly set this to =t= in your initialization
2645      file if you want to allow =#+BIND= keywords.
2647 - [[doc:org-export-with-planning][org-export-with-planning]] :: This new option controls the export of
2648      =SCHEDULED:, DEADLINE:, CLOSED:= lines, and planning information is
2649      now skipped by default during export.  This use to be the job of
2650      [[doc:org-export-with-timestamps][org-export-with-timestamps]], but this latter option has been given a
2651      new role: it controls the export of /standalone time-stamps/.  When
2652      set to =nil=, Org will not export active and inactive time-stamps
2653      standing on a line by themselves or within a paragraph that only
2654      contains time-stamps.
2656 To check if an option has been introduced or its default value changed in
2657 Org 8.0, do =C-h v [option] RET= and check if the documentation says that
2658 the variable has been introduced (or changed) in version 24.4 of Emacs.
2660 **** Enhanced default stylesheet for the HTML exporter
2662 See the new default value of [[doc:org-html-style-default][org-html-style-default]].
2664 **** New tags, classes and ids for the HTML exporter
2666 See the new default value of [[doc:org-html-divs][org-html-divs]].
2668 **** Support for tikz pictures in LaTeX export
2669 **** ~org-man.el~: New export function for "man" links
2670 **** ~org-docview.el~: New export function for docview links
2671 *** Structure editing
2673 **** =C-u C-u M-RET= inserts a heading at the end of the parent subtree
2674 **** Cycling to the =CONTENTS= view keeps inline tasks folded
2676 [[doc:org-cycle-hook][org-cycle-hook]] as a new function [[doc:org-cycle-hide-inline-tasks][org-cycle-hide-inline-tasks]] which
2677 prevents the display of inline tasks when showing the content of a subtree.
2679 **** =C-c -= in a region makes a list item for each line
2681 This is the opposite of the previous behavior, where =C-c -= on a region
2682 would create one item for the whole region, and where =C-u C-c -= would
2683 create an item for each line.  Now =C-c -= on the selected region creates
2684 an item per line, and =C-u C-c -= creates a single item for the whole
2685 region.
2687 **** When transposing words, markup characters are now part of the words
2689 In Emacs, you can transpose words with =M-t=.  Transposing =*these*
2690 _words__= will preserve markup.
2692 **** New command [[doc:org-set-property-and-value][org-set-property-and-value]] bound to =C-c C-x P=
2694 This command allows you to quickly add both the property and its value.  It
2695 is useful in buffers where there are many properties and where =C-c C-x p=
2696 can slow down the flow of editing too much.
2698 **** New commands [[doc:org-next-block][org-next-block]] and [[doc:org-previous-block][org-previous-block]]
2700 These commands allow you to go to the previous block (=C-c M-b= or the
2701 speedy key =B=) or to the next block (=C-c M-f= or the speedy key =F=.)
2703 **** New commands [[doc:org-drag-line-forward][org-drag-line-forward]] and [[doc:org-drag-line-backward][org-drag-line-backward]]
2705 These commands emulate the old behavior of =M-<down>= and =M-<up>= but are
2706 now bound to =S-M-<down>= and =S-M-<up>= respectively, since =M-<down>= and
2707 =M-<up>= now drag the whole element at point (a paragraph, a table, etc.)
2708 forward and backward.
2710 **** When a list item has a checkbox, inserting a new item uses a checkbox too
2711 **** When sorting entries/items, only the description of links is considered
2713 Now Org will sort this list
2715 : - [[][B]]
2716 : - [[][A]]
2718 like this:
2720 : - [[][A]]
2721 : - [[][B]]
2723 by comparing the descriptions, not the links.
2724 Same when sorting headlines instead of list items.
2725 **** New option =orgstruct-heading-prefix-regexp=
2727 For example, setting this option to "^;;; " in Emacs lisp files and using
2728 =orgstruct-mode= in those files will allow you to cycle through visibility
2729 states as if lines starting with ";;; *..." where headlines.
2731 In general, you want to set =orgstruct-heading-prefix-regexp= as a file
2732 local variable.
2734 **** New behavior of [[doc:org-clone-subtree-with-time-shift][org-clone-subtree-with-time-shift]]
2736 The default is now to ask for a time-shift only when there is a time-stamp.
2737 When called with a universal prefix argument =C-u=, it will not ask for a
2738 time-shift even if there is a time-stamp.
2740 **** New option [[doc:org-agenda-restriction-lock-highlight-subtree][org-agenda-restriction-lock-highlight-subtree]]
2742 This defaults to =t= so that the whole subtree is highlighted when you
2743 restrict the agenda view to it with =C-c C-x <= (or the speed command =<=).
2744 The default setting helps ensuring that you are not adding tasks after the
2745 restricted region.  If you find this highlighting too intrusive, set this
2746 option to =nil=.
2747 **** New option [[doc:org-closed-keep-when-no-todo][org-closed-keep-when-no-todo]]
2749 When switching back from a =DONE= keyword to a =TODO= keyword, Org now
2750 removes the =CLOSED= planning information, if any.  It also removes this
2751 information when going back to a non-TODO state (e.g., with =C-c C-t SPC=).
2752 If you want to keep the =CLOSED= planning information when removing the
2753 TODO keyword, set [[doc:org-closed-keep-when-no-todo][org-closed-keep-when-no-todo]] to =t=.
2755 **** New option [[doc:org-image-actual-width][org-image-actual-width]]
2757 This option allows you to change the width of in-buffer displayed images.
2758 The default is to use the actual width of the image, but you can use a
2759 fixed value for all images, or fall back on an attribute like
2761 : #+attr_html: :width 300px
2762 *** Scheduled/deadline
2764 **** Implement "delay" cookies for scheduled items
2766 If you want to delay the display of a scheduled task in the agenda, you can
2767 now use a delay cookie like this: =SCHEDULED: <2004-12-25 Sat -2d>=.  The
2768 task is still scheduled on the 25th but will appear in your agenda starting
2769 from two days later (i.e. from March 27th.)
2771 Imagine for example that your co-workers are not done in due time and tell
2772 you "we need two more days".  In that case, you may want to delay the
2773 display of the task in your agenda by two days, but you still want the task
2774 to appear as scheduled on March 25th.
2776 In case the task contains a repeater, the delay is considered to affect all
2777 occurrences; if you want the delay to only affect the first scheduled
2778 occurrence of the task, use =--2d= instead.  See [[doc:org-scheduled-delay-days][org-scheduled-delay-days]]
2779 and [[doc:org-agenda-skip-scheduled-delay-if-deadline][org-agenda-skip-scheduled-delay-if-deadline]] for details on how to
2780 control this globally or per agenda.
2782 **** Use =C-u C-u C-c C-s= will insert a delay cookie for scheduled tasks
2784 See the previous section for why delay cookies may be useful.
2786 **** Use =C-u C-u C-c C-d= will insert a warning delay for deadline tasks
2788 =C-u C-u C-c C-d= now inserts a warning delay to deadlines.
2789 *** Calendar, diary and appts
2791 **** New variable [[doc:org-read-date-minibuffer-local-map][org-read-date-minibuffer-local-map]]
2793 By default, this new local map uses "." to go to today's date, like in the
2794 normal =M-x calendar RET=.  If you want to deactivate this and to reassign
2795 the "@" key to =calendar-goto-today=, use this:
2797 #+BEGIN_SRC emacs-lisp
2798   ;; Unbind "." in Org's calendar:
2799   (define-key org-read-date-minibuffer-local-map (kbd ".") nil)
2801   ;; Bind "@" to `calendar-goto-today':
2802   (define-key org-read-date-minibuffer-local-map
2803               (kbd "@")
2804               (lambda () (interactive) (org-eval-in-calendar '(calendar-goto-today))))
2805 #+END_SRC
2807 **** In Org's calendar, =!= displays diary entries of the date at point
2809 This is useful when you want to check if you don't already have an
2810 appointment when setting new ones with =C-c .= or =C-c s=.  =!= will
2811 call =diary-view-entries= and display the diary in a separate buffer.
2813 **** [[doc:org-diary][org-diary]]: only keep the descriptions of links
2815 [[doc:org-diary][org-diary]] returns diary information from Org files, but it returns it
2816 in a diary buffer, not in an Org mode buffer.  When links are displayed,
2817 only show their description, not the full links.
2818 *** Agenda
2820 **** New agenda type =agenda*= and entry types =:scheduled* :deadline*=
2822 When defining agenda custom commands, you can now use =agenda*=: this will
2823 list entries that have both a date and a time.  This is useful when you
2824 want to build a list of appointments.
2826 You can also set [[doc:org-agenda-entry-types][org-agenda-entry-types]] either globally or locally in
2827 each agenda custom command and use =:timestamp*= and/or =:deadline*= there.
2829 Another place where this is useful is your =.diary= file:
2831 : %%(org-diary :scheduled*) ~/org/
2833 This will list only entries from =~/org/ that are scheduled with a
2834 time value (i.e. appointments).
2836 **** New agenda sorting strategies
2838 [[doc:org-agenda-sorting-strategy][org-agenda-sorting-strategy]] allows these new sorting strategies:
2840 | Strategy       | Explanations                             |
2841 |----------------+------------------------------------------|
2842 | timestamp-up   | Sort by any timestamp, early first       |
2843 | timestamp-down | Sort by any timestamp, late first        |
2844 | scheduled-up   | Sort by scheduled timestamp, early first |
2845 | scheduled-down | Sort by scheduled timestamp, late first  |
2846 | deadline-up    | Sort by deadline timestamp, early first  |
2847 | deadline-down  | Sort by deadline timestamp, late first   |
2848 | ts-up          | Sort by active timestamp, early first    |
2849 | ts-down        | Sort by active timestamp, late first     |
2850 | tsia-up        | Sort by inactive timestamp, early first  |
2851 | tsia-down      | Sort by inactive timestamp, late first   |
2853 **** New options to limit the number of agenda entries
2855 You can now limit the number of entries in an agenda view.  This is
2856 different from filters: filters only /hide/ the entries in the agenda,
2857 while limits are set while generating the list of agenda entries.
2859 These new options are available:
2861 - [[doc:org-agenda-max-entries][org-agenda-max-entries]] :: limit by number of entries.
2862 - [[doc:org-agenda-max-todos][org-agenda-max-todos]] :: limit by number of TODOs.
2863 - [[doc:org-agenda-max-tags][org-agenda-max-tags]] :: limit by number of tagged entries.
2864 - [[doc:org-agenda-max-effort][org-agenda-max-effort]] :: limit by effort (minutes).
2866 For example, if you locally set [[doc:org-agenda-max-todos][org-agenda-max-todos]] to 3 in an agenda
2867 view, the agenda will be limited to the first three todos.  Other entries
2868 without a TODO keyword or beyond the third TODO headline will be ignored.
2870 When setting a limit (e.g. about an effort's sum), the default behavior is
2871 to exclude entries that cannot be checked against (e.g. entries that have
2872 no effort property.)  To include other entries too, you can set the limit
2873 to a negative number.  For example =(setq org-agenda-max-tags -3)= will not
2874 show the fourth tagged headline (and beyond), but it will also show
2875 non-tagged headlines.
2877 **** =~= in agenda view sets temporary limits
2879 You can hit =~= in the agenda to temporarily set limits: this will
2880 regenerate the agenda as if the limits were set.  This is useful for
2881 example when you want to only see a list of =N= tasks, or a list of tasks
2882 that take only =N= minutes.
2884 **** "=" in agenda view filters by regular expressions
2886 You can now filter agenda entries by regular expressions using ~=~.  =C-u
2887 == will filter entries out.  Regexp filters are cumulative.  You can set
2888 [[doc:org-agenda-regexp-filter-preset][org-agenda-regexp-filter-preset]] to suit your needs in each agenda view.
2890 **** =|= in agenda view resets all filters
2892 Since it's common to combine tag filters, category filters, and now regexp
2893 filters, there is a new command =|= to reset all filters at once.
2895 **** Allow writing an agenda to an file
2897 You can now write an agenda view to an file.  It copies the
2898 headlines and their content (but not subheadings) into the new file.
2900 This is useful when you want to quickly share an agenda containing the full
2901 list of notes.
2903 **** New commands to drag an agenda line forward (=M-<down>=) or backward (=M-<up>=)
2905 It sometimes handy to move agenda lines around, just to quickly reorganize
2906 your tasks, or maybe before saving the agenda to a file.  Now you can use
2907 =M-<down>= and =M-<up>= to move the line forward or backward.
2909 This does not persist after a refresh of the agenda, and this does not
2910 change the files who contribute to the agenda.
2912 **** Use =%b= for displaying "breadcrumbs" in the agenda view
2914 [[doc:org-agenda-prefix-format][org-agenda-prefix-format]] now allows to use a =%b= formatter to tell Org
2915 to display "breadcrumbs" in the agenda view.
2917 This is useful when you want to display the task hierarchy in your agenda.
2919 **** Use =%l= for displaying the headline's level in the agenda view
2921 [[doc:org-agenda-prefix-format][org-agenda-prefix-format]] allows to use a =%l= formatter to tell Org to
2922 display entries with additional spaces corresponding to their level in the
2923 outline tree.
2925 **** [[doc:org-agenda-write][org-agenda-write]] will ask before overwriting an existing file
2927 =M-x org-agenda-write RET= (or =C-c C-w= from an agenda buffer) used to
2928 overwrite preexisting file with the same name without confirmation.  It now
2929 asks for a confirmation.
2931 **** New commands =M-m= and =M-*= to toggle (all) mark(s) for bulk action
2933 - [[doc:org-agenda-bulk-toggle][org-agenda-bulk-toggle]] :: this command is bound to =M-m= and toggles
2934      the mark of the entry at point.
2936 - [[doc:org-agenda-bulk-toggle-all][org-agenda-bulk-toggle-all]] :: this command is bound to =M-*= and
2937      toggles all the marks in the current agenda.
2939 **** New option [[doc:org-agenda-search-view-max-outline-level][org-agenda-search-view-max-outline-level]]
2941 This option sets the maximum outline level to display in search view.
2942 E.g. when this is set to 1, the search view will only show headlines of
2943 level 1.
2945 **** New option [[doc:org-agenda-todo-ignore-time-comparison-use-seconds][org-agenda-todo-ignore-time-comparison-use-seconds]]
2947 This allows to compare times using seconds instead of days when honoring
2948 options like =org-agenda-todo-ignore-*= in the agenda display.
2950 **** New option [[doc:org-agenda-entry-text-leaders][org-agenda-entry-text-leaders]]
2952 This allows you to get rid of the ">" character that gets added in front of
2953 entries excerpts when hitting =E= in the agenda view.
2955 **** New formatting string for past deadlines in [[doc:org-agenda-deadline-leaders][org-agenda-deadline-leaders]]
2957 The default formatting for past deadlines is ="%2d d. ago: "=, which makes
2958 it explicit that the deadline is in the past.  You can configure this via
2959 [[doc:org-agenda-deadline-leaders][org-agenda-deadline-leaders]].  Note that the width of the formatting
2960 string is important to keep the agenda alignment clean.
2962 **** New allowed value =repeated-after-deadline= for [[doc:org-agenda-skip-scheduled-if-deadline-is-shown][org-agenda-skip-scheduled-if-deadline-is-shown]]
2964 When [[doc:org-agenda-skip-scheduled-if-deadline-is-shown][org-agenda-skip-scheduled-if-deadline-is-shown]] is set to
2965 =repeated-after-deadline=, the agenda will skip scheduled items if they are
2966 repeated beyond the current deadline.
2968 **** New option for [[doc:org-agenda-skip-deadline-prewarning-if-scheduled][org-agenda-skip-deadline-prewarning-if-scheduled]]
2970 This variable may be set to nil, t, the symbol `pre-scheduled', or a number
2971 which will then give the number of days before the actual deadline when the
2972 prewarnings should resume.  The symbol `pre-scheduled' eliminates the
2973 deadline prewarning only prior to the scheduled date.
2975 Read the full docstring for details.
2977 **** [[doc:org-class][org-class]] now supports holiday strings in the skip-weeks parameter
2979 For example, this task will now be skipped only on new year's day:
2981     : * Task
2982     :   <%%(org-class 2012 1 1 2013 12 12 2 "New Year's Day")>
2983 *** Capture
2985 **** Allow =C-1= as a prefix for [[doc:org-agenda-capture][org-agenda-capture]] and [[doc:org-capture][org-capture]]
2987 With a =C-1= prefix, the capture mechanism will use the =HH:MM= value at
2988 point (if any) or the current =HH:MM= time as the default time for the
2989 capture template.
2991 **** Expand keywords within %(sexp) placeholder in capture templates
2993 If you use a =%:keyword= construct within a =%(sexp)= construct, Org will
2994 expand the keywords before expanding the =%(sexp)=.
2996 **** Allow to contextualize capture (and agenda) commands by checking the name of the buffer
2998 [[doc:org-capture-templates-contexts][org-capture-templates-contexts]] and [[doc:org-agenda-custom-commands-contexts][org-agenda-custom-commands-contexts]]
2999 allow you to define what capture templates and what agenda commands should
3000 be available in various contexts.  It is now possible for the context to
3001 check against the name of the buffer.
3002 *** Tag groups
3004 Using =#+TAGS: { Tag1 : Tag2 Tag3 }= will define =Tag1= as a /group tag/
3005 (note the colon after =Tag1=).  If you search for =Tag1=, it will return
3006 headlines containing either =Tag1=, =Tag2= or =Tag3= (or any combination
3007 of those tags.)
3009 You can use group tags for sparse tree in an Org buffer, for creating
3010 agenda views, and for filtering.
3012 See for details.
3014 *** Links
3016 **** =C-u C-u M-x org-store-link RET= will ignore non-core link functions
3018 Org knows how to store links from Org buffers, from info files and from
3019 other Emacs buffers.  Org can be taught how to store links from any buffer
3020 through new link protocols (see [[]["Adding hyperlink types"]] in the manual.)
3022 Sometimes you want Org to ignore added link protocols and store the link
3023 as if the protocol was not known.
3025 You can now do this with =C-u C-u M-x org-store-link RET=.
3027 **** =C-u C-u C-u M-x org-store-link RET= on an active region will store links for each lines
3029 Imagine for example that you want to store a link for every message in a
3030 Gnus summary buffer.  In that case =C-x h C-u C-u C-u M-x org-store-link
3031 RET= will store a link for every line (i.e. message) if the region is
3032 active.
3034 **** =C-c C-M-l= will add a default description for links which don't have one
3036 =C-c C-M-l= inserts all stored links.  If a link does not have a
3037 description, this command now adds a default one, so that we are not mixing
3038 with-description and without-description links when inserting them.
3040 **** No curly braces to bracket links within internal links
3042 When storing a link to a headline like
3044 : * See [[][Org website]]
3046 [[doc:org-store-link][org-store-link]] used to convert the square brackets into curly brackets.
3047 It does not anymore, taking the link description or the link path, when
3048 there is no description.
3049 *** Table
3051 **** Switching between #+TBLFM lines
3053 If you have several =#+TBLFM= lines below a table, =C-c C-c= on a line will
3054 apply the formulas from this line, and =C-c C-c= on another line will apply
3055 those other formulas.
3057 **** You now use "nan" for empty fields in Calc formulas
3059 If empty fields are of interest, it is recommended to reread the section
3060 [[][3.5.2 Formula syntax for Calc]] of the manual because the description for the
3061 mode strings has been clarified and new examples have been added towards
3062 the end.
3064 **** Handle localized time-stamps in formulas evaluation
3066 If your =LOCALE= is set so that Org time-stamps use another language than
3067 english, and if you make time computations in Org's table, it now works by
3068 internally converting the time-stamps with a temporary =LOCALE=C= before
3069 doing computation.
3071 **** New lookup functions
3073 There are now three lookup functions:
3075 - [[doc:org-loopup-first][org-loopup-first]]
3076 - [[doc:org-loopup-last][org-loopup-last]]
3077 - [[doc:org-loopup-all][org-loopup-all]]
3079 See [[][the manual]] for details.
3080 *** Startup keywords
3082 These new startup keywords are now available:
3084 | Startup keyword                  | Option                                      |
3085 |----------------------------------+---------------------------------------------|
3086 | =#+STARTUP: logdrawer=           | =(setq org-log-into-drawer t)=              |
3087 | =#+STARTUP: nologdrawer=         | =(setq org-log-into-drawer nil)=            |
3088 |----------------------------------+---------------------------------------------|
3089 | =#+STARTUP: logstatesreversed=   | =(setq org-log-states-order-reversed t)=    |
3090 | =#+STARTUP: nologstatesreversed= | =(setq org-log-states-order-reversed nil)=  |
3091 |----------------------------------+---------------------------------------------|
3092 | =#+STARTUP: latexpreview=        | =(setq org-startup-with-latex-preview t)=   |
3093 | =#+STARTUP: nolatexpreview=      | =(setq org-startup-with-latex-preview nil)= |
3095 *** Clocking
3097 **** New option [[doc:org-clock-rounding-minutes][org-clock-rounding-minutes]]
3099 E.g. if [[doc:org-clock-rounding-minutes][org-clock-rounding-minutes]] is set to 5, time is 14:47 and you
3100 clock in: then the clock starts at 14:45.  If you clock out within the next
3101 5 minutes, the clock line will be removed; if you clock out 8 minutes after
3102 your clocked in, the clock out time will be 14:50.
3104 **** New option [[doc:org-time-clocksum-use-effort-durations][org-time-clocksum-use-effort-durations]]
3106 When non-nil, =C-c C-x C-d= uses effort durations.  E.g., by default, one
3107 day is considered to be a 8 hours effort, so a task that has been clocked
3108 for 16 hours will be displayed as during 2 days in the clock display or in
3109 the clocktable.
3111 See [[doc:org-effort-durations][org-effort-durations]] on how to set effort durations and
3112 [[doc:org-time-clocksum-format][org-time-clocksum-format]] for more on time clock formats.
3114 **** New option [[doc:org-clock-x11idle-program-name][org-clock-x11idle-program-name]]
3116 This allows to set the name of the program which prints X11 idle time in
3117 milliseconds.  The default is to use =x11idle=.
3119 **** New option [[doc:org-use-last-clock-out-time-as-effective-time][org-use-last-clock-out-time-as-effective-time]]
3121 When non-nil, use the last clock out time for [[doc:org-todo][org-todo]].  Note that this
3122 option has precedence over the combined use of [[doc:org-use-effective-time][org-use-effective-time]] and
3123 [[doc:org-extend-today-until][org-extend-today-until]].
3125 **** =S-<left/right>= on a clocksum column will update the sum by updating the last clock
3126 **** =C-u 3 C-S-<up/down>= will update clock timestamps synchronously by 3 units
3127 **** New parameter =:wstart= for clocktables to define the week start day
3128 **** New parameter =:mstart= to state the starting day of the month
3129 **** Allow relative times in clocktable tstart and tend options
3130 **** The clocktable summary is now a caption
3131 **** =:tstart= and =:tend= and friends allow relative times like "<-1w>" or "<now>"
3132 *** Babel
3134 **** You can now use =C-c C-k= for [[doc:org-edit-src-abort][org-edit-src-abort]]
3136 This allows you to quickly cancel editing a source block.
3138 **** =C-u C-u M-x org-babel-tangle RET= tangles by the target file of the block at point
3140 This is handy if you want to tangle all source code blocks that have the
3141 same target than the block at point.
3143 **** New options for auto-saving the base buffer or the source block editing buffer
3145 When [[doc:org-edit-src-turn-on-auto-save][org-edit-src-turn-on-auto-save]] is set to =t=, editing a source block
3146 in a new window will turn on =auto-save-mode= and save the code in a new
3147 file under the same directory than the base Org file.
3149 When [[doc:org-edit-src-auto-save-idle-delay][org-edit-src-auto-save-idle-delay]] is set to a number of minutes =N=,
3150 the base Org buffer will be saved after this number of minutes of idle
3151 time.
3153 **** New =:post= header argument post-processes results
3155      This header argument may be used to pass the results of the current
3156      code block through another code block for post-processing.  See the
3157      manual for a usage example.
3159 **** Commented out heading are ignored when collecting blocks for tangling
3161 If you comment out a heading (with =C-c ;= anywhere on the heading or in
3162 the subtree), code blocks from within this heading are now ignored when
3163 collecting blocks for tangling.
3165 **** New option [[doc:org-babel-hash-show-time][org-babel-hash-show-time]] to show a time-stamp in the result hash
3166 **** Do not ask for confirmation if cached value is current
3168 Do not run [[doc:org-babel-confirm-evaluate][org-babel-confirm-evaluate]] if source block has a cache and the
3169 cache value is current as there is no evaluation involved in this case.
3170 **** =ob-sql.el= and =ob-python.el= have been improved.
3171 **** New Babel files only need to =(require 'ob)=
3173 When writing a new Babel file, you now only need to use =(require 'ob)=
3174 instead of requiring each Babel library one by one.
3175 *** Faces
3177 - Org now fontifies radio link targets by default
3178 - In the agenda, use [[doc:org-todo-keyword-faces][org-todo-keyword-faces]] to highlight selected TODO keywords
3179 - New face [[doc:org-priority][org-priority]], enhanced fontification of priority cookies in agenda
3180 - New face [[doc:org-tag-group][org-tag-group]] for group tags
3182 ** Miscellaneous
3184 - New speedy key =s= pour [[doc:org-narrow-to-subtree][org-narrow-to-subtree]]
3185 - Handling of [[doc:org-html-table-row][org-html-table-row]] has been updated (incompatible change)
3186 - [[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]]
3187 - Support using =git-annex= with Org attachments
3188 - org-protocol: Pass optional value using query in url to capture from protocol
3189 - When the refile history is empty, use the current filename as default
3190 - When you cannot change the TODO state of a task, Org displays the blocking task
3191 - New option [[doc:org-mobile-allpriorities][org-mobile-allpriorities]]
3192 - org-bibtex.el now use =visual-line-mode= instead of the deprecated =longlines-mode=
3193 - [[doc:org-format-latex-options][org-format-latex-options]] allows to set the foreground/background colors automatically
3194 - New option [[doc:org-archive-file-header-format][org-archive-file-header-format]]
3195 - New "neg" entity in [[doc:org-entities][org-entities]]
3196 - New function [[doc:org-docview-export][org-docview-export]] to export docview links
3197 - New =:eps= header argument for ditaa code blocks
3198 - New option [[doc:org-gnus-no-server][org-gnus-no-server]] to start Gnus with =gnus-no-server=
3199 - Org is now distributed with =htmlize.el= version 1.43
3200 - ~org-drill.el~ has been updated to version 2.3.7
3201 - ~org-mac-iCal.el~ now supports OS X versions up to 10.8
3202 - Various improvements to ~org-contacts.el~ and =orgpan.el=
3204 ** Outside Org
3206 *** Spanish translation of the Org guide by David Arroyo Menéndez
3208 David (and others) translated the Org compact guide in spanish:
3210 You can read the [[][PDF guide]].
3212 *** ~poporg.el~ and ~outorg.el~
3214 Two new libraries (~poporg.el~ by François Pinard and ~outorg.el~ by
3215 Thorsten Jolitz) now enable editing of comment-sections from source-code
3216 buffers in temporary Org-mode buffers, making the full editing power of
3217 Org-mode available.  ~outorg.el~ comes together with ~outshine.el~ and
3218 ~navi-mode.el~, two more libraries by Thorsten Jolitz with the goal to give
3219 source-code buffers the /look & feel/ of Org-mode buffers while greatly
3220 improving navigation and structure editing.  A detailed description can be
3221 found here:
3223 Here are two screencasts demonstrating Thorsten's tools:
3225 - [[]["Modern conventions for Emacs Lisp files"]]
3226 - [[][Exploring Bernt Hansen's Org-mode tutorial with 'navi-mode']]
3228 *** MobileOrg for iOS
3230 MobileOrg for iOS back in the App Store The 1.6.0 release was focused on
3231 the new Dropbox API and minor bug fixes but also includes a new ability to
3232 launch in Capture mode.  Track development and contribute [[][on github]].
3234 * Version 7.9.3
3236 ** New option [[doc::org-agenda-use-tag-inheritance][org-agenda-use-tag-inheritance]]
3238 [[doc::org-use-tag-inheritance][org-use-tag-inheritance]] controls whether tags are inherited when
3239 org-tags-view is called (either in =tags=, =tags-tree= or =tags-todo=
3240 agenda views.)
3242 When generating other agenda types such as =agenda=, =todo= and
3243 =todo-tree=, tags inheritance is not used when selecting the entries
3244 to display.  Still, you might want to have all tag information correct
3245 in the agenda buffer, e.g. for tag filtering.  In that case, add the
3246 agenda type to this variable.
3248 Setting this variable to nil should considerably speeds up the agenda
3249 generation.
3251 Note that the default was to display inherited tags in the agenda
3252 lines even if `org-use-tag-inheritance' was nil.  The default is now
3253 to *never* display inherited tags in agenda lines, but to /know/ about
3254 them when the agenda type is listed in [[doc::org-agenda-use-tag-inheritance][org-agenda-use-tag-inheritance]].
3256 ** New default value nil for [[doc::org-agenda-dim-blocked-tasks][org-agenda-dim-blocked-tasks]]
3258 Using `nil' as the default value speeds up the agenda generation.  You
3259 can hit `#' (or `C-u #') in agenda buffers to temporarily dim (or turn
3260 invisible) blocked tasks.
3262 ** New speedy keys for [[doc::org-speed-commands-default][org-speed-commands-default]]
3264 You can now use `:' (instead of `;') for setting tags---this is
3265 consistent with using the `:' key in agenda view.
3267 You can now use `=' for [[doc::org-columns][org-columns]].
3269 ** =org-float= is now obsolete, use =diary-float= instead
3270 ** No GPL manual anymore
3272 There used to be a GPL version of the Org manual, but this is not the
3273 case anymore, the Free Software Foundation does not permit this.
3275 The GNU FDL license is now included in the manual directly.
3277 ** Enhanced compatibility with Emacs 22 and XEmacs
3279 Thanks to Achim for his work on enhancing Org's compatibility with
3280 various Emacsen.  Things may not be perfect, but Org should work okay
3281 in most environments.
3283 * Version 7.9.2
3285 ** New ELPA repository for Org packages
3287 You can now add the Org ELPA repository like this:
3289 #+BEGIN_SRC emacs-lisp
3290 (add-to-list 'package-archives '("org" . "") t)
3291 #+END_SRC
3293 It contains both the =org-*.tar= package (the core Org distribution, also
3294 available through and the =org-plus*.tar= package (the
3295 extended Org distribution, with non-GNU packages from the =contrib/=
3296 directory.)
3298 See
3300 ** Overview of the new keybindings
3302    | Keybinding      | Speedy | Command                     |
3303    |-----------------+--------+-----------------------------|
3304    | =C-c C-x C-z=   |        | [[doc::org-clock-resolve][org-clock-resolve]]           |
3305    | =C-c C-x C-q=   |        | [[doc::org-clock-cancel][org-clock-cancel]]            |
3306    | =C-c C-x C-x=   |        | [[doc::org-clock-in-last][org-clock-in-last]]           |
3307    | =M-h=           |        | [[doc::org-mark-element][org-mark-element]]            |
3308    | =*=             |        | [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]]    |
3309    | =C-c C-M-l=     |        | [[doc::org-insert-all-links][org-insert-all-links]]        |
3310    | =C-c C-x C-M-v= |        | [[doc::org-redisplay-inline-images][org-redisplay-inline-images]] |
3311    | =C-c C-x E=     | =E=    | [[doc::org-inc-effort][org-inc-effort]]              |
3312    |                 | =#=    | [[doc::org-toggle-comment][org-toggle-comment]]          |
3313    |                 | =:=    | [[doc::org-columns][org-columns]]                 |
3314    |                 | =W=    | Set =APPT_WARNTIME=         |
3315    | =k=             |        | [[doc::org-agenda-capture][org-agenda-capture]]          |
3316    | C-c ,           | ,      | [[doc::org-priority][org-priority]]                |
3318 ** New package and Babel language
3320 *** =org-eshell.el= by Konrad Hinsen is now in Org
3322     =org-eshell.el= allows you to create links from [[][Eshell]].
3324 *** Support for execution of Scala code blocks (see ob-scala.el)
3325 *** Support for execution of IO code blocks (see ob-io.el)
3327 ** Incompatible changes
3329    - If your code relies on =org-write-agenda=, please use
3330      [[doc::org-agenda-write][org-agenda-write]] from now on.
3332    - If your code relies on =org-make-link=, please use =concat=
3333      instead.
3335    - =org-link-to-org-use-id= has been renamed to
3336      =org-id-link-to-org-use-id= and its default value is nil.  The
3337      previous default was =create-if-interactive-and-no-custom-id=.
3339 ** New features and user-visible changes
3341 *** Org Element
3343     =org-element.el= is a toolbox for parsing and analyzing "elements"
3344     in an Org-mode buffer.  This has been written by Nicolas Goaziou
3345     and has been tested for quite some time.  It is now part of Org's
3346     core and many core functions rely on this package.
3348     Two functions might be particularly handy for users:
3349     =org-element-at-point= and =org-element-context=.
3351     See the docstrings for more details.
3353     Below is a list of editing and navigating commands that now rely
3354     on =org-element.el=.
3356 **** [[doc::org-fill-paragraph][org-fill-paragraph]] has been completely rewritten
3358      The filling mechanisms now rely on org-element, trying to do the
3359      right thing on each element in various contexts.  E.g. filling in
3360      a list item will preserve indentation; filling in message-mode
3361      will fall back on the relevant filling functions; etc.
3363 **** [[doc::org-metaup][org-metaup]] and [[doc::org-metadown][org-metadown]] will drag the element backward/forward
3365      If you want to get the old behavior (i.e. moving a line up and
3366      down), you can first select the line as an active region, then
3367      =org-metaup= or =org-metadown= to move the region backward or
3368      forward.  This also works with regions bigger than just one line.
3370 **** [[doc::org-up-element][org-up-element]] and [[doc::org-down-element][org-down-element]] (respectively =C-c C-^= and =C-c C-_=)
3372      This will move the point up/down in the hierarchy of elements.
3374 **** [[doc::org-backward-element][org-backward-element]] and [[doc::org-forward-element][org-forward-element]] (respectively =M-{= and =M-}=)
3376      This will move the point backward/forward in the hierarchy of
3377      elements.
3379 **** [[doc::org-narrow-to-element][org-narrow-to-element]] will narrow to the element at point
3380 **** [[doc::org-mark-element][org-mark-element]] will mark the element at point
3382      This command is bound to =M-h= and will mark the element at
3383      point.  If the point is at a paragraph, it will mark the
3384      paragraph.  If the point is at a list item, it will mark the list
3385      item.  Etc.
3387      Note that if point is at the beginning of a list, it will mark
3388      the whole list.
3390      To mark a subtree, you can either use =M-h= on the headline
3391      (since there is no ambiguity about the element you're at) or
3392      [[doc::org-mark-subtree][org-mark-subtree]] (=C-c @=) anywhere in the subtree.
3394      Invoking [[doc::org-mark-element][org-mark-element]] repeatedly will try to mark the next
3395      element on top of the previous one(s).  E.g. hitting =M-h= twice
3396      on a headline will mark the current subtree and the next one on
3397      the same level.
3399 *** Org Agenda
3401 **** New option [[doc::org-agenda-sticky][org-agenda-sticky]]
3403      There is a new option =org-agenda-sticky= which enables "sticky"
3404      agendas.  Sticky agendas remain opened in the background so that
3405      you don't need to regenerate them each time you hit the
3406      corresponding keystroke.  This is a big time saver.
3408      When [[doc::org-agenda-sticky][org-agenda-sticky]] is =non-nil=, the agenda buffer will be
3409      named using the agenda key and its description.  In sticky
3410      agendas, the =q= key will just bury the agenda buffers and
3411      further agenda commands will show existing buffer instead of
3412      generating new ones.
3414      If [[doc::org-agenda-sticky][org-agenda-sticky]] is set to =nil=, =q= will kill the single
3415      agenda buffer.
3417 **** New option [[doc::org-agenda-custom-commands-contexts][org-agenda-custom-commands-contexts]]
3419      Setting this option allows you to define specific context where
3420      agenda commands should be available from.  For example, when set
3421      to this value
3423      #+BEGIN_SRC emacs-lisp
3424   (setq org-agenda-custom-commands-contexts
3425         '(("p" (in-file . "\\.txt"))))
3426 #+END_SRC
3428      then the =p= agenda command will only be available from buffers
3429      visiting *.txt files.  See the docstring and the manual for more
3430      details on how to use this.
3432 **** Changes in bulk actions
3434      The set of commands starting with =k ...= as been deleted and the
3435      features have been merged into the "bulk action" feature.
3437      After you marked some entries in the agenda, if you call =B s=,
3438      the agenda entries will be rescheduled using the date at point if
3439      on a date header.  If you are on an entry with a timestamp, you
3440      will be prompted for a date to reschedule your marked entries to,
3441      using the timestamp at point as the default prompt.
3443      You can now use =k= to capture the marked entry and use the date
3444      at point as an overriding date for the capture template.
3446      To bind this behavior to =M-x org-capture RET= (or its
3447      keybinding), set the new option [[doc::org-capture-use-agenda-date][org-capture-use-agenda-date]] to
3448      =t=.
3450 **** =N= and =P= in the agenda will move to the next/previous item
3452 **** New command [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]] to mark all items
3454      This new command is bound to =*= in agenda mode.
3456      There is also a new option [[doc::org-agenda-bulk-mark-char][org-agenda-bulk-mark-char]] to set the
3457      character to use as a mark for bulk actions.
3459 **** New option [[doc::org-agenda-persistent-marks][org-agenda-persistent-marks]]
3461      When set to =non-nil=, marks will remain visible after a bulk
3462      action.  You can temporarily toggle this by pressing =p= when
3463      invoking [[doc::org-agenda-bulk-action][org-agenda-bulk-action]].  Marks are deleted if your
3464      rebuild the agenda buffer or move to another date/span (e.g. with
3465      =f= or =w=).
3467 **** New option [[doc::org-agenda-skip-timestamp-if-deadline-is-shown][org-agenda-skip-timestamp-if-deadline-is-shown]]
3469      =Non-nil= means skip timestamp line if same entry shows because
3470      of deadline.
3472      In the agenda of today, an entry can show up multiple times
3473      because it has both a plain timestamp and has a nearby deadline.
3474      When this variable is t, then only the deadline is shown and the
3475      fact that the entry has a timestamp for or including today is not
3476      shown.  When this variable is =nil=, the entry will be shown
3477      several times.
3479 **** New =todo-unblocked= and =nottodo-unblocked= skip conditions
3481      See the [[][git commit]] for more explanations.
3483 **** Allow category filtering in the agenda
3485      You can now filter the agenda by category.  Pressing "<" will
3486      filter by the category of the item on the current line, and
3487      pressing "<" again will remove the filter.  You can combine tag
3488      filters and category filters.
3490      You can use =org-agenda-category-filter= in your custom agenda
3491      views and =org-agenda-category-filter-preset= in your main
3492      configuration.
3494      See also the new command [[doc::org-agenda-filter-by-top-category][org-agenda-filter-by-top-category]]:
3495      hitting =^= will filter by "Top" category: only show entries that
3496      are of the same category than the Top category of the entry at
3497      point.
3499 *** Org Links
3501 **** Inserting links
3503      When inserting links through [[doc::org-insert-link][org-insert-link]], the description is
3504      now displayed first, followed by the literal link, as the
3505      description is often more useful when you look for the link you
3506      want to insert.
3508      Completion now complete both literal links and description.  If
3509      you complete a description, the literal link and its description
3510      will be inserted directly, whereas when you complete the literal
3511      link, you will be prompted for a description (as with Org 7.8.)
3513      In the completion buffer, links to the current buffer are now
3514      highlighted.
3516 **** New templates =%h= and =%(sexp)= for abbreviated links
3518      On top of =%s= template, which is replaced by the link tag in
3519      abbreviated links, you can now use =%h= (which does the same than =%s=
3520      but does not hexify the tag) and =%(sexp)= (which can run a function
3521      that takes the tag as its own argument.)
3523 **** New link type =help=
3525      You can now create links from =help= buffers.
3527      For example, if you request help for the command [[doc::org-agenda][org-agenda]] with
3528      =C-h f org-agenda RET=, creating a link from this buffer will let
3529      you go back to the same buffer.
3531 **** New command [[doc::org-insert-all-links][org-insert-all-links]]
3533      This will insert all links as list items.  With a universal
3534      prefix argument, links will not be deleted from the variable
3535      =org-stored-links=.
3537      This new command is bound to =C-c C-M-l=.
3539 **** New option [[doc::org-url-hexify-p][org-url-hexify-p]]
3541      When set to =nil=, the =URL= part of a link will not be hexified.
3543 **** Org can now open multiple shell links
3545 **** New option [[doc::org-doi-server-url][org-doi-server-url]] to specify an alternate DOI server
3547 **** RET now follows time stamps links
3549 *** Org Editing
3551 **** [[doc::org-todo][org-todo]] and =org-archive-*= can now loop in the active region
3553      When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, using
3554      [[doc::org-todo][org-todo]] or =org-archive-*= commands in the active region will
3555      loop over headlines.  This is handy if you want to set the TODO
3556      keyword for several items, or archive them quickly.
3558 **** You can now set tags for headlines in a region
3560      If [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, then
3561      selecting the region and hitting =C-c C-q= will set the tags for
3562      all headlines in the region.
3564 **** New command [[doc::org-insert-drawer][org-insert-drawer]] to insert a drawer interactively
3566 **** Comments start with "^[ \t]*# " anywhere on a line
3568      Note that the space after the hashtag is mandatory.  Comments
3569      with "^#+" are not supported anymore.
3571 **** New speed key =#= to toggle the COMMENT cookie on a headline
3573 **** =indent-region-function= is now set to [[doc::org-indent-region][org-indent-region]]
3575      =C-M-\= should now produce useful results.
3577      You can unindent the buffer with [[doc::org-unindent-buffer][org-unindent-buffer]].
3579 **** New option [[doc::org-allow-promoting-top-level-subtree][org-allow-promoting-top-level-subtree]]
3581      When =non-nil=, =S-M-<left>= will promote level-1 subtrees
3582      containing other subtrees.  The level-1 headline will be
3583      commented out.  You can revert to the previous state with =M-x
3584      undo RET=.
3586 *** Org Clock
3588 **** New keybinding =C-c C-x C-z= for [[doc::org-clock-resolve][org-clock-resolve]]
3590 **** New keybinding =C-c C-x C-q= for [[doc::org-clock-cancel][org-clock-cancel]]
3592 **** New command [[doc::org-clock-in-last][org-clock-in-last]] to clock in the last clocked item
3594      This command is bound to =C-c C-x C-x= and will clock in the last
3595      clocked entry, if any.
3597 **** =C-u M-x= [[doc::org-clock-out][org-clock-out]] =RET= now prompts for a state to switch to
3599 **** =S-M-<up/down>= on a clock timestamps adjusts the previous/next clock
3601 **** New option [[doc::org-clock-continuously][org-clock-continuously]]
3603      When set to =nil=, clocking in a task will first try to find the
3604      last clocked out task and restart from when that task was clocked
3605      out.
3607      You can temporarily activate continuous clocking with =C-u C-u
3608      C-u M-x= [[doc::org-clock-in][org-clock-in]] =RET= (three universal prefix arguments)
3609      and =C-u C-u M-x= [[org-clock-in-last][org-clock-in-last]] =RET= (two universal prefix
3610      arguments).
3613 **** New option [[doc::org-clock-frame-title-format][org-clock-frame-title-format]]
3615      This option sets the value of =frame-title-format= when clocking
3616      in.
3618 **** New options for controlling the clockreport display
3620      [[doc::org-clock-file-time-cell-format][org-clock-file-time-cell-format]]: Format string for the file time
3621      cells in clockreport.
3623      [[doc::org-clock-total-time-cell-format][org-clock-total-time-cell-format]]: Format string for the total
3624      time cells in clockreport.
3627 **** New options for controlling the clock/timer display
3629      [[doc::org-clock-clocked-in-display][org-clock-clocked-in-display]]: control whether the current clock
3630      is displayed in the mode line and/or frame title.
3632      [[doc::org-timer-display][org-timer-display]]: control whether the current timer is displayed
3633      in the mode line and/or frame title.
3635      This allows the clock and timer to be displayed in the frame
3636      title instead of, or as well as, the mode line.  This is useful
3637      for people with limited space in the mode line but with ample
3638      space in the frame title.
3640 *** Org Appearance
3642 **** New option [[doc::org-custom-properties][org-custom-properties]]
3644      The visibility of properties listed in this options can be turn
3645      on/off with [[doc::org-toggle-custom-properties-visibility][org-toggle-custom-properties-visibility]].  This might
3646      be useful for properties used by third-part tools or that you
3647      don't want to see temporarily.
3649 **** New command [[doc::org-redisplay-inline-images][org-redisplay-inline-images]]
3651      This will redisplay all images.  It is bound to =C-c C-x C-M-v=.
3653 **** New entities in =org-entities.el=
3655      There are these new entities:
3657      : ("tilde" "\\~{}" nil "&tilde;" "~" "~" "~")
3658      : ("slash" "/" nil "/" "/" "/" "/")
3659      : ("plus" "+" nil "+" "+" "+" "+")
3660      : ("under" "\\_" nil "_" "_" "_" "_")
3661      : ("equal" "=" nil "=" "=" "=" "=")
3662      : ("asciicirc" "\\textasciicircum{}" nil "^" "^" "^" "^")
3664 **** New face =org-list-dt= for definition terms
3665 **** New face =org-date-selected= for the selected calendar day
3666 **** New face value for =org-document-title=
3668      The face is back to a normal height.
3670 *** Org Columns
3672 **** New speed command =:= to activate the column view
3673 **** New special property =CLOCKSUM_T= to display today's clocked time
3675      You can use =CLOCKSUM_T= the same way you use =CLOCKSUM=.  It
3676      will display the time spent on tasks for today only.
3678 **** Use the =:COLUMNS:= property in columnview dynamic blocks
3680      If the =:COLUMNS:= is set in a subtree, the columnview dynamic
3681      block will use its value as the column format.
3683 **** Consider inline tasks when computing a sum
3685 *** Org Dates and Time Stamps
3687 **** Enhanced [[doc::org-sparse-tree][org-sparse-tree]]
3689      =C-c /= can now check for time ranges.
3691      When checking for dates with =C-c /= it is useful to change the
3692      type of dates that you are interested in.  You can now do this
3693      interactively with =c= after =C-c /= and/or by setting
3694      [[doc::org-sparse-tree-default-date-type][org-sparse-tree-default-date-type]] to the default value you want.
3696 **** Support for hourly repeat cookies
3698      You can now use
3700      : SCHEDULED: <2012-08-20 lun. 08:00 +1h>
3702      if you want to add an hourly repeater to an entry.
3704 **** =C-u C-u C-c .= inserts a time-stamp with no prompt
3706 **** When (setq [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] 'time), accept days in the prompt
3708      "8am Wed" and "Wed 8am" are now acceptable values when entering a
3709      date from the prompt.  If [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] is set to
3710      =time=, this will produce the expected prompt indication.
3712 **** New option [[doc::org-datetree-add-timestamp][org-datetree-add-timestamp]]
3714      When set to =non-nil=, datetree entries will also have a
3715      timestamp.  This is useful if you want to see these entries in a
3716      sparse tree with =C-c /=.
3718 *** Org Capture
3720 **** New command [[doc::org-capture-string][org-capture-string]]
3722      M-x [[doc::org-capture-string][org-capture-string]] RET will prompt for a string and a capture
3723      template.  The string will be used as an annotation for the
3724      template.  This is useful when capturing in batch mode as it lets
3725      you define the content of the template without being in Emacs.
3727 **** New option [[doc::org-capture-templates-contexts][org-capture-templates-contexts]]
3729      Setting this option allows you to define specific context where
3730      capture templates should be available from.  For example, when
3731      set to this value
3733      #+BEGIN_SRC emacs-lisp
3734   (setq org-capture-templates-contexts
3735         '(("c" (in-mode . "message-mode"))))
3736 #+END_SRC
3738      then the =c= capture template will only be available from
3739      =message-mode= buffers.  See the docstring and the manual for
3740      more details on how to use this.
3742 **** New =%l= template to insert the literal link
3743 **** New option [[doc::org-capture-bookmark][org-capture-bookmark]]
3745      Org used to automatically add a bookmark with capture a note.
3746      You can now turn this on by setting [[doc::org-capture-bookmark][org-capture-bookmark]] to
3747      =nil=.
3749 **** Expand =%<num>= escape sequences into text entered for <num>'th =%^{PROMPT}= escape
3751      See the manual for more explanations.
3753 **** More control over empty lines
3755      You can use =:empty-lines-before= and =:empty-lines-after= to
3756      control the insertion of empty lines.  Check the manual for more
3757      explanations.
3759 **** New hook [[doc::org-capture-prepare-finalize-hook][org-capture-prepare-finalize-hook]]
3761      This new hook runs before the finalization process starts.
3763 *** Org Export
3765 **** New functions =orgtbl-to-table.el= and =orgtbl-to-unicode=
3767      =orgtbl-to-table.el= convert the table to a =table.el= table, and
3768      =orgtbl-to-unicode= will use =ascii-art-to-unicode.el= (when
3769      available) to print beautiful tables.
3771 **** [[doc::org-table-export][org-table-export]] now a bit clever about the target format
3773      When you specify a file name like =table.csv=, [[doc::org-table-export][org-table-export]]
3774      will now suggest =orgtbl-to-csv= the default method for exporting
3775      the table.
3777 **** New option [[doc::org-export-date-timestamp-format][org-export-date-timestamp-format]]
3779      The option allows to set a time string format for Org timestamps
3780      in the #+DATE option.
3782 **** LaTeX: New options for exporting table rules :tstart, :hline and :tend
3784      See [[doc::org-export-latex-tables-hline][org-export-latex-tables-hline]] and [[doc::org-export-latex-tables-tend][org-export-latex-tables-tend]].
3786 **** LaTeX: You can now set =:hfmt= from =#+ATTR_LaTeX=
3787 **** Beamer: Add support and keybinding for the =exampleblock= environment
3789      Add support for these languages in [[doc::org-export-language-setup][org-export-language-setup]].
3790      More languages are always welcome.
3792 **** Beamer: New option [[doc::org-beamer-inherited-properties][org-beamer-inherited-properties]]
3794      This option allows Beamer export to inherit some properties.
3795      Thanks to Carsten for implementing this.
3797 **** ODT: Add support for ODT export in org-bbdb.el
3798 **** ODT: Add support for indented tables (see [[][this commit]] for details)
3799 **** ODT: Improve the conversion from ODT to other formats
3800 **** ASCII: Swap the level-1/level-2 characters to underline the headlines
3801 **** Support for Chinese, simplified Chinese, Russian, Ukrainian and Japanese
3802 **** HTML: New option [[doc::org-export-html-date-format-string][org-export-html-date-format-string]]
3804      Format string to format the date and time in HTML export.  Thanks
3805      to Sébastien Vauban for this patch.
3807 *** Org Babel
3809 **** New =:results drawer= parameter
3811 =:results drawer= replaces =:results wrap=, which is deprecated but still
3812 supported.
3814 **** =:results org= now put results in a =#+BEGIN_SRC org= block
3816 =:results org= used to put results in a =#+BEGIN_ORG= block but it now puts
3817 results in a =#+BEGIN_SRC org= block, with comma-escaped lines.
3819 =#+BEGIN_ORG= blocks are obsolete.
3821 **** Exporting =#+BEGIN_SRC org= blocks exports the code
3823 It used to exports the results of the code.
3825 *** Miscellaneous
3827 **** New menu entry for [[doc::org-refile][org-refile]]
3828 **** Allow capturing to encrypted entries
3830 If you capture to an encrypted entry, it will be decrypted before
3831 inserting the template then re-encrypted after finalizing the capture.
3833 **** Inactive timestamps are now handled in tables
3835 Calc can do computation on active time-stamps like <2012-09-29 sat.>.
3836 Inactive time-stamps in a table's cell are now internally deactivated so
3837 that Calc formulas can operate on them.
3839 **** [[doc::org-table-number-regexp][org-table-number-regexp]] can now accept comma as decimal mark
3840 **** Org allows a new property =APPT_WARNTIME=
3842      You can set it with the =W= speedy key or set it manually.  When
3843      set, exporting to iCalendar and [[doc::org-agenda-to-appt][org-agenda-to-appt]] will use the
3844      value of this property as the number of minutes for the warning
3845      alarm.
3847 **** New command [[doc::org-inc-effort][org-inc-effort]]
3849      This will increment the effort value.
3851      It is bound to =C-c C-x E= and to =E= as a speedy command.
3853 **** Attach: Add support for creating symbolic links
3855      =org-attach-method= now supports a new method =lns=, allowing to
3856      attach symbolic links.
3858 **** Archive: you can now archive to a datetree
3860 **** New option [[doc::org-inlinetask-show-first-star][org-inlinetask-show-first-star]]
3862      =Non-nil= means display the first star of an inline task as
3863      additional marker.  When =nil=, the first star is not shown.
3865 **** New option [[doc::org-latex-preview-ltxpng-directory][org-latex-preview-ltxpng-directory]]
3867      This lets you define the path for the =ltxpng/= directory.
3869 **** You can now use imagemagick instead of dvipng to preview LaTeX fragments
3870 **** You can now turn off [[doc::orgstruct++-mode][orgstruct++-mode]] safely
3871 **** =C-u C-c C-c= on list items to add check boxes
3873      =C-u C-c C-c= will add an empty check box on a list item.
3875      When hit from the top of the list, it will add check boxes for
3876      all top level list items.
3878 **** =org-list-ending-method= and =org-list-end-regexp= are now obsolete
3880      Fall back on using =org-list-end-re= only, which see.
3882 **** org-feed.el now expands =%(sexp)= templates
3883 **** New option [[doc::org-protocol-data-separator][org-protocol-data-separator]]
3885 **** New option [[doc::org-ditaa-jar-option][org-ditaa-jar-option]] to specify the ditaa jar file
3887 **** New possible value for [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]]
3889      When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is set to
3890      =start-level=, the command will loop over the active region but
3891      will only act upon entries that are of the same level than the
3892      first headline in the region.
3894 **** New option [[doc::org-habit-show-all-today][org-habit-show-all-today]]
3896      When set to =t=, show all (even unscheduled) habits on today's
3897      agenda.
3899 ** Important bug fixes
3901 *** M-TAB on options keywords perform completion correctly again
3903     If you hit =M-TAB= on keywords like =#+TITLE=, Org will try to
3904     perform completion with meaningful values.
3906 *** Add licenses to javascript embedded and external code snippets
3908     Embedded javascript code produced when exporting an Org file to
3909     HTML is now licensed under GPLv3 (or later), and the copyright is
3910     owned by the Free Software Foundation, Inc.
3912     The javascript code for embedding MathJax in the browser mentions
3913     the MathJax copyright and the Apache 2.0 license.
3915     The javascript code for embedding =org-injo.js= in the browser
3916     mentions the copyright of Sebastian Rose and the GPLv3 (or later)
3917     license.
3919     =org-export-html-scripts= is now a variable, so that you can adapt
3920     the code and the license to your needs.
3922     See for
3923     explanations on why these changes were necessary.
3925 * Version 7.8.11
3927 ** Incompatible changes
3929 *** Emacs 21 support has been dropped
3931     Do not use Org mode 7.xx with Emacs 21, use [[][version 6.36c]] instead.
3933 *** XEmacs support requires the XEmacs development version
3935     To use Org mode 7.xx with XEmacs, you need to run the developer
3936     version of XEmacs.  We were about to drop XEmacs support entirely,
3937     but Michael Sperber stepped in and made changes to XEmacs that
3938     made it easier to keep the support.  Thanks to Michael for this
3939     last-minute save.
3941 *** New keys for TODO sparse trees
3943     The key =C-c C-v= is now reserved for Org Babel action.  TODO
3944     sparse trees can still be made with =C-c / t= (all not-done
3945     states) and =C-c / T= (specific states).
3947 *** The Agenda =org-agenda-ndays= is now obsolete
3949     The variable =org-agenda-ndays= is obsolete - please use
3950     =org-agenda-span= instead.
3952     Thanks to Julien Danjou for this.
3954 *** Changes to the intended use of =org-export-latex-classes=
3956     So far this variable has been used to specify the complete header
3957     of the LaTeX document, including all the =\usepackage= calls
3958     necessary for the document.  This setup makes it difficult to
3959     maintain the list of packages that Org itself would like to call,
3960     for example for the special symbol support it needs.
3962     First of all, you can *opt out of this change* in the following
3963     way: You can say: /I want to have full control over headers, and I
3964     will take responsibility to include the packages Org needs/.  If
3965     that is what you want, add this to your configuration and skip the
3966     rest of this section (except maybe for the description of the
3967     =[EXTRA]= place holder):
3969     #+begin_src emacs-lisp
3970    (setq org-export-latex-default-packages-alist nil
3971          org-export-latex-packages-alist nil)
3972     #+end_src
3974     /Continue to read here if you want to go along with the modified
3975     setup./
3977     There are now two variables that should be used to list the LaTeX
3978     packages that need to be included in all classes.  The header
3979     definition in =org-export-latex-classes= should then not contain
3980     the corresponding =\usepackage= calls (see below).
3982     The two new variables are:
3984     1. =org-export-latex-default-packages-alist= :: This is the
3985          variable where Org-mode itself puts the packages it needs.
3986          Normally you should not change this variable.  The only
3987          reason to change it anyway is when one of these packages
3988          causes a conflict with another package you want to use.  Then
3989          you can remove that packages and hope that you are not using
3990          Org-mode functionality that needs it.
3992     2. =org-export-latex-packages-alist= :: This is the variable where
3993          you can put the packages that you'd like to use across all
3994          classes.
3996     The sequence how these customizations will show up in the LaTeX
3997     document are:
3999     1. Header from =org-export-latex-classes=
4000     2. =org-export-latex-default-packages-alist=
4001     3. =org-export-latex-packages-alist=
4002     4. Buffer-specific things set with =#+LaTeX_HEADER:=
4004     If you want more control about which segment is placed where, or
4005     if you want, for a specific class, have full control over the
4006     header and exclude some of the automatic building blocks, you can
4007     put the following macro-like place holders into the header:
4009     #+begin_example
4010     [DEFAULT-PACKAGES]      \usepackage statements for default packages
4011     [NO-DEFAULT-PACKAGES]   do not include any of the default packages
4012     [PACKAGES]              \usepackage statements for packages
4013     [NO-PACKAGES]           do not include the packages
4014     [EXTRA]                 the stuff from #+LaTeX_HEADER
4015     [NO-EXTRA]              do not include #+LaTeX_HEADER stuff
4016     #+end_example
4018     If you have currently customized =org-export-latex-classes=, you
4019     should revise that customization and remove any package calls that
4020     are covered by =org-export-latex-default-packages-alist=.  This
4021     applies to the following packages:
4023     - inputenc
4024     - fontenc
4025     - fixltx2e
4026     - graphicx
4027     - longtable
4028     - float
4029     - wrapfig
4030     - soul
4031     - t1enc
4032     - textcomp
4033     - marvosym
4034     - wasysym
4035     - latexsym
4036     - amssymb
4037     - hyperref
4039     If one of these packages creates a conflict with another package
4040     you are using, you can remove it from
4041     =org-export-latex-default-packages-alist=.  But then you risk that
4042     some of the advertised export features of Org will not work
4043     properly.
4045     You can also consider moving packages that you use in all classes
4046     to =org-export-latex-packages-alist=.  If necessary, put the place
4047     holders so that the packages get loaded in the right sequence.  As
4048     said above, for backward compatibility, if you omit the place
4049     holders, all the variables will dump their content at the end of
4050     the header.
4052 *** The constant =org-html-entities= is obsolete
4054     Its content is now part of the new constant =org-entities=, which
4055     is defined in the file org-entities.el.  =org-html-entities= was
4056     an internal variable, but it is possible that some users did write
4057     code using it.
4059 *** =org-bbdb-anniversary-format-alist= has changed
4061     Please check the docstring and update your settings accordingly.
4063 *** Deleted =org-mode-p=
4065     This function has been deleted: please update your code.
4067 ** Important new features
4069 *** New Org to ODT exporter
4071     Jambunathan's Org to ODT exporter is now part of Org.
4073     To use it, it `C-c C-e o' in an Org file.  See the documentation
4074     for more information on how to customize it.
4076 *** org-capture.el is now the default capture system
4078     This replaces the earlier system org-remember.  The manual only
4079     describes org-capture, but for people who prefer to continue to
4080     use org-remember, we keep a static copy of the former manual
4081     section [[][chapter about remember]].
4083     The new system has a technically cleaner implementation and more
4084     possibilities for capturing different types of data.  See
4085     [[][Carsten's announcement]] for more details.
4087     To switch over to the new system:
4089     1. Run
4091      : M-x org-capture-import-remember-templates RET
4093        to get a translated version of your remember templates into the
4094        new variable =org-capture-templates=.  This will "mostly" work,
4095        but maybe not for all cases.  At least it will give you a good
4096        place to modify your templates.  After running this command,
4097        enter the customize buffer for this variable with
4099      : M-x customize-variable RET org-capture-templates RET
4101        and convince yourself that everything is OK.  Then save the
4102        customization.
4104     2. Bind the command =org-capture= to a key, similar to what you did
4105        with org-remember:
4107      : (define-key global-map "\C-cc" 'org-capture)
4109        If your fingers prefer =C-c r=, you can also use this key once
4110        you have decided to move over completely to the new
4111        implementation.  During a test time, there is nothing wrong
4112        with using both system in parallel.
4114 ** New libraries
4116 *** New Org libraries
4117 **** org-eshell.el (Konrad Hinsen)
4119      Implement links to eshell buffers.
4121 **** org-special-blocks (Carsten Dominik)
4123      This package generalizes the #+begin_foo and #+end_foo tokens.
4125      To use, put the following in your init file:
4127      #+BEGIN_EXAMPLE
4128 (require 'org-special-blocks)
4131      The tokens #+begin_center, #+begin_verse, etc. existed
4132      previously.  This package generalizes them (at least for the
4133      LaTeX and html exporters).  When a #+begin_foo token is
4134      encountered by the LaTeX exporter, it is expanded
4135      into \begin{foo}.  The text inside the environment is not
4136      protected, as text inside environments generally is.
4137      When #+begin_foo is encountered by the html exporter, a div with
4138      class foo is inserted into the HTML file.  It is up to the user
4139      to add this class to his or her stylesheet if this div is to mean
4140      anything.
4142 **** org-taskjuggler.el (Christian Egli)
4144      Christian Egli's /org-taskjuggler.el/ module is now part of Org.
4145      He also wrote a [[][tutorial]] for it.
4147 **** org-ctags.el (Paul Sexton)
4149      Targets like =<<my target>>= can now be found by Emacs' etag
4150      functionality, and Org-mode links can be used to to link to
4151      etags, also in non-Org-mode files.  For details, see the file
4152      /org-ctags.el/.
4154      This feature uses a new hook =org-open-link-functions= which will
4155      call function to do something special with text links.
4157      Thanks to Paul Sexton for this contribution.
4159 **** org-docview.el (Jan Böcker)
4161      This new module allows links to various file types using docview, where
4162      Emacs displays images of document pages.  Docview link types can point
4163      to a specific page in a document, for example to page 131 of the
4164      Org-mode manual:
4166      : [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]]
4168      Thanks to Jan Böcker for this contribution.
4170 *** New Babel libraries
4172 - ob-picolisp.el (Thorsten Jolitz)
4173 - ob-fortran.el (Sergey Litvinov)
4174 - ob-shen.el (Eric Schulte)
4175 - ob-maxima.el (Eric S Fraga)
4176 - ob-java.el (Eric Schulte)
4177 - ob-lilypond.el (Martyn Jago)
4178 - ob-awk.el (Eric Schulte)
4180 ** Other new features and various enhancements
4182 *** Hyperlinks
4184 **** Org-Bibtex -- major improvements
4186      Provides support for managing bibtex bibliographical references
4187      data in headline properties.  Each headline corresponds to a
4188      single reference and the relevant bibliographic meta-data is
4189      stored in headline properties, leaving the body of the headline
4190      free to hold notes and comments.  Org-bibtex is aware of all
4191      standard bibtex reference types and fields.
4193      The key new functions are
4195      - org-bibtex-check :: queries the user to flesh out all required
4196           (and with prefix argument optional) bibtex fields available
4197           for the specific reference =type= of the current headline.
4199      - org-bibtex-create :: Create a new entry at the given level,
4200           using org-bibtex-check to flesh out the relevant fields.
4202      - org-bibtex-yank :: Yank a bibtex entry on the kill ring as a
4203           formatted Org-mode headline into the current buffer
4205      - org-bibtex-export-to-kill-ring :: Export the current headline
4206           to the kill ring as a formatted bibtex entry.
4208 **** org-gnus.el now allows link creation from messages
4210      You can now create links from messages.  This is particularly
4211      useful when the user wants to stored messages that he sends, for
4212      later check.  Thanks to Ulf Stegemann for the patch.
4214 **** Modified link escaping
4216      David Maus worked on `org-link-escape'.  See [[][his message]]:
4218      : Percent escaping is used in Org mode to escape certain characters
4219      : in links that would either break the parser (e.g. square brackets
4220      : in link target oder description) or are not allowed to appear in
4221      : a particular link type (e.g. non-ascii characters in a http:
4222      : link).
4223      :
4224      : With this change in place Org will apply percent escaping and
4225      : unescaping more consistently especially for non-ascii characters.
4226      : Additionally some of the outstanding bugs or glitches concerning
4227      : percent escaped links are solved.
4229      Thanks a lot to David for this work.
4231 **** Make =org-store-link= point to directory in a dired buffer
4233      When, in a dired buffer, the cursor is not in a line listing a
4234      file, `org-store-link' will store a link to the directory.
4236      Patch by Stephen Eglen.
4238 **** Allow regexps in =org-file-apps= to capture link parameters
4240      The way extension regexps in =org-file-apps= are handled has
4241      changed.  Instead of matching against the file name, the regexps
4242      are now matched against the whole link, and you can use grouping
4243      to extract link parameters which you can then use in a command
4244      string to be executed.
4246      For example, to allow linking to PDF files using the syntax
4247      =file:/doc.pdf::<page number>=, you can add the following entry
4248      to org-file-apps:
4250      #+begin_example
4251      Extension: \.pdf::\([0-9]+\)\'
4252      Command:   evince "%s" -p %1
4253      #+end_example
4255      Thanks to Jan Böcker for a patch to this effect.
4257 *** Dates and time
4259 **** Allow relative time when scheduling/adding a deadline
4261      You can now use relative duration strings like "-2d" or "++3w"
4262      when calling =org-schedule= or =org-deadline=: it will schedule
4263      (or set the deadline for) the item respectively two days before
4264      today and three weeks after the current timestamp, if any.
4266      You can use this programmatically: =(org-schedule nil "+2d")=
4267      will work on the current entry.
4269      You can also use this while (bulk-)rescheduling and
4270      (bulk-)resetting the deadline of (several) items from the agenda.
4272      Thanks to Memnon Anon for a heads up about this!
4274 **** American-style dates are now understood by =org-read-date=
4276      So when you are prompted for a date, you can now answer like this
4278      #+begin_example
4279      2/5/3         --> 2003-02-05
4280      2/5           --> <CURRENT-YEAR>-02-05
4281      #+end_example
4283 *** Agenda
4285 **** =org-agenda-custom-commands= has a default value
4287      This option used to be `nil' by default.  This now has a default
4288      value, displaying an agenda and all TODOs.  See the docstring for
4289      details.  Thanks to Carsten for this.
4291 **** Improved filtering through =org-agenda-to-appt=
4293      The new function allows the user to refine the scope of entries
4294      to pass to =org-agenda-get-day-entries= and allows to filter out
4295      entries using a function.
4297      Thanks to Peter Münster for raising a related issue and to
4298      Tassilo Horn for this idea.  Also thanks to Peter Münster for
4299      [[git:68ffb7a7][fixing a small bug]] in the final implementation.
4301 **** Allow ap/pm times in agenda time grid
4303      Times in the agenda can now be displayed in am/pm format.  See
4304      the new variable =org-agenda-timegrid-use-ampm=.  Thanks to
4305      C. A. Webber for a patch to this effect.
4307 **** Agenda: Added a bulk "scattering" command
4309      =B S= in the agenda buffer will cause tasks to be rescheduled a
4310      random number of days into the future, with 7 as the default.
4311      This is useful if you've got a ton of tasks scheduled for today,
4312      you realize you'll never deal with them all, and you just want
4313      them to be distributed across the next N days.  When called with
4314      a prefix arg, rescheduling will avoid weekend days.
4316      Thanks to John Wiegley for this.
4318 *** Exporting
4320 **** Simplification of org-export-html-preamble/postamble
4322      When set to `t', export the preamble/postamble as usual, honoring
4323      the =org-export-email/author/creator-info= variables.
4325      When set to a formatting string, insert this string.  See the
4326      docstring of these variable for details about available
4327      %-sequences.
4329      You can set =:html-preamble= in publishing project in the same
4330      way: `t' means to honor =:email/creator/author-info=, and a
4331      formatting string will insert a string.
4333 **** New exporters to Latin-1 and UTF-8
4335      While Ulf Stegemann was going through the entities list to
4336      improve the LaTeX export, he had the great idea to provide
4337      representations for many of the entities in Latin-1, and for all
4338      of them in UTF-8.  This means that we can now export files rich
4339      in special symbols to Latin-1 and to UTF-8 files.  These new
4340      exporters can be reached with the commands =C-c C-e n= and =C-c
4341      C-e u=, respectively.
4343      When there is no representation for a given symbol in the
4344      targeted coding system, you can choose to keep the TeX-macro-like
4345      representation, or to get an "explanatory" representation.  For
4346      example, =\simeq= could be represented as "[approx. equal to]".
4347      Please use the variable =org-entities-ascii-explanatory= to state
4348      your preference.
4350 **** HTML export: Add class to outline containers using property
4352      The =HTML_CONTAINER_CLASS= property can now be used to add a
4353      class name to the outline container of a node in HTML export.
4355 **** Throw an error when creating an image from a LaTeX snippet fails
4357      This behavior can be configured with the new option variable
4358      =org-format-latex-signal-error=.
4360 **** Support for creating BEAMER presentations from Org-mode documents
4362      Org-mode documents or subtrees can now be converted directly in
4363      to BEAMER presentation.  Turning a tree into a simple
4364      presentations is straight forward, and there is also quite some
4365      support to make richer presentations as well.  See the [[][BEAMER
4366      section]] in the manual for more details.
4368      Thanks to everyone who has contributed to the discussion about
4369      BEAMER support and how it should work.  This was a great example
4370      for how this community can achieve a much better result than any
4371      individual could.
4373 *** Refiling
4375 **** Refile targets can now be cached
4377      You can turn on caching of refile targets by setting the variable
4378      =org-refile-use-cache=.  This should speed up refiling if you
4379      have many eligible targets in many files.  If you need to update
4380      the cache because Org misses a newly created entry or still
4381      offers a deleted one, press =C-0 C-c C-w=.
4383 **** New logging support for refiling
4385      Whenever you refile an item, a time stamp and even a note can be
4386      added to this entry.  For details, see the new option
4387      =org-log-refile=.
4389      Thanks to Charles Cave for this idea.
4391 *** Completion
4393 **** In-buffer completion is now done using John Wiegley's pcomplete.el
4395      Thanks to John Wiegley for much of this code.
4397 *** Tables
4399 **** New command =org-table-transpose-table-at-point=
4401      See the docstring.  This hack from Juan Pechiar is now part of
4402      Org's core.  Thanks to Juan!
4404 **** Display field's coordinates when editing it with =C-c `=
4406      When editing a field with =C-c `=, the field's coordinate will
4407      the displayed in the buffer.
4409      Thanks to Michael Brand for a patch to this effect.
4411 **** Spreadsheet computation of durations and time values
4413      If you want to compute time values use the =T= flag, either in
4414      Calc formulas or Elisp formulas:
4416      | Task 1 | Task 2 |   Total |
4417      |--------+--------+---------|
4418      |  35:00 |  35:00 | 1:10:00 |
4419      #+TBLFM: @2$3=$1+$2;T
4421      Values must be of the form =[HH:]MM:SS=, where hours are
4422      optional.
4424      Thanks to Martin Halder, Eric Schulte and Carsten for code and
4425      feedback on this.
4427 **** Implement formulas applying to field ranges
4429      Carsten implemented this field-ranges formulas.
4431      : A frequently requested feature for tables has been to be able to define
4432      : row formulas in a way similar to column formulas.  The patch below allows
4433      : things like
4434      :
4435      : @3=
4436      : @2$2..@5$7=
4437      : @I$2..@II$4=
4438      :
4439      : as the left hand side for table formulas in order to write a formula that
4440      : is valid for an entire column or for a rectangular section in a
4441      : table.
4443      Thanks a lot to Carsten for this.
4445 **** Sending radio tables from org buffers is now allowed
4447      Org radio tables can no also be sent inside Org buffers.  Also,
4448      there is a new hook which get called after a table has been sent.
4450      Thanks to Seweryn Kokot.
4452 *** Lists
4454 **** Improved handling of lists
4456      Nicolas Goaziou extended and improved the way Org handles lists.
4458      1. Indentation of text determines again end of items in
4459         lists. So, some text less indented than the previous item
4460         doesn't close the whole list anymore, only all items more
4461         indented than it.
4463      2. Alphabetical bullets are implemented, through the use of the
4464         variable `org-alphabetical-lists'. This also adds alphabetical
4465         counters like [@c] or [@W].
4467      3. Lists can now safely contain drawers, inline tasks, or various
4468         blocks, themselves containing lists. Two variables are
4469         controlling this: `org-list-forbidden-blocks', and
4470         `org-list-export-context'.
4472      4. Improve `newline-and-indent' (C-j): used in an item, it will
4473         keep text from moving at column 0. This allows to split text
4474         and make paragraphs and still not break the list.
4476      5. Improve `org-toggle-item' (C-c -): used on a region with
4477         standard text, it will change the region into one item. With a
4478         prefix argument, it will fallback to the previous behavior and
4479         make every line in region an item. It permits to easily
4480         integrate paragraphs inside a list.
4482      6. `fill-paragraph' (M-q) now understands lists. It can freely be
4483         used inside items, or on text just after a list, even with no
4484         blank line around, without breaking list structure.
4486      Thanks a lot to Nicolas for all this!
4488 *** Inline display of linked images
4490     Images can now be displayed inline.  The key C-c C-x C-v does
4491     toggle the display of such images.  Note that only image links
4492     that have no description part will be inlined.
4494 *** Implement offsets for ordered lists
4496     If you want to start an ordered plain list with a number different
4497     from 1, you can now do it like this:
4499     : 1. [@start:12] will star a lit a number 12
4501 *** Babel: code block body expansion for table and preview
4503     In org-babel, code is "expanded" prior to evaluation. I.e. the
4504     code that is actually evaluated comprises the code block contents,
4505     augmented with the extra code which assigns the referenced data to
4506     variables. It is now possible to preview expanded contents, and
4507     also to expand code during during tangling. This expansion takes