Org-mode release 7.9

[Bastien <bzg@gnu.org>]

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