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
18 - Line numbers and references in literal examples
19 - New hooks for export preprocessing
20 - Capture column view into a different file
26 Org-mode now directly supports the creation of footnotes. In
27 contrast to the /footnote.el/ package, Org-mode's footnotes are
28 designed for work on a larger document, not only for one-off
29 documents like emails. The basic syntax is similar to the one
30 used by /footnote.el/, i.e. a footnote is defined in a paragraph
31 that is started by a footnote marker in square brackets in column
32 0, no indentation allowed. The footnote reference is simply the
33 marker in square brackets inside text. For example:
36 The Org homepage[fn:1] now looks a lot better than it used to.
38 [fn:1] The link is: http://orgmode.org
41 Org-mode extends the number-based syntax to /named/ footnotes and
42 optional inline definition. Using plain numbers as markers is
43 supported for backward compatibility, but not encouraged because
44 of possible conflicts with LaTeX syntax. Here are the valid
47 - [1] :: A plain numeric footnote marker.
49 - [fn:name] :: A named footnote reference, where `name' is a
50 unique label word or, for simplicity of automatic creation,
53 - [fn:: This is the inline definition of this footnote] :: A
54 LaTeX-like anonymous footnote where the definition is given
55 directly at the reference point.
57 - [fn:name: a definition] :: An inline definition of a footnote,
58 which also specifies a name for the note. Since Org allows
59 multiple references to the same note, you can then use use
60 `[fn:name]' to create additional references.
62 Footnote labels can be created automatically, or you create names
63 yourself. This is handled by the variable
64 =org-footnote-auto-label= and its corresponding =#+STARTUP=
65 keywords, see the docstring of that variable for details.
67 The following command handles footnotes:
69 - C-c C-x f :: The footnote action command. When the cursor is
70 on a footnote reference, jump to the definition. When it is
71 at a definition, jump to the (first) reference. Otherwise,
72 create a new footnote. Depending on the variable
73 `org-footnote-define-inline' (with associated =#+STARTUP=
74 options =fninline= and =nofninline=), the definitions will
75 be placed right into the text as part of the reference, or
76 separately into the location determined by the variable
77 =org-footnote-section=.
78 When this command is called with a prefix argument, a menu
79 of additional options is offered:
80 - s :: Sort the footnote definitions by reference sequence.
81 During editing, Org makes no effort to sort footnote
82 definitions into a particular sequence. If you want
83 them sorted, use this command, which will also move
84 entries according to =org-footnote-section=.
85 - n :: Normalize the footnotes by collecting all
86 definitions (including inline definitions) into a
87 special section, and then numbering them in
88 sequence. The references will then also be
89 numbers. This is meant to be the final step before
90 finishing a document (e.g. sending off an email).
91 The exporters do this automatically, and so could
92 something like `message-send-hook'.
93 - d :: Delete the footnote at point, and all references to it.
95 - C-c C-c :: If the cursor is on a footnote reference, jump to
96 the definition. If it is a the definition, jump back to the
97 reference. When called with a prefix argument at either
98 location, offer the same menu as `C-u C-c C-x f'.
100 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
101 corresponding definition/reference, and you can use the
102 usual commands to follow these links.
104 Org-mode's footnote support is designed so that it should also
105 work in buffers that are not in Org-mode, for example in email
106 messages. Just bind =org-footnote-action= to a global key like
109 The main trigger for this development came from a hook function
110 written by Paul Rivier, to implement named footnotes and to
111 convert them to numbered ones before export. Thanks, Paul!
113 Thanks also to Scot Becker for a thoughtful post bringing this
114 subject back onto the discussion table, and to Matt Lundin for
115 the idea of named footnotes and his prompt testing of the new
118 *** Line numbers and references in literal examples
120 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
121 do now allow optional line numbering in the example.
122 Furthermore, links to specific code lines are supported, greatly
123 increasing Org-mode's utility for writing tutorials and other
126 Code references use special labels embedded directly into the
127 source code. Such labels look like "((name))" and must be unique
128 within a document. Org-mode links with the coderef cookie in the
129 link part will be correctly interpreted, both while working with
130 an Org file (internal links), and while exporting to the
131 different backends. Line numbering and code references are
132 supported for all three major backends, HTML, LaTeX, and ASCII.
133 In the HTML backend, hovering the mouse over a link to a source
134 line will remote-highlight the referenced code line.
136 The options for the BEGIN lines are:
138 - -n :: Number the lines in the example
139 - +n :: Like -n, but continue numbering from where the previous
141 - -r :: Remove the coderef cookies from the example, and replace
142 links to this reference with line numbers. This option
143 takes only effect if either -n or +n are given as well.
144 If -r is not given, coderefs simply use the label name.
149 #+begin_src emacs-lisp -n -r
150 (defmacro org-unmodified (&rest body) ((def))
151 "Execute body without changing `buffer-modified-p'."
152 `(set-buffer-modified-p ((back))
153 (prog1 (buffer-modified-p) ,@body)))
155 [[((def))][Line ((def))]] contains the macro name. Later at line [[((back))]],
159 When exported, this is translated to:
160 #+begin_src emacs-lisp -n -r
161 (defmacro org-unmodified (&rest body) ((def))
162 "Execute body without changing `buffer-modified-p'."
163 `(set-buffer-modified-p ((back))
164 (prog1 (buffer-modified-p) ,@body)))
166 [[((def))][Line ((def))]] contains the macro name. Later at line [[((back))]],
169 Thanks to Ilya Shlyakhter for proposing this feature set. Thanks
170 to Sebastian Rose for the key Javascript element that made the
171 remote highlighting possible.
173 *** New hooks for export preprocessing
174 The export preprocessor now runs more hooks, to allow
175 better-timed tweaking by user functions:
177 - =org-export-preprocess-hook= ::
178 Pretty much the first thing in the preprocessor. But org-mode
179 is already active in the preprocessing buffer.
181 - =org-export-preprocess-after-include-files-hook= ::
182 This is run after the contents of included files have been inserted.
184 - =org-export-preprocess-after-tree-selection-hook= ::
185 This is run after selection of trees to be exported has
186 happened. This selection includes tags-based selection, as
187 well as removal of commented and archived trees.
189 - =org-export-preprocess-before-backend-specifics-hook= ::
190 Hook run before backend-specific functions are called during preprocessing.
192 - =org-export-preprocess-final-hook= ::
193 Hook for preprocessing an export buffer. This is run as the
194 last thing in the preprocessing buffer, just before returning
195 the buffer string to the backend.
197 *** Capture column view into a different file
199 The :id parameter for the dynamic block capturing column view
200 can now truly be an ID that will also be found in a
201 different file. Also, it can be like =file:path/to/file=, to
202 capture the global column view from a different file.
204 Thanks to Francois Lagarde for his report that IDs outside
205 the current file would not work.
211 Cleanup of many small bugs, and one new feature.
215 *** References to last table row with special names
217 Fields in the last row of a table can now be referenced with
218 $LR1, $LR2, etc. These references can appear both on the
219 left hand side and right hand side of a formula.
223 This version reverses the introduction of @0 as a reference to
224 the last rwo in a table, because of a conflict with the use of
225 @0 for the current row.
230 - All known LaTeX export issues fixed
231 - Captions and attributes for figures and tables.
232 - Better implementation for entry IDs
233 - Spreadsheet references to the last table line.
234 - Old syntax for link attributes abandoned
236 ** Incompatible changes
237 *** Old syntax for link attributes abandoned
239 There used to be a syntax for setting link attributes for
240 HTML export by enclosing the attributes into double braces
241 and adding them to the link itself, like
244 [[./img/a.jpg{{alt="an image"}}] ]
247 This syntax is not longer supported, use instead
250 ,#+ATTR_HTML: alt="an image"
256 *** All known LaTeX export issues fixed
258 All the remaining issues with the LaTeX exporter have hopefully
259 been addressed in this release. In particular, this covers
260 quoting of special characters in tables and problems with
261 exporting files where the headline is in the first line, or with
264 *** Captions and attributes for figures and tables.
266 Tables, and Hyperlinks that represent inlined images, can now be
267 equipped with additional information that will be used during
268 export. The information will be taken from the following special
269 lines in the buffer and apply to the first following table or
272 - #+CAPTION: :: The caption of the image or table. This string
273 should be processed according to the export backend, but
274 this is not yet done.
276 - #+LABEL: :: A label to identify the figure/table for cross
277 references. For HTML export, this string will become the
278 ID for the ~<div class="figure">~ element that encapsulates
279 the image tag and the caption. For LaTeX export, this
280 string will be used as the argument of a ~\label{...}~
281 macro. These labels will be available for internal links
282 like ~[[label][Table] ]~.
284 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
285 added as attributes into the ~<img...>~ tag. This string
286 will not be processed, so it should have immediately the
289 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
291 For /images/, this string is directly inserted into
292 the optional argument of the ~\includegraphics[...]{file}~
293 command, to specify scaling, clipping and other options.
294 This string will not be processed, so it should have
295 immediately the right format, like =width=5cm,angle=90=.\\
296 For /tables/, this can currently contain the keyword
297 =longtable=, to request typesetting of the table using the
298 longtable package, which automatically distributes the table
299 over several pages if needed. Also, the attributes line may
300 contain an alignment string for the tabular environment, like
301 =longtable,align=l|lrl=
303 For LaTeX export, if either a caption or a label is given, the element
304 will be exported as a float, i.e. wrapped into a figure or table
307 *** Better implementation for entry IDs
309 Unique identifiers for entries can now be used more efficiently.
310 Internally, a hash array has replaced the alist used so far to
311 keep track of the files in which an ID is defined. This makes it
312 quite fast to find an entry by ID.
314 There is a new link type which looks like this:
317 id:GLOBALLY-UNIQUE-IDENTIFIER
320 This link points to a specific entry. When you move the entry to
321 a different file, for example if you move it to an archive
322 file, the link will continue to work.
324 The file /org-id.el/ contains an API that can be used to write
325 code using these identifiers, including creating IDs and finding
326 them wherever they are.
328 Org has its own method to create unique identifiers, but if the system
329 has /uuidgen/ command installed (Mac's and Linux systems generally
330 do), it will be used by default (a change compared to the earlier
331 implmentation, where you explicitdly had to opt for uuidgen). You can
332 also select the method by hand, using the variable =org-id-method=.
334 If the ID system ever gets confused about where a certain ID is, it
335 initiates a global scan of all agenda files with associated archives,
336 all files previously known containing any IDs, and all currently
337 visited Org-mode files to rebuild the hash. You can also initiate
338 this by hand: =M-x org-id-update-id-locations=. Running this command
339 will also dump into the =*Messages*= buffer information about any
340 duplicate IDs. These should not exist, and Org will never /make/ the
341 same ID twice, but if you /copy/ an entry with its properties,
342 duplicate IDs will inevitably be produced. Unfortunately, this is
343 unavoidable in a plain text system that allows you to edit the text in
344 arbitrary ways, and a portion of care on your side is needed to keep
347 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
348 This is also a change from previous versions where the file was
349 =~/.org=id-locations=. Therefore, you can remove this old file
350 if you have it. I am not sure what will happen if the =.emacs.d=
351 directory does not exists in your setup, but in modern Emacsen, I
352 believe it should exist. If you do not want to use IDs across
353 files, you can avoid the overhead with tracking IDs by
354 customizing the variable =org-id-track-globally=. IDs can then
355 still be used for links inside a single file.
357 IDs will also be used when you create a new link to an Org-mode
358 buffer. If you use =org-store-link= (normally at =C-c l=) inside
359 en entry in an Org-mode buffer, and ID property will be created
360 if it does not exist, and the stored link will be an =id:= link.
361 If you prefer the much less secure linking to headline text, you
362 can configure the variable =org-link-to-org-use-id=. The default
363 setting for this variable is =create-if-interactive=, meaning
364 that an ID will be created when you store a link interactively,
365 but not if you happen to be in an Org-mode file while you create
366 a remember note (which usually has a link to the place where you
367 were when starting remember).
369 *** Spreadsheet references to the last table line.
371 You may now use =@0= to reference the last dataline in a table
372 in a stable way. This is useful in particular for automatically
373 generated tables like the ones using /org-collector.el/ by Eric
379 - New relative timer to support timed notes
380 - Special faces can be set for individual tags
381 - The agenda shows now all tags, including inherited ones.
382 - Exclude some tags from inheritance.
383 - More special values for time comparisons in property searches
384 - Control for exporting meta data
385 - Cut and Paste with hot links from w3m to Org
386 - LOCATION can be inherited for iCalendar export
387 - Relative row references crossing hlines now throw an error
389 ** Incompatible Changes
391 *** Relative row references crossing hlines now throw an error
393 Relative row references in tables look like this: "@-4" which
394 means the forth row above this one. These row references are
395 not allowed to cross horizontal separator lines (hlines). So
396 far, when a row reference violates this policy, Org would
397 silently choose the field just next to the hline.
399 Tassilo Horn pointed out that this kind of hidden magic is
400 actually confusing and may cause incorrect formulas, and I do
401 agree. Therefore, trying to cross a hline with a relative
402 reference will now throw an error.
404 If you need the old behavior, customize the variable
405 `org-table-error-on-row-ref-crossing-hline'.
409 *** New relative timer to support timed notes
411 Org now supports taking timed notes, useful for example while
412 watching a video, or during a meeting which is also recorded.
415 Insert a relative time into the buffer. The first time
416 you use this, the timer will be started. When called
417 with a prefix argument, the timer is reset to 0.
420 Insert a description list item with the current relative
421 time. With a prefix argument, first reset the timer to 0.
424 Once the time list has been initiated, you can also use the
425 normal item-creating command to insert the next timer item.
428 Reset the timer without inserting anything into the buffer.
429 By default, the timer is reset to 0. When called with a
430 =C-u= prefix, reset the timer to specific starting
431 offset. The user is prompted for the offset, with a
432 default taken from a timer string at point, if any, So this
433 can be used to restart taking notes after a break in the
434 process. When called with a double prefix argument
435 =C-c C-u=, change all timer strings in the active
436 region by a certain amount. This can be used to fix timer
437 strings if the timer was not started at exactly the right
440 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
441 contributions to this idea.
443 *** Special faces can be set for individual tags
445 You may now use the variable =org-tag-faces= to define the
446 face used for specific tags, much in the same way as you can
447 do for TODO keywords.
449 Thanks to Samuel Wales for this proposal.
451 *** The agenda shows now all tags, including inherited ones.
453 This request has come up often, most recently it was
454 formulated by Tassilo Horn.
456 If you prefer the old behavior of only showing the local
457 tags, customize the variable =org-agenda-show-inherited-tags=.
459 *** Exclude some tags from inheritance.
461 So far, the only way to select tags for inheritance was to
462 allow it for all tags, or to do a positive selection using
463 one of the more complex settings for
464 `org-use-tag-inheritance'. It may actually be better to
465 allow inheritance for all but a few tags, which was difficult
466 to achieve with this methodology.
468 A new option, `org-tags-exclude-from-inheritance', allows to
469 specify an exclusion list for inherited tags.
471 *** More special values for time comparisons in property searches
473 In addition to =<now>=, =<today>=, =<yesterday>=, and
474 =<tomorrow>=, there are more special values accepted now in
475 time comparisons in property searches: You may use strings
476 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
477 week, month, and year, respectively
479 Thanks to Linday Todd for this proposal.
481 *** Control for exporting meta data
483 All the metadata in a headline, i.e. the TODO keyword, the
484 priority cookie, and the tags, can now be excluded from
485 export with appropriate options:
487 | Variable | Publishing property | OPTIONS switch |
488 |-------------------------------+---------------------+----------------|
489 | org-export-with-todo-keywords | :todo-keywords | todo: |
490 | org-export-with-tags | :tags | tags: |
491 | org-export-with-priority | :priority | pri: |
493 *** Cut and Paste with hot links from w3m to Org
495 You can now use the key =C-c C-x M-w= in a w3m buffer with
496 HTML content to copy either the region or the entire file in
497 a special way. When you yank this text back into an Org-mode
498 buffer, all links from the w3m buffer will continue to work
501 For this to work you need to load the new file /org-w3m.el./
502 Please check your org-modules variable to make sure that this
505 Thanks for Richard Riley for the idea and to Andy Stewart for
508 *** LOCATION can be inherited for iCalendar export
510 The LOCATION property can now be inherited during iCalendar
511 export if you configure =org-use-property-inheritance= like
514 #+begin_src emacs-lisp
515 (setq org-use-property-inheritance '("LOCATION"))
522 - Keybindings in Remember buffers can be configured
523 - Support for ido completion
524 - New face for date lines in agenda column view
525 - Invisible targets become now anchors in headlines.
526 - New contributed file /org-exp-blocks.el/
527 - New contributed file /org-eval-light.el/
529 - BBDB links may use regular expressions.
530 - Link abbreviations can use %h to insert a url-encoded target value
531 - Improved XHTML compliance
535 *** Keybindings in Remember buffers can be configured
537 The remember buffers created with Org's extensions are in
538 Org-mode, which is nice to prepare snippets that will
539 actually be stored in Org-mode files. However, this makes it
540 hard to configure key bindings without modifying the Org-mode
541 keymap. There is now a minor mode active in these buffers,
542 `org-remember-mode', and its keymap org-remember-mode-map can
543 be used for key bindings. By default, this map only contains
544 the bindings for =C-c C-c= to store the note, and =C-c C-k=
545 to abort it. Use `org-remember-mode-hook' to define your own
548 #+begin_src emacs-lisp
550 'org-remember-mode-hook
552 (define-key org-remember-mode-map
553 "\C-x\C-s" 'org-remember-finalize)))
556 If you wish, you can also use this to free the =C-c C-c=
557 binding (by binding this key to nil in the minor mode map),
558 so that you can use =C-c C-c= again to set tags.
560 This modification is based on a request by Tim O'Callaghan.
562 *** Support for ido completion
564 You can now get the completion interface from /ido.el/ for
565 many of Org's internal completion commands by turning on the
566 variable =org-completion-use-ido=. =ido-mode= must also be
567 active before you can use this.
569 This change is based upon a request by Samuel Wales.
571 *** New face for date lines in agenda column view
573 When column view is active in the agenda, and when you have
574 summarizing properties, the date lines become normal column
575 lines and the separation between different days becomes
576 harder to see. If this bothers you, you can now customize
577 the face =org-agenda-column-dateline=.
579 This is based on a request by George Pearson.
581 *** Invisible targets become now anchors in headlines.
583 These anchors can be used to jump to a directly with an HTML
584 link, just like the =sec-xxx= IDs. For example, the
585 following will make a http link
586 =//domain/path-to-my-file.html#dummy= work:
593 This is based on a request by Matt Lundin.
595 *** New contributed file /org-exp-blocks.el/
597 This new file implements special export behavior of
598 user-defined blocks. The currently supported blocks are
600 - comment :: Comment blocks with author-specific markup
601 - ditaa :: conversion of ASCII art into pretty png files
602 using Stathis Sideris' /ditaa.jar/ program
603 - dot :: creation of graphs in the /dot/ language
604 - R :: Sweave type exporting using the R program
606 For more details and examples, see the file commentary in
609 Kudos to Eric Schulte for this new functionality, after
610 /org-plot.el/ already his second major contribution. Thanks
611 to Stathis for this excellent program, and for allowing us to
612 bundle it with Org-mode.
614 *** New contributed file /org-eval-light.el/
616 This module gives control over execution Emacs Lisp code
617 blocks included in a file.
619 Thanks to Eric Schulte also for this file.
623 You can now configure Org to understand many links created
624 with the Emacs Planner package, so you can cut text from
625 planner pages and paste them into Org-mode files without
626 having to re-write the links. Among other things, this means
627 that the command =org-open-at-point-global= which follows
628 links not only in Org-mode, but in arbitrary files like
629 source code files etc, will work also with links created by
630 planner. The following customization is needed to make all of
633 #+begin_src emacs-lisp
634 (setq org-link-translation-function
635 'org-translate-link-from-planner)
638 I guess an inverse translator could be written and integrated
641 *** BBDB links may use regular expressions.
643 This did work all along, but only now I have documented it.
645 *** =yank-pop= works again after yanking an outline tree
647 Samuel Wales had noticed that =org-yank= did mess up this
648 functionality. Now you can use =yank-pop= again, the only
649 restriction is that the so-yanked text will not be
650 pro/demoted or folded.
652 *** Link abbreviations can use %h to insert a url-encoded target value
654 Thanks to Steve Purcell for a patch to this effect.
656 *** Improved XHTML compliance
658 Thanks to Sebastian Rose for pushing this.
660 *** Many bug fixes again.
665 - A region of entries can now be refiled with a single command
666 - Fine-tuning the behavior of `org-yank'
667 - Formulas for clocktables
668 - Better implementation of footnotes for HTML export
669 - More languages for HTML export.
673 *** A region of entries can now be refiled with a single command
675 With =transient-make-mode= active (=zmacs-regions= under
676 XEmacs), you can now select a region of entries and refile
677 them all with a single =C-c C-w= command.
679 Thanks to Samuel Wales for this useful proposal.
681 *** Fine-tuning the behavior of =org-yank=
683 The behavior of Org's yanking command has been further
684 fine-tuned in order to avoid some of the small annoyances
687 - Calling =org-yank= with a prefix arg will stop any special
688 treatment and directly pass through to the normal =yank=
689 command. Therefore, you can now force a normal yank with
692 - Subtrees will only be folded after a yank if doing so will
693 now swallow any non-white characters after the yanked text.
694 This is, I think a really important change to make the
695 command work more sanely.
697 *** Formulas for clocktables
699 You can now add formulas to a clock table, either by hand, or
700 with a =:formula= parameter. These formulas can be used to
701 create additional columns with further analysis of the
704 Thanks to Jurgen Defurne for triggering this addition.
706 *** Better implementation of footnotes for HTML export
708 The footnote export in 6.11 really was not good enough. Now
709 it works fine. If you have customized
710 =footnote-section-tag=, make sure that your customization is
711 matched by =footnote-section-tag-regexp=.
713 Thanks to Sebastian Rose for pushing this change.
715 *** More languages for HTML export.
717 More languages are supported during HTML export. This is
718 only relevant for the few special words Org inserts, like
719 "Table of Contents", or "Footnotes". Also the encoding
720 issues with this feature seem to be solved now.
722 Thanks to Sebastian Rose for pushing me to fix the encoding
729 - Yanking subtree with =C-y= now adjusts the tree level
730 - State changes can now be shown in the log mode in the agenda
731 - Footnote in HTML export are now collected at the end of the document
732 - HTML export now validates again as XHTML
733 - The clock can now be resumed after exiting and re-starting Emacs
734 - Clock-related data can be saved and resumed across Emacs sessions
735 - Following file links can now use C-u C-u to force use of an external app
736 - Inserting absolute files names now abbreviates links with "~"
737 - Links to attachment files
738 - Completed repeated tasks listed briefly in agenda
739 - Remove buffers created during publishing are removed
743 *** Yanking subtree with =C-y= now adjusts the tree level
744 When yanking a cut/copied subtree or a series of trees, the
745 normal yank key =C-y= now adjusts the level of the tree to
746 make it fit into the current outline position, without losing
747 its identity, and without swallowing other subtrees.
749 This uses the command =org-past-subtree=. An additional
750 change in that command has been implemented: Normally, this
751 command picks the right outline level from the surrounding
752 *visible* headlines, and uses the smaller one. So if the
753 cursor is between a level 4 and a level 3 headline, the tree
754 will be pasted as level 3. If the cursor is actually *at*
755 the beginning of a headline, the level of that headline will
756 be used. For example, lets say you have a tree like this:
762 ,(2)* Level one again
765 with (1) and (2) indicating possible cursor positions for the
766 insertion. When at (1), the tree will be pasted as level 2.
767 When at (2), it will be pasted as level 1.
769 If you do not want =C-y= to behave like this, configure the
770 variable =org-yank-adjusted-subtrees=.
772 Thanks to Samuel Wales for this idea and a partial implementation.
774 *** State changes can now be shown in the log mode in the agenda
776 If you configure the variable =org-agenda-log-mode-items=,
777 you can now request that all logged state changes be included
778 in the agenda when log mode is active. If you find this too
779 much for normal applications, you can also temporarily
780 request the inclusion of state changes by pressing =C-u l= in
783 This was a request by Hsiu-Khuern Tang.
785 You can also press `C-u C-u l' to get *only* log items in the
786 agenda, withour any timestamps/deadlines etc.
788 *** Footnote in HTML export are now collected at the end of the document
789 Previously, footnotes would be left in the document where
790 they are defined, now they are all collected and put into a
791 special =<div>= at the end of the document.
793 Thanks to Sebastian Rose for this request.
795 *** HTML export now validates again as XHTML.
797 Thanks to Sebastian Rose for pushing this cleanup.
799 *** The clock can now be resumed after exiting and re-starting Emacs
801 If the option =org-clock-in-resume= is t, and the first clock
802 line in an entry is unclosed, clocking into that task resumes
803 the clock from that time.
805 Thanks to James TD Smith for a patch to this effect.
807 *** Clock-related data can be saved and resumed across Emacs sessions
809 The data saved include the contents of =org-clock-history=,
810 and the running clock, if there is one.
812 To use this, you will need to add to your .emacs
814 #+begin_src emacs-lisp
815 (setq org-clock-persist t)
816 (setq org-clock-in-resume t)
817 (org-clock-persistence-insinuate)
820 Thanks to James TD Smith for a patch to this effect.
822 *** Following file links can now use C-u C-u to force use of an external app.
824 So far you could only bypass your setup in `org-file-apps'
825 and force opening a file link in Emacs by using a =C-u= prefix arg
826 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
827 an external application. Which external application depends
828 on your system. On Mac OS X and Windows, =open= is used. On
829 a GNU/Linux system, the mailcap settings are used.
831 This was a proposal by Samuel Wales.
833 *** Inserting absolute files names now abbreviates links with "~".
835 Inserting file links with =C-u C-c C-l= was buggy if the
836 setting of `org-link-file-path-type' was `adaptive' (the
837 default). Absolute file paths were not abbreviated relative
838 to the users home directory. This bug has been fixed.
840 Thanks to Matt Lundin for the report.
842 *** Links to attachment files
844 Even though one of the purposes of entry attachments was to
845 reduce the number of links in an entry, one might still want
846 to have the occasional link to one of those files. You can
847 now use link abbreviations to set up a special link type that
848 points to attachments in the current entry. Note that such
849 links will only work from within the same entry that has the
850 attachment, because the directory path is entry specific.
851 Here is the setup you need:
853 #+begin_src emacs-lisp
854 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
857 After this, a link like this will work
860 [[att:some-attached-file.txt]]
862 This was a proposal by Lindsay Todd.
864 *** Completed repeated tasks listed briefly in agenda
866 When a repeating task, listed in the daily/weekly agenda under
867 today's date, is completed from the agenda, it is listed as
868 DONE in the agenda until the next update happens. After the
869 next update, the task will have disappeared, of course,
870 because the new date is no longer today.
872 *** Remove buffers created during publishing are removed
874 Buffers that are created during publishing are now deleted
875 when the publishing is over. At least I hope it works like this.
881 - Secondary agenda filtering is becoming a killer feature
882 - Setting tags has now its own binding, =C-c C-q=
883 - Todo state changes can trigger tag changes
884 - C-RET will now always insert a new headline, never an item.
885 - Customize org-mouse.el feature set to free up mouse events
886 - New commands for export all the way to PDF (through LaTeX)
887 - Some bug fixed for LaTeX export, more bugs remain.
891 *** Enhancements to secondary agenda filtering
893 This is, I believe, becoming a killer feature. It allows you
894 to define fewer and more general custom agenda commands, and
895 then to do the final narrowing to specific tasks you are
896 looking for very quickly, much faster than calling a new
899 If you have not tries this yet, you should!
901 **** You can now refining the current filter by an additional criterion
902 When filtering an existing agenda view with =/=, you can
903 now narrow down the existing selection by an additional
904 condition. Do do this, use =\= instead of =/= to add the
905 additional criterion. You can also press =+= or =-= after
906 =/= to add a positive or negative condition. A condition
907 can be a TAG, or an effort estimate limit, see below.
909 **** It is now possible to filter for effort estimates
910 This means to filter the agenda for the value of the Effort
911 property. For this you should best set up global allowed
912 values for effort estimates, with
914 #+begin_src emacs-lisp
915 (setq org-global-properties
916 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
919 You may then select effort limits with single keys in the
920 filter. It works like this: After =/= or =\=, first select
921 the operator which you want to use to compare effort
924 : < Select entries with effort smaller than or equal to the limit
925 : > Select entries with effort larger than or equal to the limit
926 : = Select entries with effort equal to the limit
928 After that, you can press a single digit number which is
929 used as an index to the allowed effort estimates.
931 If you do not use digits to fast-select tags, you can even
932 skip the operator, which will then default to
933 `org-agenda-filter-effort-default-operator', which is by
936 Thanks to Manish for the great idea to include fast effort
937 filtering into the agenda filtering process.
939 **** The mode line will show the active filter
940 For example, if there is a filter in place that does select
941 for HOME tags, against EMAIL tags, and for tasks with an
942 estimated effort smaller than 30 minutes, the mode-line with
943 show =+HOME-EMAIL+<0:30=
945 **** The filter now persists when the agenda view is refreshed
946 All normal refresh commands, including those that move the
947 weekly agenda from one week to the next, now keep the
948 current filter in place.
950 You need to press =/ /= to turn off the filter. However,
951 when you run a new agenda command, for example going from
952 the weekly agenda to the TODO list, the filter will be
955 *** Setting tags has now its own binding, =C-c C-q=
957 You can still use =C-c C-c= on a headline, but the new
958 binding should be considered as the main binding for this
959 command. The reasons for this change are:
961 - Using =C-c C-c= for tags is really out of line with other
964 - I hate it in Remember buffers when I try to set tags and I
965 cannot, because =C-c C-c= exits the buffer :-(
967 - =C-c C-q= will also work when the cursor is somewhere down
968 in the entry, it does not have to be on the headline.
970 *** Todo state changes can trigger tag changes
972 The new option =org-todo-state-tags-triggers= can be used to
973 define automatic changes to tags when a TODO state changes.
974 For example, the setting
976 : (setq org-todo-state-tags-triggers
977 : '((done ("Today" . nil) ("NEXT" . nil))
978 : ("WAITING" ("Today" . t))))
980 will make sure that any change to any of the DONE states will
981 remove tags "Today" and "NEXT", while switching to the
982 "WAITING" state will trigger the tag "Today" to be added.
984 I use this mostly to get rid of TODAY and NEXT tags which I
985 apply to select an entry for execution in the near future,
986 which I often prefer to specific time scheduling.
988 *** C-RET will now always insert a new headline, never an item.
989 The new headline is inserted after the current subtree.
991 Thanks to Peter Jones for patches to fine-tune this behavior.
993 *** Customize org-mouse.el feature set
994 There is a new variable =org-mouse-features= which gives you
995 some control about what features of org-mouse you want to
996 use. Turning off some of the feature will free up the
997 corresponding mouse events, or will avoid activating special
998 regions for mouse clicks. By default I have urned off the
999 feature to use drag mouse events to move or promote/demote
1000 entries. You can of course turn them back on if you wish.
1002 This variable may still change in the future, allowing more
1003 fine-grained control.
1005 *** New commands for export to PDF
1007 This is using LaTeX export, and then processes it to PDF
1010 : C-c C-e p process to PDF.
1011 : C-c C-e d process to PDF, and open the file.
1014 - \usepackage{graphicx} is now part of the standard class
1016 - Several bugs fixed, but definitely not all of them :-(
1018 *** New option `org-log-state-notes-insert-after-drawers'
1020 Set this to =t= if you want state change notes to be inserted
1021 after any initial drawers, i.e drawers the immediately follow
1022 the headline and the planning line (the one with
1023 DEADLINE/SCHEDULED/CLOSED information).
1027 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1031 *** =org-file-apps= now uses regular repressions instead of extensions
1032 Just like in =auto-mode-alist=, car's in the variable
1033 =org-file-apps= that are strings are now interpreted as
1034 regular expressions that are matched against a file name. So
1035 instead of "txt", you should now write "\\.txt\\'" to make
1036 sure the matching is done correctly (even though "txt" will
1037 be recognized and still be interpreted as an extension).
1039 There is now a shortcut to get many file types visited by
1040 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
1041 any files that are matched by `auto-mode-alist' will be
1044 *** Changes to the attachment system
1046 - The default method to attach a file is now to copy it
1047 instead of moving it.
1048 - You can modify the default method using the variable
1049 `org-attach-method'. I believe that most Unix people want
1050 to set it to `ln' to create hard links.
1051 - The keys =c=, =m=, and =l= specifically select =copy=,
1052 =move=, or =link=, respectively, as the attachment method
1053 for a file, overruling `org-attach-method'.
1054 - To create a new attachment as an Emacs buffer, you have not
1055 now use =n= instead of =c=.
1056 - The file list is now always retrieved from the directory
1057 itself, not from the "Attachments" property. We still
1058 keep this property by default, but you can turn it off, by
1059 customizing the variable =org-attach-file-list-property=.
1063 ** Incompatible changes
1065 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
1067 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
1071 *** The default structure of IDs has changed
1073 IDs created by Org have changed a bit:
1074 - By default, there is no prefix on the ID. There used to be
1075 an "Org" prefix, but I now think this is not necessary.
1076 - IDs use only lower-case letters, no upper-case letters
1077 anymore. The reason for this is that IDs are now also used
1078 as directory names for org-attach, and some systems do not
1079 distinguish upper and lower case in the file system.
1080 - The ID string derived from the current time is now
1081 /reversed/ to become an ID. This assures that the first
1082 two letters of the ID change fast, so hat it makes sense to
1083 split them off to create subdirectories to balance load.
1084 - You can now set the `org-id-method' to `uuidgen' on systems
1087 *** =C-c C-a= no longer calls `show-all'
1089 The reason for this is that =C-c C-a= is now used for the
1090 attachment system. On the rare occasions that this command
1091 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
1093 *** New attachment system
1095 You can now attach files to each node in the outline tree.
1096 This works by creating special directories based on the ID of
1097 an entry, and storing files in these directories. Org can
1098 keep track of changes to the attachments by automatically
1099 committing changes to git. See the manual for more
1102 Thanks to John Wiegley who contributed this fantastic new
1103 concept and wrote org-attach.el to implement it.
1105 *** New remember template escapes
1107 : %^{prop}p to insert a property
1108 : %k the heading of the item currently being clocked
1109 : %K a link to the heading of the item currently being clocked
1111 Also, when you exit remember with =C-2 C-c C-c=, the item
1112 will be filed as a child of the item currently being
1113 clocked. So the idea is, if you are working on something and
1114 think of a new task related to this or a new note to be
1115 added, you can use this to quickly add information to that
1118 Thanks to James TD Smith for a patch to this effect.
1120 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
1122 Thanks to James TD Smith for a patch to this effect.
1124 *** New file in contrib: lisp/org-checklist.el
1126 This module deals with repeated tasks that have checkbox
1129 Thanks to James TD Smith for this contribution.
1131 *** New in-buffer setting #+STYLE
1133 It can be used to locally set the variable
1134 `org-export-html-style-extra'. Several such lines are
1135 allowed-, they will all be concatenated. For an example on
1136 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1142 - Filtering existing agenda views with respect to a tag
1143 - Editing fixed-width regions with picture or artist mode
1144 - /org-plot.el/ is now part of Org
1145 - Tags can be used to select the export part of a document
1146 - Prefix interpretation when storing remember notes
1147 - Yanking inserts folded subtrees
1148 - Column view capture tables can have formulas, plotting info
1149 - In column view, date stamps can be changed with S-cursor keys
1150 - The note buffer for clocking out now mentions the task
1151 - Sorting entries alphabetically ignores TODO keyword and priority
1152 - Agenda views can sort entries by TODO state
1153 - New face =org-scheduled= for entries scheduled in the future.
1154 - Remember templates for gnus links can use the :to escape.
1155 - The file specification in a remember template may be a function
1156 - Categories in iCalendar export include local tags
1157 - It is possible to define filters for column view
1158 - Disabling integer increment during table Field copy
1159 - Capturing column view is on `C-c C-x i'
1160 - And tons of bugs fixed.
1163 ** Incompatible changes
1165 *** Prefix interpretation when storing remember notes has changed
1167 The prefix argument to the `C-c C-c' command that finishes a
1168 remember process is now interpreted differently:
1170 : C-c C-c Store the note to predefined file and headline
1171 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1172 : in its new location.
1173 : C-1 C-c C-c Select the storage location interactively
1174 : C-0 C-c C-c Re-use the last used location
1176 This was requested by John Wiegley.
1178 *** Capturing column view is now on `C-c C-x i'
1180 The reason for this change was that `C-c C-x r' is also used
1181 as a tty key replacement.
1183 *** Categories in iCalendar export now include local tags
1185 The locally defined tags are now listed as categories when
1186 exporting to iCalendar format. Org's traditional file/tree
1187 category is now the last category in this list. Configure
1188 the variable =org-icalendar-categories= to modify or revert
1191 This was a request by Charles Philip Chan.
1195 *** Secondary filtering of agenda views.
1197 You can now easily and interactively filter an existing
1198 agenda view with respect to a tag. This command is executed
1199 with the =/= key in the agenda. You will be prompted for a
1200 tag selection key, and all entries that do not contain or
1201 inherit the corresponding tag will be hidden. With a prefix
1202 argument, the opposite filter is applied: entries that
1203 do have the tag will be hidden.
1205 This operation only /hides/ lines in the agenda buffer, it
1206 does not remove them. Changing the secondary filtering does
1207 not require a new search and is very fast.
1209 If you press TAB at the tag selection prompt, you will be
1210 switched to a completion interface to select a tag. This is
1211 useful when you want to select a tag that does not have a
1212 direct access character.
1214 A double =/ /= will restore the original agenda view by
1215 unhiding any hidden lines.
1217 This functionality was John Wiegley's idea. It is a simpler
1218 implementation of some of the query-editing features proposed
1219 and implemented some time ago by Christopher League (see the
1220 file contrib/lisp/org-interactive-query.el).
1222 *** Editing fixed-width regions with picture or artist mode
1224 The command @<code>C-c '@</code> (that is =C-c= followed by a
1225 single quote) can now also be used to switch to a special
1226 editing mode for fixed-width sections. The default mode is
1227 =artist-mode= which allows you to create ASCII drawings.
1229 It works like this: Enter the editing mode with
1230 @<code>C-c '@</code>. An indirect buffer will be created and
1231 narrowed to the fixed-width region. Edit the drawing, and
1232 press @<code>C-c '@</code> again to exit.
1234 Lines in a fixed-width region should be preceded by a colon
1235 followed by at least one space. These will be removed during
1236 editing, and then added back when you exit the editing mode.
1238 Using the command in an empty line will create a new
1241 This new feature arose from a discussion involving Scott
1242 Otterson, Sebastian Rose and Will Henney.
1244 *** /org-plot.el/ is now part of Org.
1246 You can run it by simple calling org-plot/gnuplot.
1247 Documentation is not yet included with Org, please refer to
1248 http://github.com/eschulte/org-plot/tree/master until we have
1249 moved the docs into Org or Worg.
1251 Thanks to Eric Schulte for this great contribution.
1253 *** Tags can be used to select the export part of a document
1255 You may now use tags to select parts of a document for
1256 inclusion into the export, and to exclude other parts. This
1257 behavior is governed by two new variables:
1258 =org-export-select-tags= and =org-export-exclude-tags=.
1259 These default to =("export")= and =("noexport")=, but can be
1260 changed, even to include a list of several tags.
1262 Org first checks if any of the /select/ tags is present in
1263 the buffer. If yes, all trees that do not carry one of these
1264 tags will be excluded. If a selected tree is a subtree, the
1265 heading hierarchy above it will also be selected for export,
1266 but not the text below those headings. If none of the select
1267 tags is found anywhere in the buffer, the whole buffer will
1268 be selected for export. Finally, all subtrees that are
1269 marked by any of the /exclude/ tags will be removed from the
1272 You may set these tags with in-buffer options
1273 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1275 I love this feature. Thanks to Richard G Riley for coming
1278 *** Prefix interpretation when storing remember notes
1280 The prefix argument to the `C-c C-c' command that finishes a
1281 remember process is now interpreted differently:
1283 : C-c C-c Store the note to predefined file and headline
1284 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1285 : in its new location.
1286 : C-1 C-c C-c Select the storage location interactively
1287 : C-0 C-c C-c Re-use the last used location
1289 This was requested by John Wiegley.
1291 *** Yanking inserts folded subtrees
1293 If the kill is a subtree or a sequence of subtrees, yanking
1294 them with =C-y= will leave all the subtrees in a folded
1295 state. This basically means, that kill and yank are now
1296 much more useful in moving stuff around in your outline. If
1297 you do not like this, customize the variable
1298 =org-yank-folded-subtrees=.
1300 Right now, I am only binding =C-y= to this new function,
1301 should I modify all bindings of yank? Do we need to amend
1304 This feature was requested by John Wiegley.
1306 *** Column view capture tables can have formulas, plotting info
1308 If you attach formulas and plotting instructions to a table
1309 capturing column view, these extra lines will now survive an
1310 update of the column view capture, and any formulas will be
1311 re-applied to the captured table. This works by keeping any
1312 continuous block of comments before and after the actual
1315 *** In column view, date stamps can be changed with S-cursor keys
1317 If a property value is a time stamp, S-left and S-right can
1318 now be used to shift this date around while in column view.
1320 This was a request by Chris Randle.
1322 *** The note buffer for clocking out now mentions the task
1324 This was a request by Peter Frings.
1326 *** Sorting entries alphabetically ignores TODO keyword and priority
1328 Numerical and alphanumerical sorting now skips any TODO
1329 keyword or priority cookie when constructing the comparison
1330 string. This was a request by Wanrong Lin.
1332 *** Agenda views can sort entries by TODO state
1334 You can now define a sorting strategy for agenda entries that
1335 does look at the TODO state of the entries. Sorting by TODO
1336 entry does first separate the non-done from the done states.
1337 Within each class, the entries are sorted not alphabetically,
1338 but in definition order. So if you have a sequence of TODO
1339 entries defined, the entries will be sorted according to the
1340 position of the keyword in this sequence.
1342 This follows an idea and sample implementation by Christian
1345 *** New face =org-scheduled= for entries scheduled in the future.
1347 This was a request by Richard G Riley.
1349 *** Remember templates for gnus links can now use the :to escape.
1351 Thanks to Tommy Lindgren for a patch to this effect.
1352 *** The file specification in a remember template may now be a function
1354 Thanks to Gregory Sullivan for a patch to this effect.
1356 *** Categories in iCalendar export now include local tags
1358 The locally defined tags are now listed as categories when
1359 exporting to iCalendar format. Org's traditional file/tree
1360 category is now the last category in this list. Configure
1361 the variable =org-icalendar-categories= to modify or revert
1364 This was a request by Charles Philip Chan.
1366 *** It is now possible to define filters for column view
1368 The filter can modify the value that will be displayed in a
1369 column, for example it can cut out a part of a time stamp.
1370 For more information, look at the variable
1371 =org-columns-modify-value-for-display-function=.
1373 *** Disabling integer increment during table field copy
1375 Prefix arg 0 to S-RET does the trick.
1377 This was a request by Chris Randle.
1382 For older Changes, see [[file:Changes_old.org]]