[Orgmode] Org-mode release 6.05

[Carsten Dominik]

Hi,

Org-mode release 6.05 is available at http://orgmode.org

If I were to name my releases, this one would be called "Adam".
Adam, you definitely owe me a beer :-).  And I owe you one, too -
thanks for all the great ideas.


Enjoy!

- Carsten


Changes in Version 6.05
=======================

Overview
========

   - Use cursor position in agenda for remember, scheduling and  
deadlines
   - New API for mapping a function over all or selected entries
   - Remember templates can be filed to beginning/end of a file
   - Visiting a filed remember buffer immediately
   - BBDB anniversaries are now links
   - Column view in the agenda now cleans the ITEM field
   - The format of section numbers in exported files is configurable
   - Direct, single key access to allowed values in column view
   - New hook to hack exported iCalendar files
   - Log mode in agenda now shows end time for CLOCK line

Incompatible changes
====================

`C-c C-x C-k' now calls `org-mark-entry-for-agenda-action'
----------------------------------------------------------
    It used to call `org-cut-special', but that is also at bound
    to the key `C-c C-x C-w'.

Details
=======

Making use of the cursor position in the agenda
-----------------------------------------------

    The date at the cursor in the agenda (and also in the
    calendar) can now be used to schedule entries, or to set the
    date in a remember template correctly.  It is also designed
    to make it easier to move an entry to a date picked in the
    agenda.  Thanks to Thomas Baumann for starting the thread
    that led to this development.

* Calling remember with the cursor date in the agenda

  If you want to use the date at the agenda cursor in a
  remember template, start remember from the agenda with the
  keys `k r'.  While the template is being filled in, the
  default date for all time stamps, and also for all
  interactive escapes like `%^t' is now the date at the cursor
  in the agenda.  The exact same command can also be used from
  the calendar if you prefer that.

* Picking a date for scheduling/deadline in the agenda

  You may now pick the date for scheduling an item or for
  setting a deadline in the agenda, where you have the best
  overview over free time slots.  This is a two step process.

  1. First you pick the entry that should be acted upon.  In
     the agenda, you use the keys `k m'.  In an org-mode file,
     this is on `C-c C-x C-k'.

  2. Then you find the agenda date you want to apply.  When the
     cursor is anywhere in the block belonging to that date,
     press `k s' to schedule, or `k d' to put a deadline.  The
     agenda is not updated immediately, press `r' if you want
     it to show the affected entry in the right place.


New API for mapping a function over all or selected entries
-----------------------------------------------------------

    Org has sophisticated mapping capabilities to find all
    entries satisfying certain criteria.  Internally, this
    functionality is used to produce agenda views, but there is
    also an API that can be used to execute arbitrary functions
    for each or selected entries.  The main entry point for this
    API is:

  -- Function: org-map-entries func &optional match scope &rest skip
       Call FUNC at each headline selected by MATCH in SCOPE.

       FUNC is a function or a lisp form.  The function will be
       called without arguments, with the cursor positioned at
       the beginning of the headline.  The return values of all
       calls to the function will be collected and returned as
       a list.

       MATCH is a tags/property/todo match as it is used in the
       agenda tags view.  Only headlines that are matched by
       this query will be considered during the iteration.
       When MATCH is nil or t, all headlines will be visited by
       the iteration.

       SCOPE determines the scope of this command, it can
       specify a file, all agenda files, the current tree and
       much more.

       The remaining args are treated as settings for the
       skipping facilities of the scanner.

The function given to that mapping routine can really do anything
you like.  Here is a simple example that will turn all entries in
the current file with a tag `TOMORROW' into TODO entries with the
keyword `UPCOMING'.  Entries in comment trees and in archive
trees will be ignored.

  (org-map-entries
     '(org-todo "UPCOMING")
     "+TOMORROW" 'file 'archive 'comment)


   The following example counts the number of entries with TODO
keyword `WAITING', in all agenda files.

  (length (org-map-entries t "/+WAITING" nil 'agenda))


Changes in Remember templates
-----------------------------

* Remember templates can now use the cursor date in the agenda
  Use `k r' to start remember from the agenda, with enforcing
  the cursor date as default for any time stamps created by
  the template.

* Filing remember templates to the beginning or end of a file
  You may now set the heading part of a remember template
  definition to `top' or `bottom'.  The template will then be
  filed as a level 1 entry to the beginning or end of the
  target file, respectively.  Thanks to Adam Spiers for this
  proposal.

* You can jump to the location of a note immediately after filing it
  Just include the `%&' escape anywhere in the template.  An
  interesting combination now is to use `%!%&', which will
  immediately file and visit the note, which is equivalent to
  generating the note directly in the target location.  Thanks
  to Adam Spiers for this proposal.


BBDB anniversaries are now links.
---------------------------------
    If you are using `%%(bbdb-anniversaries)' to list
    anniversaries in the agenda, you can now directly access the
    entry that triggered a listed anniversary from the agenda.
    Just click the anniversary - it is a link now.  Thanks to
    Thomas Baumann for a patch to this effect.

Column view in the agenda now cleans the ITEM field
---------------------------------------------------
    See the new variable
    `org-agenda-columns-remove-prefix-from-item'.  Thanks to Adam
    Spiers for this proposal.

The format of section number in exported files is configurable
--------------------------------------------------------------

    See the new variable `org-export-section-number-format'.
    Thanks to Adam Spiers for this proposal.

Direct access to allowed values in column view
----------------------------------------------

    In column view, if you press a key 1-9 or 0, the
    corresponding values from the list of allowed values for that
    field at point will be directly selected.  Thanks to Levin Du
    for this proposal and a patch to this effect.

New hook to hack exported iCalendar files
-----------------------------------------
    The new hook `org-before-save-iCalendar-file-hook' runs just
    before the buffer with a created iCalendar export is saved.
    This is what I settled for after a long discussion with Adam
    Spiers about doing some special filtering automatically.

Log mode in agenda now shows start end time for CLOCK lines
-----------------------------------------------------------
    When turning on log mode in the agenda with `l', clock lines
    will now also list the end time, not only the starting time.
    Thanks to Tian Qiu for bringing this up again.