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
21 *** Tag searches are now case-sensitive
23 From this release on, tag searches will be case sensitive. While
24 I still think it would be nice to have them case-insensitive,
25 this was both an inconsistency (TODO keyword searches have always
26 been case-sensitive), and trouble for coding some efficient
27 algorithms. So please make sure that you give the tags with
28 correct casing when prompted for a match expression.
30 *** New key for creating tags/property sparse trees
32 The key to produce a sparse tree matching tags and properties is
33 now =C-c / m= instead of =C-c a T=. This is also more consistent
34 with the =C-c a m= key for the corresponding agenda view.
35 =C-c / T= will still work for now, but it is no longer advertised
36 in the documentation and may go away at any time in the future.
38 *** IDs in HTML have "ID-" prefix when generated by uuidgen
40 /uuidgen/ generates IDs that often start with a number, not a
41 latter. However, IDs and names in XHTML must start with a letter.
42 Therefore, IDs in HTML files will now get an "ID-" prefix if they
43 have been generated by uuidgen. This means that id links from one
44 file to another may stop working until all files have been
47 *** In agenda, only priority cookies get the special face
49 So far, an entire task would get a special face when
50 =org-agenda-fontify-priorities= was set. Now, the default value
51 for this variable is the symbol =cookies=, which means that on
52 the cookie is fontified. Set it to =t= if you want the entire
53 task headline to be fontified.
57 *** PDF export of agenda views
59 Agenda views can now be exported to PDF files by writing them to
60 a file with extension ".pdf". Internally this works by first
61 producing the postscript version and then converting that to PDF
62 using the ghostview utility =ps2pdf=. Make sure that this
63 utility is installed on your system.
65 The postscript version will not be removed, it will stay around.
67 *** Inline some entry text for Agenda View export
69 When exporting an agenda view to HTML or PDF for printing or
70 remote access, one of the problems can be that information stored
71 in entries below the headline is not accessible in that format.
73 You can now copy some of that information to the agenda view
74 before exporting it. For this you need to set the variable
75 =org-agenda-add-entry-text-maxlines= to a number greater than 0.
77 #+begin_src emacs-lisp
78 (setq org-agenda-add-entry-text-maxlines 20)
81 Or you can do this with the settings in a custom agenda view,
84 #+begin_src emacs-lisp
87 (org-agenda-add-entry-text-maxlines 5))
91 *** Improved ASCII export of links
93 ASCII export of links works now much better. If a link has a
94 link and a description part which are different, then the
95 description will remain in the text while the link part will be
96 moved to the end of the current section, before the next heading,
97 as a footnote-like construct.
99 Configure the variable =org-export-ascii-links-to-notes= if you
100 prefer the links to be shown in the text. In this case, Org will
101 make an attempt to wrap the line which may have become
102 significantly longer by showing the link.
104 Thanks to Samuel Wales for pointing out the bad state of ASCII
107 *** Custom agenda commands can specify a filter preset
109 If a custom agenda command specifies a value for
110 =org-agenda-filter-preset= in its options, the initial view of
111 the agenda will be filterd by the specified tags. Applying a
112 filter with =/= will then always add to that preset filter,
113 clearing the filter with =/ /= will set it back to the preset.
114 Here is an example of a custom agenda view that will display the
115 agenda, but hide all entries with tags =FLUFF= or =BLUFF=:
117 #+begin_src emacs-lisp
119 ((org-agenda-filter-preset '("-FLUFF" "-BLUFF"))))
122 This is in response to a [[http://thread.gmane.org/gmane.emacs.orgmode/11752][thread on the mailing list]], started by
123 Daniel Clemente and with great contributions by Bernt Hansen and
126 *** Exporting of citations to LaTeX and HTML, using BibTeX
128 Citations can now me made using BibTeX, and will be exported to
129 LaTeX and HTML. This is implemented in a contributed package by
130 Taru Karttunen, /org-exp-bibtex.el/. Kudos to Taru for this
131 really nice addition.
133 *** org-collector.el is now a contributed package
135 /org-collector.el/ provides functions to create tables by by
136 collecting and processing properties collected from entries in a
137 specific scope like the current tree or file, or even from all
138 agenda files. General lisp expressions can be used to manipulate
139 the property values before they are inserted into an org-mode
140 table, for example as a dynamic block.
142 Thanks to Eric Schulte for yet another great contribution to
145 *** Update of org2rem.el
147 /org2rem.el/ has been updated significantly and now does a more
148 comprehensive job of exporting Org events to remind.
150 Thanks to Sharad Pratap for this update.
152 *** New div around the entire page in HTMP export
154 A new =<div id=content>= is wrapped around the entire page,
155 everything that is inside =<body>=.
157 This means that you need to update /org-info.js/ (if you have a
158 local copy). It will be safe todo so, because the new
159 org-info.js still handles older pages correctly. Thanks to
160 Sebastian Rose for making these changes so quicky.
162 *** Clustering characters for undo
164 When typing in Org-mode, undo will now remove up to 20 characters
165 at a time with a single undo command. This is how things work
166 normally in Emacs, but the special binding of characters in
167 Org-mode made this impossible until now.
169 Thanks to Martin Pohlack for a patch which mimicks the behavior
170 of the Emacs command loop for the Org version of
171 =self-insert-command=. Note that this will not work in headlines
172 and tables because typing there will do a lot of extra work.
174 There might be a small typing performance hit resulting from this
175 change - please report in the mailing list if this is noticeable
178 *** Separate settings for special C-a and C-e
180 The variable `org-special-ctrl-a/e' now allows separate settings
181 for =C-a= and =C-e=. For example
183 #+begin_src emacs-lisp
184 (setq org-special-ctrl-a/e '(reversed . t))
187 Thanks to Alan Davis for this proposal.
189 *** orgstruct++-mode improvements
191 In addition to =orgstruct-mode= which allows to use some Org-mode
192 structure commands in other major modes, there is a more invasive
193 version of this mode: =orgstruct++-mode=. This mode will import
194 all paragraph and line wrapping variables into the major mode, so
195 that, for example, during typing the auto-fill wrapping of items
196 will work just like in Org-mode. This change is not reversible,
197 so turning off =orgstruct++-mode= will not remove these settings
198 again. =orgstruct++-mode= is most useful in text modes like
199 message-mode or =magit-log-edit-mode=. Furthermore,
200 =orgstruct++-mode= will recognize plain list context not only in
201 the first line of an item, but also further down, so that =M-RET=
202 will correctly insert new items.
204 Thanks to Austin Frank for requesting some of these changes.
206 *** Promotion and demotion works for regions now
208 =M-right= and =M-left= now do demote and promote all headlines in
211 *** Match syntax for tags/properties is now described in a single place
213 The manual chapters about tags and about properties now only
214 refer to the section about agenda views, where the general syntax
215 of tag/property matches is described.
217 *** Macro replacement
219 A string like ={{{ title }}}= will be replaced by the title of
220 the document, ={{{ email }}}= by the email setting of the author
221 and similarly for other export settings given in =#+...= lines.
222 In addition to that, you can define an arbitrary number of
226 ,#+MACRO: myaddress 41 Onestreet, 12345 New York, NY
228 ,my address is {{{myaddress}}}, see you there.
231 Macro replacement is the very first thing that happens during
232 export, and macros will be replaced even in source code and other
235 *** New reload command, with keyboard access
237 There is now a special command to reload all Org Lisp files, so
238 that you can stay in your Emacs session while pulling and
239 compiling changes to Org. The command to reload the compiled
240 files (if available) is =C-c C-x r=. If no compiled files are
241 found, uncompiled ones will be loaded. If you want to force
242 loading of uncompiled code (great for producing backtraces), use
243 a prefix arg: =C-u C-c C-x r=. Both commands are available in
246 This new command was inspired by one written earlier by Bernt
249 *** Faces for priority cookies can now be set freely
251 The new variable =org-priority-faces= can be used to set faces
254 *** New key for creating tags/property sparse trees
256 The key to produce a sparse tree matching tags and properties is
257 now =C-c / m= instead of =C-c a T=. This is more consistent with
258 the =C-c a m= key for the corresponding agenda view. =C-c / T=
259 will still work for now, but it is no longer advertised in the
260 documentation and may go away at any time in the future.
262 *** IDs in HTML have "ID-" prefix when generated by uuidgen
264 /uuidgen/ generates IDs that often start with a number, not a
265 letter. However, IDs and names in XHTML must start with a letter.
266 Therefore, IDs in HTML files will now get an "ID-" prefix if they
267 have been generated by /uuidgen/. This means that id links from one
268 file to another may stop working until all files have been
269 exported again, so that both links and targets have the new prefix.
271 *** In agenda, only priority cookies get the special face
273 So far, an entire task would get a special face when
274 =org-agenda-fontify-priorities= was set. Now, the default value
275 for this variable is the symbol =cookies=, which means that on
276 the cookie is fontified. Set it to =t= if you want the entire
277 task headline to be fontified.
279 *** Turning off time-of-day search in headline
281 Some people like to put a creation time stamp into a headline and
282 then get confused if the time-of-day found in there shows up as
283 the time-of-day of the deadline/scheduling entry for this
284 headline. The reason for this is that Org searches the headline
285 for a free-format time when trying to sort the entry into the
286 agenda, and that search accidentally finds the time in the
287 creation time stamp or something else that happens to look like a
288 time. If this is more painful than useful for you, configure the
289 new variable =org-agenda-search-headline-for-time=.
295 - Capture state change notes into a drawer
296 - Clock lines are now captured into the LOGBOOK drawer as well
297 - Added org-R.el to contrib directory
298 - Allow individual formatting of each TODO keyword in HTML export
299 - New hooks for add-ons to tap into context-sensitive commands
300 - Publishing files irrespective of extension
301 - New variable index in the manual
302 - The ORDERED property also influences checkboxes
303 - The ORDERED property can be tracked with a tag
304 - You may now specify line breaks in the fast tags interface
305 - When a TODO is blocked by checkboxes, keep it visible in agenda
306 - LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc.
308 ** Incompatible changes
310 - CLOCK lines will now be captured into the LOGBOOK drawer.
311 See below for details.
315 *** Capture state change notes into a drawer
317 State change notes can now be captured into a drawer =LOGBOOK=,
318 to keep the entry tidy. If this is what you want, you will need
321 #+begin_src emacs-lisp
322 (setq org-log-into-drawer "LOGBOOK")
325 Thanks to Wanrong Lin for this proposal.
327 *** Clock lines are now captured into the LOGBOOK drawer as well
329 The =CLOCK= drawer will be abandoned, clock lines will now also
330 end up in a drawer =LOGBOOK=. The reason for this is that it's a
331 bit useless to have two different drawers for state change notes
332 and clock lines. If you wish to keep the old way, use
334 #+begin_src emacs-lisp
335 (setq org-clock-into-drawer "CLOCK")
338 *** Added org-R.el to contrib directory
340 Dan Davison has contributed /org-R.el/ which is now in the
341 contrib directory. Org-R performs numerical computations and
342 generates graphics. Data can come from org tables, or from csv
343 files; numerical output can be stored in the org buffer as org
344 tables, and links are created to files containing graphical
345 output. Although, behind the scenes, it uses R, you do not need
346 to know anything about R. Common operations, such as tabulating
347 discrete values in a column of an org table, are available "off
348 the shelf" by specifying options on lines starting with =#+R:=.
349 However, you can also provide raw R code to be evaluated. The
350 documentation is currently the worg tutorial at
351 http://orgmode.org/worg/org-tutorials/org-R/org-R.php
353 Thanks to Dan for this great contribution.
355 *** Allow individual formatting of TODO keyword and tags in HTML export
357 TODO keywords in HTML export have the CSS class =todo= or =done=.
358 Tags have the CSS class =tag=. In addition to this, each keyword
359 has now itself as class, so you could do this in your CSS file:
362 .todo { font-weight:bold; }
363 .done { font-weight:bold; }
365 .WAITING { color:orange; }
366 .DONE { color:green; }
369 If any of your keywords causes conflicts with CSS classes used
370 for different purposes (for example a tag "title" would cause a
371 conflict with the class used for formatting the document title),
372 then you can use the variables =org-export-html-tag-class-prefix=
373 and =org-export-html-todo-kwd-class-prefix= to define prefixes
374 for the class names for keywords, for example "kwd-".
376 Thanks to Wanrong Lin for this request, and to Sebastian Rose for
377 help with the implementation.
379 *** New hooks for add-ons to tap into context-sensitive commands
381 Some commands in Org are context-sensitive, they will execute
382 different functions depending on context. The most important
383 example is of course =C-c C-c=, but also the =M-cursor= keys fall
386 Org has now a system of hooks that can be used by add-on packages
387 to install their own functionality into these keys. See the
388 docstring of =org-ctrl-c-ctrl-c-hook= for details. The other
389 hooks are named like =org-metaleft-hook= or
390 =org-shiftmetaright-hook=.
392 *** Publishing files irrespective of extension
394 If you set the =:base-extension= property for a publishing
395 project to the symbol =any=, all files in the directory will be
396 published, irrespective of extension.
398 Thanks to Richard Klinda for a patch to this effect.
400 *** New variable index in the manual
402 A new index in the manual lists all variables mentioned in the
403 manual, about 200 variables in total.
405 *** The ORDERED property also influences checkboxes
407 When an entry has the ORDERED property set, checkboxes in
408 the entry must be completed in order. This was already the case
409 for children TODO items, now it also applies for checkboxes.
411 Thanks to Rainer Stengele for this proposal.
413 *** The ORDERED property can be tracked with a tag
415 The =ORDERED= property is used to flag an entry so that subtasks
416 (both children TODO items and checkboxes) must be completed in
417 order. This property is most easily toggled with the command
418 =C-c C-x o=. A property was chosen for this functionality,
419 because this should be a behavior local to the current task, not
420 inherited like tags. However, properties are normally
421 invisible. If you would like visual feedback on the state of
422 this property, configure the variable
423 =org-track-ordered-property-with-tag=. If you then use =C-c C-x
424 o= to toggle the property, a tag will be toggled as well, for
427 Note that the tag itself has no meaning for the behavior of TODO
428 items and checkboxes, and that changing the tag with the usual
429 tag commands will not influence the property and therefore the
430 behavior of TODO and checkbox commands.
432 *** You may now specify line breaks in the fast tags interface
434 Up to now, the fast tags interface tried to lump as many tags as
435 possible into a single line, with the exception that groups would
436 always be on a line by themselves.
438 Now, if you use several lines to define your tags, like
441 ,#+TAGS: aa(a) bb(b) cc(c)
442 ,#+TAGS: dd(d) ee(e) ff(f)
445 then there will also be a line break after the "cc" tag in the
446 fast tag selection interface. You may also write
449 ,#+TAGS: aa(a) bb(b) cc(c) \n dd(d) ee(e) ff(f)
452 to achieve the same effect, and you can use =\n= several times in
453 order to produce empty lines. In =org-tag-alist=, newlines are
454 represented as =(:newline)=.
456 Thanks to Christopher Suckling for a patch to this effect.
458 *** When a TODO is blocked by checkboxes, keep it visible in agenda
460 When the variable =org-agenda-dim-blocked-tasks= is set to
461 =invisible=, tasks that are blocked will not be visible in the
462 agenda. If the blocking is due to child TODO entries, this does
463 make sense because the children themselves will show up in the
466 However, as John Rakestraw has [[http://thread.gmane.org/gmane.emacs.orgmode/10939][pointed out]], if the blocking is
467 done by checkboxes, no trace of these subtasks is left.
468 Therefore, when the blocking is done by checkboxes, we now
469 overrule the =invisible= setting and replace it with mere dimming
472 *** LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc.
474 If you configure =org-export-latex-import-inbuffer-stuff=,
475 in-buffer definitions like #+TITLE will be made available in the
476 LaTeX file as =\orgTITLE=.
478 This was a request by Russel Adams.
483 *** org-choose.el by Tom Breton is now included
485 Org-choose helps documenting a decision-making process by using
486 TODO keywords for different degrees of /chosenness/, and by
487 automatically keeping a set of alternatives in a consistent state.
489 Documentation for /org-choose.el/ is available [[http://orgmode.org/worg/org-contrib/org-choose.php][here]].
491 This package inserts itself into Org using hooks, so if other
492 people would like to do interesting stuff with TODO keywords for
493 special purposes, looking at Tom's code might be a good way to
496 Thanks to Tom for this interesting contribution!
498 *** orgmode.org and Worg css works now better on IE
500 Thanks to Sebastian Rose for making these changes.
502 *** When exporting a subtree, headline levels are now relative to parent
504 This was reported as a bug by William Henney and is fixed now.
506 *** Inactive dates in tables can be used for sorting.
508 When sorting table fields or entries by date, Org first tries to
509 find an active date, and, if none exist, uses a passive date if
512 This was a request by Hsui-Khuen Tang
514 *** The default for =org-return-follows-link= is back to =nil=
516 Setting it to =t= violates Emacs rules to some extent. The
517 internal implementation of this has been improved, so setting it
518 to =t= should now be pretty stable.
520 *** Automatic scheduling of siblings with org-depend.el
522 The sibling of a DONE task can now automatically be scheduled.
524 This was a patch by Andrew Hyatt.
526 *** New skipping conditions
528 The functions =org-agenda-skip-entry-if= and
529 =org-agenda-skip-subtree-if= now accept =timestamp= and
530 =nottimestamp= as additional conditions.
532 This was in response to a request by Saurabh Agrawal.
538 *** Changes to some default values of variables:
540 Here are the new default values:
543 (setq org-return-follows-link t)
545 (setq org-use-fast-todo-selection t)
547 (setq org-yank-adjusted-subtrees nil)
549 (setq org-tags-column -77)
551 (setq org-agenda-sorting-strategy
552 '((agenda time-up priority-down category-keep)
553 (todo time-up priority-down category-keep)
554 (tags time-up priority-down category-keep)
555 (search category-keep)))
558 *** Final cleanup for Emacs 21.1 pretest
564 *** Support for simple TODO dependencies
566 John Wiegley's code for enforcing simple TODO dependencies has
567 been integrated into Org-mode. Thanks John!
569 The structure of Org files (hierarchy and lists) makes it easy to
570 define TODO dependencies. A parent TODO task should not be
571 marked DONE until all subtasks (defined as children tasks) are
572 marked as DONE. And sometimes there is a logical sequence to a
573 number of (sub)tasks, so that one task cannot be acted upon
574 before all siblings above it are done. If you customize the
575 variable =org-enforce-todo-dependencies=, Org will block entries
576 from changing state while they have children that are not DONE.
577 Furthermore, if an entry has a property =ORDERED=, each of its
578 children will be blocked until all earlier siblings are marked
579 DONE. Here is an example:
582 ,* TODO Blocked until (two) is done
591 ,** TODO b, needs to wait for (a)
592 ,** TODO c, needs to wait for (a) and (b)
595 The command =C-c C-x o= toggles the value of the =ORDERED=
598 The variable =org-agenda-dim-blocked-tasks= controls how blocked
599 entries should appear in the agenda, where they can be dimmed or
602 Furthermore, you can use the variable
603 =org-enforce-todo-checkbox-dependencies= to block TODO entries
604 from switching to DONE while any checkboxes are unchecked in the entry.
606 *** Support for shift-selection in Emacs 23
608 Customize the variable =org-support-shift-select= to use S-cursor
609 key for selecting text. Make sure that you carefully read the
610 docstring of that variable first.
612 *** Adding and removing checkboxes from many lines
614 The command =C-c C-x C-b= normally toggles checkbox status in the
615 current line, or in all lines in the region. With prefix
616 argument it now either adds or removes the checkbox.
618 This was a requested by Daniel Clemente.
624 - Improved behavior of conversion commands =C-c -= and =C-c *=
625 - Table formulas may now reference fields in other tables
626 - A final hline is imagined in each table, for the sake of references
627 - A tags-todo search can now ignore timestamped items
628 - =\par= can be used to force a paragraph break, also in footnotes
633 *** Improved behavior of conversion commands =C-c -= and =C-c *=
635 The conversion commands =C-c -= and =C-c *= are now better
636 behaved and therefore more useful, I hope.
638 If there is an active region, these commands will act on the
639 region, otherwise on the current line.
641 - C-c - :: This command turns headings or normal lines into
642 items, or items into normal lines. When there is a
643 region, everything depends on the first line of the
645 - if it is a item, turn all items in the region into
647 - if it is a headline, turn all headlines in the region
649 - if it is a normal line, turn all lines into items.
650 - special case: if there is no active region and the
651 current line is an item, cycle the bullet type of the
653 - C-c * :: This command turns items and normal lines into
654 headings, or headings into normal lines. When there is
655 a region, everything depends on the first line of the
657 - if it is a item, turn all items in the region into
659 - if it is a headline, turn all headlines in the region
661 - if it is a normal line, turn all lines into headlines.
663 *** Table formulas may now reference fields in other tables
665 You may now reference constants, fields and ranges from a
666 different table, either in the current file or even in a
667 different file. The syntax is
669 : remote(NAME-OR-ID,REF)
671 where /NAME/ can be the name of a table in the current file as
672 set by a =#+TBLNAME: NAME= line before the table. It can also be
673 the ID of an entry, even in a different file, and the reference
674 then refers to the first table in that entry. /REF/ is an
675 absolute field or range reference, valid in the referenced table.
676 Note that since there is no "current filed" for the remote table,
677 all row and column references must be absolute, not relative.
679 *** A final hline is imagined in each table, for the sake of references
681 Even if a table does not end with a hline (mine never do because I
682 think it is not pretty), for the sake of references you can
683 assume there is one. So in the following table
692 a reference like =@I$1..@II$2= will now work.
694 *** A tags-todo search can now ignore timestamped items
695 The variables =org-agenda-todo-ignore-with-date=,
696 =org-agenda-todo-ignore-with-date=, and
697 =org-agenda-todo-ignore-with-date= make it possible to
698 exclude TODO entries which have this kind of planning info
699 associated with them. This is most useful for people who
700 schedule everything, and who use the TODO list mainly to find
701 things that are not yet scheduled. Thomas Morgan pointed out
702 that also the tags-todo search may serve exactly this
703 purpose, and that it might be good to have a way to make
704 these variables also apply to the tags-todo search. I can
705 see that, but could not convince myself to make this the
706 default. A new variable must be set to make this happen:
707 =org-agenda-tags-todo-honor-ignore-options=.
709 *** =\par= can be used to force a paragraph break, also in footnotes
711 The LaTeX idiom =\par= will insert a paragraph break at that
712 location. Normally you would simply leave an empty line to get
713 such a break, but this is useful for footnotes whose
714 definitions may not contain empty lines.
717 ** Incompatible changes
719 *** Short examples must have a space after the colon
721 Short literal examples can be created by preceding lines
722 with a colon. Such lines must now have a space after the
723 colon. I believe this is already general practice, but now
724 it must be like this. The only exception are lines that are
725 empty except for the colon.
729 *** Include files can now also process switches
731 The example and src switches like =-n= can now also be added
732 to include file statements:
734 : #+INCLUDE "~/.emacs" src emacs-lisp -n -r
736 Thanks to Manish for pointing out that this was not yet
739 *** Examples can be exported to HTML as text areas
741 You can now specify a =-t= switch to an example or src block,
742 to make it export to HTML as a text area. To change the
743 defaults for height (number of lines in the example) and
744 width of this area (80), use the =-h= and =-w= switches.
746 Thanks to Ulf Stegemann for driving this development.
748 *** LaTeX_CLASS can be given as a property
750 When exporting a single subtree by selecting it as a region
751 before export, the LaTeX class for the export will be taken
752 from the =LaTeX_CLASS= property of the entry if present.
754 Thanks to Robert Goldman for this request.
756 *** Better handling of inlined images in different backends
758 Two new variables govern which kind of files can be inlined
759 during export. These are
760 =org-export-html-inline-image-extensions= and
761 =org-export-latex-inline-image-extensions=. Remember that
762 links are turned into an inline image if they are a pure link
763 with no description. HTML files can inline /.png/, /.jpg/,
764 and /.gif/ files, while LaTeX files, when processed with
765 /pdflatex/, can inline /.png/, /.jpg/, and /.pdf/ files.
766 These also represent the default settings for the new
767 variables. Note that this means that pure links to /.pdf/
768 files will be inlined - to avoid this for a particular link,
769 make sure that the link has a description part which is not
770 equal to the link part.
772 *** Links by ID now continue to work in HTML exported files
774 If you make links by ID, these links will now still work in
775 HTML exported files, provided that you keep the relative path
776 from link to target file the same.
778 Thanks to Friedrich Delgado Friedrichs for pushing this over
781 *** The relative timer can be paused
783 The new command `C-c C-x ,' will pause the relative timer.
784 When the relative timer is running, its value will be shown
785 in the mode line. To get rid of this display, you need to
786 really stop the timer with `C-u C-c C-x ,'.
788 Thanks to Alan Davis for driving this change.
790 *** The attachment directory may now be chosen by the user
792 Instead of using the automatic, unique directory related to
793 the entry ID, you can also use a chosen directory for the
794 attachments of an entry. This directory is specified by the
795 ATTACH_DIR property. You can use `C-c C-a s' to set this
798 Thanks to Jason Jackson for this proposal.
800 *** You can use a single attachment directory for a subtree
802 By setting the property ATTACH_DIR_INHERIT, you can now tell
803 Org that children of the entry should use the same directory
804 for attachments, unless a child explicitly defines its own
805 directory with the ATTACH_DIR property. You can use the
806 command `C-c C-a i' to set this property in an entry.
813 - Line numbers and references in literal examples
814 - New hooks for export preprocessing
815 - Capture column view into a different file
821 Org-mode now directly supports the creation of footnotes. In
822 contrast to the /footnote.el/ package, Org-mode's footnotes are
823 designed for work on a larger document, not only for one-off
824 documents like emails. The basic syntax is similar to the one
825 used by /footnote.el/, i.e. a footnote is defined in a paragraph
826 that is started by a footnote marker in square brackets in column
827 0, no indentation allowed. The footnote reference is simply the
828 marker in square brackets inside text. For example:
831 The Org homepage[fn:1] now looks a lot better than it used to.
833 [fn:1] The link is: http://orgmode.org
836 Org-mode extends the number-based syntax to /named/ footnotes and
837 optional inline definition. Using plain numbers as markers is
838 supported for backward compatibility, but not encouraged because
839 of possible conflicts with LaTeX syntax. Here are the valid
842 - [1] :: A plain numeric footnote marker.
844 - [fn:name] :: A named footnote reference, where `name' is a
845 unique label word or, for simplicity of automatic creation,
848 - [fn:: This is the inline definition of this footnote] :: A
849 LaTeX-like anonymous footnote where the definition is given
850 directly at the reference point.
852 - [fn:name: a definition] :: An inline definition of a footnote,
853 which also specifies a name for the note. Since Org allows
854 multiple references to the same note, you can then use use
855 `[fn:name]' to create additional references.
857 Footnote labels can be created automatically, or you create names
858 yourself. This is handled by the variable
859 =org-footnote-auto-label= and its corresponding =#+STARTUP=
860 keywords, see the docstring of that variable for details.
862 The following command handles footnotes:
864 - C-c C-x f :: The footnote action command. When the cursor is
865 on a footnote reference, jump to the definition. When it is
866 at a definition, jump to the (first) reference. Otherwise,
867 create a new footnote. Depending on the variable
868 `org-footnote-define-inline' (with associated =#+STARTUP=
869 options =fninline= and =nofninline=), the definitions will
870 be placed right into the text as part of the reference, or
871 separately into the location determined by the variable
872 =org-footnote-section=.
873 When this command is called with a prefix argument, a menu
874 of additional options is offered:
875 - s :: Sort the footnote definitions by reference sequence.
876 During editing, Org makes no effort to sort footnote
877 definitions into a particular sequence. If you want
878 them sorted, use this command, which will also move
879 entries according to =org-footnote-section=.
880 - n :: Normalize the footnotes by collecting all
881 definitions (including inline definitions) into a
882 special section, and then numbering them in
883 sequence. The references will then also be
884 numbers. This is meant to be the final step before
885 finishing a document (e.g. sending off an email).
886 The exporters do this automatically, and so could
887 something like `message-send-hook'.
888 - d :: Delete the footnote at point, and all references to it.
890 - C-c C-c :: If the cursor is on a footnote reference, jump to
891 the definition. If it is a the definition, jump back to the
892 reference. When called with a prefix argument at either
893 location, offer the same menu as `C-u C-c C-x f'.
895 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
896 corresponding definition/reference, and you can use the
897 usual commands to follow these links.
899 Org-mode's footnote support is designed so that it should also
900 work in buffers that are not in Org-mode, for example in email
901 messages. Just bind =org-footnote-action= to a global key like
904 The main trigger for this development came from a hook function
905 written by Paul Rivier, to implement named footnotes and to
906 convert them to numbered ones before export. Thanks, Paul!
908 Thanks also to Scot Becker for a thoughtful post bringing this
909 subject back onto the discussion table, and to Matt Lundin for
910 the idea of named footnotes and his prompt testing of the new
913 *** Line numbers and references in literal examples
915 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
916 do now allow optional line numbering in the example.
917 Furthermore, links to specific code lines are supported, greatly
918 increasing Org-mode's utility for writing tutorials and other
921 Code references use special labels embedded directly into the
922 source code. Such labels look like "(ref:name)" and must be
923 unique within a document. Org-mode links with "(name)" in the
924 link part will be correctly interpreted, both while working with
925 an Org file (internal links), and while exporting to the
926 different backends. Line numbering and code references are
927 supported for all three major backends, HTML, LaTeX, and ASCII.
928 In the HTML backend, hovering the mouse over a link to a source
929 line will remote-highlight the referenced code line.
931 The options for the BEGIN lines are:
933 - -n :: Number the lines in the example
934 - +n :: Like -n, but continue numbering from where the previous
936 - -r :: Remove the coderef cookies from the example, and replace
937 links to this reference with line numbers. This option
938 takes only effect if either -n or +n are given as well.
939 If -r is not given, coderefs simply use the label name.
940 - -l "fmt" :: Define a local format for coderef labels, see the
941 variable =org-coderef-label-format= for details. Use this
942 of the default syntax causes conflicts with the code in the
943 code snippet you are using.
948 #+begin_src emacs-lisp -n -r
949 (defmacro org-unmodified (&rest body) (ref:def)
950 "Execute body without changing `buffer-modified-p'."
951 `(set-buffer-modified-p (ref:back)
952 (prog1 (buffer-modified-p) ,@body)))
954 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
958 When exported, this is translated to:
959 #+begin_src emacs-lisp -n -r
960 (defmacro org-unmodified (&rest body) (ref:def)
961 "Execute body without changing `buffer-modified-p'."
962 `(set-buffer-modified-p (ref:back)
963 (prog1 (buffer-modified-p) ,@body)))
965 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
968 Thanks to Ilya Shlyakhter for proposing this feature set. Thanks
969 to Sebastian Rose for the key Javascript element that made the
970 remote highlighting possible.
972 *** New hooks for export preprocessing
973 The export preprocessor now runs more hooks, to allow
974 better-timed tweaking by user functions:
976 - =org-export-preprocess-hook= ::
977 Pretty much the first thing in the preprocessor. But org-mode
978 is already active in the preprocessing buffer.
980 - =org-export-preprocess-after-include-files-hook= ::
981 This is run after the contents of included files have been inserted.
983 - =org-export-preprocess-after-tree-selection-hook= ::
984 This is run after selection of trees to be exported has
985 happened. This selection includes tags-based selection, as
986 well as removal of commented and archived trees.
988 - =org-export-preprocess-before-backend-specifics-hook= ::
989 Hook run before backend-specific functions are called during preprocessing.
991 - =org-export-preprocess-final-hook= ::
992 Hook for preprocessing an export buffer. This is run as the
993 last thing in the preprocessing buffer, just before returning
994 the buffer string to the backend.
996 *** Capture column view into a different file
998 The :id parameter for the dynamic block capturing column view
999 can now truly be an ID that will also be found in a
1000 different file. Also, it can be like =file:path/to/file=, to
1001 capture the global column view from a different file.
1003 Thanks to Francois Lagarde for his report that IDs outside
1004 the current file would not work.
1007 Cleanup of many small bugs, and one new feature.
1011 *** References to last table row with special names
1013 Fields in the last row of a table can now be referenced with
1014 $LR1, $LR2, etc. These references can appear both on the
1015 left hand side and right hand side of a formula.
1019 This version reverses the introduction of @0 as a reference to
1020 the last rwo in a table, because of a conflict with the use of
1021 @0 for the current row.
1026 - All known LaTeX export issues fixed
1027 - Captions and attributes for figures and tables.
1028 - Better implementation for entry IDs
1029 - Spreadsheet references to the last table line.
1030 - Old syntax for link attributes abandoned
1032 ** Incompatible changes
1033 *** Old syntax for link attributes abandoned
1035 There used to be a syntax for setting link attributes for
1036 HTML export by enclosing the attributes into double braces
1037 and adding them to the link itself, like
1040 [[./img/a.jpg{{alt="an image"}}] ]
1043 This syntax is not longer supported, use instead
1046 ,#+ATTR_HTML: alt="an image"
1052 *** All known LaTeX export issues fixed
1054 All the remaining issues with the LaTeX exporter have hopefully
1055 been addressed in this release. In particular, this covers
1056 quoting of special characters in tables and problems with
1057 exporting files where the headline is in the first line, or with
1060 *** Captions and attributes for figures and tables.
1062 Tables, and Hyperlinks that represent inlined images, can now be
1063 equipped with additional information that will be used during
1064 export. The information will be taken from the following special
1065 lines in the buffer and apply to the first following table or
1068 - #+CAPTION: :: The caption of the image or table. This string
1069 should be processed according to the export backend, but
1070 this is not yet done.
1072 - #+LABEL: :: A label to identify the figure/table for cross
1073 references. For HTML export, this string will become the
1074 ID for the ~<div class="figure">~ element that encapsulates
1075 the image tag and the caption. For LaTeX export, this
1076 string will be used as the argument of a ~\label{...}~
1077 macro. These labels will be available for internal links
1078 like ~[[label][Table] ]~.
1080 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
1081 added as attributes into the ~<img...>~ tag. This string
1082 will not be processed, so it should have immediately the
1085 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
1087 For /images/, this string is directly inserted into
1088 the optional argument of the ~\includegraphics[...]{file}~
1089 command, to specify scaling, clipping and other options.
1090 This string will not be processed, so it should have
1091 immediately the right format, like =width=5cm,angle=90=.\\
1092 For /tables/, this can currently contain the keyword
1093 =longtable=, to request typesetting of the table using the
1094 longtable package, which automatically distributes the table
1095 over several pages if needed. Also, the attributes line may
1096 contain an alignment string for the tabular environment, like
1097 =longtable,align=l|lrl=
1099 For LaTeX export, if either a caption or a label is given, the element
1100 will be exported as a float, i.e. wrapped into a figure or table
1103 *** Better implementation for entry IDs
1105 Unique identifiers for entries can now be used more efficiently.
1106 Internally, a hash array has replaced the alist used so far to
1107 keep track of the files in which an ID is defined. This makes it
1108 quite fast to find an entry by ID.
1110 There is a new link type which looks like this:
1113 id:GLOBALLY-UNIQUE-IDENTIFIER
1116 This link points to a specific entry. When you move the entry to
1117 a different file, for example if you move it to an archive
1118 file, the link will continue to work.
1120 The file /org-id.el/ contains an API that can be used to write
1121 code using these identifiers, including creating IDs and finding
1122 them wherever they are.
1124 Org has its own method to create unique identifiers, but if the system
1125 has /uuidgen/ command installed (Mac's and Linux systems generally
1126 do), it will be used by default (a change compared to the earlier
1127 implmentation, where you explicitdly had to opt for uuidgen). You can
1128 also select the method by hand, using the variable =org-id-method=.
1130 If the ID system ever gets confused about where a certain ID is, it
1131 initiates a global scan of all agenda files with associated archives,
1132 all files previously known containing any IDs, and all currently
1133 visited Org-mode files to rebuild the hash. You can also initiate
1134 this by hand: =M-x org-id-update-id-locations=. Running this command
1135 will also dump into the =*Messages*= buffer information about any
1136 duplicate IDs. These should not exist, and Org will never /make/ the
1137 same ID twice, but if you /copy/ an entry with its properties,
1138 duplicate IDs will inevitably be produced. Unfortunately, this is
1139 unavoidable in a plain text system that allows you to edit the text in
1140 arbitrary ways, and a portion of care on your side is needed to keep
1143 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
1144 This is also a change from previous versions where the file was
1145 =~/.org=id-locations=. Therefore, you can remove this old file
1146 if you have it. I am not sure what will happen if the =.emacs.d=
1147 directory does not exists in your setup, but in modern Emacsen, I
1148 believe it should exist. If you do not want to use IDs across
1149 files, you can avoid the overhead with tracking IDs by
1150 customizing the variable =org-id-track-globally=. IDs can then
1151 still be used for links inside a single file.
1153 IDs will also be used when you create a new link to an Org-mode
1154 buffer. If you use =org-store-link= (normally at =C-c l=) inside
1155 en entry in an Org-mode buffer, and ID property will be created
1156 if it does not exist, and the stored link will be an =id:= link.
1157 If you prefer the much less secure linking to headline text, you
1158 can configure the variable =org-link-to-org-use-id=. The default
1159 setting for this variable is =create-if-interactive=, meaning
1160 that an ID will be created when you store a link interactively,
1161 but not if you happen to be in an Org-mode file while you create
1162 a remember note (which usually has a link to the place where you
1163 were when starting remember).
1165 *** Spreadsheet references to the last table line.
1167 You may now use =@0= to reference the last dataline in a table
1168 in a stable way. This is useful in particular for automatically
1169 generated tables like the ones using /org-collector.el/ by Eric
1175 - New relative timer to support timed notes
1176 - Special faces can be set for individual tags
1177 - The agenda shows now all tags, including inherited ones.
1178 - Exclude some tags from inheritance.
1179 - More special values for time comparisons in property searches
1180 - Control for exporting meta data
1181 - Cut and Paste with hot links from w3m to Org
1182 - LOCATION can be inherited for iCalendar export
1183 - Relative row references crossing hlines now throw an error
1185 ** Incompatible Changes
1187 *** Relative row references crossing hlines now throw an error
1189 Relative row references in tables look like this: "@-4" which
1190 means the forth row above this one. These row references are
1191 not allowed to cross horizontal separator lines (hlines). So
1192 far, when a row reference violates this policy, Org would
1193 silently choose the field just next to the hline.
1195 Tassilo Horn pointed out that this kind of hidden magic is
1196 actually confusing and may cause incorrect formulas, and I do
1197 agree. Therefore, trying to cross a hline with a relative
1198 reference will now throw an error.
1200 If you need the old behavior, customize the variable
1201 `org-table-error-on-row-ref-crossing-hline'.
1205 *** New relative timer to support timed notes
1207 Org now supports taking timed notes, useful for example while
1208 watching a video, or during a meeting which is also recorded.
1211 Insert a relative time into the buffer. The first time
1212 you use this, the timer will be started. When called
1213 with a prefix argument, the timer is reset to 0.
1216 Insert a description list item with the current relative
1217 time. With a prefix argument, first reset the timer to 0.
1220 Once the time list has been initiated, you can also use the
1221 normal item-creating command to insert the next timer item.
1224 Reset the timer without inserting anything into the buffer.
1225 By default, the timer is reset to 0. When called with a
1226 =C-u= prefix, reset the timer to specific starting
1227 offset. The user is prompted for the offset, with a
1228 default taken from a timer string at point, if any, So this
1229 can be used to restart taking notes after a break in the
1230 process. When called with a double prefix argument
1231 =C-c C-u=, change all timer strings in the active
1232 region by a certain amount. This can be used to fix timer
1233 strings if the timer was not started at exactly the right
1236 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
1237 contributions to this idea.
1239 *** Special faces can be set for individual tags
1241 You may now use the variable =org-tag-faces= to define the
1242 face used for specific tags, much in the same way as you can
1243 do for TODO keywords.
1245 Thanks to Samuel Wales for this proposal.
1247 *** The agenda shows now all tags, including inherited ones.
1249 This request has come up often, most recently it was
1250 formulated by Tassilo Horn.
1252 If you prefer the old behavior of only showing the local
1253 tags, customize the variable =org-agenda-show-inherited-tags=.
1255 *** Exclude some tags from inheritance.
1257 So far, the only way to select tags for inheritance was to
1258 allow it for all tags, or to do a positive selection using
1259 one of the more complex settings for
1260 `org-use-tag-inheritance'. It may actually be better to
1261 allow inheritance for all but a few tags, which was difficult
1262 to achieve with this methodology.
1264 A new option, `org-tags-exclude-from-inheritance', allows to
1265 specify an exclusion list for inherited tags.
1267 *** More special values for time comparisons in property searches
1269 In addition to =<now>=, =<today>=, =<yesterday>=, and
1270 =<tomorrow>=, there are more special values accepted now in
1271 time comparisons in property searches: You may use strings
1272 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
1273 week, month, and year, respectively
1275 Thanks to Linday Todd for this proposal.
1277 *** Control for exporting meta data
1279 All the metadata in a headline, i.e. the TODO keyword, the
1280 priority cookie, and the tags, can now be excluded from
1281 export with appropriate options:
1283 | Variable | Publishing property | OPTIONS switch |
1284 |-------------------------------+---------------------+----------------|
1285 | org-export-with-todo-keywords | :todo-keywords | todo: |
1286 | org-export-with-tags | :tags | tags: |
1287 | org-export-with-priority | :priority | pri: |
1289 *** Cut and Paste with hot links from w3m to Org
1291 You can now use the key =C-c C-x M-w= in a w3m buffer with
1292 HTML content to copy either the region or the entire file in
1293 a special way. When you yank this text back into an Org-mode
1294 buffer, all links from the w3m buffer will continue to work
1297 For this to work you need to load the new file /org-w3m.el./
1298 Please check your org-modules variable to make sure that this
1301 Thanks for Richard Riley for the idea and to Andy Stewart for
1304 *** LOCATION can be inherited for iCalendar export
1306 The LOCATION property can now be inherited during iCalendar
1307 export if you configure =org-use-property-inheritance= like
1310 #+begin_src emacs-lisp
1311 (setq org-use-property-inheritance '("LOCATION"))
1318 - Keybindings in Remember buffers can be configured
1319 - Support for ido completion
1320 - New face for date lines in agenda column view
1321 - Invisible targets become now anchors in headlines.
1322 - New contributed file /org-exp-blocks.el/
1323 - New contributed file /org-eval-light.el/
1325 - BBDB links may use regular expressions.
1326 - Link abbreviations can use %h to insert a url-encoded target value
1327 - Improved XHTML compliance
1331 *** Keybindings in Remember buffers can be configured
1333 The remember buffers created with Org's extensions are in
1334 Org-mode, which is nice to prepare snippets that will
1335 actually be stored in Org-mode files. However, this makes it
1336 hard to configure key bindings without modifying the Org-mode
1337 keymap. There is now a minor mode active in these buffers,
1338 `org-remember-mode', and its keymap org-remember-mode-map can
1339 be used for key bindings. By default, this map only contains
1340 the bindings for =C-c C-c= to store the note, and =C-c C-k=
1341 to abort it. Use `org-remember-mode-hook' to define your own
1344 #+begin_src emacs-lisp
1346 'org-remember-mode-hook
1348 (define-key org-remember-mode-map
1349 "\C-x\C-s" 'org-remember-finalize)))
1352 If you wish, you can also use this to free the =C-c C-c=
1353 binding (by binding this key to nil in the minor mode map),
1354 so that you can use =C-c C-c= again to set tags.
1356 This modification is based on a request by Tim O'Callaghan.
1358 *** Support for ido completion
1360 You can now get the completion interface from /ido.el/ for
1361 many of Org's internal completion commands by turning on the
1362 variable =org-completion-use-ido=. =ido-mode= must also be
1363 active before you can use this.
1365 This change is based upon a request by Samuel Wales.
1367 *** New face for date lines in agenda column view
1369 When column view is active in the agenda, and when you have
1370 summarizing properties, the date lines become normal column
1371 lines and the separation between different days becomes
1372 harder to see. If this bothers you, you can now customize
1373 the face =org-agenda-column-dateline=.
1375 This is based on a request by George Pearson.
1377 *** Invisible targets become now anchors in headlines.
1379 These anchors can be used to jump to a directly with an HTML
1380 link, just like the =sec-xxx= IDs. For example, the
1381 following will make a http link
1382 =//domain/path-to-my-file.html#dummy= work:
1389 This is based on a request by Matt Lundin.
1391 *** New contributed file /org-exp-blocks.el/
1393 This new file implements special export behavior of
1394 user-defined blocks. The currently supported blocks are
1396 - comment :: Comment blocks with author-specific markup
1397 - ditaa :: conversion of ASCII art into pretty png files
1398 using Stathis Sideris' /ditaa.jar/ program
1399 - dot :: creation of graphs in the /dot/ language
1400 - R :: Sweave type exporting using the R program
1402 For more details and examples, see the file commentary in
1403 /org-exp-blocks.el/.
1405 Kudos to Eric Schulte for this new functionality, after
1406 /org-plot.el/ already his second major contribution. Thanks
1407 to Stathis for this excellent program, and for allowing us to
1408 bundle it with Org-mode.
1410 *** New contributed file /org-eval-light.el/
1412 This module gives control over execution Emacs Lisp code
1413 blocks included in a file.
1415 Thanks to Eric Schulte also for this file.
1417 *** Link translation
1419 You can now configure Org to understand many links created
1420 with the Emacs Planner package, so you can cut text from
1421 planner pages and paste them into Org-mode files without
1422 having to re-write the links. Among other things, this means
1423 that the command =org-open-at-point-global= which follows
1424 links not only in Org-mode, but in arbitrary files like
1425 source code files etc, will work also with links created by
1426 planner. The following customization is needed to make all of
1429 #+begin_src emacs-lisp
1430 (setq org-link-translation-function
1431 'org-translate-link-from-planner)
1434 I guess an inverse translator could be written and integrated
1437 *** BBDB links may use regular expressions.
1439 This did work all along, but only now I have documented it.
1441 *** =yank-pop= works again after yanking an outline tree
1443 Samuel Wales had noticed that =org-yank= did mess up this
1444 functionality. Now you can use =yank-pop= again, the only
1445 restriction is that the so-yanked text will not be
1446 pro/demoted or folded.
1448 *** Link abbreviations can use %h to insert a url-encoded target value
1450 Thanks to Steve Purcell for a patch to this effect.
1452 *** Improved XHTML compliance
1454 Thanks to Sebastian Rose for pushing this.
1456 *** Many bug fixes again.
1461 - A region of entries can now be refiled with a single command
1462 - Fine-tuning the behavior of `org-yank'
1463 - Formulas for clocktables
1464 - Better implementation of footnotes for HTML export
1465 - More languages for HTML export.
1469 *** A region of entries can now be refiled with a single command
1471 With =transient-make-mode= active (=zmacs-regions= under
1472 XEmacs), you can now select a region of entries and refile
1473 them all with a single =C-c C-w= command.
1475 Thanks to Samuel Wales for this useful proposal.
1477 *** Fine-tuning the behavior of =org-yank=
1479 The behavior of Org's yanking command has been further
1480 fine-tuned in order to avoid some of the small annoyances
1481 this command caused.
1483 - Calling =org-yank= with a prefix arg will stop any special
1484 treatment and directly pass through to the normal =yank=
1485 command. Therefore, you can now force a normal yank with
1488 - Subtrees will only be folded after a yank if doing so will
1489 now swallow any non-white characters after the yanked text.
1490 This is, I think a really important change to make the
1491 command work more sanely.
1493 *** Formulas for clocktables
1495 You can now add formulas to a clock table, either by hand, or
1496 with a =:formula= parameter. These formulas can be used to
1497 create additional columns with further analysis of the
1500 Thanks to Jurgen Defurne for triggering this addition.
1502 *** Better implementation of footnotes for HTML export
1504 The footnote export in 6.11 really was not good enough. Now
1505 it works fine. If you have customized
1506 =footnote-section-tag=, make sure that your customization is
1507 matched by =footnote-section-tag-regexp=.
1509 Thanks to Sebastian Rose for pushing this change.
1511 *** More languages for HTML export.
1513 More languages are supported during HTML export. This is
1514 only relevant for the few special words Org inserts, like
1515 "Table of Contents", or "Footnotes". Also the encoding
1516 issues with this feature seem to be solved now.
1518 Thanks to Sebastian Rose for pushing me to fix the encoding
1525 - Yanking subtree with =C-y= now adjusts the tree level
1526 - State changes can now be shown in the log mode in the agenda
1527 - Footnote in HTML export are now collected at the end of the document
1528 - HTML export now validates again as XHTML
1529 - The clock can now be resumed after exiting and re-starting Emacs
1530 - Clock-related data can be saved and resumed across Emacs sessions
1531 - Following file links can now use C-u C-u to force use of an external app
1532 - Inserting absolute files names now abbreviates links with "~"
1533 - Links to attachment files
1534 - Completed repeated tasks listed briefly in agenda
1535 - Remove buffers created during publishing are removed
1539 *** Yanking subtree with =C-y= now adjusts the tree level
1540 When yanking a cut/copied subtree or a series of trees, the
1541 normal yank key =C-y= now adjusts the level of the tree to
1542 make it fit into the current outline position, without losing
1543 its identity, and without swallowing other subtrees.
1545 This uses the command =org-past-subtree=. An additional
1546 change in that command has been implemented: Normally, this
1547 command picks the right outline level from the surrounding
1548 *visible* headlines, and uses the smaller one. So if the
1549 cursor is between a level 4 and a level 3 headline, the tree
1550 will be pasted as level 3. If the cursor is actually *at*
1551 the beginning of a headline, the level of that headline will
1552 be used. For example, lets say you have a tree like this:
1558 ,(2)* Level one again
1561 with (1) and (2) indicating possible cursor positions for the
1562 insertion. When at (1), the tree will be pasted as level 2.
1563 When at (2), it will be pasted as level 1.
1565 If you do not want =C-y= to behave like this, configure the
1566 variable =org-yank-adjusted-subtrees=.
1568 Thanks to Samuel Wales for this idea and a partial implementation.
1570 *** State changes can now be shown in the log mode in the agenda
1572 If you configure the variable =org-agenda-log-mode-items=,
1573 you can now request that all logged state changes be included
1574 in the agenda when log mode is active. If you find this too
1575 much for normal applications, you can also temporarily
1576 request the inclusion of state changes by pressing =C-u l= in
1579 This was a request by Hsiu-Khuern Tang.
1581 You can also press `C-u C-u l' to get *only* log items in the
1582 agenda, withour any timestamps/deadlines etc.
1584 *** Footnote in HTML export are now collected at the end of the document
1585 Previously, footnotes would be left in the document where
1586 they are defined, now they are all collected and put into a
1587 special =<div>= at the end of the document.
1589 Thanks to Sebastian Rose for this request.
1591 *** HTML export now validates again as XHTML.
1593 Thanks to Sebastian Rose for pushing this cleanup.
1595 *** The clock can now be resumed after exiting and re-starting Emacs
1597 If the option =org-clock-in-resume= is t, and the first clock
1598 line in an entry is unclosed, clocking into that task resumes
1599 the clock from that time.
1601 Thanks to James TD Smith for a patch to this effect.
1603 *** Clock-related data can be saved and resumed across Emacs sessions
1605 The data saved include the contents of =org-clock-history=,
1606 and the running clock, if there is one.
1608 To use this, you will need to add to your .emacs
1610 #+begin_src emacs-lisp
1611 (setq org-clock-persist t)
1612 (setq org-clock-in-resume t)
1613 (org-clock-persistence-insinuate)
1616 Thanks to James TD Smith for a patch to this effect.
1618 *** Following file links can now use C-u C-u to force use of an external app.
1620 So far you could only bypass your setup in `org-file-apps'
1621 and force opening a file link in Emacs by using a =C-u= prefix arg
1622 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
1623 an external application. Which external application depends
1624 on your system. On Mac OS X and Windows, =open= is used. On
1625 a GNU/Linux system, the mailcap settings are used.
1627 This was a proposal by Samuel Wales.
1629 *** Inserting absolute files names now abbreviates links with "~".
1631 Inserting file links with =C-u C-c C-l= was buggy if the
1632 setting of `org-link-file-path-type' was `adaptive' (the
1633 default). Absolute file paths were not abbreviated relative
1634 to the users home directory. This bug has been fixed.
1636 Thanks to Matt Lundin for the report.
1638 *** Links to attachment files
1640 Even though one of the purposes of entry attachments was to
1641 reduce the number of links in an entry, one might still want
1642 to have the occasional link to one of those files. You can
1643 now use link abbreviations to set up a special link type that
1644 points to attachments in the current entry. Note that such
1645 links will only work from within the same entry that has the
1646 attachment, because the directory path is entry specific.
1647 Here is the setup you need:
1649 #+begin_src emacs-lisp
1650 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
1653 After this, a link like this will work
1656 [[att:some-attached-file.txt]]
1658 This was a proposal by Lindsay Todd.
1660 *** Completed repeated tasks listed briefly in agenda
1662 When a repeating task, listed in the daily/weekly agenda under
1663 today's date, is completed from the agenda, it is listed as
1664 DONE in the agenda until the next update happens. After the
1665 next update, the task will have disappeared, of course,
1666 because the new date is no longer today.
1668 *** Remove buffers created during publishing are removed
1670 Buffers that are created during publishing are now deleted
1671 when the publishing is over. At least I hope it works like this.
1677 - Secondary agenda filtering is becoming a killer feature
1678 - Setting tags has now its own binding, =C-c C-q=
1679 - Todo state changes can trigger tag changes
1680 - C-RET will now always insert a new headline, never an item.
1681 - Customize org-mouse.el feature set to free up mouse events
1682 - New commands for export all the way to PDF (through LaTeX)
1683 - Some bug fixed for LaTeX export, more bugs remain.
1687 *** Enhancements to secondary agenda filtering
1689 This is, I believe, becoming a killer feature. It allows you
1690 to define fewer and more general custom agenda commands, and
1691 then to do the final narrowing to specific tasks you are
1692 looking for very quickly, much faster than calling a new
1695 If you have not tries this yet, you should!
1697 **** You can now refining the current filter by an additional criterion
1698 When filtering an existing agenda view with =/=, you can
1699 now narrow down the existing selection by an additional
1700 condition. Do do this, use =\= instead of =/= to add the
1701 additional criterion. You can also press =+= or =-= after
1702 =/= to add a positive or negative condition. A condition
1703 can be a TAG, or an effort estimate limit, see below.
1705 **** It is now possible to filter for effort estimates
1706 This means to filter the agenda for the value of the Effort
1707 property. For this you should best set up global allowed
1708 values for effort estimates, with
1710 #+begin_src emacs-lisp
1711 (setq org-global-properties
1712 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
1715 You may then select effort limits with single keys in the
1716 filter. It works like this: After =/= or =\=, first select
1717 the operator which you want to use to compare effort
1720 : < Select entries with effort smaller than or equal to the limit
1721 : > Select entries with effort larger than or equal to the limit
1722 : = Select entries with effort equal to the limit
1724 After that, you can press a single digit number which is
1725 used as an index to the allowed effort estimates.
1727 If you do not use digits to fast-select tags, you can even
1728 skip the operator, which will then default to
1729 `org-agenda-filter-effort-default-operator', which is by
1732 Thanks to Manish for the great idea to include fast effort
1733 filtering into the agenda filtering process.
1735 **** The mode line will show the active filter
1736 For example, if there is a filter in place that does select
1737 for HOME tags, against EMAIL tags, and for tasks with an
1738 estimated effort smaller than 30 minutes, the mode-line with
1739 show =+HOME-EMAIL+<0:30=
1741 **** The filter now persists when the agenda view is refreshed
1742 All normal refresh commands, including those that move the
1743 weekly agenda from one week to the next, now keep the
1744 current filter in place.
1746 You need to press =/ /= to turn off the filter. However,
1747 when you run a new agenda command, for example going from
1748 the weekly agenda to the TODO list, the filter will be
1751 *** Setting tags has now its own binding, =C-c C-q=
1753 You can still use =C-c C-c= on a headline, but the new
1754 binding should be considered as the main binding for this
1755 command. The reasons for this change are:
1757 - Using =C-c C-c= for tags is really out of line with other
1760 - I hate it in Remember buffers when I try to set tags and I
1761 cannot, because =C-c C-c= exits the buffer :-(
1763 - =C-c C-q= will also work when the cursor is somewhere down
1764 in the entry, it does not have to be on the headline.
1766 *** Todo state changes can trigger tag changes
1768 The new option =org-todo-state-tags-triggers= can be used to
1769 define automatic changes to tags when a TODO state changes.
1770 For example, the setting
1772 : (setq org-todo-state-tags-triggers
1773 : '((done ("Today" . nil) ("NEXT" . nil))
1774 : ("WAITING" ("Today" . t))))
1776 will make sure that any change to any of the DONE states will
1777 remove tags "Today" and "NEXT", while switching to the
1778 "WAITING" state will trigger the tag "Today" to be added.
1780 I use this mostly to get rid of TODAY and NEXT tags which I
1781 apply to select an entry for execution in the near future,
1782 which I often prefer to specific time scheduling.
1784 *** C-RET will now always insert a new headline, never an item.
1785 The new headline is inserted after the current subtree.
1787 Thanks to Peter Jones for patches to fine-tune this behavior.
1789 *** Customize org-mouse.el feature set
1790 There is a new variable =org-mouse-features= which gives you
1791 some control about what features of org-mouse you want to
1792 use. Turning off some of the feature will free up the
1793 corresponding mouse events, or will avoid activating special
1794 regions for mouse clicks. By default I have urned off the
1795 feature to use drag mouse events to move or promote/demote
1796 entries. You can of course turn them back on if you wish.
1798 This variable may still change in the future, allowing more
1799 fine-grained control.
1801 *** New commands for export to PDF
1803 This is using LaTeX export, and then processes it to PDF
1806 : C-c C-e p process to PDF.
1807 : C-c C-e d process to PDF, and open the file.
1810 - \usepackage{graphicx} is now part of the standard class
1812 - Several bugs fixed, but definitely not all of them :-(
1814 *** New option `org-log-state-notes-insert-after-drawers'
1816 Set this to =t= if you want state change notes to be inserted
1817 after any initial drawers, i.e drawers the immediately follow
1818 the headline and the planning line (the one with
1819 DEADLINE/SCHEDULED/CLOSED information).
1823 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1827 *** =org-file-apps= now uses regular repressions instead of extensions
1828 Just like in =auto-mode-alist=, car's in the variable
1829 =org-file-apps= that are strings are now interpreted as
1830 regular expressions that are matched against a file name. So
1831 instead of "txt", you should now write "\\.txt\\'" to make
1832 sure the matching is done correctly (even though "txt" will
1833 be recognized and still be interpreted as an extension).
1835 There is now a shortcut to get many file types visited by
1836 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
1837 any files that are matched by `auto-mode-alist' will be
1840 *** Changes to the attachment system
1842 - The default method to attach a file is now to copy it
1843 instead of moving it.
1844 - You can modify the default method using the variable
1845 `org-attach-method'. I believe that most Unix people want
1846 to set it to `ln' to create hard links.
1847 - The keys =c=, =m=, and =l= specifically select =copy=,
1848 =move=, or =link=, respectively, as the attachment method
1849 for a file, overruling `org-attach-method'.
1850 - To create a new attachment as an Emacs buffer, you have not
1851 now use =n= instead of =c=.
1852 - The file list is now always retrieved from the directory
1853 itself, not from the "Attachments" property. We still
1854 keep this property by default, but you can turn it off, by
1855 customizing the variable =org-attach-file-list-property=.
1859 ** Incompatible changes
1861 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
1863 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
1867 *** The default structure of IDs has changed
1869 IDs created by Org have changed a bit:
1870 - By default, there is no prefix on the ID. There used to be
1871 an "Org" prefix, but I now think this is not necessary.
1872 - IDs use only lower-case letters, no upper-case letters
1873 anymore. The reason for this is that IDs are now also used
1874 as directory names for org-attach, and some systems do not
1875 distinguish upper and lower case in the file system.
1876 - The ID string derived from the current time is now
1877 /reversed/ to become an ID. This assures that the first
1878 two letters of the ID change fast, so hat it makes sense to
1879 split them off to create subdirectories to balance load.
1880 - You can now set the `org-id-method' to `uuidgen' on systems
1883 *** =C-c C-a= no longer calls `show-all'
1885 The reason for this is that =C-c C-a= is now used for the
1886 attachment system. On the rare occasions that this command
1887 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
1889 *** New attachment system
1891 You can now attach files to each node in the outline tree.
1892 This works by creating special directories based on the ID of
1893 an entry, and storing files in these directories. Org can
1894 keep track of changes to the attachments by automatically
1895 committing changes to git. See the manual for more
1898 Thanks to John Wiegley who contributed this fantastic new
1899 concept and wrote org-attach.el to implement it.
1901 *** New remember template escapes
1903 : %^{prop}p to insert a property
1904 : %k the heading of the item currently being clocked
1905 : %K a link to the heading of the item currently being clocked
1907 Also, when you exit remember with =C-2 C-c C-c=, the item
1908 will be filed as a child of the item currently being
1909 clocked. So the idea is, if you are working on something and
1910 think of a new task related to this or a new note to be
1911 added, you can use this to quickly add information to that
1914 Thanks to James TD Smith for a patch to this effect.
1916 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
1918 Thanks to James TD Smith for a patch to this effect.
1920 *** New file in contrib: lisp/org-checklist.el
1922 This module deals with repeated tasks that have checkbox
1925 Thanks to James TD Smith for this contribution.
1927 *** New in-buffer setting #+STYLE
1929 It can be used to locally set the variable
1930 `org-export-html-style-extra'. Several such lines are
1931 allowed-, they will all be concatenated. For an example on
1932 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1938 - Filtering existing agenda views with respect to a tag
1939 - Editing fixed-width regions with picture or artist mode
1940 - /org-plot.el/ is now part of Org
1941 - Tags can be used to select the export part of a document
1942 - Prefix interpretation when storing remember notes
1943 - Yanking inserts folded subtrees
1944 - Column view capture tables can have formulas, plotting info
1945 - In column view, date stamps can be changed with S-cursor keys
1946 - The note buffer for clocking out now mentions the task
1947 - Sorting entries alphabetically ignores TODO keyword and priority
1948 - Agenda views can sort entries by TODO state
1949 - New face =org-scheduled= for entries scheduled in the future.
1950 - Remember templates for gnus links can use the :to escape.
1951 - The file specification in a remember template may be a function
1952 - Categories in iCalendar export include local tags
1953 - It is possible to define filters for column view
1954 - Disabling integer increment during table Field copy
1955 - Capturing column view is on `C-c C-x i'
1956 - And tons of bugs fixed.
1959 ** Incompatible changes
1961 *** Prefix interpretation when storing remember notes has changed
1963 The prefix argument to the `C-c C-c' command that finishes a
1964 remember process is now interpreted differently:
1966 : C-c C-c Store the note to predefined file and headline
1967 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1968 : in its new location.
1969 : C-1 C-c C-c Select the storage location interactively
1970 : C-0 C-c C-c Re-use the last used location
1972 This was requested by John Wiegley.
1974 *** Capturing column view is now on `C-c C-x i'
1976 The reason for this change was that `C-c C-x r' is also used
1977 as a tty key replacement.
1979 *** Categories in iCalendar export now include local tags
1981 The locally defined tags are now listed as categories when
1982 exporting to iCalendar format. Org's traditional file/tree
1983 category is now the last category in this list. Configure
1984 the variable =org-icalendar-categories= to modify or revert
1987 This was a request by Charles Philip Chan.
1991 *** Secondary filtering of agenda views.
1993 You can now easily and interactively filter an existing
1994 agenda view with respect to a tag. This command is executed
1995 with the =/= key in the agenda. You will be prompted for a
1996 tag selection key, and all entries that do not contain or
1997 inherit the corresponding tag will be hidden. With a prefix
1998 argument, the opposite filter is applied: entries that
1999 do have the tag will be hidden.
2001 This operation only /hides/ lines in the agenda buffer, it
2002 does not remove them. Changing the secondary filtering does
2003 not require a new search and is very fast.
2005 If you press TAB at the tag selection prompt, you will be
2006 switched to a completion interface to select a tag. This is
2007 useful when you want to select a tag that does not have a
2008 direct access character.
2010 A double =/ /= will restore the original agenda view by
2011 unhiding any hidden lines.
2013 This functionality was John Wiegley's idea. It is a simpler
2014 implementation of some of the query-editing features proposed
2015 and implemented some time ago by Christopher League (see the
2016 file contrib/lisp/org-interactive-query.el).
2018 *** Editing fixed-width regions with picture or artist mode
2020 The command @<code>C-c '@</code> (that is =C-c= followed by a
2021 single quote) can now also be used to switch to a special
2022 editing mode for fixed-width sections. The default mode is
2023 =artist-mode= which allows you to create ASCII drawings.
2025 It works like this: Enter the editing mode with
2026 @<code>C-c '@</code>. An indirect buffer will be created and
2027 narrowed to the fixed-width region. Edit the drawing, and
2028 press @<code>C-c '@</code> again to exit.
2030 Lines in a fixed-width region should be preceded by a colon
2031 followed by at least one space. These will be removed during
2032 editing, and then added back when you exit the editing mode.
2034 Using the command in an empty line will create a new
2037 This new feature arose from a discussion involving Scott
2038 Otterson, Sebastian Rose and Will Henney.
2040 *** /org-plot.el/ is now part of Org.
2042 You can run it by simple calling org-plot/gnuplot.
2043 Documentation is not yet included with Org, please refer to
2044 http://github.com/eschulte/org-plot/tree/master until we have
2045 moved the docs into Org or Worg.
2047 Thanks to Eric Schulte for this great contribution.
2049 *** Tags can be used to select the export part of a document
2051 You may now use tags to select parts of a document for
2052 inclusion into the export, and to exclude other parts. This
2053 behavior is governed by two new variables:
2054 =org-export-select-tags= and =org-export-exclude-tags=.
2055 These default to =("export")= and =("noexport")=, but can be
2056 changed, even to include a list of several tags.
2058 Org first checks if any of the /select/ tags is present in
2059 the buffer. If yes, all trees that do not carry one of these
2060 tags will be excluded. If a selected tree is a subtree, the
2061 heading hierarchy above it will also be selected for export,
2062 but not the text below those headings. If none of the select
2063 tags is found anywhere in the buffer, the whole buffer will
2064 be selected for export. Finally, all subtrees that are
2065 marked by any of the /exclude/ tags will be removed from the
2068 You may set these tags with in-buffer options
2069 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
2071 I love this feature. Thanks to Richard G Riley for coming
2074 *** Prefix interpretation when storing remember notes
2076 The prefix argument to the `C-c C-c' command that finishes a
2077 remember process is now interpreted differently:
2079 : C-c C-c Store the note to predefined file and headline
2080 : C-u C-c C-c Like C-c C-c, but immediately visit the note
2081 : in its new location.
2082 : C-1 C-c C-c Select the storage location interactively
2083 : C-0 C-c C-c Re-use the last used location
2085 This was requested by John Wiegley.
2087 *** Yanking inserts folded subtrees
2089 If the kill is a subtree or a sequence of subtrees, yanking
2090 them with =C-y= will leave all the subtrees in a folded
2091 state. This basically means, that kill and yank are now
2092 much more useful in moving stuff around in your outline. If
2093 you do not like this, customize the variable
2094 =org-yank-folded-subtrees=.
2096 Right now, I am only binding =C-y= to this new function,
2097 should I modify all bindings of yank? Do we need to amend
2100 This feature was requested by John Wiegley.
2102 *** Column view capture tables can have formulas, plotting info
2104 If you attach formulas and plotting instructions to a table
2105 capturing column view, these extra lines will now survive an
2106 update of the column view capture, and any formulas will be
2107 re-applied to the captured table. This works by keeping any
2108 continuous block of comments before and after the actual
2111 *** In column view, date stamps can be changed with S-cursor keys
2113 If a property value is a time stamp, S-left and S-right can
2114 now be used to shift this date around while in column view.
2116 This was a request by Chris Randle.
2118 *** The note buffer for clocking out now mentions the task
2120 This was a request by Peter Frings.
2122 *** Sorting entries alphabetically ignores TODO keyword and priority
2124 Numerical and alphanumerical sorting now skips any TODO
2125 keyword or priority cookie when constructing the comparison
2126 string. This was a request by Wanrong Lin.
2128 *** Agenda views can sort entries by TODO state
2130 You can now define a sorting strategy for agenda entries that
2131 does look at the TODO state of the entries. Sorting by TODO
2132 entry does first separate the non-done from the done states.
2133 Within each class, the entries are sorted not alphabetically,
2134 but in definition order. So if you have a sequence of TODO
2135 entries defined, the entries will be sorted according to the
2136 position of the keyword in this sequence.
2138 This follows an idea and sample implementation by Christian
2141 *** New face =org-scheduled= for entries scheduled in the future.
2143 This was a request by Richard G Riley.
2145 *** Remember templates for gnus links can now use the :to escape.
2147 Thanks to Tommy Lindgren for a patch to this effect.
2148 *** The file specification in a remember template may now be a function
2150 Thanks to Gregory Sullivan for a patch to this effect.
2152 *** Categories in iCalendar export now include local tags
2154 The locally defined tags are now listed as categories when
2155 exporting to iCalendar format. Org's traditional file/tree
2156 category is now the last category in this list. Configure
2157 the variable =org-icalendar-categories= to modify or revert
2160 This was a request by Charles Philip Chan.
2162 *** It is now possible to define filters for column view
2164 The filter can modify the value that will be displayed in a
2165 column, for example it can cut out a part of a time stamp.
2166 For more information, look at the variable
2167 =org-columns-modify-value-for-display-function=.
2169 *** Disabling integer increment during table field copy
2171 Prefix arg 0 to S-RET does the trick.
2173 This was a request by Chris Randle.
2178 For older Changes, see [[file:Changes_old.org]]