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
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 *** Line numbers and references in literal examples
19 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
20 do now allow optional line numbering in the example.
21 Furthermore, links to specific code lines are supported, greatly
22 increasing Org-mode utility for writing tutorials and other
25 Code references use special labels embedded directly into the
26 source code. Such labels look like "((name))" and must be unique
27 within a document. Org-mode links with the coderef cookie in the
28 link part will be correctly interpreted, both while working with
29 an Org file (internal links), and while exporting to the
30 different backends. Line numbering and code references are
31 supported for all three major backends, HTML, LaTeX, and ASCII.
32 In the HTML backend, hovering the mouse over a link to a source
33 line will remote-highlight the referenced code line.
35 The options for the BEGIN lines are:
37 - -n :: Number the lines in the example
38 - +n :: Like -n, but continue numbering from where the previous
40 - -r :: Remove the coderef cookies from the example, and replace
41 links to this reference with line numbers. This option
42 takes only effect if either -n or +n are given as well.
43 If -r is not given, coderefs simply use the label name.
48 #+begin_src emacs-lisp -n -r
49 (defmacro org-unmodified (&rest body) ((def))
50 "Execute body without changing `buffer-modified-p'."
51 `(set-buffer-modified-p ((back))
52 (prog1 (buffer-modified-p) ,@body)))
54 [[((def))][Line ((def))]] contains the macro name. Later at line [[((back))]],
58 When exported, this is translated to:
59 #+begin_src emacs-lisp -n -r
60 (defmacro org-unmodified (&rest body) ((def))
61 "Execute body without changing `buffer-modified-p'."
62 `(set-buffer-modified-p ((back))
63 (prog1 (buffer-modified-p) ,@body)))
65 [[((def))][Line ((def))]] contains the macro name. Later at line [[((back))]],
69 *** Capture column view into a different file.
71 The :id parameter for the dynamic block capturing column view
72 can now truly be an ID that will also be found in a
73 different file. Also, it can be like =file:path/to/file=, to
74 capture the global column view from a different file.
76 Thanks to Francois Lagarde for his report that IDs outside
77 the current file would not work.
83 Cleanup of many small bugs, and one new feature.
87 *** References to last table row with special names
89 Fields in the last row of a table can now be referenced with
90 $LR1, $LR2, etc. These references can appear both on the
91 left hand side and right hand side of a formula.
95 This version reverses the introduction of @0 as a reference to
96 the last rwo in a table, because of a conflict with the use of
97 @0 for the current row.
102 - All known LaTeX export issues fixed
103 - Captions and attributes for figures and tables.
104 - Better implementation for entry IDs
105 - Spreadsheet references to the last table line.
106 - Old syntax for link attributes abandoned
108 ** Incompatible changes
109 *** Old syntax for link attributes abandoned
111 There used to be a syntax for setting link attributes for
112 HTML export by enclosing the attributes into double braces
113 and adding them to the link itself, like
116 [[./img/a.jpg{{alt="an image"}}] ]
119 This syntax is not longer supported, use instead
122 ,#+ATTR_HTML: alt="an image"
128 *** All known LaTeX export issues fixed
130 All the remaining issues with the LaTeX exporter have hopefully
131 been addressed in this release. In particular, this covers
132 quoting of special characters in tables and problems with
133 exporting files where the headline is in the first line, or with
136 *** Captions and attributes for figures and tables.
138 Tables, and Hyperlinks that represent inlined images, can now be
139 equipped with additional information that will be used during
140 export. The information will be taken from the following special
141 lines in the buffer and apply to the first following table or
144 - #+CAPTION: :: The caption of the image or table. This string
145 should be processed according to the export backend, but
146 this is not yet done.
148 - #+LABEL: :: A label to identify the figure/table for cross
149 references. For HTML export, this string will become the
150 ID for the ~<div class="figure">~ element that encapsulates
151 the image tag and the caption. For LaTeX export, this
152 string will be used as the argument of a ~\label{...}~
153 macro. These labels will be available for internal links
154 like ~[[label][Table] ]~.
156 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
157 added as attributes into the ~<img...>~ tag. This string
158 will not be processed, so it should have immediately the
161 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
163 For /images/, this string is directly inserted into
164 the optional argument of the ~\includegraphics[...]{file}~
165 command, to specify scaling, clipping and other options.
166 This string will not be processed, so it should have
167 immediately the right format, like =width=5cm,angle=90=.\\
168 For /tables/, this can currently contain the keyword
169 =longtable=, to request typesetting of the table using the
170 longtable package, which automatically distributes the table
171 over several pages if needed. Also, the attributes line may
172 contain an alignment string for the tabular environment, like
173 =longtable,align=l|lrl=
175 For LaTeX export, if either a caption or a label is given, the element
176 will be exported as a float, i.e. wrapped into a figure or table
179 *** Better implementation for entry IDs
181 Unique identifiers for entries can now be used more efficiently.
182 Internally, a hash array has replaced the alist used so far to
183 keep track of the files in which an ID is defined. This makes it
184 quite fast to find an entry by ID.
186 There is a new link type which looks like this:
189 id:GLOBALLY-UNIQUE-IDENTIFIER
192 This link points to a specific entry. When you move the entry to
193 a different file, for example if you move it to an archive
194 file, the link will continue to work.
196 The file /org-id.el/ contains an API that can be used to write
197 code using these identifiers, including creating IDs and finding
198 them wherever they are.
200 Org has its own method to create unique identifiers, but if the system
201 has /uuidgen/ command installed (Mac's and Linux systems generally
202 do), it will be used by default (a change compared to the earlier
203 implmentation, where you explicitdly had to opt for uuidgen). You can
204 also select the method by hand, using the variable =org-id-method=.
206 If the ID system ever gets confused about where a certain ID is, it
207 initiates a global scan of all agenda files with associated archives,
208 all files previously known containing any IDs, and all currently
209 visited Org-mode files to rebuild the hash. You can also initiate
210 this by hand: =M-x org-id-update-id-locations=. Running this command
211 will also dump into the =*Messages*= buffer information about any
212 duplicate IDs. These should not exist, and Org will never /make/ the
213 same ID twice, but if you /copy/ an entry with its properties,
214 duplicate IDs will inevitably be produced. Unfortunately, this is
215 unavoidable in a plain text system that allows you to edit the text in
216 arbitrary ways, and a portion of care on your side is needed to keep
219 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
220 This is also a change from previous versions where the file was
221 =~/.org=id-locations=. Therefore, you can remove this old file
222 if you have it. I am not sure what will happen if the =.emacs.d=
223 directory does not exists in your setup, but in modern Emacsen, I
224 believe it should exist. If you do not want to use IDs across
225 files, you can avoid the overhead with tracking IDs by
226 customizing the variable =org-id-track-globally=. IDs can then
227 still be used for links inside a single file.
229 IDs will also be used when you create a new link to an Org-mode
230 buffer. If you use =org-store-link= (normally at =C-c l=) inside
231 en entry in an Org-mode buffer, and ID property will be created
232 if it does not exist, and the stored link will be an =id:= link.
233 If you prefer the much less secure linking to headline text, you
234 can configure the variable =org-link-to-org-use-id=. The default
235 setting for this variable is =create-if-interactive=, meaning
236 that an ID will be created when you store a link interactively,
237 but not if you happen to be in an Org-mode file while you create
238 a remember note (which usually has a link to the place where you
239 were when starting remember).
241 *** Spreadsheet references to the last table line.
243 You may now use =@0= to reference the last dataline in a table
244 in a stable way. This is useful in particular for automatically
245 generated tables like the ones using /org-collector.el/ by Eric
251 - New relative timer to support timed notes
252 - Special faces can be set for individual tags
253 - The agenda shows now all tags, including inherited ones.
254 - Exclude some tags from inheritance.
255 - More special values for time comparisons in property searches
256 - Control for exporting meta data
257 - Cut and Paste with hot links from w3m to Org
258 - LOCATION can be inherited for iCalendar export
259 - Relative row references crossing hlines now throw an error
261 ** Incompatible Changes
263 *** Relative row references crossing hlines now throw an error
265 Relative row references in tables look like this: "@-4" which
266 means the forth row above this one. These row references are
267 not allowed to cross horizontal separator lines (hlines). So
268 far, when a row reference violates this policy, Org would
269 silently choose the field just next to the hline.
271 Tassilo Horn pointed out that this kind of hidden magic is
272 actually confusing and may cause incorrect formulas, and I do
273 agree. Therefore, trying to cross a hline with a relative
274 reference will now throw an error.
276 If you need the old behavior, customize the variable
277 `org-table-error-on-row-ref-crossing-hline'.
281 *** New relative timer to support timed notes
283 Org now supports taking timed notes, useful for example while
284 watching a video, or during a meeting which is also recorded.
287 Insert a relative time into the buffer. The first time
288 you use this, the timer will be started. When called
289 with a prefix argument, the timer is reset to 0.
292 Insert a description list item with the current relative
293 time. With a prefix argument, first reset the timer to 0.
296 Once the time list has been initiated, you can also use the
297 normal item-creating command to insert the next timer item.
300 Reset the timer without inserting anything into the buffer.
301 By default, the timer is reset to 0. When called with a
302 =C-u= prefix, reset the timer to specific starting
303 offset. The user is prompted for the offset, with a
304 default taken from a timer string at point, if any, So this
305 can be used to restart taking notes after a break in the
306 process. When called with a double prefix argument
307 =C-c C-u=, change all timer strings in the active
308 region by a certain amount. This can be used to fix timer
309 strings if the timer was not started at exactly the right
312 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
313 contributions to this idea.
315 *** Special faces can be set for individual tags
317 You may now use the variable =org-tag-faces= to define the
318 face used for specific tags, much in the same way as you can
319 do for TODO keywords.
321 Thanks to Samuel Wales for this proposal.
323 *** The agenda shows now all tags, including inherited ones.
325 This request has come up often, most recently it was
326 formulated by Tassilo Horn.
328 If you prefer the old behavior of only showing the local
329 tags, customize the variable =org-agenda-show-inherited-tags=.
331 *** Exclude some tags from inheritance.
333 So far, the only way to select tags for inheritance was to
334 allow it for all tags, or to do a positive selection using
335 one of the more complex settings for
336 `org-use-tag-inheritance'. It may actually be better to
337 allow inheritance for all but a few tags, which was difficult
338 to achieve with this methodology.
340 A new option, `org-tags-exclude-from-inheritance', allows to
341 specify an exclusion list for inherited tags.
343 *** More special values for time comparisons in property searches
345 In addition to =<now>=, =<today>=, =<yesterday>=, and
346 =<tomorrow>=, there are more special values accepted now in
347 time comparisons in property searches: You may use strings
348 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
349 week, month, and year, respectively
351 Thanks to Linday Todd for this proposal.
353 *** Control for exporting meta data
355 All the metadata in a headline, i.e. the TODO keyword, the
356 priority cookie, and the tags, can now be excluded from
357 export with appropriate options:
359 | Variable | Publishing property | OPTIONS switch |
360 |-------------------------------+---------------------+----------------|
361 | org-export-with-todo-keywords | :todo-keywords | todo: |
362 | org-export-with-tags | :tags | tags: |
363 | org-export-with-priority | :priority | pri: |
365 *** Cut and Paste with hot links from w3m to Org
367 You can now use the key =C-c C-x M-w= in a w3m buffer with
368 HTML content to copy either the region or the entire file in
369 a special way. When you yank this text back into an Org-mode
370 buffer, all links from the w3m buffer will continue to work
373 For this to work you need to load the new file /org-w3m.el./
374 Please check your org-modules variable to make sure that this
377 Thanks for Richard Riley for the idea and to Andy Stewart for
380 *** LOCATION can be inherited for iCalendar export
382 The LOCATION property can now be inherited during iCalendar
383 export if you configure =org-use-property-inheritance= like
386 #+begin_src emacs-lisp
387 (setq org-use-property-inheritance '("LOCATION"))
394 - Keybindings in Remember buffers can be configured
395 - Support for ido completion
396 - New face for date lines in agenda column view
397 - Invisible targets become now anchors in headlines.
398 - New contributed file /org-exp-blocks.el/
399 - New contributed file /org-eval-light.el/
401 - BBDB links may use regular expressions.
402 - Link abbreviations can use %h to insert a url-encoded target value
403 - Improved XHTML compliance
407 *** Keybindings in Remember buffers can be configured
409 The remember buffers created with Org's extensions are in
410 Org-mode, which is nice to prepare snippets that will
411 actually be stored in Org-mode files. However, this makes it
412 hard to configure key bindings without modifying the Org-mode
413 keymap. There is now a minor mode active in these buffers,
414 `org-remember-mode', and its keymap org-remember-mode-map can
415 be used for key bindings. By default, this map only contains
416 the bindings for =C-c C-c= to store the note, and =C-c C-k=
417 to abort it. Use `org-remember-mode-hook' to define your own
420 #+begin_src emacs-lisp
422 'org-remember-mode-hook
424 (define-key org-remember-mode-map
425 "\C-x\C-s" 'org-remember-finalize)))
428 If you wish, you can also use this to free the =C-c C-c=
429 binding (by binding this key to nil in the minor mode map),
430 so that you can use =C-c C-c= again to set tags.
432 This modification is based on a request by Tim O'Callaghan.
434 *** Support for ido completion
436 You can now get the completion interface from /ido.el/ for
437 many of Org's internal completion commands by turning on the
438 variable =org-completion-use-ido=. =ido-mode= must also be
439 active before you can use this.
441 This change is based upon a request by Samuel Wales.
443 *** New face for date lines in agenda column view
445 When column view is active in the agenda, and when you have
446 summarizing properties, the date lines become normal column
447 lines and the separation between different days becomes
448 harder to see. If this bothers you, you can now customize
449 the face =org-agenda-column-dateline=.
451 This is based on a request by George Pearson.
453 *** Invisible targets become now anchors in headlines.
455 These anchors can be used to jump to a directly with an HTML
456 link, just like the =sec-xxx= IDs. For example, the
457 following will make a http link
458 =//domain/path-to-my-file.html#dummy= work:
465 This is based on a request by Matt Lundin.
467 *** New contributed file /org-exp-blocks.el/
469 This new file implements special export behavior of
470 user-defined blocks. The currently supported blocks are
472 - comment :: Comment blocks with author-specific markup
473 - ditaa :: conversion of ASCII art into pretty png files
474 using Stathis Sideris' /ditaa.jar/ program
475 - dot :: creation of graphs in the /dot/ language
476 - R :: Sweave type exporting using the R program
478 For more details and examples, see the file commentary in
481 Kudos to Eric Schulte for this new functionality, after
482 /org-plot.el/ already his second major contribution. Thanks
483 to Stathis for this excellent program, and for allowing us to
484 bundle it with Org-mode.
486 *** New contributed file /org-eval-light.el/
488 This module gives control over execution Emacs Lisp code
489 blocks included in a file.
491 Thanks to Eric Schulte also for this file.
495 You can now configure Org to understand many links created
496 with the Emacs Planner package, so you can cut text from
497 planner pages and paste them into Org-mode files without
498 having to re-write the links. Among other things, this means
499 that the command =org-open-at-point-global= which follows
500 links not only in Org-mode, but in arbitrary files like
501 source code files etc, will work also with links created by
502 planner. The following customization is needed to make all of
505 #+begin_src emacs-lisp
506 (setq org-link-translation-function
507 'org-translate-link-from-planner)
510 I guess an inverse translator could be written and integrated
513 *** BBDB links may use regular expressions.
515 This did work all along, but only now I have documented it.
517 *** =yank-pop= works again after yanking an outline tree
519 Samuel Wales had noticed that =org-yank= did mess up this
520 functionality. Now you can use =yank-pop= again, the only
521 restriction is that the so-yanked text will not be
522 pro/demoted or folded.
524 *** Link abbreviations can use %h to insert a url-encoded target value
526 Thanks to Steve Purcell for a patch to this effect.
528 *** Improved XHTML compliance
530 Thanks to Sebastian Rose for pushing this.
532 *** Many bug fixes again.
537 - A region of entries can now be refiled with a single command
538 - Fine-tuning the behavior of `org-yank'
539 - Formulas for clocktables
540 - Better implementation of footnotes for HTML export
541 - More languages for HTML export.
545 *** A region of entries can now be refiled with a single command
547 With =transient-make-mode= active (=zmacs-regions= under
548 XEmacs), you can now select a region of entries and refile
549 them all with a single =C-c C-w= command.
551 Thanks to Samuel Wales for this useful proposal.
553 *** Fine-tuning the behavior of =org-yank=
555 The behavior of Org's yanking command has been further
556 fine-tuned in order to avoid some of the small annoyances
559 - Calling =org-yank= with a prefix arg will stop any special
560 treatment and directly pass through to the normal =yank=
561 command. Therefore, you can now force a normal yank with
564 - Subtrees will only be folded after a yank if doing so will
565 now swallow any non-white characters after the yanked text.
566 This is, I think a really important change to make the
567 command work more sanely.
569 *** Formulas for clocktables
571 You can now add formulas to a clock table, either by hand, or
572 with a =:formula= parameter. These formulas can be used to
573 create additional columns with further analysis of the
576 Thanks to Jurgen Defurne for triggering this addition.
578 *** Better implementation of footnotes for HTML export
580 The footnote export in 6.11 really was not good enough. Now
581 it works fine. If you have customized
582 =footnote-section-tag=, make sure that your customization is
583 matched by =footnote-section-tag-regexp=.
585 Thanks to Sebastian Rose for pushing this change.
587 *** More languages for HTML export.
589 More languages are supported during HTML export. This is
590 only relevant for the few special words Org inserts, like
591 "Table of Contents", or "Footnotes". Also the encoding
592 issues with this feature seem to be solved now.
594 Thanks to Sebastian Rose for pushing me to fix the encoding
601 - Yanking subtree with =C-y= now adjusts the tree level
602 - State changes can now be shown in the log mode in the agenda
603 - Footnote in HTML export are now collected at the end of the document
604 - HTML export now validates again as XHTML
605 - The clock can now be resumed after exiting and re-starting Emacs
606 - Clock-related data can be saved and resumed across Emacs sessions
607 - Following file links can now use C-u C-u to force use of an external app
608 - Inserting absolute files names now abbreviates links with "~"
609 - Links to attachment files
610 - Completed repeated tasks listed briefly in agenda
611 - Remove buffers created during publishing are removed
615 *** Yanking subtree with =C-y= now adjusts the tree level
616 When yanking a cut/copied subtree or a series of trees, the
617 normal yank key =C-y= now adjusts the level of the tree to
618 make it fit into the current outline position, without losing
619 its identity, and without swallowing other subtrees.
621 This uses the command =org-past-subtree=. An additional
622 change in that command has been implemented: Normally, this
623 command picks the right outline level from the surrounding
624 *visible* headlines, and uses the smaller one. So if the
625 cursor is between a level 4 and a level 3 headline, the tree
626 will be pasted as level 3. If the cursor is actually *at*
627 the beginning of a headline, the level of that headline will
628 be used. For example, lets say you have a tree like this:
634 ,(2)* Level one again
637 with (1) and (2) indicating possible cursor positions for the
638 insertion. When at (1), the tree will be pasted as level 2.
639 When at (2), it will be pasted as level 1.
641 If you do not want =C-y= to behave like this, configure the
642 variable =org-yank-adjusted-subtrees=.
644 Thanks to Samuel Wales for this idea and a partial implementation.
646 *** State changes can now be shown in the log mode in the agenda
648 If you configure the variable =org-agenda-log-mode-items=,
649 you can now request that all logged state changes be included
650 in the agenda when log mode is active. If you find this too
651 much for normal applications, you can also temporarily
652 request the inclusion of state changes by pressing =C-u l= in
655 This was a request by Hsiu-Khuern Tang.
657 You can also press `C-u C-u l' to get *only* log items in the
658 agenda, withour any timestamps/deadlines etc.
660 *** Footnote in HTML export are now collected at the end of the document
661 Previously, footnotes would be left in the document where
662 they are defined, now they are all collected and put into a
663 special =<div>= at the end of the document.
665 Thanks to Sebastian Rose for this request.
667 *** HTML export now validates again as XHTML.
669 Thanks to Sebastian Rose for pushing this cleanup.
671 *** The clock can now be resumed after exiting and re-starting Emacs
673 If the option =org-clock-in-resume= is t, and the first clock
674 line in an entry is unclosed, clocking into that task resumes
675 the clock from that time.
677 Thanks to James TD Smith for a patch to this effect.
679 *** Clock-related data can be saved and resumed across Emacs sessions
681 The data saved include the contents of =org-clock-history=,
682 and the running clock, if there is one.
684 To use this, you will need to add to your .emacs
686 #+begin_src emacs-lisp
687 (setq org-clock-persist t)
688 (setq org-clock-in-resume t)
689 (org-clock-persistence-insinuate)
692 Thanks to James TD Smith for a patch to this effect.
694 *** Following file links can now use C-u C-u to force use of an external app.
696 So far you could only bypass your setup in `org-file-apps'
697 and force opening a file link in Emacs by using a =C-u= prefix arg
698 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
699 an external application. Which external application depends
700 on your system. On Mac OS X and Windows, =open= is used. On
701 a GNU/Linux system, the mailcap settings are used.
703 This was a proposal by Samuel Wales.
705 *** Inserting absolute files names now abbreviates links with "~".
707 Inserting file links with =C-u C-c C-l= was buggy if the
708 setting of `org-link-file-path-type' was `adaptive' (the
709 default). Absolute file paths were not abbreviated relative
710 to the users home directory. This bug has been fixed.
712 Thanks to Matt Lundin for the report.
714 *** Links to attachment files
716 Even though one of the purposes of entry attachments was to
717 reduce the number of links in an entry, one might still want
718 to have the occasional link to one of those files. You can
719 now use link abbreviations to set up a special link type that
720 points to attachments in the current entry. Note that such
721 links will only work from within the same entry that has the
722 attachment, because the directory path is entry specific.
723 Here is the setup you need:
725 #+begin_src emacs-lisp
726 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
729 After this, a link like this will work
732 [[att:some-attached-file.txt]]
734 This was a proposal by Lindsay Todd.
736 *** Completed repeated tasks listed briefly in agenda
738 When a repeating task, listed in the daily/weekly agenda under
739 today's date, is completed from the agenda, it is listed as
740 DONE in the agenda until the next update happens. After the
741 next update, the task will have disappeared, of course,
742 because the new date is no longer today.
744 *** Remove buffers created during publishing are removed
746 Buffers that are created during publishing are now deleted
747 when the publishing is over. At least I hope it works like this.
753 - Secondary agenda filtering is becoming a killer feature
754 - Setting tags has now its own binding, =C-c C-q=
755 - Todo state changes can trigger tag changes
756 - C-RET will now always insert a new headline, never an item.
757 - Customize org-mouse.el feature set to free up mouse events
758 - New commands for export all the way to PDF (through LaTeX)
759 - Some bug fixed for LaTeX export, more bugs remain.
763 *** Enhancements to secondary agenda filtering
765 This is, I believe, becoming a killer feature. It allows you
766 to define fewer and more general custom agenda commands, and
767 then to do the final narrowing to specific tasks you are
768 looking for very quickly, much faster than calling a new
771 If you have not tries this yet, you should!
773 **** You can now refining the current filter by an additional criterion
774 When filtering an existing agenda view with =/=, you can
775 now narrow down the existing selection by an additional
776 condition. Do do this, use =\= instead of =/= to add the
777 additional criterion. You can also press =+= or =-= after
778 =/= to add a positive or negative condition. A condition
779 can be a TAG, or an effort estimate limit, see below.
781 **** It is now possible to filter for effort estimates
782 This means to filter the agenda for the value of the Effort
783 property. For this you should best set up global allowed
784 values for effort estimates, with
786 #+begin_src emacs-lisp
787 (setq org-global-properties
788 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
791 You may then select effort limits with single keys in the
792 filter. It works like this: After =/= or =\=, first select
793 the operator which you want to use to compare effort
796 : < Select entries with effort smaller than or equal to the limit
797 : > Select entries with effort larger than or equal to the limit
798 : = Select entries with effort equal to the limit
800 After that, you can press a single digit number which is
801 used as an index to the allowed effort estimates.
803 If you do not use digits to fast-select tags, you can even
804 skip the operator, which will then default to
805 `org-agenda-filter-effort-default-operator', which is by
808 Thanks to Manish for the great idea to include fast effort
809 filtering into the agenda filtering process.
811 **** The mode line will show the active filter
812 For example, if there is a filter in place that does select
813 for HOME tags, against EMAIL tags, and for tasks with an
814 estimated effort smaller than 30 minutes, the mode-line with
815 show =+HOME-EMAIL+<0:30=
817 **** The filter now persists when the agenda view is refreshed
818 All normal refresh commands, including those that move the
819 weekly agenda from one week to the next, now keep the
820 current filter in place.
822 You need to press =/ /= to turn off the filter. However,
823 when you run a new agenda command, for example going from
824 the weekly agenda to the TODO list, the filter will be
827 *** Setting tags has now its own binding, =C-c C-q=
829 You can still use =C-c C-c= on a headline, but the new
830 binding should be considered as the main binding for this
831 command. The reasons for this change are:
833 - Using =C-c C-c= for tags is really out of line with other
836 - I hate it in Remember buffers when I try to set tags and I
837 cannot, because =C-c C-c= exits the buffer :-(
839 - =C-c C-q= will also work when the cursor is somewhere down
840 in the entry, it does not have to be on the headline.
842 *** Todo state changes can trigger tag changes
844 The new option =org-todo-state-tags-triggers= can be used to
845 define automatic changes to tags when a TODO state changes.
846 For example, the setting
848 : (setq org-todo-state-tags-triggers
849 : '((done ("Today" . nil) ("NEXT" . nil))
850 : ("WAITING" ("Today" . t))))
852 will make sure that any change to any of the DONE states will
853 remove tags "Today" and "NEXT", while switching to the
854 "WAITING" state will trigger the tag "Today" to be added.
856 I use this mostly to get rid of TODAY and NEXT tags which I
857 apply to select an entry for execution in the near future,
858 which I often prefer to specific time scheduling.
860 *** C-RET will now always insert a new headline, never an item.
861 The new headline is inserted after the current subtree.
863 Thanks to Peter Jones for patches to fine-tune this behavior.
865 *** Customize org-mouse.el feature set
866 There is a new variable =org-mouse-features= which gives you
867 some control about what features of org-mouse you want to
868 use. Turning off some of the feature will free up the
869 corresponding mouse events, or will avoid activating special
870 regions for mouse clicks. By default I have urned off the
871 feature to use drag mouse events to move or promote/demote
872 entries. You can of course turn them back on if you wish.
874 This variable may still change in the future, allowing more
875 fine-grained control.
877 *** New commands for export to PDF
879 This is using LaTeX export, and then processes it to PDF
882 : C-c C-e p process to PDF.
883 : C-c C-e d process to PDF, and open the file.
886 - \usepackage{graphicx} is now part of the standard class
888 - Several bugs fixed, but definitely not all of them :-(
890 *** New option `org-log-state-notes-insert-after-drawers'
892 Set this to =t= if you want state change notes to be inserted
893 after any initial drawers, i.e drawers the immediately follow
894 the headline and the planning line (the one with
895 DEADLINE/SCHEDULED/CLOSED information).
899 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
903 *** =org-file-apps= now uses regular repressions instead of extensions
904 Just like in =auto-mode-alist=, car's in the variable
905 =org-file-apps= that are strings are now interpreted as
906 regular expressions that are matched against a file name. So
907 instead of "txt", you should now write "\\.txt\\'" to make
908 sure the matching is done correctly (even though "txt" will
909 be recognized and still be interpreted as an extension).
911 There is now a shortcut to get many file types visited by
912 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
913 any files that are matched by `auto-mode-alist' will be
916 *** Changes to the attachment system
918 - The default method to attach a file is now to copy it
919 instead of moving it.
920 - You can modify the default method using the variable
921 `org-attach-method'. I believe that most Unix people want
922 to set it to `ln' to create hard links.
923 - The keys =c=, =m=, and =l= specifically select =copy=,
924 =move=, or =link=, respectively, as the attachment method
925 for a file, overruling `org-attach-method'.
926 - To create a new attachment as an Emacs buffer, you have not
927 now use =n= instead of =c=.
928 - The file list is now always retrieved from the directory
929 itself, not from the "Attachments" property. We still
930 keep this property by default, but you can turn it off, by
931 customizing the variable =org-attach-file-list-property=.
935 ** Incompatible changes
937 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
939 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
943 *** The default structure of IDs has changed
945 IDs created by Org have changed a bit:
946 - By default, there is no prefix on the ID. There used to be
947 an "Org" prefix, but I now think this is not necessary.
948 - IDs use only lower-case letters, no upper-case letters
949 anymore. The reason for this is that IDs are now also used
950 as directory names for org-attach, and some systems do not
951 distinguish upper and lower case in the file system.
952 - The ID string derived from the current time is now
953 /reversed/ to become an ID. This assures that the first
954 two letters of the ID change fast, so hat it makes sense to
955 split them off to create subdirectories to balance load.
956 - You can now set the `org-id-method' to `uuidgen' on systems
959 *** =C-c C-a= no longer calls `show-all'
961 The reason for this is that =C-c C-a= is now used for the
962 attachment system. On the rare occasions that this command
963 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
965 *** New attachment system
967 You can now attach files to each node in the outline tree.
968 This works by creating special directories based on the ID of
969 an entry, and storing files in these directories. Org can
970 keep track of changes to the attachments by automatically
971 committing changes to git. See the manual for more
974 Thanks to John Wiegley who contributed this fantastic new
975 concept and wrote org-attach.el to implement it.
977 *** New remember template escapes
979 : %^{prop}p to insert a property
980 : %k the heading of the item currently being clocked
981 : %K a link to the heading of the item currently being clocked
983 Also, when you exit remember with =C-2 C-c C-c=, the item
984 will be filed as a child of the item currently being
985 clocked. So the idea is, if you are working on something and
986 think of a new task related to this or a new note to be
987 added, you can use this to quickly add information to that
990 Thanks to James TD Smith for a patch to this effect.
992 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
994 Thanks to James TD Smith for a patch to this effect.
996 *** New file in contrib: lisp/org-checklist.el
998 This module deals with repeated tasks that have checkbox
1001 Thanks to James TD Smith for this contribution.
1003 *** New in-buffer setting #+STYLE
1005 It can be used to locally set the variable
1006 `org-export-html-style-extra'. Several such lines are
1007 allowed-, they will all be concatenated. For an example on
1008 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1014 - Filtering existing agenda views with respect to a tag
1015 - Editing fixed-width regions with picture or artist mode
1016 - /org-plot.el/ is now part of Org
1017 - Tags can be used to select the export part of a document
1018 - Prefix interpretation when storing remember notes
1019 - Yanking inserts folded subtrees
1020 - Column view capture tables can have formulas, plotting info
1021 - In column view, date stamps can be changed with S-cursor keys
1022 - The note buffer for clocking out now mentions the task
1023 - Sorting entries alphabetically ignores TODO keyword and priority
1024 - Agenda views can sort entries by TODO state
1025 - New face =org-scheduled= for entries scheduled in the future.
1026 - Remember templates for gnus links can use the :to escape.
1027 - The file specification in a remember template may be a function
1028 - Categories in iCalendar export include local tags
1029 - It is possible to define filters for column view
1030 - Disabling integer increment during table Field copy
1031 - Capturing column view is on `C-c C-x i'
1032 - And tons of bugs fixed.
1035 ** Incompatible changes
1037 *** Prefix interpretation when storing remember notes has changed
1039 The prefix argument to the `C-c C-c' command that finishes a
1040 remember process is now interpreted differently:
1042 : C-c C-c Store the note to predefined file and headline
1043 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1044 : in its new location.
1045 : C-1 C-c C-c Select the storage location interactively
1046 : C-0 C-c C-c Re-use the last used location
1048 This was requested by John Wiegley.
1050 *** Capturing column view is now on `C-c C-x i'
1052 The reason for this change was that `C-c C-x r' is also used
1053 as a tty key replacement.
1055 *** Categories in iCalendar export now include local tags
1057 The locally defined tags are now listed as categories when
1058 exporting to iCalendar format. Org's traditional file/tree
1059 category is now the last category in this list. Configure
1060 the variable =org-icalendar-categories= to modify or revert
1063 This was a request by Charles Philip Chan.
1067 *** Secondary filtering of agenda views.
1069 You can now easily and interactively filter an existing
1070 agenda view with respect to a tag. This command is executed
1071 with the =/= key in the agenda. You will be prompted for a
1072 tag selection key, and all entries that do not contain or
1073 inherit the corresponding tag will be hidden. With a prefix
1074 argument, the opposite filter is applied: entries that
1075 do have the tag will be hidden.
1077 This operation only /hides/ lines in the agenda buffer, it
1078 does not remove them. Changing the secondary filtering does
1079 not require a new search and is very fast.
1081 If you press TAB at the tag selection prompt, you will be
1082 switched to a completion interface to select a tag. This is
1083 useful when you want to select a tag that does not have a
1084 direct access character.
1086 A double =/ /= will restore the original agenda view by
1087 unhiding any hidden lines.
1089 This functionality was John Wiegley's idea. It is a simpler
1090 implementation of some of the query-editing features proposed
1091 and implemented some time ago by Christopher League (see the
1092 file contrib/lisp/org-interactive-query.el).
1094 *** Editing fixed-width regions with picture or artist mode
1096 The command @<code>C-c '@</code> (that is =C-c= followed by a
1097 single quote) can now also be used to switch to a special
1098 editing mode for fixed-width sections. The default mode is
1099 =artist-mode= which allows you to create ASCII drawings.
1101 It works like this: Enter the editing mode with
1102 @<code>C-c '@</code>. An indirect buffer will be created and
1103 narrowed to the fixed-width region. Edit the drawing, and
1104 press @<code>C-c '@</code> again to exit.
1106 Lines in a fixed-width region should be preceded by a colon
1107 followed by at least one space. These will be removed during
1108 editing, and then added back when you exit the editing mode.
1110 Using the command in an empty line will create a new
1113 This new feature arose from a discussion involving Scott
1114 Otterson, Sebastian Rose and Will Henney.
1116 *** /org-plot.el/ is now part of Org.
1118 You can run it by simple calling org-plot/gnuplot.
1119 Documentation is not yet included with Org, please refer to
1120 http://github.com/eschulte/org-plot/tree/master until we have
1121 moved the docs into Org or Worg.
1123 Thanks to Eric Schulte for this great contribution.
1125 *** Tags can be used to select the export part of a document
1127 You may now use tags to select parts of a document for
1128 inclusion into the export, and to exclude other parts. This
1129 behavior is governed by two new variables:
1130 =org-export-select-tags= and =org-export-exclude-tags=.
1131 These default to =("export")= and =("noexport")=, but can be
1132 changed, even to include a list of several tags.
1134 Org first checks if any of the /select/ tags is present in
1135 the buffer. If yes, all trees that do not carry one of these
1136 tags will be excluded. If a selected tree is a subtree, the
1137 heading hierarchy above it will also be selected for export,
1138 but not the text below those headings. If none of the select
1139 tags is found anywhere in the buffer, the whole buffer will
1140 be selected for export. Finally, all subtrees that are
1141 marked by any of the /exclude/ tags will be removed from the
1144 You may set these tags with in-buffer options
1145 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1147 I love this feature. Thanks to Richard G Riley for coming
1150 *** Prefix interpretation when storing remember notes
1152 The prefix argument to the `C-c C-c' command that finishes a
1153 remember process is now interpreted differently:
1155 : C-c C-c Store the note to predefined file and headline
1156 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1157 : in its new location.
1158 : C-1 C-c C-c Select the storage location interactively
1159 : C-0 C-c C-c Re-use the last used location
1161 This was requested by John Wiegley.
1163 *** Yanking inserts folded subtrees
1165 If the kill is a subtree or a sequence of subtrees, yanking
1166 them with =C-y= will leave all the subtrees in a folded
1167 state. This basically means, that kill and yank are now
1168 much more useful in moving stuff around in your outline. If
1169 you do not like this, customize the variable
1170 =org-yank-folded-subtrees=.
1172 Right now, I am only binding =C-y= to this new function,
1173 should I modify all bindings of yank? Do we need to amend
1176 This feature was requested by John Wiegley.
1178 *** Column view capture tables can have formulas, plotting info
1180 If you attach formulas and plotting instructions to a table
1181 capturing column view, these extra lines will now survive an
1182 update of the column view capture, and any formulas will be
1183 re-applied to the captured table. This works by keeping any
1184 continuous block of comments before and after the actual
1187 *** In column view, date stamps can be changed with S-cursor keys
1189 If a property value is a time stamp, S-left and S-right can
1190 now be used to shift this date around while in column view.
1192 This was a request by Chris Randle.
1194 *** The note buffer for clocking out now mentions the task
1196 This was a request by Peter Frings.
1198 *** Sorting entries alphabetically ignores TODO keyword and priority
1200 Numerical and alphanumerical sorting now skips any TODO
1201 keyword or priority cookie when constructing the comparison
1202 string. This was a request by Wanrong Lin.
1204 *** Agenda views can sort entries by TODO state
1206 You can now define a sorting strategy for agenda entries that
1207 does look at the TODO state of the entries. Sorting by TODO
1208 entry does first separate the non-done from the done states.
1209 Within each class, the entries are sorted not alphabetically,
1210 but in definition order. So if you have a sequence of TODO
1211 entries defined, the entries will be sorted according to the
1212 position of the keyword in this sequence.
1214 This follows an idea and sample implementation by Christian
1217 *** New face =org-scheduled= for entries scheduled in the future.
1219 This was a request by Richard G Riley.
1221 *** Remember templates for gnus links can now use the :to escape.
1223 Thanks to Tommy Lindgren for a patch to this effect.
1224 *** The file specification in a remember template may now be a function
1226 Thanks to Gregory Sullivan for a patch to this effect.
1228 *** Categories in iCalendar export now include local tags
1230 The locally defined tags are now listed as categories when
1231 exporting to iCalendar format. Org's traditional file/tree
1232 category is now the last category in this list. Configure
1233 the variable =org-icalendar-categories= to modify or revert
1236 This was a request by Charles Philip Chan.
1238 *** It is now possible to define filters for column view
1240 The filter can modify the value that will be displayed in a
1241 column, for example it can cut out a part of a time stamp.
1242 For more information, look at the variable
1243 =org-columns-modify-value-for-display-function=.
1245 *** Disabling integer increment during table field copy
1247 Prefix arg 0 to S-RET does the trick.
1249 This was a request by Chris Randle.
1254 For older Changes, see [[file:Changes_old.org]]