From mboxrd@z Thu Jan 1 00:00:00 1970 From: Carsten Dominik Subject: Org-mode release 6.05 Date: Mon, 16 Jun 2008 18:46:02 +0200 Message-ID: Mime-Version: 1.0 (Apple Message framework v924) Content-Type: text/plain; charset=US-ASCII; format=flowed; delsp=yes Content-Transfer-Encoding: 7bit Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1K8HqP-00063u-MS for emacs-orgmode@gnu.org; Mon, 16 Jun 2008 12:46:13 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1K8HqN-00063i-4N for emacs-orgmode@gnu.org; Mon, 16 Jun 2008 12:46:12 -0400 Received: from [199.232.76.173] (port=41082 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1K8HqM-00063f-VP for emacs-orgmode@gnu.org; Mon, 16 Jun 2008 12:46:10 -0400 Received: from ug-out-1314.google.com ([66.249.92.170]:36900) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1K8HqM-0007xC-H4 for emacs-orgmode@gnu.org; Mon, 16 Jun 2008 12:46:10 -0400 Received: by ug-out-1314.google.com with SMTP id l31so423779ugc.48 for ; Mon, 16 Jun 2008 09:46:06 -0700 (PDT) List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: org-mode mailing list 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.