1 # -*- mode: org; fill-column: 65 -*-
5 #+TITLE: Org-mode list of user-visible changes
6 #+AUTHOR: Carsten Dominik
7 #+EMAIL: carsten at orgmode dot org
8 #+OPTIONS: H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:{} *:t TeX:t LaTeX:nil f:nil
9 #+INFOJS_OPT: view:info toc:1 path:org-info.js tdepth:2 ftoc:t
11 #+LINK_HOME: http://orgmode.org
13 * Version 6.24 (in preparation)
18 ** Incompatible changes
20 *** New key for creating tags/property sparse trees
22 The key to produce a sparse tree matching tags and properties is
23 now =C-c / m= instead of =C-c a T=. This is also more consistent
24 with the =C-c a m= key for the corresponding agenda view.
25 =C-c / T= will still work for now, but it is no longer advertised
26 in the documentation and may go away at any time in the future.
28 *** IDs in HTML have "ID-" prefix when generated by uuidgen
30 =uuidgen= generates IDs that often start with a number, not a
31 latter. However, IDs and names in XHTML must start with a letter.
32 Therefore, IDs in HTML files will now get an "ID-" prefix if they
33 have been generated by uuidgen. This means that id links from one
34 file to another may stop working until all files have been
37 *** In agenda, only priority cookies get the special face
39 So far, an entire task would get a special face when
40 =org-agenda-fontify-priorities= was set. Now, the default value
41 for this variable is the symbol =cookies=, which means that on
42 the cookie is fontified. Set it to =t= if you want the entire
43 task headline to be fontified.
46 *** Tag searches are now case-sensitive
48 From this release on, tag searches will be case sensitive. While
49 I still think it would be nice to have them case-insensitive,
50 this was both an inconsistency (TODO keyword searches have always
51 been case-sensitive), and trouble for coding some efficient
52 algorithms. So please make sure that you give the tags with
53 correct casing when prompted for a match expression.
57 *** Improved ASCII export of links
59 ASCII export of links works now much better. If a link has a
60 link and a description part which are different, then the
61 description will remain in the text while the link part will be
62 moved to the end of the current section, before the next heading,
63 as a footnote-like construct.
65 Configure the variable =org-export-ascii-links-to-notes= if you
66 prefer the links to be shown in the text. In this case, Org will
67 make an attempt to wrap the line which may have become
68 significantly longer by showing the link.
70 *** PDF export of agenda views
72 Agenda views can now be exported to PDF files by writing them to
73 a file with extension ".pdf". Internally this works by first
74 producing the postscript version and then converting that to PDF
75 using the ghostview utility =ps2pdf=. Make sure that this
76 utility is installed on your system.
78 The postscript version will not be removed, it will stay around.
80 *** Inline some entry text for Agenda View export
82 When exporting an agenda view to HTML or PDF for printing or
83 remote access, one of the problems can be that information stored
84 in entries below the headline is not accessible in that format.
86 You can now copy some of that information to the agenda view
87 before exporting it. For this you need to set the variable
88 =org-agenda-add-entry-text-maxlines= to a number greater than 0.
90 #+begin_src emacs-lisp
91 (setq org-agenda-add-entry-text-maxlines 20)
94 Or you can do this with the settings in a custom agenda view,
97 #+begin_src emacs-lisp
100 (org-agenda-add-entry-text-maxlines 5))
101 ("agenda-today.pdf"))
104 *** Custom agenda commands can specify a filter preset
106 If a custom agenda command specifies a value for
107 =org-agenda-filter-preset= in its options, the initial view of
108 the agenda will be filterd by the specified tags. Applying a
109 filter with =/= will then always add to that preset filter,
110 clearing the filter with =/ /= will set it back to the preset.
111 Here is an example of a custom agenda view that will display the
112 agenda, but hide all entries with tags =FLUFF= or =BLUFF=:
114 #+begin_src emacs-lisp
116 ((org-agenda-filter-preset '("-FLUFF" "-BLUFF"))))
119 This is in response to a [[http://thread.gmane.org/gmane.emacs.orgmode/11752][thread on the mailing list]], started by
120 Daniel Clemente and with great contributions by Bernt Hansen and
123 *** Exporting of citations to LaTeX and HTML, using BibTeX
125 Citations can now me made using BibTeX, and will be exported to
126 LaTeX and HTML. This is implemented in a contributed package by
127 Taru Karttunen, /org-exp-bibtex.el/. Kudos to Taru for this
128 really nice addition.
130 *** Update of org2rem.el
132 /org2rem.el/ has been updated significantly and now does a more
133 comprehensive job of exporting Org events to remind.
135 Thanks to Sharad Pratap for this update.
137 *** New div around the entire page in HTMP export
139 A new =<div id=content>= is wrapped around the entire page,
140 everything that is inside =<body>=.
142 This means that you need to update /org-info.js/ (if you have a
143 local copy). It will be safe todo so, because the new
144 org-info.js still handles older pages correctly. Thanks to
145 Sebastian for making these changes so quicky.
147 *** Clustering characters for undo
149 When typing in Org-mode, undo will now remove up to 20 characters
150 at a time with a single undo command. This is how things work
151 normally in Emacs, but the special binding of characters in
152 Org-mode made this impossible until now.
154 Thanks to Martin Pohlack for a patch which mimicks the behavior
155 of the Emacs command loop for the Org version of
156 =self-insert-command=. Note that this will not work in headlines
157 and tables because typing there will do a lot of extra work.
159 There might be a small typing performance hit resulting from this
160 change - please report in the mailing list if this is noticeable
163 *** Separate settings for special C-a and C-e
165 The variable `org-special-ctrl-a/e' now allows separate settings
166 for =C-a= and =C-e=. For example
168 #+begin_src emacs-lisp
169 (setq org-special-ctrl-a/e '(reversed . t))
172 Thanks to Alan Davis for this proposal.
174 *** orgstruct++-mode improvements
176 In addition to =orgstruct-mode= which allows to use some Org-mode
177 structure commands in other major modes, there is a more invasive
178 version of this mode: =orgstruct++-mode=. This mode will import
179 all paragraph and line wrapping variables into the major mode, so
180 that, for example, during typing the auto-fill wrapping of items
181 will work just like in Org-mode. This change is not reversible,
182 so turning off =orgstruct++-mode= will not remove these settings
183 again. =orgstruct++-mode= is most useful in text modes like
184 message-mode or =magit-log-edit-mode=. Furthermore,
185 =orgstruct++-mode= will recognize plain list context not only in
186 the first line of an item, but also further down, so that =M-RET=
187 will correctly insert new items.
189 Thanks to Austin Frank for requesting some of these changes.
191 *** Promotion and demotion works for regions now
193 =M-right= and =M-left= now do demote and promote all headlines in
196 *** Match syntax for tags/properties is now described in a single place
198 The manual chapters about tags and about properties now only
199 refer to the section about agenda views, where the general syntax
200 of tag/property matches is described.
202 *** Macro replacement
204 A string like ={{{ title }}}= will be replaced by the title of
205 the document, ={{{ email }}}= by the email setting of the author
206 and similarly for other export settings given in =#+...= lines.
207 In addition to that, you can define an arbitrary number of
211 ,#+MACRO: myaddress 41 Onestreet, 12345 New York, NY
213 ,my address is {{{myaddress}}}, see you there.
216 Macro replacement is the very first thing that happens during
217 export, and macros will be replaced even in source code and other
220 *** New reload command, with keyboard access
222 There is now a special command to reload all Org Lisp files, so
223 that you can stay in your Emacs session while pulling and
224 compiling changes to Org. The command to reload the compiled
225 files (if available) is =C-c C-x r=. If no compiled files are
226 found, uncompiled ones will be loaded. If you want to force
227 loading of uncompiled code (great for producing backtraces), use
228 a prefix arg: =C-u C-c C-x o=. Both commands are available in
231 This new command was inspired by one written earlier by Bernt
234 *** Faces for priority cookies can now be set freely
236 The new variable =org-priority-faces= can be used to set faces
239 *** New key for creating tags/property sparse trees
241 The key to produce a sparse tree matching tags and properties is
242 now =C-c / m= instead of =C-c a T=. This is more consistent with
243 the =C-c a m= key for the corresponding agenda view. =C-c / T=
244 will still work for now, but it is no longer advertised in the
245 documentation and may go away at any time in the future.
247 *** IDs in HTML have "ID-" prefix when generated by uuidgen
249 /uuidgen/ generates IDs that often start with a number, not a
250 letter. However, IDs and names in XHTML must start with a letter.
251 Therefore, IDs in HTML files will now get an "ID-" prefix if they
252 have been generated by /uuidgen/. This means that id links from one
253 file to another may stop working until all files have been
254 exported again, so that both links and targets have the new prefix.
256 *** In agenda, only priority cookies get the special face
258 So far, an entire task would get a special face when
259 =org-agenda-fontify-priorities= was set. Now, the default value
260 for this variable is the symbol =cookies=, which means that on
261 the cookie is fontified. Set it to =t= if you want the entire
262 task headline to be fontified.
264 *** Turning off time-of-day search in headline
266 Some people like to put a creation time stamp into a headline and
267 then get confused if the time-of-day found in there shows up as
268 the time-of-day of the deadline/scheduling entry for this
269 headline. The reason for this is that Org searches the headline
270 for a free-format time when trying to sort the entry into the
271 agenda, and that search accidentally finds the time in the
272 creation time stamp or something else that happens to look like a
273 time. If this is more painful than useful for you, configure the
274 new variable =org-agenda-search-headline-for-time=.
280 - Capture state change notes into a drawer
281 - Clock lines are now captured into the LOGBOOK drawer as well
282 - Added org-R.el to contrib directory
283 - Allow individual formatting of each TODO keyword in HTML export
284 - New hooks for add-ons to tap into context-sensitive commands
285 - Publishing files irrespective of extension
286 - New variable index in the manual
287 - The ORDERED property also influences checkboxes
288 - The ORDERED property can be tracked with a tag
289 - You may now specify line breaks in the fast tags interface
290 - When a TODO is blocked by checkboxes, keep it visible in agenda
291 - LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc.
293 ** Incompatible changes
295 - CLOCK lines will now be captured into the LOGBOOK drawer.
296 See below for details.
300 *** Capture state change notes into a drawer
302 State change notes can now be captured into a drawer =LOGBOOK=,
303 to keep the entry tidy. If this is what you want, you will need
306 #+begin_src emacs-lisp
307 (setq org-log-into-drawer "LOGBOOK")
310 Thanks to Wanrong Lin for this proposal.
312 *** Clock lines are now captured into the LOGBOOK drawer as well
314 The =CLOCK= drawer will be abandoned, clock lines will now also
315 end up in a drawer =LOGBOOK=. The reason for this is that it's a
316 bit useless to have two different drawers for state change notes
317 and clock lines. If you wish to keep the old way, use
319 #+begin_src emacs-lisp
320 (setq org-clock-into-drawer "CLOCK")
323 *** Added org-R.el to contrib directory
325 Dan Davison has contributed /org-R.el/ which is now in the
326 contrib directory. Org-R performs numerical computations and
327 generates graphics. Data can come from org tables, or from csv
328 files; numerical output can be stored in the org buffer as org
329 tables, and links are created to files containing graphical
330 output. Although, behind the scenes, it uses R, you do not need
331 to know anything about R. Common operations, such as tabulating
332 discrete values in a column of an org table, are available "off
333 the shelf" by specifying options on lines starting with =#+R:=.
334 However, you can also provide raw R code to be evaluated. The
335 documentation is currently the worg tutorial at
336 http://orgmode.org/worg/org-tutorials/org-R/org-R.php
338 Thanks to Dan for this great contribution.
340 *** Allow individual formatting of TODO keyword and tags in HTML export
342 TODO keywords in HTML export have the CSS class =todo= or =done=.
343 Tags have the CSS class =tag=. In addition to this, each keyword
344 has now itself as class, so you could do this in your CSS file:
347 .todo { font-weight:bold; }
348 .done { font-weight:bold; }
350 .WAITING { color:orange; }
351 .DONE { color:green; }
354 If any of your keywords causes conflicts with CSS classes used
355 for different purposes (for example a tag "title" would cause a
356 conflict with the class used for formatting the document title),
357 then you can use the variables =org-export-html-tag-class-prefix=
358 and =org-export-html-todo-kwd-class-prefix= to define prefixes
359 for the class names for keywords, for example "kwd-".
361 Thanks to Wanrong Lin for this request, and to Sebastian Rose for
362 help with the implementation.
364 *** New hooks for add-ons to tap into context-sensitive commands
366 Some commands in Org are context-sensitive, they will execute
367 different functions depending on context. The most important
368 example is of course =C-c C-c=, but also the =M-cursor= keys fall
371 Org has now a system of hooks that can be used by add-on packages
372 to install their own functionality into these keys. See the
373 docstring of =org-ctrl-c-ctrl-c-hook= for details. The other
374 hooks are named like =org-metaleft-hook= or
375 =org-shiftmetaright-hook=.
377 *** Publishing files irrespective of extension
379 If you set the =:base-extension= property for a publishing
380 project to the symbol =any=, all files in the directory will be
381 published, irrespective of extension.
383 Thanks to Richard Klinda for a patch to this effect.
385 *** New variable index in the manual
387 A new index in the manual lists all variables mentioned in the
388 manual, about 200 variables in total.
390 *** The ORDERED property also influences checkboxes
392 When an entry has the ORDERED property set, checkboxes in
393 the entry must be completed in order. This was already the case
394 for children TODO items, now it also applies for checkboxes.
396 Thanks to Rainer Stengele for this proposal.
398 *** The ORDERED property can be tracked with a tag
400 The =ORDERED= property is used to flag an entry so that subtasks
401 (both children TODO items and checkboxes) must be completed in
402 order. This property is most easily toggled with the command
403 =C-c C-x o=. A property was chosen for this functionality,
404 because this should be a behavior local to the current task, not
405 inherited like tags. However, properties are normally
406 invisible. If you would like visual feedback on the state of
407 this property, configure the variable
408 =org-track-ordered-property-with-tag=. If you then use =C-c C-x
409 o= to toggle the property, a tag will be toggled as well, for
412 Note that the tag itself has no meaning for the behavior of TODO
413 items and checkboxes, and that changing the tag with the usual
414 tag commands will not influence the property and therefore the
415 behavior of TODO and checkbox commands.
417 *** You may now specify line breaks in the fast tags interface
419 Up to now, the fast tags interface tried to lump as many tags as
420 possible into a single line, with the exception that groups would
421 always be on a line by themselves.
423 Now, if you use several lines to define your tags, like
426 ,#+TAGS: aa(a) bb(b) cc(c)
427 ,#+TAGS: dd(d) ee(e) ff(f)
430 then there will also be a line break after the "cc" tag in the
431 fast tag selection interface. You may also write
434 ,#+TAGS: aa(a) bb(b) cc(c) \n dd(d) ee(e) ff(f)
437 to achieve the same effect, and you can use =\n= several times in
438 order to produce empty lines. In =org-tag-alist=, newlines are
439 represented as =(:newline)=.
441 Thanks to Christopher Suckling for a patch to this effect.
443 *** When a TODO is blocked by checkboxes, keep it visible in agenda
445 When the variable =org-agenda-dim-blocked-tasks= is set to
446 =invisible=, tasks that are blocked will not be visible in the
447 agenda. If the blocking is due to child TODO entries, this does
448 make sense because the children themselves will show up in the
451 However, as John Rakestraw has [[http://thread.gmane.org/gmane.emacs.orgmode/10939][pointed out]], if the blocking is
452 done by checkboxes, no trace of these subtasks is left.
453 Therefore, when the blocking is done by checkboxes, we now
454 overrule the =invisible= setting and replace it with mere dimming
457 *** LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc.
459 If you configure =org-export-latex-import-inbuffer-stuff=,
460 in-buffer definitions like #+TITLE will be made available in the
461 LaTeX file as =\orgTITLE=.
463 This was a request by Russel Adams.
468 *** org-choose.el by Tom Breton is now included
470 Org-choose helps documenting a decision-making process by using
471 TODO keywords for different degrees of /chosenness/, and by
472 automatically keeping a set of alternatives in a consistent state.
474 Documentation for /org-choose.el/ is available [[http://orgmode.org/worg/org-contrib/org-choose.php][here]].
476 This package inserts itself into Org using hooks, so if other
477 people would like to do interesting stuff with TODO keywords for
478 special purposes, looking at Tom's code might be a good way to
481 Thanks to Tom for this interesting contribution!
483 *** orgmode.org and Worg css works now better on IE
485 Thanks to Sebastian Rose for making these changes.
487 *** When exporting a subtree, headline levels are now relative to parent
489 This was reported as a bug by William Henney and is fixed now.
491 *** Inactive dates in tables can be used for sorting.
493 When sorting table fields or entries by date, Org first tries to
494 find an active date, and, if none exist, uses a passive date if
497 This was a request by Hsui-Khuen Tang
499 *** The default for =org-return-follows-link= is back to =nil=
501 Setting it to =t= violates Emacs rules to some extent. The
502 internal implementation of this has been improved, so setting it
503 to =t= should now be pretty stable.
505 *** Automatic scheduling of siblings with org-depend.el
507 The sibling of a DONE task can now automatically be scheduled.
509 This was a patch by Andrew Hyatt.
511 *** New skipping conditions
513 The functions =org-agenda-skip-entry-if= and
514 =org-agenda-skip-subtree-if= now accept =timestamp= and
515 =nottimestamp= as additional conditions.
517 This was in response to a request by Saurabh Agrawal.
523 *** Changes to some default values of variables:
525 Here are the new default values:
528 (setq org-return-follows-link t)
530 (setq org-use-fast-todo-selection t)
532 (setq org-yank-adjusted-subtrees nil)
534 (setq org-tags-column -77)
536 (setq org-agenda-sorting-strategy
537 '((agenda time-up priority-down category-keep)
538 (todo time-up priority-down category-keep)
539 (tags time-up priority-down category-keep)
540 (search category-keep)))
543 *** Final cleanup for Emacs 21.1 pretest
549 *** Support for simple TODO dependencies
551 John Wiegley's code for enforcing simple TODO dependencies has
552 been integrated into Org-mode. Thanks John!
554 The structure of Org files (hierarchy and lists) makes it easy to
555 define TODO dependencies. A parent TODO task should not be
556 marked DONE until all subtasks (defined as children tasks) are
557 marked as DONE. And sometimes there is a logical sequence to a
558 number of (sub)tasks, so that one task cannot be acted upon
559 before all siblings above it are done. If you customize the
560 variable =org-enforce-todo-dependencies=, Org will block entries
561 from changing state while they have children that are not DONE.
562 Furthermore, if an entry has a property =ORDERED=, each of its
563 children will be blocked until all earlier siblings are marked
564 DONE. Here is an example:
567 ,* TODO Blocked until (two) is done
576 ,** TODO b, needs to wait for (a)
577 ,** TODO c, needs to wait for (a) and (b)
580 The command =C-c C-x o= toggles the value of the =ORDERED=
583 The variable =org-agenda-dim-blocked-tasks= controls how blocked
584 entries should appear in the agenda, where they can be dimmed or
587 Furthermore, you can use the variable
588 =org-enforce-todo-checkbox-dependencies= to block TODO entries
589 from switching to DONE while any checkboxes are unchecked in the entry.
591 *** Support for shift-selection in Emacs 23
593 Customize the variable =org-support-shift-select= to use S-cursor
594 key for selecting text. Make sure that you carefully read the
595 docstring of that variable first.
597 *** Adding and removing checkboxes from many lines
599 The command =C-c C-x C-b= normally toggles checkbox status in the
600 current line, or in all lines in the region. With prefix
601 argument it now either adds or removes the checkbox.
603 This was a requested by Daniel Clemente.
609 - Improved behavior of conversion commands =C-c -= and =C-c *=
610 - Table formulas may now reference fields in other tables
611 - A final hline is imagined in each table, for the sake of references
612 - A tags-todo search can now ignore timestamped items
613 - =\par= can be used to force a paragraph break, also in footnotes
618 *** Improved behavior of conversion commands =C-c -= and =C-c *=
620 The conversion commands =C-c -= and =C-c *= are now better
621 behaved and therefore more useful, I hope.
623 If there is an active region, these commands will act on the
624 region, otherwise on the current line.
626 - C-c - :: This command turns headings or normal lines into
627 items, or items into normal lines. When there is a
628 region, everything depends on the first line of the
630 - if it is a item, turn all items in the region into
632 - if it is a headline, turn all headlines in the region
634 - if it is a normal line, turn all lines into items.
635 - special case: if there is no active region and the
636 current line is an item, cycle the bullet type of the
638 - C-c * :: This command turns items and normal lines into
639 headings, or headings into normal lines. When there is
640 a region, everything depends on the first line of the
642 - if it is a item, turn all items in the region into
644 - if it is a headline, turn all headlines in the region
646 - if it is a normal line, turn all lines into headlines.
648 *** Table formulas may now reference fields in other tables
650 You may now reference constants, fields and ranges from a
651 different table, either in the current file or even in a
652 different file. The syntax is
654 : remote(NAME-OR-ID,REF)
656 where /NAME/ can be the name of a table in the current file as
657 set by a =#+TBLNAME: NAME= line before the table. It can also be
658 the ID of an entry, even in a different file, and the reference
659 then refers to the first table in that entry. /REF/ is an
660 absolute field or range reference, valid in the referenced table.
661 Note that since there is no "current filed" for the remote table,
662 all row and column references must be absolute, not relative.
664 *** A final hline is imagined in each table, for the sake of references
666 Even if a table does not end with a hline (mine never do because I
667 think it is not pretty), for the sake of references you can
668 assume there is one. So in the following table
677 a reference like =@I$1..@II$2= will now work.
679 *** A tags-todo search can now ignore timestamped items
680 The variables =org-agenda-todo-ignore-with-date=,
681 =org-agenda-todo-ignore-with-date=, and
682 =org-agenda-todo-ignore-with-date= make it possible to
683 exclude TODO entries which have this kind of planning info
684 associated with them. This is most useful for people who
685 schedule everything, and who use the TODO list mainly to find
686 things that are not yet scheduled. Thomas Morgan pointed out
687 that also the tags-todo search may serve exactly this
688 purpose, and that it might be good to have a way to make
689 these variables also apply to the tags-todo search. I can
690 see that, but could not convince myself to make this the
691 default. A new variable must be set to make this happen:
692 =org-agenda-tags-todo-honor-ignore-options=.
694 *** =\par= can be used to force a paragraph break, also in footnotes
696 The LaTeX idiom =\par= will insert a paragraph break at that
697 location. Normally you would simply leave an empty line to get
698 such a break, but this is useful for footnotes whose
699 definitions may not contain empty lines.
702 ** Incompatible changes
704 *** Short examples must have a space after the colon
706 Short literal examples can be created by preceding lines
707 with a colon. Such lines must now have a space after the
708 colon. I believe this is already general practice, but now
709 it must be like this. The only exception are lines that are
710 empty except for the colon.
714 *** Include files can now also process switches
716 The example and src switches like =-n= can now also be added
717 to include file statements:
719 : #+INCLUDE "~/.emacs" src emacs-lisp -n -r
721 Thanks to Manish for pointing out that this was not yet
724 *** Examples can be exported to HTML as text areas
726 You can now specify a =-t= switch to an example or src block,
727 to make it export to HTML as a text area. To change the
728 defaults for height (number of lines in the example) and
729 width of this area (80), use the =-h= and =-w= switches.
731 Thanks to Ulf Stegemann for driving this development.
733 *** LaTeX_CLASS can be given as a property
735 When exporting a single subtree by selecting it as a region
736 before export, the LaTeX class for the export will be taken
737 from the =LaTeX_CLASS= property of the entry if present.
739 Thanks to Robert Goldman for this request.
741 *** Better handling of inlined images in different backends
743 Two new variables govern which kind of files can be inlined
744 during export. These are
745 =org-export-html-inline-image-extensions= and
746 =org-export-latex-inline-image-extensions=. Remember that
747 links are turned into an inline image if they are a pure link
748 with no description. HTML files can inline /.png/, /.jpg/,
749 and /.gif/ files, while LaTeX files, when processed with
750 /pdflatex/, can inline /.png/, /.jpg/, and /.pdf/ files.
751 These also represent the default settings for the new
752 variables. Note that this means that pure links to /.pdf/
753 files will be inlined - to avoid this for a particular link,
754 make sure that the link has a description part which is not
755 equal to the link part.
757 *** Links by ID now continue to work in HTML exported files
759 If you make links by ID, these links will now still work in
760 HTML exported files, provided that you keep the relative path
761 from link to target file the same.
763 Thanks to Friedrich Delgado Friedrichs for pushing this over
766 *** The relative timer can be paused
768 The new command `C-c C-x ,' will pause the relative timer.
769 When the relative timer is running, its value will be shown
770 in the mode line. To get rid of this display, you need to
771 really stop the timer with `C-u C-c C-x ,'.
773 Thanks to Alan Davis for driving this change.
775 *** The attachment directory may now be chosen by the user
777 Instead of using the automatic, unique directory related to
778 the entry ID, you can also use a chosen directory for the
779 attachments of an entry. This directory is specified by the
780 ATTACH_DIR property. You can use `C-c C-a s' to set this
783 Thanks to Jason Jackson for this proposal.
785 *** You can use a single attachment directory for a subtree
787 By setting the property ATTACH_DIR_INHERIT, you can now tell
788 Org that children of the entry should use the same directory
789 for attachments, unless a child explicitly defines its own
790 directory with the ATTACH_DIR property. You can use the
791 command `C-c C-a i' to set this property in an entry.
798 - Line numbers and references in literal examples
799 - New hooks for export preprocessing
800 - Capture column view into a different file
806 Org-mode now directly supports the creation of footnotes. In
807 contrast to the /footnote.el/ package, Org-mode's footnotes are
808 designed for work on a larger document, not only for one-off
809 documents like emails. The basic syntax is similar to the one
810 used by /footnote.el/, i.e. a footnote is defined in a paragraph
811 that is started by a footnote marker in square brackets in column
812 0, no indentation allowed. The footnote reference is simply the
813 marker in square brackets inside text. For example:
816 The Org homepage[fn:1] now looks a lot better than it used to.
818 [fn:1] The link is: http://orgmode.org
821 Org-mode extends the number-based syntax to /named/ footnotes and
822 optional inline definition. Using plain numbers as markers is
823 supported for backward compatibility, but not encouraged because
824 of possible conflicts with LaTeX syntax. Here are the valid
827 - [1] :: A plain numeric footnote marker.
829 - [fn:name] :: A named footnote reference, where `name' is a
830 unique label word or, for simplicity of automatic creation,
833 - [fn:: This is the inline definition of this footnote] :: A
834 LaTeX-like anonymous footnote where the definition is given
835 directly at the reference point.
837 - [fn:name: a definition] :: An inline definition of a footnote,
838 which also specifies a name for the note. Since Org allows
839 multiple references to the same note, you can then use use
840 `[fn:name]' to create additional references.
842 Footnote labels can be created automatically, or you create names
843 yourself. This is handled by the variable
844 =org-footnote-auto-label= and its corresponding =#+STARTUP=
845 keywords, see the docstring of that variable for details.
847 The following command handles footnotes:
849 - C-c C-x f :: The footnote action command. When the cursor is
850 on a footnote reference, jump to the definition. When it is
851 at a definition, jump to the (first) reference. Otherwise,
852 create a new footnote. Depending on the variable
853 `org-footnote-define-inline' (with associated =#+STARTUP=
854 options =fninline= and =nofninline=), the definitions will
855 be placed right into the text as part of the reference, or
856 separately into the location determined by the variable
857 =org-footnote-section=.
858 When this command is called with a prefix argument, a menu
859 of additional options is offered:
860 - s :: Sort the footnote definitions by reference sequence.
861 During editing, Org makes no effort to sort footnote
862 definitions into a particular sequence. If you want
863 them sorted, use this command, which will also move
864 entries according to =org-footnote-section=.
865 - n :: Normalize the footnotes by collecting all
866 definitions (including inline definitions) into a
867 special section, and then numbering them in
868 sequence. The references will then also be
869 numbers. This is meant to be the final step before
870 finishing a document (e.g. sending off an email).
871 The exporters do this automatically, and so could
872 something like `message-send-hook'.
873 - d :: Delete the footnote at point, and all references to it.
875 - C-c C-c :: If the cursor is on a footnote reference, jump to
876 the definition. If it is a the definition, jump back to the
877 reference. When called with a prefix argument at either
878 location, offer the same menu as `C-u C-c C-x f'.
880 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
881 corresponding definition/reference, and you can use the
882 usual commands to follow these links.
884 Org-mode's footnote support is designed so that it should also
885 work in buffers that are not in Org-mode, for example in email
886 messages. Just bind =org-footnote-action= to a global key like
889 The main trigger for this development came from a hook function
890 written by Paul Rivier, to implement named footnotes and to
891 convert them to numbered ones before export. Thanks, Paul!
893 Thanks also to Scot Becker for a thoughtful post bringing this
894 subject back onto the discussion table, and to Matt Lundin for
895 the idea of named footnotes and his prompt testing of the new
898 *** Line numbers and references in literal examples
900 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
901 do now allow optional line numbering in the example.
902 Furthermore, links to specific code lines are supported, greatly
903 increasing Org-mode's utility for writing tutorials and other
906 Code references use special labels embedded directly into the
907 source code. Such labels look like "(ref:name)" and must be
908 unique within a document. Org-mode links with "(name)" in the
909 link part will be correctly interpreted, both while working with
910 an Org file (internal links), and while exporting to the
911 different backends. Line numbering and code references are
912 supported for all three major backends, HTML, LaTeX, and ASCII.
913 In the HTML backend, hovering the mouse over a link to a source
914 line will remote-highlight the referenced code line.
916 The options for the BEGIN lines are:
918 - -n :: Number the lines in the example
919 - +n :: Like -n, but continue numbering from where the previous
921 - -r :: Remove the coderef cookies from the example, and replace
922 links to this reference with line numbers. This option
923 takes only effect if either -n or +n are given as well.
924 If -r is not given, coderefs simply use the label name.
925 - -l "fmt" :: Define a local format for coderef labels, see the
926 variable =org-coderef-label-format= for details. Use this
927 of the default syntax causes conflicts with the code in the
928 code snippet you are using.
933 #+begin_src emacs-lisp -n -r
934 (defmacro org-unmodified (&rest body) (ref:def)
935 "Execute body without changing `buffer-modified-p'."
936 `(set-buffer-modified-p (ref:back)
937 (prog1 (buffer-modified-p) ,@body)))
939 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
943 When exported, this is translated to:
944 #+begin_src emacs-lisp -n -r
945 (defmacro org-unmodified (&rest body) (ref:def)
946 "Execute body without changing `buffer-modified-p'."
947 `(set-buffer-modified-p (ref:back)
948 (prog1 (buffer-modified-p) ,@body)))
950 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
953 Thanks to Ilya Shlyakhter for proposing this feature set. Thanks
954 to Sebastian Rose for the key Javascript element that made the
955 remote highlighting possible.
957 *** New hooks for export preprocessing
958 The export preprocessor now runs more hooks, to allow
959 better-timed tweaking by user functions:
961 - =org-export-preprocess-hook= ::
962 Pretty much the first thing in the preprocessor. But org-mode
963 is already active in the preprocessing buffer.
965 - =org-export-preprocess-after-include-files-hook= ::
966 This is run after the contents of included files have been inserted.
968 - =org-export-preprocess-after-tree-selection-hook= ::
969 This is run after selection of trees to be exported has
970 happened. This selection includes tags-based selection, as
971 well as removal of commented and archived trees.
973 - =org-export-preprocess-before-backend-specifics-hook= ::
974 Hook run before backend-specific functions are called during preprocessing.
976 - =org-export-preprocess-final-hook= ::
977 Hook for preprocessing an export buffer. This is run as the
978 last thing in the preprocessing buffer, just before returning
979 the buffer string to the backend.
981 *** Capture column view into a different file
983 The :id parameter for the dynamic block capturing column view
984 can now truly be an ID that will also be found in a
985 different file. Also, it can be like =file:path/to/file=, to
986 capture the global column view from a different file.
988 Thanks to Francois Lagarde for his report that IDs outside
989 the current file would not work.
992 Cleanup of many small bugs, and one new feature.
996 *** References to last table row with special names
998 Fields in the last row of a table can now be referenced with
999 $LR1, $LR2, etc. These references can appear both on the
1000 left hand side and right hand side of a formula.
1004 This version reverses the introduction of @0 as a reference to
1005 the last rwo in a table, because of a conflict with the use of
1006 @0 for the current row.
1011 - All known LaTeX export issues fixed
1012 - Captions and attributes for figures and tables.
1013 - Better implementation for entry IDs
1014 - Spreadsheet references to the last table line.
1015 - Old syntax for link attributes abandoned
1017 ** Incompatible changes
1018 *** Old syntax for link attributes abandoned
1020 There used to be a syntax for setting link attributes for
1021 HTML export by enclosing the attributes into double braces
1022 and adding them to the link itself, like
1025 [[./img/a.jpg{{alt="an image"}}] ]
1028 This syntax is not longer supported, use instead
1031 ,#+ATTR_HTML: alt="an image"
1037 *** All known LaTeX export issues fixed
1039 All the remaining issues with the LaTeX exporter have hopefully
1040 been addressed in this release. In particular, this covers
1041 quoting of special characters in tables and problems with
1042 exporting files where the headline is in the first line, or with
1045 *** Captions and attributes for figures and tables.
1047 Tables, and Hyperlinks that represent inlined images, can now be
1048 equipped with additional information that will be used during
1049 export. The information will be taken from the following special
1050 lines in the buffer and apply to the first following table or
1053 - #+CAPTION: :: The caption of the image or table. This string
1054 should be processed according to the export backend, but
1055 this is not yet done.
1057 - #+LABEL: :: A label to identify the figure/table for cross
1058 references. For HTML export, this string will become the
1059 ID for the ~<div class="figure">~ element that encapsulates
1060 the image tag and the caption. For LaTeX export, this
1061 string will be used as the argument of a ~\label{...}~
1062 macro. These labels will be available for internal links
1063 like ~[[label][Table] ]~.
1065 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
1066 added as attributes into the ~<img...>~ tag. This string
1067 will not be processed, so it should have immediately the
1070 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
1072 For /images/, this string is directly inserted into
1073 the optional argument of the ~\includegraphics[...]{file}~
1074 command, to specify scaling, clipping and other options.
1075 This string will not be processed, so it should have
1076 immediately the right format, like =width=5cm,angle=90=.\\
1077 For /tables/, this can currently contain the keyword
1078 =longtable=, to request typesetting of the table using the
1079 longtable package, which automatically distributes the table
1080 over several pages if needed. Also, the attributes line may
1081 contain an alignment string for the tabular environment, like
1082 =longtable,align=l|lrl=
1084 For LaTeX export, if either a caption or a label is given, the element
1085 will be exported as a float, i.e. wrapped into a figure or table
1088 *** Better implementation for entry IDs
1090 Unique identifiers for entries can now be used more efficiently.
1091 Internally, a hash array has replaced the alist used so far to
1092 keep track of the files in which an ID is defined. This makes it
1093 quite fast to find an entry by ID.
1095 There is a new link type which looks like this:
1098 id:GLOBALLY-UNIQUE-IDENTIFIER
1101 This link points to a specific entry. When you move the entry to
1102 a different file, for example if you move it to an archive
1103 file, the link will continue to work.
1105 The file /org-id.el/ contains an API that can be used to write
1106 code using these identifiers, including creating IDs and finding
1107 them wherever they are.
1109 Org has its own method to create unique identifiers, but if the system
1110 has /uuidgen/ command installed (Mac's and Linux systems generally
1111 do), it will be used by default (a change compared to the earlier
1112 implmentation, where you explicitdly had to opt for uuidgen). You can
1113 also select the method by hand, using the variable =org-id-method=.
1115 If the ID system ever gets confused about where a certain ID is, it
1116 initiates a global scan of all agenda files with associated archives,
1117 all files previously known containing any IDs, and all currently
1118 visited Org-mode files to rebuild the hash. You can also initiate
1119 this by hand: =M-x org-id-update-id-locations=. Running this command
1120 will also dump into the =*Messages*= buffer information about any
1121 duplicate IDs. These should not exist, and Org will never /make/ the
1122 same ID twice, but if you /copy/ an entry with its properties,
1123 duplicate IDs will inevitably be produced. Unfortunately, this is
1124 unavoidable in a plain text system that allows you to edit the text in
1125 arbitrary ways, and a portion of care on your side is needed to keep
1128 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
1129 This is also a change from previous versions where the file was
1130 =~/.org=id-locations=. Therefore, you can remove this old file
1131 if you have it. I am not sure what will happen if the =.emacs.d=
1132 directory does not exists in your setup, but in modern Emacsen, I
1133 believe it should exist. If you do not want to use IDs across
1134 files, you can avoid the overhead with tracking IDs by
1135 customizing the variable =org-id-track-globally=. IDs can then
1136 still be used for links inside a single file.
1138 IDs will also be used when you create a new link to an Org-mode
1139 buffer. If you use =org-store-link= (normally at =C-c l=) inside
1140 en entry in an Org-mode buffer, and ID property will be created
1141 if it does not exist, and the stored link will be an =id:= link.
1142 If you prefer the much less secure linking to headline text, you
1143 can configure the variable =org-link-to-org-use-id=. The default
1144 setting for this variable is =create-if-interactive=, meaning
1145 that an ID will be created when you store a link interactively,
1146 but not if you happen to be in an Org-mode file while you create
1147 a remember note (which usually has a link to the place where you
1148 were when starting remember).
1150 *** Spreadsheet references to the last table line.
1152 You may now use =@0= to reference the last dataline in a table
1153 in a stable way. This is useful in particular for automatically
1154 generated tables like the ones using /org-collector.el/ by Eric
1160 - New relative timer to support timed notes
1161 - Special faces can be set for individual tags
1162 - The agenda shows now all tags, including inherited ones.
1163 - Exclude some tags from inheritance.
1164 - More special values for time comparisons in property searches
1165 - Control for exporting meta data
1166 - Cut and Paste with hot links from w3m to Org
1167 - LOCATION can be inherited for iCalendar export
1168 - Relative row references crossing hlines now throw an error
1170 ** Incompatible Changes
1172 *** Relative row references crossing hlines now throw an error
1174 Relative row references in tables look like this: "@-4" which
1175 means the forth row above this one. These row references are
1176 not allowed to cross horizontal separator lines (hlines). So
1177 far, when a row reference violates this policy, Org would
1178 silently choose the field just next to the hline.
1180 Tassilo Horn pointed out that this kind of hidden magic is
1181 actually confusing and may cause incorrect formulas, and I do
1182 agree. Therefore, trying to cross a hline with a relative
1183 reference will now throw an error.
1185 If you need the old behavior, customize the variable
1186 `org-table-error-on-row-ref-crossing-hline'.
1190 *** New relative timer to support timed notes
1192 Org now supports taking timed notes, useful for example while
1193 watching a video, or during a meeting which is also recorded.
1196 Insert a relative time into the buffer. The first time
1197 you use this, the timer will be started. When called
1198 with a prefix argument, the timer is reset to 0.
1201 Insert a description list item with the current relative
1202 time. With a prefix argument, first reset the timer to 0.
1205 Once the time list has been initiated, you can also use the
1206 normal item-creating command to insert the next timer item.
1209 Reset the timer without inserting anything into the buffer.
1210 By default, the timer is reset to 0. When called with a
1211 =C-u= prefix, reset the timer to specific starting
1212 offset. The user is prompted for the offset, with a
1213 default taken from a timer string at point, if any, So this
1214 can be used to restart taking notes after a break in the
1215 process. When called with a double prefix argument
1216 =C-c C-u=, change all timer strings in the active
1217 region by a certain amount. This can be used to fix timer
1218 strings if the timer was not started at exactly the right
1221 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
1222 contributions to this idea.
1224 *** Special faces can be set for individual tags
1226 You may now use the variable =org-tag-faces= to define the
1227 face used for specific tags, much in the same way as you can
1228 do for TODO keywords.
1230 Thanks to Samuel Wales for this proposal.
1232 *** The agenda shows now all tags, including inherited ones.
1234 This request has come up often, most recently it was
1235 formulated by Tassilo Horn.
1237 If you prefer the old behavior of only showing the local
1238 tags, customize the variable =org-agenda-show-inherited-tags=.
1240 *** Exclude some tags from inheritance.
1242 So far, the only way to select tags for inheritance was to
1243 allow it for all tags, or to do a positive selection using
1244 one of the more complex settings for
1245 `org-use-tag-inheritance'. It may actually be better to
1246 allow inheritance for all but a few tags, which was difficult
1247 to achieve with this methodology.
1249 A new option, `org-tags-exclude-from-inheritance', allows to
1250 specify an exclusion list for inherited tags.
1252 *** More special values for time comparisons in property searches
1254 In addition to =<now>=, =<today>=, =<yesterday>=, and
1255 =<tomorrow>=, there are more special values accepted now in
1256 time comparisons in property searches: You may use strings
1257 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
1258 week, month, and year, respectively
1260 Thanks to Linday Todd for this proposal.
1262 *** Control for exporting meta data
1264 All the metadata in a headline, i.e. the TODO keyword, the
1265 priority cookie, and the tags, can now be excluded from
1266 export with appropriate options:
1268 | Variable | Publishing property | OPTIONS switch |
1269 |-------------------------------+---------------------+----------------|
1270 | org-export-with-todo-keywords | :todo-keywords | todo: |
1271 | org-export-with-tags | :tags | tags: |
1272 | org-export-with-priority | :priority | pri: |
1274 *** Cut and Paste with hot links from w3m to Org
1276 You can now use the key =C-c C-x M-w= in a w3m buffer with
1277 HTML content to copy either the region or the entire file in
1278 a special way. When you yank this text back into an Org-mode
1279 buffer, all links from the w3m buffer will continue to work
1282 For this to work you need to load the new file /org-w3m.el./
1283 Please check your org-modules variable to make sure that this
1286 Thanks for Richard Riley for the idea and to Andy Stewart for
1289 *** LOCATION can be inherited for iCalendar export
1291 The LOCATION property can now be inherited during iCalendar
1292 export if you configure =org-use-property-inheritance= like
1295 #+begin_src emacs-lisp
1296 (setq org-use-property-inheritance '("LOCATION"))
1303 - Keybindings in Remember buffers can be configured
1304 - Support for ido completion
1305 - New face for date lines in agenda column view
1306 - Invisible targets become now anchors in headlines.
1307 - New contributed file /org-exp-blocks.el/
1308 - New contributed file /org-eval-light.el/
1310 - BBDB links may use regular expressions.
1311 - Link abbreviations can use %h to insert a url-encoded target value
1312 - Improved XHTML compliance
1316 *** Keybindings in Remember buffers can be configured
1318 The remember buffers created with Org's extensions are in
1319 Org-mode, which is nice to prepare snippets that will
1320 actually be stored in Org-mode files. However, this makes it
1321 hard to configure key bindings without modifying the Org-mode
1322 keymap. There is now a minor mode active in these buffers,
1323 `org-remember-mode', and its keymap org-remember-mode-map can
1324 be used for key bindings. By default, this map only contains
1325 the bindings for =C-c C-c= to store the note, and =C-c C-k=
1326 to abort it. Use `org-remember-mode-hook' to define your own
1329 #+begin_src emacs-lisp
1331 'org-remember-mode-hook
1333 (define-key org-remember-mode-map
1334 "\C-x\C-s" 'org-remember-finalize)))
1337 If you wish, you can also use this to free the =C-c C-c=
1338 binding (by binding this key to nil in the minor mode map),
1339 so that you can use =C-c C-c= again to set tags.
1341 This modification is based on a request by Tim O'Callaghan.
1343 *** Support for ido completion
1345 You can now get the completion interface from /ido.el/ for
1346 many of Org's internal completion commands by turning on the
1347 variable =org-completion-use-ido=. =ido-mode= must also be
1348 active before you can use this.
1350 This change is based upon a request by Samuel Wales.
1352 *** New face for date lines in agenda column view
1354 When column view is active in the agenda, and when you have
1355 summarizing properties, the date lines become normal column
1356 lines and the separation between different days becomes
1357 harder to see. If this bothers you, you can now customize
1358 the face =org-agenda-column-dateline=.
1360 This is based on a request by George Pearson.
1362 *** Invisible targets become now anchors in headlines.
1364 These anchors can be used to jump to a directly with an HTML
1365 link, just like the =sec-xxx= IDs. For example, the
1366 following will make a http link
1367 =//domain/path-to-my-file.html#dummy= work:
1374 This is based on a request by Matt Lundin.
1376 *** New contributed file /org-exp-blocks.el/
1378 This new file implements special export behavior of
1379 user-defined blocks. The currently supported blocks are
1381 - comment :: Comment blocks with author-specific markup
1382 - ditaa :: conversion of ASCII art into pretty png files
1383 using Stathis Sideris' /ditaa.jar/ program
1384 - dot :: creation of graphs in the /dot/ language
1385 - R :: Sweave type exporting using the R program
1387 For more details and examples, see the file commentary in
1388 /org-exp-blocks.el/.
1390 Kudos to Eric Schulte for this new functionality, after
1391 /org-plot.el/ already his second major contribution. Thanks
1392 to Stathis for this excellent program, and for allowing us to
1393 bundle it with Org-mode.
1395 *** New contributed file /org-eval-light.el/
1397 This module gives control over execution Emacs Lisp code
1398 blocks included in a file.
1400 Thanks to Eric Schulte also for this file.
1402 *** Link translation
1404 You can now configure Org to understand many links created
1405 with the Emacs Planner package, so you can cut text from
1406 planner pages and paste them into Org-mode files without
1407 having to re-write the links. Among other things, this means
1408 that the command =org-open-at-point-global= which follows
1409 links not only in Org-mode, but in arbitrary files like
1410 source code files etc, will work also with links created by
1411 planner. The following customization is needed to make all of
1414 #+begin_src emacs-lisp
1415 (setq org-link-translation-function
1416 'org-translate-link-from-planner)
1419 I guess an inverse translator could be written and integrated
1422 *** BBDB links may use regular expressions.
1424 This did work all along, but only now I have documented it.
1426 *** =yank-pop= works again after yanking an outline tree
1428 Samuel Wales had noticed that =org-yank= did mess up this
1429 functionality. Now you can use =yank-pop= again, the only
1430 restriction is that the so-yanked text will not be
1431 pro/demoted or folded.
1433 *** Link abbreviations can use %h to insert a url-encoded target value
1435 Thanks to Steve Purcell for a patch to this effect.
1437 *** Improved XHTML compliance
1439 Thanks to Sebastian Rose for pushing this.
1441 *** Many bug fixes again.
1446 - A region of entries can now be refiled with a single command
1447 - Fine-tuning the behavior of `org-yank'
1448 - Formulas for clocktables
1449 - Better implementation of footnotes for HTML export
1450 - More languages for HTML export.
1454 *** A region of entries can now be refiled with a single command
1456 With =transient-make-mode= active (=zmacs-regions= under
1457 XEmacs), you can now select a region of entries and refile
1458 them all with a single =C-c C-w= command.
1460 Thanks to Samuel Wales for this useful proposal.
1462 *** Fine-tuning the behavior of =org-yank=
1464 The behavior of Org's yanking command has been further
1465 fine-tuned in order to avoid some of the small annoyances
1466 this command caused.
1468 - Calling =org-yank= with a prefix arg will stop any special
1469 treatment and directly pass through to the normal =yank=
1470 command. Therefore, you can now force a normal yank with
1473 - Subtrees will only be folded after a yank if doing so will
1474 now swallow any non-white characters after the yanked text.
1475 This is, I think a really important change to make the
1476 command work more sanely.
1478 *** Formulas for clocktables
1480 You can now add formulas to a clock table, either by hand, or
1481 with a =:formula= parameter. These formulas can be used to
1482 create additional columns with further analysis of the
1485 Thanks to Jurgen Defurne for triggering this addition.
1487 *** Better implementation of footnotes for HTML export
1489 The footnote export in 6.11 really was not good enough. Now
1490 it works fine. If you have customized
1491 =footnote-section-tag=, make sure that your customization is
1492 matched by =footnote-section-tag-regexp=.
1494 Thanks to Sebastian Rose for pushing this change.
1496 *** More languages for HTML export.
1498 More languages are supported during HTML export. This is
1499 only relevant for the few special words Org inserts, like
1500 "Table of Contents", or "Footnotes". Also the encoding
1501 issues with this feature seem to be solved now.
1503 Thanks to Sebastian Rose for pushing me to fix the encoding
1510 - Yanking subtree with =C-y= now adjusts the tree level
1511 - State changes can now be shown in the log mode in the agenda
1512 - Footnote in HTML export are now collected at the end of the document
1513 - HTML export now validates again as XHTML
1514 - The clock can now be resumed after exiting and re-starting Emacs
1515 - Clock-related data can be saved and resumed across Emacs sessions
1516 - Following file links can now use C-u C-u to force use of an external app
1517 - Inserting absolute files names now abbreviates links with "~"
1518 - Links to attachment files
1519 - Completed repeated tasks listed briefly in agenda
1520 - Remove buffers created during publishing are removed
1524 *** Yanking subtree with =C-y= now adjusts the tree level
1525 When yanking a cut/copied subtree or a series of trees, the
1526 normal yank key =C-y= now adjusts the level of the tree to
1527 make it fit into the current outline position, without losing
1528 its identity, and without swallowing other subtrees.
1530 This uses the command =org-past-subtree=. An additional
1531 change in that command has been implemented: Normally, this
1532 command picks the right outline level from the surrounding
1533 *visible* headlines, and uses the smaller one. So if the
1534 cursor is between a level 4 and a level 3 headline, the tree
1535 will be pasted as level 3. If the cursor is actually *at*
1536 the beginning of a headline, the level of that headline will
1537 be used. For example, lets say you have a tree like this:
1543 ,(2)* Level one again
1546 with (1) and (2) indicating possible cursor positions for the
1547 insertion. When at (1), the tree will be pasted as level 2.
1548 When at (2), it will be pasted as level 1.
1550 If you do not want =C-y= to behave like this, configure the
1551 variable =org-yank-adjusted-subtrees=.
1553 Thanks to Samuel Wales for this idea and a partial implementation.
1555 *** State changes can now be shown in the log mode in the agenda
1557 If you configure the variable =org-agenda-log-mode-items=,
1558 you can now request that all logged state changes be included
1559 in the agenda when log mode is active. If you find this too
1560 much for normal applications, you can also temporarily
1561 request the inclusion of state changes by pressing =C-u l= in
1564 This was a request by Hsiu-Khuern Tang.
1566 You can also press `C-u C-u l' to get *only* log items in the
1567 agenda, withour any timestamps/deadlines etc.
1569 *** Footnote in HTML export are now collected at the end of the document
1570 Previously, footnotes would be left in the document where
1571 they are defined, now they are all collected and put into a
1572 special =<div>= at the end of the document.
1574 Thanks to Sebastian Rose for this request.
1576 *** HTML export now validates again as XHTML.
1578 Thanks to Sebastian Rose for pushing this cleanup.
1580 *** The clock can now be resumed after exiting and re-starting Emacs
1582 If the option =org-clock-in-resume= is t, and the first clock
1583 line in an entry is unclosed, clocking into that task resumes
1584 the clock from that time.
1586 Thanks to James TD Smith for a patch to this effect.
1588 *** Clock-related data can be saved and resumed across Emacs sessions
1590 The data saved include the contents of =org-clock-history=,
1591 and the running clock, if there is one.
1593 To use this, you will need to add to your .emacs
1595 #+begin_src emacs-lisp
1596 (setq org-clock-persist t)
1597 (setq org-clock-in-resume t)
1598 (org-clock-persistence-insinuate)
1601 Thanks to James TD Smith for a patch to this effect.
1603 *** Following file links can now use C-u C-u to force use of an external app.
1605 So far you could only bypass your setup in `org-file-apps'
1606 and force opening a file link in Emacs by using a =C-u= prefix arg
1607 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
1608 an external application. Which external application depends
1609 on your system. On Mac OS X and Windows, =open= is used. On
1610 a GNU/Linux system, the mailcap settings are used.
1612 This was a proposal by Samuel Wales.
1614 *** Inserting absolute files names now abbreviates links with "~".
1616 Inserting file links with =C-u C-c C-l= was buggy if the
1617 setting of `org-link-file-path-type' was `adaptive' (the
1618 default). Absolute file paths were not abbreviated relative
1619 to the users home directory. This bug has been fixed.
1621 Thanks to Matt Lundin for the report.
1623 *** Links to attachment files
1625 Even though one of the purposes of entry attachments was to
1626 reduce the number of links in an entry, one might still want
1627 to have the occasional link to one of those files. You can
1628 now use link abbreviations to set up a special link type that
1629 points to attachments in the current entry. Note that such
1630 links will only work from within the same entry that has the
1631 attachment, because the directory path is entry specific.
1632 Here is the setup you need:
1634 #+begin_src emacs-lisp
1635 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
1638 After this, a link like this will work
1641 [[att:some-attached-file.txt]]
1643 This was a proposal by Lindsay Todd.
1645 *** Completed repeated tasks listed briefly in agenda
1647 When a repeating task, listed in the daily/weekly agenda under
1648 today's date, is completed from the agenda, it is listed as
1649 DONE in the agenda until the next update happens. After the
1650 next update, the task will have disappeared, of course,
1651 because the new date is no longer today.
1653 *** Remove buffers created during publishing are removed
1655 Buffers that are created during publishing are now deleted
1656 when the publishing is over. At least I hope it works like this.
1662 - Secondary agenda filtering is becoming a killer feature
1663 - Setting tags has now its own binding, =C-c C-q=
1664 - Todo state changes can trigger tag changes
1665 - C-RET will now always insert a new headline, never an item.
1666 - Customize org-mouse.el feature set to free up mouse events
1667 - New commands for export all the way to PDF (through LaTeX)
1668 - Some bug fixed for LaTeX export, more bugs remain.
1672 *** Enhancements to secondary agenda filtering
1674 This is, I believe, becoming a killer feature. It allows you
1675 to define fewer and more general custom agenda commands, and
1676 then to do the final narrowing to specific tasks you are
1677 looking for very quickly, much faster than calling a new
1680 If you have not tries this yet, you should!
1682 **** You can now refining the current filter by an additional criterion
1683 When filtering an existing agenda view with =/=, you can
1684 now narrow down the existing selection by an additional
1685 condition. Do do this, use =\= instead of =/= to add the
1686 additional criterion. You can also press =+= or =-= after
1687 =/= to add a positive or negative condition. A condition
1688 can be a TAG, or an effort estimate limit, see below.
1690 **** It is now possible to filter for effort estimates
1691 This means to filter the agenda for the value of the Effort
1692 property. For this you should best set up global allowed
1693 values for effort estimates, with
1695 #+begin_src emacs-lisp
1696 (setq org-global-properties
1697 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
1700 You may then select effort limits with single keys in the
1701 filter. It works like this: After =/= or =\=, first select
1702 the operator which you want to use to compare effort
1705 : < Select entries with effort smaller than or equal to the limit
1706 : > Select entries with effort larger than or equal to the limit
1707 : = Select entries with effort equal to the limit
1709 After that, you can press a single digit number which is
1710 used as an index to the allowed effort estimates.
1712 If you do not use digits to fast-select tags, you can even
1713 skip the operator, which will then default to
1714 `org-agenda-filter-effort-default-operator', which is by
1717 Thanks to Manish for the great idea to include fast effort
1718 filtering into the agenda filtering process.
1720 **** The mode line will show the active filter
1721 For example, if there is a filter in place that does select
1722 for HOME tags, against EMAIL tags, and for tasks with an
1723 estimated effort smaller than 30 minutes, the mode-line with
1724 show =+HOME-EMAIL+<0:30=
1726 **** The filter now persists when the agenda view is refreshed
1727 All normal refresh commands, including those that move the
1728 weekly agenda from one week to the next, now keep the
1729 current filter in place.
1731 You need to press =/ /= to turn off the filter. However,
1732 when you run a new agenda command, for example going from
1733 the weekly agenda to the TODO list, the filter will be
1736 *** Setting tags has now its own binding, =C-c C-q=
1738 You can still use =C-c C-c= on a headline, but the new
1739 binding should be considered as the main binding for this
1740 command. The reasons for this change are:
1742 - Using =C-c C-c= for tags is really out of line with other
1745 - I hate it in Remember buffers when I try to set tags and I
1746 cannot, because =C-c C-c= exits the buffer :-(
1748 - =C-c C-q= will also work when the cursor is somewhere down
1749 in the entry, it does not have to be on the headline.
1751 *** Todo state changes can trigger tag changes
1753 The new option =org-todo-state-tags-triggers= can be used to
1754 define automatic changes to tags when a TODO state changes.
1755 For example, the setting
1757 : (setq org-todo-state-tags-triggers
1758 : '((done ("Today" . nil) ("NEXT" . nil))
1759 : ("WAITING" ("Today" . t))))
1761 will make sure that any change to any of the DONE states will
1762 remove tags "Today" and "NEXT", while switching to the
1763 "WAITING" state will trigger the tag "Today" to be added.
1765 I use this mostly to get rid of TODAY and NEXT tags which I
1766 apply to select an entry for execution in the near future,
1767 which I often prefer to specific time scheduling.
1769 *** C-RET will now always insert a new headline, never an item.
1770 The new headline is inserted after the current subtree.
1772 Thanks to Peter Jones for patches to fine-tune this behavior.
1774 *** Customize org-mouse.el feature set
1775 There is a new variable =org-mouse-features= which gives you
1776 some control about what features of org-mouse you want to
1777 use. Turning off some of the feature will free up the
1778 corresponding mouse events, or will avoid activating special
1779 regions for mouse clicks. By default I have urned off the
1780 feature to use drag mouse events to move or promote/demote
1781 entries. You can of course turn them back on if you wish.
1783 This variable may still change in the future, allowing more
1784 fine-grained control.
1786 *** New commands for export to PDF
1788 This is using LaTeX export, and then processes it to PDF
1791 : C-c C-e p process to PDF.
1792 : C-c C-e d process to PDF, and open the file.
1795 - \usepackage{graphicx} is now part of the standard class
1797 - Several bugs fixed, but definitely not all of them :-(
1799 *** New option `org-log-state-notes-insert-after-drawers'
1801 Set this to =t= if you want state change notes to be inserted
1802 after any initial drawers, i.e drawers the immediately follow
1803 the headline and the planning line (the one with
1804 DEADLINE/SCHEDULED/CLOSED information).
1808 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1812 *** =org-file-apps= now uses regular repressions instead of extensions
1813 Just like in =auto-mode-alist=, car's in the variable
1814 =org-file-apps= that are strings are now interpreted as
1815 regular expressions that are matched against a file name. So
1816 instead of "txt", you should now write "\\.txt\\'" to make
1817 sure the matching is done correctly (even though "txt" will
1818 be recognized and still be interpreted as an extension).
1820 There is now a shortcut to get many file types visited by
1821 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
1822 any files that are matched by `auto-mode-alist' will be
1825 *** Changes to the attachment system
1827 - The default method to attach a file is now to copy it
1828 instead of moving it.
1829 - You can modify the default method using the variable
1830 `org-attach-method'. I believe that most Unix people want
1831 to set it to `ln' to create hard links.
1832 - The keys =c=, =m=, and =l= specifically select =copy=,
1833 =move=, or =link=, respectively, as the attachment method
1834 for a file, overruling `org-attach-method'.
1835 - To create a new attachment as an Emacs buffer, you have not
1836 now use =n= instead of =c=.
1837 - The file list is now always retrieved from the directory
1838 itself, not from the "Attachments" property. We still
1839 keep this property by default, but you can turn it off, by
1840 customizing the variable =org-attach-file-list-property=.
1844 ** Incompatible changes
1846 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
1848 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
1852 *** The default structure of IDs has changed
1854 IDs created by Org have changed a bit:
1855 - By default, there is no prefix on the ID. There used to be
1856 an "Org" prefix, but I now think this is not necessary.
1857 - IDs use only lower-case letters, no upper-case letters
1858 anymore. The reason for this is that IDs are now also used
1859 as directory names for org-attach, and some systems do not
1860 distinguish upper and lower case in the file system.
1861 - The ID string derived from the current time is now
1862 /reversed/ to become an ID. This assures that the first
1863 two letters of the ID change fast, so hat it makes sense to
1864 split them off to create subdirectories to balance load.
1865 - You can now set the `org-id-method' to `uuidgen' on systems
1868 *** =C-c C-a= no longer calls `show-all'
1870 The reason for this is that =C-c C-a= is now used for the
1871 attachment system. On the rare occasions that this command
1872 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
1874 *** New attachment system
1876 You can now attach files to each node in the outline tree.
1877 This works by creating special directories based on the ID of
1878 an entry, and storing files in these directories. Org can
1879 keep track of changes to the attachments by automatically
1880 committing changes to git. See the manual for more
1883 Thanks to John Wiegley who contributed this fantastic new
1884 concept and wrote org-attach.el to implement it.
1886 *** New remember template escapes
1888 : %^{prop}p to insert a property
1889 : %k the heading of the item currently being clocked
1890 : %K a link to the heading of the item currently being clocked
1892 Also, when you exit remember with =C-2 C-c C-c=, the item
1893 will be filed as a child of the item currently being
1894 clocked. So the idea is, if you are working on something and
1895 think of a new task related to this or a new note to be
1896 added, you can use this to quickly add information to that
1899 Thanks to James TD Smith for a patch to this effect.
1901 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
1903 Thanks to James TD Smith for a patch to this effect.
1905 *** New file in contrib: lisp/org-checklist.el
1907 This module deals with repeated tasks that have checkbox
1910 Thanks to James TD Smith for this contribution.
1912 *** New in-buffer setting #+STYLE
1914 It can be used to locally set the variable
1915 `org-export-html-style-extra'. Several such lines are
1916 allowed-, they will all be concatenated. For an example on
1917 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1923 - Filtering existing agenda views with respect to a tag
1924 - Editing fixed-width regions with picture or artist mode
1925 - /org-plot.el/ is now part of Org
1926 - Tags can be used to select the export part of a document
1927 - Prefix interpretation when storing remember notes
1928 - Yanking inserts folded subtrees
1929 - Column view capture tables can have formulas, plotting info
1930 - In column view, date stamps can be changed with S-cursor keys
1931 - The note buffer for clocking out now mentions the task
1932 - Sorting entries alphabetically ignores TODO keyword and priority
1933 - Agenda views can sort entries by TODO state
1934 - New face =org-scheduled= for entries scheduled in the future.
1935 - Remember templates for gnus links can use the :to escape.
1936 - The file specification in a remember template may be a function
1937 - Categories in iCalendar export include local tags
1938 - It is possible to define filters for column view
1939 - Disabling integer increment during table Field copy
1940 - Capturing column view is on `C-c C-x i'
1941 - And tons of bugs fixed.
1944 ** Incompatible changes
1946 *** Prefix interpretation when storing remember notes has changed
1948 The prefix argument to the `C-c C-c' command that finishes a
1949 remember process is now interpreted differently:
1951 : C-c C-c Store the note to predefined file and headline
1952 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1953 : in its new location.
1954 : C-1 C-c C-c Select the storage location interactively
1955 : C-0 C-c C-c Re-use the last used location
1957 This was requested by John Wiegley.
1959 *** Capturing column view is now on `C-c C-x i'
1961 The reason for this change was that `C-c C-x r' is also used
1962 as a tty key replacement.
1964 *** Categories in iCalendar export now include local tags
1966 The locally defined tags are now listed as categories when
1967 exporting to iCalendar format. Org's traditional file/tree
1968 category is now the last category in this list. Configure
1969 the variable =org-icalendar-categories= to modify or revert
1972 This was a request by Charles Philip Chan.
1976 *** Secondary filtering of agenda views.
1978 You can now easily and interactively filter an existing
1979 agenda view with respect to a tag. This command is executed
1980 with the =/= key in the agenda. You will be prompted for a
1981 tag selection key, and all entries that do not contain or
1982 inherit the corresponding tag will be hidden. With a prefix
1983 argument, the opposite filter is applied: entries that
1984 do have the tag will be hidden.
1986 This operation only /hides/ lines in the agenda buffer, it
1987 does not remove them. Changing the secondary filtering does
1988 not require a new search and is very fast.
1990 If you press TAB at the tag selection prompt, you will be
1991 switched to a completion interface to select a tag. This is
1992 useful when you want to select a tag that does not have a
1993 direct access character.
1995 A double =/ /= will restore the original agenda view by
1996 unhiding any hidden lines.
1998 This functionality was John Wiegley's idea. It is a simpler
1999 implementation of some of the query-editing features proposed
2000 and implemented some time ago by Christopher League (see the
2001 file contrib/lisp/org-interactive-query.el).
2003 *** Editing fixed-width regions with picture or artist mode
2005 The command @<code>C-c '@</code> (that is =C-c= followed by a
2006 single quote) can now also be used to switch to a special
2007 editing mode for fixed-width sections. The default mode is
2008 =artist-mode= which allows you to create ASCII drawings.
2010 It works like this: Enter the editing mode with
2011 @<code>C-c '@</code>. An indirect buffer will be created and
2012 narrowed to the fixed-width region. Edit the drawing, and
2013 press @<code>C-c '@</code> again to exit.
2015 Lines in a fixed-width region should be preceded by a colon
2016 followed by at least one space. These will be removed during
2017 editing, and then added back when you exit the editing mode.
2019 Using the command in an empty line will create a new
2022 This new feature arose from a discussion involving Scott
2023 Otterson, Sebastian Rose and Will Henney.
2025 *** /org-plot.el/ is now part of Org.
2027 You can run it by simple calling org-plot/gnuplot.
2028 Documentation is not yet included with Org, please refer to
2029 http://github.com/eschulte/org-plot/tree/master until we have
2030 moved the docs into Org or Worg.
2032 Thanks to Eric Schulte for this great contribution.
2034 *** Tags can be used to select the export part of a document
2036 You may now use tags to select parts of a document for
2037 inclusion into the export, and to exclude other parts. This
2038 behavior is governed by two new variables:
2039 =org-export-select-tags= and =org-export-exclude-tags=.
2040 These default to =("export")= and =("noexport")=, but can be
2041 changed, even to include a list of several tags.
2043 Org first checks if any of the /select/ tags is present in
2044 the buffer. If yes, all trees that do not carry one of these
2045 tags will be excluded. If a selected tree is a subtree, the
2046 heading hierarchy above it will also be selected for export,
2047 but not the text below those headings. If none of the select
2048 tags is found anywhere in the buffer, the whole buffer will
2049 be selected for export. Finally, all subtrees that are
2050 marked by any of the /exclude/ tags will be removed from the
2053 You may set these tags with in-buffer options
2054 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
2056 I love this feature. Thanks to Richard G Riley for coming
2059 *** Prefix interpretation when storing remember notes
2061 The prefix argument to the `C-c C-c' command that finishes a
2062 remember process is now interpreted differently:
2064 : C-c C-c Store the note to predefined file and headline
2065 : C-u C-c C-c Like C-c C-c, but immediately visit the note
2066 : in its new location.
2067 : C-1 C-c C-c Select the storage location interactively
2068 : C-0 C-c C-c Re-use the last used location
2070 This was requested by John Wiegley.
2072 *** Yanking inserts folded subtrees
2074 If the kill is a subtree or a sequence of subtrees, yanking
2075 them with =C-y= will leave all the subtrees in a folded
2076 state. This basically means, that kill and yank are now
2077 much more useful in moving stuff around in your outline. If
2078 you do not like this, customize the variable
2079 =org-yank-folded-subtrees=.
2081 Right now, I am only binding =C-y= to this new function,
2082 should I modify all bindings of yank? Do we need to amend
2085 This feature was requested by John Wiegley.
2087 *** Column view capture tables can have formulas, plotting info
2089 If you attach formulas and plotting instructions to a table
2090 capturing column view, these extra lines will now survive an
2091 update of the column view capture, and any formulas will be
2092 re-applied to the captured table. This works by keeping any
2093 continuous block of comments before and after the actual
2096 *** In column view, date stamps can be changed with S-cursor keys
2098 If a property value is a time stamp, S-left and S-right can
2099 now be used to shift this date around while in column view.
2101 This was a request by Chris Randle.
2103 *** The note buffer for clocking out now mentions the task
2105 This was a request by Peter Frings.
2107 *** Sorting entries alphabetically ignores TODO keyword and priority
2109 Numerical and alphanumerical sorting now skips any TODO
2110 keyword or priority cookie when constructing the comparison
2111 string. This was a request by Wanrong Lin.
2113 *** Agenda views can sort entries by TODO state
2115 You can now define a sorting strategy for agenda entries that
2116 does look at the TODO state of the entries. Sorting by TODO
2117 entry does first separate the non-done from the done states.
2118 Within each class, the entries are sorted not alphabetically,
2119 but in definition order. So if you have a sequence of TODO
2120 entries defined, the entries will be sorted according to the
2121 position of the keyword in this sequence.
2123 This follows an idea and sample implementation by Christian
2126 *** New face =org-scheduled= for entries scheduled in the future.
2128 This was a request by Richard G Riley.
2130 *** Remember templates for gnus links can now use the :to escape.
2132 Thanks to Tommy Lindgren for a patch to this effect.
2133 *** The file specification in a remember template may now be a function
2135 Thanks to Gregory Sullivan for a patch to this effect.
2137 *** Categories in iCalendar export now include local tags
2139 The locally defined tags are now listed as categories when
2140 exporting to iCalendar format. Org's traditional file/tree
2141 category is now the last category in this list. Configure
2142 the variable =org-icalendar-categories= to modify or revert
2145 This was a request by Charles Philip Chan.
2147 *** It is now possible to define filters for column view
2149 The filter can modify the value that will be displayed in a
2150 column, for example it can cut out a part of a time stamp.
2151 For more information, look at the variable
2152 =org-columns-modify-value-for-display-function=.
2154 *** Disabling integer increment during table field copy
2156 Prefix arg 0 to S-RET does the trick.
2158 This was a request by Chris Randle.
2163 For older Changes, see [[file:Changes_old.org]]