[Orgmode] Release 6.35

[Carsten Dominik]

Dear all, I am finally releasing version 6.35 of Org-mode.
Please read them carefully.

Thanks to all who have contributed.

Enjoy!

- Carsten


                             Version 6.35
                             ============

Author: Carsten Dominik
Date: 2010-04-06 09:18:58 CEST


Incompatible Changes
~~~~~~~~~~~~~~~~~~~~~

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

So far this variable has been used to specify the complete header
of the LaTeX document, including all the =\usepackage= calls
necessary for the document.  This setup makes it difficult to
maintain the list of packages that Org itself would like to call,
for example for the special symbol support it needs.  Each time I
have to add a package, I have to ask people to revise the
configuration of this variable.  In this release, I have tried to
fix this.

First of all, you can *opt out of this change* in the following
way: You can say: /I want to have full control over headers, and
I will take responsibility to include the packages Org needs/.
If that is what you want, add this to your configuration and skip
the rest of this section (except maybe for the description of the
=[EXTRA]= place holder):


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

/Continue to read here if you want to go along with the modified
setup./

There are now two variables that should be used to list the LaTeX
packages that need to be included in all classes.  The header
definition in =org-export-latex-classes= should then not contain
the corresponding =\usepackage= calls (see below).

The two new variables are:

1. =org-export-latex-default-packages-alist= :: This is the
     variable where Org-mode itself puts the packages it needs.
     Normally you should not change this variable.  The only
     reason to change it anyway is when one of these packages
     causes a conflict with another package you want to use.
     Then you can remove that packages and hope that you are not
     using Org-mode functionality that needs it.

2. =org-export-latex-packages-alist= :: This is the variable
     where you can put the packages that you'd like to use across
     all classes.  For example, I am putting =amsmath= and =tikz=
     here, because I always want to have them.

The sequence how these customizations will show up in the LaTeX
document are:
1. Header from =org-export-latex-classes=
2. =org-export-latex-default-packages-alist=
3. =org-export-latex-packages-alist=
4. Buffer-specific things set with =#+LaTeX_HEADER:=

If you want more control about which segment is placed where, or
if you want, for a specific class, have full control over the
header and exclude some of the automatic building blocks, you can
put the following macro-like place holders into the header:


  [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

If you have currently customized =org-export-latex-classes=, you
should revise that customization and remove any package calls that
are covered by =org-export-latex-default-packages-alist=.  This
applies to the following packages:

- inputenc
- fontenc
- graphicx
- longtable
- float
- wrapfig
- soul
- t1enc
- textcomp
- marvosym
- wasysym
- latexsym
- amssymb
- hyperref

If one of these packages creates a conflict with another package
you are using, you can remove it from
=org-export-latex-default-packages-alist=.  But then you risk
that some of the advertised export features of Org will not work
properly.

You can also consider moving packages that you use in all classes
to =org-export-latex-packages-alist=.  If necessary, put the
place holders so that the packages get loaded in the right
sequence.  As said above, for backward compatibility, if you omit
the place holders, all the variables will dump their content at
the end of the header.

Damn, this has become more complex than I wanted it to be.  I
hope that in practice, this will not be complicated at all.

The constant =org-html-entities= is obsolete
=============================================

Its content is now part of the new constant =org-entities=, which
is defined in the file org-entities.el.  =org-html-entities= was
an internal variable, but it is possible that some users did
write code using it - this is why I am mentioning it here.

Editing Convenience and Appearance
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

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.

Export
~~~~~~~

Much better handling of entities for LaTeX export
==================================================

Special entities like =\therefore= and =\alpha= now know if
they need to be in LaTeX math mode and are formatted accordingly.

Thanks to Ulf Stegemann for the tedious work to make this
possible.


LaTeX export: Set coding system automatically
==============================================

The coding system of the LaTeX class will now be set to the value
corresponding to the buffer's file coding system.  This happens
if your setup sets up the file to have a line
=\usepackage[AUTO]{inputenc}= (the default setup does this).

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.

Full label/reference support in HTML, Docbook, and LaTeX backends
==================================================================

=#+LABEL= definitions for tables and figures are now fully
implemented in the LaTeX, Docbook, and HTML interfaces.
=\ref{xxx}= is expanded to a valid link in all backends.

BEAMER export: Title of the outline frame is now customizable
==============================================================

The new option =org-outline-frame-title= allows to set the
title for outline frames in Beamer presentations.

Patch by Lukasz Stelmach.


BEAMER export: fragile frames are better recognized
====================================================

A =lstlisting= environment now also triggers the fragile option in
a beamer frame, just like =verbatim= environments do.

Thanks to Eric Schulte for this patch.

BEAMER export: Protect <...> macro arguments
=============================================

Macros for the BEAMER package can have arguments in angular
brackets.  These are now protected just like normal arguments.

Requested by Bill Jackson.

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.

New option =org-export-email-info= to turn off export of the email  
address
= 
= 
= 
========================================================================

Default is actually off now.

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

Index generation
~~~~~~~~~~~~~~~~~

Org-mode can now produce a 2-level subject index spanning an
entire publishing project.  Write index entries in your files as


  * What is org-mode?
  #+index: Org-mode
  #+index: Definitions!Org-mode

where the first line will produce an index entry /Org-mode/,
while the second line will create /Definitions/ with a sub-item
/Org-mode/.  Three-level entries are not supported.

To produce the index, set


  :makeindex t

in the project definition in =org-publish-project-alist=.  You
may have to force re-export of all files to get the index by
using a =C-u= prefix to the publishing command:


  C-u M-x org-publish-all

Whenever an Org file is published in this project, a new file
with the extension "orgx" will be written.  It contains the index
entries and corresponding jump target names.  When all project
files are published, Org will produce a new file "theindex.inc"
containing the index as a to-level tree.  This file can be
included into any project file using


  CANNOT INCLUDE FILE theindex.inc

Org-mode will also create a file "theindex.org" with this include
statement, and you can build a more complex structure (for
example style definitions, top and home links, etc) around this
statement.  When this file already exists, it will not be
overwritten by Org.

Thanks to Stefan Vollmar for initiating and driving this feature.

TODO Still need to do the LaTeX portion
========================================

MobileOrg
~~~~~~~~~~

Encrypting stage files for MobileOrg
=====================================

Since the use of (often pubic) servers is needed for MobileOrg,
it is now possible to encrypt the files to be staged for
MobileOrg.  Version 1.2 of MobileOrg will be needed for this
feature, and Richard Moreland will show instructions on his
website once that is available.  Basically, on the Org-side this
will require the following settings:


  (setq org-mobile-use-encryption t
        org-mobile-encryption-password "My_MobileOrg_Password")

So the password will be visible in your local setup, but since
the encryption is only for the public server, this seems
acceptable.

Agenda
~~~~~~~

Specify entry types as an option
=================================

Custom Agenda commands can now limit the sets of entry types
considered for this command by binding =org-agenda-entry-types=
temporarily in the options section of the command.  This can lead
to significant speedups, because instead of laboriously finding
entries and then rejecting them, a whole search cycle is skipped.
For more information see the new section in
[Matt Lundin's agenda custom command tutorial].

Thanks to Matt Lundin for this feature.


[Matt Lundin's agenda custom command tutorial]: 
http://orgmode.org/worg/org-tutorials/org-custom-agenda-commands.php#sec-5

Speed up multiple calls to org-diary by only doing buffer prep once
====================================================================

Also a patch by Matt Lundin.

Show and hide deadlines in the agenda
======================================

You can now hide all deadline entries in the agenda by pressing
=!=.

Thanks to John Wiegley for this feature.

Agenda: Allow to suppress deadline warnings for entries also scheduled
=======================================================================

The the docstring of the variable
=org-agenda-skip-deadline-prewarning-if-scheduled=.

Expand file names in org-agenda-files (external file case)
===========================================================

If you are using a file to manage the list of agenda files, the
names in this file can now contain environment variables and "~"
to write them more compactly and portable.

Thanks to Mikael Fornius for a patch to this effect.

Agenda: Allow TODO conditions in the skip functions
====================================================

The agenda skip function has now special support for skipping
based on the TODO state.  Here are just two examples, see the
manual for more information.


  (org-agenda-skip-entry-if 'todo '(\"TODO\" \"WAITING\"))
  (org-agenda-skip-entry-if 'nottodo 'done)

Thanks to Lukasz Stelmach for this patch.

Extracting the time-of-day when adding diary entries
=====================================================

The time of day can now be extracted from new diary entries made
from the agenda with (for example) =i d=.  When
=org-agenda-insert-diary-extract-time= is set, this is done, and
the time is moved into the time stamp.

Thanks to Stephen Eglen for this feature.

The customization group org-font-lock has been renamed
=======================================================

The new name is `org-appearance'.

Thanks to Dan Davison for a patch to this effect.

The TODO list: Allow skipping scheduled or deadlined entries
=============================================================

Skipping TODO entries in the global TODO list based on whether
they are scheduled or have a deadline can now be controlled in
more detail.  Please see the docstrings of
=org-agenda-todo-ignore-scheduled= and
=org-agenda-todo-ignore-deadline=.

Thanks to Lukasz Stelmach for patches to this effect.

Hyperlinks
~~~~~~~~~~~

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öker for a patch to this effect.

Clocking
~~~~~~~~~

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.

Tables
~~~~~~~

Repair the broken support for table.el tables again.
=====================================================

Tables created with the table.el package now finally work again
in Org-mode.  While you cannot edit the table directly in the
buffer, you can use  =C-c '= to edit it nicely in a temporary
buffer.

Export of these tables to HTML seem to work without problems.
Export to LaTeX is imperfect.  If fails if the table contains
special characters that will be replaced by the exporter before
formatting the table.  The replacement operation changes the
length of some lines, breaking the alignment of the table fields.
Unfortunately this is not easy to fix.  It is also not an option
to not do these replacements.  The table.el LaTeX exporter will
for example not escape "&" in table fields, causing the exported
tables to be broken.

Misc
~~~~~

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.

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

Tables: Field coordinates for formulas, and improved docs
==========================================================

Calc and Emacs-Lisp formulas for tables can access the current
field coordinates with address@hidden and =$#= for row and column,
respectively.  These can be useful in some formulas.  For
example, to sequentially number the fields in a column, use
address@hidden as column equation.

One application is to copy a column from a different table.  See
the manual for details.

Thanks to Michael Brand for this feature.

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.

Requested by Tom.

Better documentation on calc accuracy in tables
================================================

Thanks to Michael Brand for this fix.

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.

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

org-timer.el now allows just one timer
=======================================

There is now only a single free timer supported by org-timer.el.
Thanks to Bastien for cleaning this up, after a bug report in
this area by Frédéric Couchet.

Remember: Allow to file as sibling of current clock
====================================================

=C-3 C-c C-c= will file the remember entry as a sibling of the
last filed entry.

Patch by Lukasz Stelmach.

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.

Add org-secretary.el by Juan Reyero to the contrib directory
=============================================================

org-secretary.el is a possible setup for group work using
Org-mode.

Thanks to Juan Reyero for this contribution.

Babel
~~~~~~

Eric and Dan have compiled the following list of changes in and
around org-babel.

- Added support for Matlab and Octave.
- Added support for C and C++ code blocks.
- Added support for the Oz programming language.
  Thanks to Torsten Anders for this contribution
- Can now force literal interpretation of table cell contents
  with extra "$" in table formula.
  Thanks to Maurizio Vitale for this suggestion.
- Variable references which look like lisp forms are now
  evaluated.
- No longer adding extension during tangling when filename is
  provided.
  Thanks to Martin G. Skjæveland and Nicolas Girard for prompting this.
- Added `org-babel-execute-hook' which runs after code block
  execution.
- Working directories and remote execution

  This introduces a new header argument :dir. For the duration of
  source block execution, default-directory is set to the value
  of this header argument. Consequences include:

  - external interpreter processes run in that directory
  - new session processes run in that directory (but existing
    ones are unaffected)
  - relative paths for file output are relative to that directory

  The name of a directory on a remote machine may be specified
  with tramp syntax (/address@hidden:path), in which case the
  interpreter executable will be sought in tramp-remote-path, and
  if found will execute on the remote machine in the specified
  remote directory.
- Tramp syntax can be used to tangle to remote files.
  Thanks to Maurizio Vitale and Rémi Vanicat.
- org-R removed from contrib.
- gnuplot can now return it's string output -- when session is
  set to "none".
- Now including source code block arguments w/source name on
  export.
- Now able to reference file links as results.
- Allow pdf/png generation directly from latex source blocks
  with :file header argument.