Org-mode release 6.05

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.

Re: Org-mode release 6.05

[Paul R]

Carsten Dominik <carsten.dominik@gmail.com> writes:

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

good job, as usual. Thank you Carsten.

-- 
      Paul

Re: Org-mode release 6.05

[Cezar Halmagean]

Paul R <paul.r.ml@gmail.com> writes:

> Carsten Dominik <carsten.dominik@gmail.com> writes:
>
>> Hi,
>>
>> Org-mode release 6.05 is available at http://orgmode.org
>>
>
> good job, as usual. Thank you Carsten.

Love the new features ! org-mode rocks.

Cezar