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.18 (in preparation)
18 ** Incompatible changes
20 *** Short examples must have a space after the colon
22 Short literal examples can be created by preceeding lines
23 with a colon. Such lines must now have a space after the
24 colon. I believe this is already general practice, but now
25 it must be like this. The only exception are lines what are
26 empty except for the colon.
30 *** Include files can now also process switches
32 The example and src switches like =-n= can now also be added
33 to inlcude file statements:
35 : #+INCLUDE "~/.emacs" src emacs-lisp -n -r
37 Thanks to Manish for pointing out that this was not yet
40 *** Examples can be exported to HTML as text areas
42 You can now specify a =-t= switch to an example or src block,
43 to make it export to HTML as a text area. To change the
44 defaults for height (number of lines in the example) and
45 width of this area (80), use the =-h= and =-w= switches.
47 Thanks to Ulf Stegemann for driving this development.
49 *** LaTeX_CLASS can be given as a property
51 When exporting a single subtree by selectiong it as a region
52 before export, the LaTeX class for the export will be taken
53 from the =LaTeX_CLASS= property of the entry if present.
55 Thanks to Robert Goldman for this request.
57 *** Better handling of inlined images in different backends
59 Two new variables govern which kind of files can be inlined
60 during export. These are
61 =org-export-html-inline-image-extensions= and
62 =org-export-latex-inline-image-extensions=. Remember that
63 links are turned into an inline image if they are a pure link
64 with no description. HTML files can inline /.png/, /.jpg/,
65 and /.gif/ files, while LaTeX files, when processed with
66 /pdflatex/, can inline /.png/, /.jpg/, and /.pdf/ files.
67 These also represent the default settings for the new
68 variables. Note that this means that pure links to /.pdf/
69 files will be inlined - to avoid this for a particular link,
70 make sure that the link has a description part which is not
71 equal to the link part.
73 *** Links by ID now continue to work in HTML exported files
75 If you make links by ID, these links will now still work in
76 HTML exported files, provided that you keep the relative path
77 from link to target file the same.
79 Thanks to Friedrich Delgado Friedrichs for pushing this over
82 *** The relative timer can be paused
84 The new command `C-c C-x ,' will pause the relative timer.
85 When the relative timer is running, its value will be shown
86 in the mode line. To get rid of this display, you need to
87 really stop the timer with `C-u C-c C-x ,'.
89 Thanks to Alan Davis for driving this change.
91 *** The attachment directory may now be chosen by the user
93 Instead of using the automatic, unique directory related to
94 the entry ID, you can also use a chosen directory for the
95 attachments of an entry. This directory is specified by the
96 ATTACH_DIR property. You can use `C-c C-a s' to set this
99 *** You can use a single attachment directory for a subtree
101 By setting the property ATTACH_DIR_INHERIT, you can now tell
102 Org that children of the entry should use the same directory
103 for attachments, unless a child explicitly defines its own
104 directory with the ATTACH_DIR property. You can use the
105 command `C-c C-a i' to set this property in an entry.
112 - Line numbers and references in literal examples
113 - New hooks for export preprocessing
114 - Capture column view into a different file
120 Org-mode now directly supports the creation of footnotes. In
121 contrast to the /footnote.el/ package, Org-mode's footnotes are
122 designed for work on a larger document, not only for one-off
123 documents like emails. The basic syntax is similar to the one
124 used by /footnote.el/, i.e. a footnote is defined in a paragraph
125 that is started by a footnote marker in square brackets in column
126 0, no indentation allowed. The footnote reference is simply the
127 marker in square brackets inside text. For example:
130 The Org homepage[fn:1] now looks a lot better than it used to.
132 [fn:1] The link is: http://orgmode.org
135 Org-mode extends the number-based syntax to /named/ footnotes and
136 optional inline definition. Using plain numbers as markers is
137 supported for backward compatibility, but not encouraged because
138 of possible conflicts with LaTeX syntax. Here are the valid
141 - [1] :: A plain numeric footnote marker.
143 - [fn:name] :: A named footnote reference, where `name' is a
144 unique label word or, for simplicity of automatic creation,
147 - [fn:: This is the inline definition of this footnote] :: A
148 LaTeX-like anonymous footnote where the definition is given
149 directly at the reference point.
151 - [fn:name: a definition] :: An inline definition of a footnote,
152 which also specifies a name for the note. Since Org allows
153 multiple references to the same note, you can then use use
154 `[fn:name]' to create additional references.
156 Footnote labels can be created automatically, or you create names
157 yourself. This is handled by the variable
158 =org-footnote-auto-label= and its corresponding =#+STARTUP=
159 keywords, see the docstring of that variable for details.
161 The following command handles footnotes:
163 - C-c C-x f :: The footnote action command. When the cursor is
164 on a footnote reference, jump to the definition. When it is
165 at a definition, jump to the (first) reference. Otherwise,
166 create a new footnote. Depending on the variable
167 `org-footnote-define-inline' (with associated =#+STARTUP=
168 options =fninline= and =nofninline=), the definitions will
169 be placed right into the text as part of the reference, or
170 separately into the location determined by the variable
171 =org-footnote-section=.
172 When this command is called with a prefix argument, a menu
173 of additional options is offered:
174 - s :: Sort the footnote definitions by reference sequence.
175 During editing, Org makes no effort to sort footnote
176 definitions into a particular sequence. If you want
177 them sorted, use this command, which will also move
178 entries according to =org-footnote-section=.
179 - n :: Normalize the footnotes by collecting all
180 definitions (including inline definitions) into a
181 special section, and then numbering them in
182 sequence. The references will then also be
183 numbers. This is meant to be the final step before
184 finishing a document (e.g. sending off an email).
185 The exporters do this automatically, and so could
186 something like `message-send-hook'.
187 - d :: Delete the footnote at point, and all references to it.
189 - C-c C-c :: If the cursor is on a footnote reference, jump to
190 the definition. If it is a the definition, jump back to the
191 reference. When called with a prefix argument at either
192 location, offer the same menu as `C-u C-c C-x f'.
194 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
195 corresponding definition/reference, and you can use the
196 usual commands to follow these links.
198 Org-mode's footnote support is designed so that it should also
199 work in buffers that are not in Org-mode, for example in email
200 messages. Just bind =org-footnote-action= to a global key like
203 The main trigger for this development came from a hook function
204 written by Paul Rivier, to implement named footnotes and to
205 convert them to numbered ones before export. Thanks, Paul!
207 Thanks also to Scot Becker for a thoughtful post bringing this
208 subject back onto the discussion table, and to Matt Lundin for
209 the idea of named footnotes and his prompt testing of the new
212 *** Line numbers and references in literal examples
214 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
215 do now allow optional line numbering in the example.
216 Furthermore, links to specific code lines are supported, greatly
217 increasing Org-mode's utility for writing tutorials and other
220 Code references use special labels embedded directly into the
221 source code. Such labels look like "(ref:name)" and must be
222 unique within a document. Org-mode links with "(name)" in the
223 link part will be correctly interpreted, both while working with
224 an Org file (internal links), and while exporting to the
225 different backends. Line numbering and code references are
226 supported for all three major backends, HTML, LaTeX, and ASCII.
227 In the HTML backend, hovering the mouse over a link to a source
228 line will remote-highlight the referenced code line.
230 The options for the BEGIN lines are:
232 - -n :: Number the lines in the example
233 - +n :: Like -n, but continue numbering from where the previous
235 - -r :: Remove the coderef cookies from the example, and replace
236 links to this reference with line numbers. This option
237 takes only effect if either -n or +n are given as well.
238 If -r is not given, coderefs simply use the label name.
239 - -l "fmt" :: Define a local format for coderef labels, see the
240 variable =org-coderef-label-format= for details. Use this
241 of the default syntax causes conflicts with the code in the
242 code snippet you are using.
247 #+begin_src emacs-lisp -n -r
248 (defmacro org-unmodified (&rest body) (ref:def)
249 "Execute body without changing `buffer-modified-p'."
250 `(set-buffer-modified-p (ref:back)
251 (prog1 (buffer-modified-p) ,@body)))
253 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
257 When exported, this is translated to:
258 #+begin_src emacs-lisp -n -r
259 (defmacro org-unmodified (&rest body) (ref:def)
260 "Execute body without changing `buffer-modified-p'."
261 `(set-buffer-modified-p (ref:back)
262 (prog1 (buffer-modified-p) ,@body)))
264 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
267 Thanks to Ilya Shlyakhter for proposing this feature set. Thanks
268 to Sebastian Rose for the key Javascript element that made the
269 remote highlighting possible.
271 *** New hooks for export preprocessing
272 The export preprocessor now runs more hooks, to allow
273 better-timed tweaking by user functions:
275 - =org-export-preprocess-hook= ::
276 Pretty much the first thing in the preprocessor. But org-mode
277 is already active in the preprocessing buffer.
279 - =org-export-preprocess-after-include-files-hook= ::
280 This is run after the contents of included files have been inserted.
282 - =org-export-preprocess-after-tree-selection-hook= ::
283 This is run after selection of trees to be exported has
284 happened. This selection includes tags-based selection, as
285 well as removal of commented and archived trees.
287 - =org-export-preprocess-before-backend-specifics-hook= ::
288 Hook run before backend-specific functions are called during preprocessing.
290 - =org-export-preprocess-final-hook= ::
291 Hook for preprocessing an export buffer. This is run as the
292 last thing in the preprocessing buffer, just before returning
293 the buffer string to the backend.
295 *** Capture column view into a different file
297 The :id parameter for the dynamic block capturing column view
298 can now truly be an ID that will also be found in a
299 different file. Also, it can be like =file:path/to/file=, to
300 capture the global column view from a different file.
302 Thanks to Francois Lagarde for his report that IDs outside
303 the current file would not work.
306 Cleanup of many small bugs, and one new feature.
310 *** References to last table row with special names
312 Fields in the last row of a table can now be referenced with
313 $LR1, $LR2, etc. These references can appear both on the
314 left hand side and right hand side of a formula.
318 This version reverses the introduction of @0 as a reference to
319 the last rwo in a table, because of a conflict with the use of
320 @0 for the current row.
325 - All known LaTeX export issues fixed
326 - Captions and attributes for figures and tables.
327 - Better implementation for entry IDs
328 - Spreadsheet references to the last table line.
329 - Old syntax for link attributes abandoned
331 ** Incompatible changes
332 *** Old syntax for link attributes abandoned
334 There used to be a syntax for setting link attributes for
335 HTML export by enclosing the attributes into double braces
336 and adding them to the link itself, like
339 [[./img/a.jpg{{alt="an image"}}] ]
342 This syntax is not longer supported, use instead
345 ,#+ATTR_HTML: alt="an image"
351 *** All known LaTeX export issues fixed
353 All the remaining issues with the LaTeX exporter have hopefully
354 been addressed in this release. In particular, this covers
355 quoting of special characters in tables and problems with
356 exporting files where the headline is in the first line, or with
359 *** Captions and attributes for figures and tables.
361 Tables, and Hyperlinks that represent inlined images, can now be
362 equipped with additional information that will be used during
363 export. The information will be taken from the following special
364 lines in the buffer and apply to the first following table or
367 - #+CAPTION: :: The caption of the image or table. This string
368 should be processed according to the export backend, but
369 this is not yet done.
371 - #+LABEL: :: A label to identify the figure/table for cross
372 references. For HTML export, this string will become the
373 ID for the ~<div class="figure">~ element that encapsulates
374 the image tag and the caption. For LaTeX export, this
375 string will be used as the argument of a ~\label{...}~
376 macro. These labels will be available for internal links
377 like ~[[label][Table] ]~.
379 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
380 added as attributes into the ~<img...>~ tag. This string
381 will not be processed, so it should have immediately the
384 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
386 For /images/, this string is directly inserted into
387 the optional argument of the ~\includegraphics[...]{file}~
388 command, to specify scaling, clipping and other options.
389 This string will not be processed, so it should have
390 immediately the right format, like =width=5cm,angle=90=.\\
391 For /tables/, this can currently contain the keyword
392 =longtable=, to request typesetting of the table using the
393 longtable package, which automatically distributes the table
394 over several pages if needed. Also, the attributes line may
395 contain an alignment string for the tabular environment, like
396 =longtable,align=l|lrl=
398 For LaTeX export, if either a caption or a label is given, the element
399 will be exported as a float, i.e. wrapped into a figure or table
402 *** Better implementation for entry IDs
404 Unique identifiers for entries can now be used more efficiently.
405 Internally, a hash array has replaced the alist used so far to
406 keep track of the files in which an ID is defined. This makes it
407 quite fast to find an entry by ID.
409 There is a new link type which looks like this:
412 id:GLOBALLY-UNIQUE-IDENTIFIER
415 This link points to a specific entry. When you move the entry to
416 a different file, for example if you move it to an archive
417 file, the link will continue to work.
419 The file /org-id.el/ contains an API that can be used to write
420 code using these identifiers, including creating IDs and finding
421 them wherever they are.
423 Org has its own method to create unique identifiers, but if the system
424 has /uuidgen/ command installed (Mac's and Linux systems generally
425 do), it will be used by default (a change compared to the earlier
426 implmentation, where you explicitdly had to opt for uuidgen). You can
427 also select the method by hand, using the variable =org-id-method=.
429 If the ID system ever gets confused about where a certain ID is, it
430 initiates a global scan of all agenda files with associated archives,
431 all files previously known containing any IDs, and all currently
432 visited Org-mode files to rebuild the hash. You can also initiate
433 this by hand: =M-x org-id-update-id-locations=. Running this command
434 will also dump into the =*Messages*= buffer information about any
435 duplicate IDs. These should not exist, and Org will never /make/ the
436 same ID twice, but if you /copy/ an entry with its properties,
437 duplicate IDs will inevitably be produced. Unfortunately, this is
438 unavoidable in a plain text system that allows you to edit the text in
439 arbitrary ways, and a portion of care on your side is needed to keep
442 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
443 This is also a change from previous versions where the file was
444 =~/.org=id-locations=. Therefore, you can remove this old file
445 if you have it. I am not sure what will happen if the =.emacs.d=
446 directory does not exists in your setup, but in modern Emacsen, I
447 believe it should exist. If you do not want to use IDs across
448 files, you can avoid the overhead with tracking IDs by
449 customizing the variable =org-id-track-globally=. IDs can then
450 still be used for links inside a single file.
452 IDs will also be used when you create a new link to an Org-mode
453 buffer. If you use =org-store-link= (normally at =C-c l=) inside
454 en entry in an Org-mode buffer, and ID property will be created
455 if it does not exist, and the stored link will be an =id:= link.
456 If you prefer the much less secure linking to headline text, you
457 can configure the variable =org-link-to-org-use-id=. The default
458 setting for this variable is =create-if-interactive=, meaning
459 that an ID will be created when you store a link interactively,
460 but not if you happen to be in an Org-mode file while you create
461 a remember note (which usually has a link to the place where you
462 were when starting remember).
464 *** Spreadsheet references to the last table line.
466 You may now use =@0= to reference the last dataline in a table
467 in a stable way. This is useful in particular for automatically
468 generated tables like the ones using /org-collector.el/ by Eric
474 - New relative timer to support timed notes
475 - Special faces can be set for individual tags
476 - The agenda shows now all tags, including inherited ones.
477 - Exclude some tags from inheritance.
478 - More special values for time comparisons in property searches
479 - Control for exporting meta data
480 - Cut and Paste with hot links from w3m to Org
481 - LOCATION can be inherited for iCalendar export
482 - Relative row references crossing hlines now throw an error
484 ** Incompatible Changes
486 *** Relative row references crossing hlines now throw an error
488 Relative row references in tables look like this: "@-4" which
489 means the forth row above this one. These row references are
490 not allowed to cross horizontal separator lines (hlines). So
491 far, when a row reference violates this policy, Org would
492 silently choose the field just next to the hline.
494 Tassilo Horn pointed out that this kind of hidden magic is
495 actually confusing and may cause incorrect formulas, and I do
496 agree. Therefore, trying to cross a hline with a relative
497 reference will now throw an error.
499 If you need the old behavior, customize the variable
500 `org-table-error-on-row-ref-crossing-hline'.
504 *** New relative timer to support timed notes
506 Org now supports taking timed notes, useful for example while
507 watching a video, or during a meeting which is also recorded.
510 Insert a relative time into the buffer. The first time
511 you use this, the timer will be started. When called
512 with a prefix argument, the timer is reset to 0.
515 Insert a description list item with the current relative
516 time. With a prefix argument, first reset the timer to 0.
519 Once the time list has been initiated, you can also use the
520 normal item-creating command to insert the next timer item.
523 Reset the timer without inserting anything into the buffer.
524 By default, the timer is reset to 0. When called with a
525 =C-u= prefix, reset the timer to specific starting
526 offset. The user is prompted for the offset, with a
527 default taken from a timer string at point, if any, So this
528 can be used to restart taking notes after a break in the
529 process. When called with a double prefix argument
530 =C-c C-u=, change all timer strings in the active
531 region by a certain amount. This can be used to fix timer
532 strings if the timer was not started at exactly the right
535 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
536 contributions to this idea.
538 *** Special faces can be set for individual tags
540 You may now use the variable =org-tag-faces= to define the
541 face used for specific tags, much in the same way as you can
542 do for TODO keywords.
544 Thanks to Samuel Wales for this proposal.
546 *** The agenda shows now all tags, including inherited ones.
548 This request has come up often, most recently it was
549 formulated by Tassilo Horn.
551 If you prefer the old behavior of only showing the local
552 tags, customize the variable =org-agenda-show-inherited-tags=.
554 *** Exclude some tags from inheritance.
556 So far, the only way to select tags for inheritance was to
557 allow it for all tags, or to do a positive selection using
558 one of the more complex settings for
559 `org-use-tag-inheritance'. It may actually be better to
560 allow inheritance for all but a few tags, which was difficult
561 to achieve with this methodology.
563 A new option, `org-tags-exclude-from-inheritance', allows to
564 specify an exclusion list for inherited tags.
566 *** More special values for time comparisons in property searches
568 In addition to =<now>=, =<today>=, =<yesterday>=, and
569 =<tomorrow>=, there are more special values accepted now in
570 time comparisons in property searches: You may use strings
571 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
572 week, month, and year, respectively
574 Thanks to Linday Todd for this proposal.
576 *** Control for exporting meta data
578 All the metadata in a headline, i.e. the TODO keyword, the
579 priority cookie, and the tags, can now be excluded from
580 export with appropriate options:
582 | Variable | Publishing property | OPTIONS switch |
583 |-------------------------------+---------------------+----------------|
584 | org-export-with-todo-keywords | :todo-keywords | todo: |
585 | org-export-with-tags | :tags | tags: |
586 | org-export-with-priority | :priority | pri: |
588 *** Cut and Paste with hot links from w3m to Org
590 You can now use the key =C-c C-x M-w= in a w3m buffer with
591 HTML content to copy either the region or the entire file in
592 a special way. When you yank this text back into an Org-mode
593 buffer, all links from the w3m buffer will continue to work
596 For this to work you need to load the new file /org-w3m.el./
597 Please check your org-modules variable to make sure that this
600 Thanks for Richard Riley for the idea and to Andy Stewart for
603 *** LOCATION can be inherited for iCalendar export
605 The LOCATION property can now be inherited during iCalendar
606 export if you configure =org-use-property-inheritance= like
609 #+begin_src emacs-lisp
610 (setq org-use-property-inheritance '("LOCATION"))
617 - Keybindings in Remember buffers can be configured
618 - Support for ido completion
619 - New face for date lines in agenda column view
620 - Invisible targets become now anchors in headlines.
621 - New contributed file /org-exp-blocks.el/
622 - New contributed file /org-eval-light.el/
624 - BBDB links may use regular expressions.
625 - Link abbreviations can use %h to insert a url-encoded target value
626 - Improved XHTML compliance
630 *** Keybindings in Remember buffers can be configured
632 The remember buffers created with Org's extensions are in
633 Org-mode, which is nice to prepare snippets that will
634 actually be stored in Org-mode files. However, this makes it
635 hard to configure key bindings without modifying the Org-mode
636 keymap. There is now a minor mode active in these buffers,
637 `org-remember-mode', and its keymap org-remember-mode-map can
638 be used for key bindings. By default, this map only contains
639 the bindings for =C-c C-c= to store the note, and =C-c C-k=
640 to abort it. Use `org-remember-mode-hook' to define your own
643 #+begin_src emacs-lisp
645 'org-remember-mode-hook
647 (define-key org-remember-mode-map
648 "\C-x\C-s" 'org-remember-finalize)))
651 If you wish, you can also use this to free the =C-c C-c=
652 binding (by binding this key to nil in the minor mode map),
653 so that you can use =C-c C-c= again to set tags.
655 This modification is based on a request by Tim O'Callaghan.
657 *** Support for ido completion
659 You can now get the completion interface from /ido.el/ for
660 many of Org's internal completion commands by turning on the
661 variable =org-completion-use-ido=. =ido-mode= must also be
662 active before you can use this.
664 This change is based upon a request by Samuel Wales.
666 *** New face for date lines in agenda column view
668 When column view is active in the agenda, and when you have
669 summarizing properties, the date lines become normal column
670 lines and the separation between different days becomes
671 harder to see. If this bothers you, you can now customize
672 the face =org-agenda-column-dateline=.
674 This is based on a request by George Pearson.
676 *** Invisible targets become now anchors in headlines.
678 These anchors can be used to jump to a directly with an HTML
679 link, just like the =sec-xxx= IDs. For example, the
680 following will make a http link
681 =//domain/path-to-my-file.html#dummy= work:
688 This is based on a request by Matt Lundin.
690 *** New contributed file /org-exp-blocks.el/
692 This new file implements special export behavior of
693 user-defined blocks. The currently supported blocks are
695 - comment :: Comment blocks with author-specific markup
696 - ditaa :: conversion of ASCII art into pretty png files
697 using Stathis Sideris' /ditaa.jar/ program
698 - dot :: creation of graphs in the /dot/ language
699 - R :: Sweave type exporting using the R program
701 For more details and examples, see the file commentary in
704 Kudos to Eric Schulte for this new functionality, after
705 /org-plot.el/ already his second major contribution. Thanks
706 to Stathis for this excellent program, and for allowing us to
707 bundle it with Org-mode.
709 *** New contributed file /org-eval-light.el/
711 This module gives control over execution Emacs Lisp code
712 blocks included in a file.
714 Thanks to Eric Schulte also for this file.
718 You can now configure Org to understand many links created
719 with the Emacs Planner package, so you can cut text from
720 planner pages and paste them into Org-mode files without
721 having to re-write the links. Among other things, this means
722 that the command =org-open-at-point-global= which follows
723 links not only in Org-mode, but in arbitrary files like
724 source code files etc, will work also with links created by
725 planner. The following customization is needed to make all of
728 #+begin_src emacs-lisp
729 (setq org-link-translation-function
730 'org-translate-link-from-planner)
733 I guess an inverse translator could be written and integrated
736 *** BBDB links may use regular expressions.
738 This did work all along, but only now I have documented it.
740 *** =yank-pop= works again after yanking an outline tree
742 Samuel Wales had noticed that =org-yank= did mess up this
743 functionality. Now you can use =yank-pop= again, the only
744 restriction is that the so-yanked text will not be
745 pro/demoted or folded.
747 *** Link abbreviations can use %h to insert a url-encoded target value
749 Thanks to Steve Purcell for a patch to this effect.
751 *** Improved XHTML compliance
753 Thanks to Sebastian Rose for pushing this.
755 *** Many bug fixes again.
760 - A region of entries can now be refiled with a single command
761 - Fine-tuning the behavior of `org-yank'
762 - Formulas for clocktables
763 - Better implementation of footnotes for HTML export
764 - More languages for HTML export.
768 *** A region of entries can now be refiled with a single command
770 With =transient-make-mode= active (=zmacs-regions= under
771 XEmacs), you can now select a region of entries and refile
772 them all with a single =C-c C-w= command.
774 Thanks to Samuel Wales for this useful proposal.
776 *** Fine-tuning the behavior of =org-yank=
778 The behavior of Org's yanking command has been further
779 fine-tuned in order to avoid some of the small annoyances
782 - Calling =org-yank= with a prefix arg will stop any special
783 treatment and directly pass through to the normal =yank=
784 command. Therefore, you can now force a normal yank with
787 - Subtrees will only be folded after a yank if doing so will
788 now swallow any non-white characters after the yanked text.
789 This is, I think a really important change to make the
790 command work more sanely.
792 *** Formulas for clocktables
794 You can now add formulas to a clock table, either by hand, or
795 with a =:formula= parameter. These formulas can be used to
796 create additional columns with further analysis of the
799 Thanks to Jurgen Defurne for triggering this addition.
801 *** Better implementation of footnotes for HTML export
803 The footnote export in 6.11 really was not good enough. Now
804 it works fine. If you have customized
805 =footnote-section-tag=, make sure that your customization is
806 matched by =footnote-section-tag-regexp=.
808 Thanks to Sebastian Rose for pushing this change.
810 *** More languages for HTML export.
812 More languages are supported during HTML export. This is
813 only relevant for the few special words Org inserts, like
814 "Table of Contents", or "Footnotes". Also the encoding
815 issues with this feature seem to be solved now.
817 Thanks to Sebastian Rose for pushing me to fix the encoding
824 - Yanking subtree with =C-y= now adjusts the tree level
825 - State changes can now be shown in the log mode in the agenda
826 - Footnote in HTML export are now collected at the end of the document
827 - HTML export now validates again as XHTML
828 - The clock can now be resumed after exiting and re-starting Emacs
829 - Clock-related data can be saved and resumed across Emacs sessions
830 - Following file links can now use C-u C-u to force use of an external app
831 - Inserting absolute files names now abbreviates links with "~"
832 - Links to attachment files
833 - Completed repeated tasks listed briefly in agenda
834 - Remove buffers created during publishing are removed
838 *** Yanking subtree with =C-y= now adjusts the tree level
839 When yanking a cut/copied subtree or a series of trees, the
840 normal yank key =C-y= now adjusts the level of the tree to
841 make it fit into the current outline position, without losing
842 its identity, and without swallowing other subtrees.
844 This uses the command =org-past-subtree=. An additional
845 change in that command has been implemented: Normally, this
846 command picks the right outline level from the surrounding
847 *visible* headlines, and uses the smaller one. So if the
848 cursor is between a level 4 and a level 3 headline, the tree
849 will be pasted as level 3. If the cursor is actually *at*
850 the beginning of a headline, the level of that headline will
851 be used. For example, lets say you have a tree like this:
857 ,(2)* Level one again
860 with (1) and (2) indicating possible cursor positions for the
861 insertion. When at (1), the tree will be pasted as level 2.
862 When at (2), it will be pasted as level 1.
864 If you do not want =C-y= to behave like this, configure the
865 variable =org-yank-adjusted-subtrees=.
867 Thanks to Samuel Wales for this idea and a partial implementation.
869 *** State changes can now be shown in the log mode in the agenda
871 If you configure the variable =org-agenda-log-mode-items=,
872 you can now request that all logged state changes be included
873 in the agenda when log mode is active. If you find this too
874 much for normal applications, you can also temporarily
875 request the inclusion of state changes by pressing =C-u l= in
878 This was a request by Hsiu-Khuern Tang.
880 You can also press `C-u C-u l' to get *only* log items in the
881 agenda, withour any timestamps/deadlines etc.
883 *** Footnote in HTML export are now collected at the end of the document
884 Previously, footnotes would be left in the document where
885 they are defined, now they are all collected and put into a
886 special =<div>= at the end of the document.
888 Thanks to Sebastian Rose for this request.
890 *** HTML export now validates again as XHTML.
892 Thanks to Sebastian Rose for pushing this cleanup.
894 *** The clock can now be resumed after exiting and re-starting Emacs
896 If the option =org-clock-in-resume= is t, and the first clock
897 line in an entry is unclosed, clocking into that task resumes
898 the clock from that time.
900 Thanks to James TD Smith for a patch to this effect.
902 *** Clock-related data can be saved and resumed across Emacs sessions
904 The data saved include the contents of =org-clock-history=,
905 and the running clock, if there is one.
907 To use this, you will need to add to your .emacs
909 #+begin_src emacs-lisp
910 (setq org-clock-persist t)
911 (setq org-clock-in-resume t)
912 (org-clock-persistence-insinuate)
915 Thanks to James TD Smith for a patch to this effect.
917 *** Following file links can now use C-u C-u to force use of an external app.
919 So far you could only bypass your setup in `org-file-apps'
920 and force opening a file link in Emacs by using a =C-u= prefix arg
921 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
922 an external application. Which external application depends
923 on your system. On Mac OS X and Windows, =open= is used. On
924 a GNU/Linux system, the mailcap settings are used.
926 This was a proposal by Samuel Wales.
928 *** Inserting absolute files names now abbreviates links with "~".
930 Inserting file links with =C-u C-c C-l= was buggy if the
931 setting of `org-link-file-path-type' was `adaptive' (the
932 default). Absolute file paths were not abbreviated relative
933 to the users home directory. This bug has been fixed.
935 Thanks to Matt Lundin for the report.
937 *** Links to attachment files
939 Even though one of the purposes of entry attachments was to
940 reduce the number of links in an entry, one might still want
941 to have the occasional link to one of those files. You can
942 now use link abbreviations to set up a special link type that
943 points to attachments in the current entry. Note that such
944 links will only work from within the same entry that has the
945 attachment, because the directory path is entry specific.
946 Here is the setup you need:
948 #+begin_src emacs-lisp
949 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
952 After this, a link like this will work
955 [[att:some-attached-file.txt]]
957 This was a proposal by Lindsay Todd.
959 *** Completed repeated tasks listed briefly in agenda
961 When a repeating task, listed in the daily/weekly agenda under
962 today's date, is completed from the agenda, it is listed as
963 DONE in the agenda until the next update happens. After the
964 next update, the task will have disappeared, of course,
965 because the new date is no longer today.
967 *** Remove buffers created during publishing are removed
969 Buffers that are created during publishing are now deleted
970 when the publishing is over. At least I hope it works like this.
976 - Secondary agenda filtering is becoming a killer feature
977 - Setting tags has now its own binding, =C-c C-q=
978 - Todo state changes can trigger tag changes
979 - C-RET will now always insert a new headline, never an item.
980 - Customize org-mouse.el feature set to free up mouse events
981 - New commands for export all the way to PDF (through LaTeX)
982 - Some bug fixed for LaTeX export, more bugs remain.
986 *** Enhancements to secondary agenda filtering
988 This is, I believe, becoming a killer feature. It allows you
989 to define fewer and more general custom agenda commands, and
990 then to do the final narrowing to specific tasks you are
991 looking for very quickly, much faster than calling a new
994 If you have not tries this yet, you should!
996 **** You can now refining the current filter by an additional criterion
997 When filtering an existing agenda view with =/=, you can
998 now narrow down the existing selection by an additional
999 condition. Do do this, use =\= instead of =/= to add the
1000 additional criterion. You can also press =+= or =-= after
1001 =/= to add a positive or negative condition. A condition
1002 can be a TAG, or an effort estimate limit, see below.
1004 **** It is now possible to filter for effort estimates
1005 This means to filter the agenda for the value of the Effort
1006 property. For this you should best set up global allowed
1007 values for effort estimates, with
1009 #+begin_src emacs-lisp
1010 (setq org-global-properties
1011 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
1014 You may then select effort limits with single keys in the
1015 filter. It works like this: After =/= or =\=, first select
1016 the operator which you want to use to compare effort
1019 : < Select entries with effort smaller than or equal to the limit
1020 : > Select entries with effort larger than or equal to the limit
1021 : = Select entries with effort equal to the limit
1023 After that, you can press a single digit number which is
1024 used as an index to the allowed effort estimates.
1026 If you do not use digits to fast-select tags, you can even
1027 skip the operator, which will then default to
1028 `org-agenda-filter-effort-default-operator', which is by
1031 Thanks to Manish for the great idea to include fast effort
1032 filtering into the agenda filtering process.
1034 **** The mode line will show the active filter
1035 For example, if there is a filter in place that does select
1036 for HOME tags, against EMAIL tags, and for tasks with an
1037 estimated effort smaller than 30 minutes, the mode-line with
1038 show =+HOME-EMAIL+<0:30=
1040 **** The filter now persists when the agenda view is refreshed
1041 All normal refresh commands, including those that move the
1042 weekly agenda from one week to the next, now keep the
1043 current filter in place.
1045 You need to press =/ /= to turn off the filter. However,
1046 when you run a new agenda command, for example going from
1047 the weekly agenda to the TODO list, the filter will be
1050 *** Setting tags has now its own binding, =C-c C-q=
1052 You can still use =C-c C-c= on a headline, but the new
1053 binding should be considered as the main binding for this
1054 command. The reasons for this change are:
1056 - Using =C-c C-c= for tags is really out of line with other
1059 - I hate it in Remember buffers when I try to set tags and I
1060 cannot, because =C-c C-c= exits the buffer :-(
1062 - =C-c C-q= will also work when the cursor is somewhere down
1063 in the entry, it does not have to be on the headline.
1065 *** Todo state changes can trigger tag changes
1067 The new option =org-todo-state-tags-triggers= can be used to
1068 define automatic changes to tags when a TODO state changes.
1069 For example, the setting
1071 : (setq org-todo-state-tags-triggers
1072 : '((done ("Today" . nil) ("NEXT" . nil))
1073 : ("WAITING" ("Today" . t))))
1075 will make sure that any change to any of the DONE states will
1076 remove tags "Today" and "NEXT", while switching to the
1077 "WAITING" state will trigger the tag "Today" to be added.
1079 I use this mostly to get rid of TODAY and NEXT tags which I
1080 apply to select an entry for execution in the near future,
1081 which I often prefer to specific time scheduling.
1083 *** C-RET will now always insert a new headline, never an item.
1084 The new headline is inserted after the current subtree.
1086 Thanks to Peter Jones for patches to fine-tune this behavior.
1088 *** Customize org-mouse.el feature set
1089 There is a new variable =org-mouse-features= which gives you
1090 some control about what features of org-mouse you want to
1091 use. Turning off some of the feature will free up the
1092 corresponding mouse events, or will avoid activating special
1093 regions for mouse clicks. By default I have urned off the
1094 feature to use drag mouse events to move or promote/demote
1095 entries. You can of course turn them back on if you wish.
1097 This variable may still change in the future, allowing more
1098 fine-grained control.
1100 *** New commands for export to PDF
1102 This is using LaTeX export, and then processes it to PDF
1105 : C-c C-e p process to PDF.
1106 : C-c C-e d process to PDF, and open the file.
1109 - \usepackage{graphicx} is now part of the standard class
1111 - Several bugs fixed, but definitely not all of them :-(
1113 *** New option `org-log-state-notes-insert-after-drawers'
1115 Set this to =t= if you want state change notes to be inserted
1116 after any initial drawers, i.e drawers the immediately follow
1117 the headline and the planning line (the one with
1118 DEADLINE/SCHEDULED/CLOSED information).
1122 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1126 *** =org-file-apps= now uses regular repressions instead of extensions
1127 Just like in =auto-mode-alist=, car's in the variable
1128 =org-file-apps= that are strings are now interpreted as
1129 regular expressions that are matched against a file name. So
1130 instead of "txt", you should now write "\\.txt\\'" to make
1131 sure the matching is done correctly (even though "txt" will
1132 be recognized and still be interpreted as an extension).
1134 There is now a shortcut to get many file types visited by
1135 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
1136 any files that are matched by `auto-mode-alist' will be
1139 *** Changes to the attachment system
1141 - The default method to attach a file is now to copy it
1142 instead of moving it.
1143 - You can modify the default method using the variable
1144 `org-attach-method'. I believe that most Unix people want
1145 to set it to `ln' to create hard links.
1146 - The keys =c=, =m=, and =l= specifically select =copy=,
1147 =move=, or =link=, respectively, as the attachment method
1148 for a file, overruling `org-attach-method'.
1149 - To create a new attachment as an Emacs buffer, you have not
1150 now use =n= instead of =c=.
1151 - The file list is now always retrieved from the directory
1152 itself, not from the "Attachments" property. We still
1153 keep this property by default, but you can turn it off, by
1154 customizing the variable =org-attach-file-list-property=.
1158 ** Incompatible changes
1160 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
1162 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
1166 *** The default structure of IDs has changed
1168 IDs created by Org have changed a bit:
1169 - By default, there is no prefix on the ID. There used to be
1170 an "Org" prefix, but I now think this is not necessary.
1171 - IDs use only lower-case letters, no upper-case letters
1172 anymore. The reason for this is that IDs are now also used
1173 as directory names for org-attach, and some systems do not
1174 distinguish upper and lower case in the file system.
1175 - The ID string derived from the current time is now
1176 /reversed/ to become an ID. This assures that the first
1177 two letters of the ID change fast, so hat it makes sense to
1178 split them off to create subdirectories to balance load.
1179 - You can now set the `org-id-method' to `uuidgen' on systems
1182 *** =C-c C-a= no longer calls `show-all'
1184 The reason for this is that =C-c C-a= is now used for the
1185 attachment system. On the rare occasions that this command
1186 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
1188 *** New attachment system
1190 You can now attach files to each node in the outline tree.
1191 This works by creating special directories based on the ID of
1192 an entry, and storing files in these directories. Org can
1193 keep track of changes to the attachments by automatically
1194 committing changes to git. See the manual for more
1197 Thanks to John Wiegley who contributed this fantastic new
1198 concept and wrote org-attach.el to implement it.
1200 *** New remember template escapes
1202 : %^{prop}p to insert a property
1203 : %k the heading of the item currently being clocked
1204 : %K a link to the heading of the item currently being clocked
1206 Also, when you exit remember with =C-2 C-c C-c=, the item
1207 will be filed as a child of the item currently being
1208 clocked. So the idea is, if you are working on something and
1209 think of a new task related to this or a new note to be
1210 added, you can use this to quickly add information to that
1213 Thanks to James TD Smith for a patch to this effect.
1215 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
1217 Thanks to James TD Smith for a patch to this effect.
1219 *** New file in contrib: lisp/org-checklist.el
1221 This module deals with repeated tasks that have checkbox
1224 Thanks to James TD Smith for this contribution.
1226 *** New in-buffer setting #+STYLE
1228 It can be used to locally set the variable
1229 `org-export-html-style-extra'. Several such lines are
1230 allowed-, they will all be concatenated. For an example on
1231 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1237 - Filtering existing agenda views with respect to a tag
1238 - Editing fixed-width regions with picture or artist mode
1239 - /org-plot.el/ is now part of Org
1240 - Tags can be used to select the export part of a document
1241 - Prefix interpretation when storing remember notes
1242 - Yanking inserts folded subtrees
1243 - Column view capture tables can have formulas, plotting info
1244 - In column view, date stamps can be changed with S-cursor keys
1245 - The note buffer for clocking out now mentions the task
1246 - Sorting entries alphabetically ignores TODO keyword and priority
1247 - Agenda views can sort entries by TODO state
1248 - New face =org-scheduled= for entries scheduled in the future.
1249 - Remember templates for gnus links can use the :to escape.
1250 - The file specification in a remember template may be a function
1251 - Categories in iCalendar export include local tags
1252 - It is possible to define filters for column view
1253 - Disabling integer increment during table Field copy
1254 - Capturing column view is on `C-c C-x i'
1255 - And tons of bugs fixed.
1258 ** Incompatible changes
1260 *** Prefix interpretation when storing remember notes has changed
1262 The prefix argument to the `C-c C-c' command that finishes a
1263 remember process is now interpreted differently:
1265 : C-c C-c Store the note to predefined file and headline
1266 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1267 : in its new location.
1268 : C-1 C-c C-c Select the storage location interactively
1269 : C-0 C-c C-c Re-use the last used location
1271 This was requested by John Wiegley.
1273 *** Capturing column view is now on `C-c C-x i'
1275 The reason for this change was that `C-c C-x r' is also used
1276 as a tty key replacement.
1278 *** Categories in iCalendar export now include local tags
1280 The locally defined tags are now listed as categories when
1281 exporting to iCalendar format. Org's traditional file/tree
1282 category is now the last category in this list. Configure
1283 the variable =org-icalendar-categories= to modify or revert
1286 This was a request by Charles Philip Chan.
1290 *** Secondary filtering of agenda views.
1292 You can now easily and interactively filter an existing
1293 agenda view with respect to a tag. This command is executed
1294 with the =/= key in the agenda. You will be prompted for a
1295 tag selection key, and all entries that do not contain or
1296 inherit the corresponding tag will be hidden. With a prefix
1297 argument, the opposite filter is applied: entries that
1298 do have the tag will be hidden.
1300 This operation only /hides/ lines in the agenda buffer, it
1301 does not remove them. Changing the secondary filtering does
1302 not require a new search and is very fast.
1304 If you press TAB at the tag selection prompt, you will be
1305 switched to a completion interface to select a tag. This is
1306 useful when you want to select a tag that does not have a
1307 direct access character.
1309 A double =/ /= will restore the original agenda view by
1310 unhiding any hidden lines.
1312 This functionality was John Wiegley's idea. It is a simpler
1313 implementation of some of the query-editing features proposed
1314 and implemented some time ago by Christopher League (see the
1315 file contrib/lisp/org-interactive-query.el).
1317 *** Editing fixed-width regions with picture or artist mode
1319 The command @<code>C-c '@</code> (that is =C-c= followed by a
1320 single quote) can now also be used to switch to a special
1321 editing mode for fixed-width sections. The default mode is
1322 =artist-mode= which allows you to create ASCII drawings.
1324 It works like this: Enter the editing mode with
1325 @<code>C-c '@</code>. An indirect buffer will be created and
1326 narrowed to the fixed-width region. Edit the drawing, and
1327 press @<code>C-c '@</code> again to exit.
1329 Lines in a fixed-width region should be preceded by a colon
1330 followed by at least one space. These will be removed during
1331 editing, and then added back when you exit the editing mode.
1333 Using the command in an empty line will create a new
1336 This new feature arose from a discussion involving Scott
1337 Otterson, Sebastian Rose and Will Henney.
1339 *** /org-plot.el/ is now part of Org.
1341 You can run it by simple calling org-plot/gnuplot.
1342 Documentation is not yet included with Org, please refer to
1343 http://github.com/eschulte/org-plot/tree/master until we have
1344 moved the docs into Org or Worg.
1346 Thanks to Eric Schulte for this great contribution.
1348 *** Tags can be used to select the export part of a document
1350 You may now use tags to select parts of a document for
1351 inclusion into the export, and to exclude other parts. This
1352 behavior is governed by two new variables:
1353 =org-export-select-tags= and =org-export-exclude-tags=.
1354 These default to =("export")= and =("noexport")=, but can be
1355 changed, even to include a list of several tags.
1357 Org first checks if any of the /select/ tags is present in
1358 the buffer. If yes, all trees that do not carry one of these
1359 tags will be excluded. If a selected tree is a subtree, the
1360 heading hierarchy above it will also be selected for export,
1361 but not the text below those headings. If none of the select
1362 tags is found anywhere in the buffer, the whole buffer will
1363 be selected for export. Finally, all subtrees that are
1364 marked by any of the /exclude/ tags will be removed from the
1367 You may set these tags with in-buffer options
1368 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1370 I love this feature. Thanks to Richard G Riley for coming
1373 *** Prefix interpretation when storing remember notes
1375 The prefix argument to the `C-c C-c' command that finishes a
1376 remember process is now interpreted differently:
1378 : C-c C-c Store the note to predefined file and headline
1379 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1380 : in its new location.
1381 : C-1 C-c C-c Select the storage location interactively
1382 : C-0 C-c C-c Re-use the last used location
1384 This was requested by John Wiegley.
1386 *** Yanking inserts folded subtrees
1388 If the kill is a subtree or a sequence of subtrees, yanking
1389 them with =C-y= will leave all the subtrees in a folded
1390 state. This basically means, that kill and yank are now
1391 much more useful in moving stuff around in your outline. If
1392 you do not like this, customize the variable
1393 =org-yank-folded-subtrees=.
1395 Right now, I am only binding =C-y= to this new function,
1396 should I modify all bindings of yank? Do we need to amend
1399 This feature was requested by John Wiegley.
1401 *** Column view capture tables can have formulas, plotting info
1403 If you attach formulas and plotting instructions to a table
1404 capturing column view, these extra lines will now survive an
1405 update of the column view capture, and any formulas will be
1406 re-applied to the captured table. This works by keeping any
1407 continuous block of comments before and after the actual
1410 *** In column view, date stamps can be changed with S-cursor keys
1412 If a property value is a time stamp, S-left and S-right can
1413 now be used to shift this date around while in column view.
1415 This was a request by Chris Randle.
1417 *** The note buffer for clocking out now mentions the task
1419 This was a request by Peter Frings.
1421 *** Sorting entries alphabetically ignores TODO keyword and priority
1423 Numerical and alphanumerical sorting now skips any TODO
1424 keyword or priority cookie when constructing the comparison
1425 string. This was a request by Wanrong Lin.
1427 *** Agenda views can sort entries by TODO state
1429 You can now define a sorting strategy for agenda entries that
1430 does look at the TODO state of the entries. Sorting by TODO
1431 entry does first separate the non-done from the done states.
1432 Within each class, the entries are sorted not alphabetically,
1433 but in definition order. So if you have a sequence of TODO
1434 entries defined, the entries will be sorted according to the
1435 position of the keyword in this sequence.
1437 This follows an idea and sample implementation by Christian
1440 *** New face =org-scheduled= for entries scheduled in the future.
1442 This was a request by Richard G Riley.
1444 *** Remember templates for gnus links can now use the :to escape.
1446 Thanks to Tommy Lindgren for a patch to this effect.
1447 *** The file specification in a remember template may now be a function
1449 Thanks to Gregory Sullivan for a patch to this effect.
1451 *** Categories in iCalendar export now include local tags
1453 The locally defined tags are now listed as categories when
1454 exporting to iCalendar format. Org's traditional file/tree
1455 category is now the last category in this list. Configure
1456 the variable =org-icalendar-categories= to modify or revert
1459 This was a request by Charles Philip Chan.
1461 *** It is now possible to define filters for column view
1463 The filter can modify the value that will be displayed in a
1464 column, for example it can cut out a part of a time stamp.
1465 For more information, look at the variable
1466 =org-columns-modify-value-for-display-function=.
1468 *** Disabling integer increment during table field copy
1470 Prefix arg 0 to S-RET does the trick.
1472 This was a request by Chris Randle.
1477 For older Changes, see [[file:Changes_old.org]]