Org mode for Emacs – Old Release notes

Variables relative to clocksum duration are obsolete

org-at-timestamp-p optional argument accepts different values

org-capture-templates no longer accepts S-expressions as file names

(file (sexp))

(file (lambda () (sexp)))

Deleted contributed packages

Change org-texinfo-classes value

Removal of :sitemap-sans-extension

(lambda (entry style project)
  (cond ((not (directory-name-p entry))
         (format "[[file:%s][%s]]"
                 (file-name-sans-extension entry)
                 (org-publish-find-title entry project)))
        ((eq style 'tree) (file-name-nondirectory (directory-file-name entry)))
        (t entry)))

Change signature for :sitemap-function

Change signature for some properties in org-list-to-generic

Change signature for org-get-repeater

Change signature for org-time-string-to-time

Change order of items in org-agenda-time-grid

tags-todo custom searches now include DONE keywords

Removal of ob-scala.el

iCalendar export uses inheritance for TIMEZONE and LOCATION properties

iCalendar export respects a TIMEZONE property

org-attach can move directory contents

New Org duration library

Agenda

• New variable : org-agenda-show-future-repeats
  
• New variable : org-agenda-prefer-last-repeat
  
• New variable : org-deadline-past-days
  

  See docstring for details.

• Binding C-c C-x < for org-agenda-set-restriction-lock-from-agenda
  
• New auto-align default setting for org-agenda-tags-column
  

  org-agenda-tags-column can now be set to auto, which will automatically align tags to the right edge of the window. This is now the default setting.

New value for org-publish-sitemap-sort-folders

Babel

• Scheme: support for tables
  
• Scheme: new variable: org-babel-scheme-null-to
  

  This new custom option allows to use a empty list or null symbol to format the table output, initially assigned to hlines.

• Scheme: new header :prologue
  

  A new block code header has been created for Org Babel that enables developers to prepend code to the scheme block being processed.

  Multiple :prologue headers can be added each of them using a string with the content to be added.

  The scheme blocks are prepared by surronding the code in the block with a let form. The content of the :prologue headers are prepended before this let form.

• Support for hledger accounting reports added
  
• Clojure: new setting org-babel-clojure-sync-nrepl-timeout
  

  Creation of a new setting to specify the Cider timeout. By setting the org-babel-clojure-sync-nrepl-timeout setting option. The value is in seconds and if set to nil then no timeout will occur.

• Clojure: new header :show-process
  

  A new block code header has been created for Org Babel that enables developers to output the process of an ongoing process into a new window/buffer.

  You can tell Org Babel to output the process of a running code block.

  To show that output you only have to specify the :show-process option in the code block's header like this:

  #+BEGIN_SRC clojure :results output :show-process t
    (dotimes [n 10]
      (println n ".")
      (Thread/sleep 500))
  #+END_SRC
  

  If :show-process is specified that way, then when you will run the code using C-c C-c a new window will open in Emacs. Everything that is output by the REPL will immediately be added to that new window.

  When the processing of the code is finished, then the window and its buffer will be closed and the results will be reported in the #+RESULTS section.

  Note that the :results parameter's behavior is not changed. If silent is specified, then no result will be displayed. If output is specified then all the output from the window will appears in the results section. If value is specified, then only the last returned value of the code will be displayed in the results section.

• Maxima: new headers :prologue and :epilogue
  

  Babel options :prologue and :epilogue have been implemented for Maxima src blocks which prepend and append, respectively, the given code strings. This can be useful for specifying formatting settings which would add clutter to exported code. For instance, you can use this :prologue "fpprintprec: 2; linel: 50;" for presenting Maxima results in a beamer presentation.

• PlantUML: add support for header arguments
  

  Plantuml source blocks now support the :prologue, :epilogue and :var header arguments.

• SQL: new engine added sqsh
  

  A new engine was added to support sqsh command line utility for use against Microsoft SQL Server or Sybase SQL server.

  More information on sqsh can be found here: sourceforge/sqsh

  To use sqsh in an sql SRC_BLK set the :engine like this:

  #+BEGIN_SRC sql :engine sqsh :dbhost my_host :dbuser master :dbpassword pass :database support
  Select * From Users
  Where clue > 0
  #+END_SRC
  

• SQL: new engine added vertica
  

  A new engine was added to support vsql command line utility for use against HP Vertica.

  More information on vsql can be found here: my.vertica.com

  To use vertica in an sql SRC_BLK set the :engine like this:

  #+BEGIN_SRC sql :engine vertica :dbhost my_host :dbuser dbadmin :dbpassword pw :database vmart
  SELECT * FROM nodes;
  #+END_SRC
  

• C++: New header :namespaces
  

  The new :namespaces export option can be used to specify namespaces to be used within a C++ org source block. Its usage is similar to :includes, in that it can accept multiple, space-separated namespaces to use. This header is equivalent to adding using namespace <name>; in the source block. Here is a "Hello World" in C++ using :namespaces:

  #+BEGIN_SRC C++ :results output :namespaces std :includes <iostream>
    cout << "Hello World" << endl;
  #+END_SRC
  

• Support for Vala language
  

  Vala language blocks support two special header arguments:

  • :flags passes arguments to the compiler
  • :cmdline passes commandline arguments to the generated executable

  Support for :var does not exist yet, also there is no :session support because Vala is a compiled language.

  The Vala compiler binary can be changed via the defcustom org-babel-vala-compiler.

New function scope argument for the Clock Table

Export

• Implement vernacular table of contents in Markdown exporter
  

  Global table of contents are generated using vanilla Markdown syntax instead of HTML. Also #+TOC keyword, including local table of contents, are now supported.

• Add Slovanian translations
  
• Implement org-export-insert-image-links
  

  This new function is meant to be used in back-ends supporting images as descriptions of links, a.k.a. image links. See its docstring for details.

• New macro : {{{n}}}
  

  This macro creates and increment multiple counters in a document. See manual for details.

• Add global macros through org-export-global-macros
  

  With this variable, one can define macros available for all documents.

• New keyword #+EXPORT_FILE_NAME
  

  Similarly to :EXPORT_FILE_NAME: property, this keyword allows the user to specify the name of the output file upon exporting the document. This also has an effect on publishing.

• Horizontal rules are no longer ignored in LaTeX table math mode
  
• Use compilation-mode for compilation output
  
• Plain lists accept a new :separator attribute in Texinfo
  

  The new :separator attribute splits a tag from a description list item into multiple parts. This allows to have two-column tables with multiple entries in the first column. See manual for more details.

• latex-environment elements support caption keywords for LaTeX export
  

org-edit-special can edit LaTeX environments

org-list-to-generic includes a new property: :ifmt

New variable : org-bibtex-headline-format-function

org-attach supports attaching files from URLs

New option for org-refile-use-outline-path

org-file-contents now allows the FILE argument to be a URL.

org-mode-restart now resets the newly added org--file-cache.

New option : org-table-duration-hour-zero-padding

New mode switch for table formulas : U

Org Timeline

org-agenda-skip-entry-when-regexp-matches is obsolete

org-agenda-skip-subtree-when-regexp-matches is obsolete

org-agenda-skip-entry-when-regexp-matches-in-subtree is obsolete

org-minutes-to-clocksum-string is obsolete

org-hh:mm-string-to-minutes is obsolete

org-duration-string-to-minutes is obsolete

org-gnus-nnimap-cached-article-number is removed.

org-agenda-repeating-timestamp-show-all is removed.

org-gnus-nnimap-query-article-no-from-file is removed.

org-usenet-links-prefer-google is obsolete.

org-publish-sitemap-file-entry-format is deprecated

org-enable-table-editor is removed.

org-export-use-babel cannot be set to inline-only

org-texinfo-def-table-markup is obsolete

org-publish-find-property

org-list-to-org

org-agenda-set-restriction-lock-from-agenda

The Library of Babel now on Worg

Allow multiple columns view

Org Attach obeys dired-dwim-target

org-fill-paragraph can now fill a whole region

More specific anniversary descriptions

Computed dates in tables appear as inactive time stamps

Save point before opening a file with an unknown search option

org-get-heading accepts two more optional arguments

New option org-babel-uppercase-example-markers

INCLUDE keywords in commented trees are now ignored.

Default value for org-texinfo-text-markup-alist changed.

Texinfo exports example blocks as @example

Texinfo exports inline src blocks as @code{}

Texinfo default table markup is @asis

Texinfo default process includes --no-split option

New entities : \dollar and \USD

org-parse-time-string accepts a new optional argument

org-time-string-to-seconds now accepts an optional ZONE argument

Support for date style URLs in org-protocol://open-source

Add (C) COMMENT support to org-structure-template-alist

Emacs 23 support has been dropped

XEmacs support has been dropped

New syntax for export blocks

#+BEGIN_EXPORT backend
...
#+END_EXPORT

#+BEGIN_backend
...
#+END_backend

#+INCLUDE: "file.org" HTML

#+INCLUDE: "file.org" export html

(defun org-repair-export-blocks ()
  "Repair export blocks and INCLUDE keywords in current buffer."
  (interactive)
  (when (eq major-mode 'org-mode)
    (let ((case-fold-search t)
          (back-end-re (regexp-opt
                        '("HTML" "ASCII" "LATEX" "ODT" "MARKDOWN" "MD" "ORG"
                          "MAN" "BEAMER" "TEXINFO" "GROFF" "KOMA-LETTER")
                        t)))
      (org-with-wide-buffer
       (goto-char (point-min))
       (let ((block-re (concat "^[ \t]*#\\+BEGIN_" back-end-re)))
         (save-excursion
           (while (re-search-forward block-re nil t)
             (let ((element (save-match-data (org-element-at-point))))
               (when (eq (org-element-type element) 'special-block)
                 (save-excursion
                   (goto-char (org-element-property :end element))
                   (save-match-data (search-backward "_"))
                   (forward-char)
                   (insert "EXPORT")
                   (delete-region (point) (line-end-position)))
                 (replace-match "EXPORT \\1" nil nil nil 1))))))
       (let ((include-re
              (format "^[ \t]*#\\+INCLUDE: .*?%s[ \t]*$" back-end-re)))
         (while (re-search-forward include-re nil t)
           (let ((element (save-match-data (org-element-at-point))))
             (when (and (eq (org-element-type element) 'keyword)
                        (string= (org-element-property :key element) "INCLUDE"))
               (replace-match "EXPORT \\1" nil nil nil 1)))))))))

org-file-apps no longer accepts S-expressions as commands

("pdf" . (foo))

("pdf" . (lambda (file link) (foo)))

The {{{modification-time}}} macro can get time via vc

Preparation and completion functions in publishing projects change signature

Old Babel header properties are no longer supported

* Headline
:PROPERTIES:
:exports: code
:var: a=1 b=2
:var+: c=3
:END:

* Headline
:PROPERTIES:
:header-args: :exports code
:header-args: :var a=1 b=2
:header-args+: :var c=3
:END:

org-eww has been moved into core

New org-protocol key=value syntax

org-protocol://store-link?url=http:%2F%2Flocalhost%2Findex.html&title=The%20title
org-protocol://capture?template=x&title=Hello&body=World&url=http:%2F%2Fexample.com

org-protocol://store-link:/http:%2F%2Flocalhost%2Findex.html/The%20title

New Org linter library

New option date-tree-last for org-agenda-insert-diary-strategy

New vbar entity

Export

• New #+latex_compiler keyword to set LaTeX compiler.
  

  PDFLaTeX, XeLaTeX, and LuaLaTeX are supported. See the manual for details.

• New option org-export-with-broken-links
  

  This option tells the export process how to behave when encountering a broken internal link. See its docstring for more information.

• Attributes support in custom language environments for LaTeX export
  

  Custom language environments for LaTeX export can now define the string to be inserted during export, using attributes to indicate the position of the elements. See variable org-latex-custom-lang-environments for more details.

• New Texinfo options attribute on special blocks
  

  Using :options as a Texinfo attribute, it is possible to add information to custom environments. See manual for details.

• New HTML id attributes on special, example and quote blocks
  

  If the block has a #+NAME: attribute assigned, then the HTML element will have an id attribute with that name in the HTML export. This enables one to create links to these elements in other places, e.g., <a href="#name">text</a>.

• Listings with captions are now numbered in HTML export
  

  The class associated to the numbering is "listing-number". If you don't want these blocks to be numbered, as it was the case until now, You may want to add .listing-number { display: none; } to the CSS used.

• Line Numbering in SRC/EXAMPLE blocks support arbitrary start number
  

  The -n option to SRC and EXAMPLE blocks can now take a numeric argument to specify the staring line number for the source or example block. The +n option can now take a numeric argument that will be added to the last line number from the previous block as the starting point for the SRC/EXAMPLE block.

  #+BEGIN_SRC emacs-lisp -n 20
  ;; this will export with line number 20
  (message "This is line 21")
  #+END_SRC
  #+BEGIN_SRC emacs-lisp +n 10
  ;; This will be listed as line 31
  (message "This is line 32")
  #+END_SRC
  

• Allow toggling center for images in LaTeX export
  

  With the global variable org-latex-images-centered or the local attribute :center it is now possible to center an image in LaTeX export.

• Default CSS class org-svg for SVG images in HTML export
  

  SVG images exported in HTML are now by default assigned a CSS class org-svg if no CSS class is specified with the :class attribute. By default, the CSS styling of class org-svg specifies an image width of 90 % of the container the image.

• Markdown footnote export customization
  

  Variables org-md-footnotes-section and org-md-footnote-format introduced for ox-md.el. Both new variables define template strings which can be used to customize the format of the exported footnotes section and individual footnotes, respectively.

Babel

• Blocks with coderefs labels can now be evaluated
  

  The labels are removed prior to evaluating the block.

• Support for Lua language
  
• Support for SLY in Lisp blocks
  

  See org-babel-lisp-eval-fn to activate it.

• Support for Stan language
  

  New ob-stan.el library.

  Evaluating a Stan block can produce two different results.

  1. Dump the source code contents to a file.

     This file can then be used as a variable in other blocks, which allows interfaces like RStan to use the model.

  2. Compile the contents to a model file.

     This provides access to the CmdStan interface. To use this, set org-babel-stan-cmdstan-directory and provide a :file argument that does not end in ".stan".

  For more information and usage examples, visit https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-stan.html

• Support for Oracle databases via sqlplus
  

  ob-sql library supports running SQL blocks against an Oracle database using sqlplus. Use with properties like this (all mandatory):

  :engine oracle
  :dbhost <host.com>
  :dbport <1521>
  :dbuser <username>
  :database <database>
  :dbpassword <secret>
  

• Improved support to Microsoft SQL Server via sqlcmd
  

  ob-sql library removes support to the msosql engine which uses the deprecated osql command line tool, and replaces it with mssql engine which uses the sqlcmd command line tool. Use with properties like this:

  :engine mssql
  :dbhost <host.com>
  :dbuser <username>
  :dbpassword <secret>
  :database <database>
  

  If you want to use the trusted connection feature, omit both the dbuser and dbpassword properties and add cmdline -E to the properties.

  If your Emacs is running in a Cygwin environment, the ob-sql library can pass the converted path to the sqlcmd tool.

• Improved support of header arguments for postgresql
  

  The postgresql engine in a sql code block supports now :dbport nd :dbpassword as header arguments.

• Support for additional plantuml output formats
  

  The support for output formats of plantuml has been extended to now include:

  All Diagrams:

  png

  svg

  eps

  pdf

  vdx

  txt

  ASCII art

  utxt

  ASCII art using unicode characters

  Class Diagrams:

  xmi

  html

  State Diagrams:

  scxml

  The output formats are determined by the file extension specified using the :file property, e.g.:

  @startuml
  Alice -> Bob: Authentication Request
  Bob --> Alice: Authentication Response
  
  Alice -> Bob: Another authentication Request
  Alice <-- Bob: another authentication Response
  @enduml
  

  Please note that pdf does not work out of the box and needs additional setup in addition to plantuml. See http://plantuml.com/pdf.html for details and setup information.

Rewrite of radio lists

org-bbdb-anniversaries-future

Clear non-repeated SCHEDULED upon repeating a task

Support for ISO week trees

* 2015
** 2015-W35
** 2015-W36
*** 2015-08-31 Monday

Accept :indent parameter when capturing column view

Columns view

• org-columns accepts a prefix argument
  

  When called with a prefix argument, org-columns apply to the whole buffer unconditionally.

• New variable : org-agenda-view-columns-initially
  

  The variable used to be a defvar, it is now a defcustom.

• Allow custom summaries
  

  It is now possible to add new summary types, or override those provided by Org by customizing org-columns-summary-types, which see.

• Allow multiple summaries for any property
  

  Columns can now summarize the same property using different summary types.

Preview LaTeX snippets in buffers not visiting files

New option org-attach-commit

Allow conditional case-fold searches in org-occur

More robust repeated ox-latex footnote handling

The org-block face is inherited by src-blocks

Links are now customizable

org-next-line-empty-p

org-show-children

org-agenda-filter-by-tag-refine has been removed.

org-agenda-todayp is deprecated.

org-babel-get-header is removed.

org-babel-trim is deprecated.

org-element-remove-indentation is deprecated.

org-image-file-name-regexp is deprecated

org-list-parse-list is deprecated

org-on-heading-p is deprecated

org-table-p is deprecated

org-table-recognize-table.el is deprecated

Various reimplementations of cl-lib functions are deprecated

Remove all options related to ido or iswitchb

Remove org-list-empty-line-terminates-plain-lists

fixltx2e is removed from org-latex-default-packages-alist

Add Icelandic smart quotes

Allow multiple receiver locations in radio tables and lists

Allow angular links within link descriptions

Beamer export back-ends uses org-latex-prefer-user-labels

:preparation-function called earlier during publishing

Function org-remove-indentation changes.

Secure placeholders in capture templates

Links stored by org-gnus-store-link in nnir groups

org-babel-check-confirm-evaluate is now a function instead of a macro

HTML export table row customization changes

ITEM special property returns headline without stars

Rename org-insert-columns-dblock into org-columns-insert-dblock

org-trim can preserve leading indentation.

Function org-info-export changes.

<a href="emacs.html#List-Buffers">emacs#List Buffers</a>

<a href="http://www.gnu.org/software/emacs/manual/html_mono/emacs.html#List-Buffers">emacs#List Buffers</a>

Repeaters with a ++ interval and a time can be shifted to later today

org-mobile-action-alist is now a defconst

file+emacs and file+sys link types are deprecated

New defcustom org-babel-J-command stores the j command

New defalias org-babel-execute:j

org-open-line ignores tables at the very beginning of the buffer

org-babel-hash-show-time is now customizable

New :format property to parsed links

Properties drawers syntax changes

(defun org-repair-property-drawers ()
  "Fix properties drawers in current buffer.
 Ignore non Org buffers."
  (when (eq major-mode 'org-mode)
    (org-with-wide-buffer
     (goto-char (point-min))
     (let ((case-fold-search t)
           (inline-re (and (featurep 'org-inlinetask)
                           (concat (org-inlinetask-outline-regexp)
                                   "END[ \t]*$"))))
       (org-map-entries
        (lambda ()
          (unless (and inline-re (org-looking-at-p inline-re))
            (save-excursion
              (let ((end (save-excursion (outline-next-heading) (point))))
                (forward-line)
                (when (org-looking-at-p org-planning-line-re) (forward-line))
                (when (and (< (point) end)
                           (not (org-looking-at-p org-property-drawer-re))
                           (save-excursion
                             (and (re-search-forward org-property-drawer-re end t)
                                  (eq (org-element-type
                                       (save-match-data (org-element-at-point)))
                                      'drawer))))
                  (insert (delete-and-extract-region
                           (match-beginning 0)
                           (min (1+ (match-end 0)) end)))
                  (unless (bolp) (insert "\n"))))))))))))

#+CATEGORY keywords no longer apply partially to document

* Headline
   :PROPERTIES:
   :CATEGORY: some category
   :END:

New variable to control visibility when revealing a location

Replace disputed keys again when reading a date

No default title is provided when TITLE keyword is missing

Functions signature changes

Default bindings of C-c C-n and C-c C-p changed

org-element-context no longer return objects in keywords

Behavior of org-return changed

org-timer-default-timer type changed from number to string

Hierarchies of tags

#+TAGS: [ Group : SubOne SubTwo ]
#+TAGS: [ SubOne : SubOne1 SubOne2 ]
#+TAGS: [ SubTwo : SubTwo1 SubTwo2 ]

Additional syntax for non-unique grouptags

* Test                                                            :sub1:sub2:

Define regular expression patterns as tags

#+TAGS: [ Project : {P@.+} ]

Filtering in the agenda on grouptags (Tag hierarchies)

Minor refactoring of org-agenda-filter-by-tag

Babel: support for sed scripts

Babel: support for Processing language

New behaviour for `org-toggle-latex-fragment'

Additional markup with #+INCLUDE keyword

File links with #+INCLUDE keyword

Drawers do not need anymore to be referenced in #+DRAWERS

org-edit-special can edit export blocks

Additional :hline processing to ob-shell

Markdown export supports switches in source blocks

New option in ASCII export

New blocks in ASCII export

More back-end specific publishing options

Export inline source blocks

Extend org-export-first-sibling-p and org-export-last-sibling-p

New function: org-export-table-row-in-header-p

New function: org-export-get-reference

New function: org-element-lineage

New function: org-element-copy

New filter: org-export-filter-body-functions

Various improvements on radio tables

Non-floating minted listings in Latex export

Field formulas can now create columns as needed

ASCII plot

New hook: org-archive-hook

New option: org-attach-archive-delete

New option: org-latex-caption-above

New option: org-latex-prefer-user-labels

Export unnumbered headlines

Tables can be sorted with an arbitrary function

Table of contents can be local to a section

Countdown timers can now be paused

New option only-window for org-agenda-window-setup

{{{date}}} macro supports optional formatting argument

{{{property}}} macro supports optional search argument

New option org-export-with-title

New entities family: " "

New MathJax configuration options

New behaviour in `org-export-options-alist'

Viewport support in html export

New #+SUBTITLE export keyword

Remotely edit a footnote definition

New function org-delete-indentation bound to M-^

Support for images in Texinfo export

Support for captions in Texinfo export

Countdown timer support hh:mm:ss format

Extend org-clone-subtree-with-time-shift

New time block for clock tables: untilnow

Support for the polyglossia LaTeX package

None-floating tables, graphics and blocks can have captions

`org-insert-heading' can be forced to insert top-level headline

Removed function org-translate-time

Removed function org-beamer-insert-options-template

Removed function org-timer-cancel-timer

Removed function org-export-solidify-link-text

Removed function org-end-of-meta-data-and-drawers

Removed functions org-table-colgroup-line-p, org-table-cookie-line-p

org-list-empty-line-terminates-plain-lists is deprecated

org-export-with-creator is a boolean

Removed option org-babel-sh-command

Removed option org-babel-sh-var-quote-fmt

Removed option org-insert-labeled-timestamps-at-point

Removed option org-koma-letter-use-title

Removed option org-entities-ascii-explanatory

Removed option org-table-error-on-row-ref-crossing-hline

Removed MathML-related options from org-html-mathjax-options

Removed comment-related filters

Strip all meta data from ITEM special property

File names in links accept are now compatible with URI syntax

Footnotes in included files are now local to the file

Mailto links now use regular URI syntax

QUOTE keywords do not exist anymore

Select tests to perform with the build system

Exact heading search for external links ignore spaces and cookies

org-latex-hyperref-template, org-latex-title-command formatting

float, wasysym, marvosym are removed from org-latex-default-packages-alist

When exporting, throw an error on unresolved id/fuzzy links and code refs

xdg-open has been removed again from org-file-apps-defaults-gnu

Match string for sparse trees can now contain a slash in a property value

Changes in the default packages loaded for LaTeX

Microsoft Outlook support has been added to org-mac-link.el

Lazy autoloading of org-id.el to follow links

New functions for paragraph motion

New agenda fortnight view

New option: org-special-ctrl-o

Combine org-mac-message.el and org-mac-link-grabber into org-mac-link.el

(define-key org-mode-map (kbd "C-c g") 'omgl-grab-link)

(define-key org-mode-map (kbd "C-c g") 'org-mac-grab-link)

HTML export: Replace HTML_HTML5_FANCY by :html-html5-fancy (…)

#+HTML_INCLUDE_STYLE: t

#+OPTIONS: :html-include-style t

org-insert-heading has been rewritten and bugs are now fixed

The replacement of disputed keys is now turned of when reading a date

You can now use xdg-open to control how to open files

C-c ^ x will now sort checklist items by their checked status

Various LaTeX export enhancements

Remapping forward-paragraph and backward-paragraph

New entities in org-entities.el

New option org-bookmark-names-plist

New option org-agenda-ignore-drawer-properties

New option: org-html-link-use-abs-url to force using absolute URLs

New option org-babel-ditaa-java-cmd

New options org-babel-latex-htlatex and org-babel-latex-htlatex-packages

New option: org-habit-show-done-alwyays-green

New option: org-babel-inline-result-wrap

(setq org-babel-inline-result-wrap "$%s$")

ob-makefile.el by Eric Schulte and Thomas S. Dye

ox-man.el by Luis Anaya

ox-md.el by Nicolas Goaziou

ox-texinfo.el by Jonathan Leech-Pepin

ob-julia.el by G. Jay Kerns

ob-mathomatic.el by Luis Anaya

ob-tcl.el by Luis Anaya

org-bullets.el by Evgeni Sabof

ox-confluence.el by Sébastien Delafond

ox-deck.el and ox-s5.el by Rick Frankel

ox-groff.el by Luis Anaya and Nicolas Goaziou

ox-koma-letter.el by Nicolas Goaziou and Alan Schmitt

ox-rss.el by Bastien

Export

• New export generic options
  

  If you use Org exporter, we advise you to re-read the manual section about it. It has been updated and includes new options.

  Among the new/updated export options, three are of particular importance:

  org-export-allow-bind-keywords

  This option replaces the old option org-export-allow-BIND and the default value is nil, not confirm. You will need to explicitly set this to t in your initialization file if you want to allow #+BIND keywords.

  org-export-with-planning

  This new option controls the export of SCHEDULED:, DEADLINE:, CLOSED: lines, and planning information is now skipped by default during export. This use to be the job of org-export-with-timestamps, but this latter option has been given a new role: it controls the export of standalone time-stamps. When set to nil, Org will not export active and inactive time-stamps standing on a line by themselves or within a paragraph that only contains time-stamps.

  To check if an option has been introduced or its default value changed in Org 8.0, do C-h v [option] RET and check if the documentation says that the variable has been introduced (or changed) in version 24.4 of Emacs.

• Enhanced default stylesheet for the HTML exporter
  

  See the new default value of org-html-style-default.

• New tags, classes and ids for the HTML exporter
  

  See the new default value of org-html-divs.

• Support for tikz pictures in LaTeX export
  
• org-man.el: New export function for "man" links
  
• org-docview.el: New export function for docview links
  

Structure editing

• C-u C-u M-RET inserts a heading at the end of the parent subtree
  
• Cycling to the CONTENTS view keeps inline tasks folded
  

  org-cycle-hook as a new function org-cycle-hide-inline-tasks which prevents the display of inline tasks when showing the content of a subtree.

• C-c - in a region makes a list item for each line
  

  This is the opposite of the previous behavior, where C-c - on a region would create one item for the whole region, and where C-u C-c - would create an item for each line. Now C-c - on the selected region creates an item per line, and C-u C-c - creates a single item for the whole region.

• When transposing words, markup characters are now part of the words
  

  In Emacs, you can transpose words with M-t. Transposing *these* _words__ will preserve markup.

• New command org-set-property-and-value bound to C-c C-x P
  

  This command allows you to quickly add both the property and its value. It is useful in buffers where there are many properties and where C-c C-x p can slow down the flow of editing too much.

• New commands org-next-block and org-previous-block
  

  These commands allow you to go to the previous block (C-c M-b or the speedy key B) or to the next block (C-c M-f or the speedy key F.)

• New commands org-drag-line-forward and org-drag-line-backward
  

  These commands emulate the old behavior of M-<down> and M-<up> but are now bound to S-M-<down> and S-M-<up> respectively, since M-<down> and M-<up> now drag the whole element at point (a paragraph, a table, etc.) forward and backward.

• When a list item has a checkbox, inserting a new item uses a checkbox too
  
• When sorting entries/items, only the description of links is considered
  

  Now Org will sort this list

  - [[http://abc.org][B]]
  - [[http://def.org][A]]
  

  like this:

  - [[http://def.org][A]]
  - [[http://abc.org][B]]
  

  by comparing the descriptions, not the links. Same when sorting headlines instead of list items.

• New option orgstruct-heading-prefix-regexp
  

  For example, setting this option to "^;;; " in Emacs lisp files and using orgstruct-mode in those files will allow you to cycle through visibility states as if lines starting with ";;; *…" where headlines.

  In general, you want to set orgstruct-heading-prefix-regexp as a file local variable.

• New behavior of org-clone-subtree-with-time-shift
  

  The default is now to ask for a time-shift only when there is a time-stamp. When called with a universal prefix argument C-u, it will not ask for a time-shift even if there is a time-stamp.

• New option org-agenda-restriction-lock-highlight-subtree
  

  This defaults to t so that the whole subtree is highlighted when you restrict the agenda view to it with C-c C-x < (or the speed command <). The default setting helps ensuring that you are not adding tasks after the restricted region. If you find this highlighting too intrusive, set this option to nil.

• New option org-closed-keep-when-no-todo
  

  When switching back from a DONE keyword to a TODO keyword, Org now removes the CLOSED planning information, if any. It also removes this information when going back to a non-TODO state (e.g., with C-c C-t SPC). If you want to keep the CLOSED planning information when removing the TODO keyword, set org-closed-keep-when-no-todo to t.

• New option org-image-actual-width
  

  This option allows you to change the width of in-buffer displayed images. The default is to use the actual width of the image, but you can use a fixed value for all images, or fall back on an attribute like

  #+attr_html: :width 300px
  

Scheduled/deadline

• Implement "delay" cookies for scheduled items
  

  If you want to delay the display of a scheduled task in the agenda, you can now use a delay cookie like this: SCHEDULED: <2004-12-25 Sat -2d>. The task is still scheduled on the 25th but will appear in your agenda starting from two days later (i.e. from March 27th.)

  Imagine for example that your co-workers are not done in due time and tell you "we need two more days". In that case, you may want to delay the display of the task in your agenda by two days, but you still want the task to appear as scheduled on March 25th.

  In case the task contains a repeater, the delay is considered to affect all occurrences; if you want the delay to only affect the first scheduled occurrence of the task, use --2d instead. See org-scheduled-delay-days and org-agenda-skip-scheduled-delay-if-deadline for details on how to control this globally or per agenda.

• Use C-u C-u C-c C-s will insert a delay cookie for scheduled tasks
  

  See the previous section for why delay cookies may be useful.

• Use C-u C-u C-c C-d will insert a warning delay for deadline tasks
  

  C-u C-u C-c C-d now inserts a warning delay to deadlines.

Calendar, diary and appts

• New variable org-read-date-minibuffer-local-map
  

  By default, this new local map uses "." to go to today's date, like in the normal M-x calendar RET. If you want to deactivate this and to reassign the "@" key to calendar-goto-today, use this:

  ;; Unbind "." in Org's calendar:
  (define-key org-read-date-minibuffer-local-map (kbd ".") nil)
  
  ;; Bind "@" to `calendar-goto-today':
  (define-key org-read-date-minibuffer-local-map
              (kbd "@")
              (lambda () (interactive) (org-eval-in-calendar '(calendar-goto-today))))
  

• In Org's calendar, ! displays diary entries of the date at point
  

  This is useful when you want to check if you don't already have an appointment when setting new ones with C-c . or C-c s. ! will call diary-view-entries and display the diary in a separate buffer.

• org-diary: only keep the descriptions of links
  

  org-diary returns diary information from Org files, but it returns it in a diary buffer, not in an Org mode buffer. When links are displayed, only show their description, not the full links.

Agenda

• New agenda type agenda* and entry types :scheduled* :deadline*
  

  When defining agenda custom commands, you can now use agenda*: this will list entries that have both a date and a time. This is useful when you want to build a list of appointments.

  You can also set org-agenda-entry-types either globally or locally in each agenda custom command and use :timestamp* and/or :deadline* there.

  Another place where this is useful is your .diary file:

  %%(org-diary :scheduled*) ~/org/rdv.org
  

  This will list only entries from ~/org/rdv.org that are scheduled with a time value (i.e. appointments).

• New agenda sorting strategies
  

  org-agenda-sorting-strategy allows these new sorting strategies:

  Strategy	Explanations
  timestamp-up	Sort by any timestamp, early first
  timestamp-down	Sort by any timestamp, late first
  scheduled-up	Sort by scheduled timestamp, early first
  scheduled-down	Sort by scheduled timestamp, late first
  deadline-up	Sort by deadline timestamp, early first
  deadline-down	Sort by deadline timestamp, late first
  ts-up	Sort by active timestamp, early first
  ts-down	Sort by active timestamp, late first
  tsia-up	Sort by inactive timestamp, early first
  tsia-down	Sort by inactive timestamp, late first

• New options to limit the number of agenda entries
  

  You can now limit the number of entries in an agenda view. This is different from filters: filters only hide the entries in the agenda, while limits are set while generating the list of agenda entries.

  These new options are available:

  org-agenda-max-entries

  limit by number of entries.

  org-agenda-max-todos

  limit by number of TODOs.

  org-agenda-max-tags

  limit by number of tagged entries.

  org-agenda-max-effort

  limit by effort (minutes).

  For example, if you locally set org-agenda-max-todos to 3 in an agenda view, the agenda will be limited to the first three todos. Other entries without a TODO keyword or beyond the third TODO headline will be ignored.

  When setting a limit (e.g. about an effort's sum), the default behavior is to exclude entries that cannot be checked against (e.g. entries that have no effort property.) To include other entries too, you can set the limit to a negative number. For example (setq org-agenda-max-tags -3) will not show the fourth tagged headline (and beyond), but it will also show non-tagged headlines.

• ~ in agenda view sets temporary limits
  

  You can hit ~ in the agenda to temporarily set limits: this will regenerate the agenda as if the limits were set. This is useful for example when you want to only see a list of N tasks, or a list of tasks that take only N minutes.

• "=" in agenda view filters by regular expressions
  

  You can now filter agenda entries by regular expressions using =. C-u = will filter entries out. Regexp filters are cumulative. You can set org-agenda-regexp-filter-preset to suit your needs in each agenda view.

• | in agenda view resets all filters
  

  Since it's common to combine tag filters, category filters, and now regexp filters, there is a new command | to reset all filters at once.

• Allow writing an agenda to an .org file
  

  You can now write an agenda view to an .org file. It copies the headlines and their content (but not subheadings) into the new file.

  This is useful when you want to quickly share an agenda containing the full list of notes.

• New commands to drag an agenda line forward (M-<down>) or backward (M-<up>)
  

  It sometimes handy to move agenda lines around, just to quickly reorganize your tasks, or maybe before saving the agenda to a file. Now you can use M-<down> and M-<up> to move the line forward or backward.

  This does not persist after a refresh of the agenda, and this does not change the .org files who contribute to the agenda.

• Use %b for displaying "breadcrumbs" in the agenda view
  

  org-agenda-prefix-format now allows to use a %b formatter to tell Org to display "breadcrumbs" in the agenda view.

  This is useful when you want to display the task hierarchy in your agenda.

• Use %l for displaying the headline's level in the agenda view
  

  org-agenda-prefix-format allows to use a %l formatter to tell Org to display entries with additional spaces corresponding to their level in the outline tree.

• org-agenda-write will ask before overwriting an existing file
  

  M-x org-agenda-write RET (or C-c C-w from an agenda buffer) used to overwrite preexisting file with the same name without confirmation. It now asks for a confirmation.

• New commands M-m and M-* to toggle (all) mark(s) for bulk action
  

  org-agenda-bulk-toggle

  this command is bound to M-m and toggles the mark of the entry at point.

  org-agenda-bulk-toggle-all

  this command is bound to M-* and toggles all the marks in the current agenda.

• New option org-agenda-search-view-max-outline-level
  

  This option sets the maximum outline level to display in search view. E.g. when this is set to 1, the search view will only show headlines of level 1.

• New option org-agenda-todo-ignore-time-comparison-use-seconds
  

  This allows to compare times using seconds instead of days when honoring options like org-agenda-todo-ignore-* in the agenda display.

• New option org-agenda-entry-text-leaders
  

  This allows you to get rid of the ">" character that gets added in front of entries excerpts when hitting E in the agenda view.

• New formatting string for past deadlines in org-agenda-deadline-leaders
  

  The default formatting for past deadlines is "%2d d. ago: ", which makes it explicit that the deadline is in the past. You can configure this via org-agenda-deadline-leaders. Note that the width of the formatting string is important to keep the agenda alignment clean.

• New allowed value repeated-after-deadline for org-agenda-skip-scheduled-if-deadline-is-shown
  

  When org-agenda-skip-scheduled-if-deadline-is-shown is set to repeated-after-deadline, the agenda will skip scheduled items if they are repeated beyond the current dealine.

• New option for org-agenda-skip-deadline-prewarning-if-scheduled
  

  This variable may be set to nil, t, the symbol `pre-scheduled', or a number which will then give the number of days before the actual deadline when the prewarnings should resume. The symbol `pre-scheduled' eliminates the deadline prewarning only prior to the scheduled date.

  Read the full docstring for details.

• org-class now supports holiday strings in the skip-weeks parameter
  

  For example, this task will now be skipped only on new year's day:

  * Task
    <%%(org-class 2012 1 1 2013 12 12 2 "New Year's Day")>
  

Capture

• Allow C-1 as a prefix for org-agenda-capture and org-capture
  

  With a C-1 prefix, the capture mechanism will use the HH:MM value at point (if any) or the current HH:MM time as the default time for the capture template.

• Expand keywords within %(sexp) placeholder in capture templates
  

  If you use a %:keyword construct within a %(sexp) construct, Org will expand the keywords before expanding the %(sexp).

• Allow to contextualize capture (and agenda) commands by checking the name of the buffer
  

  org-capture-templates-contexts and org-agenda-custom-commands-contexts allow you to define what capture templates and what agenda commands should be available in various contexts. It is now possible for the context to check against the name of the buffer.

Tag groups

Links

• C-u C-u M-x org-store-link RET will ignore non-core link functions
  

  Org knows how to store links from Org buffers, from info files and from other Emacs buffers. Org can be taught how to store links from any buffer through new link protocols (see "Adding hyperlink types" in the manual.)

  Sometimes you want Org to ignore added link protocols and store the link as if the protocol was not known.

  You can now do this with C-u C-u M-x org-store-link RET.

• C-u C-u C-u M-x org-store-link RET on an active region will store links for each lines
  

  Imagine for example that you want to store a link for every message in a Gnus summary buffer. In that case C-x h C-u C-u C-u M-x org-store-link RET will store a link for every line (i.e. message) if the region is active.

• C-c C-M-l will add a default description for links which don't have one
  

  C-c C-M-l inserts all stored links. If a link does not have a description, this command now adds a default one, so that we are not mixing with-description and without-description links when inserting them.

• No curly braces to bracket links within internal links
  

  When storing a link to a headline like

  * See [[https://orgmode.org][Org website]]
  

  org-store-link used to convert the square brackets into curly brackets. It does not anymore, taking the link description or the link path, when there is no description.

Table

• Switching between #+TBLFM lines
  

  If you have several #+TBLFM lines below a table, C-c C-c on a line will apply the formulas from this line, and C-c C-c on another line will apply those other formulas.

• You now use "nan" for empty fields in Calc formulas
  

  If empty fields are of interest, it is recommended to reread the section 3.5.2 Formula syntax for Calc of the manual because the description for the mode strings has been clarified and new examples have been added towards the end.

• Handle localized time-stamps in formulas evaluation
  

  If your LOCALE is set so that Org time-stamps use another language than english, and if you make time computations in Org's table, it now works by internally converting the time-stamps with a temporary LOCALE=C before doing computation.

• New lookup functions
  

  There are now three lookup functions:

  • org-loopup-first
  • org-loopup-last
  • org-loopup-all

  See the manual for details.

Startup keywords

Clocking

• New option org-clock-rounding-minutes
  

  E.g. if org-clock-rounding-minutes is set to 5, time is 14:47 and you clock in: then the clock starts at 14:45. If you clock out within the next 5 minutes, the clock line will be removed; if you clock out 8 minutes after your clocked in, the clock out time will be 14:50.

• New option org-time-clocksum-use-effort-durations
  

  When non-nil, C-c C-x C-d uses effort durations. E.g., by default, one day is considered to be a 8 hours effort, so a task that has been clocked for 16 hours will be displayed as during 2 days in the clock display or in the clocktable.

  See org-effort-durations on how to set effort durations and org-time-clocksum-format for more on time clock formats.

• New option org-clock-x11idle-program-name
  

  This allows to set the name of the program which prints X11 idle time in milliseconds. The default is to use x11idle.

• New option org-use-last-clock-out-time-as-effective-time
  

  When non-nil, use the last clock out time for org-todo. Note that this option has precedence over the combined use of org-use-effective-time and org-extend-today-until.

• S-<left/right> on a clocksum column will update the sum by updating the last clock
  
• C-u 3 C-S-<up/down> will update clock timestamps synchronously by 3 units
  
• New parameter :wstart for clocktables to define the week start day
  
• New parameter :mstart to state the starting day of the month
  
• Allow relative times in clocktable tstart and tend options
  
• The clocktable summary is now a caption
  
• :tstart and :tend and friends allow relative times like "<-1w>" or "<now>"
  

Babel

• You can now use C-c C-k for org-edit-src-abort
  

  This allows you to quickly cancel editing a source block.

• C-u C-u M-x org-babel-tangle RET tangles by the target file of the block at point
  

  This is handy if you want to tangle all source code blocks that have the same target than the block at point.

• New options for auto-saving the base buffer or the source block editing buffer
  

  When org-edit-src-turn-on-auto-save is set to t, editing a source block in a new window will turn on auto-save-mode and save the code in a new file under the same directory than the base Org file.

  When org-edit-src-auto-save-idle-delay is set to a number of minutes N, the base Org buffer will be saved after this number of minutes of idle time.

• New :post header argument post-processes results
  

  This header argument may be used to pass the results of the current code block through another code block for post-processing. See the manual for a usage example.

• Commented out heading are ignored when collecting blocks for tangling
  

  If you comment out a heading (with C-c ; anywhere on the heading or in the subtree), code blocks from within this heading are now ignored when collecting blocks for tangling.

• New option org-babel-hash-show-time to show a time-stamp in the result hash
  
• Do not ask for confirmation if cached value is current
  

  Do not run org-babel-confirm-evaluate if source block has a cache and the cache value is current as there is no evaluation involved in this case.

• ob-sql.el and ob-python.el have been improved.
  
• New Babel files only need to (require 'ob)
  

  When writing a new Babel file, you now only need to use (require 'ob) instead of requiring each Babel library one by one.

Faces

Spanish translation of the Org guide by David Arroyo Menéndez

poporg.el and outorg.el

MobileOrg for iOS

New build system

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.

New packages in contrib/

• 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/

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

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)
  

Org Element

• 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-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-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-backward-element and org-forward-element (respectively M-{ and M-})
  

  This will move the point backward/forward in the hierarchy of elements.

• org-narrow-to-element will narrow to the element at point
  
• 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 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 buffer will be named using the agenda key and its description. In sticky agendas, the q key will just bury the agenda buffers and further agenda commands will show existing buffer instead of generating new ones.

  If org-agenda-sticky is set to nil, q will kill the single agenda buffer.

• 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.

• Changes in bulk actions
  

  The set of commands starting with k ... as been deleted and the features have been merged into the "bulk action" feature.

  After you marked some entries in the agenda, if you call B s, the agenda entries will be rescheduled using the date at point if on a date header. If you are on an entry with a timestamp, you will be prompted for a date to reschedule your marked entries to, using the timestamp at point as the default prompt.

  You can now use k to capture the marked entry and use the date at point as an overriding date for the capture template.

  To bind this behavior to M-x org-capture RET (or its keybinding), set the new option org-capture-use-agenda-date to t.

• 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.

• 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.

• 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.

• New todo-unblocked and nottodo-unblocked skip conditions
  

  See the git commit for more explanations.

• 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 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.

• 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.

• 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.

• New option org-url-hexify-p
  

  When set to nil, the URL part of a link will not be hexified.

• Org can now open multiple shell links
  
• New option org-doi-server-url to specify an alternate DOI server
  
• 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.

• 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.

• New command org-insert-drawer to insert a drawer interactively
  
• 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.

• 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 Clock

• New keybinding C-c C-x C-z for org-clock-resolve
  
• New keybinding C-c C-x C-q for 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.

• C-u M-x org-clock-out RET now prompts for a state to switch to
  
• 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).

• New option org-clock-frame-title-format
  

  This option sets the value of frame-title-format when clocking in.

• 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.

• 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 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.

• New command org-redisplay-inline-images
  

  This will redisplay all images. It is bound to C-c C-x C-M-v.

• New entities in org-entities.el
  

  There are these new entities:

  ("tilde" "\\~{}" nil "˜" "~" "~" "~")
  ("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.

• 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.

• 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 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.

• 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.

• 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.

• 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 Export

• New functions orgtbl-to-table.el and orgtbl-to-unicode
  

  orgtbl-to-table.el 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.

• 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 the default method for exporting the table.

• New option org-export-date-timestamp-format
  

  The option allows to set a time string format for Org timestamps in the #+DATE option.

• LaTeX: New options for exporting table rules :tstart, :hline and :tend
  

  See org-export-latex-tables-hline and 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.

• Beamer: New option org-beamer-inherited-properties
  

  This option allows Beamer export to inherit some properties. Thanks to Carsten for implementing this.

• ODT: Add support for ODT export in org-bbdb.el
  
• ODT: Add support for indented tables (see this commit for details)
  
• 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 Babel

• New :results drawer parameter
  

  :results drawer replaces :results wrap, which is deprecated but still supported.

• :results org now put results in a #+BEGIN_SRC org block
  

  :results org used to put results in a #+BEGIN_ORG block but it now puts results in a #+BEGIN_SRC org block, wich comma-escaped lines.

  #+BEGIN_ORG blocks are obsolete.

• Exporting #+BEGIN_SRC org blocks exports the code
  

  It used to exports the results of the code.

Miscellaneous

• New menu entry for org-refile
  
• Allow capturing to encrypted entries
  

  If you capture to an encrypted entry, it will be decrpyted before inserting the template then re-encrypted after finalizing the capture.

• Inactive timestamps are now handled in tables
  

  Calc can do computation on active time-stamps like <2012-09-29 Sat>. Inactive time-stamps in a table's cell are now internally deactivated so that Calc formulas can operate on them.

• org-table-number-regexp accept comma as a decimal mark to represent numbers
  
• 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.

• 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.

• 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.

• New option org-latex-preview-ltxpng-directory
  

  This lets you define the path for the ltxpng/ directory.

• You can now use imagemagick instead of dvipng to preview LaTeX fragments
  
• You can now turn off orgstruct++-mode safely
  
• 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-feed.el now expands %(sexp) templates
  
• New option org-protocol-data-separator
  
• New option org-ditaa-jar-option to specify the ditaa jar file
  
• 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.

• New option org-habit-show-all-today
  

  When set to t, show all (even unscheduled) habits on today's agenda.

M-TAB on options keywords perform completion correctly again

Add licenses to javascript embedded and external code snippets

Emacs 21 support has been dropped

XEmacs support requires the XEmacs development version

New keys for TODO sparse trees

The Agenda org-agenda-ndays is now obsolete

Changes to the intended use of org-export-latex-classes

(setq org-export-latex-default-packages-alist nil
      org-export-latex-packages-alist nil)

[DEFAULT-PACKAGES]      \usepackage statements for default packages
[NO-DEFAULT-PACKAGES]   do not include any of the default packages
[PACKAGES]              \usepackage statements for packages
[NO-PACKAGES]           do not include the packages
[EXTRA]                 the stuff from #+LaTeX_HEADER
[NO-EXTRA]              do not include #+LaTeX_HEADER stuff

The constant org-html-entities is obsolete

org-bbdb-anniversary-format-alist has changed

Deleted org-mode-p

New Org to ODT exporter

org-capture.el is now the default capture system

New Org libraries

• org-eshell.el (Konrad Hinsen)
  

  Implement links to eshell buffers.

• org-special-blocks (Carsten Dominik)
  

  This package generalizes the #+begin_foo and #+end_foo tokens.

  To use, put the following in your init file:

  (require 'org-special-blocks)
  

  The tokens #+begin_center, #+begin_verse, etc. existed previously. This package generalizes them (at least for the LaTeX and html exporters). When a #+begin_foo token is encountered by the LaTeX exporter, it is expanded into \begin{foo}. The text inside the environment is not protected, as text inside environments generally is. When #+begin_foo is encountered by the html exporter, a div with class foo is inserted into the HTML file. It is up to the user to add this class to his or her stylesheet if this div is to mean anything.

• org-taskjuggler.el (Christian Egli)
  

  Christian Egli's org-taskjuggler.el module is now part of Org. He also wrote a tutorial for it.

• org-ctags.el (Paul Sexton)
  

  Targets like <<my target>> can now be found by Emacs' etag functionality, and Org-mode links can be used to to link to etags, also in non-Org-mode files. For details, see the file org-ctags.el.

  This feature uses a new hook org-open-link-functions which will call function to do something special with text links.

  Thanks to Paul Sexton for this contribution.

• org-docview.el (Jan Böcker)
  

  This new module allows links to various file types using docview, where Emacs displays images of document pages. Docview link types can point to a specific page in a document, for example to page 131 of the Org-mode manual:

  [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]]
  

  Thanks to Jan Böcker for this contribution.

New Babel libraries

Hyperlinks

• Org-Bibtex – major improvements
  

  Provides support for managing bibtex bibliographical references data in headline properties. Each headline corresponds to a single reference and the relevant bibliographic meta-data is stored in headline properties, leaving the body of the headline free to hold notes and comments. Org-bibtex is aware of all standard bibtex reference types and fields.

  The key new functions are

  org-bibtex-check

  queries the user to flesh out all required (and with prefix argument optional) bibtex fields available for the specific reference type of the current headline.

  org-bibtex-create

  Create a new entry at the given level, using org-bibtex-check to flesh out the relevant fields.

  org-bibtex-yank

  Yank a bibtex entry on the kill ring as a formatted Org-mode headline into the current buffer

  org-bibtex-export-to-kill-ring

  Export the current headline to the kill ring as a formatted bibtex entry.

• org-gnus.el now allows link creation from messages
  

  You can now create links from messages. This is particularly useful when the user wants to stored messages that he sends, for later check. Thanks to Ulf Stegemann for the patch.

• Modified link escaping
  

  David Maus worked on `org-link-escape'. See his message:

  Percent escaping is used in Org mode to escape certain characters
  in links that would either break the parser (e.g. square brackets
  in link target oder description) or are not allowed to appear in
  a particular link type (e.g. non-ascii characters in a http:
  link).
  
  With this change in place Org will apply percent escaping and
  unescaping more consistently especially for non-ascii characters.
  Additionally some of the outstanding bugs or glitches concerning
  percent escaped links are solved.
  

  Thanks a lot to David for this work.

• Make org-store-link point to directory in a dired buffer
  

  When, in a dired buffer, the cursor is not in a line listing a file, `org-store-link' will store a link to the directory.

  Patch by Stephen Eglen.

• Allow regexps in org-file-apps to capture link parameters
  

  The way extension regexps in org-file-apps are handled has changed. Instead of matching against the file name, the regexps are now matched against the whole link, and you can use grouping to extract link parameters which you can then use in a command string to be executed.

  For example, to allow linking to PDF files using the syntax file:/doc.pdf::<page number>, you can add the following entry to org-file-apps:

  Extension: \.pdf::\([0-9]+\)\'
  Command:   evince "%s" -p %1
  

  Thanks to Jan Böcker for a patch to this effect.

Dates and time

• Allow relative time when scheduling/adding a deadline
  

  You can now use relative duration strings like "-2d" or "++3w" when calling org-schedule or org-deadline: it will schedule (or set the deadline for) the item respectively two days before today and three weeks after the current timestamp, if any.

  You can use this programmatically: (org-schedule nil "+2d") will work on the current entry.

  You can also use this while (bulk-)rescheduling and (bulk-)resetting the deadline of (several) items from the agenda.

  Thanks to Memnon Anon for a heads up about this!

• American-style dates are now understood by org-read-date
  

  So when you are prompted for a date, you can now answer like this

  2/5/3         --> 2003-02-05
  2/5           --> <CURRENT-YEAR>-02-05
  

Agenda

• org-agenda-custom-commands has a default value
  

  This option used to be `nil' by default. This now has a default value, displaying an agenda and all TODOs. See the docstring for details. Thanks to Carsten for this.

• Improved filtering through org-agenda-to-appt
  

  The new function allows the user to refine the scope of entries to pass to org-agenda-get-day-entries and allows to filter out entries using a function.

  Thanks to Peter Münster for raising a related issue and to Tassilo Horn for this idea. Also thanks to Peter Münster for fixing a small bug in the final implementation.

• Allow ap/pm times in agenda time grid
  

  Times in the agenda can now be displayed in am/pm format. See the new variable org-agenda-timegrid-use-ampm. Thanks to C. A. Webber for a patch to this effect.

• Agenda: Added a bulk "scattering" command
  

  B S in the agenda buffer will cause tasks to be rescheduled a random number of days into the future, with 7 as the default. This is useful if you've got a ton of tasks scheduled for today, you realize you'll never deal with them all, and you just want them to be distributed across the next N days. When called with a prefix arg, rescheduling will avoid weekend days.

  Thanks to John Wiegley for this.

Exporting

• Simplification of org-export-html-preamble/postamble
  

  When set to `t', export the preamble/postamble as usual, honoring the org-export-email/author/creator-info variables.

  When set to a formatting string, insert this string. See the docstring of these variable for details about available %-sequences.

  You can set :html-preamble in publishing project in the same way: `t' means to honor :email/creator/author-info, and a formatting string will insert a string.

• New exporters to Latin-1 and UTF-8
  

  While Ulf Stegemann was going through the entities list to improve the LaTeX export, he had the great idea to provide representations for many of the entities in Latin-1, and for all of them in UTF-8. This means that we can now export files rich in special symbols to Latin-1 and to UTF-8 files. These new exporters can be reached with the commands C-c C-e n and C-c C-e u, respectively.

  When there is no representation for a given symbol in the targeted coding system, you can choose to keep the TeX-macro-like representation, or to get an "explanatory" representation. For example, \simeq could be represented as "[approx. equal to]". Please use the variable org-entities-ascii-explanatory to state your preference.

• HTML export: Add class to outline containers using property
  

  The HTML_CONTAINER_CLASS property can now be used to add a class name to the outline container of a node in HTML export.

• Throw an error when creating an image from a LaTeX snippet fails
  

  This behavior can be configured with the new option variable org-format-latex-signal-error.

• Support for creating BEAMER presentations from Org-mode documents
  

  Org-mode documents or subtrees can now be converted directly in to BEAMER presentation. Turning a tree into a simple presentations is straight forward, and there is also quite some support to make richer presentations as well. See the BEAMER section in the manual for more details.

  Thanks to everyone who has contributed to the discussion about BEAMER support and how it should work. This was a great example for how this community can achieve a much better result than any individual could.

Refiling

• Refile targets can now be cached
  

  You can turn on caching of refile targets by setting the variable org-refile-use-cache. This should speed up refiling if you have many eligible targets in many files. If you need to update the cache because Org misses a newly created entry or still offers a deleted one, press C-0 C-c C-w.

• New logging support for refiling
  

  Whenever you refile an item, a time stamp and even a note can be added to this entry. For details, see the new option org-log-refile.

  Thanks to Charles Cave for this idea.

Completion

• In-buffer completion is now done using John Wiegley's pcomplete.el
  

  Thanks to John Wiegley for much of this code.

Tables

• New command org-table-transpose-table-at-point
  

  See the docstring. This hack from Juan Pechiar is now part of Org's core. Thanks to Juan!

• Display field's coordinates when editing it with C-c `
  

  When editing a field with C-c `, the field's coordinate will the displayed in the buffer.

  Thanks to Michael Brand for a patch to this effect.

• Spreadsheet computation of durations and time values
  

  If you want to compute time values use the T flag, either in Calc formulas or Elisp formulas:

  Task 1	Task 2	Total
  35:00	35:00	1:10:00

  Values must be of the form [HH:]MM:SS, where hours are optional.

  Thanks to Martin Halder, Eric Schulte and Carsten for code and feedback on this.

• Implement formulas applying to field ranges
  

  Carsten implemented this field-ranges formulas.

  A frequently requested feature for tables has been to be able to define
  row formulas in a way similar to column formulas.  The patch below allows
  things like
  
  @3=
  @2$2..@5$7=
  @I$2..@II$4=
  
  as the left hand side for table formulas in order to write a formula that
  is valid for an entire column or for a rectangular section in a
  table.
  

  Thanks a lot to Carsten for this.

• Sending radio tables from org buffers is now allowed
  

  Org radio tables can no also be sent inside Org buffers. Also, there is a new hook which get called after a table has been sent.

  Thanks to Seweryn Kokot.

Lists

• Improved handling of lists
  

  Nicolas Goaziou extended and improved the way Org handles lists.

  1. Indentation of text determines again end of items in lists. So, some text less indented than the previous item doesn't close the whole list anymore, only all items more indented than it.
  2. Alphabetical bullets are implemented, through the use of the variable `org-alphabetical-lists'. This also adds alphabetical counters like [@c] or [@W].
  3. Lists can now safely contain drawers, inline tasks, or various blocks, themselves containing lists. Two variables are controlling this: `org-list-forbidden-blocks', and `org-list-export-context'.
  4. Improve `newline-and-indent' (C-j): used in an item, it will keep text from moving at column 0. This allows to split text and make paragraphs and still not break the list.
  5. Improve `org-toggle-item' (C-c -): used on a region with standard text, it will change the region into one item. With a prefix argument, it will fallback to the previous behavior and make every line in region an item. It permits to easily integrate paragraphs inside a list.
  6. `fill-paragraph' (M-q) now understands lists. It can freely be used inside items, or on text just after a list, even with no blank line around, without breaking list structure.

  Thanks a lot to Nicolas for all this!

Inline display of linked images

Implement offsets for ordered lists

1. [@start:12] will star a lit a number 12

Babel: code block body expansion for table and preview

Editing Convenience and Appearance

• New command org-copy-visible (C-c C-x v)
  

  This command will copy the visible text in the region into the kill ring. Thanks to Florian Beck for this function and to Carsten for adding it to org.el and documenting it!

• Make it possible to protect hidden subtrees from being killed by C-k
  

  See the new variable org-ctrl-k-protect-subtree. This was a request by Scott Otterson.

• Implement pretty display of entities, sub-, and superscripts.
  

  The command C-c C-x \ toggles the display of Org's special entities like \alpha as pretty unicode characters. Also, sub and superscripts are displayed in a pretty way (raised/lower display, in a smaller font). If you want to exclude sub- and superscripts, see the variable org-pretty-entities-include-sub-superscripts.

  Thanks to Eric Schulte and Ulf Stegeman for making this possible.

• New faces for title, date, author and email address lines
  

  The keywords in these lines are now dimmed out, and the title is displayed in a larger font, and a special font is also used for author, date, and email information. This is implemented by the following new faces:

  org-document-title org-document-info org-document-info-keyword

  In addition, the variable org-hidden-keywords can be used to make the corresponding keywords disappear.

  Thanks to Dan Davison for this feature.

• Simpler way to specify faces for tags and todo keywords
  

  The variables org-todo-keyword-faces, org-tag-faces, and org-priority-faces now accept simple color names as specifications. The colors will be used as either foreground or background color for the corresponding keyword. See also the variable org-faces-easy-properties, which governs which face property is affected by this setting.

  This is really a great simplification for setting keyword faces. The change is based on an idea and patch by Ryan Thompson.

• <N> in tables now means fixed width, not maximum width
  

  Requested by Michael Brand.

• Better level cycling function
  

  TAB in an empty headline cycles the level of that headline through likely states. Ryan Thompson implemented an improved version of this function, which does not depend upon when exactly this command is used. Thanks to Ryan for this improvement.

• Adaptive filling
  

  For paragraph text, org-adaptive-fill-function did not handle the base case of regular text which needed to be filled. This is now fixed. Among other things, it allows email-style ">" comments to be filled correctly.

  Thanks to Dan Hackney for this patch.

• `org-reveal' (C-c C-r) also decrypts encrypted entries (org-crypt.el)
  

  Thanks to Richard Riley for triggering this change.

• Better automatic letter selection for TODO keywords
  

  When all first letters of keywords have been used, Org now assigns more meaningful characters based on the keywords.

  Thanks to Mikael Fornius for this patch.

Clocking

• Clock: Allow synchronous update of timestamps in CLOCK log
  

  Using S-M-<up/down> on CLOCK log timestamps will increase/decrease the two timestamps on this line so that duration will keep the same. Note that duration can still be slightly modified in case a timestamp needs some rounding.

  Thanks to Rainer Stengele for this idea.

• Localized clock tables
  

  Clock tables now support a new new :lang parameter, allowing the user to customize the localization of the table headers. See the variable org-clock-clocktable-language-setup which controls available translated strings.

• Show clock overruns in mode line
  

  When clocking an item with a planned effort, overrunning the planned time is now made visible in the mode line, for example using the new face org-mode-line-clock-overrun, or by adding an extra string given by org-task-overrun-text.

  Thanks to Richard Riley for a patch to this effect.

• Clock reports can now include the running, incomplete clock
  

  If you have a clock running, and the entry being clocked falls into the scope when creating a clock table, the time so far spent can be added to the total. This behavior depends on the setting of org-clock-report-include-clocking-task. The default is nil.

  Thanks to Bernt Hansen for this useful addition.

Misc

• Improvements with inline tasks and indentation
  

  There is now a configurable way on how to export inline tasks. See the new variable org-inlinetask-export-templates.

  Thanks to Nicolas Goaziou for coding these changes.

• A property value of "nil" now means to unset a property
  

  This can be useful in particular with property inheritance, if some upper level has the property, and some grandchild of it would like to have the default settings (i.e. not overruled by a property) back.

  Thanks to Robert Goldman and Bernt Hansen for suggesting this change.

• New helper functions in org-table.el
  

  There are new functions to access and write to a specific table field. This is for hackers, and maybe for the org-babel people.

  org-table-get
  org-table-put
  org-table-current-line
  org-table-goto-line
  

• Archiving: Allow to reverse order in target node
  

  The new option org-archive-reversed-order allows to have archived entries inserted in a last-on-top fashion in the target node.

  This was requested by Tom.

• Org-reveal: Double prefix arg shows the entire subtree of the parent
  

  This can help to get out of an inconsistent state produced for example by viewing from the agenda.

  This was a request by Matt Lundin.

Standardized code block keywords

(defun update-org-buffer ()
  "Update an Org mode buffer to the new data, code block and call line syntax."
  (interactive)
  (save-excursion
    (flet ((to-re (lst) (concat "^[ \t]*#\\+" (regexp-opt lst t)
                                "\\(\\[\\([[:alnum:]]+\\)\\]\\)?\\:[ \t]*"))
           (update (re new)
                   (goto-char (point-min))
                   (while (re-search-forward re nil t)
                     (replace-match new nil nil nil 1))))
      (let ((old-re (to-re '("RESULTS" "DATA" "SRCNAME" "SOURCE")))
            (lob-re (to-re '("LOB")))
            (case-fold-search t))
        (update old-re "name")
        (update lob-re "call")))))

Removed the #+BABEL: keyword

Deleted org-mode-p (git)

Day names are optional when you type timestamps manually (git)

Improved filtering through org-agenda-to-appt (git)

org-agenda-date-later jumps to today when modifying past date (git)

Use prefix arg 0 to inhibit note taking for TODO change (git)

Various improvements to org-indent.el

Property names ending in + accumulate

#+property: var  foo=1
#+property: var+ bar=2

#+begin_src emacs-lisp
,  (+ foo bar)
#+end_src

#+results:
,: 3

#+begin_src emacs-lisp
,  (org-entry-get (point) "var" t)
#+end_src

#+results:
,: foo=1 bar=2

* overwriting a file-wide property
,  :PROPERTIES:
,  :var:      foo=7
,  :END:

#+begin_src emacs-lisp
,  foo
#+end_src

#+results:
,: 7

#+begin_src emacs-lisp
,  (org-entry-get (point) "var" t)
#+end_src

#+results:
,: foo=7

* appending to a file-wide property
,  :PROPERTIES:
,  :var+:      baz=3
,  :END:

#+begin_src emacs-lisp
,  (+ foo bar baz)
#+end_src

#+results:
,: 6

#+begin_src emacs-lisp
,  (org-entry-get (point) "var" t)
#+end_src

#+results:
,: foo=1 bar=2 baz=3

org-agenda-custom-commands has a default value (git)

outline-demote/promote points to org-demote/promote-subtree

New escape characters for org-log-note-headings (git)

New command org-table-transpose-table-at-point (git)

Allow recursive edit of minibuffer (git)

Allow dynamic construction of the publishing destination (git)

Set the capture default time to the prompt time (git)

org-agenda-skip-additional-timestamps-same-entry defaults to `nil' (git)

org-sudoku.el – small sudoku solver

Added tikzDevice support to ob-R.el

Support for Pico Lisp code blocks

Extension to the eval code block header argument

Update of intermediate results during code block evaluation

Support for Fortran code block is now in the core

The sbe function allows header argument specification

Support for Shen code blocks

New option org-export-html-headline-anchor-format (git)

New option org-table-formula-field-format (git)

New option org-loop-over-headlines-in-active-region (git)

New option org-catch-invisible-edits (git)

+nil              Do not check, so just do invisible edits.
+error            Throw an error and do nothing.
+show             Make point visible, and do the requested edit.
+show-and-error   Make point visible, then throw an error and abort the edit.
+smart            Make point visible, and do insertion/deletion if it is
                  adjacent to visible text and the change feels predictable.

New option org-export-latex-table-caption-above

New option org-agenda-follow-indirect (git)

New option org-refile-active-region-within-subtree (git)

New option org-latex-to-mathml-convert-command

New option org-properties-postprocess-alist (git)

Alist of properties and functions to adjust inserted values.
Elements of this alist must be of the form

  ([string] [function])

where [string] must be a property name and [function] must be a
lambda expression: this lambda expression must take one argument,
the value to adjust, and return the new value as a string.

For example, this element will allow the property "Remaining"
to be updated wrt the relation between the "Effort" property
and the clock summary:

 (("Remaining" 
     (lambda(value)
       (let ((clocksum (org-clock-sum-current-item))
             (effort (org-duration-string-to-minutes
                     (org-entry-get (point) "Effort"))))
         (org-minutes-to-hh:mm-string (- effort clocksum))))))

New options org-habit-today-glyph and org-habit-completed-glyph (git)

New option org-bibtex-type-property-name (git)

New face org-agenda-filter-tags (git)

New faces org-agenda-calendar-event and org-agenda-calendar-sexp (git)

Respect org-export-with-tags when exporting a subtree (git)

Fix XEmacs compatibility issue when creating an indirect buffer (git)

New test function org-test-with-temp-text-in-file (https://code.orgmode.org/bzg/org-mode/commit/1f206ed4)

New command org-copy-visible (C-c C-x v)

New hook org-ctrl-c-ctrl-c-final-hook

Allow relative time when scheduling/adding a deadline

New functions: org-todo-yesterday and org-agenda-todo-yesterday

org-set-property defaults to the last interactively modified property

Clock: Allow synchronous update of timestamps in CLOCK log

Clock: New function org-clock-remove-empty-clock-drawer

Capture: new escape sequence %F for templates

Agenda: new variable org-agenda-bulk-custom-functions for custom bulk functions

Refile: exclude irrelevant headings

Lists: new variable org-list-use-circular-motion

Lists: New variable org-list-indent-offset

- First item
	  - Sub-item 1
	  - Sub-item 2
- Second item

Table: New flag ";t" to tailor the display of computed durations

Table: display field's coordinates when editing it with C-c `

Babel: support for java code blocks

#+begin_src java :classname myfirstjavaprog
,  class myfirstjavaprog
,  {
,      public static void main(String args[])
,      {
,          System.out.println("Hello World!");
,      }
,  }
#+end_src

#+results:
,: Hello World!

Babel: support for fortran code blocks by Sergey Litvinov

Babel: support for the fomus language by Torsten Anders

Publish: hide .orgx files and use theindex.org directly

Export: new variable org-export-html-divs to allow custom divs

Export: new variable org-export-latex-quotes to customize quotes in LaTeX export

Duration computations now work for complex ranges in tables

Handle recursive setup files correctly

org-map-entries can now have 'region as its scope

org-depend.el: new chain-find-next trigger option

Export: new experimental exporter to MoinMoin by Puneeth Chaganti.

Export: new default for org-export-html-preamble

Export: new variable org-lparse-use-flashy-warning defaulting to nil

Export: new default value for org-export-latex-image-default-option

Export: allow org-export-latex-href-format to have only one "%s"

The ODT exporter will choke when using some Org-defined strings

Integration of Jambunathan's OpenDocumentText Exporter

• Activation
  

  Org mode 7.6 supports exporting to OpenDocument Text (odt) format using org-odt.el. Depending on how you installed Org, this module can be enabled in one of the following ways:

  1. If you have downloaded the Org from the Web, either as a distribution .zip or .tar.gz file, or as a Git archive, enable the odt option in the variable org-modules.
  2. If you are using Org mode 7.6 that comes bundled with Emacs-24.0.50 (or future Emacs-24.1), then you can install the OpenDocumentText exporter using the package manager. Check the list of available packages with M-x list-packages and install the org-odt package.

  Thanks a lot to Jambunathan K for this great contribution.

• Keybindings
  

  The following interactive commands are provided:

  1. C-c C-e o (org-export-as-odt): Export as an odt file.
  2. C-c C-e O (org-export-as-odt-and-open): Export as an odt file and open the resulting file.

  See the contrib/odt/README.org file for further details; you may check in particular the commands M-x org-lparse and M-x org-export-convert.

Ob-Lilypond – new Babel language to allow score generation

Org-Bibtex – major improvements

Spreadsheet computation of durations and time values

Links within inlined footnotes.

New variable org-export-with-tasks

New variable org-export-latex-timestamp-inactive-markup

New org-default face

Babel improvements

• In line code block call syntax
  

  It is now possible to call code blocks from within blocks of prose.

  The new syntax is exactly analogous to the existing #+call: line syntax, only it may be present embedded in a block of prose for example call_double(num=8) would call the double code block assigning the num variable to the value 8.

• Optional variable names in code block calls
  

  Variable names are now optional when passing variables to a code block reference. Un-named variables will be assigned in order as shown below.

  #+source: minus
  #+begin_src emacs-lisp :var a=0 :var b=0
    (- a b)
  #+end_src
  
  #+call: minus(a=8, b=4)
  
  #+call: minus(8,4)
  

• Sub-tree ID as valid code block variable reference
  

  It is now possible to assign the textual contents of an Org mode subtree to a code block variable using the ID of the subtree. Both custom IDs and Org mode IDs may be used. For example;

  #+begin_src sh :var text=foo
  ,  echo "$text"|wc
  #+end_src
  
  #+results:
  ,: 8      58     415
  
  * example foo
  ,  :PROPERTIES:
  ,  :CUSTOM_ID: foo
  ,  :END:
  
  ,Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Donec
  ,hendrerit tempor tellus. Donec pretium posuere tellus. Proin quam
  ,nisl, tincidunt et, mattis eget, convallis nec, purus. Cum sociis
  ,natoque penatibus et magnis dis parturient montes, nascetur ridiculus
  ,mus. Nulla posuere. Donec vitae dolor. Nullam tristique diam non
  ,turpis. Cras placerat accumsan nulla. Nullam rutrum. Nam vestibulum
  ,accumsan nisl.
  

• org-babel-tangle-body-hook for reprocessing code block bodies during tangling
  
• padline header argument controls newline padding during tangling
  
• Maxima code blocks are now supported
  

  Thanks to Eric Fraga for contributing this support.

• awk code blocks are now supported
  
• Added xmpfilter to Ruby code blocks for annotated code output
  
• New noweb-ref header argument
  

  This header argument may be used to concatenate the bodies of many code blocks into a single noweb reference. This brings Org mode's tangling functionality in line with traditional noweb tangling.

  A no web reference like the following

  #+begin_src sh
  ,  <<the-ref>>
  #+end_src
  

  will now expand to include the bodies of all code blocks which are named the-ref, as well as all code blocks which have a :noweb-ref header argument set to the value the-ref.

New tests

Org-exp-blocks — proper handling of recursively nested blocks

#+begin_src org
,  ,#+begin_example
,  ,  nested example
,  ,#+end_example
#+end_src

List handling

Footnotes have gone through some bug-fixing:

Many small bug fixes have been applied to list handling

Code block variable initialized with Emacs Lisp code in tables and lists

$data

(a b c)

`org-bbdb-anniversary-format-alist' has changed

Implement formulas applying to field ranges

A frequently requested feature for tables has been to be able to define
row formulas in a way similar to column formulas.  The patch below allows
things like

@3=
@2$2..@5$7=
@I$2..@II$4=

as the left hand side for table formulas in order to write a formula that
is valid for an entire column or for a rectangular section in a
table.

Improved handling of lists

Modified link escaping

Percent escaping is used in Org mode to escape certain characters
in links that would either break the parser (e.g. square brackets
in link target oder description) or are not allowed to appear in
a particular link type (e.g. non-ascii characters in a http:
link).

With this change in place Org will apply percent escaping and
unescaping more consistently especially for non-ascii characters.
Additionally some of the outstanding bugs or glitches concerning
percent escaped links are solved.

Simplification of org-export-html-preamble/postamble

New command `org-agenda-append-agenda'

Localized clock tables

New sorting options when publishing projects

Testing with ERT

New file in contrib/: org-notmuch.el

=org-notmuch.el= implements links to notmuch messages and
"searchs". A search is a query to be performed by notmuch; it is
the equivalent to folders in other mail clients. Similarly, mails
are refered to by a query, so both a link can refer to several
mails.

org-gnus.el now allows link creation from messages

Capturing to narrowed buffers

Better handling of the new `org-agenda-span' variable

Security warning: using org-crypt with auto-save

Babel

• :file argument causes results to be written to file for all languages
  

  :file <filename> should be understood as saying "write the result to <filename> and return a link to <filename>".

  This works for all languages. For graphics languages (e.g. ditaa, dot, gnuplot) there is no change in behavior: "result" in the above is the graphics, and a link to the image is placed in the org buffer. For general-purpose languages (e.g. emacs-lisp, python, R, ruby, shell), the "result" written to file is the normal org-babel result (string, number, table).

  In order to return a file link from a src block without telling babel to save any results to that file, use :results <filename> and do not use :file. The code block can of course write arbitrary content to <filename>.

  Some examples:

  Save the output of ls -l as a .csv file (recall that :results value is the default):

  ls -l
  

  Send the text output of ls -l directly to file:

  ls -l
  

• R requires :results graphics :file filename when generating graphics
  

  ":results graphics" is now required in addition to ":file filename" in order for graphical output to be sent automatically to file. If :file is supplied, but not ":results graphics", then non-graphical, "value" or "output" results are written to file, depending on which of those options is in effect.

• Calc code blocks can now accept vectors
  

  For example;

  3 y
  

  [3, 6, 9]
  

  Thanks to Eric S. Fraga for raising this issue

• Code blocks with empty bodies are now acceptable
  

  Previously these caused errors on export. Thanks to Martyn Jago for this patch.

• Emacs Lisp variable assignments which don't eval cleanly passed literally
  

  This makes it possible to easily pass through non-elisp variable assignments which may initially look like valid elisp.

• Unified naming of c++ functions to C++
  

  Thanks to Martyn Jago for this patch.

• `org-babel-execute-buffer' and `org-babel-execute-subtree' now eval inline code blocks as well
  
• New :mkdirp header argument creates parent dirs of tangle targets
  
• New ":comments noweb" option for wrapping noweb references in comment links
  

  This can be useful to allow backward linking from tangle code files to the original code block holding noweb-expanded content.

• Allow detangling of text containing '\'s – Thanks to Seth Burleigh
  
• :sep specifies table separator when opening or writing tabular results
  
• `org-edit-src-content-indentation' can now be a buffer-local variable
  

All export configuration variables can now be buffer-local variables

org-complete.el has been renamed to org-pcomplete.el

New user options for LaTeX source code export via minted and listings packages

Effort durations now support 2d, 2m, etc.

New option :clock-keep for capture templates

Misc

• New command `org-agenda-bulk-mark-regexp'
  

  M-x org-agenda-bulk-mark-regexp RET will mark agenda entries which headings match against a regular expression. You can call this command with the `%' key from an agenda buffer.

• New command `org-agenda-reset-view'
  

  Julien Danjou implemented this:

  This new command lets you switch to day/week/month/year view.
  
  When switching to day or week view, this setting becomes the default for
  subsequent agenda refreshes.  Since month and year views are slow to
  create, they do not become the default.  A numeric prefix argument may be
  used to jump directly to a specific day of the year, ISO week, month, or
  year, respectively.  For example, `32 d' jumps to February 1st, `9 w' to
  ISO week number 9.  When setting day, week, or month view, a year may be
  encoded in the prefix argument as well.  For example, `200712 w' will jump
  to week 12 in 2007.  If such a year specification has only one or two
  digits, it will be mapped to the interval 1938-2037. `v SPC'' will reset to
  what is set in `org-agenda-span'.
  

  Thanks a lot to Julien for this.

• New options for ignoring past or future items in the global todo list
  

  This patch gives users greater control over which past or future items they would like to ignore in the global todo list. By setting org-agenda-todo-ignore-scheduled to 7, for instance, a user can ignore all items scheduled 7 or more days in the future. Similarly, by setting org-agenda-todo-ignore-scheduled to -1, a user can ignore all items that are truly in the past (unlike the 'past setting, which ignores items scheduled today).

  See the docstrings of these variables:

  • org-agenda-todo-ignore-deadlines
  • org-agenda-todo-ignore-scheduled
  • org-agenda-todo-ignore-timestamp

  Thanks a lot to Matt Lundin for implementing this and to Paul Sexton for the idea.

• New variable `org-export-table-remove-empty-lines'
  

  When set to `nil', don't remove empty tables when exporting tables. This was requested by Eric S Fraga.

• New variable `org-table-fix-formulas-confirm'
  

  Sometime, editing the structure of a table should not edit the corresponding formulas. This new variable lets the user decide whether he wants to confirm formula fixes or not.

• New variable `org-export-initial-scope'
  

  This variable controls the initial scope when exporting with `org-export'. It can be set to 'buffer or 'subtree. If there is an active region, tell it when prompting the user for an export command.

• Show and use the default refile location
  

  M-x org-refile RET now shows the default refile location. Thanks to Tassilo Horn for a patch to this effect.

• New variable `org-archive-subtree-add-inherited-tags'
  

  Non-nil means append inherited tags when archiving a subtree.

• New variable `org-export-current-backend'
  

  This variable is dynamically set by exporters. You can check against its value anytime in your code to see if you are exporting to HTML, LaTeX, etc. Possible values are 'html, 'latex, 'ascii, 'docbook. Thanks to Eric Schulte and Dan Davison for ideas and patches in this area.

• New hook `org-clock-before-select-task-hook'
  

  Hook called in task selection just before prompting the user.

  Thanks to Benjamin Drieu for the patch.

• = = emphasis now uses \protectedtexttt
  
• Author's email now included in the LaTeX title
  

  When `org-export-email-info' is non-nil, the LaTeX title will also include the author's email. Thanks to Lawrence Mitchell for the patch.

• Update contrib/scripts/ditaa.jar to ditaa v0.9 of 2009-11-24
  
• New variable `org-mobile-files-exclude-regexp'
  

  This variable lets you exclude files that you don't want in org-mobile-files.

• New variable `org-confirm-elisp-link-not-regexp'
  

  Set this to a regexp if you want to skip the confirmation step for Elisp/Shell code matching this regexp.

• New variable `org-attach-store-link-p'
  

  When set to `t', store link to the attached file, at its original location.

• `org-table-use-standard-references' now defaults to 'from
  
• Better `org-agenda-repeating-timestamp-show-all'
  

  When this is set to a list of TODO keywords, the agenda will only show occurrences of repeating stamps for these TODO keywords.

• New command `org-narrow-to-block'
  

  This command (`C-x n b') will narrow the buffer to the current block.