Re: Org-mode release 7.9

[Torsten Wagner <torsten.wagner@gmail.com>]

Hi Bastien,

with all the new features and changes for each release, we might
really need a release-party....
or better a release-workshop. 1-2 days to get introduced to all the
great new stuff ;)

Kudos to all the org developers.


Torsten

On 25 August 2012 00:48, Bastien <bzg@gnu.org> wrote:
> Hi all,
>
> I've released Org 7.9.
>
>   http://orgmode.org/org-7.9.zip
>   http://orgmode.org/org-7.9.gz
>   http://orgmode.org/org-mode-download.html
>
> After 1885 commits since Org 7.8, it was about time.
>
> See the list of changes here:
>
>   http://orgmode.org/Changes.html
>
> I cannot thank all the contributors enough: especially Nicolas, for his
> great work on org-element.el (among other nice stuff), Achim for the way
> he patiently rethought the build mechanism (and bared with me when I was
> being stubborn), Eric for the steady maintainance of Babel, Max for the
> neat idea of sticky agendas, etc.
>
> Here is a list of people to praise for their help:
>
> A. Major, Aaron Peromsik, Achim Gratz, Adam Spiers, Aidan Gauland,
> Albert, Alex Lane, Alexander Willand, Andrew Young, Anthony Lander,
> Benjamin Motz, Bernt Hansen, Bill Jackson, Bill Wishon, Bjarte Johansen,
> Brian J. Carlson, Brian Wood, Brian van den Broek, Carsten Dominik,
> Charles Philip Chan, Charles Sebold, Charles, Charlie Millar, Christoph
> Lange, Christophe Rhodes, Christopher Schmidt, Daniel Dehennin, Dave
> Abrahams, David Coate, David Maus, David Niemi, Dov Grobgeld, Du
> Yanning, Dunib, Elias Assarsson, Eric Abrahamsen, Eric S Fraga, Eric
> Schulte, Fabrice Pardo, Feiming Chen, François Allisson, François
> Pinard, Friedrich Delgado, Giles, Glenn Morris, Greg Troxel, Gsqual,
> Guido Arnold, Gustav Wikström, Henning Redestig, Ian Barton, Ilya
> Shlyakhter, Ingo Lohmar, Ivan Kanis, Ivars Finvers, Jack Erwin,
> Jambunathan, James Harkins, Joe Vornehm Jr., John Hendy, John Wiegley,
> Jonathan Leech-Pepin, Joost Kremers, Jose E. Marchesi, Joseph Thomas,
> Karl Berg, Ken Williams, Konstantin Ziegler, Laurynas Biveinis, Leo
> Alekseyev, Leo and Henning, Loris Bennett, Luis Anaya, Marc-Oliver Ihm,
> Marcel Van der Boom, Martin Beck, Martyn Jago, Mathias Bauer, Matt
> Lundin, Michael Heerdegen, Mike McLean, Mike McLean, Mikhail Titov,
> Mikkel Kristiansen, Moritz Ulrich, Myles English, Nick Dokos, Nicolas
> Goaziou, Noorul Islam K M, Olaf Dietsche, Paul Eggert, Paweł Menich,
> Peter Danenberg, Peter Münster, Petro Rafael, Rasmus Rempling, Richard
> Hansen, Richard Stanton, Robert Lupton the Good, Ryan Kaskel, SW, Samuel
> Wales, Sean O'Halpin, Simon Thum, Stefan Vollmar, Steinar Bang, Steve
> Revilak, Stuart McLean, Sylvain Rousseau, Sébastien Vauban, T.F. Torrey,
> Takaaki Ishikawa, Takafumi Arakaki, Tassilo Horn, Thierry Stoehr, Thomas
> S. Dye, Thomas Wallrafen, Tobias Naehring, Toby Cubitt, Tomas Grigera,
> Torsten Wagner, Uwe Brauer, Vagn Johansen, Viktor Rosenfeld, Vladimir
> Lomov, Waldemar Reusch, Yagnesh Raghava Yakkala, Zachary Jones
>
> And here are the detailed release notes:
>
>
>                          Release notes of Org 7.9
>                          ========================
>
>
> New committers who signed the FSF copyright assigment
> =====================================================
>
> Welcome and thanks to these new core contributors:
>
> - Andrew Hyatt
> - Andrzej Lichnerowicz
> - Ethan Ligon
> - Feng Shu
> - George Kettleborough
> - Henning Dietmar Weiss
> - Ilya Shlyakhter
> - Ivan Kanis
> - Konrad Hinsen
> - Madan Ramakrishnan
> - Max Mikhanosha
> - Moritz Ulrich
> - Rick Frankel
> - Toby Cubitt
>
> Online documentation for hooks, commands and options
> ====================================================
>
> You can read the documentation for hooks, commands (i.e. interactive
> functions) and options (i.e. customizable variables) [online].  Clicking on a
> command/option in this ChangeLog will take you to the online documentation
> for that command/option.
>
>
> [online]: http://orgmode.org/worg/doc.html
>
> Overview of the new keybindings
> ===============================
>
> │ Keybinding      │ Speedy │ Command                     │
> ├─────────────────┼────────┼─────────────────────────────┤
> │ =C─c C─x C─z=   │        │ org─clock─resolve           │
> │ =C─c C─x C─q=   │        │ org─clock─cancel            │
> │ =C─c C─x C─x=   │        │ org─clock─in─last           │
> │ =M─h=           │        │ org─mark─element            │
> │ =*=             │        │ org─agenda─bulk─mark─all    │
> │ =C─c C─M─l=     │        │ org─insert─all─links        │
> │ =C─c C─x C─M─v= │        │ org─redisplay─inline─images │
> │ =C─c C─x E=     │ =E=    │ org─inc─effort              │
> │                 │ =#=    │ org─toggle─comment          │
> │                 │ =:=    │ org─columns                 │
> │                 │ =W=    │ Set =APPT_WARNTIME=         │
>
> New build system and new packages
> =================================
>
> New build system
> ----------------
>
> Achim implemented a new build system.
>
> The basic method for installing Org is the same:
>
> 1. Download or clone Org.
> 2. run `make install' from the Org directory.
> 3. Add (require 'org-install) in your .emacs.el.
>
> But the build system is now more flexible and can be more easily
> adapted to suit your needs.
>
> See [http://orgmode.org/worg/dev/org-build-system.html] for details.
>
> New packages in core
> --------------------
>
> =org-eshell.el= by Konrad Hinsen is now in Org's core
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> =org-eshell.el= allows you to create links from [Eshell].
>
>
> [Eshell]: http://www.gnu.org/software/emacs/manual/html_node/eshell/index.html
>
> New packages in contrib/
> ------------------------
>
> Note: The =EXPERIMENTAL/= directory has been deleted.  The files
> have been moved to the =contrib/lisp/= directory.
>
> =org-notify.el= by Peter Münster
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> From the comment section:
>
> Get notifications, when there is something to do.
> Sometimes, you need a reminder a few days before a deadline, e.g. to buy a
> present for a birthday, and then another notification one hour before to
> have enough time to choose the right clothes.
> For other events, e.g. rolling the dustbin to the roadside once per week,
> you probably need another kind of notification strategy.
> This package tries to satisfy the various needs.
>
> =org-bibtex-extras.el= by Eric Schulte
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> From the comment section:
>
> This file add some extra functionality to your bibtex entries which
> are stored as Org-mode headlines using org-bibtex.el.  Most
> features expect that you keep all of your reading notes in a single
> file, set the `obe-bibtex-file' variable to the path to this file.
>
> New exporters in contrib/
> -------------------------
>
> Nicolas export engine org-export.el lives in the =contrib/lisp/= directory.
> To use it:
>
> Make sure contrib/lisp/ is in your load-path
> M-: (require 'org-export) RET
> M-: (require 'org-e-latex) RET ; or any other library
> M-x org-export-dispatch RET
>
> These are the currently available exporters:
>
> - =org-e-ascii.el= by Nicolas
> - =org-e-beamer.el= by Nicolas
> - =org-e-groff.el= by Luis Anaya
> - =org-e-html.el= by Jambunathan
> - =org-e-latex.el= by Nicolas
> - =org-e-man.el= by Luis Anaya
> - =org-e-odt.el= by Jambunathan
> - =org-e-texinfo.el= by Jonathan Leech-Pepin
> - =org-md.el= by Nicolas
>
> If we have enough testers, the new export engine is very likely to replace
> the current one for the next major release.  Please report any problem on
> the mailing list!
>
> If you want to write a new export backend based on this export engine,
> please check the [online documentation].
>
>
> [online documentation]: http://orgmode.org/worg/dev/org-export-reference.html
>
> New Babel languages
> -------------------
>
> Support for execution of Scala code blocks (see lisp/ob-scala.el)
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Support for execution of IO code blocks (see lisp/ob-io.el)
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Incompatible changes
> ====================
>
> - The =UTILITIES/= directory has been renamed to =utils/=.
>
> - If your code relies on =org-write-agenda=, please use
>   [org-agenda-write] from now on.
>
> - If your code relies on =org-make-link=, please use =concat=
>   instead.
>
> - The default value of [org-table-number-regexp] now allows commas
>   as the mark to separate decimals from integers in numbers.  If
>   your code relies on the previous behavior, please customize
>   this variable.  See the announcement on the mailing list.
>
>
>   [org-agenda-write]: http://orgmode.org/worg/doc.html#org-agenda-write
>   [org-table-number-regexp]: http://orgmode.org/worg/doc.html#org-table-number-regexp
>
> New features and user-visible changes
> =====================================
>
> Org Element
> -----------
>
> org-element.el is a toolbox for parsing and analysing "elements" in an
> Org-mode buffer.  This has been written by Nicolas Goaziou and has been
> tested for quite some time.  It is now part of Org's core and many core
> functions rely on this package.
>
> Two functions might be particularily handy for users: [org-element-at-point]
> and [org-element-context].  See the docstrings for more details.
>
> Below is a list of editing and navigating commands that now rely on
> org-element.el.
>
>
> [org-element-at-point]: http://orgmode.org/worg/doc.html#org-element-at-point
> [org-element-context]: http://orgmode.org/worg/doc.html#org-element-context
>
> [org-fill-paragraph] has been completely rewritten
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> The filling mechanisms now rely on org-element, trying to do the right
> thing on each element in various contexts.  E.g. filling in a list item
> will preserve indentation; filling in message-mode will fall back on the
> relevant filling functions; etc.
>
>
> [org-fill-paragraph]: http://orgmode.org/worg/doc.html#org-fill-paragraph
>
> [org-metaup] and [org-metadown] will drag the element backward/forward
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> If you want to get the old behavior (i.e. moving a line up and down), you
> can first select the line as an active region, then =org-metaup/down= to
> move the region backward/forward.  This also works with regions bigger than
> just one line.
>
>
> [org-metaup]: http://orgmode.org/worg/doc.html#org-metaup
> [org-metadown]: http://orgmode.org/worg/doc.html#org-metadown
>
> [org-up-element] and [org-down-element] (respectively =C-c C-^= and =C-c C-_=)
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This will move the point up/down in the hierarchy of elements.
>
>
> [org-up-element]: http://orgmode.org/worg/doc.html#org-up-element
> [org-down-element]: http://orgmode.org/worg/doc.html#org-down-element
>
> [org-backward-element] and [org-forward-element] (respectively =M-{= and =M-}=)
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This will move the point backward/forward in the hierarchy of elements.
>
>
> [org-backward-element]: http://orgmode.org/worg/doc.html#org-backward-element
> [org-forward-element]: http://orgmode.org/worg/doc.html#org-forward-element
>
> [org-narrow-to-element] will narrow to the element at point
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> [org-narrow-to-element]: http://orgmode.org/worg/doc.html#org-narrow-to-element
>
> [org-mark-element] will mark the element at point
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This command is bound to =M-h= and will mark the element at point.  If the
> point is at a paragraph, it will mark the paragraph.  If the point is at a
> list item, it will mark the list item.  Etc.
>
> Note that if point is at the beginning of a list, it will mark the whole
> list.
>
> To mark a subtree, you can either use =M-h= on the headline (since there is
> no ambiguity about the element you're at) or [org-mark-subtree] (=C-c @=)
> anywhere in the subtree.
>
> Invoking [org-mark-element] repeatedly will try to mark the next element on
> top of the previous one(s).  E.g. hitting =M-h= twice on a headline will
> mark the current subtree and the next one on the same level.
>
>
> [org-mark-element]: http://orgmode.org/worg/doc.html#org-mark-element
> [org-mark-subtree]: http://orgmode.org/worg/doc.html#org-mark-subtree
> [org-mark-element]: http://orgmode.org/worg/doc.html#org-mark-element
>
> Org Agenda
> ----------
>
> New option [org-agenda-sticky]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> There is a new option `org-agenda-sticky' which enables "sticky" agendas.
> Sticky agendas remain opened in the background so that you don't need to
> regenerate them each time you hit the corresponding keystroke.  This is a
> big time saver.
>
> When [org-agenda-sticky] is =non-nil=, the agenda =q= key will bury the
> agenda buffers.  Agenda commands will then show existing buffer instead of
> generating new ones.  When =nil=, =q= will kill the single agenda buffer.
>
>
> [org-agenda-sticky]: http://orgmode.org/worg/doc.html#org-agenda-sticky
> [org-agenda-sticky]: http://orgmode.org/worg/doc.html#org-agenda-sticky
>
> New option [org-agenda-custom-commands-contexts]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Setting this option allows you to define specific context where
> agenda commands should be available from.  For example, when set
> to this value
>
>
>
>   (setq org-agenda-custom-commands-contexts
>         '(("p" (in-file . "\\.txt"))))
>
>
> then the =p= agenda command will only be available from buffers
> visiting *.txt files.  See the docstring and the manual for more
> details on how to use this.
>
>
> [org-agenda-custom-commands-contexts]: http://orgmode.org/worg/doc.html#org-agenda-custom-commands-contexts
>
> =N= and =P= in the agenda will move to the next/previous item
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> New command [org-agenda-bulk-mark-all] to mark all items
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This new command is bound to =*= in agenda mode.
>
> There is also a new option [org-agenda-bulk-mark-char] to set the character
> to use as a mark for bulk actions.
>
>
> [org-agenda-bulk-mark-all]: http://orgmode.org/worg/doc.html#org-agenda-bulk-mark-all
> [org-agenda-bulk-mark-char]: http://orgmode.org/worg/doc.html#org-agenda-bulk-mark-char
>
> New option [org-agenda-persistent-marks]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> When set to =non-nil=, marks will remain visible after a bulk action.  You
> can temporarily toggle this by pressing =p= when invoking
> [org-agenda-bulk-action].
>
>
> [org-agenda-persistent-marks]: http://orgmode.org/worg/doc.html#org-agenda-persistent-marks
> [org-agenda-bulk-action]: http://orgmode.org/worg/doc.html#org-agenda-bulk-action
>
> New option [org-agenda-skip-timestamp-if-deadline-is-shown]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> =Non-nil= means skip timestamp line if same entry shows because of
> deadline.
>
> In the agenda of today, an entry can show up multiple times because it has
> both a plain timestamp and has a nearby deadline.  When this variable is t,
> then only the deadline is shown and the fact that the entry has a timestamp
> for or including today is not shown.  When this variable is =nil=, the
> entry will be shown several times.
>
>
> [org-agenda-skip-timestamp-if-deadline-is-shown]: http://orgmode.org/worg/doc.html#org-agenda-skip-timestamp-if-deadline-is-shown
>
> New =todo-unblocked= and =nottodo-unblocked= skip conditions
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> See the [git commit] for more explanations.
>
>
> [git commit]: http://orgmode.org/w/?p%3Dorg-mode.git%3Ba%3Dcommit%3Bh%3Df426da
>
> Allow category filtering in the agenda
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> You can now filter the agenda by category.  Pressing "<" will filter by
> the category of the item on the current line, and pressing "<" again will
> remove the filter.  You can combine tag filters and category filters.
>
> You can use [org-agenda-category-filter] in your custom agenda views and
> [org-agenda-category-filter-preset] in your main configuration.
>
> See also the new command [org-agenda-filter-by-top-category]: hitting `^'
> will filter by "Top" category: only show entries that are of the same
> category than the Top category of the entry at point.
>
> [org-agenda-category-filter]: http://orgmode.org/worg/doc.html#org-agenda-category-filter
> [org-agenda-category-filter-preset]: http://orgmode.org/worg/doc.html#org-agenda-category-filter-preset
> [org-agenda-filter-by-top-category]: http://orgmode.org/worg/doc.html#org-agenda-filter-by-top-category
>
> Org Links
> ---------
>
> Inserting links
> ~~~~~~~~~~~~~~~
>
> When inserting links through [org-insert-link], the description is now
> displayed first, followed by the literal link, as the description is often
> more useful when you look for the link you want to insert.
>
> Completion now complete both literal links and description.  If you
> complete a description, the literal link and its description will be
> inserted directly, whereas when you complete the literal link, you will be
> prompted for a description (as with Org 7.8.)
>
> In the completion buffer, links to the current buffer are now highlighted.
>
>
> [org-insert-link]: http://orgmode.org/worg/doc.html#org-insert-link
>
> New templates =%h= and =%(sexp)= for abbreviated links
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> On top of =%s= template, which is replaced by the link tag in abbreviated
> links, you can now use =%h= (which does the same than =%s= but does not
> hexify the tag) and =%(sexp)= (which can run a function that takes the tag
> as its own argument.)
>
> New link type =help=
> ~~~~~~~~~~~~~~~~~~~~
>
> You can now create links from =help= buffers.
>
> For example, if you request help for the command [org-agenda] with =C-h f
> org-agenda RET=, creating a link from this buffer will let you go back to
> the same buffer.
>
>
> [org-agenda]: http://orgmode.org/worg/doc.html#org-agenda
>
> New command [org-insert-all-links]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This will insert all links as list items.  With a universal prefix
> argument, links will not be deleted from [org-stored-links].
>
> This new command is bound to =C-c C-M-l=.
>
>
> [org-insert-all-links]: http://orgmode.org/worg/doc.html#org-insert-all-links
> [org-stored-links]: http://orgmode.org/worg/doc.html#org-stored-links
>
> New option [org-url-hexify-p]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> When set to =nil=, the =URL= part of a link will not be hexified.
>
>
> [org-url-hexify-p]: http://orgmode.org/worg/doc.html#org-url-hexify-p
>
> Org can now open multiple shell links
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
>
> New option [org-doi-server-url] to specify an alternate DOI server
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
>
> [org-doi-server-url]: http://orgmode.org/worg/doc.html#org-doi-server-url
>
> RET now follows time stamps links
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Org Editing
> -----------
>
> [org-todo] and =org-archive-*= can now loop in the active region
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> When [org-loop-over-headlines-in-active-region] is =non-nil=, using [org-todo]
> or =org-archive-*= commands in the active region will loop over headlines.
> This is handy if you want to set the TODO keyword for several items, or
> archive them quickly.
>
> [org-todo]: http://orgmode.org/worg/doc.html#org-todo
> [org-loop-over-headlines-in-active-region]: http://orgmode.org/worg/doc.html#org-loop-over-headlines-in-active-region
> [org-todo]: http://orgmode.org/worg/doc.html#org-todo
>
> You can now set tags for headlines in a region
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> If [org-loop-over-headlines-in-active-region] is =non-nil=, then selecting
> the region and hitting =C-c C-q= will set the tags for all headlines in the
> region.
>
>
> [org-loop-over-headlines-in-active-region]: http://orgmode.org/worg/doc.html#org-loop-over-headlines-in-active-region
>
> New command [org-insert-drawer] to insert a drawer interactively
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> [org-insert-drawer]: http://orgmode.org/worg/doc.html#org-insert-drawer
>
> Comments start with "^[ \t]*# " anywhere on a line
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Note that the space after the hashtag is mandatory.  Comments with "^#+"
> are not supported anymore.
>
> New speed key =#= to toggle the COMMENT cookie on a headline
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> =indent-region-function= is now set to [org-indent-region]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> =C-M-\= should now produce useful results.
>
> You can unindent the buffer with [org-unindent-buffer].
>
>
> [org-indent-region]: http://orgmode.org/worg/doc.html#org-indent-region
> [org-unindent-buffer]: http://orgmode.org/worg/doc.html#org-unindent-buffer
>
> New option [org-allow-promoting-top-level-subtree]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> When =non-nil=, =S-M-<left>= will promote level-1 subtrees containing other
> subtrees.  The level-1 headline will be commented out.  You can revert to
> the previous state with =M-x undo RET=.
>
>
> [org-allow-promoting-top-level-subtree]: http://orgmode.org/worg/doc.html#org-allow-promoting-top-level-subtree
>
> Org Clock
> ---------
>
>
> New keybinding =C-c C-x C-z= for [org-clock-resolve]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> [org-clock-resolve]: http://orgmode.org/worg/doc.html#org-clock-resolve
>
> New keybinding =C-c C-x C-q= for [org-clock-cancel]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> [org-clock-cancel]: http://orgmode.org/worg/doc.html#org-clock-cancel
>
> New command [org-clock-in-last] to clock in the last clocked item
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This command is bound to =C-c C-x C-x= and will clock in the last clocked
> entry, if any.
>
>
> [org-clock-in-last]: http://orgmode.org/worg/doc.html#org-clock-in-last
>
> =C-u M-x= [org-clock-out] =RET= now prompts for a state to switch to
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> [org-clock-out]: http://orgmode.org/worg/doc.html#org-clock-out
>
> =S-M-<up/down>= on a clock timestamps adjusts the previous/next clock
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> New option [org-clock-continuously]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> When set to =nil=, clocking in a task will first try to find the last
> clocked out task and restart from when that task was clocked out.
>
> You can temporarily activate continuous clocking with =C-u C-u C-u M-x
> [org-clock-in] RET= (three universal prefix arguments) and =C-u C-u M-x
> [org-clock-in-last] RET= (two universal prefix arguments).
>
>
> [org-clock-continuously]: http://orgmode.org/worg/doc.html#org-clock-continuously
> [org-clock-in]: doc::org-clock-in
> [org-clock-in-last]: doc::org-clock-in-last
>
> New option [org-clock-frame-title-format]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This option sets the value of =frame-title-format= when clocking in.
>
>
> [org-clock-frame-title-format]: http://orgmode.org/worg/doc.html#org-clock-frame-title-format
>
> New options for controlling the clockreport display
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> [org-clock-file-time-cell-format]: Format string for the file time cells in
> clockreport.
>
> [org-clock-total-time-cell-format]: Format string for the total time cells
> in clockreport.
>
>
> [org-clock-file-time-cell-format]: http://orgmode.org/worg/doc.html#org-clock-file-time-cell-format
> [org-clock-total-time-cell-format]: http://orgmode.org/worg/doc.html#org-clock-total-time-cell-format
>
> New options for controlling the clock/timer display
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> [org-clock-clocked-in-display]: control whether the current clock is
> displayed in the mode line and/or frame title.
>
> [org-timer-display]: control whether the current timer is displayed in the
> mode line and/or frame title.
>
> This allows the clock and timer to be displayed in the frame title instead
> of, or as well as, the mode line.  This is useful for people with limited
> space in the mode line but with ample space in the frame title.
>
>
> [org-clock-clocked-in-display]: http://orgmode.org/worg/doc.html#org-clock-clocked-in-display
> [org-timer-display]: http://orgmode.org/worg/doc.html#org-timer-display
>
> Org Appearance
> --------------
>
> New option [org-custom-properties]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> The visibility of properties listed in this options can be turn on/off with
> [org-toggle-custom-properties-visibility].  This might be useful for
> properties used by third-part tools or that you don't want to see
> temporarily.
>
>
> [org-custom-properties]: http://orgmode.org/worg/doc.html#org-custom-properties
> [org-toggle-custom-properties-visibility]: http://orgmode.org/worg/doc.html#org-toggle-custom-properties-visibility
>
> New command [org-redisplay-inline-images]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This will redisplay all images.  It is bound to =C-c C-x C-M-v=.
>
>
> [org-redisplay-inline-images]: http://orgmode.org/worg/doc.html#org-redisplay-inline-images
>
> New entities in =org-entities.el=
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> There are these new entities:
>
>     ("tilde" "\\~{}" nil "&tilde;" "~" "~" "~")
>     ("slash" "/" nil "/" "/" "/" "/")
>     ("plus" "+" nil "+" "+" "+" "+")
>     ("under" "\\_" nil "_" "_" "_" "_")
>     ("equal" "=" nil "=" "=" "=" "=")
>     ("asciicirc" "\\textasciicircum{}" nil "^" "^" "^" "^")
>
> New face =org-list-dt= for definition terms
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> New face =org-date-selected= for the selected calendar day
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> New face value for =org-document-title=
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> The face is back to a normal height.
>
> Org Columns
> -----------
>
> New speed command =:= to activate the column view
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> New special property =CLOCKSUM_T= to display today's clocked time
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> You can use =CLOCKSUM_T= the same way you use =CLOCKSUM=.  It will display
> the time spent on tasks for today only.
>
> Use the =:COLUMNS:= property in columnview dynamic blocks
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> If the =:COLUMNS:= is set in a subtree, the columnview dynamic block will
> use its value as the column format.
>
> Consider inline tasks when computing a sum
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Org Dates and Time Stamps
> -------------------------
>
> Enhanced [org-sparse-tree]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> =C-c /= can now check for time ranges.
>
> When checking for dates with =C-c /= it is useful to change the type of
> dates that you are interested in.  You can now do this interactively with
> =c= after =C-c /= and/or by setting [org-sparse-tree-default-date-type] to
> the default value you want.
>
>
> [org-sparse-tree]: http://orgmode.org/worg/doc.html#org-sparse-tree
> [org-sparse-tree-default-date-type]: http://orgmode.org/worg/doc.html#org-sparse-tree-default-date-type
>
> Support for hourly repeat cookies
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> You can now use
>
> SCHEDULED: <2012-08-20 lun. 08:00 +1h>
>
> if you want to add an hourly repeater to an entry.
>
> =C-u C-u C-c .= inserts a time-stamp with no prompt
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> When (setq [org-read-date-prefer-future] 'time), accept days in the prompt
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> "8am Wed" and "Wed 8am" are now acceptable values when entering a date from
> the prompt.  If [org-read-date-prefer-future] is set to =time=, this will
> produce the expected prompt indication.
>
>
> [org-read-date-prefer-future]: http://orgmode.org/worg/doc.html#org-read-date-prefer-future
> [org-read-date-prefer-future]: http://orgmode.org/worg/doc.html#org-read-date-prefer-future
>
> New option [org-datetree-add-timestamp]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> When set to =non-nil=, datetree entries will also have a timestamp.  This
> is useful if you want to see these entries in a sparse tree with =C-c /=.
>
>
> [org-datetree-add-timestamp]: http://orgmode.org/worg/doc.html#org-datetree-add-timestamp
>
> Org Capture
> -----------
>
> New command [org-capture-string]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> M-x [org-capture-string] RET will prompt for a string and a capture template.
> The string will be used as an annotation for the template.  This is useful
> when capturing in batch mode as it lets you define the content of the
> template without being in Emacs.
>
>
> [org-capture-string]: http://orgmode.org/worg/doc.html#org-capture-string
> [org-capture-string]: http://orgmode.org/worg/doc.html#org-capture-string
>
> New option [org-capture-templates-contexts]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Setting this option allows you to define specific context where
> capture templates should be available from.  For example, when
> set to this value
>
>
>
>   (setq org-capture-templates-contexts
>         '(("c" (in-mode . "message-mode"))))
>
>
> then the =c= capture template will only be available from
> =message-mode= buffers.  See the docstring and the manual for
> more details on how to use this.
>
>
> [org-capture-templates-contexts]: http://orgmode.org/worg/doc.html#org-capture-templates-contexts
>
> New =%l= template to insert the literal link
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> New option [org-capture-bookmark]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Org used to automatically add a bookmark with capture a note.  You can now
> turn this on by setting [org-capture-bookmark] to =nil=.
>
>
> [org-capture-bookmark]: http://orgmode.org/worg/doc.html#org-capture-bookmark
> [org-capture-bookmark]: http://orgmode.org/worg/doc.html#org-capture-bookmark
>
> Expand =%<num>= escape sequences into text entered for <num>'th =%^{PROMPT}= escape
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> See the manual for more explanations.
>
> More control over empty lines
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> You can use =:empty-lines-before= and =:empty-lines-after= to control the
> insertion of empty lines.  Check the manual for more explanations.
>
> New hook [org-capture-prepare-finalize-hook]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This new hook runs before the finalization process starts.
>
>
> [org-capture-prepare-finalize-hook]: http://orgmode.org/worg/doc.html#org-capture-prepare-finalize-hook
>
> Org Export
> ----------
>
> New command [orgtbl-to-table.el] and [orgtbl-to-unicode]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> [orgtbl-to-table.el] will convert the table to a =table.el= table, and
> [orgtbl-to-unicode] will use ascii-art-to-unicode.el (when available) to
> print beautiful tables.
>
>
> [orgtbl-to-table.el]: http://orgmode.org/worg/doc.html#orgtbl-to-table.el
> [orgtbl-to-unicode]: http://orgmode.org/worg/doc.html#orgtbl-to-unicode
> [orgtbl-to-table.el]: http://orgmode.org/worg/doc.html#orgtbl-to-table.el
> [orgtbl-to-unicode]: http://orgmode.org/worg/doc.html#orgtbl-to-unicode
>
> [org-table-export] now a bit clever about the target format
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> When you specify a file name like =table.csv=, [org-table-export] will now
> suggest [orgtbl-to-csv] as the default method for exporting the table.
>
>
> [org-table-export]: http://orgmode.org/worg/doc.html#org-table-export
> [org-table-export]: http://orgmode.org/worg/doc.html#org-table-export
> [orgtbl-to-csv]: http://orgmode.org/worg/doc.html#orgtbl-to-csv
>
> New option [org-export-date-timestamp-format]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> The option allows to set a time string format for Org timestamps
> in the #+DATE option.
>
> [org-export-date-timestamp-format]: http://orgmode.org/worg/doc.html#org-export-date-timestamp-format
>
> LaTeX: New options for exporting table rules :tstart, :hline and :tend
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> See [org-export-latex-tables-hline] and [org-export-latex-tables-tend].
>
>
> [org-export-latex-tables-hline]: http://orgmode.org/worg/doc.html#org-export-latex-tables-hline
> [org-export-latex-tables-tend]: http://orgmode.org/worg/doc.html#org-export-latex-tables-tend
>
> LaTeX: You can now set =:hfmt= from =#+ATTR_LaTeX=
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Beamer: Add support and keybinding for the =exampleblock= environment
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Add support for these languages in [org-export-language-setup].  More
> languages are always welcome.
>
>
> [org-export-language-setup]: http://orgmode.org/worg/doc.html#org-export-language-setup
>
> Beamer: New option [org-beamer-inherited-properties]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This option allows Beamer export to inherit some properties.
> Thanks to Carsten for implementing this.
>
>
> [org-beamer-inherited-properties]: http://orgmode.org/worg/doc.html#org-beamer-inherited-properties
>
> ODT: Add support for ODT export in org-bbdb.el
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> ODT: Add support for indented tables (see [this commit] for details)
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> [this commit]: http://orgmode.org/w/?p%3Dorg-mode.git%3Ba%3Dcommit%3Bh%3De9fd33
>
> ODT: Improve the conversion from ODT to other formats
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> ASCII: Swap the level-1/level-2 characters to underline the headlines
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Support for Chinese, simplified Chinese, Russian, Ukrainian and Japanese
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> HTML: New option [org-export-html-date-format-string]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Format string to format the date and time in HTML export.
> Thanks to Sébastien Vauban for this patch.
>
>
> [org-export-html-date-format-string]: http://orgmode.org/worg/doc.html#org-export-html-date-format-string
>
> Miscellaneous
> -------------
>
> [org-table-number-regexp] accept comma as a decimal mark to represent numbers
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> [org-table-number-regexp]: http://orgmode.org/worg/doc.html#org-table-number-regexp
>
> Org allows a new property =APPT_WARNTIME=
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> You can set it with the =W= speedy key or set it manually.  When set,
> exporting to iCalendar and [org-agenda-to-appt] will use the value of this
> property as the number of minutes for the warning alarm.
>
>
> [org-agenda-to-appt]: http://orgmode.org/worg/doc.html#org-agenda-to-appt
>
> New command [org-inc-effort]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This will increment the effort value.
>
> It is bound to =C-c C-x E= and to =E= as a speedy command.
>
>
> [org-inc-effort]: http://orgmode.org/worg/doc.html#org-inc-effort
>
> Attach: Add support for creating symbolic links
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> `org-attach-method' now supports a new method =lns=, allowing to attach
> symbolic links.
>
> Archive: you can now archive to a datetree
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> New option [org-inlinetask-show-first-star]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> =Non-nil= means display the first star of an inline task as
> additional marker.  When =nil=, the first star is not shown.
>
>
> [org-inlinetask-show-first-star]: http://orgmode.org/worg/doc.html#org-inlinetask-show-first-star
>
> New option [org-latex-preview-ltxpng-directory]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> This lets you define the path for the =ltxpng/= directory.
>
>
> [org-latex-preview-ltxpng-directory]: http://orgmode.org/worg/doc.html#org-latex-preview-ltxpng-directory
>
> You can now use imagemagick instead of dvipng to preview LaTeX fragments
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> You can now turn off [orgstruct++-mode] safely
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> [orgstruct++-mode]: http://orgmode.org/worg/doc.html#orgstruct++-mode
>
> =C-u C-c C-c= on list items to add check boxes
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> =C-u C-c C-c= will add an empty check box on a list item.
>
> When hit from the top of the list, it will add check boxes for all top
> level list items.
>
> =org-list-ending-method= and =org-list-end-regexp= are now obsolete
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> Fall back on using [org-list-end-re] only, which see.
>
>
> [org-list-end-re]: http://orgmode.org/worg/doc.html#org-list-end-re
>
> org-feed.el now expands =%(sexp)= templates
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> New option [org-protocol-data-separator]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
>
> [org-protocol-data-separator]: http://orgmode.org/worg/doc.html#org-protocol-data-separator
>
> New option [org-ditaa-jar-option] to specify the ditaa jar file
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
>
> [org-ditaa-jar-option]: http://orgmode.org/worg/doc.html#org-ditaa-jar-option
>
> New possible value for [org-loop-over-headlines-in-active-region]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> When [org-loop-over-headlines-in-active-region] is set to
> =start-level=, the command will loop over the active region but
> will only act upon entries that are of the same level than the
> first headline in the region.
>
>
> [org-loop-over-headlines-in-active-region]: http://orgmode.org/worg/doc.html#org-loop-over-headlines-in-active-region
> [org-loop-over-headlines-in-active-region]: http://orgmode.org/worg/doc.html#org-loop-over-headlines-in-active-region
>
> New option [org-habit-show-all-today]
> ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
>
> When set to =t=, show all (even unscheduled) habits on today's agenda.
>
>
> [org-habit-show-all-today]: http://orgmode.org/worg/doc.html#org-habit-show-all-today
>
>
> Important bug fixes
> ===================
>
> M-TAB on options keywords perform completion correctly again
> ------------------------------------------------------------
>
> If you hit =M-TAB= on keywords like =#+TITLE=, Org will try to
> perform completion with meaningful values.
>
> Add licenses to javascript embedded and external code snippets
> --------------------------------------------------------------
>
> Embedded javascript code produced when exporting an Org file to HTML is now
> licensed under GPLv3 (or later), and the copyright is owned by the Free
> Software Foundation, Inc.
>
> The javascript code for embedding MathJax in the browser mentions the
> MathJax copyright and the Apache 2.0 license.
>
> The javascript code for embedding =org-injo.js= in the browser mentions the
> copyright of Sebastian Rose and the GPLv3 (or later) license.
>
> [org-export-html-scripts] is now a variable, so that you can adapt the code
> and the license to your needs.
>
> See [http://www.gnu.org/philosophy/javascript-trap.html] for explanations on
> why these changes were necessary.
>
>
> [org-export-html-scripts]: http://orgmode.org/worg/doc.html#org-export-html-scripts
>
>
> --
>  Bastien
>
>