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
20 - Capture state change notes into a drawer
21 - Clock lines are now captured into the LOGBOOK drawer as well
22 - Added org-R.el to contrib directory
23 - Allow individual formatting of each TODO keyword in HTML export
24 - New hooks for add-ons to tap into context-sensitive commands
25 - Publishing files irrespective of extension
26 - New variable index in the manual
27 - The ORDERED property also influences checkboxes
28 - The ORDERED property can be tracked with a tag
29 - You may now specify line breaks in the fast tags interface
30 - When a TODO is blocked by checkboxes, keep it visible in agenda
31 - LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc.
33 ** Incompatible changes
35 - CLOCK lines will now be captured into the LOGBOOK drawer.
36 See below for details.
40 *** Capture state change notes into a drawer
42 State change notes can now be captured into a drawer =LOGBOOK=,
43 to keep the entry tidy. If this is what you want, you will need
46 #+begin_src emacs-lisp
47 (setq org-log-into-drawer "LOGBOOK")
50 Thanks to Wanrong Lin for this proposal.
52 *** Clock lines are now captured into the LOGBOOK drawer as well
54 The =CLOCK= drawer will be abandoned, clock lines will now also
55 end up in a drawer =LOGBOOK=. The reason for this is that it's a
56 bit useless to have two different drawers for state change notes
57 and clock lines. If you wish to keep the old way, use
59 #+begin_src emacs-lisp
60 (setq org-clock-into-drawer "CLOCK")
63 *** Added org-R.el to contrib directory
65 Dan Davison has contributed /org-R.el/ which is now in the
66 contrib directory. Org-R performs numerical computations and
67 generates graphics. Data can come from org tables, or from csv
68 files; numerical output can be stored in the org buffer as org
69 tables, and links are created to files containing graphical
70 output. Although, behind the scenes, it uses R, you do not need
71 to know anything about R. Common operations, such as tabulating
72 discrete values in a column of an org table, are available "off
73 the shelf" by specifying options on lines starting with =#+R:=.
74 However, you can also provide raw R code to be evaluated. The
75 documentation is currently the worg tutorial at
76 http://orgmode.org/worg/org-tutorials/org-R/org-R.php
78 Thanks to Dan for this great contribution.
80 *** Allow individual formatting of each TODO keyword in HTML export
82 TODO keywords in HTML export have the CSS class =todo= or =done=.
83 In addition to this, each keyword has now itself as class, so you
84 could do this in your CSS file:
87 .todo { font-weight:bold; }
88 .done { font-weight:bold; }
90 .WAITING { color:orange; }
91 .DONE { color:green; }
94 Thanks to Wanrong Lin for this request, and to Sebastian Rose for
95 help with the implementation.
97 *** New hooks for add-ons to tap into context-sensitive commands
99 Some commands in Org are context-sensitive, they will execute
100 different functions depending on context. The most important
101 example is of course =C-c C-c=, but also the =M-cursor= keys fall
104 Org has now a system of hooks that can be used by add-on packages
105 to install their own functionality into these keys. See the
106 docstring of =org-ctrl-c-ctrl-c-hook= for details. The other
107 hooks are named like =org-metaleft-hook= or
108 =org-shiftmetaright-hook=.
110 *** Publishing files irrespective of extension
112 If you set the =:base-extension= property for a publishing
113 project to the symbol =any=, all files in the directory will be
114 published, irrespective of extension.
116 Thanks to Richard Klinda for a patch to this effect.
118 *** New variable index in the manual
120 A new index in the manual lists all variables mentioned in the
121 manual, about 200 variables in total.
123 *** The ORDERED property also influences checkboxes
125 When an entry has the ORDERED property set, checkboxes in
126 the entry must be completed in order. This was already the case
127 for children TODO items, now it also applies for checkboxes.
129 Thanks to Rainer Stengele for this proposal.
131 *** The ORDERED property can be tracked with a tag
133 The =ORDERED= property is used to flag an entry so that subtasks
134 (both children TODO items and checkboxes) must be completed in
135 order. This property is most easily toggled with the command
136 =C-c C-x o=. A property was chosen for this functionality,
137 because this should be a behavior local to the current task, not
138 inherited like tags. However, properties are normally
139 invisible. If you would like visual feedback on the state of
140 this property, configure the variable
141 =org-track-ordered-property-with-tag=. If you then use =C-c C-x
142 o= to toggle the property, a tag will be toggled as well, for
145 Note that the tag itself has no meaning for the behavior of TODO
146 items and checkboxes, and that changing the tag with the usual
147 tag commands will not influence the property and therefore the
148 behavior of TODO and checkbox commands.
150 *** You may now specify line breaks in the fast tags interface
152 Up to now, the fast tags interface tried to lump as many tags as
153 possible into a single line, with the exception that groups would
154 always be on a line by themselves.
156 Now, if you use several lines to define your tags, like
159 ,#+TAGS: aa(a) bb(b) cc(c)
160 ,#+TAGS: dd(d) ee(e) ff(f)
163 then there will also be a line break after the "cc" tag in the
164 fast tag selection interface. You may also write
167 ,#+TAGS: aa(a) bb(b) cc(c) \n dd(d) ee(e) ff(f)
170 to achieve the same effect, and you can use =\n= several times in
171 order to produce empty lines. In =org-tag-alist=, newlines are
172 represented as =(:newline)=.
174 Thanks to Christopher Suckling for a patch to this effect.
176 *** When a TODO is blocked by checkboxes, keep it visible in agenda
178 When the variable =org-agenda-dim-blocked-tasks= is set to
179 =invisible=, tasks that are blocked will not be visible in the
180 agenda. If the blocking is due to child TODO entries, this does
181 make sense because the children themselves will show up in the
184 However, as John Rakestraw has [[http://thread.gmane.org/gmane.emacs.orgmode/10939][pointed out]], if the blocking is
185 done by checkboxes, no trace of these subtasks is left.
186 Therefore, when the blocking is done by checkboxes, we now
187 overrule the =invisible= setting and replace it with mere dimming
190 *** LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc.
192 If you configure =org-export-latex-import-inbuffer-stuff=,
193 in-buffer definitions like #+TITLE will be made available in the
194 LaTeX file as =\orgTITLE=.
196 This was a request by Russel Adams.
201 *** org-choose.el by Tom Breton is now included
203 Org-choose helps documenting a decision-making process by using
204 TODO keywords for different degrees of /chosenness/, and by
205 automatically keeping a set of alternatives in a consistent state.
207 Documentation for /org-choose.el/ is available [[http://orgmode.org/worg/org-contrib/org-choose.php][here]].
209 This package inserts itself into Org using hooks, so if other
210 people would like to do interesting stuff with TODO keywords for
211 special purposes, looking at Tom's code might be a good way to
214 Thanks to Tom for this interesting contribution!
216 *** orgmode.org and Worg css works now better on IE
218 Thanks to Sebastian Rose for making these changes.
220 *** When exporting a subtree, headline levels are now relative to parent
222 This was reported as a bug by William Henney and is fixed now.
224 *** Inactive dates in tables can be used for sorting.
226 When sorting table fields or entries by date, Org first tries to
227 find an active date, and, if none exist, uses a passive date if
230 This was a request by Hsui-Khuen Tang
232 *** The default for =org-return-follows-link= is back to =nil=
234 Setting it to =t= violates Emacs rules to some extent. The
235 internal implementation of this has been improved, so setting it
236 to =t= should now be pretty stable.
238 *** Automatic scheduling of siblings with org-depend.el
240 The sibling of a DONE task can now automatically be scheduled.
242 This was a patch by Andrew Hyatt.
244 *** New skipping conditions
246 The functions =org-agenda-skip-entry-if= and
247 =org-agenda-skip-subtree-if= now accept =timestamp= and
248 =nottimestamp= as additional conditions.
250 This was in response to a request by Saurabh Agrawal.
256 *** Changes to some default values of variables:
258 Here are the new default values:
261 (setq org-return-follows-link t)
263 (setq org-use-fast-todo-selection t)
265 (setq org-yank-adjusted-subtrees nil)
267 (setq org-tags-column -77)
269 (setq org-agenda-sorting-strategy
270 '((agenda time-up priority-down category-keep)
271 (todo time-up priority-down category-keep)
272 (tags time-up priority-down category-keep)
273 (search category-keep)))
276 *** Final cleanup for Emacs 21.1 pretest
282 *** Support for simple TODO dependencies
284 John Wiegley's code for enforcing simple TODO dependencies has
285 been integrated into Org-mode. Thanks John!
287 The structure of Org files (hierarchy and lists) makes it easy to
288 define TODO dependencies. A parent TODO task should not be
289 marked DONE until all subtasks (defined as children tasks) are
290 marked as DONE. And sometimes there is a logical sequence to a
291 number of (sub)tasks, so that one task cannot be acted upon
292 before all siblings above it are done. If you customize the
293 variable =org-enforce-todo-dependencies=, Org will block entries
294 from changing state while they have children that are not DONE.
295 Furthermore, if an entry has a property =ORDERED=, each of its
296 children will be blocked until all earlier siblings are marked
297 DONE. Here is an example:
300 ,* TODO Blocked until (two) is done
309 ,** TODO b, needs to wait for (a)
310 ,** TODO c, needs to wait for (a) and (b)
313 The command =C-c C-x o= toggles the value of the =ORDERED=
316 The variable =org-agenda-dim-blocked-tasks= controls how blocked
317 entries should appear in the agenda, where they can be dimmed or
320 Furthermore, you can use the variable
321 =org-enforce-todo-checkbox-dependencies= to block TODO entries
322 from switching to DONE while any checkboxes are unchecked in the entry.
324 *** Support for shift-selection in Emacs 23
326 Customize the variable =org-support-shift-select= to use S-cursor
327 key for selecting text. Make sure that you carefully read the
328 docstring of that variable first.
330 *** Adding and removing checkboxes from many lines
332 The command =C-c C-x C-b= normally toggles checkbox status in the
333 current line, or in all lines in the region. With prefix
334 argument it now either adds or removes the checkbox.
336 This was a requested by Daniel Clemente.
342 - Improved behavior of conversion commands =C-c -= and =C-c *=
343 - Table formulas may now reference fields in other tables
344 - A final hline is imagined in each table, for the sake of references
345 - A tags-todo search can now ignore timestamped items
346 - =\par= can be used to force a paragraph break, also in footnotes
351 *** Improved behavior of conversion commands =C-c -= and =C-c *=
353 The conversion commands =C-c -= and =C-c *= are now better
354 behaved and therefore more useful, I hope.
356 If there is an active region, these commands will act on the
357 region, otherwise on the current line.
359 - C-c - :: This command turns headings or normal lines into
360 items, or items into normal lines. When there is a
361 region, everything depends on the first line of the
363 - if it is a item, turn all items in the region into
365 - if it is a headline, turn all headlines in the region
367 - if it is a normal line, turn all lines into items.
368 - special case: if there is no active region and the
369 current line is an item, cycle the bullet type of the
371 - C-c * :: This command turns items and normal lines into
372 headings, or headings into normal lines. When there is
373 a region, everything depends on the first line of the
375 - if it is a item, turn all items in the region into
377 - if it is a headline, turn all headlines in the region
379 - if it is a normal line, turn all lines into headlines.
381 *** Table formulas may now reference fields in other tables
383 You may now reference constants, fields and ranges from a
384 different table, either in the current file or even in a
385 different file. The syntax is
387 : remote(NAME-OR-ID,REF)
389 where /NAME/ can be the name of a table in the current file as
390 set by a =#+TBLNAME: NAME= line before the table. It can also be
391 the ID of an entry, even in a different file, and the reference
392 then refers to the first table in that entry. /REF/ is an
393 absolute field or range reference, valid in the referenced table.
394 Note that since there is no "current filed" for the remote table,
395 all row and column references must be absolute, not relative.
397 *** A final hline is imagined in each table, for the sake of references
399 Even if a table does not end with a hline (mine never do because I
400 think it is not pretty), for the sake of references you can
401 assume there is one. So in the following table
410 a reference like =@I$1..@II$2= will now work.
412 *** A tags-todo search can now ignore timestamped items
413 The variables =org-agenda-todo-ignore-with-date=,
414 =org-agenda-todo-ignore-with-date=, and
415 =org-agenda-todo-ignore-with-date= make it possible to
416 exclude TODO entries which have this kind of planning info
417 associated with them. This is most useful for people who
418 schedule everything, and who use the TODO list mainly to find
419 things that are not yet scheduled. Thomas Morgan pointed out
420 that also the tags-todo search may serve exactly this
421 purpose, and that it might be good to have a way to make
422 these variables also apply to the tags-todo search. I can
423 see that, but could not convince myself to make this the
424 default. A new variable must be set to make this happen:
425 =org-agenda-tags-todo-honor-ignore-options=.
427 *** =\par= can be used to force a paragraph break, also in footnotes
429 The LaTeX idiom =\par= will insert a paragraph break at that
430 location. Normally you would simply leave an empty line to get
431 such a break, but this is useful for footnotes whose
432 definitions may not contain empty lines.
435 ** Incompatible changes
437 *** Short examples must have a space after the colon
439 Short literal examples can be created by preceding lines
440 with a colon. Such lines must now have a space after the
441 colon. I believe this is already general practice, but now
442 it must be like this. The only exception are lines what are
443 empty except for the colon.
447 *** Include files can now also process switches
449 The example and src switches like =-n= can now also be added
450 to include file statements:
452 : #+INCLUDE "~/.emacs" src emacs-lisp -n -r
454 Thanks to Manish for pointing out that this was not yet
457 *** Examples can be exported to HTML as text areas
459 You can now specify a =-t= switch to an example or src block,
460 to make it export to HTML as a text area. To change the
461 defaults for height (number of lines in the example) and
462 width of this area (80), use the =-h= and =-w= switches.
464 Thanks to Ulf Stegemann for driving this development.
466 *** LaTeX_CLASS can be given as a property
468 When exporting a single subtree by selecting it as a region
469 before export, the LaTeX class for the export will be taken
470 from the =LaTeX_CLASS= property of the entry if present.
472 Thanks to Robert Goldman for this request.
474 *** Better handling of inlined images in different backends
476 Two new variables govern which kind of files can be inlined
477 during export. These are
478 =org-export-html-inline-image-extensions= and
479 =org-export-latex-inline-image-extensions=. Remember that
480 links are turned into an inline image if they are a pure link
481 with no description. HTML files can inline /.png/, /.jpg/,
482 and /.gif/ files, while LaTeX files, when processed with
483 /pdflatex/, can inline /.png/, /.jpg/, and /.pdf/ files.
484 These also represent the default settings for the new
485 variables. Note that this means that pure links to /.pdf/
486 files will be inlined - to avoid this for a particular link,
487 make sure that the link has a description part which is not
488 equal to the link part.
490 *** Links by ID now continue to work in HTML exported files
492 If you make links by ID, these links will now still work in
493 HTML exported files, provided that you keep the relative path
494 from link to target file the same.
496 Thanks to Friedrich Delgado Friedrichs for pushing this over
499 *** The relative timer can be paused
501 The new command `C-c C-x ,' will pause the relative timer.
502 When the relative timer is running, its value will be shown
503 in the mode line. To get rid of this display, you need to
504 really stop the timer with `C-u C-c C-x ,'.
506 Thanks to Alan Davis for driving this change.
508 *** The attachment directory may now be chosen by the user
510 Instead of using the automatic, unique directory related to
511 the entry ID, you can also use a chosen directory for the
512 attachments of an entry. This directory is specified by the
513 ATTACH_DIR property. You can use `C-c C-a s' to set this
516 Thanks to Jason Jackson for this proposal.
518 *** You can use a single attachment directory for a subtree
520 By setting the property ATTACH_DIR_INHERIT, you can now tell
521 Org that children of the entry should use the same directory
522 for attachments, unless a child explicitly defines its own
523 directory with the ATTACH_DIR property. You can use the
524 command `C-c C-a i' to set this property in an entry.
531 - Line numbers and references in literal examples
532 - New hooks for export preprocessing
533 - Capture column view into a different file
539 Org-mode now directly supports the creation of footnotes. In
540 contrast to the /footnote.el/ package, Org-mode's footnotes are
541 designed for work on a larger document, not only for one-off
542 documents like emails. The basic syntax is similar to the one
543 used by /footnote.el/, i.e. a footnote is defined in a paragraph
544 that is started by a footnote marker in square brackets in column
545 0, no indentation allowed. The footnote reference is simply the
546 marker in square brackets inside text. For example:
549 The Org homepage[fn:1] now looks a lot better than it used to.
551 [fn:1] The link is: http://orgmode.org
554 Org-mode extends the number-based syntax to /named/ footnotes and
555 optional inline definition. Using plain numbers as markers is
556 supported for backward compatibility, but not encouraged because
557 of possible conflicts with LaTeX syntax. Here are the valid
560 - [1] :: A plain numeric footnote marker.
562 - [fn:name] :: A named footnote reference, where `name' is a
563 unique label word or, for simplicity of automatic creation,
566 - [fn:: This is the inline definition of this footnote] :: A
567 LaTeX-like anonymous footnote where the definition is given
568 directly at the reference point.
570 - [fn:name: a definition] :: An inline definition of a footnote,
571 which also specifies a name for the note. Since Org allows
572 multiple references to the same note, you can then use use
573 `[fn:name]' to create additional references.
575 Footnote labels can be created automatically, or you create names
576 yourself. This is handled by the variable
577 =org-footnote-auto-label= and its corresponding =#+STARTUP=
578 keywords, see the docstring of that variable for details.
580 The following command handles footnotes:
582 - C-c C-x f :: The footnote action command. When the cursor is
583 on a footnote reference, jump to the definition. When it is
584 at a definition, jump to the (first) reference. Otherwise,
585 create a new footnote. Depending on the variable
586 `org-footnote-define-inline' (with associated =#+STARTUP=
587 options =fninline= and =nofninline=), the definitions will
588 be placed right into the text as part of the reference, or
589 separately into the location determined by the variable
590 =org-footnote-section=.
591 When this command is called with a prefix argument, a menu
592 of additional options is offered:
593 - s :: Sort the footnote definitions by reference sequence.
594 During editing, Org makes no effort to sort footnote
595 definitions into a particular sequence. If you want
596 them sorted, use this command, which will also move
597 entries according to =org-footnote-section=.
598 - n :: Normalize the footnotes by collecting all
599 definitions (including inline definitions) into a
600 special section, and then numbering them in
601 sequence. The references will then also be
602 numbers. This is meant to be the final step before
603 finishing a document (e.g. sending off an email).
604 The exporters do this automatically, and so could
605 something like `message-send-hook'.
606 - d :: Delete the footnote at point, and all references to it.
608 - C-c C-c :: If the cursor is on a footnote reference, jump to
609 the definition. If it is a the definition, jump back to the
610 reference. When called with a prefix argument at either
611 location, offer the same menu as `C-u C-c C-x f'.
613 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
614 corresponding definition/reference, and you can use the
615 usual commands to follow these links.
617 Org-mode's footnote support is designed so that it should also
618 work in buffers that are not in Org-mode, for example in email
619 messages. Just bind =org-footnote-action= to a global key like
622 The main trigger for this development came from a hook function
623 written by Paul Rivier, to implement named footnotes and to
624 convert them to numbered ones before export. Thanks, Paul!
626 Thanks also to Scot Becker for a thoughtful post bringing this
627 subject back onto the discussion table, and to Matt Lundin for
628 the idea of named footnotes and his prompt testing of the new
631 *** Line numbers and references in literal examples
633 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
634 do now allow optional line numbering in the example.
635 Furthermore, links to specific code lines are supported, greatly
636 increasing Org-mode's utility for writing tutorials and other
639 Code references use special labels embedded directly into the
640 source code. Such labels look like "(ref:name)" and must be
641 unique within a document. Org-mode links with "(name)" in the
642 link part will be correctly interpreted, both while working with
643 an Org file (internal links), and while exporting to the
644 different backends. Line numbering and code references are
645 supported for all three major backends, HTML, LaTeX, and ASCII.
646 In the HTML backend, hovering the mouse over a link to a source
647 line will remote-highlight the referenced code line.
649 The options for the BEGIN lines are:
651 - -n :: Number the lines in the example
652 - +n :: Like -n, but continue numbering from where the previous
654 - -r :: Remove the coderef cookies from the example, and replace
655 links to this reference with line numbers. This option
656 takes only effect if either -n or +n are given as well.
657 If -r is not given, coderefs simply use the label name.
658 - -l "fmt" :: Define a local format for coderef labels, see the
659 variable =org-coderef-label-format= for details. Use this
660 of the default syntax causes conflicts with the code in the
661 code snippet you are using.
666 #+begin_src emacs-lisp -n -r
667 (defmacro org-unmodified (&rest body) (ref:def)
668 "Execute body without changing `buffer-modified-p'."
669 `(set-buffer-modified-p (ref:back)
670 (prog1 (buffer-modified-p) ,@body)))
672 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
676 When exported, this is translated to:
677 #+begin_src emacs-lisp -n -r
678 (defmacro org-unmodified (&rest body) (ref:def)
679 "Execute body without changing `buffer-modified-p'."
680 `(set-buffer-modified-p (ref:back)
681 (prog1 (buffer-modified-p) ,@body)))
683 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
686 Thanks to Ilya Shlyakhter for proposing this feature set. Thanks
687 to Sebastian Rose for the key Javascript element that made the
688 remote highlighting possible.
690 *** New hooks for export preprocessing
691 The export preprocessor now runs more hooks, to allow
692 better-timed tweaking by user functions:
694 - =org-export-preprocess-hook= ::
695 Pretty much the first thing in the preprocessor. But org-mode
696 is already active in the preprocessing buffer.
698 - =org-export-preprocess-after-include-files-hook= ::
699 This is run after the contents of included files have been inserted.
701 - =org-export-preprocess-after-tree-selection-hook= ::
702 This is run after selection of trees to be exported has
703 happened. This selection includes tags-based selection, as
704 well as removal of commented and archived trees.
706 - =org-export-preprocess-before-backend-specifics-hook= ::
707 Hook run before backend-specific functions are called during preprocessing.
709 - =org-export-preprocess-final-hook= ::
710 Hook for preprocessing an export buffer. This is run as the
711 last thing in the preprocessing buffer, just before returning
712 the buffer string to the backend.
714 *** Capture column view into a different file
716 The :id parameter for the dynamic block capturing column view
717 can now truly be an ID that will also be found in a
718 different file. Also, it can be like =file:path/to/file=, to
719 capture the global column view from a different file.
721 Thanks to Francois Lagarde for his report that IDs outside
722 the current file would not work.
725 Cleanup of many small bugs, and one new feature.
729 *** References to last table row with special names
731 Fields in the last row of a table can now be referenced with
732 $LR1, $LR2, etc. These references can appear both on the
733 left hand side and right hand side of a formula.
737 This version reverses the introduction of @0 as a reference to
738 the last rwo in a table, because of a conflict with the use of
739 @0 for the current row.
744 - All known LaTeX export issues fixed
745 - Captions and attributes for figures and tables.
746 - Better implementation for entry IDs
747 - Spreadsheet references to the last table line.
748 - Old syntax for link attributes abandoned
750 ** Incompatible changes
751 *** Old syntax for link attributes abandoned
753 There used to be a syntax for setting link attributes for
754 HTML export by enclosing the attributes into double braces
755 and adding them to the link itself, like
758 [[./img/a.jpg{{alt="an image"}}] ]
761 This syntax is not longer supported, use instead
764 ,#+ATTR_HTML: alt="an image"
770 *** All known LaTeX export issues fixed
772 All the remaining issues with the LaTeX exporter have hopefully
773 been addressed in this release. In particular, this covers
774 quoting of special characters in tables and problems with
775 exporting files where the headline is in the first line, or with
778 *** Captions and attributes for figures and tables.
780 Tables, and Hyperlinks that represent inlined images, can now be
781 equipped with additional information that will be used during
782 export. The information will be taken from the following special
783 lines in the buffer and apply to the first following table or
786 - #+CAPTION: :: The caption of the image or table. This string
787 should be processed according to the export backend, but
788 this is not yet done.
790 - #+LABEL: :: A label to identify the figure/table for cross
791 references. For HTML export, this string will become the
792 ID for the ~<div class="figure">~ element that encapsulates
793 the image tag and the caption. For LaTeX export, this
794 string will be used as the argument of a ~\label{...}~
795 macro. These labels will be available for internal links
796 like ~[[label][Table] ]~.
798 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
799 added as attributes into the ~<img...>~ tag. This string
800 will not be processed, so it should have immediately the
803 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
805 For /images/, this string is directly inserted into
806 the optional argument of the ~\includegraphics[...]{file}~
807 command, to specify scaling, clipping and other options.
808 This string will not be processed, so it should have
809 immediately the right format, like =width=5cm,angle=90=.\\
810 For /tables/, this can currently contain the keyword
811 =longtable=, to request typesetting of the table using the
812 longtable package, which automatically distributes the table
813 over several pages if needed. Also, the attributes line may
814 contain an alignment string for the tabular environment, like
815 =longtable,align=l|lrl=
817 For LaTeX export, if either a caption or a label is given, the element
818 will be exported as a float, i.e. wrapped into a figure or table
821 *** Better implementation for entry IDs
823 Unique identifiers for entries can now be used more efficiently.
824 Internally, a hash array has replaced the alist used so far to
825 keep track of the files in which an ID is defined. This makes it
826 quite fast to find an entry by ID.
828 There is a new link type which looks like this:
831 id:GLOBALLY-UNIQUE-IDENTIFIER
834 This link points to a specific entry. When you move the entry to
835 a different file, for example if you move it to an archive
836 file, the link will continue to work.
838 The file /org-id.el/ contains an API that can be used to write
839 code using these identifiers, including creating IDs and finding
840 them wherever they are.
842 Org has its own method to create unique identifiers, but if the system
843 has /uuidgen/ command installed (Mac's and Linux systems generally
844 do), it will be used by default (a change compared to the earlier
845 implmentation, where you explicitdly had to opt for uuidgen). You can
846 also select the method by hand, using the variable =org-id-method=.
848 If the ID system ever gets confused about where a certain ID is, it
849 initiates a global scan of all agenda files with associated archives,
850 all files previously known containing any IDs, and all currently
851 visited Org-mode files to rebuild the hash. You can also initiate
852 this by hand: =M-x org-id-update-id-locations=. Running this command
853 will also dump into the =*Messages*= buffer information about any
854 duplicate IDs. These should not exist, and Org will never /make/ the
855 same ID twice, but if you /copy/ an entry with its properties,
856 duplicate IDs will inevitably be produced. Unfortunately, this is
857 unavoidable in a plain text system that allows you to edit the text in
858 arbitrary ways, and a portion of care on your side is needed to keep
861 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
862 This is also a change from previous versions where the file was
863 =~/.org=id-locations=. Therefore, you can remove this old file
864 if you have it. I am not sure what will happen if the =.emacs.d=
865 directory does not exists in your setup, but in modern Emacsen, I
866 believe it should exist. If you do not want to use IDs across
867 files, you can avoid the overhead with tracking IDs by
868 customizing the variable =org-id-track-globally=. IDs can then
869 still be used for links inside a single file.
871 IDs will also be used when you create a new link to an Org-mode
872 buffer. If you use =org-store-link= (normally at =C-c l=) inside
873 en entry in an Org-mode buffer, and ID property will be created
874 if it does not exist, and the stored link will be an =id:= link.
875 If you prefer the much less secure linking to headline text, you
876 can configure the variable =org-link-to-org-use-id=. The default
877 setting for this variable is =create-if-interactive=, meaning
878 that an ID will be created when you store a link interactively,
879 but not if you happen to be in an Org-mode file while you create
880 a remember note (which usually has a link to the place where you
881 were when starting remember).
883 *** Spreadsheet references to the last table line.
885 You may now use =@0= to reference the last dataline in a table
886 in a stable way. This is useful in particular for automatically
887 generated tables like the ones using /org-collector.el/ by Eric
893 - New relative timer to support timed notes
894 - Special faces can be set for individual tags
895 - The agenda shows now all tags, including inherited ones.
896 - Exclude some tags from inheritance.
897 - More special values for time comparisons in property searches
898 - Control for exporting meta data
899 - Cut and Paste with hot links from w3m to Org
900 - LOCATION can be inherited for iCalendar export
901 - Relative row references crossing hlines now throw an error
903 ** Incompatible Changes
905 *** Relative row references crossing hlines now throw an error
907 Relative row references in tables look like this: "@-4" which
908 means the forth row above this one. These row references are
909 not allowed to cross horizontal separator lines (hlines). So
910 far, when a row reference violates this policy, Org would
911 silently choose the field just next to the hline.
913 Tassilo Horn pointed out that this kind of hidden magic is
914 actually confusing and may cause incorrect formulas, and I do
915 agree. Therefore, trying to cross a hline with a relative
916 reference will now throw an error.
918 If you need the old behavior, customize the variable
919 `org-table-error-on-row-ref-crossing-hline'.
923 *** New relative timer to support timed notes
925 Org now supports taking timed notes, useful for example while
926 watching a video, or during a meeting which is also recorded.
929 Insert a relative time into the buffer. The first time
930 you use this, the timer will be started. When called
931 with a prefix argument, the timer is reset to 0.
934 Insert a description list item with the current relative
935 time. With a prefix argument, first reset the timer to 0.
938 Once the time list has been initiated, you can also use the
939 normal item-creating command to insert the next timer item.
942 Reset the timer without inserting anything into the buffer.
943 By default, the timer is reset to 0. When called with a
944 =C-u= prefix, reset the timer to specific starting
945 offset. The user is prompted for the offset, with a
946 default taken from a timer string at point, if any, So this
947 can be used to restart taking notes after a break in the
948 process. When called with a double prefix argument
949 =C-c C-u=, change all timer strings in the active
950 region by a certain amount. This can be used to fix timer
951 strings if the timer was not started at exactly the right
954 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
955 contributions to this idea.
957 *** Special faces can be set for individual tags
959 You may now use the variable =org-tag-faces= to define the
960 face used for specific tags, much in the same way as you can
961 do for TODO keywords.
963 Thanks to Samuel Wales for this proposal.
965 *** The agenda shows now all tags, including inherited ones.
967 This request has come up often, most recently it was
968 formulated by Tassilo Horn.
970 If you prefer the old behavior of only showing the local
971 tags, customize the variable =org-agenda-show-inherited-tags=.
973 *** Exclude some tags from inheritance.
975 So far, the only way to select tags for inheritance was to
976 allow it for all tags, or to do a positive selection using
977 one of the more complex settings for
978 `org-use-tag-inheritance'. It may actually be better to
979 allow inheritance for all but a few tags, which was difficult
980 to achieve with this methodology.
982 A new option, `org-tags-exclude-from-inheritance', allows to
983 specify an exclusion list for inherited tags.
985 *** More special values for time comparisons in property searches
987 In addition to =<now>=, =<today>=, =<yesterday>=, and
988 =<tomorrow>=, there are more special values accepted now in
989 time comparisons in property searches: You may use strings
990 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
991 week, month, and year, respectively
993 Thanks to Linday Todd for this proposal.
995 *** Control for exporting meta data
997 All the metadata in a headline, i.e. the TODO keyword, the
998 priority cookie, and the tags, can now be excluded from
999 export with appropriate options:
1001 | Variable | Publishing property | OPTIONS switch |
1002 |-------------------------------+---------------------+----------------|
1003 | org-export-with-todo-keywords | :todo-keywords | todo: |
1004 | org-export-with-tags | :tags | tags: |
1005 | org-export-with-priority | :priority | pri: |
1007 *** Cut and Paste with hot links from w3m to Org
1009 You can now use the key =C-c C-x M-w= in a w3m buffer with
1010 HTML content to copy either the region or the entire file in
1011 a special way. When you yank this text back into an Org-mode
1012 buffer, all links from the w3m buffer will continue to work
1015 For this to work you need to load the new file /org-w3m.el./
1016 Please check your org-modules variable to make sure that this
1019 Thanks for Richard Riley for the idea and to Andy Stewart for
1022 *** LOCATION can be inherited for iCalendar export
1024 The LOCATION property can now be inherited during iCalendar
1025 export if you configure =org-use-property-inheritance= like
1028 #+begin_src emacs-lisp
1029 (setq org-use-property-inheritance '("LOCATION"))
1036 - Keybindings in Remember buffers can be configured
1037 - Support for ido completion
1038 - New face for date lines in agenda column view
1039 - Invisible targets become now anchors in headlines.
1040 - New contributed file /org-exp-blocks.el/
1041 - New contributed file /org-eval-light.el/
1043 - BBDB links may use regular expressions.
1044 - Link abbreviations can use %h to insert a url-encoded target value
1045 - Improved XHTML compliance
1049 *** Keybindings in Remember buffers can be configured
1051 The remember buffers created with Org's extensions are in
1052 Org-mode, which is nice to prepare snippets that will
1053 actually be stored in Org-mode files. However, this makes it
1054 hard to configure key bindings without modifying the Org-mode
1055 keymap. There is now a minor mode active in these buffers,
1056 `org-remember-mode', and its keymap org-remember-mode-map can
1057 be used for key bindings. By default, this map only contains
1058 the bindings for =C-c C-c= to store the note, and =C-c C-k=
1059 to abort it. Use `org-remember-mode-hook' to define your own
1062 #+begin_src emacs-lisp
1064 'org-remember-mode-hook
1066 (define-key org-remember-mode-map
1067 "\C-x\C-s" 'org-remember-finalize)))
1070 If you wish, you can also use this to free the =C-c C-c=
1071 binding (by binding this key to nil in the minor mode map),
1072 so that you can use =C-c C-c= again to set tags.
1074 This modification is based on a request by Tim O'Callaghan.
1076 *** Support for ido completion
1078 You can now get the completion interface from /ido.el/ for
1079 many of Org's internal completion commands by turning on the
1080 variable =org-completion-use-ido=. =ido-mode= must also be
1081 active before you can use this.
1083 This change is based upon a request by Samuel Wales.
1085 *** New face for date lines in agenda column view
1087 When column view is active in the agenda, and when you have
1088 summarizing properties, the date lines become normal column
1089 lines and the separation between different days becomes
1090 harder to see. If this bothers you, you can now customize
1091 the face =org-agenda-column-dateline=.
1093 This is based on a request by George Pearson.
1095 *** Invisible targets become now anchors in headlines.
1097 These anchors can be used to jump to a directly with an HTML
1098 link, just like the =sec-xxx= IDs. For example, the
1099 following will make a http link
1100 =//domain/path-to-my-file.html#dummy= work:
1107 This is based on a request by Matt Lundin.
1109 *** New contributed file /org-exp-blocks.el/
1111 This new file implements special export behavior of
1112 user-defined blocks. The currently supported blocks are
1114 - comment :: Comment blocks with author-specific markup
1115 - ditaa :: conversion of ASCII art into pretty png files
1116 using Stathis Sideris' /ditaa.jar/ program
1117 - dot :: creation of graphs in the /dot/ language
1118 - R :: Sweave type exporting using the R program
1120 For more details and examples, see the file commentary in
1121 /org-exp-blocks.el/.
1123 Kudos to Eric Schulte for this new functionality, after
1124 /org-plot.el/ already his second major contribution. Thanks
1125 to Stathis for this excellent program, and for allowing us to
1126 bundle it with Org-mode.
1128 *** New contributed file /org-eval-light.el/
1130 This module gives control over execution Emacs Lisp code
1131 blocks included in a file.
1133 Thanks to Eric Schulte also for this file.
1135 *** Link translation
1137 You can now configure Org to understand many links created
1138 with the Emacs Planner package, so you can cut text from
1139 planner pages and paste them into Org-mode files without
1140 having to re-write the links. Among other things, this means
1141 that the command =org-open-at-point-global= which follows
1142 links not only in Org-mode, but in arbitrary files like
1143 source code files etc, will work also with links created by
1144 planner. The following customization is needed to make all of
1147 #+begin_src emacs-lisp
1148 (setq org-link-translation-function
1149 'org-translate-link-from-planner)
1152 I guess an inverse translator could be written and integrated
1155 *** BBDB links may use regular expressions.
1157 This did work all along, but only now I have documented it.
1159 *** =yank-pop= works again after yanking an outline tree
1161 Samuel Wales had noticed that =org-yank= did mess up this
1162 functionality. Now you can use =yank-pop= again, the only
1163 restriction is that the so-yanked text will not be
1164 pro/demoted or folded.
1166 *** Link abbreviations can use %h to insert a url-encoded target value
1168 Thanks to Steve Purcell for a patch to this effect.
1170 *** Improved XHTML compliance
1172 Thanks to Sebastian Rose for pushing this.
1174 *** Many bug fixes again.
1179 - A region of entries can now be refiled with a single command
1180 - Fine-tuning the behavior of `org-yank'
1181 - Formulas for clocktables
1182 - Better implementation of footnotes for HTML export
1183 - More languages for HTML export.
1187 *** A region of entries can now be refiled with a single command
1189 With =transient-make-mode= active (=zmacs-regions= under
1190 XEmacs), you can now select a region of entries and refile
1191 them all with a single =C-c C-w= command.
1193 Thanks to Samuel Wales for this useful proposal.
1195 *** Fine-tuning the behavior of =org-yank=
1197 The behavior of Org's yanking command has been further
1198 fine-tuned in order to avoid some of the small annoyances
1199 this command caused.
1201 - Calling =org-yank= with a prefix arg will stop any special
1202 treatment and directly pass through to the normal =yank=
1203 command. Therefore, you can now force a normal yank with
1206 - Subtrees will only be folded after a yank if doing so will
1207 now swallow any non-white characters after the yanked text.
1208 This is, I think a really important change to make the
1209 command work more sanely.
1211 *** Formulas for clocktables
1213 You can now add formulas to a clock table, either by hand, or
1214 with a =:formula= parameter. These formulas can be used to
1215 create additional columns with further analysis of the
1218 Thanks to Jurgen Defurne for triggering this addition.
1220 *** Better implementation of footnotes for HTML export
1222 The footnote export in 6.11 really was not good enough. Now
1223 it works fine. If you have customized
1224 =footnote-section-tag=, make sure that your customization is
1225 matched by =footnote-section-tag-regexp=.
1227 Thanks to Sebastian Rose for pushing this change.
1229 *** More languages for HTML export.
1231 More languages are supported during HTML export. This is
1232 only relevant for the few special words Org inserts, like
1233 "Table of Contents", or "Footnotes". Also the encoding
1234 issues with this feature seem to be solved now.
1236 Thanks to Sebastian Rose for pushing me to fix the encoding
1243 - Yanking subtree with =C-y= now adjusts the tree level
1244 - State changes can now be shown in the log mode in the agenda
1245 - Footnote in HTML export are now collected at the end of the document
1246 - HTML export now validates again as XHTML
1247 - The clock can now be resumed after exiting and re-starting Emacs
1248 - Clock-related data can be saved and resumed across Emacs sessions
1249 - Following file links can now use C-u C-u to force use of an external app
1250 - Inserting absolute files names now abbreviates links with "~"
1251 - Links to attachment files
1252 - Completed repeated tasks listed briefly in agenda
1253 - Remove buffers created during publishing are removed
1257 *** Yanking subtree with =C-y= now adjusts the tree level
1258 When yanking a cut/copied subtree or a series of trees, the
1259 normal yank key =C-y= now adjusts the level of the tree to
1260 make it fit into the current outline position, without losing
1261 its identity, and without swallowing other subtrees.
1263 This uses the command =org-past-subtree=. An additional
1264 change in that command has been implemented: Normally, this
1265 command picks the right outline level from the surrounding
1266 *visible* headlines, and uses the smaller one. So if the
1267 cursor is between a level 4 and a level 3 headline, the tree
1268 will be pasted as level 3. If the cursor is actually *at*
1269 the beginning of a headline, the level of that headline will
1270 be used. For example, lets say you have a tree like this:
1276 ,(2)* Level one again
1279 with (1) and (2) indicating possible cursor positions for the
1280 insertion. When at (1), the tree will be pasted as level 2.
1281 When at (2), it will be pasted as level 1.
1283 If you do not want =C-y= to behave like this, configure the
1284 variable =org-yank-adjusted-subtrees=.
1286 Thanks to Samuel Wales for this idea and a partial implementation.
1288 *** State changes can now be shown in the log mode in the agenda
1290 If you configure the variable =org-agenda-log-mode-items=,
1291 you can now request that all logged state changes be included
1292 in the agenda when log mode is active. If you find this too
1293 much for normal applications, you can also temporarily
1294 request the inclusion of state changes by pressing =C-u l= in
1297 This was a request by Hsiu-Khuern Tang.
1299 You can also press `C-u C-u l' to get *only* log items in the
1300 agenda, withour any timestamps/deadlines etc.
1302 *** Footnote in HTML export are now collected at the end of the document
1303 Previously, footnotes would be left in the document where
1304 they are defined, now they are all collected and put into a
1305 special =<div>= at the end of the document.
1307 Thanks to Sebastian Rose for this request.
1309 *** HTML export now validates again as XHTML.
1311 Thanks to Sebastian Rose for pushing this cleanup.
1313 *** The clock can now be resumed after exiting and re-starting Emacs
1315 If the option =org-clock-in-resume= is t, and the first clock
1316 line in an entry is unclosed, clocking into that task resumes
1317 the clock from that time.
1319 Thanks to James TD Smith for a patch to this effect.
1321 *** Clock-related data can be saved and resumed across Emacs sessions
1323 The data saved include the contents of =org-clock-history=,
1324 and the running clock, if there is one.
1326 To use this, you will need to add to your .emacs
1328 #+begin_src emacs-lisp
1329 (setq org-clock-persist t)
1330 (setq org-clock-in-resume t)
1331 (org-clock-persistence-insinuate)
1334 Thanks to James TD Smith for a patch to this effect.
1336 *** Following file links can now use C-u C-u to force use of an external app.
1338 So far you could only bypass your setup in `org-file-apps'
1339 and force opening a file link in Emacs by using a =C-u= prefix arg
1340 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
1341 an external application. Which external application depends
1342 on your system. On Mac OS X and Windows, =open= is used. On
1343 a GNU/Linux system, the mailcap settings are used.
1345 This was a proposal by Samuel Wales.
1347 *** Inserting absolute files names now abbreviates links with "~".
1349 Inserting file links with =C-u C-c C-l= was buggy if the
1350 setting of `org-link-file-path-type' was `adaptive' (the
1351 default). Absolute file paths were not abbreviated relative
1352 to the users home directory. This bug has been fixed.
1354 Thanks to Matt Lundin for the report.
1356 *** Links to attachment files
1358 Even though one of the purposes of entry attachments was to
1359 reduce the number of links in an entry, one might still want
1360 to have the occasional link to one of those files. You can
1361 now use link abbreviations to set up a special link type that
1362 points to attachments in the current entry. Note that such
1363 links will only work from within the same entry that has the
1364 attachment, because the directory path is entry specific.
1365 Here is the setup you need:
1367 #+begin_src emacs-lisp
1368 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
1371 After this, a link like this will work
1374 [[att:some-attached-file.txt]]
1376 This was a proposal by Lindsay Todd.
1378 *** Completed repeated tasks listed briefly in agenda
1380 When a repeating task, listed in the daily/weekly agenda under
1381 today's date, is completed from the agenda, it is listed as
1382 DONE in the agenda until the next update happens. After the
1383 next update, the task will have disappeared, of course,
1384 because the new date is no longer today.
1386 *** Remove buffers created during publishing are removed
1388 Buffers that are created during publishing are now deleted
1389 when the publishing is over. At least I hope it works like this.
1395 - Secondary agenda filtering is becoming a killer feature
1396 - Setting tags has now its own binding, =C-c C-q=
1397 - Todo state changes can trigger tag changes
1398 - C-RET will now always insert a new headline, never an item.
1399 - Customize org-mouse.el feature set to free up mouse events
1400 - New commands for export all the way to PDF (through LaTeX)
1401 - Some bug fixed for LaTeX export, more bugs remain.
1405 *** Enhancements to secondary agenda filtering
1407 This is, I believe, becoming a killer feature. It allows you
1408 to define fewer and more general custom agenda commands, and
1409 then to do the final narrowing to specific tasks you are
1410 looking for very quickly, much faster than calling a new
1413 If you have not tries this yet, you should!
1415 **** You can now refining the current filter by an additional criterion
1416 When filtering an existing agenda view with =/=, you can
1417 now narrow down the existing selection by an additional
1418 condition. Do do this, use =\= instead of =/= to add the
1419 additional criterion. You can also press =+= or =-= after
1420 =/= to add a positive or negative condition. A condition
1421 can be a TAG, or an effort estimate limit, see below.
1423 **** It is now possible to filter for effort estimates
1424 This means to filter the agenda for the value of the Effort
1425 property. For this you should best set up global allowed
1426 values for effort estimates, with
1428 #+begin_src emacs-lisp
1429 (setq org-global-properties
1430 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
1433 You may then select effort limits with single keys in the
1434 filter. It works like this: After =/= or =\=, first select
1435 the operator which you want to use to compare effort
1438 : < Select entries with effort smaller than or equal to the limit
1439 : > Select entries with effort larger than or equal to the limit
1440 : = Select entries with effort equal to the limit
1442 After that, you can press a single digit number which is
1443 used as an index to the allowed effort estimates.
1445 If you do not use digits to fast-select tags, you can even
1446 skip the operator, which will then default to
1447 `org-agenda-filter-effort-default-operator', which is by
1450 Thanks to Manish for the great idea to include fast effort
1451 filtering into the agenda filtering process.
1453 **** The mode line will show the active filter
1454 For example, if there is a filter in place that does select
1455 for HOME tags, against EMAIL tags, and for tasks with an
1456 estimated effort smaller than 30 minutes, the mode-line with
1457 show =+HOME-EMAIL+<0:30=
1459 **** The filter now persists when the agenda view is refreshed
1460 All normal refresh commands, including those that move the
1461 weekly agenda from one week to the next, now keep the
1462 current filter in place.
1464 You need to press =/ /= to turn off the filter. However,
1465 when you run a new agenda command, for example going from
1466 the weekly agenda to the TODO list, the filter will be
1469 *** Setting tags has now its own binding, =C-c C-q=
1471 You can still use =C-c C-c= on a headline, but the new
1472 binding should be considered as the main binding for this
1473 command. The reasons for this change are:
1475 - Using =C-c C-c= for tags is really out of line with other
1478 - I hate it in Remember buffers when I try to set tags and I
1479 cannot, because =C-c C-c= exits the buffer :-(
1481 - =C-c C-q= will also work when the cursor is somewhere down
1482 in the entry, it does not have to be on the headline.
1484 *** Todo state changes can trigger tag changes
1486 The new option =org-todo-state-tags-triggers= can be used to
1487 define automatic changes to tags when a TODO state changes.
1488 For example, the setting
1490 : (setq org-todo-state-tags-triggers
1491 : '((done ("Today" . nil) ("NEXT" . nil))
1492 : ("WAITING" ("Today" . t))))
1494 will make sure that any change to any of the DONE states will
1495 remove tags "Today" and "NEXT", while switching to the
1496 "WAITING" state will trigger the tag "Today" to be added.
1498 I use this mostly to get rid of TODAY and NEXT tags which I
1499 apply to select an entry for execution in the near future,
1500 which I often prefer to specific time scheduling.
1502 *** C-RET will now always insert a new headline, never an item.
1503 The new headline is inserted after the current subtree.
1505 Thanks to Peter Jones for patches to fine-tune this behavior.
1507 *** Customize org-mouse.el feature set
1508 There is a new variable =org-mouse-features= which gives you
1509 some control about what features of org-mouse you want to
1510 use. Turning off some of the feature will free up the
1511 corresponding mouse events, or will avoid activating special
1512 regions for mouse clicks. By default I have urned off the
1513 feature to use drag mouse events to move or promote/demote
1514 entries. You can of course turn them back on if you wish.
1516 This variable may still change in the future, allowing more
1517 fine-grained control.
1519 *** New commands for export to PDF
1521 This is using LaTeX export, and then processes it to PDF
1524 : C-c C-e p process to PDF.
1525 : C-c C-e d process to PDF, and open the file.
1528 - \usepackage{graphicx} is now part of the standard class
1530 - Several bugs fixed, but definitely not all of them :-(
1532 *** New option `org-log-state-notes-insert-after-drawers'
1534 Set this to =t= if you want state change notes to be inserted
1535 after any initial drawers, i.e drawers the immediately follow
1536 the headline and the planning line (the one with
1537 DEADLINE/SCHEDULED/CLOSED information).
1541 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1545 *** =org-file-apps= now uses regular repressions instead of extensions
1546 Just like in =auto-mode-alist=, car's in the variable
1547 =org-file-apps= that are strings are now interpreted as
1548 regular expressions that are matched against a file name. So
1549 instead of "txt", you should now write "\\.txt\\'" to make
1550 sure the matching is done correctly (even though "txt" will
1551 be recognized and still be interpreted as an extension).
1553 There is now a shortcut to get many file types visited by
1554 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
1555 any files that are matched by `auto-mode-alist' will be
1558 *** Changes to the attachment system
1560 - The default method to attach a file is now to copy it
1561 instead of moving it.
1562 - You can modify the default method using the variable
1563 `org-attach-method'. I believe that most Unix people want
1564 to set it to `ln' to create hard links.
1565 - The keys =c=, =m=, and =l= specifically select =copy=,
1566 =move=, or =link=, respectively, as the attachment method
1567 for a file, overruling `org-attach-method'.
1568 - To create a new attachment as an Emacs buffer, you have not
1569 now use =n= instead of =c=.
1570 - The file list is now always retrieved from the directory
1571 itself, not from the "Attachments" property. We still
1572 keep this property by default, but you can turn it off, by
1573 customizing the variable =org-attach-file-list-property=.
1577 ** Incompatible changes
1579 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
1581 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
1585 *** The default structure of IDs has changed
1587 IDs created by Org have changed a bit:
1588 - By default, there is no prefix on the ID. There used to be
1589 an "Org" prefix, but I now think this is not necessary.
1590 - IDs use only lower-case letters, no upper-case letters
1591 anymore. The reason for this is that IDs are now also used
1592 as directory names for org-attach, and some systems do not
1593 distinguish upper and lower case in the file system.
1594 - The ID string derived from the current time is now
1595 /reversed/ to become an ID. This assures that the first
1596 two letters of the ID change fast, so hat it makes sense to
1597 split them off to create subdirectories to balance load.
1598 - You can now set the `org-id-method' to `uuidgen' on systems
1601 *** =C-c C-a= no longer calls `show-all'
1603 The reason for this is that =C-c C-a= is now used for the
1604 attachment system. On the rare occasions that this command
1605 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
1607 *** New attachment system
1609 You can now attach files to each node in the outline tree.
1610 This works by creating special directories based on the ID of
1611 an entry, and storing files in these directories. Org can
1612 keep track of changes to the attachments by automatically
1613 committing changes to git. See the manual for more
1616 Thanks to John Wiegley who contributed this fantastic new
1617 concept and wrote org-attach.el to implement it.
1619 *** New remember template escapes
1621 : %^{prop}p to insert a property
1622 : %k the heading of the item currently being clocked
1623 : %K a link to the heading of the item currently being clocked
1625 Also, when you exit remember with =C-2 C-c C-c=, the item
1626 will be filed as a child of the item currently being
1627 clocked. So the idea is, if you are working on something and
1628 think of a new task related to this or a new note to be
1629 added, you can use this to quickly add information to that
1632 Thanks to James TD Smith for a patch to this effect.
1634 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
1636 Thanks to James TD Smith for a patch to this effect.
1638 *** New file in contrib: lisp/org-checklist.el
1640 This module deals with repeated tasks that have checkbox
1643 Thanks to James TD Smith for this contribution.
1645 *** New in-buffer setting #+STYLE
1647 It can be used to locally set the variable
1648 `org-export-html-style-extra'. Several such lines are
1649 allowed-, they will all be concatenated. For an example on
1650 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1656 - Filtering existing agenda views with respect to a tag
1657 - Editing fixed-width regions with picture or artist mode
1658 - /org-plot.el/ is now part of Org
1659 - Tags can be used to select the export part of a document
1660 - Prefix interpretation when storing remember notes
1661 - Yanking inserts folded subtrees
1662 - Column view capture tables can have formulas, plotting info
1663 - In column view, date stamps can be changed with S-cursor keys
1664 - The note buffer for clocking out now mentions the task
1665 - Sorting entries alphabetically ignores TODO keyword and priority
1666 - Agenda views can sort entries by TODO state
1667 - New face =org-scheduled= for entries scheduled in the future.
1668 - Remember templates for gnus links can use the :to escape.
1669 - The file specification in a remember template may be a function
1670 - Categories in iCalendar export include local tags
1671 - It is possible to define filters for column view
1672 - Disabling integer increment during table Field copy
1673 - Capturing column view is on `C-c C-x i'
1674 - And tons of bugs fixed.
1677 ** Incompatible changes
1679 *** Prefix interpretation when storing remember notes has changed
1681 The prefix argument to the `C-c C-c' command that finishes a
1682 remember process is now interpreted differently:
1684 : C-c C-c Store the note to predefined file and headline
1685 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1686 : in its new location.
1687 : C-1 C-c C-c Select the storage location interactively
1688 : C-0 C-c C-c Re-use the last used location
1690 This was requested by John Wiegley.
1692 *** Capturing column view is now on `C-c C-x i'
1694 The reason for this change was that `C-c C-x r' is also used
1695 as a tty key replacement.
1697 *** Categories in iCalendar export now include local tags
1699 The locally defined tags are now listed as categories when
1700 exporting to iCalendar format. Org's traditional file/tree
1701 category is now the last category in this list. Configure
1702 the variable =org-icalendar-categories= to modify or revert
1705 This was a request by Charles Philip Chan.
1709 *** Secondary filtering of agenda views.
1711 You can now easily and interactively filter an existing
1712 agenda view with respect to a tag. This command is executed
1713 with the =/= key in the agenda. You will be prompted for a
1714 tag selection key, and all entries that do not contain or
1715 inherit the corresponding tag will be hidden. With a prefix
1716 argument, the opposite filter is applied: entries that
1717 do have the tag will be hidden.
1719 This operation only /hides/ lines in the agenda buffer, it
1720 does not remove them. Changing the secondary filtering does
1721 not require a new search and is very fast.
1723 If you press TAB at the tag selection prompt, you will be
1724 switched to a completion interface to select a tag. This is
1725 useful when you want to select a tag that does not have a
1726 direct access character.
1728 A double =/ /= will restore the original agenda view by
1729 unhiding any hidden lines.
1731 This functionality was John Wiegley's idea. It is a simpler
1732 implementation of some of the query-editing features proposed
1733 and implemented some time ago by Christopher League (see the
1734 file contrib/lisp/org-interactive-query.el).
1736 *** Editing fixed-width regions with picture or artist mode
1738 The command @<code>C-c '@</code> (that is =C-c= followed by a
1739 single quote) can now also be used to switch to a special
1740 editing mode for fixed-width sections. The default mode is
1741 =artist-mode= which allows you to create ASCII drawings.
1743 It works like this: Enter the editing mode with
1744 @<code>C-c '@</code>. An indirect buffer will be created and
1745 narrowed to the fixed-width region. Edit the drawing, and
1746 press @<code>C-c '@</code> again to exit.
1748 Lines in a fixed-width region should be preceded by a colon
1749 followed by at least one space. These will be removed during
1750 editing, and then added back when you exit the editing mode.
1752 Using the command in an empty line will create a new
1755 This new feature arose from a discussion involving Scott
1756 Otterson, Sebastian Rose and Will Henney.
1758 *** /org-plot.el/ is now part of Org.
1760 You can run it by simple calling org-plot/gnuplot.
1761 Documentation is not yet included with Org, please refer to
1762 http://github.com/eschulte/org-plot/tree/master until we have
1763 moved the docs into Org or Worg.
1765 Thanks to Eric Schulte for this great contribution.
1767 *** Tags can be used to select the export part of a document
1769 You may now use tags to select parts of a document for
1770 inclusion into the export, and to exclude other parts. This
1771 behavior is governed by two new variables:
1772 =org-export-select-tags= and =org-export-exclude-tags=.
1773 These default to =("export")= and =("noexport")=, but can be
1774 changed, even to include a list of several tags.
1776 Org first checks if any of the /select/ tags is present in
1777 the buffer. If yes, all trees that do not carry one of these
1778 tags will be excluded. If a selected tree is a subtree, the
1779 heading hierarchy above it will also be selected for export,
1780 but not the text below those headings. If none of the select
1781 tags is found anywhere in the buffer, the whole buffer will
1782 be selected for export. Finally, all subtrees that are
1783 marked by any of the /exclude/ tags will be removed from the
1786 You may set these tags with in-buffer options
1787 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1789 I love this feature. Thanks to Richard G Riley for coming
1792 *** Prefix interpretation when storing remember notes
1794 The prefix argument to the `C-c C-c' command that finishes a
1795 remember process is now interpreted differently:
1797 : C-c C-c Store the note to predefined file and headline
1798 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1799 : in its new location.
1800 : C-1 C-c C-c Select the storage location interactively
1801 : C-0 C-c C-c Re-use the last used location
1803 This was requested by John Wiegley.
1805 *** Yanking inserts folded subtrees
1807 If the kill is a subtree or a sequence of subtrees, yanking
1808 them with =C-y= will leave all the subtrees in a folded
1809 state. This basically means, that kill and yank are now
1810 much more useful in moving stuff around in your outline. If
1811 you do not like this, customize the variable
1812 =org-yank-folded-subtrees=.
1814 Right now, I am only binding =C-y= to this new function,
1815 should I modify all bindings of yank? Do we need to amend
1818 This feature was requested by John Wiegley.
1820 *** Column view capture tables can have formulas, plotting info
1822 If you attach formulas and plotting instructions to a table
1823 capturing column view, these extra lines will now survive an
1824 update of the column view capture, and any formulas will be
1825 re-applied to the captured table. This works by keeping any
1826 continuous block of comments before and after the actual
1829 *** In column view, date stamps can be changed with S-cursor keys
1831 If a property value is a time stamp, S-left and S-right can
1832 now be used to shift this date around while in column view.
1834 This was a request by Chris Randle.
1836 *** The note buffer for clocking out now mentions the task
1838 This was a request by Peter Frings.
1840 *** Sorting entries alphabetically ignores TODO keyword and priority
1842 Numerical and alphanumerical sorting now skips any TODO
1843 keyword or priority cookie when constructing the comparison
1844 string. This was a request by Wanrong Lin.
1846 *** Agenda views can sort entries by TODO state
1848 You can now define a sorting strategy for agenda entries that
1849 does look at the TODO state of the entries. Sorting by TODO
1850 entry does first separate the non-done from the done states.
1851 Within each class, the entries are sorted not alphabetically,
1852 but in definition order. So if you have a sequence of TODO
1853 entries defined, the entries will be sorted according to the
1854 position of the keyword in this sequence.
1856 This follows an idea and sample implementation by Christian
1859 *** New face =org-scheduled= for entries scheduled in the future.
1861 This was a request by Richard G Riley.
1863 *** Remember templates for gnus links can now use the :to escape.
1865 Thanks to Tommy Lindgren for a patch to this effect.
1866 *** The file specification in a remember template may now be a function
1868 Thanks to Gregory Sullivan for a patch to this effect.
1870 *** Categories in iCalendar export now include local tags
1872 The locally defined tags are now listed as categories when
1873 exporting to iCalendar format. Org's traditional file/tree
1874 category is now the last category in this list. Configure
1875 the variable =org-icalendar-categories= to modify or revert
1878 This was a request by Charles Philip Chan.
1880 *** It is now possible to define filters for column view
1882 The filter can modify the value that will be displayed in a
1883 column, for example it can cut out a part of a time stamp.
1884 For more information, look at the variable
1885 =org-columns-modify-value-for-display-function=.
1887 *** Disabling integer increment during table field copy
1889 Prefix arg 0 to S-RET does the trick.
1891 This was a request by Chris Randle.
1896 For older Changes, see [[file:Changes_old.org]]