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.23 (in preparation)
19 ** Incompatible changes
21 - CLOCK lines will now be captured into the LOGBOOK drawer.
22 See below for details.
26 *** Capture state change notes into a drawer
28 State change notes can now be captured into a drawer =LOGBOOK=,
29 to keep the entry tidy. If this is what you want, you will need
32 #+begin_src emacs-lisp
33 (setq org-log-into-drawer "LOGBOOK")
36 Thanks to Wanrong Lin for this proposal.
38 *** Clock lines are now captured into the LOGBOOK drawer as well
40 The =CLOCK= drawer will be abandoned, clock lines will now also
41 end up in a drawer =LOGBOOK=. The reason for this is because it
42 is a bit useless to have two different drawers for state change
43 notes and clock lines. If you wish to keep the old way, for
44 example if you do not want clock lines and state notes in the
47 #+begin_src emacs-lisp
48 (setq org-clock-into-drawer "CLOCK")
51 *** Added org-R.el to contrib directory
53 Dan Davison has contributed /org-R.el/ which is now in the
54 contrib directory. Org-R performs numerical computations and
55 generates graphics. Data can come from org tables, or from csv
56 files; numerical output can be stored in the org buffer as org
57 tables, and links are created to files containing graphical
58 output. Although, behind the scenes, it uses R, you do not need
59 to know anything about R. Common operations, such as tabulating
60 discrete values in a column of an org table, are available "off
61 the shelf" by specifying options on lines starting with =#+R:=.
62 However, you can also provide raw R code to be evaluated. The
63 documentation is currently the worg tutorial at
64 http://orgmode.org/worg/org-tutorials/org-R/org-R.php
66 Thanks to Dan for this great contribution.
68 *** Allow individual formatting of each TODO keyword in HTML export
70 TODO keywords in HTML export have the CSS class =todo=. In
71 addition to this, each keyword has now itself as class, so you
72 could do this in your CSS file:
75 .todo { font-weight:bold; }
76 .done { font-weight:bold; }
78 .WAITING { color:orange; }
79 .DONE { color:green; }
82 Thanks to Wanrong Lin for this request, and to Sebastian Rose for
83 help with the implementation.
84 *** New hooks for add-ons to tap into context-sensitive commands
86 Some commands in Org are context-sensitive, they will execute
87 different functions depending on context. The most important
88 example is of course =C-c C-c=, but also the =M-cursor= keys fall
91 Org has now a system of hooks that can be used by add-on packages
92 to install their own functionality into these keys. See the
93 docstring of =org-ctrl-c-ctrl-c-hook= for details. The other
94 hooks are named like =org-metaleft-hook= or
95 =org-shiftmetaright-hook=.
97 *** Publishing files irrespective of extension
99 If you set the =:base-extension= property for a publishing
100 project to the symbol =any=, all files in the directory will be
101 published, irrespective of extension.
103 Thanks to Richard Klinda for a patch to this effect.
105 *** New variable index in the manual
107 A new index in the manual lists all variables mentioned in the
110 *** The ORDERED property also influences checkboxes
112 When an entry has the ORDERED property set, checkboxes in
113 the entry must be completed in order. This was already the case
114 for children TODO items, now it also applies for checkboxes.
116 Thanks to Rainer Stengele for this proposal.
118 *** The ORDERED property can be tracked with a tag
120 The =ORDERED= property is used to flag an entry so that subtasks
121 (both children TODO items and checkboxes) must be completed in
122 order. This property is most easily toggled with the command
123 =C-c C-x o=. A property was chosen for this functionality,
124 because this should be a behavior local to the current task, not
125 inherited like tags. However, properties are normally
126 invisible. If you would like visual feedback on the state of
127 this property, configure the variable
128 =org-track-ordered-property-with-tag=. If you then use =C-c C-x
129 o= to toggle the property, a tag will be toggled as well, for
132 Note that the tag itself has no meaning for the behavior of TODO
133 items and checkboxes, and that changing the tag with the usual
134 tag commands will not influence the property and therefore the
135 behavior of TODO and checkbox commands.
137 *** You may now specify line breaks in the fast tags interface
139 Up to now, the fast tags interface tried to lump as many tags as
140 possible into a single line, with the exception that groups would
141 always be on a line by themselves.
143 Now, if you use several lines to define your tags, like
146 ,#+TAGS: aa(a) bb(b) cc(c)
147 ,#+TAGS: dd(d) ee(e) ff(f)
150 then there will also be a line break after the "cc" tag in the
151 fast tag selection interface. You may also write
154 ,#+TAGS: aa(a) bb(b) cc(c) \n dd(d) ee(e) ff(f)
157 to achieve the same effect, and you can use =\n= several times in
158 order to produce empty lines. In =org-tag-alist=, newlines are
159 represented as =(:newline)=.
161 Thanks to Christopher Suckling for a patch to this effect.
166 *** org-choose.el by Tom Breton is now included
168 Org-choose helps documenting a decision-making process by using
169 TODO keywords for different degrees of /chosenness/, and by
170 automatically keeping a set of alternatives in a consistent state.
172 Documentation for /org-choose.el/ is available [[http://orgmode.org/worg/org-contrib/org-choose.php][here]].
174 This package inserts itself into Org using hooks, so if other
175 people would like to do interesting stuff with TODO keywords for
176 special purposes, looking at Tom's code might be a good way to
179 Thanks to Tom for this interesting contribution!
181 *** orgmode.org and Worg css works now better on IE
183 Thanks to Sebastian Rose for making these changes.
185 *** When exporting a subtree, headline levels are now relative to parent
187 This was reported as a bug by William Henney and is fixed now.
189 *** Inactive dates in tables can be used for sorting.
191 When sorting table fields or entries by date, Org first tries to
192 find an active date, and, if none exist, uses a passive date if
195 This was a request by Hsui-Khuen Tang
197 *** The default for =org-return-follows-link= is back to =nil=
199 Setting it to =t= violates Emacs rules to some extent. The
200 internal implementation of this has been improved, so setting it
201 to =t= should now be pretty stable.
203 *** Automatic scheduling of siblings with org-depend.el
205 The sibling of a DONE task can now automatically be scheduled.
207 This was a patch by Andrew Hyatt.
209 *** New skipping conditions
211 The functions =org-agenda-skip-entry-if= and
212 =org-agenda-skip-subtree-if= now accept =timestamp= and
213 =nottimestamp= as additional conditions.
215 This was in response to a request by Saurabh Agrawal.
221 *** Changes to some default values of variables:
223 Here are the new default values:
226 (setq org-return-follows-link t)
228 (setq org-use-fast-todo-selection t)
230 (setq org-yank-adjusted-subtrees nil)
232 (setq org-tags-column -77)
234 (setq org-agenda-sorting-strategy
235 '((agenda time-up priority-down category-keep)
236 (todo time-up priority-down category-keep)
237 (tags time-up priority-down category-keep)
238 (search category-keep)))
241 *** Final cleanup for Emacs 21.1 pretest
247 *** Support for simple TODO dependencies
249 John Wiegley's code for enforcing simple TODO dependencies has
250 been integrated into Org-mode. Thanks John!
252 The structure of Org files (hierarchy and lists) makes it easy to
253 define TODO dependencies. A parent TODO task should not be
254 marked DONE until all subtasks (defined as children tasks) are
255 marked as DONE. And sometimes there is a logical sequence to a
256 number of (sub)tasks, so that one task cannot be acted upon
257 before all siblings above it are done. If you customize the
258 variable =org-enforce-todo-dependencies=, Org will block entries
259 from changing state while they have children that are not DONE.
260 Furthermore, if an entry has a property =ORDERED=, each of its
261 children will be blocked until all earlier siblings are marked
262 DONE. Here is an example:
265 ,* TODO Blocked until (two) is done
274 ,** TODO b, needs to wait for (a)
275 ,** TODO c, needs to wait for (a) and (b)
278 The command =C-c C-x o= toggles the value of the =ORDERED=
281 The variable =org-agenda-dim-blocked-tasks= controls how blocked
282 entries should appear in the agenda, where they can be dimmed or
285 Furthermore, you can use the variable
286 =org-enforce-todo-checkbox-dependencies= to block TODO entries
287 from switching to DONE while any checkboxes are unchecked in the entry.
289 *** Support for shift-selection in Emacs 23
291 Customize the variable =org-support-shift-select= to use S-cursor
292 key for selecting text. Make sure that you carefully read the
293 docstring of that variable first.
295 *** Adding and removing checkboxes from many lines
297 The command =C-c C-x C-b= normally toggles checkbox status in the
298 current line, or in all lines in the region. With prefix
299 argument it now either adds or removes the checkbox.
301 This was a requested by Daniel Clemente.
307 - Improved behavior of conversion commands =C-c -= and =C-c *=
308 - Table formulas may now reference fields in other tables
309 - A final hline is imagined in each table, for the sake of references
310 - A tags-todo search can now ignore timestamped items
311 - =\par= can be used to force a paragraph break, also in footnotes
316 *** Improved behavior of conversion commands =C-c -= and =C-c *=
318 The conversion commands =C-c -= and =C-c *= are now better
319 behaved and therefore more useful, I hope.
321 If there is an active region, these commands will act on the
322 region, otherwise on the current line.
324 - C-c - :: This command turns headings or normal lines into
325 items, or items into normal lines. When there is a
326 region, everything depends on the first line of the
328 - if it is a item, turn all items in the region into
330 - if it is a headline, turn all headlines in the region
332 - if it is a normal line, turn all lines into items.
333 - special case: if there is no active region and the
334 current line is an item, cycle the bullet type of the
336 - C-c * :: This command turns items and normal lines into
337 headings, or headings into normal lines. When there is
338 a region, everything depends on the first line of the
340 - if it is a item, turn all items in the region into
342 - if it is a headline, turn all headlines in the region
344 - if it is a normal line, turn all lines into headlines.
346 *** Table formulas may now reference fields in other tables
348 You may now reference constants, fields and ranges from a
349 different table, either in the current file or even in a
350 different file. The syntax is
352 : remote(NAME-OR-ID,REF)
354 where /NAME/ can be the name of a table in the current file as
355 set by a =#+TBLNAME: NAME= line before the table. It can also be
356 the ID of an entry, even in a different file, and the reference
357 then refers to the first table in that entry. /REF/ is an
358 absolute field or range reference, valid in the referenced table.
359 Note that since there is no "current filed" for the remote table,
360 all row and column references must be absolute, not relative.
362 *** A final hline is imagined in each table, for the sake of references
364 Even if a table does not end with a hline (mine never do because I
365 think it is not pretty), for the sake of references you can
366 assume there is one. So in the following table
375 a reference like =@I$1..@II$2= will now work.
377 *** A tags-todo search can now ignore timestamped items
378 The variables =org-agenda-todo-ignore-with-date=,
379 =org-agenda-todo-ignore-with-date=, and
380 =org-agenda-todo-ignore-with-date= make it possible to
381 exclude TODO entries which have this kind of planning info
382 associated with them. This is most useful for people who
383 schedule everything, and who use the TODO list mainly to find
384 things that are not yet scheduled. Thomas Morgan pointed out
385 that also the tags-todo search may serve exactly this
386 purpose, and that it might be good to have a way to make
387 these variables also apply to the tags-todo search. I can
388 see that, but could not convince myself to make this the
389 default. A new variable must be set to make this happen:
390 =org-agenda-tags-todo-honor-ignore-options=.
392 *** =\par= can be used to force a paragraph break, also in footnotes
394 The LaTeX idiom =\par= will insert a paragraph break at that
395 location. Normally you would simply leave an empty line to get
396 such a break, but this is useful for footnotes whose
397 definitions may not contain empty lines.
400 ** Incompatible changes
402 *** Short examples must have a space after the colon
404 Short literal examples can be created by preceding lines
405 with a colon. Such lines must now have a space after the
406 colon. I believe this is already general practice, but now
407 it must be like this. The only exception are lines what are
408 empty except for the colon.
412 *** Include files can now also process switches
414 The example and src switches like =-n= can now also be added
415 to include file statements:
417 : #+INCLUDE "~/.emacs" src emacs-lisp -n -r
419 Thanks to Manish for pointing out that this was not yet
422 *** Examples can be exported to HTML as text areas
424 You can now specify a =-t= switch to an example or src block,
425 to make it export to HTML as a text area. To change the
426 defaults for height (number of lines in the example) and
427 width of this area (80), use the =-h= and =-w= switches.
429 Thanks to Ulf Stegemann for driving this development.
431 *** LaTeX_CLASS can be given as a property
433 When exporting a single subtree by selecting it as a region
434 before export, the LaTeX class for the export will be taken
435 from the =LaTeX_CLASS= property of the entry if present.
437 Thanks to Robert Goldman for this request.
439 *** Better handling of inlined images in different backends
441 Two new variables govern which kind of files can be inlined
442 during export. These are
443 =org-export-html-inline-image-extensions= and
444 =org-export-latex-inline-image-extensions=. Remember that
445 links are turned into an inline image if they are a pure link
446 with no description. HTML files can inline /.png/, /.jpg/,
447 and /.gif/ files, while LaTeX files, when processed with
448 /pdflatex/, can inline /.png/, /.jpg/, and /.pdf/ files.
449 These also represent the default settings for the new
450 variables. Note that this means that pure links to /.pdf/
451 files will be inlined - to avoid this for a particular link,
452 make sure that the link has a description part which is not
453 equal to the link part.
455 *** Links by ID now continue to work in HTML exported files
457 If you make links by ID, these links will now still work in
458 HTML exported files, provided that you keep the relative path
459 from link to target file the same.
461 Thanks to Friedrich Delgado Friedrichs for pushing this over
464 *** The relative timer can be paused
466 The new command `C-c C-x ,' will pause the relative timer.
467 When the relative timer is running, its value will be shown
468 in the mode line. To get rid of this display, you need to
469 really stop the timer with `C-u C-c C-x ,'.
471 Thanks to Alan Davis for driving this change.
473 *** The attachment directory may now be chosen by the user
475 Instead of using the automatic, unique directory related to
476 the entry ID, you can also use a chosen directory for the
477 attachments of an entry. This directory is specified by the
478 ATTACH_DIR property. You can use `C-c C-a s' to set this
481 Thanks to Jason Jackson for this proposal.
483 *** You can use a single attachment directory for a subtree
485 By setting the property ATTACH_DIR_INHERIT, you can now tell
486 Org that children of the entry should use the same directory
487 for attachments, unless a child explicitly defines its own
488 directory with the ATTACH_DIR property. You can use the
489 command `C-c C-a i' to set this property in an entry.
496 - Line numbers and references in literal examples
497 - New hooks for export preprocessing
498 - Capture column view into a different file
504 Org-mode now directly supports the creation of footnotes. In
505 contrast to the /footnote.el/ package, Org-mode's footnotes are
506 designed for work on a larger document, not only for one-off
507 documents like emails. The basic syntax is similar to the one
508 used by /footnote.el/, i.e. a footnote is defined in a paragraph
509 that is started by a footnote marker in square brackets in column
510 0, no indentation allowed. The footnote reference is simply the
511 marker in square brackets inside text. For example:
514 The Org homepage[fn:1] now looks a lot better than it used to.
516 [fn:1] The link is: http://orgmode.org
519 Org-mode extends the number-based syntax to /named/ footnotes and
520 optional inline definition. Using plain numbers as markers is
521 supported for backward compatibility, but not encouraged because
522 of possible conflicts with LaTeX syntax. Here are the valid
525 - [1] :: A plain numeric footnote marker.
527 - [fn:name] :: A named footnote reference, where `name' is a
528 unique label word or, for simplicity of automatic creation,
531 - [fn:: This is the inline definition of this footnote] :: A
532 LaTeX-like anonymous footnote where the definition is given
533 directly at the reference point.
535 - [fn:name: a definition] :: An inline definition of a footnote,
536 which also specifies a name for the note. Since Org allows
537 multiple references to the same note, you can then use use
538 `[fn:name]' to create additional references.
540 Footnote labels can be created automatically, or you create names
541 yourself. This is handled by the variable
542 =org-footnote-auto-label= and its corresponding =#+STARTUP=
543 keywords, see the docstring of that variable for details.
545 The following command handles footnotes:
547 - C-c C-x f :: The footnote action command. When the cursor is
548 on a footnote reference, jump to the definition. When it is
549 at a definition, jump to the (first) reference. Otherwise,
550 create a new footnote. Depending on the variable
551 `org-footnote-define-inline' (with associated =#+STARTUP=
552 options =fninline= and =nofninline=), the definitions will
553 be placed right into the text as part of the reference, or
554 separately into the location determined by the variable
555 =org-footnote-section=.
556 When this command is called with a prefix argument, a menu
557 of additional options is offered:
558 - s :: Sort the footnote definitions by reference sequence.
559 During editing, Org makes no effort to sort footnote
560 definitions into a particular sequence. If you want
561 them sorted, use this command, which will also move
562 entries according to =org-footnote-section=.
563 - n :: Normalize the footnotes by collecting all
564 definitions (including inline definitions) into a
565 special section, and then numbering them in
566 sequence. The references will then also be
567 numbers. This is meant to be the final step before
568 finishing a document (e.g. sending off an email).
569 The exporters do this automatically, and so could
570 something like `message-send-hook'.
571 - d :: Delete the footnote at point, and all references to it.
573 - C-c C-c :: If the cursor is on a footnote reference, jump to
574 the definition. If it is a the definition, jump back to the
575 reference. When called with a prefix argument at either
576 location, offer the same menu as `C-u C-c C-x f'.
578 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
579 corresponding definition/reference, and you can use the
580 usual commands to follow these links.
582 Org-mode's footnote support is designed so that it should also
583 work in buffers that are not in Org-mode, for example in email
584 messages. Just bind =org-footnote-action= to a global key like
587 The main trigger for this development came from a hook function
588 written by Paul Rivier, to implement named footnotes and to
589 convert them to numbered ones before export. Thanks, Paul!
591 Thanks also to Scot Becker for a thoughtful post bringing this
592 subject back onto the discussion table, and to Matt Lundin for
593 the idea of named footnotes and his prompt testing of the new
596 *** Line numbers and references in literal examples
598 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
599 do now allow optional line numbering in the example.
600 Furthermore, links to specific code lines are supported, greatly
601 increasing Org-mode's utility for writing tutorials and other
604 Code references use special labels embedded directly into the
605 source code. Such labels look like "(ref:name)" and must be
606 unique within a document. Org-mode links with "(name)" in the
607 link part will be correctly interpreted, both while working with
608 an Org file (internal links), and while exporting to the
609 different backends. Line numbering and code references are
610 supported for all three major backends, HTML, LaTeX, and ASCII.
611 In the HTML backend, hovering the mouse over a link to a source
612 line will remote-highlight the referenced code line.
614 The options for the BEGIN lines are:
616 - -n :: Number the lines in the example
617 - +n :: Like -n, but continue numbering from where the previous
619 - -r :: Remove the coderef cookies from the example, and replace
620 links to this reference with line numbers. This option
621 takes only effect if either -n or +n are given as well.
622 If -r is not given, coderefs simply use the label name.
623 - -l "fmt" :: Define a local format for coderef labels, see the
624 variable =org-coderef-label-format= for details. Use this
625 of the default syntax causes conflicts with the code in the
626 code snippet you are using.
631 #+begin_src emacs-lisp -n -r
632 (defmacro org-unmodified (&rest body) (ref:def)
633 "Execute body without changing `buffer-modified-p'."
634 `(set-buffer-modified-p (ref:back)
635 (prog1 (buffer-modified-p) ,@body)))
637 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
641 When exported, this is translated to:
642 #+begin_src emacs-lisp -n -r
643 (defmacro org-unmodified (&rest body) (ref:def)
644 "Execute body without changing `buffer-modified-p'."
645 `(set-buffer-modified-p (ref:back)
646 (prog1 (buffer-modified-p) ,@body)))
648 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
651 Thanks to Ilya Shlyakhter for proposing this feature set. Thanks
652 to Sebastian Rose for the key Javascript element that made the
653 remote highlighting possible.
655 *** New hooks for export preprocessing
656 The export preprocessor now runs more hooks, to allow
657 better-timed tweaking by user functions:
659 - =org-export-preprocess-hook= ::
660 Pretty much the first thing in the preprocessor. But org-mode
661 is already active in the preprocessing buffer.
663 - =org-export-preprocess-after-include-files-hook= ::
664 This is run after the contents of included files have been inserted.
666 - =org-export-preprocess-after-tree-selection-hook= ::
667 This is run after selection of trees to be exported has
668 happened. This selection includes tags-based selection, as
669 well as removal of commented and archived trees.
671 - =org-export-preprocess-before-backend-specifics-hook= ::
672 Hook run before backend-specific functions are called during preprocessing.
674 - =org-export-preprocess-final-hook= ::
675 Hook for preprocessing an export buffer. This is run as the
676 last thing in the preprocessing buffer, just before returning
677 the buffer string to the backend.
679 *** Capture column view into a different file
681 The :id parameter for the dynamic block capturing column view
682 can now truly be an ID that will also be found in a
683 different file. Also, it can be like =file:path/to/file=, to
684 capture the global column view from a different file.
686 Thanks to Francois Lagarde for his report that IDs outside
687 the current file would not work.
690 Cleanup of many small bugs, and one new feature.
694 *** References to last table row with special names
696 Fields in the last row of a table can now be referenced with
697 $LR1, $LR2, etc. These references can appear both on the
698 left hand side and right hand side of a formula.
702 This version reverses the introduction of @0 as a reference to
703 the last rwo in a table, because of a conflict with the use of
704 @0 for the current row.
709 - All known LaTeX export issues fixed
710 - Captions and attributes for figures and tables.
711 - Better implementation for entry IDs
712 - Spreadsheet references to the last table line.
713 - Old syntax for link attributes abandoned
715 ** Incompatible changes
716 *** Old syntax for link attributes abandoned
718 There used to be a syntax for setting link attributes for
719 HTML export by enclosing the attributes into double braces
720 and adding them to the link itself, like
723 [[./img/a.jpg{{alt="an image"}}] ]
726 This syntax is not longer supported, use instead
729 ,#+ATTR_HTML: alt="an image"
735 *** All known LaTeX export issues fixed
737 All the remaining issues with the LaTeX exporter have hopefully
738 been addressed in this release. In particular, this covers
739 quoting of special characters in tables and problems with
740 exporting files where the headline is in the first line, or with
743 *** Captions and attributes for figures and tables.
745 Tables, and Hyperlinks that represent inlined images, can now be
746 equipped with additional information that will be used during
747 export. The information will be taken from the following special
748 lines in the buffer and apply to the first following table or
751 - #+CAPTION: :: The caption of the image or table. This string
752 should be processed according to the export backend, but
753 this is not yet done.
755 - #+LABEL: :: A label to identify the figure/table for cross
756 references. For HTML export, this string will become the
757 ID for the ~<div class="figure">~ element that encapsulates
758 the image tag and the caption. For LaTeX export, this
759 string will be used as the argument of a ~\label{...}~
760 macro. These labels will be available for internal links
761 like ~[[label][Table] ]~.
763 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
764 added as attributes into the ~<img...>~ tag. This string
765 will not be processed, so it should have immediately the
768 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
770 For /images/, this string is directly inserted into
771 the optional argument of the ~\includegraphics[...]{file}~
772 command, to specify scaling, clipping and other options.
773 This string will not be processed, so it should have
774 immediately the right format, like =width=5cm,angle=90=.\\
775 For /tables/, this can currently contain the keyword
776 =longtable=, to request typesetting of the table using the
777 longtable package, which automatically distributes the table
778 over several pages if needed. Also, the attributes line may
779 contain an alignment string for the tabular environment, like
780 =longtable,align=l|lrl=
782 For LaTeX export, if either a caption or a label is given, the element
783 will be exported as a float, i.e. wrapped into a figure or table
786 *** Better implementation for entry IDs
788 Unique identifiers for entries can now be used more efficiently.
789 Internally, a hash array has replaced the alist used so far to
790 keep track of the files in which an ID is defined. This makes it
791 quite fast to find an entry by ID.
793 There is a new link type which looks like this:
796 id:GLOBALLY-UNIQUE-IDENTIFIER
799 This link points to a specific entry. When you move the entry to
800 a different file, for example if you move it to an archive
801 file, the link will continue to work.
803 The file /org-id.el/ contains an API that can be used to write
804 code using these identifiers, including creating IDs and finding
805 them wherever they are.
807 Org has its own method to create unique identifiers, but if the system
808 has /uuidgen/ command installed (Mac's and Linux systems generally
809 do), it will be used by default (a change compared to the earlier
810 implmentation, where you explicitdly had to opt for uuidgen). You can
811 also select the method by hand, using the variable =org-id-method=.
813 If the ID system ever gets confused about where a certain ID is, it
814 initiates a global scan of all agenda files with associated archives,
815 all files previously known containing any IDs, and all currently
816 visited Org-mode files to rebuild the hash. You can also initiate
817 this by hand: =M-x org-id-update-id-locations=. Running this command
818 will also dump into the =*Messages*= buffer information about any
819 duplicate IDs. These should not exist, and Org will never /make/ the
820 same ID twice, but if you /copy/ an entry with its properties,
821 duplicate IDs will inevitably be produced. Unfortunately, this is
822 unavoidable in a plain text system that allows you to edit the text in
823 arbitrary ways, and a portion of care on your side is needed to keep
826 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
827 This is also a change from previous versions where the file was
828 =~/.org=id-locations=. Therefore, you can remove this old file
829 if you have it. I am not sure what will happen if the =.emacs.d=
830 directory does not exists in your setup, but in modern Emacsen, I
831 believe it should exist. If you do not want to use IDs across
832 files, you can avoid the overhead with tracking IDs by
833 customizing the variable =org-id-track-globally=. IDs can then
834 still be used for links inside a single file.
836 IDs will also be used when you create a new link to an Org-mode
837 buffer. If you use =org-store-link= (normally at =C-c l=) inside
838 en entry in an Org-mode buffer, and ID property will be created
839 if it does not exist, and the stored link will be an =id:= link.
840 If you prefer the much less secure linking to headline text, you
841 can configure the variable =org-link-to-org-use-id=. The default
842 setting for this variable is =create-if-interactive=, meaning
843 that an ID will be created when you store a link interactively,
844 but not if you happen to be in an Org-mode file while you create
845 a remember note (which usually has a link to the place where you
846 were when starting remember).
848 *** Spreadsheet references to the last table line.
850 You may now use =@0= to reference the last dataline in a table
851 in a stable way. This is useful in particular for automatically
852 generated tables like the ones using /org-collector.el/ by Eric
858 - New relative timer to support timed notes
859 - Special faces can be set for individual tags
860 - The agenda shows now all tags, including inherited ones.
861 - Exclude some tags from inheritance.
862 - More special values for time comparisons in property searches
863 - Control for exporting meta data
864 - Cut and Paste with hot links from w3m to Org
865 - LOCATION can be inherited for iCalendar export
866 - Relative row references crossing hlines now throw an error
868 ** Incompatible Changes
870 *** Relative row references crossing hlines now throw an error
872 Relative row references in tables look like this: "@-4" which
873 means the forth row above this one. These row references are
874 not allowed to cross horizontal separator lines (hlines). So
875 far, when a row reference violates this policy, Org would
876 silently choose the field just next to the hline.
878 Tassilo Horn pointed out that this kind of hidden magic is
879 actually confusing and may cause incorrect formulas, and I do
880 agree. Therefore, trying to cross a hline with a relative
881 reference will now throw an error.
883 If you need the old behavior, customize the variable
884 `org-table-error-on-row-ref-crossing-hline'.
888 *** New relative timer to support timed notes
890 Org now supports taking timed notes, useful for example while
891 watching a video, or during a meeting which is also recorded.
894 Insert a relative time into the buffer. The first time
895 you use this, the timer will be started. When called
896 with a prefix argument, the timer is reset to 0.
899 Insert a description list item with the current relative
900 time. With a prefix argument, first reset the timer to 0.
903 Once the time list has been initiated, you can also use the
904 normal item-creating command to insert the next timer item.
907 Reset the timer without inserting anything into the buffer.
908 By default, the timer is reset to 0. When called with a
909 =C-u= prefix, reset the timer to specific starting
910 offset. The user is prompted for the offset, with a
911 default taken from a timer string at point, if any, So this
912 can be used to restart taking notes after a break in the
913 process. When called with a double prefix argument
914 =C-c C-u=, change all timer strings in the active
915 region by a certain amount. This can be used to fix timer
916 strings if the timer was not started at exactly the right
919 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
920 contributions to this idea.
922 *** Special faces can be set for individual tags
924 You may now use the variable =org-tag-faces= to define the
925 face used for specific tags, much in the same way as you can
926 do for TODO keywords.
928 Thanks to Samuel Wales for this proposal.
930 *** The agenda shows now all tags, including inherited ones.
932 This request has come up often, most recently it was
933 formulated by Tassilo Horn.
935 If you prefer the old behavior of only showing the local
936 tags, customize the variable =org-agenda-show-inherited-tags=.
938 *** Exclude some tags from inheritance.
940 So far, the only way to select tags for inheritance was to
941 allow it for all tags, or to do a positive selection using
942 one of the more complex settings for
943 `org-use-tag-inheritance'. It may actually be better to
944 allow inheritance for all but a few tags, which was difficult
945 to achieve with this methodology.
947 A new option, `org-tags-exclude-from-inheritance', allows to
948 specify an exclusion list for inherited tags.
950 *** More special values for time comparisons in property searches
952 In addition to =<now>=, =<today>=, =<yesterday>=, and
953 =<tomorrow>=, there are more special values accepted now in
954 time comparisons in property searches: You may use strings
955 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
956 week, month, and year, respectively
958 Thanks to Linday Todd for this proposal.
960 *** Control for exporting meta data
962 All the metadata in a headline, i.e. the TODO keyword, the
963 priority cookie, and the tags, can now be excluded from
964 export with appropriate options:
966 | Variable | Publishing property | OPTIONS switch |
967 |-------------------------------+---------------------+----------------|
968 | org-export-with-todo-keywords | :todo-keywords | todo: |
969 | org-export-with-tags | :tags | tags: |
970 | org-export-with-priority | :priority | pri: |
972 *** Cut and Paste with hot links from w3m to Org
974 You can now use the key =C-c C-x M-w= in a w3m buffer with
975 HTML content to copy either the region or the entire file in
976 a special way. When you yank this text back into an Org-mode
977 buffer, all links from the w3m buffer will continue to work
980 For this to work you need to load the new file /org-w3m.el./
981 Please check your org-modules variable to make sure that this
984 Thanks for Richard Riley for the idea and to Andy Stewart for
987 *** LOCATION can be inherited for iCalendar export
989 The LOCATION property can now be inherited during iCalendar
990 export if you configure =org-use-property-inheritance= like
993 #+begin_src emacs-lisp
994 (setq org-use-property-inheritance '("LOCATION"))
1001 - Keybindings in Remember buffers can be configured
1002 - Support for ido completion
1003 - New face for date lines in agenda column view
1004 - Invisible targets become now anchors in headlines.
1005 - New contributed file /org-exp-blocks.el/
1006 - New contributed file /org-eval-light.el/
1008 - BBDB links may use regular expressions.
1009 - Link abbreviations can use %h to insert a url-encoded target value
1010 - Improved XHTML compliance
1014 *** Keybindings in Remember buffers can be configured
1016 The remember buffers created with Org's extensions are in
1017 Org-mode, which is nice to prepare snippets that will
1018 actually be stored in Org-mode files. However, this makes it
1019 hard to configure key bindings without modifying the Org-mode
1020 keymap. There is now a minor mode active in these buffers,
1021 `org-remember-mode', and its keymap org-remember-mode-map can
1022 be used for key bindings. By default, this map only contains
1023 the bindings for =C-c C-c= to store the note, and =C-c C-k=
1024 to abort it. Use `org-remember-mode-hook' to define your own
1027 #+begin_src emacs-lisp
1029 'org-remember-mode-hook
1031 (define-key org-remember-mode-map
1032 "\C-x\C-s" 'org-remember-finalize)))
1035 If you wish, you can also use this to free the =C-c C-c=
1036 binding (by binding this key to nil in the minor mode map),
1037 so that you can use =C-c C-c= again to set tags.
1039 This modification is based on a request by Tim O'Callaghan.
1041 *** Support for ido completion
1043 You can now get the completion interface from /ido.el/ for
1044 many of Org's internal completion commands by turning on the
1045 variable =org-completion-use-ido=. =ido-mode= must also be
1046 active before you can use this.
1048 This change is based upon a request by Samuel Wales.
1050 *** New face for date lines in agenda column view
1052 When column view is active in the agenda, and when you have
1053 summarizing properties, the date lines become normal column
1054 lines and the separation between different days becomes
1055 harder to see. If this bothers you, you can now customize
1056 the face =org-agenda-column-dateline=.
1058 This is based on a request by George Pearson.
1060 *** Invisible targets become now anchors in headlines.
1062 These anchors can be used to jump to a directly with an HTML
1063 link, just like the =sec-xxx= IDs. For example, the
1064 following will make a http link
1065 =//domain/path-to-my-file.html#dummy= work:
1072 This is based on a request by Matt Lundin.
1074 *** New contributed file /org-exp-blocks.el/
1076 This new file implements special export behavior of
1077 user-defined blocks. The currently supported blocks are
1079 - comment :: Comment blocks with author-specific markup
1080 - ditaa :: conversion of ASCII art into pretty png files
1081 using Stathis Sideris' /ditaa.jar/ program
1082 - dot :: creation of graphs in the /dot/ language
1083 - R :: Sweave type exporting using the R program
1085 For more details and examples, see the file commentary in
1086 /org-exp-blocks.el/.
1088 Kudos to Eric Schulte for this new functionality, after
1089 /org-plot.el/ already his second major contribution. Thanks
1090 to Stathis for this excellent program, and for allowing us to
1091 bundle it with Org-mode.
1093 *** New contributed file /org-eval-light.el/
1095 This module gives control over execution Emacs Lisp code
1096 blocks included in a file.
1098 Thanks to Eric Schulte also for this file.
1100 *** Link translation
1102 You can now configure Org to understand many links created
1103 with the Emacs Planner package, so you can cut text from
1104 planner pages and paste them into Org-mode files without
1105 having to re-write the links. Among other things, this means
1106 that the command =org-open-at-point-global= which follows
1107 links not only in Org-mode, but in arbitrary files like
1108 source code files etc, will work also with links created by
1109 planner. The following customization is needed to make all of
1112 #+begin_src emacs-lisp
1113 (setq org-link-translation-function
1114 'org-translate-link-from-planner)
1117 I guess an inverse translator could be written and integrated
1120 *** BBDB links may use regular expressions.
1122 This did work all along, but only now I have documented it.
1124 *** =yank-pop= works again after yanking an outline tree
1126 Samuel Wales had noticed that =org-yank= did mess up this
1127 functionality. Now you can use =yank-pop= again, the only
1128 restriction is that the so-yanked text will not be
1129 pro/demoted or folded.
1131 *** Link abbreviations can use %h to insert a url-encoded target value
1133 Thanks to Steve Purcell for a patch to this effect.
1135 *** Improved XHTML compliance
1137 Thanks to Sebastian Rose for pushing this.
1139 *** Many bug fixes again.
1144 - A region of entries can now be refiled with a single command
1145 - Fine-tuning the behavior of `org-yank'
1146 - Formulas for clocktables
1147 - Better implementation of footnotes for HTML export
1148 - More languages for HTML export.
1152 *** A region of entries can now be refiled with a single command
1154 With =transient-make-mode= active (=zmacs-regions= under
1155 XEmacs), you can now select a region of entries and refile
1156 them all with a single =C-c C-w= command.
1158 Thanks to Samuel Wales for this useful proposal.
1160 *** Fine-tuning the behavior of =org-yank=
1162 The behavior of Org's yanking command has been further
1163 fine-tuned in order to avoid some of the small annoyances
1164 this command caused.
1166 - Calling =org-yank= with a prefix arg will stop any special
1167 treatment and directly pass through to the normal =yank=
1168 command. Therefore, you can now force a normal yank with
1171 - Subtrees will only be folded after a yank if doing so will
1172 now swallow any non-white characters after the yanked text.
1173 This is, I think a really important change to make the
1174 command work more sanely.
1176 *** Formulas for clocktables
1178 You can now add formulas to a clock table, either by hand, or
1179 with a =:formula= parameter. These formulas can be used to
1180 create additional columns with further analysis of the
1183 Thanks to Jurgen Defurne for triggering this addition.
1185 *** Better implementation of footnotes for HTML export
1187 The footnote export in 6.11 really was not good enough. Now
1188 it works fine. If you have customized
1189 =footnote-section-tag=, make sure that your customization is
1190 matched by =footnote-section-tag-regexp=.
1192 Thanks to Sebastian Rose for pushing this change.
1194 *** More languages for HTML export.
1196 More languages are supported during HTML export. This is
1197 only relevant for the few special words Org inserts, like
1198 "Table of Contents", or "Footnotes". Also the encoding
1199 issues with this feature seem to be solved now.
1201 Thanks to Sebastian Rose for pushing me to fix the encoding
1208 - Yanking subtree with =C-y= now adjusts the tree level
1209 - State changes can now be shown in the log mode in the agenda
1210 - Footnote in HTML export are now collected at the end of the document
1211 - HTML export now validates again as XHTML
1212 - The clock can now be resumed after exiting and re-starting Emacs
1213 - Clock-related data can be saved and resumed across Emacs sessions
1214 - Following file links can now use C-u C-u to force use of an external app
1215 - Inserting absolute files names now abbreviates links with "~"
1216 - Links to attachment files
1217 - Completed repeated tasks listed briefly in agenda
1218 - Remove buffers created during publishing are removed
1222 *** Yanking subtree with =C-y= now adjusts the tree level
1223 When yanking a cut/copied subtree or a series of trees, the
1224 normal yank key =C-y= now adjusts the level of the tree to
1225 make it fit into the current outline position, without losing
1226 its identity, and without swallowing other subtrees.
1228 This uses the command =org-past-subtree=. An additional
1229 change in that command has been implemented: Normally, this
1230 command picks the right outline level from the surrounding
1231 *visible* headlines, and uses the smaller one. So if the
1232 cursor is between a level 4 and a level 3 headline, the tree
1233 will be pasted as level 3. If the cursor is actually *at*
1234 the beginning of a headline, the level of that headline will
1235 be used. For example, lets say you have a tree like this:
1241 ,(2)* Level one again
1244 with (1) and (2) indicating possible cursor positions for the
1245 insertion. When at (1), the tree will be pasted as level 2.
1246 When at (2), it will be pasted as level 1.
1248 If you do not want =C-y= to behave like this, configure the
1249 variable =org-yank-adjusted-subtrees=.
1251 Thanks to Samuel Wales for this idea and a partial implementation.
1253 *** State changes can now be shown in the log mode in the agenda
1255 If you configure the variable =org-agenda-log-mode-items=,
1256 you can now request that all logged state changes be included
1257 in the agenda when log mode is active. If you find this too
1258 much for normal applications, you can also temporarily
1259 request the inclusion of state changes by pressing =C-u l= in
1262 This was a request by Hsiu-Khuern Tang.
1264 You can also press `C-u C-u l' to get *only* log items in the
1265 agenda, withour any timestamps/deadlines etc.
1267 *** Footnote in HTML export are now collected at the end of the document
1268 Previously, footnotes would be left in the document where
1269 they are defined, now they are all collected and put into a
1270 special =<div>= at the end of the document.
1272 Thanks to Sebastian Rose for this request.
1274 *** HTML export now validates again as XHTML.
1276 Thanks to Sebastian Rose for pushing this cleanup.
1278 *** The clock can now be resumed after exiting and re-starting Emacs
1280 If the option =org-clock-in-resume= is t, and the first clock
1281 line in an entry is unclosed, clocking into that task resumes
1282 the clock from that time.
1284 Thanks to James TD Smith for a patch to this effect.
1286 *** Clock-related data can be saved and resumed across Emacs sessions
1288 The data saved include the contents of =org-clock-history=,
1289 and the running clock, if there is one.
1291 To use this, you will need to add to your .emacs
1293 #+begin_src emacs-lisp
1294 (setq org-clock-persist t)
1295 (setq org-clock-in-resume t)
1296 (org-clock-persistence-insinuate)
1299 Thanks to James TD Smith for a patch to this effect.
1301 *** Following file links can now use C-u C-u to force use of an external app.
1303 So far you could only bypass your setup in `org-file-apps'
1304 and force opening a file link in Emacs by using a =C-u= prefix arg
1305 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
1306 an external application. Which external application depends
1307 on your system. On Mac OS X and Windows, =open= is used. On
1308 a GNU/Linux system, the mailcap settings are used.
1310 This was a proposal by Samuel Wales.
1312 *** Inserting absolute files names now abbreviates links with "~".
1314 Inserting file links with =C-u C-c C-l= was buggy if the
1315 setting of `org-link-file-path-type' was `adaptive' (the
1316 default). Absolute file paths were not abbreviated relative
1317 to the users home directory. This bug has been fixed.
1319 Thanks to Matt Lundin for the report.
1321 *** Links to attachment files
1323 Even though one of the purposes of entry attachments was to
1324 reduce the number of links in an entry, one might still want
1325 to have the occasional link to one of those files. You can
1326 now use link abbreviations to set up a special link type that
1327 points to attachments in the current entry. Note that such
1328 links will only work from within the same entry that has the
1329 attachment, because the directory path is entry specific.
1330 Here is the setup you need:
1332 #+begin_src emacs-lisp
1333 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
1336 After this, a link like this will work
1339 [[att:some-attached-file.txt]]
1341 This was a proposal by Lindsay Todd.
1343 *** Completed repeated tasks listed briefly in agenda
1345 When a repeating task, listed in the daily/weekly agenda under
1346 today's date, is completed from the agenda, it is listed as
1347 DONE in the agenda until the next update happens. After the
1348 next update, the task will have disappeared, of course,
1349 because the new date is no longer today.
1351 *** Remove buffers created during publishing are removed
1353 Buffers that are created during publishing are now deleted
1354 when the publishing is over. At least I hope it works like this.
1360 - Secondary agenda filtering is becoming a killer feature
1361 - Setting tags has now its own binding, =C-c C-q=
1362 - Todo state changes can trigger tag changes
1363 - C-RET will now always insert a new headline, never an item.
1364 - Customize org-mouse.el feature set to free up mouse events
1365 - New commands for export all the way to PDF (through LaTeX)
1366 - Some bug fixed for LaTeX export, more bugs remain.
1370 *** Enhancements to secondary agenda filtering
1372 This is, I believe, becoming a killer feature. It allows you
1373 to define fewer and more general custom agenda commands, and
1374 then to do the final narrowing to specific tasks you are
1375 looking for very quickly, much faster than calling a new
1378 If you have not tries this yet, you should!
1380 **** You can now refining the current filter by an additional criterion
1381 When filtering an existing agenda view with =/=, you can
1382 now narrow down the existing selection by an additional
1383 condition. Do do this, use =\= instead of =/= to add the
1384 additional criterion. You can also press =+= or =-= after
1385 =/= to add a positive or negative condition. A condition
1386 can be a TAG, or an effort estimate limit, see below.
1388 **** It is now possible to filter for effort estimates
1389 This means to filter the agenda for the value of the Effort
1390 property. For this you should best set up global allowed
1391 values for effort estimates, with
1393 #+begin_src emacs-lisp
1394 (setq org-global-properties
1395 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
1398 You may then select effort limits with single keys in the
1399 filter. It works like this: After =/= or =\=, first select
1400 the operator which you want to use to compare effort
1403 : < Select entries with effort smaller than or equal to the limit
1404 : > Select entries with effort larger than or equal to the limit
1405 : = Select entries with effort equal to the limit
1407 After that, you can press a single digit number which is
1408 used as an index to the allowed effort estimates.
1410 If you do not use digits to fast-select tags, you can even
1411 skip the operator, which will then default to
1412 `org-agenda-filter-effort-default-operator', which is by
1415 Thanks to Manish for the great idea to include fast effort
1416 filtering into the agenda filtering process.
1418 **** The mode line will show the active filter
1419 For example, if there is a filter in place that does select
1420 for HOME tags, against EMAIL tags, and for tasks with an
1421 estimated effort smaller than 30 minutes, the mode-line with
1422 show =+HOME-EMAIL+<0:30=
1424 **** The filter now persists when the agenda view is refreshed
1425 All normal refresh commands, including those that move the
1426 weekly agenda from one week to the next, now keep the
1427 current filter in place.
1429 You need to press =/ /= to turn off the filter. However,
1430 when you run a new agenda command, for example going from
1431 the weekly agenda to the TODO list, the filter will be
1434 *** Setting tags has now its own binding, =C-c C-q=
1436 You can still use =C-c C-c= on a headline, but the new
1437 binding should be considered as the main binding for this
1438 command. The reasons for this change are:
1440 - Using =C-c C-c= for tags is really out of line with other
1443 - I hate it in Remember buffers when I try to set tags and I
1444 cannot, because =C-c C-c= exits the buffer :-(
1446 - =C-c C-q= will also work when the cursor is somewhere down
1447 in the entry, it does not have to be on the headline.
1449 *** Todo state changes can trigger tag changes
1451 The new option =org-todo-state-tags-triggers= can be used to
1452 define automatic changes to tags when a TODO state changes.
1453 For example, the setting
1455 : (setq org-todo-state-tags-triggers
1456 : '((done ("Today" . nil) ("NEXT" . nil))
1457 : ("WAITING" ("Today" . t))))
1459 will make sure that any change to any of the DONE states will
1460 remove tags "Today" and "NEXT", while switching to the
1461 "WAITING" state will trigger the tag "Today" to be added.
1463 I use this mostly to get rid of TODAY and NEXT tags which I
1464 apply to select an entry for execution in the near future,
1465 which I often prefer to specific time scheduling.
1467 *** C-RET will now always insert a new headline, never an item.
1468 The new headline is inserted after the current subtree.
1470 Thanks to Peter Jones for patches to fine-tune this behavior.
1472 *** Customize org-mouse.el feature set
1473 There is a new variable =org-mouse-features= which gives you
1474 some control about what features of org-mouse you want to
1475 use. Turning off some of the feature will free up the
1476 corresponding mouse events, or will avoid activating special
1477 regions for mouse clicks. By default I have urned off the
1478 feature to use drag mouse events to move or promote/demote
1479 entries. You can of course turn them back on if you wish.
1481 This variable may still change in the future, allowing more
1482 fine-grained control.
1484 *** New commands for export to PDF
1486 This is using LaTeX export, and then processes it to PDF
1489 : C-c C-e p process to PDF.
1490 : C-c C-e d process to PDF, and open the file.
1493 - \usepackage{graphicx} is now part of the standard class
1495 - Several bugs fixed, but definitely not all of them :-(
1497 *** New option `org-log-state-notes-insert-after-drawers'
1499 Set this to =t= if you want state change notes to be inserted
1500 after any initial drawers, i.e drawers the immediately follow
1501 the headline and the planning line (the one with
1502 DEADLINE/SCHEDULED/CLOSED information).
1506 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1510 *** =org-file-apps= now uses regular repressions instead of extensions
1511 Just like in =auto-mode-alist=, car's in the variable
1512 =org-file-apps= that are strings are now interpreted as
1513 regular expressions that are matched against a file name. So
1514 instead of "txt", you should now write "\\.txt\\'" to make
1515 sure the matching is done correctly (even though "txt" will
1516 be recognized and still be interpreted as an extension).
1518 There is now a shortcut to get many file types visited by
1519 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
1520 any files that are matched by `auto-mode-alist' will be
1523 *** Changes to the attachment system
1525 - The default method to attach a file is now to copy it
1526 instead of moving it.
1527 - You can modify the default method using the variable
1528 `org-attach-method'. I believe that most Unix people want
1529 to set it to `ln' to create hard links.
1530 - The keys =c=, =m=, and =l= specifically select =copy=,
1531 =move=, or =link=, respectively, as the attachment method
1532 for a file, overruling `org-attach-method'.
1533 - To create a new attachment as an Emacs buffer, you have not
1534 now use =n= instead of =c=.
1535 - The file list is now always retrieved from the directory
1536 itself, not from the "Attachments" property. We still
1537 keep this property by default, but you can turn it off, by
1538 customizing the variable =org-attach-file-list-property=.
1542 ** Incompatible changes
1544 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
1546 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
1550 *** The default structure of IDs has changed
1552 IDs created by Org have changed a bit:
1553 - By default, there is no prefix on the ID. There used to be
1554 an "Org" prefix, but I now think this is not necessary.
1555 - IDs use only lower-case letters, no upper-case letters
1556 anymore. The reason for this is that IDs are now also used
1557 as directory names for org-attach, and some systems do not
1558 distinguish upper and lower case in the file system.
1559 - The ID string derived from the current time is now
1560 /reversed/ to become an ID. This assures that the first
1561 two letters of the ID change fast, so hat it makes sense to
1562 split them off to create subdirectories to balance load.
1563 - You can now set the `org-id-method' to `uuidgen' on systems
1566 *** =C-c C-a= no longer calls `show-all'
1568 The reason for this is that =C-c C-a= is now used for the
1569 attachment system. On the rare occasions that this command
1570 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
1572 *** New attachment system
1574 You can now attach files to each node in the outline tree.
1575 This works by creating special directories based on the ID of
1576 an entry, and storing files in these directories. Org can
1577 keep track of changes to the attachments by automatically
1578 committing changes to git. See the manual for more
1581 Thanks to John Wiegley who contributed this fantastic new
1582 concept and wrote org-attach.el to implement it.
1584 *** New remember template escapes
1586 : %^{prop}p to insert a property
1587 : %k the heading of the item currently being clocked
1588 : %K a link to the heading of the item currently being clocked
1590 Also, when you exit remember with =C-2 C-c C-c=, the item
1591 will be filed as a child of the item currently being
1592 clocked. So the idea is, if you are working on something and
1593 think of a new task related to this or a new note to be
1594 added, you can use this to quickly add information to that
1597 Thanks to James TD Smith for a patch to this effect.
1599 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
1601 Thanks to James TD Smith for a patch to this effect.
1603 *** New file in contrib: lisp/org-checklist.el
1605 This module deals with repeated tasks that have checkbox
1608 Thanks to James TD Smith for this contribution.
1610 *** New in-buffer setting #+STYLE
1612 It can be used to locally set the variable
1613 `org-export-html-style-extra'. Several such lines are
1614 allowed-, they will all be concatenated. For an example on
1615 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1621 - Filtering existing agenda views with respect to a tag
1622 - Editing fixed-width regions with picture or artist mode
1623 - /org-plot.el/ is now part of Org
1624 - Tags can be used to select the export part of a document
1625 - Prefix interpretation when storing remember notes
1626 - Yanking inserts folded subtrees
1627 - Column view capture tables can have formulas, plotting info
1628 - In column view, date stamps can be changed with S-cursor keys
1629 - The note buffer for clocking out now mentions the task
1630 - Sorting entries alphabetically ignores TODO keyword and priority
1631 - Agenda views can sort entries by TODO state
1632 - New face =org-scheduled= for entries scheduled in the future.
1633 - Remember templates for gnus links can use the :to escape.
1634 - The file specification in a remember template may be a function
1635 - Categories in iCalendar export include local tags
1636 - It is possible to define filters for column view
1637 - Disabling integer increment during table Field copy
1638 - Capturing column view is on `C-c C-x i'
1639 - And tons of bugs fixed.
1642 ** Incompatible changes
1644 *** Prefix interpretation when storing remember notes has changed
1646 The prefix argument to the `C-c C-c' command that finishes a
1647 remember process is now interpreted differently:
1649 : C-c C-c Store the note to predefined file and headline
1650 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1651 : in its new location.
1652 : C-1 C-c C-c Select the storage location interactively
1653 : C-0 C-c C-c Re-use the last used location
1655 This was requested by John Wiegley.
1657 *** Capturing column view is now on `C-c C-x i'
1659 The reason for this change was that `C-c C-x r' is also used
1660 as a tty key replacement.
1662 *** Categories in iCalendar export now include local tags
1664 The locally defined tags are now listed as categories when
1665 exporting to iCalendar format. Org's traditional file/tree
1666 category is now the last category in this list. Configure
1667 the variable =org-icalendar-categories= to modify or revert
1670 This was a request by Charles Philip Chan.
1674 *** Secondary filtering of agenda views.
1676 You can now easily and interactively filter an existing
1677 agenda view with respect to a tag. This command is executed
1678 with the =/= key in the agenda. You will be prompted for a
1679 tag selection key, and all entries that do not contain or
1680 inherit the corresponding tag will be hidden. With a prefix
1681 argument, the opposite filter is applied: entries that
1682 do have the tag will be hidden.
1684 This operation only /hides/ lines in the agenda buffer, it
1685 does not remove them. Changing the secondary filtering does
1686 not require a new search and is very fast.
1688 If you press TAB at the tag selection prompt, you will be
1689 switched to a completion interface to select a tag. This is
1690 useful when you want to select a tag that does not have a
1691 direct access character.
1693 A double =/ /= will restore the original agenda view by
1694 unhiding any hidden lines.
1696 This functionality was John Wiegley's idea. It is a simpler
1697 implementation of some of the query-editing features proposed
1698 and implemented some time ago by Christopher League (see the
1699 file contrib/lisp/org-interactive-query.el).
1701 *** Editing fixed-width regions with picture or artist mode
1703 The command @<code>C-c '@</code> (that is =C-c= followed by a
1704 single quote) can now also be used to switch to a special
1705 editing mode for fixed-width sections. The default mode is
1706 =artist-mode= which allows you to create ASCII drawings.
1708 It works like this: Enter the editing mode with
1709 @<code>C-c '@</code>. An indirect buffer will be created and
1710 narrowed to the fixed-width region. Edit the drawing, and
1711 press @<code>C-c '@</code> again to exit.
1713 Lines in a fixed-width region should be preceded by a colon
1714 followed by at least one space. These will be removed during
1715 editing, and then added back when you exit the editing mode.
1717 Using the command in an empty line will create a new
1720 This new feature arose from a discussion involving Scott
1721 Otterson, Sebastian Rose and Will Henney.
1723 *** /org-plot.el/ is now part of Org.
1725 You can run it by simple calling org-plot/gnuplot.
1726 Documentation is not yet included with Org, please refer to
1727 http://github.com/eschulte/org-plot/tree/master until we have
1728 moved the docs into Org or Worg.
1730 Thanks to Eric Schulte for this great contribution.
1732 *** Tags can be used to select the export part of a document
1734 You may now use tags to select parts of a document for
1735 inclusion into the export, and to exclude other parts. This
1736 behavior is governed by two new variables:
1737 =org-export-select-tags= and =org-export-exclude-tags=.
1738 These default to =("export")= and =("noexport")=, but can be
1739 changed, even to include a list of several tags.
1741 Org first checks if any of the /select/ tags is present in
1742 the buffer. If yes, all trees that do not carry one of these
1743 tags will be excluded. If a selected tree is a subtree, the
1744 heading hierarchy above it will also be selected for export,
1745 but not the text below those headings. If none of the select
1746 tags is found anywhere in the buffer, the whole buffer will
1747 be selected for export. Finally, all subtrees that are
1748 marked by any of the /exclude/ tags will be removed from the
1751 You may set these tags with in-buffer options
1752 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1754 I love this feature. Thanks to Richard G Riley for coming
1757 *** Prefix interpretation when storing remember notes
1759 The prefix argument to the `C-c C-c' command that finishes a
1760 remember process is now interpreted differently:
1762 : C-c C-c Store the note to predefined file and headline
1763 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1764 : in its new location.
1765 : C-1 C-c C-c Select the storage location interactively
1766 : C-0 C-c C-c Re-use the last used location
1768 This was requested by John Wiegley.
1770 *** Yanking inserts folded subtrees
1772 If the kill is a subtree or a sequence of subtrees, yanking
1773 them with =C-y= will leave all the subtrees in a folded
1774 state. This basically means, that kill and yank are now
1775 much more useful in moving stuff around in your outline. If
1776 you do not like this, customize the variable
1777 =org-yank-folded-subtrees=.
1779 Right now, I am only binding =C-y= to this new function,
1780 should I modify all bindings of yank? Do we need to amend
1783 This feature was requested by John Wiegley.
1785 *** Column view capture tables can have formulas, plotting info
1787 If you attach formulas and plotting instructions to a table
1788 capturing column view, these extra lines will now survive an
1789 update of the column view capture, and any formulas will be
1790 re-applied to the captured table. This works by keeping any
1791 continuous block of comments before and after the actual
1794 *** In column view, date stamps can be changed with S-cursor keys
1796 If a property value is a time stamp, S-left and S-right can
1797 now be used to shift this date around while in column view.
1799 This was a request by Chris Randle.
1801 *** The note buffer for clocking out now mentions the task
1803 This was a request by Peter Frings.
1805 *** Sorting entries alphabetically ignores TODO keyword and priority
1807 Numerical and alphanumerical sorting now skips any TODO
1808 keyword or priority cookie when constructing the comparison
1809 string. This was a request by Wanrong Lin.
1811 *** Agenda views can sort entries by TODO state
1813 You can now define a sorting strategy for agenda entries that
1814 does look at the TODO state of the entries. Sorting by TODO
1815 entry does first separate the non-done from the done states.
1816 Within each class, the entries are sorted not alphabetically,
1817 but in definition order. So if you have a sequence of TODO
1818 entries defined, the entries will be sorted according to the
1819 position of the keyword in this sequence.
1821 This follows an idea and sample implementation by Christian
1824 *** New face =org-scheduled= for entries scheduled in the future.
1826 This was a request by Richard G Riley.
1828 *** Remember templates for gnus links can now use the :to escape.
1830 Thanks to Tommy Lindgren for a patch to this effect.
1831 *** The file specification in a remember template may now be a function
1833 Thanks to Gregory Sullivan for a patch to this effect.
1835 *** Categories in iCalendar export now include local tags
1837 The locally defined tags are now listed as categories when
1838 exporting to iCalendar format. Org's traditional file/tree
1839 category is now the last category in this list. Configure
1840 the variable =org-icalendar-categories= to modify or revert
1843 This was a request by Charles Philip Chan.
1845 *** It is now possible to define filters for column view
1847 The filter can modify the value that will be displayed in a
1848 column, for example it can cut out a part of a time stamp.
1849 For more information, look at the variable
1850 =org-columns-modify-value-for-display-function=.
1852 *** Disabling integer increment during table field copy
1854 Prefix arg 0 to S-RET does the trick.
1856 This was a request by Chris Randle.
1861 For older Changes, see [[file:Changes_old.org]]