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)
20 *** PDF export of agenda views
22 Agenda views can now be exported to PDF files by writing them to
23 a file with extension ".pdf". Internally this works by first
24 producing the postscript version and then converting that to PDF
25 using the ghostview utility =ps2pdf=. Make sure that this
26 utility is installed on your system.
28 The postscript version will not be removed, it will stay around.
30 *** Inline some entry text for Agenda View export
32 When exporting an agenda view to HTML or PDF for printing or
33 remote access, one of the problems can be that information stored
34 in entries below the headline is not accessible in that format.
36 You can now copy some of that information to the agenda view
37 before exporting it. For this you need set the variable
38 =org-agenda-add-entry-text-maxlines= to a number greater than 0.
40 #+begin_src emacs-lisp
41 (setq org-agenda-add-entry-text-maxlines 20)
44 Or you can to this with the settings in a special agenda view,
47 #+begin_src emacs-lisp
50 (org-agenda-add-entry-text-maxlines 5))
54 *** Update of org2rem.el
56 /org2rem.el/ has been updated significantly and now does a more
57 comprehensive job of exporting Org events to remind.
59 Thanks to Sharad Pratap for this update.
61 *** Improved ASCII export of links
63 ASCII export of links works now much better. If a link has a
64 link and a description part which are different, then the
65 description will remain in the text while the link part will be
66 moved to the end of the current section, before the next heading,
67 as a footnote-like construct.
69 Configure the variable =org-export-ascii-links-to-notes= if you
70 prefer the links to be shown in the text. In this case, Org will
71 make an attempt to wrap the line which may have become
72 significantly longer by showing the link.
74 *** Turning off time-of-day search in headline
76 Some people like to put a creation time stamp into a headline and
77 then get confused if the time-of-day found in there shows up as
78 the time-of-day of the deadline/scheduling entry for this
79 headline. The reason for this is that Org searches the headline
80 for a free-format time when trying to sort the entry into the
81 agenda, and that search accidentally finds the time in the
82 creation time stamp or something else that happens to look like a
83 time. If this is more painful than useful for you, configure the
84 new variable =org-agenda-search-headline-for-time=.
86 *** Clustering characters for undo
88 When typing in Org-mode, undo will now remove up to 20 characters
89 at a time with a single undo command. This is how things work
90 normally in Emacs, but the special binding of characters in
91 Org-mode made this impossible until now.
93 Thanks to Martin Pohlack for a patch which mimicks the behavior
94 of the Emacs command loop for the Org version of self-insert.
95 Note that this will not work in headlines and tables because
96 typing there will do a lot of extra work.
98 There might be a small typing performance hit resulting from this
99 change - please report in the mailing list if this is noticeable
102 *** New reload command, with keyboard access
104 There is now a special command to reload all Org Lisp files, so
105 that you can stay in your Emacs session while pulling and
106 compiling changes to Org. The command to reload the compiled
107 files (if available) is =C-c C-x r=. If no compiled files are
108 found, uncompiled ones will be loaded. If you want to force
109 loading of uncompiled code (great for producing backtraces), use
110 a prefix arg: =C-u C-c C-x o=. Both commands are available in
113 This new command was inspired by one written earlier by Bernt
116 *** Macro replacement
118 A string like ={{{ title }}}= will be replaced by the title of
119 the document, ={{{ email }}}= by the email setting of the author
120 and similarly for other export settings given in =#+...= lines.
121 In addition to that, you can define an arbitrary number of
125 ,#+MACRO: myaddress 41 Onestreet, 12345 New York, NY
127 ,my address is {{{myaddress}}}, see you there.
130 Macro replacement is the very first thing that happes during
131 export, and macros will be replaced even in source code and other
134 *** Separate settings for special C-a and C-e
136 The variable `org-special-ctrl-a/e' now allows separate settings
137 for =C-a= and =C-e=. For example
139 #+begin_src emacs-lisp
140 (setq org-special-ctrl-a/e '(reversed . t))
143 Thanks to Alan Davis for this proposal.
145 *** orgstruct++-mode improvements
147 In addition to =orgstruct-mode= which allows to use some Org-mode
148 structure commands in other major modes, there is now a more
149 invasive version of this mode: =orgstruct++-mode=. This mode
150 will import all paragraph and line wrapping variables into the
151 major mode, so that, for example, during typing the auto-fill
152 wrapping of items will work just like in Org-mode. This change
153 is not reversible, so turning off orgstruct++-mode will not
154 remove these settings again. =orgstruct++-mode= is most useful in
155 text modes like message-mode or =magit-log-edit-mode=.
156 Furthermore, =orgstruct++-mode= will recognize plain list context
157 not only in the first line of an item, but also further down, so
158 that =M-RET= will correctly insert new items.
160 Thanks to Austin Frank for requesting some of these changes.
162 *** Promotion and demotion works for regions now
164 =M-right= and =M-left= now do demote and promote all headlines in
170 - Capture state change notes into a drawer
171 - Clock lines are now captured into the LOGBOOK drawer as well
172 - Added org-R.el to contrib directory
173 - Allow individual formatting of each TODO keyword in HTML export
174 - New hooks for add-ons to tap into context-sensitive commands
175 - Publishing files irrespective of extension
176 - New variable index in the manual
177 - The ORDERED property also influences checkboxes
178 - The ORDERED property can be tracked with a tag
179 - You may now specify line breaks in the fast tags interface
180 - When a TODO is blocked by checkboxes, keep it visible in agenda
181 - LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc.
183 ** Incompatible changes
185 - CLOCK lines will now be captured into the LOGBOOK drawer.
186 See below for details.
190 *** Capture state change notes into a drawer
192 State change notes can now be captured into a drawer =LOGBOOK=,
193 to keep the entry tidy. If this is what you want, you will need
196 #+begin_src emacs-lisp
197 (setq org-log-into-drawer "LOGBOOK")
200 Thanks to Wanrong Lin for this proposal.
202 *** Clock lines are now captured into the LOGBOOK drawer as well
204 The =CLOCK= drawer will be abandoned, clock lines will now also
205 end up in a drawer =LOGBOOK=. The reason for this is that it's a
206 bit useless to have two different drawers for state change notes
207 and clock lines. If you wish to keep the old way, use
209 #+begin_src emacs-lisp
210 (setq org-clock-into-drawer "CLOCK")
213 *** Added org-R.el to contrib directory
215 Dan Davison has contributed /org-R.el/ which is now in the
216 contrib directory. Org-R performs numerical computations and
217 generates graphics. Data can come from org tables, or from csv
218 files; numerical output can be stored in the org buffer as org
219 tables, and links are created to files containing graphical
220 output. Although, behind the scenes, it uses R, you do not need
221 to know anything about R. Common operations, such as tabulating
222 discrete values in a column of an org table, are available "off
223 the shelf" by specifying options on lines starting with =#+R:=.
224 However, you can also provide raw R code to be evaluated. The
225 documentation is currently the worg tutorial at
226 http://orgmode.org/worg/org-tutorials/org-R/org-R.php
228 Thanks to Dan for this great contribution.
230 *** Allow individual formatting of TODO keyword and tags in HTML export
232 TODO keywords in HTML export have the CSS class =todo= or =done=.
233 Tags have the CSS class =tag=. In addition to this, each keyword
234 has now itself as class, so you could do this in your CSS file:
237 .todo { font-weight:bold; }
238 .done { font-weight:bold; }
240 .WAITING { color:orange; }
241 .DONE { color:green; }
244 If any of your keywords causes conflicts with CSS classes used
245 for different purposes (for example a tag "title" would cause a
246 conflict with the class used for formatting the document title),
247 then you can use the variables =org-export-html-tag-class-prefix=
248 and =org-export-html-todo-kwd-class-prefix= to define prefixes
249 for the class names for keywords, for example "kwd-".
251 Thanks to Wanrong Lin for this request, and to Sebastian Rose for
252 help with the implementation.
254 *** New hooks for add-ons to tap into context-sensitive commands
256 Some commands in Org are context-sensitive, they will execute
257 different functions depending on context. The most important
258 example is of course =C-c C-c=, but also the =M-cursor= keys fall
261 Org has now a system of hooks that can be used by add-on packages
262 to install their own functionality into these keys. See the
263 docstring of =org-ctrl-c-ctrl-c-hook= for details. The other
264 hooks are named like =org-metaleft-hook= or
265 =org-shiftmetaright-hook=.
267 *** Publishing files irrespective of extension
269 If you set the =:base-extension= property for a publishing
270 project to the symbol =any=, all files in the directory will be
271 published, irrespective of extension.
273 Thanks to Richard Klinda for a patch to this effect.
275 *** New variable index in the manual
277 A new index in the manual lists all variables mentioned in the
278 manual, about 200 variables in total.
280 *** The ORDERED property also influences checkboxes
282 When an entry has the ORDERED property set, checkboxes in
283 the entry must be completed in order. This was already the case
284 for children TODO items, now it also applies for checkboxes.
286 Thanks to Rainer Stengele for this proposal.
288 *** The ORDERED property can be tracked with a tag
290 The =ORDERED= property is used to flag an entry so that subtasks
291 (both children TODO items and checkboxes) must be completed in
292 order. This property is most easily toggled with the command
293 =C-c C-x o=. A property was chosen for this functionality,
294 because this should be a behavior local to the current task, not
295 inherited like tags. However, properties are normally
296 invisible. If you would like visual feedback on the state of
297 this property, configure the variable
298 =org-track-ordered-property-with-tag=. If you then use =C-c C-x
299 o= to toggle the property, a tag will be toggled as well, for
302 Note that the tag itself has no meaning for the behavior of TODO
303 items and checkboxes, and that changing the tag with the usual
304 tag commands will not influence the property and therefore the
305 behavior of TODO and checkbox commands.
307 *** You may now specify line breaks in the fast tags interface
309 Up to now, the fast tags interface tried to lump as many tags as
310 possible into a single line, with the exception that groups would
311 always be on a line by themselves.
313 Now, if you use several lines to define your tags, like
316 ,#+TAGS: aa(a) bb(b) cc(c)
317 ,#+TAGS: dd(d) ee(e) ff(f)
320 then there will also be a line break after the "cc" tag in the
321 fast tag selection interface. You may also write
324 ,#+TAGS: aa(a) bb(b) cc(c) \n dd(d) ee(e) ff(f)
327 to achieve the same effect, and you can use =\n= several times in
328 order to produce empty lines. In =org-tag-alist=, newlines are
329 represented as =(:newline)=.
331 Thanks to Christopher Suckling for a patch to this effect.
333 *** When a TODO is blocked by checkboxes, keep it visible in agenda
335 When the variable =org-agenda-dim-blocked-tasks= is set to
336 =invisible=, tasks that are blocked will not be visible in the
337 agenda. If the blocking is due to child TODO entries, this does
338 make sense because the children themselves will show up in the
341 However, as John Rakestraw has [[http://thread.gmane.org/gmane.emacs.orgmode/10939][pointed out]], if the blocking is
342 done by checkboxes, no trace of these subtasks is left.
343 Therefore, when the blocking is done by checkboxes, we now
344 overrule the =invisible= setting and replace it with mere dimming
347 *** LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc.
349 If you configure =org-export-latex-import-inbuffer-stuff=,
350 in-buffer definitions like #+TITLE will be made available in the
351 LaTeX file as =\orgTITLE=.
353 This was a request by Russel Adams.
358 *** org-choose.el by Tom Breton is now included
360 Org-choose helps documenting a decision-making process by using
361 TODO keywords for different degrees of /chosenness/, and by
362 automatically keeping a set of alternatives in a consistent state.
364 Documentation for /org-choose.el/ is available [[http://orgmode.org/worg/org-contrib/org-choose.php][here]].
366 This package inserts itself into Org using hooks, so if other
367 people would like to do interesting stuff with TODO keywords for
368 special purposes, looking at Tom's code might be a good way to
371 Thanks to Tom for this interesting contribution!
373 *** orgmode.org and Worg css works now better on IE
375 Thanks to Sebastian Rose for making these changes.
377 *** When exporting a subtree, headline levels are now relative to parent
379 This was reported as a bug by William Henney and is fixed now.
381 *** Inactive dates in tables can be used for sorting.
383 When sorting table fields or entries by date, Org first tries to
384 find an active date, and, if none exist, uses a passive date if
387 This was a request by Hsui-Khuen Tang
389 *** The default for =org-return-follows-link= is back to =nil=
391 Setting it to =t= violates Emacs rules to some extent. The
392 internal implementation of this has been improved, so setting it
393 to =t= should now be pretty stable.
395 *** Automatic scheduling of siblings with org-depend.el
397 The sibling of a DONE task can now automatically be scheduled.
399 This was a patch by Andrew Hyatt.
401 *** New skipping conditions
403 The functions =org-agenda-skip-entry-if= and
404 =org-agenda-skip-subtree-if= now accept =timestamp= and
405 =nottimestamp= as additional conditions.
407 This was in response to a request by Saurabh Agrawal.
413 *** Changes to some default values of variables:
415 Here are the new default values:
418 (setq org-return-follows-link t)
420 (setq org-use-fast-todo-selection t)
422 (setq org-yank-adjusted-subtrees nil)
424 (setq org-tags-column -77)
426 (setq org-agenda-sorting-strategy
427 '((agenda time-up priority-down category-keep)
428 (todo time-up priority-down category-keep)
429 (tags time-up priority-down category-keep)
430 (search category-keep)))
433 *** Final cleanup for Emacs 21.1 pretest
439 *** Support for simple TODO dependencies
441 John Wiegley's code for enforcing simple TODO dependencies has
442 been integrated into Org-mode. Thanks John!
444 The structure of Org files (hierarchy and lists) makes it easy to
445 define TODO dependencies. A parent TODO task should not be
446 marked DONE until all subtasks (defined as children tasks) are
447 marked as DONE. And sometimes there is a logical sequence to a
448 number of (sub)tasks, so that one task cannot be acted upon
449 before all siblings above it are done. If you customize the
450 variable =org-enforce-todo-dependencies=, Org will block entries
451 from changing state while they have children that are not DONE.
452 Furthermore, if an entry has a property =ORDERED=, each of its
453 children will be blocked until all earlier siblings are marked
454 DONE. Here is an example:
457 ,* TODO Blocked until (two) is done
466 ,** TODO b, needs to wait for (a)
467 ,** TODO c, needs to wait for (a) and (b)
470 The command =C-c C-x o= toggles the value of the =ORDERED=
473 The variable =org-agenda-dim-blocked-tasks= controls how blocked
474 entries should appear in the agenda, where they can be dimmed or
477 Furthermore, you can use the variable
478 =org-enforce-todo-checkbox-dependencies= to block TODO entries
479 from switching to DONE while any checkboxes are unchecked in the entry.
481 *** Support for shift-selection in Emacs 23
483 Customize the variable =org-support-shift-select= to use S-cursor
484 key for selecting text. Make sure that you carefully read the
485 docstring of that variable first.
487 *** Adding and removing checkboxes from many lines
489 The command =C-c C-x C-b= normally toggles checkbox status in the
490 current line, or in all lines in the region. With prefix
491 argument it now either adds or removes the checkbox.
493 This was a requested by Daniel Clemente.
499 - Improved behavior of conversion commands =C-c -= and =C-c *=
500 - Table formulas may now reference fields in other tables
501 - A final hline is imagined in each table, for the sake of references
502 - A tags-todo search can now ignore timestamped items
503 - =\par= can be used to force a paragraph break, also in footnotes
508 *** Improved behavior of conversion commands =C-c -= and =C-c *=
510 The conversion commands =C-c -= and =C-c *= are now better
511 behaved and therefore more useful, I hope.
513 If there is an active region, these commands will act on the
514 region, otherwise on the current line.
516 - C-c - :: This command turns headings or normal lines into
517 items, or items into normal lines. When there is a
518 region, everything depends on the first line of the
520 - if it is a item, turn all items in the region into
522 - if it is a headline, turn all headlines in the region
524 - if it is a normal line, turn all lines into items.
525 - special case: if there is no active region and the
526 current line is an item, cycle the bullet type of the
528 - C-c * :: This command turns items and normal lines into
529 headings, or headings into normal lines. When there is
530 a region, everything depends on the first line of the
532 - if it is a item, turn all items in the region into
534 - if it is a headline, turn all headlines in the region
536 - if it is a normal line, turn all lines into headlines.
538 *** Table formulas may now reference fields in other tables
540 You may now reference constants, fields and ranges from a
541 different table, either in the current file or even in a
542 different file. The syntax is
544 : remote(NAME-OR-ID,REF)
546 where /NAME/ can be the name of a table in the current file as
547 set by a =#+TBLNAME: NAME= line before the table. It can also be
548 the ID of an entry, even in a different file, and the reference
549 then refers to the first table in that entry. /REF/ is an
550 absolute field or range reference, valid in the referenced table.
551 Note that since there is no "current filed" for the remote table,
552 all row and column references must be absolute, not relative.
554 *** A final hline is imagined in each table, for the sake of references
556 Even if a table does not end with a hline (mine never do because I
557 think it is not pretty), for the sake of references you can
558 assume there is one. So in the following table
567 a reference like =@I$1..@II$2= will now work.
569 *** A tags-todo search can now ignore timestamped items
570 The variables =org-agenda-todo-ignore-with-date=,
571 =org-agenda-todo-ignore-with-date=, and
572 =org-agenda-todo-ignore-with-date= make it possible to
573 exclude TODO entries which have this kind of planning info
574 associated with them. This is most useful for people who
575 schedule everything, and who use the TODO list mainly to find
576 things that are not yet scheduled. Thomas Morgan pointed out
577 that also the tags-todo search may serve exactly this
578 purpose, and that it might be good to have a way to make
579 these variables also apply to the tags-todo search. I can
580 see that, but could not convince myself to make this the
581 default. A new variable must be set to make this happen:
582 =org-agenda-tags-todo-honor-ignore-options=.
584 *** =\par= can be used to force a paragraph break, also in footnotes
586 The LaTeX idiom =\par= will insert a paragraph break at that
587 location. Normally you would simply leave an empty line to get
588 such a break, but this is useful for footnotes whose
589 definitions may not contain empty lines.
592 ** Incompatible changes
594 *** Short examples must have a space after the colon
596 Short literal examples can be created by preceding lines
597 with a colon. Such lines must now have a space after the
598 colon. I believe this is already general practice, but now
599 it must be like this. The only exception are lines that are
600 empty except for the colon.
604 *** Include files can now also process switches
606 The example and src switches like =-n= can now also be added
607 to include file statements:
609 : #+INCLUDE "~/.emacs" src emacs-lisp -n -r
611 Thanks to Manish for pointing out that this was not yet
614 *** Examples can be exported to HTML as text areas
616 You can now specify a =-t= switch to an example or src block,
617 to make it export to HTML as a text area. To change the
618 defaults for height (number of lines in the example) and
619 width of this area (80), use the =-h= and =-w= switches.
621 Thanks to Ulf Stegemann for driving this development.
623 *** LaTeX_CLASS can be given as a property
625 When exporting a single subtree by selecting it as a region
626 before export, the LaTeX class for the export will be taken
627 from the =LaTeX_CLASS= property of the entry if present.
629 Thanks to Robert Goldman for this request.
631 *** Better handling of inlined images in different backends
633 Two new variables govern which kind of files can be inlined
634 during export. These are
635 =org-export-html-inline-image-extensions= and
636 =org-export-latex-inline-image-extensions=. Remember that
637 links are turned into an inline image if they are a pure link
638 with no description. HTML files can inline /.png/, /.jpg/,
639 and /.gif/ files, while LaTeX files, when processed with
640 /pdflatex/, can inline /.png/, /.jpg/, and /.pdf/ files.
641 These also represent the default settings for the new
642 variables. Note that this means that pure links to /.pdf/
643 files will be inlined - to avoid this for a particular link,
644 make sure that the link has a description part which is not
645 equal to the link part.
647 *** Links by ID now continue to work in HTML exported files
649 If you make links by ID, these links will now still work in
650 HTML exported files, provided that you keep the relative path
651 from link to target file the same.
653 Thanks to Friedrich Delgado Friedrichs for pushing this over
656 *** The relative timer can be paused
658 The new command `C-c C-x ,' will pause the relative timer.
659 When the relative timer is running, its value will be shown
660 in the mode line. To get rid of this display, you need to
661 really stop the timer with `C-u C-c C-x ,'.
663 Thanks to Alan Davis for driving this change.
665 *** The attachment directory may now be chosen by the user
667 Instead of using the automatic, unique directory related to
668 the entry ID, you can also use a chosen directory for the
669 attachments of an entry. This directory is specified by the
670 ATTACH_DIR property. You can use `C-c C-a s' to set this
673 Thanks to Jason Jackson for this proposal.
675 *** You can use a single attachment directory for a subtree
677 By setting the property ATTACH_DIR_INHERIT, you can now tell
678 Org that children of the entry should use the same directory
679 for attachments, unless a child explicitly defines its own
680 directory with the ATTACH_DIR property. You can use the
681 command `C-c C-a i' to set this property in an entry.
688 - Line numbers and references in literal examples
689 - New hooks for export preprocessing
690 - Capture column view into a different file
696 Org-mode now directly supports the creation of footnotes. In
697 contrast to the /footnote.el/ package, Org-mode's footnotes are
698 designed for work on a larger document, not only for one-off
699 documents like emails. The basic syntax is similar to the one
700 used by /footnote.el/, i.e. a footnote is defined in a paragraph
701 that is started by a footnote marker in square brackets in column
702 0, no indentation allowed. The footnote reference is simply the
703 marker in square brackets inside text. For example:
706 The Org homepage[fn:1] now looks a lot better than it used to.
708 [fn:1] The link is: http://orgmode.org
711 Org-mode extends the number-based syntax to /named/ footnotes and
712 optional inline definition. Using plain numbers as markers is
713 supported for backward compatibility, but not encouraged because
714 of possible conflicts with LaTeX syntax. Here are the valid
717 - [1] :: A plain numeric footnote marker.
719 - [fn:name] :: A named footnote reference, where `name' is a
720 unique label word or, for simplicity of automatic creation,
723 - [fn:: This is the inline definition of this footnote] :: A
724 LaTeX-like anonymous footnote where the definition is given
725 directly at the reference point.
727 - [fn:name: a definition] :: An inline definition of a footnote,
728 which also specifies a name for the note. Since Org allows
729 multiple references to the same note, you can then use use
730 `[fn:name]' to create additional references.
732 Footnote labels can be created automatically, or you create names
733 yourself. This is handled by the variable
734 =org-footnote-auto-label= and its corresponding =#+STARTUP=
735 keywords, see the docstring of that variable for details.
737 The following command handles footnotes:
739 - C-c C-x f :: The footnote action command. When the cursor is
740 on a footnote reference, jump to the definition. When it is
741 at a definition, jump to the (first) reference. Otherwise,
742 create a new footnote. Depending on the variable
743 `org-footnote-define-inline' (with associated =#+STARTUP=
744 options =fninline= and =nofninline=), the definitions will
745 be placed right into the text as part of the reference, or
746 separately into the location determined by the variable
747 =org-footnote-section=.
748 When this command is called with a prefix argument, a menu
749 of additional options is offered:
750 - s :: Sort the footnote definitions by reference sequence.
751 During editing, Org makes no effort to sort footnote
752 definitions into a particular sequence. If you want
753 them sorted, use this command, which will also move
754 entries according to =org-footnote-section=.
755 - n :: Normalize the footnotes by collecting all
756 definitions (including inline definitions) into a
757 special section, and then numbering them in
758 sequence. The references will then also be
759 numbers. This is meant to be the final step before
760 finishing a document (e.g. sending off an email).
761 The exporters do this automatically, and so could
762 something like `message-send-hook'.
763 - d :: Delete the footnote at point, and all references to it.
765 - C-c C-c :: If the cursor is on a footnote reference, jump to
766 the definition. If it is a the definition, jump back to the
767 reference. When called with a prefix argument at either
768 location, offer the same menu as `C-u C-c C-x f'.
770 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
771 corresponding definition/reference, and you can use the
772 usual commands to follow these links.
774 Org-mode's footnote support is designed so that it should also
775 work in buffers that are not in Org-mode, for example in email
776 messages. Just bind =org-footnote-action= to a global key like
779 The main trigger for this development came from a hook function
780 written by Paul Rivier, to implement named footnotes and to
781 convert them to numbered ones before export. Thanks, Paul!
783 Thanks also to Scot Becker for a thoughtful post bringing this
784 subject back onto the discussion table, and to Matt Lundin for
785 the idea of named footnotes and his prompt testing of the new
788 *** Line numbers and references in literal examples
790 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
791 do now allow optional line numbering in the example.
792 Furthermore, links to specific code lines are supported, greatly
793 increasing Org-mode's utility for writing tutorials and other
796 Code references use special labels embedded directly into the
797 source code. Such labels look like "(ref:name)" and must be
798 unique within a document. Org-mode links with "(name)" in the
799 link part will be correctly interpreted, both while working with
800 an Org file (internal links), and while exporting to the
801 different backends. Line numbering and code references are
802 supported for all three major backends, HTML, LaTeX, and ASCII.
803 In the HTML backend, hovering the mouse over a link to a source
804 line will remote-highlight the referenced code line.
806 The options for the BEGIN lines are:
808 - -n :: Number the lines in the example
809 - +n :: Like -n, but continue numbering from where the previous
811 - -r :: Remove the coderef cookies from the example, and replace
812 links to this reference with line numbers. This option
813 takes only effect if either -n or +n are given as well.
814 If -r is not given, coderefs simply use the label name.
815 - -l "fmt" :: Define a local format for coderef labels, see the
816 variable =org-coderef-label-format= for details. Use this
817 of the default syntax causes conflicts with the code in the
818 code snippet you are using.
823 #+begin_src emacs-lisp -n -r
824 (defmacro org-unmodified (&rest body) (ref:def)
825 "Execute body without changing `buffer-modified-p'."
826 `(set-buffer-modified-p (ref:back)
827 (prog1 (buffer-modified-p) ,@body)))
829 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
833 When exported, this is translated to:
834 #+begin_src emacs-lisp -n -r
835 (defmacro org-unmodified (&rest body) (ref:def)
836 "Execute body without changing `buffer-modified-p'."
837 `(set-buffer-modified-p (ref:back)
838 (prog1 (buffer-modified-p) ,@body)))
840 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
843 Thanks to Ilya Shlyakhter for proposing this feature set. Thanks
844 to Sebastian Rose for the key Javascript element that made the
845 remote highlighting possible.
847 *** New hooks for export preprocessing
848 The export preprocessor now runs more hooks, to allow
849 better-timed tweaking by user functions:
851 - =org-export-preprocess-hook= ::
852 Pretty much the first thing in the preprocessor. But org-mode
853 is already active in the preprocessing buffer.
855 - =org-export-preprocess-after-include-files-hook= ::
856 This is run after the contents of included files have been inserted.
858 - =org-export-preprocess-after-tree-selection-hook= ::
859 This is run after selection of trees to be exported has
860 happened. This selection includes tags-based selection, as
861 well as removal of commented and archived trees.
863 - =org-export-preprocess-before-backend-specifics-hook= ::
864 Hook run before backend-specific functions are called during preprocessing.
866 - =org-export-preprocess-final-hook= ::
867 Hook for preprocessing an export buffer. This is run as the
868 last thing in the preprocessing buffer, just before returning
869 the buffer string to the backend.
871 *** Capture column view into a different file
873 The :id parameter for the dynamic block capturing column view
874 can now truly be an ID that will also be found in a
875 different file. Also, it can be like =file:path/to/file=, to
876 capture the global column view from a different file.
878 Thanks to Francois Lagarde for his report that IDs outside
879 the current file would not work.
882 Cleanup of many small bugs, and one new feature.
886 *** References to last table row with special names
888 Fields in the last row of a table can now be referenced with
889 $LR1, $LR2, etc. These references can appear both on the
890 left hand side and right hand side of a formula.
894 This version reverses the introduction of @0 as a reference to
895 the last rwo in a table, because of a conflict with the use of
896 @0 for the current row.
901 - All known LaTeX export issues fixed
902 - Captions and attributes for figures and tables.
903 - Better implementation for entry IDs
904 - Spreadsheet references to the last table line.
905 - Old syntax for link attributes abandoned
907 ** Incompatible changes
908 *** Old syntax for link attributes abandoned
910 There used to be a syntax for setting link attributes for
911 HTML export by enclosing the attributes into double braces
912 and adding them to the link itself, like
915 [[./img/a.jpg{{alt="an image"}}] ]
918 This syntax is not longer supported, use instead
921 ,#+ATTR_HTML: alt="an image"
927 *** All known LaTeX export issues fixed
929 All the remaining issues with the LaTeX exporter have hopefully
930 been addressed in this release. In particular, this covers
931 quoting of special characters in tables and problems with
932 exporting files where the headline is in the first line, or with
935 *** Captions and attributes for figures and tables.
937 Tables, and Hyperlinks that represent inlined images, can now be
938 equipped with additional information that will be used during
939 export. The information will be taken from the following special
940 lines in the buffer and apply to the first following table or
943 - #+CAPTION: :: The caption of the image or table. This string
944 should be processed according to the export backend, but
945 this is not yet done.
947 - #+LABEL: :: A label to identify the figure/table for cross
948 references. For HTML export, this string will become the
949 ID for the ~<div class="figure">~ element that encapsulates
950 the image tag and the caption. For LaTeX export, this
951 string will be used as the argument of a ~\label{...}~
952 macro. These labels will be available for internal links
953 like ~[[label][Table] ]~.
955 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
956 added as attributes into the ~<img...>~ tag. This string
957 will not be processed, so it should have immediately the
960 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
962 For /images/, this string is directly inserted into
963 the optional argument of the ~\includegraphics[...]{file}~
964 command, to specify scaling, clipping and other options.
965 This string will not be processed, so it should have
966 immediately the right format, like =width=5cm,angle=90=.\\
967 For /tables/, this can currently contain the keyword
968 =longtable=, to request typesetting of the table using the
969 longtable package, which automatically distributes the table
970 over several pages if needed. Also, the attributes line may
971 contain an alignment string for the tabular environment, like
972 =longtable,align=l|lrl=
974 For LaTeX export, if either a caption or a label is given, the element
975 will be exported as a float, i.e. wrapped into a figure or table
978 *** Better implementation for entry IDs
980 Unique identifiers for entries can now be used more efficiently.
981 Internally, a hash array has replaced the alist used so far to
982 keep track of the files in which an ID is defined. This makes it
983 quite fast to find an entry by ID.
985 There is a new link type which looks like this:
988 id:GLOBALLY-UNIQUE-IDENTIFIER
991 This link points to a specific entry. When you move the entry to
992 a different file, for example if you move it to an archive
993 file, the link will continue to work.
995 The file /org-id.el/ contains an API that can be used to write
996 code using these identifiers, including creating IDs and finding
997 them wherever they are.
999 Org has its own method to create unique identifiers, but if the system
1000 has /uuidgen/ command installed (Mac's and Linux systems generally
1001 do), it will be used by default (a change compared to the earlier
1002 implmentation, where you explicitdly had to opt for uuidgen). You can
1003 also select the method by hand, using the variable =org-id-method=.
1005 If the ID system ever gets confused about where a certain ID is, it
1006 initiates a global scan of all agenda files with associated archives,
1007 all files previously known containing any IDs, and all currently
1008 visited Org-mode files to rebuild the hash. You can also initiate
1009 this by hand: =M-x org-id-update-id-locations=. Running this command
1010 will also dump into the =*Messages*= buffer information about any
1011 duplicate IDs. These should not exist, and Org will never /make/ the
1012 same ID twice, but if you /copy/ an entry with its properties,
1013 duplicate IDs will inevitably be produced. Unfortunately, this is
1014 unavoidable in a plain text system that allows you to edit the text in
1015 arbitrary ways, and a portion of care on your side is needed to keep
1018 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
1019 This is also a change from previous versions where the file was
1020 =~/.org=id-locations=. Therefore, you can remove this old file
1021 if you have it. I am not sure what will happen if the =.emacs.d=
1022 directory does not exists in your setup, but in modern Emacsen, I
1023 believe it should exist. If you do not want to use IDs across
1024 files, you can avoid the overhead with tracking IDs by
1025 customizing the variable =org-id-track-globally=. IDs can then
1026 still be used for links inside a single file.
1028 IDs will also be used when you create a new link to an Org-mode
1029 buffer. If you use =org-store-link= (normally at =C-c l=) inside
1030 en entry in an Org-mode buffer, and ID property will be created
1031 if it does not exist, and the stored link will be an =id:= link.
1032 If you prefer the much less secure linking to headline text, you
1033 can configure the variable =org-link-to-org-use-id=. The default
1034 setting for this variable is =create-if-interactive=, meaning
1035 that an ID will be created when you store a link interactively,
1036 but not if you happen to be in an Org-mode file while you create
1037 a remember note (which usually has a link to the place where you
1038 were when starting remember).
1040 *** Spreadsheet references to the last table line.
1042 You may now use =@0= to reference the last dataline in a table
1043 in a stable way. This is useful in particular for automatically
1044 generated tables like the ones using /org-collector.el/ by Eric
1050 - New relative timer to support timed notes
1051 - Special faces can be set for individual tags
1052 - The agenda shows now all tags, including inherited ones.
1053 - Exclude some tags from inheritance.
1054 - More special values for time comparisons in property searches
1055 - Control for exporting meta data
1056 - Cut and Paste with hot links from w3m to Org
1057 - LOCATION can be inherited for iCalendar export
1058 - Relative row references crossing hlines now throw an error
1060 ** Incompatible Changes
1062 *** Relative row references crossing hlines now throw an error
1064 Relative row references in tables look like this: "@-4" which
1065 means the forth row above this one. These row references are
1066 not allowed to cross horizontal separator lines (hlines). So
1067 far, when a row reference violates this policy, Org would
1068 silently choose the field just next to the hline.
1070 Tassilo Horn pointed out that this kind of hidden magic is
1071 actually confusing and may cause incorrect formulas, and I do
1072 agree. Therefore, trying to cross a hline with a relative
1073 reference will now throw an error.
1075 If you need the old behavior, customize the variable
1076 `org-table-error-on-row-ref-crossing-hline'.
1080 *** New relative timer to support timed notes
1082 Org now supports taking timed notes, useful for example while
1083 watching a video, or during a meeting which is also recorded.
1086 Insert a relative time into the buffer. The first time
1087 you use this, the timer will be started. When called
1088 with a prefix argument, the timer is reset to 0.
1091 Insert a description list item with the current relative
1092 time. With a prefix argument, first reset the timer to 0.
1095 Once the time list has been initiated, you can also use the
1096 normal item-creating command to insert the next timer item.
1099 Reset the timer without inserting anything into the buffer.
1100 By default, the timer is reset to 0. When called with a
1101 =C-u= prefix, reset the timer to specific starting
1102 offset. The user is prompted for the offset, with a
1103 default taken from a timer string at point, if any, So this
1104 can be used to restart taking notes after a break in the
1105 process. When called with a double prefix argument
1106 =C-c C-u=, change all timer strings in the active
1107 region by a certain amount. This can be used to fix timer
1108 strings if the timer was not started at exactly the right
1111 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
1112 contributions to this idea.
1114 *** Special faces can be set for individual tags
1116 You may now use the variable =org-tag-faces= to define the
1117 face used for specific tags, much in the same way as you can
1118 do for TODO keywords.
1120 Thanks to Samuel Wales for this proposal.
1122 *** The agenda shows now all tags, including inherited ones.
1124 This request has come up often, most recently it was
1125 formulated by Tassilo Horn.
1127 If you prefer the old behavior of only showing the local
1128 tags, customize the variable =org-agenda-show-inherited-tags=.
1130 *** Exclude some tags from inheritance.
1132 So far, the only way to select tags for inheritance was to
1133 allow it for all tags, or to do a positive selection using
1134 one of the more complex settings for
1135 `org-use-tag-inheritance'. It may actually be better to
1136 allow inheritance for all but a few tags, which was difficult
1137 to achieve with this methodology.
1139 A new option, `org-tags-exclude-from-inheritance', allows to
1140 specify an exclusion list for inherited tags.
1142 *** More special values for time comparisons in property searches
1144 In addition to =<now>=, =<today>=, =<yesterday>=, and
1145 =<tomorrow>=, there are more special values accepted now in
1146 time comparisons in property searches: You may use strings
1147 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
1148 week, month, and year, respectively
1150 Thanks to Linday Todd for this proposal.
1152 *** Control for exporting meta data
1154 All the metadata in a headline, i.e. the TODO keyword, the
1155 priority cookie, and the tags, can now be excluded from
1156 export with appropriate options:
1158 | Variable | Publishing property | OPTIONS switch |
1159 |-------------------------------+---------------------+----------------|
1160 | org-export-with-todo-keywords | :todo-keywords | todo: |
1161 | org-export-with-tags | :tags | tags: |
1162 | org-export-with-priority | :priority | pri: |
1164 *** Cut and Paste with hot links from w3m to Org
1166 You can now use the key =C-c C-x M-w= in a w3m buffer with
1167 HTML content to copy either the region or the entire file in
1168 a special way. When you yank this text back into an Org-mode
1169 buffer, all links from the w3m buffer will continue to work
1172 For this to work you need to load the new file /org-w3m.el./
1173 Please check your org-modules variable to make sure that this
1176 Thanks for Richard Riley for the idea and to Andy Stewart for
1179 *** LOCATION can be inherited for iCalendar export
1181 The LOCATION property can now be inherited during iCalendar
1182 export if you configure =org-use-property-inheritance= like
1185 #+begin_src emacs-lisp
1186 (setq org-use-property-inheritance '("LOCATION"))
1193 - Keybindings in Remember buffers can be configured
1194 - Support for ido completion
1195 - New face for date lines in agenda column view
1196 - Invisible targets become now anchors in headlines.
1197 - New contributed file /org-exp-blocks.el/
1198 - New contributed file /org-eval-light.el/
1200 - BBDB links may use regular expressions.
1201 - Link abbreviations can use %h to insert a url-encoded target value
1202 - Improved XHTML compliance
1206 *** Keybindings in Remember buffers can be configured
1208 The remember buffers created with Org's extensions are in
1209 Org-mode, which is nice to prepare snippets that will
1210 actually be stored in Org-mode files. However, this makes it
1211 hard to configure key bindings without modifying the Org-mode
1212 keymap. There is now a minor mode active in these buffers,
1213 `org-remember-mode', and its keymap org-remember-mode-map can
1214 be used for key bindings. By default, this map only contains
1215 the bindings for =C-c C-c= to store the note, and =C-c C-k=
1216 to abort it. Use `org-remember-mode-hook' to define your own
1219 #+begin_src emacs-lisp
1221 'org-remember-mode-hook
1223 (define-key org-remember-mode-map
1224 "\C-x\C-s" 'org-remember-finalize)))
1227 If you wish, you can also use this to free the =C-c C-c=
1228 binding (by binding this key to nil in the minor mode map),
1229 so that you can use =C-c C-c= again to set tags.
1231 This modification is based on a request by Tim O'Callaghan.
1233 *** Support for ido completion
1235 You can now get the completion interface from /ido.el/ for
1236 many of Org's internal completion commands by turning on the
1237 variable =org-completion-use-ido=. =ido-mode= must also be
1238 active before you can use this.
1240 This change is based upon a request by Samuel Wales.
1242 *** New face for date lines in agenda column view
1244 When column view is active in the agenda, and when you have
1245 summarizing properties, the date lines become normal column
1246 lines and the separation between different days becomes
1247 harder to see. If this bothers you, you can now customize
1248 the face =org-agenda-column-dateline=.
1250 This is based on a request by George Pearson.
1252 *** Invisible targets become now anchors in headlines.
1254 These anchors can be used to jump to a directly with an HTML
1255 link, just like the =sec-xxx= IDs. For example, the
1256 following will make a http link
1257 =//domain/path-to-my-file.html#dummy= work:
1264 This is based on a request by Matt Lundin.
1266 *** New contributed file /org-exp-blocks.el/
1268 This new file implements special export behavior of
1269 user-defined blocks. The currently supported blocks are
1271 - comment :: Comment blocks with author-specific markup
1272 - ditaa :: conversion of ASCII art into pretty png files
1273 using Stathis Sideris' /ditaa.jar/ program
1274 - dot :: creation of graphs in the /dot/ language
1275 - R :: Sweave type exporting using the R program
1277 For more details and examples, see the file commentary in
1278 /org-exp-blocks.el/.
1280 Kudos to Eric Schulte for this new functionality, after
1281 /org-plot.el/ already his second major contribution. Thanks
1282 to Stathis for this excellent program, and for allowing us to
1283 bundle it with Org-mode.
1285 *** New contributed file /org-eval-light.el/
1287 This module gives control over execution Emacs Lisp code
1288 blocks included in a file.
1290 Thanks to Eric Schulte also for this file.
1292 *** Link translation
1294 You can now configure Org to understand many links created
1295 with the Emacs Planner package, so you can cut text from
1296 planner pages and paste them into Org-mode files without
1297 having to re-write the links. Among other things, this means
1298 that the command =org-open-at-point-global= which follows
1299 links not only in Org-mode, but in arbitrary files like
1300 source code files etc, will work also with links created by
1301 planner. The following customization is needed to make all of
1304 #+begin_src emacs-lisp
1305 (setq org-link-translation-function
1306 'org-translate-link-from-planner)
1309 I guess an inverse translator could be written and integrated
1312 *** BBDB links may use regular expressions.
1314 This did work all along, but only now I have documented it.
1316 *** =yank-pop= works again after yanking an outline tree
1318 Samuel Wales had noticed that =org-yank= did mess up this
1319 functionality. Now you can use =yank-pop= again, the only
1320 restriction is that the so-yanked text will not be
1321 pro/demoted or folded.
1323 *** Link abbreviations can use %h to insert a url-encoded target value
1325 Thanks to Steve Purcell for a patch to this effect.
1327 *** Improved XHTML compliance
1329 Thanks to Sebastian Rose for pushing this.
1331 *** Many bug fixes again.
1336 - A region of entries can now be refiled with a single command
1337 - Fine-tuning the behavior of `org-yank'
1338 - Formulas for clocktables
1339 - Better implementation of footnotes for HTML export
1340 - More languages for HTML export.
1344 *** A region of entries can now be refiled with a single command
1346 With =transient-make-mode= active (=zmacs-regions= under
1347 XEmacs), you can now select a region of entries and refile
1348 them all with a single =C-c C-w= command.
1350 Thanks to Samuel Wales for this useful proposal.
1352 *** Fine-tuning the behavior of =org-yank=
1354 The behavior of Org's yanking command has been further
1355 fine-tuned in order to avoid some of the small annoyances
1356 this command caused.
1358 - Calling =org-yank= with a prefix arg will stop any special
1359 treatment and directly pass through to the normal =yank=
1360 command. Therefore, you can now force a normal yank with
1363 - Subtrees will only be folded after a yank if doing so will
1364 now swallow any non-white characters after the yanked text.
1365 This is, I think a really important change to make the
1366 command work more sanely.
1368 *** Formulas for clocktables
1370 You can now add formulas to a clock table, either by hand, or
1371 with a =:formula= parameter. These formulas can be used to
1372 create additional columns with further analysis of the
1375 Thanks to Jurgen Defurne for triggering this addition.
1377 *** Better implementation of footnotes for HTML export
1379 The footnote export in 6.11 really was not good enough. Now
1380 it works fine. If you have customized
1381 =footnote-section-tag=, make sure that your customization is
1382 matched by =footnote-section-tag-regexp=.
1384 Thanks to Sebastian Rose for pushing this change.
1386 *** More languages for HTML export.
1388 More languages are supported during HTML export. This is
1389 only relevant for the few special words Org inserts, like
1390 "Table of Contents", or "Footnotes". Also the encoding
1391 issues with this feature seem to be solved now.
1393 Thanks to Sebastian Rose for pushing me to fix the encoding
1400 - Yanking subtree with =C-y= now adjusts the tree level
1401 - State changes can now be shown in the log mode in the agenda
1402 - Footnote in HTML export are now collected at the end of the document
1403 - HTML export now validates again as XHTML
1404 - The clock can now be resumed after exiting and re-starting Emacs
1405 - Clock-related data can be saved and resumed across Emacs sessions
1406 - Following file links can now use C-u C-u to force use of an external app
1407 - Inserting absolute files names now abbreviates links with "~"
1408 - Links to attachment files
1409 - Completed repeated tasks listed briefly in agenda
1410 - Remove buffers created during publishing are removed
1414 *** Yanking subtree with =C-y= now adjusts the tree level
1415 When yanking a cut/copied subtree or a series of trees, the
1416 normal yank key =C-y= now adjusts the level of the tree to
1417 make it fit into the current outline position, without losing
1418 its identity, and without swallowing other subtrees.
1420 This uses the command =org-past-subtree=. An additional
1421 change in that command has been implemented: Normally, this
1422 command picks the right outline level from the surrounding
1423 *visible* headlines, and uses the smaller one. So if the
1424 cursor is between a level 4 and a level 3 headline, the tree
1425 will be pasted as level 3. If the cursor is actually *at*
1426 the beginning of a headline, the level of that headline will
1427 be used. For example, lets say you have a tree like this:
1433 ,(2)* Level one again
1436 with (1) and (2) indicating possible cursor positions for the
1437 insertion. When at (1), the tree will be pasted as level 2.
1438 When at (2), it will be pasted as level 1.
1440 If you do not want =C-y= to behave like this, configure the
1441 variable =org-yank-adjusted-subtrees=.
1443 Thanks to Samuel Wales for this idea and a partial implementation.
1445 *** State changes can now be shown in the log mode in the agenda
1447 If you configure the variable =org-agenda-log-mode-items=,
1448 you can now request that all logged state changes be included
1449 in the agenda when log mode is active. If you find this too
1450 much for normal applications, you can also temporarily
1451 request the inclusion of state changes by pressing =C-u l= in
1454 This was a request by Hsiu-Khuern Tang.
1456 You can also press `C-u C-u l' to get *only* log items in the
1457 agenda, withour any timestamps/deadlines etc.
1459 *** Footnote in HTML export are now collected at the end of the document
1460 Previously, footnotes would be left in the document where
1461 they are defined, now they are all collected and put into a
1462 special =<div>= at the end of the document.
1464 Thanks to Sebastian Rose for this request.
1466 *** HTML export now validates again as XHTML.
1468 Thanks to Sebastian Rose for pushing this cleanup.
1470 *** The clock can now be resumed after exiting and re-starting Emacs
1472 If the option =org-clock-in-resume= is t, and the first clock
1473 line in an entry is unclosed, clocking into that task resumes
1474 the clock from that time.
1476 Thanks to James TD Smith for a patch to this effect.
1478 *** Clock-related data can be saved and resumed across Emacs sessions
1480 The data saved include the contents of =org-clock-history=,
1481 and the running clock, if there is one.
1483 To use this, you will need to add to your .emacs
1485 #+begin_src emacs-lisp
1486 (setq org-clock-persist t)
1487 (setq org-clock-in-resume t)
1488 (org-clock-persistence-insinuate)
1491 Thanks to James TD Smith for a patch to this effect.
1493 *** Following file links can now use C-u C-u to force use of an external app.
1495 So far you could only bypass your setup in `org-file-apps'
1496 and force opening a file link in Emacs by using a =C-u= prefix arg
1497 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
1498 an external application. Which external application depends
1499 on your system. On Mac OS X and Windows, =open= is used. On
1500 a GNU/Linux system, the mailcap settings are used.
1502 This was a proposal by Samuel Wales.
1504 *** Inserting absolute files names now abbreviates links with "~".
1506 Inserting file links with =C-u C-c C-l= was buggy if the
1507 setting of `org-link-file-path-type' was `adaptive' (the
1508 default). Absolute file paths were not abbreviated relative
1509 to the users home directory. This bug has been fixed.
1511 Thanks to Matt Lundin for the report.
1513 *** Links to attachment files
1515 Even though one of the purposes of entry attachments was to
1516 reduce the number of links in an entry, one might still want
1517 to have the occasional link to one of those files. You can
1518 now use link abbreviations to set up a special link type that
1519 points to attachments in the current entry. Note that such
1520 links will only work from within the same entry that has the
1521 attachment, because the directory path is entry specific.
1522 Here is the setup you need:
1524 #+begin_src emacs-lisp
1525 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
1528 After this, a link like this will work
1531 [[att:some-attached-file.txt]]
1533 This was a proposal by Lindsay Todd.
1535 *** Completed repeated tasks listed briefly in agenda
1537 When a repeating task, listed in the daily/weekly agenda under
1538 today's date, is completed from the agenda, it is listed as
1539 DONE in the agenda until the next update happens. After the
1540 next update, the task will have disappeared, of course,
1541 because the new date is no longer today.
1543 *** Remove buffers created during publishing are removed
1545 Buffers that are created during publishing are now deleted
1546 when the publishing is over. At least I hope it works like this.
1552 - Secondary agenda filtering is becoming a killer feature
1553 - Setting tags has now its own binding, =C-c C-q=
1554 - Todo state changes can trigger tag changes
1555 - C-RET will now always insert a new headline, never an item.
1556 - Customize org-mouse.el feature set to free up mouse events
1557 - New commands for export all the way to PDF (through LaTeX)
1558 - Some bug fixed for LaTeX export, more bugs remain.
1562 *** Enhancements to secondary agenda filtering
1564 This is, I believe, becoming a killer feature. It allows you
1565 to define fewer and more general custom agenda commands, and
1566 then to do the final narrowing to specific tasks you are
1567 looking for very quickly, much faster than calling a new
1570 If you have not tries this yet, you should!
1572 **** You can now refining the current filter by an additional criterion
1573 When filtering an existing agenda view with =/=, you can
1574 now narrow down the existing selection by an additional
1575 condition. Do do this, use =\= instead of =/= to add the
1576 additional criterion. You can also press =+= or =-= after
1577 =/= to add a positive or negative condition. A condition
1578 can be a TAG, or an effort estimate limit, see below.
1580 **** It is now possible to filter for effort estimates
1581 This means to filter the agenda for the value of the Effort
1582 property. For this you should best set up global allowed
1583 values for effort estimates, with
1585 #+begin_src emacs-lisp
1586 (setq org-global-properties
1587 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
1590 You may then select effort limits with single keys in the
1591 filter. It works like this: After =/= or =\=, first select
1592 the operator which you want to use to compare effort
1595 : < Select entries with effort smaller than or equal to the limit
1596 : > Select entries with effort larger than or equal to the limit
1597 : = Select entries with effort equal to the limit
1599 After that, you can press a single digit number which is
1600 used as an index to the allowed effort estimates.
1602 If you do not use digits to fast-select tags, you can even
1603 skip the operator, which will then default to
1604 `org-agenda-filter-effort-default-operator', which is by
1607 Thanks to Manish for the great idea to include fast effort
1608 filtering into the agenda filtering process.
1610 **** The mode line will show the active filter
1611 For example, if there is a filter in place that does select
1612 for HOME tags, against EMAIL tags, and for tasks with an
1613 estimated effort smaller than 30 minutes, the mode-line with
1614 show =+HOME-EMAIL+<0:30=
1616 **** The filter now persists when the agenda view is refreshed
1617 All normal refresh commands, including those that move the
1618 weekly agenda from one week to the next, now keep the
1619 current filter in place.
1621 You need to press =/ /= to turn off the filter. However,
1622 when you run a new agenda command, for example going from
1623 the weekly agenda to the TODO list, the filter will be
1626 *** Setting tags has now its own binding, =C-c C-q=
1628 You can still use =C-c C-c= on a headline, but the new
1629 binding should be considered as the main binding for this
1630 command. The reasons for this change are:
1632 - Using =C-c C-c= for tags is really out of line with other
1635 - I hate it in Remember buffers when I try to set tags and I
1636 cannot, because =C-c C-c= exits the buffer :-(
1638 - =C-c C-q= will also work when the cursor is somewhere down
1639 in the entry, it does not have to be on the headline.
1641 *** Todo state changes can trigger tag changes
1643 The new option =org-todo-state-tags-triggers= can be used to
1644 define automatic changes to tags when a TODO state changes.
1645 For example, the setting
1647 : (setq org-todo-state-tags-triggers
1648 : '((done ("Today" . nil) ("NEXT" . nil))
1649 : ("WAITING" ("Today" . t))))
1651 will make sure that any change to any of the DONE states will
1652 remove tags "Today" and "NEXT", while switching to the
1653 "WAITING" state will trigger the tag "Today" to be added.
1655 I use this mostly to get rid of TODAY and NEXT tags which I
1656 apply to select an entry for execution in the near future,
1657 which I often prefer to specific time scheduling.
1659 *** C-RET will now always insert a new headline, never an item.
1660 The new headline is inserted after the current subtree.
1662 Thanks to Peter Jones for patches to fine-tune this behavior.
1664 *** Customize org-mouse.el feature set
1665 There is a new variable =org-mouse-features= which gives you
1666 some control about what features of org-mouse you want to
1667 use. Turning off some of the feature will free up the
1668 corresponding mouse events, or will avoid activating special
1669 regions for mouse clicks. By default I have urned off the
1670 feature to use drag mouse events to move or promote/demote
1671 entries. You can of course turn them back on if you wish.
1673 This variable may still change in the future, allowing more
1674 fine-grained control.
1676 *** New commands for export to PDF
1678 This is using LaTeX export, and then processes it to PDF
1681 : C-c C-e p process to PDF.
1682 : C-c C-e d process to PDF, and open the file.
1685 - \usepackage{graphicx} is now part of the standard class
1687 - Several bugs fixed, but definitely not all of them :-(
1689 *** New option `org-log-state-notes-insert-after-drawers'
1691 Set this to =t= if you want state change notes to be inserted
1692 after any initial drawers, i.e drawers the immediately follow
1693 the headline and the planning line (the one with
1694 DEADLINE/SCHEDULED/CLOSED information).
1698 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1702 *** =org-file-apps= now uses regular repressions instead of extensions
1703 Just like in =auto-mode-alist=, car's in the variable
1704 =org-file-apps= that are strings are now interpreted as
1705 regular expressions that are matched against a file name. So
1706 instead of "txt", you should now write "\\.txt\\'" to make
1707 sure the matching is done correctly (even though "txt" will
1708 be recognized and still be interpreted as an extension).
1710 There is now a shortcut to get many file types visited by
1711 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
1712 any files that are matched by `auto-mode-alist' will be
1715 *** Changes to the attachment system
1717 - The default method to attach a file is now to copy it
1718 instead of moving it.
1719 - You can modify the default method using the variable
1720 `org-attach-method'. I believe that most Unix people want
1721 to set it to `ln' to create hard links.
1722 - The keys =c=, =m=, and =l= specifically select =copy=,
1723 =move=, or =link=, respectively, as the attachment method
1724 for a file, overruling `org-attach-method'.
1725 - To create a new attachment as an Emacs buffer, you have not
1726 now use =n= instead of =c=.
1727 - The file list is now always retrieved from the directory
1728 itself, not from the "Attachments" property. We still
1729 keep this property by default, but you can turn it off, by
1730 customizing the variable =org-attach-file-list-property=.
1734 ** Incompatible changes
1736 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
1738 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
1742 *** The default structure of IDs has changed
1744 IDs created by Org have changed a bit:
1745 - By default, there is no prefix on the ID. There used to be
1746 an "Org" prefix, but I now think this is not necessary.
1747 - IDs use only lower-case letters, no upper-case letters
1748 anymore. The reason for this is that IDs are now also used
1749 as directory names for org-attach, and some systems do not
1750 distinguish upper and lower case in the file system.
1751 - The ID string derived from the current time is now
1752 /reversed/ to become an ID. This assures that the first
1753 two letters of the ID change fast, so hat it makes sense to
1754 split them off to create subdirectories to balance load.
1755 - You can now set the `org-id-method' to `uuidgen' on systems
1758 *** =C-c C-a= no longer calls `show-all'
1760 The reason for this is that =C-c C-a= is now used for the
1761 attachment system. On the rare occasions that this command
1762 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
1764 *** New attachment system
1766 You can now attach files to each node in the outline tree.
1767 This works by creating special directories based on the ID of
1768 an entry, and storing files in these directories. Org can
1769 keep track of changes to the attachments by automatically
1770 committing changes to git. See the manual for more
1773 Thanks to John Wiegley who contributed this fantastic new
1774 concept and wrote org-attach.el to implement it.
1776 *** New remember template escapes
1778 : %^{prop}p to insert a property
1779 : %k the heading of the item currently being clocked
1780 : %K a link to the heading of the item currently being clocked
1782 Also, when you exit remember with =C-2 C-c C-c=, the item
1783 will be filed as a child of the item currently being
1784 clocked. So the idea is, if you are working on something and
1785 think of a new task related to this or a new note to be
1786 added, you can use this to quickly add information to that
1789 Thanks to James TD Smith for a patch to this effect.
1791 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
1793 Thanks to James TD Smith for a patch to this effect.
1795 *** New file in contrib: lisp/org-checklist.el
1797 This module deals with repeated tasks that have checkbox
1800 Thanks to James TD Smith for this contribution.
1802 *** New in-buffer setting #+STYLE
1804 It can be used to locally set the variable
1805 `org-export-html-style-extra'. Several such lines are
1806 allowed-, they will all be concatenated. For an example on
1807 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1813 - Filtering existing agenda views with respect to a tag
1814 - Editing fixed-width regions with picture or artist mode
1815 - /org-plot.el/ is now part of Org
1816 - Tags can be used to select the export part of a document
1817 - Prefix interpretation when storing remember notes
1818 - Yanking inserts folded subtrees
1819 - Column view capture tables can have formulas, plotting info
1820 - In column view, date stamps can be changed with S-cursor keys
1821 - The note buffer for clocking out now mentions the task
1822 - Sorting entries alphabetically ignores TODO keyword and priority
1823 - Agenda views can sort entries by TODO state
1824 - New face =org-scheduled= for entries scheduled in the future.
1825 - Remember templates for gnus links can use the :to escape.
1826 - The file specification in a remember template may be a function
1827 - Categories in iCalendar export include local tags
1828 - It is possible to define filters for column view
1829 - Disabling integer increment during table Field copy
1830 - Capturing column view is on `C-c C-x i'
1831 - And tons of bugs fixed.
1834 ** Incompatible changes
1836 *** Prefix interpretation when storing remember notes has changed
1838 The prefix argument to the `C-c C-c' command that finishes a
1839 remember process is now interpreted differently:
1841 : C-c C-c Store the note to predefined file and headline
1842 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1843 : in its new location.
1844 : C-1 C-c C-c Select the storage location interactively
1845 : C-0 C-c C-c Re-use the last used location
1847 This was requested by John Wiegley.
1849 *** Capturing column view is now on `C-c C-x i'
1851 The reason for this change was that `C-c C-x r' is also used
1852 as a tty key replacement.
1854 *** Categories in iCalendar export now include local tags
1856 The locally defined tags are now listed as categories when
1857 exporting to iCalendar format. Org's traditional file/tree
1858 category is now the last category in this list. Configure
1859 the variable =org-icalendar-categories= to modify or revert
1862 This was a request by Charles Philip Chan.
1866 *** Secondary filtering of agenda views.
1868 You can now easily and interactively filter an existing
1869 agenda view with respect to a tag. This command is executed
1870 with the =/= key in the agenda. You will be prompted for a
1871 tag selection key, and all entries that do not contain or
1872 inherit the corresponding tag will be hidden. With a prefix
1873 argument, the opposite filter is applied: entries that
1874 do have the tag will be hidden.
1876 This operation only /hides/ lines in the agenda buffer, it
1877 does not remove them. Changing the secondary filtering does
1878 not require a new search and is very fast.
1880 If you press TAB at the tag selection prompt, you will be
1881 switched to a completion interface to select a tag. This is
1882 useful when you want to select a tag that does not have a
1883 direct access character.
1885 A double =/ /= will restore the original agenda view by
1886 unhiding any hidden lines.
1888 This functionality was John Wiegley's idea. It is a simpler
1889 implementation of some of the query-editing features proposed
1890 and implemented some time ago by Christopher League (see the
1891 file contrib/lisp/org-interactive-query.el).
1893 *** Editing fixed-width regions with picture or artist mode
1895 The command @<code>C-c '@</code> (that is =C-c= followed by a
1896 single quote) can now also be used to switch to a special
1897 editing mode for fixed-width sections. The default mode is
1898 =artist-mode= which allows you to create ASCII drawings.
1900 It works like this: Enter the editing mode with
1901 @<code>C-c '@</code>. An indirect buffer will be created and
1902 narrowed to the fixed-width region. Edit the drawing, and
1903 press @<code>C-c '@</code> again to exit.
1905 Lines in a fixed-width region should be preceded by a colon
1906 followed by at least one space. These will be removed during
1907 editing, and then added back when you exit the editing mode.
1909 Using the command in an empty line will create a new
1912 This new feature arose from a discussion involving Scott
1913 Otterson, Sebastian Rose and Will Henney.
1915 *** /org-plot.el/ is now part of Org.
1917 You can run it by simple calling org-plot/gnuplot.
1918 Documentation is not yet included with Org, please refer to
1919 http://github.com/eschulte/org-plot/tree/master until we have
1920 moved the docs into Org or Worg.
1922 Thanks to Eric Schulte for this great contribution.
1924 *** Tags can be used to select the export part of a document
1926 You may now use tags to select parts of a document for
1927 inclusion into the export, and to exclude other parts. This
1928 behavior is governed by two new variables:
1929 =org-export-select-tags= and =org-export-exclude-tags=.
1930 These default to =("export")= and =("noexport")=, but can be
1931 changed, even to include a list of several tags.
1933 Org first checks if any of the /select/ tags is present in
1934 the buffer. If yes, all trees that do not carry one of these
1935 tags will be excluded. If a selected tree is a subtree, the
1936 heading hierarchy above it will also be selected for export,
1937 but not the text below those headings. If none of the select
1938 tags is found anywhere in the buffer, the whole buffer will
1939 be selected for export. Finally, all subtrees that are
1940 marked by any of the /exclude/ tags will be removed from the
1943 You may set these tags with in-buffer options
1944 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1946 I love this feature. Thanks to Richard G Riley for coming
1949 *** Prefix interpretation when storing remember notes
1951 The prefix argument to the `C-c C-c' command that finishes a
1952 remember process is now interpreted differently:
1954 : C-c C-c Store the note to predefined file and headline
1955 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1956 : in its new location.
1957 : C-1 C-c C-c Select the storage location interactively
1958 : C-0 C-c C-c Re-use the last used location
1960 This was requested by John Wiegley.
1962 *** Yanking inserts folded subtrees
1964 If the kill is a subtree or a sequence of subtrees, yanking
1965 them with =C-y= will leave all the subtrees in a folded
1966 state. This basically means, that kill and yank are now
1967 much more useful in moving stuff around in your outline. If
1968 you do not like this, customize the variable
1969 =org-yank-folded-subtrees=.
1971 Right now, I am only binding =C-y= to this new function,
1972 should I modify all bindings of yank? Do we need to amend
1975 This feature was requested by John Wiegley.
1977 *** Column view capture tables can have formulas, plotting info
1979 If you attach formulas and plotting instructions to a table
1980 capturing column view, these extra lines will now survive an
1981 update of the column view capture, and any formulas will be
1982 re-applied to the captured table. This works by keeping any
1983 continuous block of comments before and after the actual
1986 *** In column view, date stamps can be changed with S-cursor keys
1988 If a property value is a time stamp, S-left and S-right can
1989 now be used to shift this date around while in column view.
1991 This was a request by Chris Randle.
1993 *** The note buffer for clocking out now mentions the task
1995 This was a request by Peter Frings.
1997 *** Sorting entries alphabetically ignores TODO keyword and priority
1999 Numerical and alphanumerical sorting now skips any TODO
2000 keyword or priority cookie when constructing the comparison
2001 string. This was a request by Wanrong Lin.
2003 *** Agenda views can sort entries by TODO state
2005 You can now define a sorting strategy for agenda entries that
2006 does look at the TODO state of the entries. Sorting by TODO
2007 entry does first separate the non-done from the done states.
2008 Within each class, the entries are sorted not alphabetically,
2009 but in definition order. So if you have a sequence of TODO
2010 entries defined, the entries will be sorted according to the
2011 position of the keyword in this sequence.
2013 This follows an idea and sample implementation by Christian
2016 *** New face =org-scheduled= for entries scheduled in the future.
2018 This was a request by Richard G Riley.
2020 *** Remember templates for gnus links can now use the :to escape.
2022 Thanks to Tommy Lindgren for a patch to this effect.
2023 *** The file specification in a remember template may now be a function
2025 Thanks to Gregory Sullivan for a patch to this effect.
2027 *** Categories in iCalendar export now include local tags
2029 The locally defined tags are now listed as categories when
2030 exporting to iCalendar format. Org's traditional file/tree
2031 category is now the last category in this list. Configure
2032 the variable =org-icalendar-categories= to modify or revert
2035 This was a request by Charles Philip Chan.
2037 *** It is now possible to define filters for column view
2039 The filter can modify the value that will be displayed in a
2040 column, for example it can cut out a part of a time stamp.
2041 For more information, look at the variable
2042 =org-columns-modify-value-for-display-function=.
2044 *** Disabling integer increment during table field copy
2046 Prefix arg 0 to S-RET does the trick.
2048 This was a request by Chris Randle.
2053 For older Changes, see [[file:Changes_old.org]]