From mboxrd@z Thu Jan 1 00:00:00 1970 From: "Carsten Dominik" Subject: Org-mode 5.14 Date: Tue, 27 Nov 2007 14:42:11 +0100 Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Return-path: Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1Ix0he-0006cB-7y for emacs-orgmode@gnu.org; Tue, 27 Nov 2007 08:42:18 -0500 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1Ix0hd-0006bq-4h for emacs-orgmode@gnu.org; Tue, 27 Nov 2007 08:42:17 -0500 Received: from [199.232.76.173] (helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1Ix0hc-0006bm-RK for emacs-orgmode@gnu.org; Tue, 27 Nov 2007 08:42:16 -0500 Received: from py-out-1112.google.com ([64.233.166.183]) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1Ix0hc-0005Qm-Cm for emacs-orgmode@gnu.org; Tue, 27 Nov 2007 08:42:16 -0500 Received: by py-out-1112.google.com with SMTP id a73so2461576pye for ; Tue, 27 Nov 2007 05:42:13 -0800 (PST) Content-Disposition: inline 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: emacs-orgmode@gnu.org Hi, it has been a while, but finally its done. I am releasing Org-mode 5.14 at http://orgmode.org Thanks to Bastien who has contributed a lot to this release. Again there is a long list of changes, make sure you read it all the way to the end, or you might miss the fix *you* have requested. Enjoy! - Carsten Changes in Version 5.14 ~~~~~~~~~~~~~~~~~~~~~~~ Overview ======== + Remember and related stuff - New command `org-refile' to quickly move a note. - Easy way to jump to the target location of remember template. - New %-escapes in remember templates: %c %(...) and %[...] - `org-remember-insinuate' simplifies remember setup + Emphasis and Font-lock stuff - Stacked emphasis is no longer allowed. - You may finally emphasize a single character like `*a*'. - Font-lock now can hide the emphasis markers - Text in the "=" emphasis is exported verbatim - There is a new emphasis marker "~" for verbatim text - Constructs treated specially by the exporters can be highlighted + Properties and Column view - More control over which properties use inheritance - CATEGORY="work" can now be used in a tags/property search - the {+} summary type can specify a printf-style output format - New currency summary type {$} + The date/time prompt - While entering data, watch live the current interpretation. - The date prompt now prefers to select the future - Easier modification of time in an existing time stamp. + Export - You can now export some special strings in HTML, like "..." - #+EMAIL: may contain several email addresses + Agenda - In the agenda, a few keys have changed: `g', `G', and `e'. + Miscellaneous - Class-dependent sectioning structures in LaTeX export. - Radio-lists modeled after the radio tables. - The default for `org-ellipsis' is back to nil - Support for pabbrev-mode - New variable `org-show-entry-below'. Incompatible changes ==================== - If you have customized the variable `org-emphasis-alist' or org-export-emphasis-alist', you need to do it again by first canceling your customization and then adding it again. - I know that some people have defined their own private helper functions to select a specific remember template, without being prompted, like this: (defun my-remember-template-n () (interactive) (org-remember ?n)) You need to modify this. The character selecting the template must now be the /second/ argument to `org-remember': (defun my-remember-template-n () (interactive) (org-remember nil ?n)) - `C-c C-w' now refiles an entry. To get a sparse tree of deadlines, use `C-c / d' instead. Details ======= Remember and related stuff -------------------------- - New command `org-refile' to quickly move a note to a different place. It is bound to `C-c C-w'. The foremost application might be to put a note or task captured with `remember' into the proper list or project. The command offers a list of possible refiling targets for completion. These are headings under which the entry will be inserted as a subitem. By default, this will offer all top-level headings in the current buffer, but you can configure the variable `org-refile-targets' to get more complex definitions. For example: (setq org-refile-targets '((nil . (:level . 2)))) selects all level 2 headlines in the current buffer as targets. And (setq org-refile-targets '((org-agenda-files . (:tag . "refile")))) searches all agenda files and selects headlines that are explicitly marked with the tag :refile: . Note that the list of targets is built upon first use only, to rebuilt it, call the command `C-c C-w' with a double prefix argument. This is based on an idea and example implementation by Max Mikhanosha. Many thanks Max. - You can now use a C-u prefix on `org-remember' to jump to the location where a specific templates stores its notes. For example, if you have `org-remember' bound to `C-c r', then `C-u C-c r n' will get you to the file and headline given in the template associated with the letter "n". This was proposed by someone, but I have lost track who. Sorry, and thanks anyway. - New %-escapes in remember templates: %c insert the current clipboard, like C-y would do %(..) evaluate Lisp expression and insert the result %[..] include file Thanks to Adam Spiers and Tim O'Callaghan. - New function `org-remember-insinuate' that makes is easier to set Org-mode specific values for remember variables. Thanks to Michael Olson for this proposal. It is equivalent to: (require 'remember) (setq remember-annotation-functions '(org-remember-annotation)) (setq remember-handler-functions '(org-remember-handler)) (add-hook 'remember-mode-hook 'org-remember-apply-template)) You might still want to set `org-default-notes-file' to provide a default for templates without a file, and `org-directory' to show where to find other org files. Emphasis and Font-lock stuff ---------------------------- - Stacked emphasis like `*/bold italic/*' is no longer allowed. - You may finally emphasize a single character like `*a*'. - Font-lock now can hide the emphasis markers, just like Muse does. Configure the variable `org-hide-emphasis-markers' if you want this. Showing the characters continues to be the default in Org-mode. - Text in the "=" emphasis is now exported verbatim, i.e. no further parsing and interpretation of this text takes place. So you can write `=quoted *xxx* a_x = b='. This and the following point implement a request by Daniel Clemente. - There is a new emphasis marker "~" which marks text to be exported verbatim, without special formatting. Inside an org-mode file, this text is highlighted with the org-verbatim face. I am not happy with the face yet (currently is is like org-code, but underlined), please suggest a better one. - Whether an emphasis environment is verbatim or not is now an extra flag in the variable `org-emphasis-alist'. If you have configured this variable, do it again by first canceling your customization to revert to the default, and then adding it again. - New variable `org-highlight-latex-fragments-and-specials'. When turned on, Org-mode will highlight all strings that are treated in a special way by the exporters. This is great for export-oriented writing, but maybe a bit noisy for note taking, so this feature is off by default. Properties and Column view -------------------------- - `org-use-property-inheritance' may now also be a list of property names that should be treated with inheritance during searches. - CATEGORY="work" can now be used in a tags/property search, even if the category is not specified as a property in the entry, but rather is inherited or derived from #+CATEGORY. Thanks to Adam, Tim, and Bastien for an interesting discussion around this issue. - Summary type improvements in column view. * The {+} summary type can specify a printf-style output format for computed values like this: {+;%5.2f} This was triggered by a report by Levin. * New currency summary type {$}, which so far is just a shorthand for {+;%.2f}. Do we need to have a currency symbol in front of each value. Scott Jaderholm asked for this, but I am not sure if this is already what he meant. The date/time prompt -------------------- There have been several small but *very* useful additions to the date prompt. - While entering data at the date prompt, the current interpretation of your input is shown next to your input in the minibuffer. I find this great to understand how the input works. If you find the extra stuff in the minibuffer annoying, turn it off with `org-read-date-display-live'. - The date prompt now prefers to select the future. If you enter a date without a month, and the day number is before today (for example, on the 16th of the month you enter "9"), Org-mode will assume next month. Similarly, if you enter a month and no year, next year will be assumed if the entered month is before the current, for example if you enter "May" in September. Thanks to John Rakestraw for this great suggestion. If you find it confusing, turn it off with `org-read-date-prefer-future'. - When modifying an existing date using `C-c .' at the stamp, the time or time range in the stamp are now offered as default input at the prompt. This goes a long way to simplifying the modification of an existing date. Thanks to Adam Spiers for this proposal. Export (all implemented by Bastien...) -------------------------------------- - You can now export special strings in HTML. Here is the list of newly performed conversions: Org Description HTML -----+------------------------------------+---------- `\\-' double backslash followed by minus ­ `--' two dashes (minuses) – `---' three dashes (minuses) — `...' three dots … You can turn this globally on or off with `org-export-with-special-strings' or locally with "-:t" or "-:nil" in the #+OPTIONS line. Thanks to Adam Spiers for starting the discussion, and thanks to Daniel Clemente and William Henney for relevant inputs. - Comma-separated emails in #+EMAIL: are correctly exported. Thanks to Raman for pointing out this omission. Agenda ------ - In the agenda, a few keys have changed g does now the same a "r", refresh current display, because "g" is the Emacs standard for "refresh" G toggle the time grid, used to be "g" e Execute another agenda command, pretty much the same as `C-c a', but shorter and keep the same agenda window. Miscellaneous (much of it from Bastien) --------------------------------------- - You can now select the sectioning structure of your LaTeX export by setting it either globally (`org-export-latex-default-class') or locally in each Org file (with #+LaTeX_CLASS: myclass). You can also customize the list of available classes and their sectioning structures through the new `org-export-latex-classes' option. Thanks to Daniel for discussions and suggestion on this issue. - You can send and receive radio lists in HTML, LaTeX or TeXInfo, just as you send and receive radio tables. Check the documentation for details and examples. - The default for `org-ellipsis' is back to nil, some people seem to have had problems with the face as a default. - Support for pabbrev-mode, needs pabbrev version 1.1. Thanks to Phillip Lord for adapting his package to make this possible. - New variable `org-show-entry-below' to force context-showing commands to expose the body of a headline that is being shown. Thanks to Harald Weis for pointing out this omission.