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
17 Cleanup of many small bugs, and one new feature.
21 *** References to last table row with special names
23 Fields in the last row of a table can now be referenced with
24 $LR1, $LR2, etc. These references can appear both on the
25 left hand side and right hand side of a formula.
29 This version reverses the introduction of @0 as a reference to
30 the last rwo in a table, because of a conflict with the use of
31 @0 for the current row.
36 - All known LaTeX export issues fixed
37 - Captions and attributes for figures and tables.
38 - Better implementation for entry IDs
39 - Spreadsheet references to the last table line.
40 - Old syntax for link attributes abandoned
42 ** Incompatible changes
43 *** Old syntax for link attributes abandoned
45 There used to be a syntax for setting link attributes for
46 HTML export by enclosing the attributes into double braces
47 and adding them to the link itself, like
50 [[./img/a.jpg{{alt="an image"}}] ]
53 This syntax is not longer supported, use instead
56 ,#+ATTR_HTML: alt="an image"
62 *** All known LaTeX export issues fixed
64 All the remaining issues with the LaTeX exporter have hopefully
65 been addressed in this release. In particular, this covers
66 quoting of special characters in tables and problems with
67 exporting files where the headline is in the first line, or with
70 *** Captions and attributes for figures and tables.
72 Tables, and Hyperlinks that represent inlined images, can now be
73 equipped with additional information that will be used during
74 export. The information will be taken from the following special
75 lines in the buffer and apply to the first following table or
78 - #+CAPTION: :: The caption of the image or table. This string
79 should be processed according to the export backend, but
82 - #+LABEL: :: A label to identify the figure/table for cross
83 references. For HTML export, this string will become the
84 ID for the ~<div class="figure">~ element that encapsulates
85 the image tag and the caption. For LaTeX export, this
86 string will be used as the argument of a ~\label{...}~
87 macro. These labels will be available for internal links
88 like ~[[label][Table] ]~.
90 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
91 added as attributes into the ~<img...>~ tag. This string
92 will not be processed, so it should have immediately the
95 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
97 For /images/, this string is directly inserted into
98 the optional argument of the ~\includegraphics[...]{file}~
99 command, to specify scaling, clipping and other options.
100 This string will not be processed, so it should have
101 immediately the right format, like =width=5cm,angle=90=.\\
102 For /tables/, this can currently contain the keyword
103 =longtable=, to request typesetting of the table using the
104 longtable package, which automatically distributes the table
105 over several pages if needed. Also, the attributes line may
106 contain an alignment string for the tabular environment, like
107 =longtable,align=l|lrl=
109 For LaTeX export, if either a caption or a label is given, the element
110 will be exported as a float, i.e. wrapped into a figure or table
113 *** Better implementation for entry IDs
115 Unique identifiers for entries can now be used more efficiently.
116 Internally, a hash array has replaced the alist used so far to
117 keep track of the files in which an ID is defined. This makes it
118 quite fast to find an entry by ID.
120 There is a new link type which looks like this:
123 id:GLOBALLY-UNIQUE-IDENTIFIER
126 This link points to a specific entry. When you move the entry to
127 a different file, for example if you move it to an archive
128 file, the link will continue to work.
130 The file /org-id.el/ contains an API that can be used to write
131 code using these identifiers, including creating IDs and finding
132 them wherever they are.
134 Org has its own method to create unique identifiers, but if the system
135 has /uuidgen/ command installed (Mac's and Linux systems generally
136 do), it will be used by default (a change compared to the earlier
137 implmentation, where you explicitdly had to opt for uuidgen). You can
138 also select the method by hand, using the variable =org-id-method=.
140 If the ID system ever gets confused about where a certain ID is, it
141 initiates a global scan of all agenda files with associated archives,
142 all files previously known containing any IDs, and all currently
143 visited Org-mode files to rebuild the hash. You can also initiate
144 this by hand: =M-x org-id-update-id-locations=. Running this command
145 will also dump into the =*Messages*= buffer information about any
146 duplicate IDs. These should not exist, and Org will never /make/ the
147 same ID twice, but if you /copy/ an entry with its properties,
148 duplicate IDs will inevitably be produced. Unfortunately, this is
149 unavoidable in a plain text system that allows you to edit the text in
150 arbitrary ways, and a portion of care on your side is needed to keep
153 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
154 This is also a change from previous versions where the file was
155 =~/.org=id-locations=. Therefore, you can remove this old file
156 if you have it. I am not sure what will happen if the =.emacs.d=
157 directory does not exists in your setup, but in modern Emacsen, I
158 believe it should exist. If you do not want to use IDs across
159 files, you can avoid the overhead with tracking IDs by
160 customizing the variable =org-id-track-globally=. IDs can then
161 still be used for links inside a single file.
163 IDs will also be used when you create a new link to an Org-mode
164 buffer. If you use =org-store-link= (normally at =C-c l=) inside
165 en entry in an Org-mode buffer, and ID property will be created
166 if it does not exist, and the stored link will be an =id:= link.
167 If you prefer the much less secure linking to headline text, you
168 can configure the variable =org-link-to-org-use-id=. The default
169 setting for this variable is =create-if-interactive=, meaning
170 that an ID will be created when you store a link interactively,
171 but not if you happen to be in an Org-mode file while you create
172 a remember note (which usually has a link to the place where you
173 were when starting remember).
175 *** Spreadsheet references to the last table line.
177 You may now use =@0= to reference the last dataline in a table
178 in a stable way. This is useful in particular for automatically
179 generated tables like the ones using /org-collector.el/ by Eric
185 - New relative timer to support timed notes
186 - Special faces can be set for individual tags
187 - The agenda shows now all tags, including inherited ones.
188 - Exclude some tags from inheritance.
189 - More special values for time comparisons in property searches
190 - Control for exporting meta data
191 - Cut and Paste with hot links from w3m to Org
192 - LOCATION can be inherited for iCalendar export
193 - Relative row references crossing hlines now throw an error
195 ** Incompatible Changes
197 *** Relative row references crossing hlines now throw an error
199 Relative row references in tables look like this: "@-4" which
200 means the forth row above this one. These row references are
201 not allowed to cross horizontal separator lines (hlines). So
202 far, when a row reference violates this policy, Org would
203 silently choose the field just next to the hline.
205 Tassilo Horn pointed out that this kind of hidden magic is
206 actually confusing and may cause incorrect formulas, and I do
207 agree. Therefore, trying to cross a hline with a relative
208 reference will now throw an error.
210 If you need the old behavior, customize the variable
211 `org-table-error-on-row-ref-crossing-hline'.
215 *** New relative timer to support timed notes
217 Org now supports taking timed notes, useful for example while
218 watching a video, or during a meeting which is also recorded.
221 Insert a relative time into the buffer. The first time
222 you use this, the timer will be started. When called
223 with a prefix argument, the timer is reset to 0.
226 Insert a description list item with the current relative
227 time. With a prefix argument, first reset the timer to 0.
230 Once the time list has been initiated, you can also use the
231 normal item-creating command to insert the next timer item.
234 Reset the timer without inserting anything into the buffer.
235 By default, the timer is reset to 0. When called with a
236 =C-u= prefix, reset the timer to specific starting
237 offset. The user is prompted for the offset, with a
238 default taken from a timer string at point, if any, So this
239 can be used to restart taking notes after a break in the
240 process. When called with a double prefix argument
241 =C-c C-u=, change all timer strings in the active
242 region by a certain amount. This can be used to fix timer
243 strings if the timer was not started at exactly the right
246 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
247 contributions to this idea.
249 *** Special faces can be set for individual tags
251 You may now use the variable =org-tag-faces= to define the
252 face used for specific tags, much in the same way as you can
253 do for TODO keywords.
255 Thanks to Samuel Wales for this proposal.
257 *** The agenda shows now all tags, including inherited ones.
259 This request has come up often, most recently it was
260 formulated by Tassilo Horn.
262 If you prefer the old behavior of only showing the local
263 tags, customize the variable =org-agenda-show-inherited-tags=.
265 *** Exclude some tags from inheritance.
267 So far, the only way to select tags for inheritance was to
268 allow it for all tags, or to do a positive selection using
269 one of the more complex settings for
270 `org-use-tag-inheritance'. It may actually be better to
271 allow inheritance for all but a few tags, which was difficult
272 to achieve with this methodology.
274 A new option, `org-tags-exclude-from-inheritance', allows to
275 specify an exclusion list for inherited tags.
277 *** More special values for time comparisons in property searches
279 In addition to =<now>=, =<today>=, =<yesterday>=, and
280 =<tomorrow>=, there are more special values accepted now in
281 time comparisons in property searches: You may use strings
282 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
283 week, month, and year, respectively
285 Thanks to Linday Todd for this proposal.
287 *** Control for exporting meta data
289 All the metadata in a headline, i.e. the TODO keyword, the
290 priority cookie, and the tags, can now be excluded from
291 export with appropriate options:
293 | Variable | Publishing property | OPTIONS switch |
294 |-------------------------------+---------------------+----------------|
295 | org-export-with-todo-keywords | :todo-keywords | todo: |
296 | org-export-with-tags | :tags | tags: |
297 | org-export-with-priority | :priority | pri: |
299 *** Cut and Paste with hot links from w3m to Org
301 You can now use the key =C-c C-x M-w= in a w3m buffer with
302 HTML content to copy either the region or the entire file in
303 a special way. When you yank this text back into an Org-mode
304 buffer, all links from the w3m buffer will continue to work
307 For this to work you need to load the new file /org-w3m.el./
308 Please check your org-modules variable to make sure that this
311 Thanks for Richard Riley for the idea and to Andy Stewart for
314 *** LOCATION can be inherited for iCalendar export
316 The LOCATION property can now be inherited during iCalendar
317 export if you configure =org-use-property-inheritance= like
320 #+begin_src emacs-lisp
321 (setq org-use-property-inheritance '("LOCATION"))
328 - Keybindings in Remember buffers can be configured
329 - Support for ido completion
330 - New face for date lines in agenda column view
331 - Invisible targets become now anchors in headlines.
332 - New contributed file /org-exp-blocks.el/
333 - New contributed file /org-eval-light.el/
335 - BBDB links may use regular expressions.
336 - Link abbreviations can use %h to insert a url-encoded target value
337 - Improved XHTML compliance
341 *** Keybindings in Remember buffers can be configured
343 The remember buffers created with Org's extensions are in
344 Org-mode, which is nice to prepare snippets that will
345 actually be stored in Org-mode files. However, this makes it
346 hard to configure key bindings without modifying the Org-mode
347 keymap. There is now a minor mode active in these buffers,
348 `org-remember-mode', and its keymap org-remember-mode-map can
349 be used for key bindings. By default, this map only contains
350 the bindings for =C-c C-c= to store the note, and =C-c C-k=
351 to abort it. Use `org-remember-mode-hook' to define your own
354 #+begin_src emacs-lisp
356 'org-remember-mode-hook
358 (define-key org-remember-mode-map
359 "\C-x\C-s" 'org-remember-finalize)))
362 If you wish, you can also use this to free the =C-c C-c=
363 binding (by binding this key to nil in the minor mode map),
364 so that you can use =C-c C-c= again to set tags.
366 This modification is based on a request by Tim O'Callaghan.
368 *** Support for ido completion
370 You can now get the completion interface from /ido.el/ for
371 many of Org's internal completion commands by turning on the
372 variable =org-completion-use-ido=. =ido-mode= must also be
373 active before you can use this.
375 This change is based upon a request by Samuel Wales.
377 *** New face for date lines in agenda column view
379 When column view is active in the agenda, and when you have
380 summarizing properties, the date lines become normal column
381 lines and the separation between different days becomes
382 harder to see. If this bothers you, you can now customize
383 the face =org-agenda-column-dateline=.
385 This is based on a request by George Pearson.
387 *** Invisible targets become now anchors in headlines.
389 These anchors can be used to jump to a directly with an HTML
390 link, just like the =sec-xxx= IDs. For example, the
391 following will make a http link
392 =//domain/path-to-my-file.html#dummy= work:
399 This is based on a request by Matt Lundin.
401 *** New contributed file /org-exp-blocks.el/
403 This new file implements special export behavior of
404 user-defined blocks. The currently supported blocks are
406 - comment :: Comment blocks with author-specific markup
407 - ditaa :: conversion of ASCII art into pretty png files
408 using Stathis Sideris' /ditaa.jar/ program
409 - dot :: creation of graphs in the /dot/ language
410 - R :: Sweave type exporting using the R program
412 For more details and examples, see the file commentary in
415 Kudos to Eric Schulte for this new functionality, after
416 /org-plot.el/ already his second major contribution. Thanks
417 to Stathis for this excellent program, and for allowing us to
418 bundle it with Org-mode.
420 *** New contributed file /org-eval-light.el/
422 This module gives control over execution Emacs Lisp code
423 blocks included in a file.
425 Thanks to Eric Schulte also for this file.
429 You can now configure Org to understand many links created
430 with the Emacs Planner package, so you can cut text from
431 planner pages and paste them into Org-mode files without
432 having to re-write the links. Among other things, this means
433 that the command =org-open-at-point-global= which follows
434 links not only in Org-mode, but in arbitrary files like
435 source code files etc, will work also with links created by
436 planner. The following customization is needed to make all of
439 #+begin_src emacs-lisp
440 (setq org-link-translation-function
441 'org-translate-link-from-planner)
444 I guess an inverse translator could be written and integrated
447 *** BBDB links may use regular expressions.
449 This did work all along, but only now I have documented it.
451 *** =yank-pop= works again after yanking an outline tree
453 Samuel Wales had noticed that =org-yank= did mess up this
454 functionality. Now you can use =yank-pop= again, the only
455 restriction is that the so-yanked text will not be
456 pro/demoted or folded.
458 *** Link abbreviations can use %h to insert a url-encoded target value
460 Thanks to Steve Purcell for a patch to this effect.
462 *** Improved XHTML compliance
464 Thanks to Sebastian Rose for pushing this.
466 *** Many bug fixes again.
471 - A region of entries can now be refiled with a single command
472 - Fine-tuning the behavior of `org-yank'
473 - Formulas for clocktables
474 - Better implementation of footnotes for HTML export
475 - More languages for HTML export.
479 *** A region of entries can now be refiled with a single command
481 With =transient-make-mode= active (=zmacs-regions= under
482 XEmacs), you can now select a region of entries and refile
483 them all with a single =C-c C-w= command.
485 Thanks to Samuel Wales for this useful proposal.
487 *** Fine-tuning the behavior of =org-yank=
489 The behavior of Org's yanking command has been further
490 fine-tuned in order to avoid some of the small annoyances
493 - Calling =org-yank= with a prefix arg will stop any special
494 treatment and directly pass through to the normal =yank=
495 command. Therefore, you can now force a normal yank with
498 - Subtrees will only be folded after a yank if doing so will
499 now swallow any non-white characters after the yanked text.
500 This is, I think a really important change to make the
501 command work more sanely.
503 *** Formulas for clocktables
505 You can now add formulas to a clock table, either by hand, or
506 with a =:formula= parameter. These formulas can be used to
507 create additional columns with further analysis of the
510 Thanks to Jurgen Defurne for triggering this addition.
512 *** Better implementation of footnotes for HTML export
514 The footnote export in 6.11 really was not good enough. Now
515 it works fine. If you have customized
516 =footnote-section-tag=, make sure that your customization is
517 matched by =footnote-section-tag-regexp=.
519 Thanks to Sebastian Rose for pushing this change.
521 *** More languages for HTML export.
523 More languages are supported during HTML export. This is
524 only relevant for the few special words Org inserts, like
525 "Table of Contents", or "Footnotes". Also the encoding
526 issues with this feature seem to be solved now.
528 Thanks to Sebastian Rose for pushing me to fix the encoding
535 - Yanking subtree with =C-y= now adjusts the tree level
536 - State changes can now be shown in the log mode in the agenda
537 - Footnote in HTML export are now collected at the end of the document
538 - HTML export now validates again as XHTML
539 - The clock can now be resumed after exiting and re-starting Emacs
540 - Clock-related data can be saved and resumed across Emacs sessions
541 - Following file links can now use C-u C-u to force use of an external app
542 - Inserting absolute files names now abbreviates links with "~"
543 - Links to attachment files
544 - Completed repeated tasks listed briefly in agenda
545 - Remove buffers created during publishing are removed
549 *** Yanking subtree with =C-y= now adjusts the tree level
550 When yanking a cut/copied subtree or a series of trees, the
551 normal yank key =C-y= now adjusts the level of the tree to
552 make it fit into the current outline position, without losing
553 its identity, and without swallowing other subtrees.
555 This uses the command =org-past-subtree=. An additional
556 change in that command has been implemented: Normally, this
557 command picks the right outline level from the surrounding
558 *visible* headlines, and uses the smaller one. So if the
559 cursor is between a level 4 and a level 3 headline, the tree
560 will be pasted as level 3. If the cursor is actually *at*
561 the beginning of a headline, the level of that headline will
562 be used. For example, lets say you have a tree like this:
568 ,(2)* Level one again
571 with (1) and (2) indicating possible cursor positions for the
572 insertion. When at (1), the tree will be pasted as level 2.
573 When at (2), it will be pasted as level 1.
575 If you do not want =C-y= to behave like this, configure the
576 variable =org-yank-adjusted-subtrees=.
578 Thanks to Samuel Wales for this idea and a partial implementation.
580 *** State changes can now be shown in the log mode in the agenda
582 If you configure the variable =org-agenda-log-mode-items=,
583 you can now request that all logged state changes be included
584 in the agenda when log mode is active. If you find this too
585 much for normal applications, you can also temporarily
586 request the inclusion of state changes by pressing =C-u l= in
589 This was a request by Hsiu-Khuern Tang.
591 You can also press `C-u C-u l' to get *only* log items in the
592 agenda, withour any timestamps/deadlines etc.
594 *** Footnote in HTML export are now collected at the end of the document
595 Previously, footnotes would be left in the document where
596 they are defined, now they are all collected and put into a
597 special =<div>= at the end of the document.
599 Thanks to Sebastian Rose for this request.
601 *** HTML export now validates again as XHTML.
603 Thanks to Sebastian Rose for pushing this cleanup.
605 *** The clock can now be resumed after exiting and re-starting Emacs
607 If the option =org-clock-in-resume= is t, and the first clock
608 line in an entry is unclosed, clocking into that task resumes
609 the clock from that time.
611 Thanks to James TD Smith for a patch to this effect.
613 *** Clock-related data can be saved and resumed across Emacs sessions
615 The data saved include the contents of =org-clock-history=,
616 and the running clock, if there is one.
618 To use this, you will need to add to your .emacs
620 #+begin_src emacs-lisp
621 (setq org-clock-persist t)
622 (setq org-clock-in-resume t)
623 (org-clock-persistence-insinuate)
626 Thanks to James TD Smith for a patch to this effect.
628 *** Following file links can now use C-u C-u to force use of an external app.
630 So far you could only bypass your setup in `org-file-apps'
631 and force opening a file link in Emacs by using a =C-u= prefix arg
632 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
633 an external application. Which external application depends
634 on your system. On Mac OS X and Windows, =open= is used. On
635 a GNU/Linux system, the mailcap settings are used.
637 This was a proposal by Samuel Wales.
639 *** Inserting absolute files names now abbreviates links with "~".
641 Inserting file links with =C-u C-c C-l= was buggy if the
642 setting of `org-link-file-path-type' was `adaptive' (the
643 default). Absolute file paths were not abbreviated relative
644 to the users home directory. This bug has been fixed.
646 Thanks to Matt Lundin for the report.
648 *** Links to attachment files
650 Even though one of the purposes of entry attachments was to
651 reduce the number of links in an entry, one might still want
652 to have the occasional link to one of those files. You can
653 now use link abbreviations to set up a special link type that
654 points to attachments in the current entry. Note that such
655 links will only work from within the same entry that has the
656 attachment, because the directory path is entry specific.
657 Here is the setup you need:
659 #+begin_src emacs-lisp
660 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
663 After this, a link like this will work
665 : [[att:some-attached-file.txt]]
667 This was a proposal by Lindsay Todd.
669 *** Completed repeated tasks listed briefly in agenda
671 When a repeating task, listed in the daily/weekly agenda under
672 today's date, is completed from the agenda, it is listed as
673 DONE in the agenda until the next update happens. After the
674 next update, the task will have disappeared, of course,
675 because the new date is no longer today.
677 *** Remove buffers created during publishing are removed
679 Buffers that are created during publishing are now deleted
680 when the publishing is over. At least I hope it works like this.
686 - Secondary agenda filtering is becoming a killer feature
687 - Setting tags has now its own binding, =C-c C-q=
688 - Todo state changes can trigger tag changes
689 - C-RET will now always insert a new headline, never an item.
690 - Customize org-mouse.el feature set to free up mouse events
691 - New commands for export all the way to PDF (through LaTeX)
692 - Some bug fixed for LaTeX export, more bugs remain.
696 *** Enhancements to secondary agenda filtering
698 This is, I believe, becoming a killer feature. It allows you
699 to define fewer and more general custom agenda commands, and
700 then to do the final narrowing to specific tasks you are
701 looking for very quickly, much faster than calling a new
704 If you have not tries this yet, you should!
706 **** You can now refining the current filter by an additional criterion
707 When filtering an existing agenda view with =/=, you can
708 now narrow down the existing selection by an additional
709 condition. Do do this, use =\= instead of =/= to add the
710 additional criterion. You can also press =+= or =-= after
711 =/= to add a positive or negative condition. A condition
712 can be a TAG, or an effort estimate limit, see below.
714 **** It is now possible to filter for effort estimates
715 This means to filter the agenda for the value of the Effort
716 property. For this you should best set up global allowed
717 values for effort estimates, with
719 #+begin_src emacs-lisp
720 (setq org-global-properties
721 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
724 You may then select effort limits with single keys in the
725 filter. It works like this: After =/= or =\=, first select
726 the operator which you want to use to compare effort
729 : < Select entries with effort smaller than or equal to the limit
730 : > Select entries with effort larger than or equal to the limit
731 : = Select entries with effort equal to the limit
733 After that, you can press a single digit number which is
734 used as an index to the allowed effort estimates.
736 If you do not use digits to fast-select tags, you can even
737 skip the operator, which will then default to
738 `org-agenda-filter-effort-default-operator', which is by
741 Thanks to Manish for the great idea to include fast effort
742 filtering into the agenda filtering process.
744 **** The mode line will show the active filter
745 For example, if there is a filter in place that does select
746 for HOME tags, against EMAIL tags, and for tasks with an
747 estimated effort smaller than 30 minutes, the mode-line with
748 show =+HOME-EMAIL+<0:30=
750 **** The filter now persists when the agenda view is refreshed
751 All normal refresh commands, including those that move the
752 weekly agenda from one week to the next, now keep the
753 current filter in place.
755 You need to press =/ /= to turn off the filter. However,
756 when you run a new agenda command, for example going from
757 the weekly agenda to the TODO list, the filter will be
760 *** Setting tags has now its own binding, =C-c C-q=
762 You can still use =C-c C-c= on a headline, but the new
763 binding should be considered as the main binding for this
764 command. The reasons for this change are:
766 - Using =C-c C-c= for tags is really out of line with other
769 - I hate it in Remember buffers when I try to set tags and I
770 cannot, because =C-c C-c= exits the buffer :-(
772 - =C-c C-q= will also work when the cursor is somewhere down
773 in the entry, it does not have to be on the headline.
775 *** Todo state changes can trigger tag changes
777 The new option =org-todo-state-tags-triggers= can be used to
778 define automatic changes to tags when a TODO state changes.
779 For example, the setting
781 : (setq org-todo-state-tags-triggers
782 : '((done ("Today" . nil) ("NEXT" . nil))
783 : ("WAITING" ("Today" . t))))
785 will make sure that any change to any of the DONE states will
786 remove tags "Today" and "NEXT", while switching to the
787 "WAITING" state will trigger the tag "Today" to be added.
789 I use this mostly to get rid of TODAY and NEXT tags which I
790 apply to select an entry for execution in the near future,
791 which I often prefer to specific time scheduling.
793 *** C-RET will now always insert a new headline, never an item.
794 The new headline is inserted after the current subtree.
796 Thanks to Peter Jones for patches to fine-tune this behavior.
798 *** Customize org-mouse.el feature set
799 There is a new variable =org-mouse-features= which gives you
800 some control about what features of org-mouse you want to
801 use. Turning off some of the feature will free up the
802 corresponding mouse events, or will avoid activating special
803 regions for mouse clicks. By default I have urned off the
804 feature to use drag mouse events to move or promote/demote
805 entries. You can of course turn them back on if you wish.
807 This variable may still change in the future, allowing more
808 fine-grained control.
810 *** New commands for export to PDF
812 This is using LaTeX export, and then processes it to PDF
815 : C-c C-e p process to PDF.
816 : C-c C-e d process to PDF, and open the file.
819 - \usepackage{graphicx} is now part of the standard class
821 - Several bugs fixed, but definitely not all of them :-(
823 *** New option `org-log-state-notes-insert-after-drawers'
825 Set this to =t= if you want state change notes to be inserted
826 after any initial drawers, i.e drawers the immediately follow
827 the headline and the planning line (the one with
828 DEADLINE/SCHEDULED/CLOSED information).
832 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
836 *** =org-file-apps= now uses regular repressions instead of extensions
837 Just like in =auto-mode-alist=, car's in the variable
838 =org-file-apps= that are strings are now interpreted as
839 regular expressions that are matched against a file name. So
840 instead of "txt", you should now write "\\.txt\\'" to make
841 sure the matching is done correctly (even though "txt" will
842 be recognized and still be interpreted as an extension).
844 There is now a shortcut to get many file types visited by
845 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
846 any files that are matched by `auto-mode-alist' will be
849 *** Changes to the attachment system
851 - The default method to attach a file is now to copy it
852 instead of moving it.
853 - You can modify the default method using the variable
854 `org-attach-method'. I believe that most Unix people want
855 to set it to `ln' to create hard links.
856 - The keys =c=, =m=, and =l= specifically select =copy=,
857 =move=, or =link=, respectively, as the attachment method
858 for a file, overruling `org-attach-method'.
859 - To create a new attachment as an Emacs buffer, you have not
860 now use =n= instead of =c=.
861 - The file list is now always retrieved from the directory
862 itself, not from the "Attachments" property. We still
863 keep this property by default, but you can turn it off, by
864 customizing the variable =org-attach-file-list-property=.
868 ** Incompatible changes
870 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
872 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
876 *** The default structure of IDs has changed
878 IDs created by Org have changed a bit:
879 - By default, there is no prefix on the ID. There used to be
880 an "Org" prefix, but I now think this is not necessary.
881 - IDs use only lower-case letters, no upper-case letters
882 anymore. The reason for this is that IDs are now also used
883 as directory names for org-attach, and some systems do not
884 distinguish upper and lower case in the file system.
885 - The ID string derived from the current time is now
886 /reversed/ to become an ID. This assures that the first
887 two letters of the ID change fast, so hat it makes sense to
888 split them off to create subdirectories to balance load.
889 - You can now set the `org-id-method' to `uuidgen' on systems
892 *** =C-c C-a= no longer calls `show-all'
894 The reason for this is that =C-c C-a= is now used for the
895 attachment system. On the rare occasions that this command
896 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
898 *** New attachment system
900 You can now attach files to each node in the outline tree.
901 This works by creating special directories based on the ID of
902 an entry, and storing files in these directories. Org can
903 keep track of changes to the attachments by automatically
904 committing changes to git. See the manual for more
907 Thanks to John Wiegley who contributed this fantastic new
908 concept and wrote org-attach.el to implement it.
910 *** New remember template escapes
912 : %^{prop}p to insert a property
913 : %k the heading of the item currently being clocked
914 : %K a link to the heading of the item currently being clocked
916 Also, when you exit remember with =C-2 C-c C-c=, the item
917 will be filed as a child of the item currently being
918 clocked. So the idea is, if you are working on something and
919 think of a new task related to this or a new note to be
920 added, you can use this to quickly add information to that
923 Thanks to James TD Smith for a patch to this effect.
925 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
927 Thanks to James TD Smith for a patch to this effect.
929 *** New file in contrib: lisp/org-checklist.el
931 This module deals with repeated tasks that have checkbox
934 Thanks to James TD Smith for this contribution.
936 *** New in-buffer setting #+STYLE
938 It can be used to locally set the variable
939 `org-export-html-style-extra'. Several such lines are
940 allowed-, they will all be concatenated. For an example on
941 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
947 - Filtering existing agenda views with respect to a tag
948 - Editing fixed-width regions with picture or artist mode
949 - /org-plot.el/ is now part of Org
950 - Tags can be used to select the export part of a document
951 - Prefix interpretation when storing remember notes
952 - Yanking inserts folded subtrees
953 - Column view capture tables can have formulas, plotting info
954 - In column view, date stamps can be changed with S-cursor keys
955 - The note buffer for clocking out now mentions the task
956 - Sorting entries alphabetically ignores TODO keyword and priority
957 - Agenda views can sort entries by TODO state
958 - New face =org-scheduled= for entries scheduled in the future.
959 - Remember templates for gnus links can use the :to escape.
960 - The file specification in a remember template may be a function
961 - Categories in iCalendar export include local tags
962 - It is possible to define filters for column view
963 - Disabling integer increment during table Field copy
964 - Capturing column view is on `C-c C-x i'
965 - And tons of bugs fixed.
968 ** Incompatible changes
970 *** Prefix interpretation when storing remember notes has changed
972 The prefix argument to the `C-c C-c' command that finishes a
973 remember process is now interpreted differently:
975 : C-c C-c Store the note to predefined file and headline
976 : C-u C-c C-c Like C-c C-c, but immediately visit the note
977 : in its new location.
978 : C-1 C-c C-c Select the storage location interactively
979 : C-0 C-c C-c Re-use the last used location
981 This was requested by John Wiegley.
983 *** Capturing column view is now on `C-c C-x i'
985 The reason for this change was that `C-c C-x r' is also used
986 as a tty key replacement.
988 *** Categories in iCalendar export now include local tags
990 The locally defined tags are now listed as categories when
991 exporting to iCalendar format. Org's traditional file/tree
992 category is now the last category in this list. Configure
993 the variable =org-icalendar-categories= to modify or revert
996 This was a request by Charles Philip Chan.
1000 *** Secondary filtering of agenda views.
1002 You can now easily and interactively filter an existing
1003 agenda view with respect to a tag. This command is executed
1004 with the =/= key in the agenda. You will be prompted for a
1005 tag selection key, and all entries that do not contain or
1006 inherit the corresponding tag will be hidden. With a prefix
1007 argument, the opposite filter is applied: entries that
1008 do have the tag will be hidden.
1010 This operation only /hides/ lines in the agenda buffer, it
1011 does not remove them. Changing the secondary filtering does
1012 not require a new search and is very fast.
1014 If you press TAB at the tag selection prompt, you will be
1015 switched to a completion interface to select a tag. This is
1016 useful when you want to select a tag that does not have a
1017 direct access character.
1019 A double =/ /= will restore the original agenda view by
1020 unhiding any hidden lines.
1022 This functionality was John Wiegley's idea. It is a simpler
1023 implementation of some of the query-editing features proposed
1024 and implemented some time ago by Christopher League (see the
1025 file contrib/lisp/org-interactive-query.el).
1027 *** Editing fixed-width regions with picture or artist mode
1029 The command @<code>C-c '@</code> (that is =C-c= followed by a
1030 single quote) can now also be used to switch to a special
1031 editing mode for fixed-width sections. The default mode is
1032 =artist-mode= which allows you to create ASCII drawings.
1034 It works like this: Enter the editing mode with
1035 @<code>C-c '@</code>. An indirect buffer will be created and
1036 narrowed to the fixed-width region. Edit the drawing, and
1037 press @<code>C-c '@</code> again to exit.
1039 Lines in a fixed-width region should be preceded by a colon
1040 followed by at least one space. These will be removed during
1041 editing, and then added back when you exit the editing mode.
1043 Using the command in an empty line will create a new
1046 This new feature arose from a discussion involving Scott
1047 Otterson, Sebastian Rose and Will Henney.
1049 *** /org-plot.el/ is now part of Org.
1051 You can run it by simple calling org-plot/gnuplot.
1052 Documentation is not yet included with Org, please refer to
1053 http://github.com/eschulte/org-plot/tree/master until we have
1054 moved the docs into Org or Worg.
1056 Thanks to Eric Schulte for this great contribution.
1058 *** Tags can be used to select the export part of a document
1060 You may now use tags to select parts of a document for
1061 inclusion into the export, and to exclude other parts. This
1062 behavior is governed by two new variables:
1063 =org-export-select-tags= and =org-export-exclude-tags=.
1064 These default to =("export")= and =("noexport")=, but can be
1065 changed, even to include a list of several tags.
1067 Org first checks if any of the /select/ tags is present in
1068 the buffer. If yes, all trees that do not carry one of these
1069 tags will be excluded. If a selected tree is a subtree, the
1070 heading hierarchy above it will also be selected for export,
1071 but not the text below those headings. If none of the select
1072 tags is found anywhere in the buffer, the whole buffer will
1073 be selected for export. Finally, all subtrees that are
1074 marked by any of the /exclude/ tags will be removed from the
1077 You may set these tags with in-buffer options
1078 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1080 I love this feature. Thanks to Richard G Riley for coming
1083 *** Prefix interpretation when storing remember notes
1085 The prefix argument to the `C-c C-c' command that finishes a
1086 remember process is now interpreted differently:
1088 : C-c C-c Store the note to predefined file and headline
1089 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1090 : in its new location.
1091 : C-1 C-c C-c Select the storage location interactively
1092 : C-0 C-c C-c Re-use the last used location
1094 This was requested by John Wiegley.
1096 *** Yanking inserts folded subtrees
1098 If the kill is a subtree or a sequence of subtrees, yanking
1099 them with =C-y= will leave all the subtrees in a folded
1100 state. This basically means, that kill and yank are now
1101 much more useful in moving stuff around in your outline. If
1102 you do not like this, customize the variable
1103 =org-yank-folded-subtrees=.
1105 Right now, I am only binding =C-y= to this new function,
1106 should I modify all bindings of yank? Do we need to amend
1109 This feature was requested by John Wiegley.
1111 *** Column view capture tables can have formulas, plotting info
1113 If you attach formulas and plotting instructions to a table
1114 capturing column view, these extra lines will now survive an
1115 update of the column view capture, and any formulas will be
1116 re-applied to the captured table. This works by keeping any
1117 continuous block of comments before and after the actual
1120 *** In column view, date stamps can be changed with S-cursor keys
1122 If a property value is a time stamp, S-left and S-right can
1123 now be used to shift this date around while in column view.
1125 This was a request by Chris Randle.
1127 *** The note buffer for clocking out now mentions the task
1129 This was a request by Peter Frings.
1131 *** Sorting entries alphabetically ignores TODO keyword and priority
1133 Numerical and alphanumerical sorting now skips any TODO
1134 keyword or priority cookie when constructing the comparison
1135 string. This was a request by Wanrong Lin.
1137 *** Agenda views can sort entries by TODO state
1139 You can now define a sorting strategy for agenda entries that
1140 does look at the TODO state of the entries. Sorting by TODO
1141 entry does first separate the non-done from the done states.
1142 Within each class, the entries are sorted not alphabetically,
1143 but in definition order. So if you have a sequence of TODO
1144 entries defined, the entries will be sorted according to the
1145 position of the keyword in this sequence.
1147 This follows an idea and sample implementation by Christian
1150 *** New face =org-scheduled= for entries scheduled in the future.
1152 This was a request by Richard G Riley.
1154 *** Remember templates for gnus links can now use the :to escape.
1156 Thanks to Tommy Lindgren for a patch to this effect.
1157 *** The file specification in a remember template may now be a function
1159 Thanks to Gregory Sullivan for a patch to this effect.
1161 *** Categories in iCalendar export now include local tags
1163 The locally defined tags are now listed as categories when
1164 exporting to iCalendar format. Org's traditional file/tree
1165 category is now the last category in this list. Configure
1166 the variable =org-icalendar-categories= to modify or revert
1169 This was a request by Charles Philip Chan.
1171 *** It is now possible to define filters for column view
1173 The filter can modify the value that will be displayed in a
1174 column, for example it can cut out a part of a time stamp.
1175 For more information, look at the variable
1176 =org-columns-modify-value-for-display-function=.
1178 *** Disabling integer increment during table field copy
1180 Prefix arg 0 to S-RET does the trick.
1182 This was a request by Chris Randle.
1187 For older Changes, see [[file:Changes_old.org]]