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
18 This version reverses the introduction of @0 as a reference to
19 the last rwo in a table, because of a conflict with the use of
20 @0 for the current row.
25 - All known LaTeX export issues fixed
26 - Captions and attributes for figures and tables.
27 - Better implementation for entry IDs
28 - Spreadsheet references to the last table line.
29 - Old syntax for link attributes abandoned
31 ** Incompatible changes
32 *** Old syntax for link attributes abandoned
34 There used to be a syntax for setting link attributes for
35 HTML export by enclosing the attributes into double braces
36 and adding them to the link itself, like
39 [[./img/a.jpg{{alt="an image"}}] ]
42 This syntax is not longer supported, use instead
45 ,#+ATTR_HTML: alt="an image"
51 *** All known LaTeX export issues fixed
53 All the remaining issues with the LaTeX exporter have hopefully
54 been addressed in this release. In particular, this covers
55 quoting of special characters in tables and problems with
56 exporting files where the headline is in the first line, or with
59 *** Captions and attributes for figures and tables.
61 Tables, and Hyperlinks that represent inlined images, can now be
62 equipped with additional information that will be used during
63 export. The information will be taken from the following special
64 lines in the buffer and apply to the first following table or
67 - #+CAPTION: :: The caption of the image or table. This string
68 should be processed according to the export backend, but
71 - #+LABEL: :: A label to identify the figure/table for cross
72 references. For HTML export, this string will become the
73 ID for the ~<div class="figure">~ element that encapsulates
74 the image tag and the caption. For LaTeX export, this
75 string will be used as the argument of a ~\label{...}~
76 macro. These labels will be available for internal links
77 like ~[[label][Table] ]~.
79 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
80 added as attributes into the ~<img...>~ tag. This string
81 will not be processed, so it should have immediately the
84 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
86 For /images/, this string is directly inserted into
87 the optional argument of the ~\includegraphics[...]{file}~
88 command, to specify scaling, clipping and other options.
89 This string will not be processed, so it should have
90 immediately the right format, like =width=5cm,angle=90=.\\
91 For /tables/, this can currently contain the keyword
92 =longtable=, to request typesetting of the table using the
93 longtable package, which automatically distributes the table
94 over several pages if needed. Also, the attributes line may
95 contain an alignment string for the tabular environment, like
96 =longtable,align=l|lrl=
98 For LaTeX export, if either a caption or a label is given, the element
99 will be exported as a float, i.e. wrapped into a figure or table
102 *** Better implementation for entry IDs
104 Unique identifiers for entries can now be used more efficiently.
105 Internally, a hash array has replaced the alist used so far to
106 keep track of the files in which an ID is defined. This makes it
107 quite fast to find an entry by ID.
109 There is a new link type which looks like this:
112 id:GLOBALLY-UNIQUE-IDENTIFIER
115 This link points to a specific entry. When you move the entry to
116 a different file, for example if you move it to an archive
117 file, the link will continue to work.
119 The file /org-id.el/ contains an API that can be used to write
120 code using these identifiers, including creating IDs and finding
121 them wherever they are.
123 Org has its own method to create unique identifiers, but if the system
124 has /uuidgen/ command installed (Mac's and Linux systems generally
125 do), it will be used by default (a change compared to the earlier
126 implmentation, where you explicitdly had to opt for uuidgen). You can
127 also select the method by hand, using the variable =org-id-method=.
129 If the ID system ever gets confused about where a certain ID is, it
130 initiates a global scan of all agenda files with associated archives,
131 all files previously known containing any IDs, and all currently
132 visited Org-mode files to rebuild the hash. You can also initiate
133 this by hand: =M-x org-id-update-id-locations=. Running this command
134 will also dump into the =*Messages*= buffer information about any
135 duplicate IDs. These should not exist, and Org will never /make/ the
136 same ID twice, but if you /copy/ an entry with its properties,
137 duplicate IDs will inevitably be produced. Unfortunately, this is
138 unavoidable in a plain text system that allows you to edit the text in
139 arbitrary ways, and a portion of care on your side is needed to keep
142 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
143 This is also a change from previous versions where the file was
144 =~/.org=id-locations=. Therefore, you can remove this old file
145 if you have it. I am not sure what will happen if the =.emacs.d=
146 directory does not exists in your setup, but in modern Emacsen, I
147 believe it should exist. If you do not want to use IDs across
148 files, you can avoid the overhead with tracking IDs by
149 customizing the variable =org-id-track-globally=. IDs can then
150 still be used for links inside a single file.
152 IDs will also be used when you create a new link to an Org-mode
153 buffer. If you use =org-store-link= (normally at =C-c l=) inside
154 en entry in an Org-mode buffer, and ID property will be created
155 if it does not exist, and the stored link will be an =id:= link.
156 If you prefer the much less secure linking to headline text, you
157 can configure the variable =org-link-to-org-use-id=. The default
158 setting for this variable is =create-if-interactive=, meaning
159 that an ID will be created when you store a link interactively,
160 but not if you happen to be in an Org-mode file while you create
161 a remember note (which usually has a link to the place where you
162 were when starting remember).
164 *** Spreadsheet references to the last table line.
166 You may now use =@0= to reference the last dataline in a table
167 in a stable way. This is useful in particular for automatically
168 generated tables like the ones using /org-collector.el/ by Eric
174 - New relative timer to support timed notes
175 - Special faces can be set for individual tags
176 - The agenda shows now all tags, including inherited ones.
177 - Exclude some tags from inheritance.
178 - More special values for time comparisons in property searches
179 - Control for exporting meta data
180 - Cut and Paste with hot links from w3m to Org
181 - LOCATION can be inherited for iCalendar export
182 - Relative row references crossing hlines now throw an error
184 ** Incompatible Changes
186 *** Relative row references crossing hlines now throw an error
188 Relative row references in tables look like this: "@-4" which
189 means the forth row above this one. These row references are
190 not allowed to cross horizontal separator lines (hlines). So
191 far, when a row reference violates this policy, Org would
192 silently choose the field just next to the hline.
194 Tassilo Horn pointed out that this kind of hidden magic is
195 actually confusing and may cause incorrect formulas, and I do
196 agree. Therefore, trying to cross a hline with a relative
197 reference will now throw an error.
199 If you need the old behavior, customize the variable
200 `org-table-error-on-row-ref-crossing-hline'.
204 *** New relative timer to support timed notes
206 Org now supports taking timed notes, useful for example while
207 watching a video, or during a meeting which is also recorded.
210 Insert a relative time into the buffer. The first time
211 you use this, the timer will be started. When called
212 with a prefix argument, the timer is reset to 0.
215 Insert a description list item with the current relative
216 time. With a prefix argument, first reset the timer to 0.
219 Once the time list has been initiated, you can also use the
220 normal item-creating command to insert the next timer item.
223 Reset the timer without inserting anything into the buffer.
224 By default, the timer is reset to 0. When called with a
225 =C-u= prefix, reset the timer to specific starting
226 offset. The user is prompted for the offset, with a
227 default taken from a timer string at point, if any, So this
228 can be used to restart taking notes after a break in the
229 process. When called with a double prefix argument
230 =C-c C-u=, change all timer strings in the active
231 region by a certain amount. This can be used to fix timer
232 strings if the timer was not started at exactly the right
235 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
236 contributions to this idea.
238 *** Special faces can be set for individual tags
240 You may now use the variable =org-tag-faces= to define the
241 face used for specific tags, much in the same way as you can
242 do for TODO keywords.
244 Thanks to Samuel Wales for this proposal.
246 *** The agenda shows now all tags, including inherited ones.
248 This request has come up often, most recently it was
249 formulated by Tassilo Horn.
251 If you prefer the old behavior of only showing the local
252 tags, customize the variable =org-agenda-show-inherited-tags=.
254 *** Exclude some tags from inheritance.
256 So far, the only way to select tags for inheritance was to
257 allow it for all tags, or to do a positive selection using
258 one of the more complex settings for
259 `org-use-tag-inheritance'. It may actually be better to
260 allow inheritance for all but a few tags, which was difficult
261 to achieve with this methodology.
263 A new option, `org-tags-exclude-from-inheritance', allows to
264 specify an exclusion list for inherited tags.
266 *** More special values for time comparisons in property searches
268 In addition to =<now>=, =<today>=, =<yesterday>=, and
269 =<tomorrow>=, there are more special values accepted now in
270 time comparisons in property searches: You may use strings
271 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
272 week, month, and year, respectively
274 Thanks to Linday Todd for this proposal.
276 *** Control for exporting meta data
278 All the metadata in a headline, i.e. the TODO keyword, the
279 priority cookie, and the tags, can now be excluded from
280 export with appropriate options:
282 | Variable | Publishing property | OPTIONS switch |
283 |-------------------------------+---------------------+----------------|
284 | org-export-with-todo-keywords | :todo-keywords | todo: |
285 | org-export-with-tags | :tags | tags: |
286 | org-export-with-priority | :priority | pri: |
288 *** Cut and Paste with hot links from w3m to Org
290 You can now use the key =C-c C-x M-w= in a w3m buffer with
291 HTML content to copy either the region or the entire file in
292 a special way. When you yank this text back into an Org-mode
293 buffer, all links from the w3m buffer will continue to work
296 For this to work you need to load the new file /org-w3m.el./
297 Please check your org-modules variable to make sure that this
300 Thanks for Richard Riley for the idea and to Andy Stewart for
303 *** LOCATION can be inherited for iCalendar export
305 The LOCATION property can now be inherited during iCalendar
306 export if you configure =org-use-property-inheritance= like
309 #+begin_src emacs-lisp
310 (setq org-use-property-inheritance '("LOCATION"))
317 - Keybindings in Remember buffers can be configured
318 - Support for ido completion
319 - New face for date lines in agenda column view
320 - Invisible targets become now anchors in headlines.
321 - New contributed file /org-exp-blocks.el/
322 - New contributed file /org-eval-light.el/
324 - BBDB links may use regular expressions.
325 - Link abbreviations can use %h to insert a url-encoded target value
326 - Improved XHTML compliance
330 *** Keybindings in Remember buffers can be configured
332 The remember buffers created with Org's extensions are in
333 Org-mode, which is nice to prepare snippets that will
334 actually be stored in Org-mode files. However, this makes it
335 hard to configure key bindings without modifying the Org-mode
336 keymap. There is now a minor mode active in these buffers,
337 `org-remember-mode', and its keymap org-remember-mode-map can
338 be used for key bindings. By default, this map only contains
339 the bindings for =C-c C-c= to store the note, and =C-c C-k=
340 to abort it. Use `org-remember-mode-hook' to define your own
343 #+begin_src emacs-lisp
345 'org-remember-mode-hook
347 (define-key org-remember-mode-map
348 "\C-x\C-s" 'org-remember-finalize)))
351 If you wish, you can also use this to free the =C-c C-c=
352 binding (by binding this key to nil in the minor mode map),
353 so that you can use =C-c C-c= again to set tags.
355 This modification is based on a request by Tim O'Callaghan.
357 *** Support for ido completion
359 You can now get the completion interface from /ido.el/ for
360 many of Org's internal completion commands by turning on the
361 variable =org-completion-use-ido=. =ido-mode= must also be
362 active before you can use this.
364 This change is based upon a request by Samuel Wales.
366 *** New face for date lines in agenda column view
368 When column view is active in the agenda, and when you have
369 summarizing properties, the date lines become normal column
370 lines and the separation between different days becomes
371 harder to see. If this bothers you, you can now customize
372 the face =org-agenda-column-dateline=.
374 This is based on a request by George Pearson.
376 *** Invisible targets become now anchors in headlines.
378 These anchors can be used to jump to a directly with an HTML
379 link, just like the =sec-xxx= IDs. For example, the
380 following will make a http link
381 =//domain/path-to-my-file.html#dummy= work:
388 This is based on a request by Matt Lundin.
390 *** New contributed file /org-exp-blocks.el/
392 This new file implements special export behavior of
393 user-defined blocks. The currently supported blocks are
395 - comment :: Comment blocks with author-specific markup
396 - ditaa :: conversion of ASCII art into pretty png files
397 using Stathis Sideris' /ditaa.jar/ program
398 - dot :: creation of graphs in the /dot/ language
399 - R :: Sweave type exporting using the R program
401 For more details and examples, see the file commentary in
404 Kudos to Eric Schulte for this new functionality, after
405 /org-plot.el/ already his second major contribution. Thanks
406 to Stathis for this excellent program, and for allowing us to
407 bundle it with Org-mode.
409 *** New contributed file /org-eval-light.el/
411 This module gives control over execution Emacs Lisp code
412 blocks included in a file.
414 Thanks to Eric Schulte also for this file.
418 You can now configure Org to understand many links created
419 with the Emacs Planner package, so you can cut text from
420 planner pages and paste them into Org-mode files without
421 having to re-write the links. Among other things, this means
422 that the command =org-open-at-point-global= which follows
423 links not only in Org-mode, but in arbitrary files like
424 source code files etc, will work also with links created by
425 planner. The following customization is needed to make all of
428 #+begin_src emacs-lisp
429 (setq org-link-translation-function
430 'org-translate-link-from-planner)
433 I guess an inverse translator could be written and integrated
436 *** BBDB links may use regular expressions.
438 This did work all along, but only now I have documented it.
440 *** =yank-pop= works again after yanking an outline tree
442 Samuel Wales had noticed that =org-yank= did mess up this
443 functionality. Now you can use =yank-pop= again, the only
444 restriction is that the so-yanked text will not be
445 pro/demoted or folded.
447 *** Link abbreviations can use %h to insert a url-encoded target value
449 Thanks to Steve Purcell for a patch to this effect.
451 *** Improved XHTML compliance
453 Thanks to Sebastian Rose for pushing this.
455 *** Many bug fixes again.
460 - A region of entries can now be refiled with a single command
461 - Fine-tuning the behavior of `org-yank'
462 - Formulas for clocktables
463 - Better implementation of footnotes for HTML export
464 - More languages for HTML export.
468 *** A region of entries can now be refiled with a single command
470 With =transient-make-mode= active (=zmacs-regions= under
471 XEmacs), you can now select a region of entries and refile
472 them all with a single =C-c C-w= command.
474 Thanks to Samuel Wales for this useful proposal.
476 *** Fine-tuning the behavior of =org-yank=
478 The behavior of Org's yanking command has been further
479 fine-tuned in order to avoid some of the small annoyances
482 - Calling =org-yank= with a prefix arg will stop any special
483 treatment and directly pass through to the normal =yank=
484 command. Therefore, you can now force a normal yank with
487 - Subtrees will only be folded after a yank if doing so will
488 now swallow any non-white characters after the yanked text.
489 This is, I think a really important change to make the
490 command work more sanely.
492 *** Formulas for clocktables
494 You can now add formulas to a clock table, either by hand, or
495 with a =:formula= parameter. These formulas can be used to
496 create additional columns with further analysis of the
499 Thanks to Jurgen Defurne for triggering this addition.
501 *** Better implementation of footnotes for HTML export
503 The footnote export in 6.11 really was not good enough. Now
504 it works fine. If you have customized
505 =footnote-section-tag=, make sure that your customization is
506 matched by =footnote-section-tag-regexp=.
508 Thanks to Sebastian Rose for pushing this change.
510 *** More languages for HTML export.
512 More languages are supported during HTML export. This is
513 only relevant for the few special words Org inserts, like
514 "Table of Contents", or "Footnotes". Also the encoding
515 issues with this feature seem to be solved now.
517 Thanks to Sebastian Rose for pushing me to fix the encoding
524 - Yanking subtree with =C-y= now adjusts the tree level
525 - State changes can now be shown in the log mode in the agenda
526 - Footnote in HTML export are now collected at the end of the document
527 - HTML export now validates again as XHTML
528 - The clock can now be resumed after exiting and re-starting Emacs
529 - Clock-related data can be saved and resumed across Emacs sessions
530 - Following file links can now use C-u C-u to force use of an external app
531 - Inserting absolute files names now abbreviates links with "~"
532 - Links to attachment files
533 - Completed repeated tasks listed briefly in agenda
534 - Remove buffers created during publishing are removed
538 *** Yanking subtree with =C-y= now adjusts the tree level
539 When yanking a cut/copied subtree or a series of trees, the
540 normal yank key =C-y= now adjusts the level of the tree to
541 make it fit into the current outline position, without losing
542 its identity, and without swallowing other subtrees.
544 This uses the command =org-past-subtree=. An additional
545 change in that command has been implemented: Normally, this
546 command picks the right outline level from the surrounding
547 *visible* headlines, and uses the smaller one. So if the
548 cursor is between a level 4 and a level 3 headline, the tree
549 will be pasted as level 3. If the cursor is actually *at*
550 the beginning of a headline, the level of that headline will
551 be used. For example, lets say you have a tree like this:
557 ,(2)* Level one again
560 with (1) and (2) indicating possible cursor positions for the
561 insertion. When at (1), the tree will be pasted as level 2.
562 When at (2), it will be pasted as level 1.
564 If you do not want =C-y= to behave like this, configure the
565 variable =org-yank-adjusted-subtrees=.
567 Thanks to Samuel Wales for this idea and a partial implementation.
569 *** State changes can now be shown in the log mode in the agenda
571 If you configure the variable =org-agenda-log-mode-items=,
572 you can now request that all logged state changes be included
573 in the agenda when log mode is active. If you find this too
574 much for normal applications, you can also temporarily
575 request the inclusion of state changes by pressing =C-u l= in
578 This was a request by Hsiu-Khuern Tang.
580 You can also press `C-u C-u l' to get *only* log items in the
581 agenda, withour any timestamps/deadlines etc.
583 *** Footnote in HTML export are now collected at the end of the document
584 Previously, footnotes would be left in the document where
585 they are defined, now they are all collected and put into a
586 special =<div>= at the end of the document.
588 Thanks to Sebastian Rose for this request.
590 *** HTML export now validates again as XHTML.
592 Thanks to Sebastian Rose for pushing this cleanup.
594 *** The clock can now be resumed after exiting and re-starting Emacs
596 If the option =org-clock-in-resume= is t, and the first clock
597 line in an entry is unclosed, clocking into that task resumes
598 the clock from that time.
600 Thanks to James TD Smith for a patch to this effect.
602 *** Clock-related data can be saved and resumed across Emacs sessions
604 The data saved include the contents of =org-clock-history=,
605 and the running clock, if there is one.
607 To use this, you will need to add to your .emacs
609 #+begin_src emacs-lisp
610 (setq org-clock-persist t)
611 (setq org-clock-in-resume t)
612 (org-clock-persistence-insinuate)
615 Thanks to James TD Smith for a patch to this effect.
617 *** Following file links can now use C-u C-u to force use of an external app.
619 So far you could only bypass your setup in `org-file-apps'
620 and force opening a file link in Emacs by using a =C-u= prefix arg
621 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
622 an external application. Which external application depends
623 on your system. On Mac OS X and Windows, =open= is used. On
624 a GNU/Linux system, the mailcap settings are used.
626 This was a proposal by Samuel Wales.
628 *** Inserting absolute files names now abbreviates links with "~".
630 Inserting file links with =C-u C-c C-l= was buggy if the
631 setting of `org-link-file-path-type' was `adaptive' (the
632 default). Absolute file paths were not abbreviated relative
633 to the users home directory. This bug has been fixed.
635 Thanks to Matt Lundin for the report.
637 *** Links to attachment files
639 Even though one of the purposes of entry attachments was to
640 reduce the number of links in an entry, one might still want
641 to have the occasional link to one of those files. You can
642 now use link abbreviations to set up a special link type that
643 points to attachments in the current entry. Note that such
644 links will only work from within the same entry that has the
645 attachment, because the directory path is entry specific.
646 Here is the setup you need:
648 #+begin_src emacs-lisp
649 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
652 After this, a link like this will work
654 : [[att:some-attached-file.txt]]
656 This was a proposal by Lindsay Todd.
658 *** Completed repeated tasks listed briefly in agenda
660 When a repeating task, listed in the daily/weekly agenda under
661 today's date, is completed from the agenda, it is listed as
662 DONE in the agenda until the next update happens. After the
663 next update, the task will have disappeared, of course,
664 because the new date is no longer today.
666 *** Remove buffers created during publishing are removed
668 Buffers that are created during publishing are now deleted
669 when the publishing is over. At least I hope it works like this.
675 - Secondary agenda filtering is becoming a killer feature
676 - Setting tags has now its own binding, =C-c C-q=
677 - Todo state changes can trigger tag changes
678 - C-RET will now always insert a new headline, never an item.
679 - Customize org-mouse.el feature set to free up mouse events
680 - New commands for export all the way to PDF (through LaTeX)
681 - Some bug fixed for LaTeX export, more bugs remain.
685 *** Enhancements to secondary agenda filtering
687 This is, I believe, becoming a killer feature. It allows you
688 to define fewer and more general custom agenda commands, and
689 then to do the final narrowing to specific tasks you are
690 looking for very quickly, much faster than calling a new
693 If you have not tries this yet, you should!
695 **** You can now refining the current filter by an additional criterion
696 When filtering an existing agenda view with =/=, you can
697 now narrow down the existing selection by an additional
698 condition. Do do this, use =\= instead of =/= to add the
699 additional criterion. You can also press =+= or =-= after
700 =/= to add a positive or negative condition. A condition
701 can be a TAG, or an effort estimate limit, see below.
703 **** It is now possible to filter for effort estimates
704 This means to filter the agenda for the value of the Effort
705 property. For this you should best set up global allowed
706 values for effort estimates, with
708 #+begin_src emacs-lisp
709 (setq org-global-properties
710 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
713 You may then select effort limits with single keys in the
714 filter. It works like this: After =/= or =\=, first select
715 the operator which you want to use to compare effort
718 : < Select entries with effort smaller than or equal to the limit
719 : > Select entries with effort larger than or equal to the limit
720 : = Select entries with effort equal to the limit
722 After that, you can press a single digit number which is
723 used as an index to the allowed effort estimates.
725 If you do not use digits to fast-select tags, you can even
726 skip the operator, which will then default to
727 `org-agenda-filter-effort-default-operator', which is by
730 Thanks to Manish for the great idea to include fast effort
731 filtering into the agenda filtering process.
733 **** The mode line will show the active filter
734 For example, if there is a filter in place that does select
735 for HOME tags, against EMAIL tags, and for tasks with an
736 estimated effort smaller than 30 minutes, the mode-line with
737 show =+HOME-EMAIL+<0:30=
739 **** The filter now persists when the agenda view is refreshed
740 All normal refresh commands, including those that move the
741 weekly agenda from one week to the next, now keep the
742 current filter in place.
744 You need to press =/ /= to turn off the filter. However,
745 when you run a new agenda command, for example going from
746 the weekly agenda to the TODO list, the filter will be
749 *** Setting tags has now its own binding, =C-c C-q=
751 You can still use =C-c C-c= on a headline, but the new
752 binding should be considered as the main binding for this
753 command. The reasons for this change are:
755 - Using =C-c C-c= for tags is really out of line with other
758 - I hate it in Remember buffers when I try to set tags and I
759 cannot, because =C-c C-c= exits the buffer :-(
761 - =C-c C-q= will also work when the cursor is somewhere down
762 in the entry, it does not have to be on the headline.
764 *** Todo state changes can trigger tag changes
766 The new option =org-todo-state-tags-triggers= can be used to
767 define automatic changes to tags when a TODO state changes.
768 For example, the setting
770 : (setq org-todo-state-tags-triggers
771 : '((done ("Today" . nil) ("NEXT" . nil))
772 : ("WAITING" ("Today" . t))))
774 will make sure that any change to any of the DONE states will
775 remove tags "Today" and "NEXT", while switching to the
776 "WAITING" state will trigger the tag "Today" to be added.
778 I use this mostly to get rid of TODAY and NEXT tags which I
779 apply to select an entry for execution in the near future,
780 which I often prefer to specific time scheduling.
782 *** C-RET will now always insert a new headline, never an item.
783 The new headline is inserted after the current subtree.
785 Thanks to Peter Jones for patches to fine-tune this behavior.
787 *** Customize org-mouse.el feature set
788 There is a new variable =org-mouse-features= which gives you
789 some control about what features of org-mouse you want to
790 use. Turning off some of the feature will free up the
791 corresponding mouse events, or will avoid activating special
792 regions for mouse clicks. By default I have urned off the
793 feature to use drag mouse events to move or promote/demote
794 entries. You can of course turn them back on if you wish.
796 This variable may still change in the future, allowing more
797 fine-grained control.
799 *** New commands for export to PDF
801 This is using LaTeX export, and then processes it to PDF
804 : C-c C-e p process to PDF.
805 : C-c C-e d process to PDF, and open the file.
808 - \usepackage{graphicx} is now part of the standard class
810 - Several bugs fixed, but definitely not all of them :-(
812 *** New option `org-log-state-notes-insert-after-drawers'
814 Set this to =t= if you want state change notes to be inserted
815 after any initial drawers, i.e drawers the immediately follow
816 the headline and the planning line (the one with
817 DEADLINE/SCHEDULED/CLOSED information).
821 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
825 *** =org-file-apps= now uses regular repressions instead of extensions
826 Just like in =auto-mode-alist=, car's in the variable
827 =org-file-apps= that are strings are now interpreted as
828 regular expressions that are matched against a file name. So
829 instead of "txt", you should now write "\\.txt\\'" to make
830 sure the matching is done correctly (even though "txt" will
831 be recognized and still be interpreted as an extension).
833 There is now a shortcut to get many file types visited by
834 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
835 any files that are matched by `auto-mode-alist' will be
838 *** Changes to the attachment system
840 - The default method to attach a file is now to copy it
841 instead of moving it.
842 - You can modify the default method using the variable
843 `org-attach-method'. I believe that most Unix people want
844 to set it to `ln' to create hard links.
845 - The keys =c=, =m=, and =l= specifically select =copy=,
846 =move=, or =link=, respectively, as the attachment method
847 for a file, overruling `org-attach-method'.
848 - To create a new attachment as an Emacs buffer, you have not
849 now use =n= instead of =c=.
850 - The file list is now always retrieved from the directory
851 itself, not from the "Attachments" property. We still
852 keep this property by default, but you can turn it off, by
853 customizing the variable =org-attach-file-list-property=.
857 ** Incompatible changes
859 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
861 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
865 *** The default structure of IDs has changed
867 IDs created by Org have changed a bit:
868 - By default, there is no prefix on the ID. There used to be
869 an "Org" prefix, but I now think this is not necessary.
870 - IDs use only lower-case letters, no upper-case letters
871 anymore. The reason for this is that IDs are now also used
872 as directory names for org-attach, and some systems do not
873 distinguish upper and lower case in the file system.
874 - The ID string derived from the current time is now
875 /reversed/ to become an ID. This assures that the first
876 two letters of the ID change fast, so hat it makes sense to
877 split them off to create subdirectories to balance load.
878 - You can now set the `org-id-method' to `uuidgen' on systems
881 *** =C-c C-a= no longer calls `show-all'
883 The reason for this is that =C-c C-a= is now used for the
884 attachment system. On the rare occasions that this command
885 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
887 *** New attachment system
889 You can now attach files to each node in the outline tree.
890 This works by creating special directories based on the ID of
891 an entry, and storing files in these directories. Org can
892 keep track of changes to the attachments by automatically
893 committing changes to git. See the manual for more
896 Thanks to John Wiegley who contributed this fantastic new
897 concept and wrote org-attach.el to implement it.
899 *** New remember template escapes
901 : %^{prop}p to insert a property
902 : %k the heading of the item currently being clocked
903 : %K a link to the heading of the item currently being clocked
905 Also, when you exit remember with =C-2 C-c C-c=, the item
906 will be filed as a child of the item currently being
907 clocked. So the idea is, if you are working on something and
908 think of a new task related to this or a new note to be
909 added, you can use this to quickly add information to that
912 Thanks to James TD Smith for a patch to this effect.
914 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
916 Thanks to James TD Smith for a patch to this effect.
918 *** New file in contrib: lisp/org-checklist.el
920 This module deals with repeated tasks that have checkbox
923 Thanks to James TD Smith for this contribution.
925 *** New in-buffer setting #+STYLE
927 It can be used to locally set the variable
928 `org-export-html-style-extra'. Several such lines are
929 allowed-, they will all be concatenated. For an example on
930 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
936 - Filtering existing agenda views with respect to a tag
937 - Editing fixed-width regions with picture or artist mode
938 - /org-plot.el/ is now part of Org
939 - Tags can be used to select the export part of a document
940 - Prefix interpretation when storing remember notes
941 - Yanking inserts folded subtrees
942 - Column view capture tables can have formulas, plotting info
943 - In column view, date stamps can be changed with S-cursor keys
944 - The note buffer for clocking out now mentions the task
945 - Sorting entries alphabetically ignores TODO keyword and priority
946 - Agenda views can sort entries by TODO state
947 - New face =org-scheduled= for entries scheduled in the future.
948 - Remember templates for gnus links can use the :to escape.
949 - The file specification in a remember template may be a function
950 - Categories in iCalendar export include local tags
951 - It is possible to define filters for column view
952 - Disabling integer increment during table Field copy
953 - Capturing column view is on `C-c C-x i'
954 - And tons of bugs fixed.
957 ** Incompatible changes
959 *** Prefix interpretation when storing remember notes has changed
961 The prefix argument to the `C-c C-c' command that finishes a
962 remember process is now interpreted differently:
964 : C-c C-c Store the note to predefined file and headline
965 : C-u C-c C-c Like C-c C-c, but immediately visit the note
966 : in its new location.
967 : C-1 C-c C-c Select the storage location interactively
968 : C-0 C-c C-c Re-use the last used location
970 This was requested by John Wiegley.
972 *** Capturing column view is now on `C-c C-x i'
974 The reason for this change was that `C-c C-x r' is also used
975 as a tty key replacement.
977 *** Categories in iCalendar export now include local tags
979 The locally defined tags are now listed as categories when
980 exporting to iCalendar format. Org's traditional file/tree
981 category is now the last category in this list. Configure
982 the variable =org-icalendar-categories= to modify or revert
985 This was a request by Charles Philip Chan.
989 *** Secondary filtering of agenda views.
991 You can now easily and interactively filter an existing
992 agenda view with respect to a tag. This command is executed
993 with the =/= key in the agenda. You will be prompted for a
994 tag selection key, and all entries that do not contain or
995 inherit the corresponding tag will be hidden. With a prefix
996 argument, the opposite filter is applied: entries that
997 do have the tag will be hidden.
999 This operation only /hides/ lines in the agenda buffer, it
1000 does not remove them. Changing the secondary filtering does
1001 not require a new search and is very fast.
1003 If you press TAB at the tag selection prompt, you will be
1004 switched to a completion interface to select a tag. This is
1005 useful when you want to select a tag that does not have a
1006 direct access character.
1008 A double =/ /= will restore the original agenda view by
1009 unhiding any hidden lines.
1011 This functionality was John Wiegley's idea. It is a simpler
1012 implementation of some of the query-editing features proposed
1013 and implemented some time ago by Christopher League (see the
1014 file contrib/lisp/org-interactive-query.el).
1016 *** Editing fixed-width regions with picture or artist mode
1018 The command @<code>C-c '@</code> (that is =C-c= followed by a
1019 single quote) can now also be used to switch to a special
1020 editing mode for fixed-width sections. The default mode is
1021 =artist-mode= which allows you to create ASCII drawings.
1023 It works like this: Enter the editing mode with
1024 @<code>C-c '@</code>. An indirect buffer will be created and
1025 narrowed to the fixed-width region. Edit the drawing, and
1026 press @<code>C-c '@</code> again to exit.
1028 Lines in a fixed-width region should be preceded by a colon
1029 followed by at least one space. These will be removed during
1030 editing, and then added back when you exit the editing mode.
1032 Using the command in an empty line will create a new
1035 This new feature arose from a discussion involving Scott
1036 Otterson, Sebastian Rose and Will Henney.
1038 *** /org-plot.el/ is now part of Org.
1040 You can run it by simple calling org-plot/gnuplot.
1041 Documentation is not yet included with Org, please refer to
1042 http://github.com/eschulte/org-plot/tree/master until we have
1043 moved the docs into Org or Worg.
1045 Thanks to Eric Schulte for this great contribution.
1047 *** Tags can be used to select the export part of a document
1049 You may now use tags to select parts of a document for
1050 inclusion into the export, and to exclude other parts. This
1051 behavior is governed by two new variables:
1052 =org-export-select-tags= and =org-export-exclude-tags=.
1053 These default to =("export")= and =("noexport")=, but can be
1054 changed, even to include a list of several tags.
1056 Org first checks if any of the /select/ tags is present in
1057 the buffer. If yes, all trees that do not carry one of these
1058 tags will be excluded. If a selected tree is a subtree, the
1059 heading hierarchy above it will also be selected for export,
1060 but not the text below those headings. If none of the select
1061 tags is found anywhere in the buffer, the whole buffer will
1062 be selected for export. Finally, all subtrees that are
1063 marked by any of the /exclude/ tags will be removed from the
1066 You may set these tags with in-buffer options
1067 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1069 I love this feature. Thanks to Richard G Riley for coming
1072 *** Prefix interpretation when storing remember notes
1074 The prefix argument to the `C-c C-c' command that finishes a
1075 remember process is now interpreted differently:
1077 : C-c C-c Store the note to predefined file and headline
1078 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1079 : in its new location.
1080 : C-1 C-c C-c Select the storage location interactively
1081 : C-0 C-c C-c Re-use the last used location
1083 This was requested by John Wiegley.
1085 *** Yanking inserts folded subtrees
1087 If the kill is a subtree or a sequence of subtrees, yanking
1088 them with =C-y= will leave all the subtrees in a folded
1089 state. This basically means, that kill and yank are now
1090 much more useful in moving stuff around in your outline. If
1091 you do not like this, customize the variable
1092 =org-yank-folded-subtrees=.
1094 Right now, I am only binding =C-y= to this new function,
1095 should I modify all bindings of yank? Do we need to amend
1098 This feature was requested by John Wiegley.
1100 *** Column view capture tables can have formulas, plotting info
1102 If you attach formulas and plotting instructions to a table
1103 capturing column view, these extra lines will now survive an
1104 update of the column view capture, and any formulas will be
1105 re-applied to the captured table. This works by keeping any
1106 continuous block of comments before and after the actual
1109 *** In column view, date stamps can be changed with S-cursor keys
1111 If a property value is a time stamp, S-left and S-right can
1112 now be used to shift this date around while in column view.
1114 This was a request by Chris Randle.
1116 *** The note buffer for clocking out now mentions the task
1118 This was a request by Peter Frings.
1120 *** Sorting entries alphabetically ignores TODO keyword and priority
1122 Numerical and alphanumerical sorting now skips any TODO
1123 keyword or priority cookie when constructing the comparison
1124 string. This was a request by Wanrong Lin.
1126 *** Agenda views can sort entries by TODO state
1128 You can now define a sorting strategy for agenda entries that
1129 does look at the TODO state of the entries. Sorting by TODO
1130 entry does first separate the non-done from the done states.
1131 Within each class, the entries are sorted not alphabetically,
1132 but in definition order. So if you have a sequence of TODO
1133 entries defined, the entries will be sorted according to the
1134 position of the keyword in this sequence.
1136 This follows an idea and sample implementation by Christian
1139 *** New face =org-scheduled= for entries scheduled in the future.
1141 This was a request by Richard G Riley.
1143 *** Remember templates for gnus links can now use the :to escape.
1145 Thanks to Tommy Lindgren for a patch to this effect.
1146 *** The file specification in a remember template may now be a function
1148 Thanks to Gregory Sullivan for a patch to this effect.
1150 *** Categories in iCalendar export now include local tags
1152 The locally defined tags are now listed as categories when
1153 exporting to iCalendar format. Org's traditional file/tree
1154 category is now the last category in this list. Configure
1155 the variable =org-icalendar-categories= to modify or revert
1158 This was a request by Charles Philip Chan.
1160 *** It is now possible to define filters for column view
1162 The filter can modify the value that will be displayed in a
1163 column, for example it can cut out a part of a time stamp.
1164 For more information, look at the variable
1165 =org-columns-modify-value-for-display-function=.
1167 *** Disabling integer increment during table field copy
1169 Prefix arg 0 to S-RET does the trick.
1171 This was a request by Chris Randle.
1176 For older Changes, see [[file:Changes_old.org]]