= is wrapped around the entire page, everything that is inside ==. This means that you need to update /org-info.js/ (if you have a local copy). It will be safe todo so, because the new org-info.js still handles older pages correctly. Thanks to Sebastian Rose for making these changes so quicky. *** Clustering characters for undo When typing in Org-mode, undo will now remove up to 20 characters at a time with a single undo command. This is how things work normally in Emacs, but the special binding of characters in Org-mode made this impossible until now. Thanks to Martin Pohlack for a patch which mimicks the behavior of the Emacs command loop for the Org version of =self-insert-command=. Note that this will not work in headlines and tables because typing there will do a lot of extra work. There might be a small typing performance hit resulting from this change - please report in the mailing list if this is noticeable and annoying. *** Separate settings for special C-a and C-e The variable `org-special-ctrl-a/e' now allows separate settings for =C-a= and =C-e=. For example #+begin_src emacs-lisp (setq org-special-ctrl-a/e '(reversed . t)) #+end_src Thanks to Alan Davis for this proposal. *** orgstruct++-mode improvements In addition to =orgstruct-mode= which allows to use some Org-mode structure commands in other major modes, there is a more invasive version of this mode: =orgstruct++-mode=. This mode will import all paragraph and line wrapping variables into the major mode, so that, for example, during typing the auto-fill wrapping of items will work just like in Org-mode. This change is not reversible, so turning off =orgstruct++-mode= will not remove these settings again. =orgstruct++-mode= is most useful in text modes like message-mode or =magit-log-edit-mode=. Furthermore, =orgstruct++-mode= will recognize plain list context not only in the first line of an item, but also further down, so that =M-RET= will correctly insert new items. Thanks to Austin Frank for requesting some of these changes. *** Promotion and demotion works for regions now =M-right= and =M-left= now do demote and promote all headlines in an active region. *** Match syntax for tags/properties is now described in a single place The manual chapters about tags and about properties now only refer to the section about agenda views, where the general syntax of tag/property matches is described. *** Macro replacement A string like ={{{ title }}}= will be replaced by the title of the document, ={{{ email }}}= by the email setting of the author and similarly for other export settings given in =#+...= lines. In addition to that, you can define an arbitrary number of macros, for example: #+begin_src org ,#+MACRO: myaddress 41 Onestreet, 12345 New York, NY ... ,my address is {{{myaddress}}}, see you there. #+end_src Macro replacement is the very first thing that happens during export, and macros will be replaced even in source code and other protected regions. *** New reload command, with keyboard access There is now a special command to reload all Org Lisp files, so that you can stay in your Emacs session while pulling and compiling changes to Org. The command to reload the compiled files (if available) is =C-c C-x r=. If no compiled files are found, uncompiled ones will be loaded. If you want to force loading of uncompiled code (great for producing backtraces), use a prefix arg: =C-u C-c C-x r=. Both commands are available in the menu as well. This new command was inspired by one written earlier by Bernt Hansen. *** Faces for priority cookies can now be set freely The new variable =org-priority-faces= can be used to set faces for each priority. *** New key for creating tags/property sparse trees The key to produce a sparse tree matching tags and properties is now =C-c / m= instead of =C-c a T=. This is more consistent with the =C-c a m= key for the corresponding agenda view. =C-c / T= will still work for now, but it is no longer advertised in the documentation and may go away at any time in the future. *** IDs in HTML have "ID-" prefix when generated by uuidgen /uuidgen/ generates IDs that often start with a number, not a letter. However, IDs and names in XHTML must start with a letter. Therefore, IDs in HTML files will now get an "ID-" prefix if they have been generated by /uuidgen/. This means that id links from one file to another may stop working until all files have been exported again, so that both links and targets have the new prefix. *** In agenda, only priority cookies get the special face So far, an entire task would get a special face when =org-agenda-fontify-priorities= was set. Now, the default value for this variable is the symbol =cookies=, which means that on the cookie is fontified. Set it to =t= if you want the entire task headline to be fontified. *** Turning off time-of-day search in headline Some people like to put a creation time stamp into a headline and then get confused if the time-of-day found in there shows up as the time-of-day of the deadline/scheduling entry for this headline. The reason for this is that Org searches the headline for a free-format time when trying to sort the entry into the agenda, and that search accidentally finds the time in the creation time stamp or something else that happens to look like a time. If this is more painful than useful for you, configure the new variable =org-agenda-search-headline-for-time=. * Version 6.23 :PROPERTIES: :CUSTOM_ID: v6.23 :END: ** Overview - Capture state change notes into a drawer - Clock lines are now captured into the LOGBOOK drawer as well - Added org-R.el to contrib directory - Allow individual formatting of each TODO keyword in HTML export - New hooks for add-ons to tap into context-sensitive commands - Publishing files irrespective of extension - New variable index in the manual - The ORDERED property also influences checkboxes - The ORDERED property can be tracked with a tag - You may now specify line breaks in the fast tags interface - When a TODO is blocked by checkboxes, keep it visible in agenda - LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc. ** Incompatible changes - CLOCK lines will now be captured into the LOGBOOK drawer. See below for details. ** Details *** Capture state change notes into a drawer State change notes can now be captured into a drawer =LOGBOOK=, to keep the entry tidy. If this is what you want, you will need this configuration: #+begin_src emacs-lisp (setq org-log-into-drawer "LOGBOOK") #+end_src Thanks to Wanrong Lin for this proposal. *** Clock lines are now captured into the LOGBOOK drawer as well The =CLOCK= drawer will be abandoned, clock lines will now also end up in a drawer =LOGBOOK=. The reason for this is that it's a bit useless to have two different drawers for state change notes and clock lines. If you wish to keep the old way, use #+begin_src emacs-lisp (setq org-clock-into-drawer "CLOCK") #+end_src *** Added org-R.el to contrib directory Dan Davison has contributed /org-R.el/ which is now in the contrib directory. Org-R performs numerical computations and generates graphics. Data can come from org tables, or from csv files; numerical output can be stored in the org buffer as org tables, and links are created to files containing graphical output. Although, behind the scenes, it uses R, you do not need to know anything about R. Common operations, such as tabulating discrete values in a column of an org table, are available "off the shelf" by specifying options on lines starting with =#+R:=. However, you can also provide raw R code to be evaluated. The documentation is currently the worg tutorial at http://orgmode.org/worg/org-tutorials/org-R/org-R.php Thanks to Dan for this great contribution. *** Allow individual formatting of TODO keyword and tags in HTML export TODO keywords in HTML export have the CSS class =todo= or =done=. Tags have the CSS class =tag=. In addition to this, each keyword has now itself as class, so you could do this in your CSS file: #+begin_src css .todo { font-weight:bold; } .done { font-weight:bold; } .TODO { color:red; } .WAITING { color:orange; } .DONE { color:green; } #+end_src If any of your keywords causes conflicts with CSS classes used for different purposes (for example a tag "title" would cause a conflict with the class used for formatting the document title), then you can use the variables =org-export-html-tag-class-prefix= and =org-export-html-todo-kwd-class-prefix= to define prefixes for the class names for keywords, for example "kwd-". Thanks to Wanrong Lin for this request, and to Sebastian Rose for help with the implementation. *** New hooks for add-ons to tap into context-sensitive commands Some commands in Org are context-sensitive, they will execute different functions depending on context. The most important example is of course =C-c C-c=, but also the =M-cursor= keys fall into this category. Org has now a system of hooks that can be used by add-on packages to install their own functionality into these keys. See the docstring of =org-ctrl-c-ctrl-c-hook= for details. The other hooks are named like =org-metaleft-hook= or =org-shiftmetaright-hook=. *** Publishing files irrespective of extension If you set the =:base-extension= property for a publishing project to the symbol =any=, all files in the directory will be published, irrespective of extension. Thanks to Richard Klinda for a patch to this effect. *** New variable index in the manual A new index in the manual lists all variables mentioned in the manual, about 200 variables in total. *** The ORDERED property also influences checkboxes When an entry has the ORDERED property set, checkboxes in the entry must be completed in order. This was already the case for children TODO items, now it also applies for checkboxes. Thanks to Rainer Stengele for this proposal. *** The ORDERED property can be tracked with a tag The =ORDERED= property is used to flag an entry so that subtasks (both children TODO items and checkboxes) must be completed in order. This property is most easily toggled with the command =C-c C-x o=. A property was chosen for this functionality, because this should be a behavior local to the current task, not inherited like tags. However, properties are normally invisible. If you would like visual feedback on the state of this property, configure the variable =org-track-ordered-property-with-tag=. If you then use =C-c C-x o= to toggle the property, a tag will be toggled as well, for visual feedback. Note that the tag itself has no meaning for the behavior of TODO items and checkboxes, and that changing the tag with the usual tag commands will not influence the property and therefore the behavior of TODO and checkbox commands. *** You may now specify line breaks in the fast tags interface Up to now, the fast tags interface tried to lump as many tags as possible into a single line, with the exception that groups would always be on a line by themselves. Now, if you use several lines to define your tags, like #+begin_src org ,#+TAGS: aa(a) bb(b) cc(c) ,#+TAGS: dd(d) ee(e) ff(f) #+end_src then there will also be a line break after the "cc" tag in the fast tag selection interface. You may also write #+begin_src org ,#+TAGS: aa(a) bb(b) cc(c) \n dd(d) ee(e) ff(f) #+end_src to achieve the same effect, and you can use =\n= several times in order to produce empty lines. In =org-tag-alist=, newlines are represented as =(:newline)=. Thanks to Christopher Suckling for a patch to this effect. *** When a TODO is blocked by checkboxes, keep it visible in agenda When the variable =org-agenda-dim-blocked-tasks= is set to =invisible=, tasks that are blocked will not be visible in the agenda. If the blocking is due to child TODO entries, this does make sense because the children themselves will show up in the TODO list. However, as John Rakestraw has [[http://thread.gmane.org/gmane.emacs.orgmode/10939][pointed out]], if the blocking is done by checkboxes, no trace of these subtasks is left. Therefore, when the blocking is done by checkboxes, we now overrule the =invisible= setting and replace it with mere dimming of the task. *** LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc. If you configure =org-export-latex-import-inbuffer-stuff=, in-buffer definitions like #+TITLE will be made available in the LaTeX file as =\orgTITLE=. This was a request by Russel Adams. * Version 6.22 :PROPERTIES: :CUSTOM_ID: v6.22 :END: ** Details *** org-choose.el by Tom Breton is now included Org-choose helps documenting a decision-making process by using TODO keywords for different degrees of /chosenness/, and by automatically keeping a set of alternatives in a consistent state. Documentation for /org-choose.el/ is available [[http://orgmode.org/worg/org-contrib/org-choose.php][here]]. This package inserts itself into Org using hooks, so if other people would like to do interesting stuff with TODO keywords for special purposes, looking at Tom's code might be a good way to start. Thanks to Tom for this interesting contribution! *** orgmode.org and Worg css works now better on IE Thanks to Sebastian Rose for making these changes. *** When exporting a subtree, headline levels are now relative to parent This was reported as a bug by William Henney and is fixed now. *** Inactive dates in tables can be used for sorting. When sorting table fields or entries by date, Org first tries to find an active date, and, if none exist, uses a passive date if present. This was a request by Hsui-Khuen Tang *** The default for =org-return-follows-link= is back to =nil= Setting it to =t= violates Emacs rules to some extent. The internal implementation of this has been improved, so setting it to =t= should now be pretty stable. *** Automatic scheduling of siblings with org-depend.el The sibling of a DONE task can now automatically be scheduled. This was a patch by Andrew Hyatt. *** New skipping conditions The functions =org-agenda-skip-entry-if= and =org-agenda-skip-subtree-if= now accept =timestamp= and =nottimestamp= as additional conditions. This was in response to a request by Saurabh Agrawal. * Version 6.21 :PROPERTIES: :CUSTOM_ID: v6.21 :END: ** Details *** Changes to some default values of variables: Here are the new default values: #+begin_example (setq org-return-follows-link t) (setq org-use-fast-todo-selection t) (setq org-yank-adjusted-subtrees nil) (setq org-tags-column -77) (setq org-agenda-sorting-strategy '((agenda time-up priority-down category-keep) (todo time-up priority-down category-keep) (tags time-up priority-down category-keep) (search category-keep))) #+end_example *** Final cleanup for Emacs 21.1 pretest * Version 6.20 :PROPERTIES: :CUSTOM_ID: v6.20 :END: ** Details *** Support for simple TODO dependencies John Wiegley's code for enforcing simple TODO dependencies has been integrated into Org-mode. Thanks John! The structure of Org files (hierarchy and lists) makes it easy to define TODO dependencies. A parent TODO task should not be marked DONE until all subtasks (defined as children tasks) are marked as DONE. And sometimes there is a logical sequence to a number of (sub)tasks, so that one task cannot be acted upon before all siblings above it are done. If you customize the variable =org-enforce-todo-dependencies=, Org will block entries from changing state while they have children that are not DONE. Furthermore, if an entry has a property =ORDERED=, each of its children will be blocked until all earlier siblings are marked DONE. Here is an example: #+begin_src org ,* TODO Blocked until (two) is done ,** DONE one ,** TODO two ,* Parent , :PROPERTIES: , :ORDERED: t , :END: ,** TODO a ,** TODO b, needs to wait for (a) ,** TODO c, needs to wait for (a) and (b) #+end_src The command =C-c C-x o= toggles the value of the =ORDERED= property. The variable =org-agenda-dim-blocked-tasks= controls how blocked entries should appear in the agenda, where they can be dimmed or even made invisible. Furthermore, you can use the variable =org-enforce-todo-checkbox-dependencies= to block TODO entries from switching to DONE while any checkboxes are unchecked in the entry. *** Support for shift-selection in Emacs 23 Customize the variable =org-support-shift-select= to use S-cursor key for selecting text. Make sure that you carefully read the docstring of that variable first. *** Adding and removing checkboxes from many lines The command =C-c C-x C-b= normally toggles checkbox status in the current line, or in all lines in the region. With prefix argument it now either adds or removes the checkbox. This was a requested by Daniel Clemente. * Older changes For older Changes, see [[file:Changes_old.org]] * COMMENT Setup #+STARTUP: showstars #+TITLE: Org-mode list of user-visible changes #+AUTHOR: Carsten Dominik #+EMAIL: carsten at orgmode dot org #+OPTIONS: H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:{} *:t TeX:t LaTeX:nil f:nil #+INFOJS_OPT: view:info toc:1 path:org-info.js tdepth:2 ftoc:t #+LINK_UP: index.html #+LINK_HOME: http://orgmode.org