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.17 (in preparation)
17 *** Built-in footnote support
19 Org-mode now supports the creation of footnotes. In contrast to the
20 `footnote.el' package, Org-mode's footnotes are designed for work on a
21 larger document, not only for one-off documents like emails. The basic
22 syntax is similar to the one used by `footnote.el', i.e. a footnote is
23 defined in a paragraph that is started by a footnote marker in square
24 brackets in column 0, no indentation allowed. The footnote
25 reference is simply the marker in square brackets inside text.
29 The Org homepage[fn:1] now looks a lot better than it used to.
31 [fn:1] The link is: http://orgmode.org
34 Org-mode extends the number-based syntax to /named/ footnotes and
35 optional inline definition. Using numbers as markers is
36 supported for backward compatibility, but not encouraged because
37 of possible conflicts with LaTeX syntax. Here are the valid
40 - [1] :: A plain numeric footnote marker.
42 - [fn:name] :: A named footnote reference, where `name' is a
43 unique label word or, for simplicity of automatic creation,
46 - [fn:: This is the inline definition of this footnote] :: A
47 LaTeX-like anonymous footnote where the definition is given
48 directly at the reference point.
50 - [fn:name: a definition] :: An inline definition of a footnote,
51 which also specifies a name for the note. Since Org allows
52 multiple references to the same note, you can then use use
53 `[fn:name]' to create additional references.
55 Footnote labels can be created automatically, or you create names
56 yourself. This is handled by the variable
57 =org-footnote-auto-label= and its corresponding =#+STARTUP=
58 keywords, see the docstring of that variable for details.
60 The following command handles footnotes:
62 - C-c C-x f :: The footnote action command. When the cursor is
63 on a footnote reference, jump to the definition. When it is
64 at a definition, jump to the (first) reference. Otherwise,
65 create a new footnote. Depending on the variable
66 `org-footnote-define-inline' (with associated =#+STARTUP=
67 options =fninline= and =nofninline=), the definitions will
68 be placed locally, or into the nearest outline section with
69 the heading `Footnotes'. If no such section is found after
70 the reference point, one will be created at the end of the
71 file. When this command is called with a prefix argument, a
72 menu of additional options is offered:
73 - s :: Sort the footnote definitions by reference sequence.
74 During editing, Org makes no effort to sort
75 footnote definitions into a particular sequence.
76 If you want them sorted, use this command.
77 - n :: Normalize the footnotes by collecting all
78 definitions (including inline definitions) into a
79 special section, and then numbering them in
80 sequence. The references will then also be
81 numbers. This is meant to be the final step before
82 finishing a document (e.g. sending off an email).
83 The exporters do this automatically, and so could
84 something like `message-send-hook'.
85 - d :: Delete the footnote at point, and all references to it.
87 - C-c C-c :: If the cursor is on a footnote reference, jump to
88 the definition. If it is a the definition, jump back to the
89 reference. When called with a prefix argument at either
90 location, offer the same menu as `C-u C-c C-x f'.
92 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
93 corresponding definition/reference, and you can use the
94 usual commands to follow these links.
96 Org-mode's footnote support is designed so that it should also
97 work in buffers that are not in Org-mode, for example in email
98 messages. Just bind =org-footnote-action= to a global key like
101 The main trigger for this development came from a hook function
102 written by Paul Rivier, to implement named footnotes and to
103 convert them to numbered ones before export. Thanks, Paul!
105 *** Line numbers and references in literal examples
107 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
108 do now allow optional line numbering in the example.
109 Furthermore, links to specific code lines are supported, greatly
110 increasing Org-mode's utility for writing tutorials and other
113 Code references use special labels embedded directly into the
114 source code. Such labels look like "((name))" and must be unique
115 within a document. Org-mode links with the coderef cookie in the
116 link part will be correctly interpreted, both while working with
117 an Org file (internal links), and while exporting to the
118 different backends. Line numbering and code references are
119 supported for all three major backends, HTML, LaTeX, and ASCII.
120 In the HTML backend, hovering the mouse over a link to a source
121 line will remote-highlight the referenced code line.
123 The options for the BEGIN lines are:
125 - -n :: Number the lines in the example
126 - +n :: Like -n, but continue numbering from where the previous
128 - -r :: Remove the coderef cookies from the example, and replace
129 links to this reference with line numbers. This option
130 takes only effect if either -n or +n are given as well.
131 If -r is not given, coderefs simply use the label name.
136 #+begin_src emacs-lisp -n -r
137 (defmacro org-unmodified (&rest body) ((def))
138 "Execute body without changing `buffer-modified-p'."
139 `(set-buffer-modified-p ((back))
140 (prog1 (buffer-modified-p) ,@body)))
142 [[((def))][Line ((def))]] contains the macro name. Later at line [[((back))]],
146 When exported, this is translated to:
147 #+begin_src emacs-lisp -n -r
148 (defmacro org-unmodified (&rest body) ((def))
149 "Execute body without changing `buffer-modified-p'."
150 `(set-buffer-modified-p ((back))
151 (prog1 (buffer-modified-p) ,@body)))
153 [[((def))][Line ((def))]] contains the macro name. Later at line [[((back))]],
156 Thanks to Ilya Shlyakhter for proposing this feature set. Thanks
157 to Sebastian Rose for the key Javascript element that made the
158 remote highlighting possible.
160 *** New hooks for export preprocessing
161 The export preprocessor now runs more hooks, to allow
162 better-timed tweaking by user functions:
164 - =org-export-preprocess-hook= ::
165 Pretty much the first thing in the preprocessor. But org-mode
166 is already active in the preprocessing buffer.
168 - =org-export-preprocess-after-include-files-hook= ::
169 This is run after the contents of included files have been inserted.
171 - =org-export-preprocess-after-tree-selection-hook= ::
172 This is run after selection of trees to be exported has
173 happened. This selection includes tags-based selection, as
174 well as removal of commented and archived trees.
176 - =org-export-preprocess-before-backend-specifics-hook= ::
177 Hook run before backend-specific functions are called during preprocessing.
179 - =org-export-preprocess-final-hook= ::
180 Hook for preprocessing an export buffer. This is run as the
181 last thing in the preprocessing buffer, just before returning
182 the buffer string to the backend.
184 *** Capture column view into a different file.
186 The :id parameter for the dynamic block capturing column view
187 can now truly be an ID that will also be found in a
188 different file. Also, it can be like =file:path/to/file=, to
189 capture the global column view from a different file.
191 Thanks to Francois Lagarde for his report that IDs outside
192 the current file would not work.
198 Cleanup of many small bugs, and one new feature.
202 *** References to last table row with special names
204 Fields in the last row of a table can now be referenced with
205 $LR1, $LR2, etc. These references can appear both on the
206 left hand side and right hand side of a formula.
210 This version reverses the introduction of @0 as a reference to
211 the last rwo in a table, because of a conflict with the use of
212 @0 for the current row.
217 - All known LaTeX export issues fixed
218 - Captions and attributes for figures and tables.
219 - Better implementation for entry IDs
220 - Spreadsheet references to the last table line.
221 - Old syntax for link attributes abandoned
223 ** Incompatible changes
224 *** Old syntax for link attributes abandoned
226 There used to be a syntax for setting link attributes for
227 HTML export by enclosing the attributes into double braces
228 and adding them to the link itself, like
231 [[./img/a.jpg{{alt="an image"}}] ]
234 This syntax is not longer supported, use instead
237 ,#+ATTR_HTML: alt="an image"
243 *** All known LaTeX export issues fixed
245 All the remaining issues with the LaTeX exporter have hopefully
246 been addressed in this release. In particular, this covers
247 quoting of special characters in tables and problems with
248 exporting files where the headline is in the first line, or with
251 *** Captions and attributes for figures and tables.
253 Tables, and Hyperlinks that represent inlined images, can now be
254 equipped with additional information that will be used during
255 export. The information will be taken from the following special
256 lines in the buffer and apply to the first following table or
259 - #+CAPTION: :: The caption of the image or table. This string
260 should be processed according to the export backend, but
261 this is not yet done.
263 - #+LABEL: :: A label to identify the figure/table for cross
264 references. For HTML export, this string will become the
265 ID for the ~<div class="figure">~ element that encapsulates
266 the image tag and the caption. For LaTeX export, this
267 string will be used as the argument of a ~\label{...}~
268 macro. These labels will be available for internal links
269 like ~[[label][Table] ]~.
271 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
272 added as attributes into the ~<img...>~ tag. This string
273 will not be processed, so it should have immediately the
276 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
278 For /images/, this string is directly inserted into
279 the optional argument of the ~\includegraphics[...]{file}~
280 command, to specify scaling, clipping and other options.
281 This string will not be processed, so it should have
282 immediately the right format, like =width=5cm,angle=90=.\\
283 For /tables/, this can currently contain the keyword
284 =longtable=, to request typesetting of the table using the
285 longtable package, which automatically distributes the table
286 over several pages if needed. Also, the attributes line may
287 contain an alignment string for the tabular environment, like
288 =longtable,align=l|lrl=
290 For LaTeX export, if either a caption or a label is given, the element
291 will be exported as a float, i.e. wrapped into a figure or table
294 *** Better implementation for entry IDs
296 Unique identifiers for entries can now be used more efficiently.
297 Internally, a hash array has replaced the alist used so far to
298 keep track of the files in which an ID is defined. This makes it
299 quite fast to find an entry by ID.
301 There is a new link type which looks like this:
304 id:GLOBALLY-UNIQUE-IDENTIFIER
307 This link points to a specific entry. When you move the entry to
308 a different file, for example if you move it to an archive
309 file, the link will continue to work.
311 The file /org-id.el/ contains an API that can be used to write
312 code using these identifiers, including creating IDs and finding
313 them wherever they are.
315 Org has its own method to create unique identifiers, but if the system
316 has /uuidgen/ command installed (Mac's and Linux systems generally
317 do), it will be used by default (a change compared to the earlier
318 implmentation, where you explicitdly had to opt for uuidgen). You can
319 also select the method by hand, using the variable =org-id-method=.
321 If the ID system ever gets confused about where a certain ID is, it
322 initiates a global scan of all agenda files with associated archives,
323 all files previously known containing any IDs, and all currently
324 visited Org-mode files to rebuild the hash. You can also initiate
325 this by hand: =M-x org-id-update-id-locations=. Running this command
326 will also dump into the =*Messages*= buffer information about any
327 duplicate IDs. These should not exist, and Org will never /make/ the
328 same ID twice, but if you /copy/ an entry with its properties,
329 duplicate IDs will inevitably be produced. Unfortunately, this is
330 unavoidable in a plain text system that allows you to edit the text in
331 arbitrary ways, and a portion of care on your side is needed to keep
334 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
335 This is also a change from previous versions where the file was
336 =~/.org=id-locations=. Therefore, you can remove this old file
337 if you have it. I am not sure what will happen if the =.emacs.d=
338 directory does not exists in your setup, but in modern Emacsen, I
339 believe it should exist. If you do not want to use IDs across
340 files, you can avoid the overhead with tracking IDs by
341 customizing the variable =org-id-track-globally=. IDs can then
342 still be used for links inside a single file.
344 IDs will also be used when you create a new link to an Org-mode
345 buffer. If you use =org-store-link= (normally at =C-c l=) inside
346 en entry in an Org-mode buffer, and ID property will be created
347 if it does not exist, and the stored link will be an =id:= link.
348 If you prefer the much less secure linking to headline text, you
349 can configure the variable =org-link-to-org-use-id=. The default
350 setting for this variable is =create-if-interactive=, meaning
351 that an ID will be created when you store a link interactively,
352 but not if you happen to be in an Org-mode file while you create
353 a remember note (which usually has a link to the place where you
354 were when starting remember).
356 *** Spreadsheet references to the last table line.
358 You may now use =@0= to reference the last dataline in a table
359 in a stable way. This is useful in particular for automatically
360 generated tables like the ones using /org-collector.el/ by Eric
366 - New relative timer to support timed notes
367 - Special faces can be set for individual tags
368 - The agenda shows now all tags, including inherited ones.
369 - Exclude some tags from inheritance.
370 - More special values for time comparisons in property searches
371 - Control for exporting meta data
372 - Cut and Paste with hot links from w3m to Org
373 - LOCATION can be inherited for iCalendar export
374 - Relative row references crossing hlines now throw an error
376 ** Incompatible Changes
378 *** Relative row references crossing hlines now throw an error
380 Relative row references in tables look like this: "@-4" which
381 means the forth row above this one. These row references are
382 not allowed to cross horizontal separator lines (hlines). So
383 far, when a row reference violates this policy, Org would
384 silently choose the field just next to the hline.
386 Tassilo Horn pointed out that this kind of hidden magic is
387 actually confusing and may cause incorrect formulas, and I do
388 agree. Therefore, trying to cross a hline with a relative
389 reference will now throw an error.
391 If you need the old behavior, customize the variable
392 `org-table-error-on-row-ref-crossing-hline'.
396 *** New relative timer to support timed notes
398 Org now supports taking timed notes, useful for example while
399 watching a video, or during a meeting which is also recorded.
402 Insert a relative time into the buffer. The first time
403 you use this, the timer will be started. When called
404 with a prefix argument, the timer is reset to 0.
407 Insert a description list item with the current relative
408 time. With a prefix argument, first reset the timer to 0.
411 Once the time list has been initiated, you can also use the
412 normal item-creating command to insert the next timer item.
415 Reset the timer without inserting anything into the buffer.
416 By default, the timer is reset to 0. When called with a
417 =C-u= prefix, reset the timer to specific starting
418 offset. The user is prompted for the offset, with a
419 default taken from a timer string at point, if any, So this
420 can be used to restart taking notes after a break in the
421 process. When called with a double prefix argument
422 =C-c C-u=, change all timer strings in the active
423 region by a certain amount. This can be used to fix timer
424 strings if the timer was not started at exactly the right
427 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
428 contributions to this idea.
430 *** Special faces can be set for individual tags
432 You may now use the variable =org-tag-faces= to define the
433 face used for specific tags, much in the same way as you can
434 do for TODO keywords.
436 Thanks to Samuel Wales for this proposal.
438 *** The agenda shows now all tags, including inherited ones.
440 This request has come up often, most recently it was
441 formulated by Tassilo Horn.
443 If you prefer the old behavior of only showing the local
444 tags, customize the variable =org-agenda-show-inherited-tags=.
446 *** Exclude some tags from inheritance.
448 So far, the only way to select tags for inheritance was to
449 allow it for all tags, or to do a positive selection using
450 one of the more complex settings for
451 `org-use-tag-inheritance'. It may actually be better to
452 allow inheritance for all but a few tags, which was difficult
453 to achieve with this methodology.
455 A new option, `org-tags-exclude-from-inheritance', allows to
456 specify an exclusion list for inherited tags.
458 *** More special values for time comparisons in property searches
460 In addition to =<now>=, =<today>=, =<yesterday>=, and
461 =<tomorrow>=, there are more special values accepted now in
462 time comparisons in property searches: You may use strings
463 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
464 week, month, and year, respectively
466 Thanks to Linday Todd for this proposal.
468 *** Control for exporting meta data
470 All the metadata in a headline, i.e. the TODO keyword, the
471 priority cookie, and the tags, can now be excluded from
472 export with appropriate options:
474 | Variable | Publishing property | OPTIONS switch |
475 |-------------------------------+---------------------+----------------|
476 | org-export-with-todo-keywords | :todo-keywords | todo: |
477 | org-export-with-tags | :tags | tags: |
478 | org-export-with-priority | :priority | pri: |
480 *** Cut and Paste with hot links from w3m to Org
482 You can now use the key =C-c C-x M-w= in a w3m buffer with
483 HTML content to copy either the region or the entire file in
484 a special way. When you yank this text back into an Org-mode
485 buffer, all links from the w3m buffer will continue to work
488 For this to work you need to load the new file /org-w3m.el./
489 Please check your org-modules variable to make sure that this
492 Thanks for Richard Riley for the idea and to Andy Stewart for
495 *** LOCATION can be inherited for iCalendar export
497 The LOCATION property can now be inherited during iCalendar
498 export if you configure =org-use-property-inheritance= like
501 #+begin_src emacs-lisp
502 (setq org-use-property-inheritance '("LOCATION"))
509 - Keybindings in Remember buffers can be configured
510 - Support for ido completion
511 - New face for date lines in agenda column view
512 - Invisible targets become now anchors in headlines.
513 - New contributed file /org-exp-blocks.el/
514 - New contributed file /org-eval-light.el/
516 - BBDB links may use regular expressions.
517 - Link abbreviations can use %h to insert a url-encoded target value
518 - Improved XHTML compliance
522 *** Keybindings in Remember buffers can be configured
524 The remember buffers created with Org's extensions are in
525 Org-mode, which is nice to prepare snippets that will
526 actually be stored in Org-mode files. However, this makes it
527 hard to configure key bindings without modifying the Org-mode
528 keymap. There is now a minor mode active in these buffers,
529 `org-remember-mode', and its keymap org-remember-mode-map can
530 be used for key bindings. By default, this map only contains
531 the bindings for =C-c C-c= to store the note, and =C-c C-k=
532 to abort it. Use `org-remember-mode-hook' to define your own
535 #+begin_src emacs-lisp
537 'org-remember-mode-hook
539 (define-key org-remember-mode-map
540 "\C-x\C-s" 'org-remember-finalize)))
543 If you wish, you can also use this to free the =C-c C-c=
544 binding (by binding this key to nil in the minor mode map),
545 so that you can use =C-c C-c= again to set tags.
547 This modification is based on a request by Tim O'Callaghan.
549 *** Support for ido completion
551 You can now get the completion interface from /ido.el/ for
552 many of Org's internal completion commands by turning on the
553 variable =org-completion-use-ido=. =ido-mode= must also be
554 active before you can use this.
556 This change is based upon a request by Samuel Wales.
558 *** New face for date lines in agenda column view
560 When column view is active in the agenda, and when you have
561 summarizing properties, the date lines become normal column
562 lines and the separation between different days becomes
563 harder to see. If this bothers you, you can now customize
564 the face =org-agenda-column-dateline=.
566 This is based on a request by George Pearson.
568 *** Invisible targets become now anchors in headlines.
570 These anchors can be used to jump to a directly with an HTML
571 link, just like the =sec-xxx= IDs. For example, the
572 following will make a http link
573 =//domain/path-to-my-file.html#dummy= work:
580 This is based on a request by Matt Lundin.
582 *** New contributed file /org-exp-blocks.el/
584 This new file implements special export behavior of
585 user-defined blocks. The currently supported blocks are
587 - comment :: Comment blocks with author-specific markup
588 - ditaa :: conversion of ASCII art into pretty png files
589 using Stathis Sideris' /ditaa.jar/ program
590 - dot :: creation of graphs in the /dot/ language
591 - R :: Sweave type exporting using the R program
593 For more details and examples, see the file commentary in
596 Kudos to Eric Schulte for this new functionality, after
597 /org-plot.el/ already his second major contribution. Thanks
598 to Stathis for this excellent program, and for allowing us to
599 bundle it with Org-mode.
601 *** New contributed file /org-eval-light.el/
603 This module gives control over execution Emacs Lisp code
604 blocks included in a file.
606 Thanks to Eric Schulte also for this file.
610 You can now configure Org to understand many links created
611 with the Emacs Planner package, so you can cut text from
612 planner pages and paste them into Org-mode files without
613 having to re-write the links. Among other things, this means
614 that the command =org-open-at-point-global= which follows
615 links not only in Org-mode, but in arbitrary files like
616 source code files etc, will work also with links created by
617 planner. The following customization is needed to make all of
620 #+begin_src emacs-lisp
621 (setq org-link-translation-function
622 'org-translate-link-from-planner)
625 I guess an inverse translator could be written and integrated
628 *** BBDB links may use regular expressions.
630 This did work all along, but only now I have documented it.
632 *** =yank-pop= works again after yanking an outline tree
634 Samuel Wales had noticed that =org-yank= did mess up this
635 functionality. Now you can use =yank-pop= again, the only
636 restriction is that the so-yanked text will not be
637 pro/demoted or folded.
639 *** Link abbreviations can use %h to insert a url-encoded target value
641 Thanks to Steve Purcell for a patch to this effect.
643 *** Improved XHTML compliance
645 Thanks to Sebastian Rose for pushing this.
647 *** Many bug fixes again.
652 - A region of entries can now be refiled with a single command
653 - Fine-tuning the behavior of `org-yank'
654 - Formulas for clocktables
655 - Better implementation of footnotes for HTML export
656 - More languages for HTML export.
660 *** A region of entries can now be refiled with a single command
662 With =transient-make-mode= active (=zmacs-regions= under
663 XEmacs), you can now select a region of entries and refile
664 them all with a single =C-c C-w= command.
666 Thanks to Samuel Wales for this useful proposal.
668 *** Fine-tuning the behavior of =org-yank=
670 The behavior of Org's yanking command has been further
671 fine-tuned in order to avoid some of the small annoyances
674 - Calling =org-yank= with a prefix arg will stop any special
675 treatment and directly pass through to the normal =yank=
676 command. Therefore, you can now force a normal yank with
679 - Subtrees will only be folded after a yank if doing so will
680 now swallow any non-white characters after the yanked text.
681 This is, I think a really important change to make the
682 command work more sanely.
684 *** Formulas for clocktables
686 You can now add formulas to a clock table, either by hand, or
687 with a =:formula= parameter. These formulas can be used to
688 create additional columns with further analysis of the
691 Thanks to Jurgen Defurne for triggering this addition.
693 *** Better implementation of footnotes for HTML export
695 The footnote export in 6.11 really was not good enough. Now
696 it works fine. If you have customized
697 =footnote-section-tag=, make sure that your customization is
698 matched by =footnote-section-tag-regexp=.
700 Thanks to Sebastian Rose for pushing this change.
702 *** More languages for HTML export.
704 More languages are supported during HTML export. This is
705 only relevant for the few special words Org inserts, like
706 "Table of Contents", or "Footnotes". Also the encoding
707 issues with this feature seem to be solved now.
709 Thanks to Sebastian Rose for pushing me to fix the encoding
716 - Yanking subtree with =C-y= now adjusts the tree level
717 - State changes can now be shown in the log mode in the agenda
718 - Footnote in HTML export are now collected at the end of the document
719 - HTML export now validates again as XHTML
720 - The clock can now be resumed after exiting and re-starting Emacs
721 - Clock-related data can be saved and resumed across Emacs sessions
722 - Following file links can now use C-u C-u to force use of an external app
723 - Inserting absolute files names now abbreviates links with "~"
724 - Links to attachment files
725 - Completed repeated tasks listed briefly in agenda
726 - Remove buffers created during publishing are removed
730 *** Yanking subtree with =C-y= now adjusts the tree level
731 When yanking a cut/copied subtree or a series of trees, the
732 normal yank key =C-y= now adjusts the level of the tree to
733 make it fit into the current outline position, without losing
734 its identity, and without swallowing other subtrees.
736 This uses the command =org-past-subtree=. An additional
737 change in that command has been implemented: Normally, this
738 command picks the right outline level from the surrounding
739 *visible* headlines, and uses the smaller one. So if the
740 cursor is between a level 4 and a level 3 headline, the tree
741 will be pasted as level 3. If the cursor is actually *at*
742 the beginning of a headline, the level of that headline will
743 be used. For example, lets say you have a tree like this:
749 ,(2)* Level one again
752 with (1) and (2) indicating possible cursor positions for the
753 insertion. When at (1), the tree will be pasted as level 2.
754 When at (2), it will be pasted as level 1.
756 If you do not want =C-y= to behave like this, configure the
757 variable =org-yank-adjusted-subtrees=.
759 Thanks to Samuel Wales for this idea and a partial implementation.
761 *** State changes can now be shown in the log mode in the agenda
763 If you configure the variable =org-agenda-log-mode-items=,
764 you can now request that all logged state changes be included
765 in the agenda when log mode is active. If you find this too
766 much for normal applications, you can also temporarily
767 request the inclusion of state changes by pressing =C-u l= in
770 This was a request by Hsiu-Khuern Tang.
772 You can also press `C-u C-u l' to get *only* log items in the
773 agenda, withour any timestamps/deadlines etc.
775 *** Footnote in HTML export are now collected at the end of the document
776 Previously, footnotes would be left in the document where
777 they are defined, now they are all collected and put into a
778 special =<div>= at the end of the document.
780 Thanks to Sebastian Rose for this request.
782 *** HTML export now validates again as XHTML.
784 Thanks to Sebastian Rose for pushing this cleanup.
786 *** The clock can now be resumed after exiting and re-starting Emacs
788 If the option =org-clock-in-resume= is t, and the first clock
789 line in an entry is unclosed, clocking into that task resumes
790 the clock from that time.
792 Thanks to James TD Smith for a patch to this effect.
794 *** Clock-related data can be saved and resumed across Emacs sessions
796 The data saved include the contents of =org-clock-history=,
797 and the running clock, if there is one.
799 To use this, you will need to add to your .emacs
801 #+begin_src emacs-lisp
802 (setq org-clock-persist t)
803 (setq org-clock-in-resume t)
804 (org-clock-persistence-insinuate)
807 Thanks to James TD Smith for a patch to this effect.
809 *** Following file links can now use C-u C-u to force use of an external app.
811 So far you could only bypass your setup in `org-file-apps'
812 and force opening a file link in Emacs by using a =C-u= prefix arg
813 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
814 an external application. Which external application depends
815 on your system. On Mac OS X and Windows, =open= is used. On
816 a GNU/Linux system, the mailcap settings are used.
818 This was a proposal by Samuel Wales.
820 *** Inserting absolute files names now abbreviates links with "~".
822 Inserting file links with =C-u C-c C-l= was buggy if the
823 setting of `org-link-file-path-type' was `adaptive' (the
824 default). Absolute file paths were not abbreviated relative
825 to the users home directory. This bug has been fixed.
827 Thanks to Matt Lundin for the report.
829 *** Links to attachment files
831 Even though one of the purposes of entry attachments was to
832 reduce the number of links in an entry, one might still want
833 to have the occasional link to one of those files. You can
834 now use link abbreviations to set up a special link type that
835 points to attachments in the current entry. Note that such
836 links will only work from within the same entry that has the
837 attachment, because the directory path is entry specific.
838 Here is the setup you need:
840 #+begin_src emacs-lisp
841 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
844 After this, a link like this will work
847 [[att:some-attached-file.txt]]
849 This was a proposal by Lindsay Todd.
851 *** Completed repeated tasks listed briefly in agenda
853 When a repeating task, listed in the daily/weekly agenda under
854 today's date, is completed from the agenda, it is listed as
855 DONE in the agenda until the next update happens. After the
856 next update, the task will have disappeared, of course,
857 because the new date is no longer today.
859 *** Remove buffers created during publishing are removed
861 Buffers that are created during publishing are now deleted
862 when the publishing is over. At least I hope it works like this.
868 - Secondary agenda filtering is becoming a killer feature
869 - Setting tags has now its own binding, =C-c C-q=
870 - Todo state changes can trigger tag changes
871 - C-RET will now always insert a new headline, never an item.
872 - Customize org-mouse.el feature set to free up mouse events
873 - New commands for export all the way to PDF (through LaTeX)
874 - Some bug fixed for LaTeX export, more bugs remain.
878 *** Enhancements to secondary agenda filtering
880 This is, I believe, becoming a killer feature. It allows you
881 to define fewer and more general custom agenda commands, and
882 then to do the final narrowing to specific tasks you are
883 looking for very quickly, much faster than calling a new
886 If you have not tries this yet, you should!
888 **** You can now refining the current filter by an additional criterion
889 When filtering an existing agenda view with =/=, you can
890 now narrow down the existing selection by an additional
891 condition. Do do this, use =\= instead of =/= to add the
892 additional criterion. You can also press =+= or =-= after
893 =/= to add a positive or negative condition. A condition
894 can be a TAG, or an effort estimate limit, see below.
896 **** It is now possible to filter for effort estimates
897 This means to filter the agenda for the value of the Effort
898 property. For this you should best set up global allowed
899 values for effort estimates, with
901 #+begin_src emacs-lisp
902 (setq org-global-properties
903 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
906 You may then select effort limits with single keys in the
907 filter. It works like this: After =/= or =\=, first select
908 the operator which you want to use to compare effort
911 : < Select entries with effort smaller than or equal to the limit
912 : > Select entries with effort larger than or equal to the limit
913 : = Select entries with effort equal to the limit
915 After that, you can press a single digit number which is
916 used as an index to the allowed effort estimates.
918 If you do not use digits to fast-select tags, you can even
919 skip the operator, which will then default to
920 `org-agenda-filter-effort-default-operator', which is by
923 Thanks to Manish for the great idea to include fast effort
924 filtering into the agenda filtering process.
926 **** The mode line will show the active filter
927 For example, if there is a filter in place that does select
928 for HOME tags, against EMAIL tags, and for tasks with an
929 estimated effort smaller than 30 minutes, the mode-line with
930 show =+HOME-EMAIL+<0:30=
932 **** The filter now persists when the agenda view is refreshed
933 All normal refresh commands, including those that move the
934 weekly agenda from one week to the next, now keep the
935 current filter in place.
937 You need to press =/ /= to turn off the filter. However,
938 when you run a new agenda command, for example going from
939 the weekly agenda to the TODO list, the filter will be
942 *** Setting tags has now its own binding, =C-c C-q=
944 You can still use =C-c C-c= on a headline, but the new
945 binding should be considered as the main binding for this
946 command. The reasons for this change are:
948 - Using =C-c C-c= for tags is really out of line with other
951 - I hate it in Remember buffers when I try to set tags and I
952 cannot, because =C-c C-c= exits the buffer :-(
954 - =C-c C-q= will also work when the cursor is somewhere down
955 in the entry, it does not have to be on the headline.
957 *** Todo state changes can trigger tag changes
959 The new option =org-todo-state-tags-triggers= can be used to
960 define automatic changes to tags when a TODO state changes.
961 For example, the setting
963 : (setq org-todo-state-tags-triggers
964 : '((done ("Today" . nil) ("NEXT" . nil))
965 : ("WAITING" ("Today" . t))))
967 will make sure that any change to any of the DONE states will
968 remove tags "Today" and "NEXT", while switching to the
969 "WAITING" state will trigger the tag "Today" to be added.
971 I use this mostly to get rid of TODAY and NEXT tags which I
972 apply to select an entry for execution in the near future,
973 which I often prefer to specific time scheduling.
975 *** C-RET will now always insert a new headline, never an item.
976 The new headline is inserted after the current subtree.
978 Thanks to Peter Jones for patches to fine-tune this behavior.
980 *** Customize org-mouse.el feature set
981 There is a new variable =org-mouse-features= which gives you
982 some control about what features of org-mouse you want to
983 use. Turning off some of the feature will free up the
984 corresponding mouse events, or will avoid activating special
985 regions for mouse clicks. By default I have urned off the
986 feature to use drag mouse events to move or promote/demote
987 entries. You can of course turn them back on if you wish.
989 This variable may still change in the future, allowing more
990 fine-grained control.
992 *** New commands for export to PDF
994 This is using LaTeX export, and then processes it to PDF
997 : C-c C-e p process to PDF.
998 : C-c C-e d process to PDF, and open the file.
1001 - \usepackage{graphicx} is now part of the standard class
1003 - Several bugs fixed, but definitely not all of them :-(
1005 *** New option `org-log-state-notes-insert-after-drawers'
1007 Set this to =t= if you want state change notes to be inserted
1008 after any initial drawers, i.e drawers the immediately follow
1009 the headline and the planning line (the one with
1010 DEADLINE/SCHEDULED/CLOSED information).
1014 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1018 *** =org-file-apps= now uses regular repressions instead of extensions
1019 Just like in =auto-mode-alist=, car's in the variable
1020 =org-file-apps= that are strings are now interpreted as
1021 regular expressions that are matched against a file name. So
1022 instead of "txt", you should now write "\\.txt\\'" to make
1023 sure the matching is done correctly (even though "txt" will
1024 be recognized and still be interpreted as an extension).
1026 There is now a shortcut to get many file types visited by
1027 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
1028 any files that are matched by `auto-mode-alist' will be
1031 *** Changes to the attachment system
1033 - The default method to attach a file is now to copy it
1034 instead of moving it.
1035 - You can modify the default method using the variable
1036 `org-attach-method'. I believe that most Unix people want
1037 to set it to `ln' to create hard links.
1038 - The keys =c=, =m=, and =l= specifically select =copy=,
1039 =move=, or =link=, respectively, as the attachment method
1040 for a file, overruling `org-attach-method'.
1041 - To create a new attachment as an Emacs buffer, you have not
1042 now use =n= instead of =c=.
1043 - The file list is now always retrieved from the directory
1044 itself, not from the "Attachments" property. We still
1045 keep this property by default, but you can turn it off, by
1046 customizing the variable =org-attach-file-list-property=.
1050 ** Incompatible changes
1052 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
1054 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
1058 *** The default structure of IDs has changed
1060 IDs created by Org have changed a bit:
1061 - By default, there is no prefix on the ID. There used to be
1062 an "Org" prefix, but I now think this is not necessary.
1063 - IDs use only lower-case letters, no upper-case letters
1064 anymore. The reason for this is that IDs are now also used
1065 as directory names for org-attach, and some systems do not
1066 distinguish upper and lower case in the file system.
1067 - The ID string derived from the current time is now
1068 /reversed/ to become an ID. This assures that the first
1069 two letters of the ID change fast, so hat it makes sense to
1070 split them off to create subdirectories to balance load.
1071 - You can now set the `org-id-method' to `uuidgen' on systems
1074 *** =C-c C-a= no longer calls `show-all'
1076 The reason for this is that =C-c C-a= is now used for the
1077 attachment system. On the rare occasions that this command
1078 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
1080 *** New attachment system
1082 You can now attach files to each node in the outline tree.
1083 This works by creating special directories based on the ID of
1084 an entry, and storing files in these directories. Org can
1085 keep track of changes to the attachments by automatically
1086 committing changes to git. See the manual for more
1089 Thanks to John Wiegley who contributed this fantastic new
1090 concept and wrote org-attach.el to implement it.
1092 *** New remember template escapes
1094 : %^{prop}p to insert a property
1095 : %k the heading of the item currently being clocked
1096 : %K a link to the heading of the item currently being clocked
1098 Also, when you exit remember with =C-2 C-c C-c=, the item
1099 will be filed as a child of the item currently being
1100 clocked. So the idea is, if you are working on something and
1101 think of a new task related to this or a new note to be
1102 added, you can use this to quickly add information to that
1105 Thanks to James TD Smith for a patch to this effect.
1107 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
1109 Thanks to James TD Smith for a patch to this effect.
1111 *** New file in contrib: lisp/org-checklist.el
1113 This module deals with repeated tasks that have checkbox
1116 Thanks to James TD Smith for this contribution.
1118 *** New in-buffer setting #+STYLE
1120 It can be used to locally set the variable
1121 `org-export-html-style-extra'. Several such lines are
1122 allowed-, they will all be concatenated. For an example on
1123 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1129 - Filtering existing agenda views with respect to a tag
1130 - Editing fixed-width regions with picture or artist mode
1131 - /org-plot.el/ is now part of Org
1132 - Tags can be used to select the export part of a document
1133 - Prefix interpretation when storing remember notes
1134 - Yanking inserts folded subtrees
1135 - Column view capture tables can have formulas, plotting info
1136 - In column view, date stamps can be changed with S-cursor keys
1137 - The note buffer for clocking out now mentions the task
1138 - Sorting entries alphabetically ignores TODO keyword and priority
1139 - Agenda views can sort entries by TODO state
1140 - New face =org-scheduled= for entries scheduled in the future.
1141 - Remember templates for gnus links can use the :to escape.
1142 - The file specification in a remember template may be a function
1143 - Categories in iCalendar export include local tags
1144 - It is possible to define filters for column view
1145 - Disabling integer increment during table Field copy
1146 - Capturing column view is on `C-c C-x i'
1147 - And tons of bugs fixed.
1150 ** Incompatible changes
1152 *** Prefix interpretation when storing remember notes has changed
1154 The prefix argument to the `C-c C-c' command that finishes a
1155 remember process is now interpreted differently:
1157 : C-c C-c Store the note to predefined file and headline
1158 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1159 : in its new location.
1160 : C-1 C-c C-c Select the storage location interactively
1161 : C-0 C-c C-c Re-use the last used location
1163 This was requested by John Wiegley.
1165 *** Capturing column view is now on `C-c C-x i'
1167 The reason for this change was that `C-c C-x r' is also used
1168 as a tty key replacement.
1170 *** Categories in iCalendar export now include local tags
1172 The locally defined tags are now listed as categories when
1173 exporting to iCalendar format. Org's traditional file/tree
1174 category is now the last category in this list. Configure
1175 the variable =org-icalendar-categories= to modify or revert
1178 This was a request by Charles Philip Chan.
1182 *** Secondary filtering of agenda views.
1184 You can now easily and interactively filter an existing
1185 agenda view with respect to a tag. This command is executed
1186 with the =/= key in the agenda. You will be prompted for a
1187 tag selection key, and all entries that do not contain or
1188 inherit the corresponding tag will be hidden. With a prefix
1189 argument, the opposite filter is applied: entries that
1190 do have the tag will be hidden.
1192 This operation only /hides/ lines in the agenda buffer, it
1193 does not remove them. Changing the secondary filtering does
1194 not require a new search and is very fast.
1196 If you press TAB at the tag selection prompt, you will be
1197 switched to a completion interface to select a tag. This is
1198 useful when you want to select a tag that does not have a
1199 direct access character.
1201 A double =/ /= will restore the original agenda view by
1202 unhiding any hidden lines.
1204 This functionality was John Wiegley's idea. It is a simpler
1205 implementation of some of the query-editing features proposed
1206 and implemented some time ago by Christopher League (see the
1207 file contrib/lisp/org-interactive-query.el).
1209 *** Editing fixed-width regions with picture or artist mode
1211 The command @<code>C-c '@</code> (that is =C-c= followed by a
1212 single quote) can now also be used to switch to a special
1213 editing mode for fixed-width sections. The default mode is
1214 =artist-mode= which allows you to create ASCII drawings.
1216 It works like this: Enter the editing mode with
1217 @<code>C-c '@</code>. An indirect buffer will be created and
1218 narrowed to the fixed-width region. Edit the drawing, and
1219 press @<code>C-c '@</code> again to exit.
1221 Lines in a fixed-width region should be preceded by a colon
1222 followed by at least one space. These will be removed during
1223 editing, and then added back when you exit the editing mode.
1225 Using the command in an empty line will create a new
1228 This new feature arose from a discussion involving Scott
1229 Otterson, Sebastian Rose and Will Henney.
1231 *** /org-plot.el/ is now part of Org.
1233 You can run it by simple calling org-plot/gnuplot.
1234 Documentation is not yet included with Org, please refer to
1235 http://github.com/eschulte/org-plot/tree/master until we have
1236 moved the docs into Org or Worg.
1238 Thanks to Eric Schulte for this great contribution.
1240 *** Tags can be used to select the export part of a document
1242 You may now use tags to select parts of a document for
1243 inclusion into the export, and to exclude other parts. This
1244 behavior is governed by two new variables:
1245 =org-export-select-tags= and =org-export-exclude-tags=.
1246 These default to =("export")= and =("noexport")=, but can be
1247 changed, even to include a list of several tags.
1249 Org first checks if any of the /select/ tags is present in
1250 the buffer. If yes, all trees that do not carry one of these
1251 tags will be excluded. If a selected tree is a subtree, the
1252 heading hierarchy above it will also be selected for export,
1253 but not the text below those headings. If none of the select
1254 tags is found anywhere in the buffer, the whole buffer will
1255 be selected for export. Finally, all subtrees that are
1256 marked by any of the /exclude/ tags will be removed from the
1259 You may set these tags with in-buffer options
1260 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1262 I love this feature. Thanks to Richard G Riley for coming
1265 *** Prefix interpretation when storing remember notes
1267 The prefix argument to the `C-c C-c' command that finishes a
1268 remember process is now interpreted differently:
1270 : C-c C-c Store the note to predefined file and headline
1271 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1272 : in its new location.
1273 : C-1 C-c C-c Select the storage location interactively
1274 : C-0 C-c C-c Re-use the last used location
1276 This was requested by John Wiegley.
1278 *** Yanking inserts folded subtrees
1280 If the kill is a subtree or a sequence of subtrees, yanking
1281 them with =C-y= will leave all the subtrees in a folded
1282 state. This basically means, that kill and yank are now
1283 much more useful in moving stuff around in your outline. If
1284 you do not like this, customize the variable
1285 =org-yank-folded-subtrees=.
1287 Right now, I am only binding =C-y= to this new function,
1288 should I modify all bindings of yank? Do we need to amend
1291 This feature was requested by John Wiegley.
1293 *** Column view capture tables can have formulas, plotting info
1295 If you attach formulas and plotting instructions to a table
1296 capturing column view, these extra lines will now survive an
1297 update of the column view capture, and any formulas will be
1298 re-applied to the captured table. This works by keeping any
1299 continuous block of comments before and after the actual
1302 *** In column view, date stamps can be changed with S-cursor keys
1304 If a property value is a time stamp, S-left and S-right can
1305 now be used to shift this date around while in column view.
1307 This was a request by Chris Randle.
1309 *** The note buffer for clocking out now mentions the task
1311 This was a request by Peter Frings.
1313 *** Sorting entries alphabetically ignores TODO keyword and priority
1315 Numerical and alphanumerical sorting now skips any TODO
1316 keyword or priority cookie when constructing the comparison
1317 string. This was a request by Wanrong Lin.
1319 *** Agenda views can sort entries by TODO state
1321 You can now define a sorting strategy for agenda entries that
1322 does look at the TODO state of the entries. Sorting by TODO
1323 entry does first separate the non-done from the done states.
1324 Within each class, the entries are sorted not alphabetically,
1325 but in definition order. So if you have a sequence of TODO
1326 entries defined, the entries will be sorted according to the
1327 position of the keyword in this sequence.
1329 This follows an idea and sample implementation by Christian
1332 *** New face =org-scheduled= for entries scheduled in the future.
1334 This was a request by Richard G Riley.
1336 *** Remember templates for gnus links can now use the :to escape.
1338 Thanks to Tommy Lindgren for a patch to this effect.
1339 *** The file specification in a remember template may now be a function
1341 Thanks to Gregory Sullivan for a patch to this effect.
1343 *** Categories in iCalendar export now include local tags
1345 The locally defined tags are now listed as categories when
1346 exporting to iCalendar format. Org's traditional file/tree
1347 category is now the last category in this list. Configure
1348 the variable =org-icalendar-categories= to modify or revert
1351 This was a request by Charles Philip Chan.
1353 *** It is now possible to define filters for column view
1355 The filter can modify the value that will be displayed in a
1356 column, for example it can cut out a part of a time stamp.
1357 For more information, look at the variable
1358 =org-columns-modify-value-for-display-function=.
1360 *** Disabling integer increment during table field copy
1362 Prefix arg 0 to S-RET does the trick.
1364 This was a request by Chris Randle.
1369 For older Changes, see [[file:Changes_old.org]]