From mboxrd@z Thu Jan 1 00:00:00 1970 From: Bastien Subject: Org-mode release 7.9 Date: Fri, 24 Aug 2012 17:48:42 +0200 Message-ID: <87sjbcb89x.fsf@altern.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([208.118.235.92]:42109) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1T4w7k-0004AY-He for emacs-orgmode@gnu.org; Fri, 24 Aug 2012 11:48:44 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1T4w7g-0007S1-9a for emacs-orgmode@gnu.org; Fri, 24 Aug 2012 11:48:40 -0400 Received: from plane.gmane.org ([80.91.229.3]:39029) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1T4w7f-0007Rl-Nl for emacs-orgmode@gnu.org; Fri, 24 Aug 2012 11:48:36 -0400 Received: from list by plane.gmane.org with local (Exim 4.69) (envelope-from ) id 1T4w7f-0002FM-90 for emacs-orgmode@gnu.org; Fri, 24 Aug 2012 17:48:35 +0200 Received: from mar75-2-81-56-68-112.fbx.proxad.net ([81.56.68.112]) by main.gmane.org with esmtp (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 24 Aug 2012 17:48:35 +0200 Received: from bzg by mar75-2-81-56-68-112.fbx.proxad.net with local (Gmexim 0.1 (Debian)) id 1AlnuQ-0007hv-00 for ; Fri, 24 Aug 2012 17:48:35 +0200 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: emacs-orgmode@gnu.org Hi all, I've released Org 7.9. http://orgmode.org/org-7.9.zip http://orgmode.org/org-7.9.gz http://orgmode.org/org-mode-download.html After 1885 commits since Org 7.8, it was about time. See the list of changes here: http://orgmode.org/Changes.html I cannot thank all the contributors enough: especially Nicolas, for his great work on org-element.el (among other nice stuff), Achim for the way he patiently rethought the build mechanism (and bared with me when I was being stubborn), Eric for the steady maintainance of Babel, Max for the neat idea of sticky agendas, etc. Here is a list of people to praise for their help: A. Major, Aaron Peromsik, Achim Gratz, Adam Spiers, Aidan Gauland, Albert, Alex Lane, Alexander Willand, Andrew Young, Anthony Lander, Benjamin Motz, Bernt Hansen, Bill Jackson, Bill Wishon, Bjarte Johansen, Brian J. Carlson, Brian Wood, Brian van den Broek, Carsten Dominik, Charles Philip Chan, Charles Sebold, Charles, Charlie Millar, Christoph Lange, Christophe Rhodes, Christopher Schmidt, Daniel Dehennin, Dave Abrahams, David Coate, David Maus, David Niemi, Dov Grobgeld, Du Yanning, Dunib, Elias Assarsson, Eric Abrahamsen, Eric S Fraga, Eric Schulte, Fabrice Pardo, Feiming Chen, François Allisson, François Pinard, Friedrich Delgado, Giles, Glenn Morris, Greg Troxel, Gsqual, Guido Arnold, Gustav Wikström, Henning Redestig, Ian Barton, Ilya Shlyakhter, Ingo Lohmar, Ivan Kanis, Ivars Finvers, Jack Erwin, Jambunathan, James Harkins, Joe Vornehm Jr., John Hendy, John Wiegley, Jonathan Leech-Pepin, Joost Kremers, Jose E. Marchesi, Joseph Thomas, Karl Berg, Ken Williams, Konstantin Ziegler, Laurynas Biveinis, Leo Alekseyev, Leo and Henning, Loris Bennett, Luis Anaya, Marc-Oliver Ihm, Marcel Van der Boom, Martin Beck, Martyn Jago, Mathias Bauer, Matt Lundin, Michael Heerdegen, Mike McLean, Mike McLean, Mikhail Titov, Mikkel Kristiansen, Moritz Ulrich, Myles English, Nick Dokos, Nicolas Goaziou, Noorul Islam K M, Olaf Dietsche, Paul Eggert, Paweł Menich, Peter Danenberg, Peter Münster, Petro Rafael, Rasmus Rempling, Richard Hansen, Richard Stanton, Robert Lupton the Good, Ryan Kaskel, SW, Samuel Wales, Sean O'Halpin, Simon Thum, Stefan Vollmar, Steinar Bang, Steve Revilak, Stuart McLean, Sylvain Rousseau, Sébastien Vauban, T.F. Torrey, Takaaki Ishikawa, Takafumi Arakaki, Tassilo Horn, Thierry Stoehr, Thomas S. Dye, Thomas Wallrafen, Tobias Naehring, Toby Cubitt, Tomas Grigera, Torsten Wagner, Uwe Brauer, Vagn Johansen, Viktor Rosenfeld, Vladimir Lomov, Waldemar Reusch, Yagnesh Raghava Yakkala, Zachary Jones And here are the detailed release notes: Release notes of Org 7.9 ======================== New committers who signed the FSF copyright assigment ===================================================== Welcome and thanks to these new core contributors: - Andrew Hyatt - Andrzej Lichnerowicz - Ethan Ligon - Feng Shu - George Kettleborough - Henning Dietmar Weiss - Ilya Shlyakhter - Ivan Kanis - Konrad Hinsen - Madan Ramakrishnan - Max Mikhanosha - Moritz Ulrich - Rick Frankel - Toby Cubitt Online documentation for hooks, commands and options ==================================================== You can read the documentation for hooks, commands (i.e. interactive functions) and options (i.e. customizable variables) [online]. Clicking on a command/option in this ChangeLog will take you to the online documentation for that command/option. [online]: http://orgmode.org/worg/doc.html Overview of the new keybindings =============================== │ Keybinding │ Speedy │ Command │ ├─────────────────┼────────┼─────────────────────────────┤ │ =C─c C─x C─z= │ │ org─clock─resolve │ │ =C─c C─x C─q= │ │ org─clock─cancel │ │ =C─c C─x C─x= │ │ org─clock─in─last │ │ =M─h= │ │ org─mark─element │ │ =*= │ │ org─agenda─bulk─mark─all │ │ =C─c C─M─l= │ │ org─insert─all─links │ │ =C─c C─x C─M─v= │ │ org─redisplay─inline─images │ │ =C─c C─x E= │ =E= │ org─inc─effort │ │ │ =#= │ org─toggle─comment │ │ │ =:= │ org─columns │ │ │ =W= │ Set =APPT_WARNTIME= │ New build system and new packages ================================= New build system ---------------- Achim implemented a new build system. The basic method for installing Org is the same: 1. Download or clone Org. 2. run `make install' from the Org directory. 3. Add (require 'org-install) in your .emacs.el. But the build system is now more flexible and can be more easily adapted to suit your needs. See [http://orgmode.org/worg/dev/org-build-system.html] for details. New packages in core -------------------- =org-eshell.el= by Konrad Hinsen is now in Org's core ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =org-eshell.el= allows you to create links from [Eshell]. [Eshell]: http://www.gnu.org/software/emacs/manual/html_node/eshell/index.html New packages in contrib/ ------------------------ Note: The =EXPERIMENTAL/= directory has been deleted. The files have been moved to the =contrib/lisp/= directory. =org-notify.el= by Peter Münster ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ >From the comment section: Get notifications, when there is something to do. Sometimes, you need a reminder a few days before a deadline, e.g. to buy a present for a birthday, and then another notification one hour before to have enough time to choose the right clothes. For other events, e.g. rolling the dustbin to the roadside once per week, you probably need another kind of notification strategy. This package tries to satisfy the various needs. =org-bibtex-extras.el= by Eric Schulte ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ >From the comment section: This file add some extra functionality to your bibtex entries which are stored as Org-mode headlines using org-bibtex.el. Most features expect that you keep all of your reading notes in a single file, set the `obe-bibtex-file' variable to the path to this file. New exporters in contrib/ ------------------------- Nicolas export engine org-export.el lives in the =contrib/lisp/= directory. To use it: Make sure contrib/lisp/ is in your load-path M-: (require 'org-export) RET M-: (require 'org-e-latex) RET ; or any other library M-x org-export-dispatch RET These are the currently available exporters: - =org-e-ascii.el= by Nicolas - =org-e-beamer.el= by Nicolas - =org-e-groff.el= by Luis Anaya - =org-e-html.el= by Jambunathan - =org-e-latex.el= by Nicolas - =org-e-man.el= by Luis Anaya - =org-e-odt.el= by Jambunathan - =org-e-texinfo.el= by Jonathan Leech-Pepin - =org-md.el= by Nicolas If we have enough testers, the new export engine is very likely to replace the current one for the next major release. Please report any problem on the mailing list! If you want to write a new export backend based on this export engine, please check the [online documentation]. [online documentation]: http://orgmode.org/worg/dev/org-export-reference.html New Babel languages ------------------- Support for execution of Scala code blocks (see lisp/ob-scala.el) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Support for execution of IO code blocks (see lisp/ob-io.el) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Incompatible changes ==================== - The =UTILITIES/= directory has been renamed to =utils/=. - If your code relies on =org-write-agenda=, please use [org-agenda-write] from now on. - If your code relies on =org-make-link=, please use =concat= instead. - The default value of [org-table-number-regexp] now allows commas as the mark to separate decimals from integers in numbers. If your code relies on the previous behavior, please customize this variable. See the announcement on the mailing list. [org-agenda-write]: http://orgmode.org/worg/doc.html#org-agenda-write [org-table-number-regexp]: http://orgmode.org/worg/doc.html#org-table-number-regexp New features and user-visible changes ===================================== Org Element ----------- org-element.el is a toolbox for parsing and analysing "elements" in an Org-mode buffer. This has been written by Nicolas Goaziou and has been tested for quite some time. It is now part of Org's core and many core functions rely on this package. Two functions might be particularily handy for users: [org-element-at-point] and [org-element-context]. See the docstrings for more details. Below is a list of editing and navigating commands that now rely on org-element.el. [org-element-at-point]: http://orgmode.org/worg/doc.html#org-element-at-point [org-element-context]: http://orgmode.org/worg/doc.html#org-element-context [org-fill-paragraph] has been completely rewritten ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The filling mechanisms now rely on org-element, trying to do the right thing on each element in various contexts. E.g. filling in a list item will preserve indentation; filling in message-mode will fall back on the relevant filling functions; etc. [org-fill-paragraph]: http://orgmode.org/worg/doc.html#org-fill-paragraph [org-metaup] and [org-metadown] will drag the element backward/forward ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If you want to get the old behavior (i.e. moving a line up and down), you can first select the line as an active region, then =org-metaup/down= to move the region backward/forward. This also works with regions bigger than just one line. [org-metaup]: http://orgmode.org/worg/doc.html#org-metaup [org-metadown]: http://orgmode.org/worg/doc.html#org-metadown [org-up-element] and [org-down-element] (respectively =C-c C-^= and =C-c C-_=) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will move the point up/down in the hierarchy of elements. [org-up-element]: http://orgmode.org/worg/doc.html#org-up-element [org-down-element]: http://orgmode.org/worg/doc.html#org-down-element [org-backward-element] and [org-forward-element] (respectively =M-{= and =M-}=) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will move the point backward/forward in the hierarchy of elements. [org-backward-element]: http://orgmode.org/worg/doc.html#org-backward-element [org-forward-element]: http://orgmode.org/worg/doc.html#org-forward-element [org-narrow-to-element] will narrow to the element at point ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [org-narrow-to-element]: http://orgmode.org/worg/doc.html#org-narrow-to-element [org-mark-element] will mark the element at point ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This command is bound to =M-h= and will mark the element at point. If the point is at a paragraph, it will mark the paragraph. If the point is at a list item, it will mark the list item. Etc. Note that if point is at the beginning of a list, it will mark the whole list. To mark a subtree, you can either use =M-h= on the headline (since there is no ambiguity about the element you're at) or [org-mark-subtree] (=C-c @=) anywhere in the subtree. Invoking [org-mark-element] repeatedly will try to mark the next element on top of the previous one(s). E.g. hitting =M-h= twice on a headline will mark the current subtree and the next one on the same level. [org-mark-element]: http://orgmode.org/worg/doc.html#org-mark-element [org-mark-subtree]: http://orgmode.org/worg/doc.html#org-mark-subtree [org-mark-element]: http://orgmode.org/worg/doc.html#org-mark-element Org Agenda ---------- New option [org-agenda-sticky] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ There is a new option `org-agenda-sticky' which enables "sticky" agendas. Sticky agendas remain opened in the background so that you don't need to regenerate them each time you hit the corresponding keystroke. This is a big time saver. When [org-agenda-sticky] is =non-nil=, the agenda =q= key will bury the agenda buffers. Agenda commands will then show existing buffer instead of generating new ones. When =nil=, =q= will kill the single agenda buffer. [org-agenda-sticky]: http://orgmode.org/worg/doc.html#org-agenda-sticky [org-agenda-sticky]: http://orgmode.org/worg/doc.html#org-agenda-sticky New option [org-agenda-custom-commands-contexts] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Setting this option allows you to define specific context where agenda commands should be available from. For example, when set to this value (setq org-agenda-custom-commands-contexts '(("p" (in-file . "\\.txt")))) then the =p= agenda command will only be available from buffers visiting *.txt files. See the docstring and the manual for more details on how to use this. [org-agenda-custom-commands-contexts]: http://orgmode.org/worg/doc.html#org-agenda-custom-commands-contexts =N= and =P= in the agenda will move to the next/previous item ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ New command [org-agenda-bulk-mark-all] to mark all items ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This new command is bound to =*= in agenda mode. There is also a new option [org-agenda-bulk-mark-char] to set the character to use as a mark for bulk actions. [org-agenda-bulk-mark-all]: http://orgmode.org/worg/doc.html#org-agenda-bulk-mark-all [org-agenda-bulk-mark-char]: http://orgmode.org/worg/doc.html#org-agenda-bulk-mark-char New option [org-agenda-persistent-marks] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When set to =non-nil=, marks will remain visible after a bulk action. You can temporarily toggle this by pressing =p= when invoking [org-agenda-bulk-action]. [org-agenda-persistent-marks]: http://orgmode.org/worg/doc.html#org-agenda-persistent-marks [org-agenda-bulk-action]: http://orgmode.org/worg/doc.html#org-agenda-bulk-action New option [org-agenda-skip-timestamp-if-deadline-is-shown] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =Non-nil= means skip timestamp line if same entry shows because of deadline. In the agenda of today, an entry can show up multiple times because it has both a plain timestamp and has a nearby deadline. When this variable is t, then only the deadline is shown and the fact that the entry has a timestamp for or including today is not shown. When this variable is =nil=, the entry will be shown several times. [org-agenda-skip-timestamp-if-deadline-is-shown]: http://orgmode.org/worg/doc.html#org-agenda-skip-timestamp-if-deadline-is-shown New =todo-unblocked= and =nottodo-unblocked= skip conditions ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ See the [git commit] for more explanations. [git commit]: http://orgmode.org/w/?p%3Dorg-mode.git%3Ba%3Dcommit%3Bh%3Df426da Allow category filtering in the agenda ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can now filter the agenda by category. Pressing "<" will filter by the category of the item on the current line, and pressing "<" again will remove the filter. You can combine tag filters and category filters. You can use [org-agenda-category-filter] in your custom agenda views and [org-agenda-category-filter-preset] in your main configuration. See also the new command [org-agenda-filter-by-top-category]: hitting `^' will filter by "Top" category: only show entries that are of the same category than the Top category of the entry at point. [org-agenda-category-filter]: http://orgmode.org/worg/doc.html#org-agenda-category-filter [org-agenda-category-filter-preset]: http://orgmode.org/worg/doc.html#org-agenda-category-filter-preset [org-agenda-filter-by-top-category]: http://orgmode.org/worg/doc.html#org-agenda-filter-by-top-category Org Links --------- Inserting links ~~~~~~~~~~~~~~~ When inserting links through [org-insert-link], the description is now displayed first, followed by the literal link, as the description is often more useful when you look for the link you want to insert. Completion now complete both literal links and description. If you complete a description, the literal link and its description will be inserted directly, whereas when you complete the literal link, you will be prompted for a description (as with Org 7.8.) In the completion buffer, links to the current buffer are now highlighted. [org-insert-link]: http://orgmode.org/worg/doc.html#org-insert-link New templates =%h= and =%(sexp)= for abbreviated links ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ On top of =%s= template, which is replaced by the link tag in abbreviated links, you can now use =%h= (which does the same than =%s= but does not hexify the tag) and =%(sexp)= (which can run a function that takes the tag as its own argument.) New link type =help= ~~~~~~~~~~~~~~~~~~~~ You can now create links from =help= buffers. For example, if you request help for the command [org-agenda] with =C-h f org-agenda RET=, creating a link from this buffer will let you go back to the same buffer. [org-agenda]: http://orgmode.org/worg/doc.html#org-agenda New command [org-insert-all-links] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will insert all links as list items. With a universal prefix argument, links will not be deleted from [org-stored-links]. This new command is bound to =C-c C-M-l=. [org-insert-all-links]: http://orgmode.org/worg/doc.html#org-insert-all-links [org-stored-links]: http://orgmode.org/worg/doc.html#org-stored-links New option [org-url-hexify-p] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When set to =nil=, the =URL= part of a link will not be hexified. [org-url-hexify-p]: http://orgmode.org/worg/doc.html#org-url-hexify-p Org can now open multiple shell links ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ New option [org-doi-server-url] to specify an alternate DOI server ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [org-doi-server-url]: http://orgmode.org/worg/doc.html#org-doi-server-url RET now follows time stamps links ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Org Editing ----------- [org-todo] and =org-archive-*= can now loop in the active region ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When [org-loop-over-headlines-in-active-region] is =non-nil=, using [org-todo] or =org-archive-*= commands in the active region will loop over headlines. This is handy if you want to set the TODO keyword for several items, or archive them quickly. [org-todo]: http://orgmode.org/worg/doc.html#org-todo [org-loop-over-headlines-in-active-region]: http://orgmode.org/worg/doc.html#org-loop-over-headlines-in-active-region [org-todo]: http://orgmode.org/worg/doc.html#org-todo You can now set tags for headlines in a region ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If [org-loop-over-headlines-in-active-region] is =non-nil=, then selecting the region and hitting =C-c C-q= will set the tags for all headlines in the region. [org-loop-over-headlines-in-active-region]: http://orgmode.org/worg/doc.html#org-loop-over-headlines-in-active-region New command [org-insert-drawer] to insert a drawer interactively ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [org-insert-drawer]: http://orgmode.org/worg/doc.html#org-insert-drawer Comments start with "^[ \t]*# " anywhere on a line ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Note that the space after the hashtag is mandatory. Comments with "^#+" are not supported anymore. New speed key =#= to toggle the COMMENT cookie on a headline ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =indent-region-function= is now set to [org-indent-region] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =C-M-\= should now produce useful results. You can unindent the buffer with [org-unindent-buffer]. [org-indent-region]: http://orgmode.org/worg/doc.html#org-indent-region [org-unindent-buffer]: http://orgmode.org/worg/doc.html#org-unindent-buffer New option [org-allow-promoting-top-level-subtree] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When =non-nil=, =S-M-= will promote level-1 subtrees containing other subtrees. The level-1 headline will be commented out. You can revert to the previous state with =M-x undo RET=. [org-allow-promoting-top-level-subtree]: http://orgmode.org/worg/doc.html#org-allow-promoting-top-level-subtree Org Clock --------- New keybinding =C-c C-x C-z= for [org-clock-resolve] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [org-clock-resolve]: http://orgmode.org/worg/doc.html#org-clock-resolve New keybinding =C-c C-x C-q= for [org-clock-cancel] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [org-clock-cancel]: http://orgmode.org/worg/doc.html#org-clock-cancel New command [org-clock-in-last] to clock in the last clocked item ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This command is bound to =C-c C-x C-x= and will clock in the last clocked entry, if any. [org-clock-in-last]: http://orgmode.org/worg/doc.html#org-clock-in-last =C-u M-x= [org-clock-out] =RET= now prompts for a state to switch to ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [org-clock-out]: http://orgmode.org/worg/doc.html#org-clock-out =S-M-= on a clock timestamps adjusts the previous/next clock ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ New option [org-clock-continuously] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When set to =nil=, clocking in a task will first try to find the last clocked out task and restart from when that task was clocked out. You can temporarily activate continuous clocking with =C-u C-u C-u M-x [org-clock-in] RET= (three universal prefix arguments) and =C-u C-u M-x [org-clock-in-last] RET= (two universal prefix arguments). [org-clock-continuously]: http://orgmode.org/worg/doc.html#org-clock-continuously [org-clock-in]: doc::org-clock-in [org-clock-in-last]: doc::org-clock-in-last New option [org-clock-frame-title-format] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This option sets the value of =frame-title-format= when clocking in. [org-clock-frame-title-format]: http://orgmode.org/worg/doc.html#org-clock-frame-title-format New options for controlling the clockreport display ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [org-clock-file-time-cell-format]: Format string for the file time cells in clockreport. [org-clock-total-time-cell-format]: Format string for the total time cells in clockreport. [org-clock-file-time-cell-format]: http://orgmode.org/worg/doc.html#org-clock-file-time-cell-format [org-clock-total-time-cell-format]: http://orgmode.org/worg/doc.html#org-clock-total-time-cell-format New options for controlling the clock/timer display ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [org-clock-clocked-in-display]: control whether the current clock is displayed in the mode line and/or frame title. [org-timer-display]: control whether the current timer is displayed in the mode line and/or frame title. This allows the clock and timer to be displayed in the frame title instead of, or as well as, the mode line. This is useful for people with limited space in the mode line but with ample space in the frame title. [org-clock-clocked-in-display]: http://orgmode.org/worg/doc.html#org-clock-clocked-in-display [org-timer-display]: http://orgmode.org/worg/doc.html#org-timer-display Org Appearance -------------- New option [org-custom-properties] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The visibility of properties listed in this options can be turn on/off with [org-toggle-custom-properties-visibility]. This might be useful for properties used by third-part tools or that you don't want to see temporarily. [org-custom-properties]: http://orgmode.org/worg/doc.html#org-custom-properties [org-toggle-custom-properties-visibility]: http://orgmode.org/worg/doc.html#org-toggle-custom-properties-visibility New command [org-redisplay-inline-images] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will redisplay all images. It is bound to =C-c C-x C-M-v=. [org-redisplay-inline-images]: http://orgmode.org/worg/doc.html#org-redisplay-inline-images New entities in =org-entities.el= ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ There are these new entities: ("tilde" "\\~{}" nil "˜" "~" "~" "~") ("slash" "/" nil "/" "/" "/" "/") ("plus" "+" nil "+" "+" "+" "+") ("under" "\\_" nil "_" "_" "_" "_") ("equal" "=" nil "=" "=" "=" "=") ("asciicirc" "\\textasciicircum{}" nil "^" "^" "^" "^") New face =org-list-dt= for definition terms ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ New face =org-date-selected= for the selected calendar day ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ New face value for =org-document-title= ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The face is back to a normal height. Org Columns ----------- New speed command =:= to activate the column view ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ New special property =CLOCKSUM_T= to display today's clocked time ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can use =CLOCKSUM_T= the same way you use =CLOCKSUM=. It will display the time spent on tasks for today only. Use the =:COLUMNS:= property in columnview dynamic blocks ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ If the =:COLUMNS:= is set in a subtree, the columnview dynamic block will use its value as the column format. Consider inline tasks when computing a sum ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Org Dates and Time Stamps ------------------------- Enhanced [org-sparse-tree] ~~~~~~~~~~~~~~~~~~~~~~~~~~ =C-c /= can now check for time ranges. When checking for dates with =C-c /= it is useful to change the type of dates that you are interested in. You can now do this interactively with =c= after =C-c /= and/or by setting [org-sparse-tree-default-date-type] to the default value you want. [org-sparse-tree]: http://orgmode.org/worg/doc.html#org-sparse-tree [org-sparse-tree-default-date-type]: http://orgmode.org/worg/doc.html#org-sparse-tree-default-date-type Support for hourly repeat cookies ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can now use SCHEDULED: <2012-08-20 lun. 08:00 +1h> if you want to add an hourly repeater to an entry. =C-u C-u C-c .= inserts a time-stamp with no prompt ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When (setq [org-read-date-prefer-future] 'time), accept days in the prompt ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ "8am Wed" and "Wed 8am" are now acceptable values when entering a date from the prompt. If [org-read-date-prefer-future] is set to =time=, this will produce the expected prompt indication. [org-read-date-prefer-future]: http://orgmode.org/worg/doc.html#org-read-date-prefer-future [org-read-date-prefer-future]: http://orgmode.org/worg/doc.html#org-read-date-prefer-future New option [org-datetree-add-timestamp] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When set to =non-nil=, datetree entries will also have a timestamp. This is useful if you want to see these entries in a sparse tree with =C-c /=. [org-datetree-add-timestamp]: http://orgmode.org/worg/doc.html#org-datetree-add-timestamp Org Capture ----------- New command [org-capture-string] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ M-x [org-capture-string] RET will prompt for a string and a capture template. The string will be used as an annotation for the template. This is useful when capturing in batch mode as it lets you define the content of the template without being in Emacs. [org-capture-string]: http://orgmode.org/worg/doc.html#org-capture-string [org-capture-string]: http://orgmode.org/worg/doc.html#org-capture-string New option [org-capture-templates-contexts] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Setting this option allows you to define specific context where capture templates should be available from. For example, when set to this value (setq org-capture-templates-contexts '(("c" (in-mode . "message-mode")))) then the =c= capture template will only be available from =message-mode= buffers. See the docstring and the manual for more details on how to use this. [org-capture-templates-contexts]: http://orgmode.org/worg/doc.html#org-capture-templates-contexts New =%l= template to insert the literal link ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ New option [org-capture-bookmark] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Org used to automatically add a bookmark with capture a note. You can now turn this on by setting [org-capture-bookmark] to =nil=. [org-capture-bookmark]: http://orgmode.org/worg/doc.html#org-capture-bookmark [org-capture-bookmark]: http://orgmode.org/worg/doc.html#org-capture-bookmark Expand =%= escape sequences into text entered for 'th =%^{PROMPT}= escape ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ See the manual for more explanations. More control over empty lines ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can use =:empty-lines-before= and =:empty-lines-after= to control the insertion of empty lines. Check the manual for more explanations. New hook [org-capture-prepare-finalize-hook] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This new hook runs before the finalization process starts. [org-capture-prepare-finalize-hook]: http://orgmode.org/worg/doc.html#org-capture-prepare-finalize-hook Org Export ---------- New command [orgtbl-to-table.el] and [orgtbl-to-unicode] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [orgtbl-to-table.el] will convert the table to a =table.el= table, and [orgtbl-to-unicode] will use ascii-art-to-unicode.el (when available) to print beautiful tables. [orgtbl-to-table.el]: http://orgmode.org/worg/doc.html#orgtbl-to-table.el [orgtbl-to-unicode]: http://orgmode.org/worg/doc.html#orgtbl-to-unicode [orgtbl-to-table.el]: http://orgmode.org/worg/doc.html#orgtbl-to-table.el [orgtbl-to-unicode]: http://orgmode.org/worg/doc.html#orgtbl-to-unicode [org-table-export] now a bit clever about the target format ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When you specify a file name like =table.csv=, [org-table-export] will now suggest [orgtbl-to-csv] as the default method for exporting the table. [org-table-export]: http://orgmode.org/worg/doc.html#org-table-export [org-table-export]: http://orgmode.org/worg/doc.html#org-table-export [orgtbl-to-csv]: http://orgmode.org/worg/doc.html#orgtbl-to-csv New option [org-export-date-timestamp-format] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ The option allows to set a time string format for Org timestamps in the #+DATE option. [org-export-date-timestamp-format]: http://orgmode.org/worg/doc.html#org-export-date-timestamp-format LaTeX: New options for exporting table rules :tstart, :hline and :tend ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ See [org-export-latex-tables-hline] and [org-export-latex-tables-tend]. [org-export-latex-tables-hline]: http://orgmode.org/worg/doc.html#org-export-latex-tables-hline [org-export-latex-tables-tend]: http://orgmode.org/worg/doc.html#org-export-latex-tables-tend LaTeX: You can now set =:hfmt= from =#+ATTR_LaTeX= ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Beamer: Add support and keybinding for the =exampleblock= environment ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Add support for these languages in [org-export-language-setup]. More languages are always welcome. [org-export-language-setup]: http://orgmode.org/worg/doc.html#org-export-language-setup Beamer: New option [org-beamer-inherited-properties] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This option allows Beamer export to inherit some properties. Thanks to Carsten for implementing this. [org-beamer-inherited-properties]: http://orgmode.org/worg/doc.html#org-beamer-inherited-properties ODT: Add support for ODT export in org-bbdb.el ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ODT: Add support for indented tables (see [this commit] for details) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [this commit]: http://orgmode.org/w/?p%3Dorg-mode.git%3Ba%3Dcommit%3Bh%3De9fd33 ODT: Improve the conversion from ODT to other formats ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ ASCII: Swap the level-1/level-2 characters to underline the headlines ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Support for Chinese, simplified Chinese, Russian, Ukrainian and Japanese ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ HTML: New option [org-export-html-date-format-string] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Format string to format the date and time in HTML export. Thanks to Sébastien Vauban for this patch. [org-export-html-date-format-string]: http://orgmode.org/worg/doc.html#org-export-html-date-format-string Miscellaneous ------------- [org-table-number-regexp] accept comma as a decimal mark to represent numbers ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [org-table-number-regexp]: http://orgmode.org/worg/doc.html#org-table-number-regexp Org allows a new property =APPT_WARNTIME= ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can set it with the =W= speedy key or set it manually. When set, exporting to iCalendar and [org-agenda-to-appt] will use the value of this property as the number of minutes for the warning alarm. [org-agenda-to-appt]: http://orgmode.org/worg/doc.html#org-agenda-to-appt New command [org-inc-effort] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This will increment the effort value. It is bound to =C-c C-x E= and to =E= as a speedy command. [org-inc-effort]: http://orgmode.org/worg/doc.html#org-inc-effort Attach: Add support for creating symbolic links ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ `org-attach-method' now supports a new method =lns=, allowing to attach symbolic links. Archive: you can now archive to a datetree ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ New option [org-inlinetask-show-first-star] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =Non-nil= means display the first star of an inline task as additional marker. When =nil=, the first star is not shown. [org-inlinetask-show-first-star]: http://orgmode.org/worg/doc.html#org-inlinetask-show-first-star New option [org-latex-preview-ltxpng-directory] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ This lets you define the path for the =ltxpng/= directory. [org-latex-preview-ltxpng-directory]: http://orgmode.org/worg/doc.html#org-latex-preview-ltxpng-directory You can now use imagemagick instead of dvipng to preview LaTeX fragments ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ You can now turn off [orgstruct++-mode] safely ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [orgstruct++-mode]: http://orgmode.org/worg/doc.html#orgstruct++-mode =C-u C-c C-c= on list items to add check boxes ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ =C-u C-c C-c= will add an empty check box on a list item. When hit from the top of the list, it will add check boxes for all top level list items. =org-list-ending-method= and =org-list-end-regexp= are now obsolete ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ Fall back on using [org-list-end-re] only, which see. [org-list-end-re]: http://orgmode.org/worg/doc.html#org-list-end-re org-feed.el now expands =%(sexp)= templates ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ New option [org-protocol-data-separator] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [org-protocol-data-separator]: http://orgmode.org/worg/doc.html#org-protocol-data-separator New option [org-ditaa-jar-option] to specify the ditaa jar file ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ [org-ditaa-jar-option]: http://orgmode.org/worg/doc.html#org-ditaa-jar-option New possible value for [org-loop-over-headlines-in-active-region] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When [org-loop-over-headlines-in-active-region] is set to =start-level=, the command will loop over the active region but will only act upon entries that are of the same level than the first headline in the region. [org-loop-over-headlines-in-active-region]: http://orgmode.org/worg/doc.html#org-loop-over-headlines-in-active-region [org-loop-over-headlines-in-active-region]: http://orgmode.org/worg/doc.html#org-loop-over-headlines-in-active-region New option [org-habit-show-all-today] ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ When set to =t=, show all (even unscheduled) habits on today's agenda. [org-habit-show-all-today]: http://orgmode.org/worg/doc.html#org-habit-show-all-today Important bug fixes =================== M-TAB on options keywords perform completion correctly again ------------------------------------------------------------ If you hit =M-TAB= on keywords like =#+TITLE=, Org will try to perform completion with meaningful values. Add licenses to javascript embedded and external code snippets -------------------------------------------------------------- Embedded javascript code produced when exporting an Org file to HTML is now licensed under GPLv3 (or later), and the copyright is owned by the Free Software Foundation, Inc. The javascript code for embedding MathJax in the browser mentions the MathJax copyright and the Apache 2.0 license. The javascript code for embedding =org-injo.js= in the browser mentions the copyright of Sebastian Rose and the GPLv3 (or later) license. [org-export-html-scripts] is now a variable, so that you can adapt the code and the license to your needs. See [http://www.gnu.org/philosophy/javascript-trap.html] for explanations on why these changes were necessary. [org-export-html-scripts]: http://orgmode.org/worg/doc.html#org-export-html-scripts -- Bastien