1 # -*- mode: org; fill-column: 65 -*-
5 #+TITLE: Org-mode list of user-visible changes
6 #+AUTHOR: Carsten Dominik
7 #+EMAIL: carsten at orgmode dot org
8 #+OPTIONS: H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:{} *:t TeX:t LaTeX:nil f:nil
9 #+INFOJS_OPT: view:info toc:1 path:org-info.js tdepth:2 ftoc:t
11 #+LINK_HOME: http://orgmode.org
20 *** Support for simple TODO dependencies
22 John Wiegley's code for enforcing simple TODO dependencies has
23 been integrated into Org-mode. Thanks John!
25 The structure of Org files (hierarchy and lists) makes it easy to
26 define TODO dependencies. A parent TODO task should not be
27 marked DONE until all subtasks (defined as children tasks) are
28 marked as DONE. And sometimes there is a logical sequence to a
29 number of (sub)tasks, so that one task cannot be acted upon
30 before all siblings above it are done. If you customize the
31 variable =org-enforce-todo-dependencies=, Org will block entries
32 from changing state while they have children that are not DONE.
33 Furthermore, if an entry has a property =ORDERED=, each of its
34 children will be blocked until all earlier siblings are marked
35 DONE. Here is an example:
38 ,* TODO Blocked until (two) is done
47 ,** TODO b, needs to wait for (a)
48 ,** TODO c, needs to wait for (a) and (b)
51 The command =C-c C-x o= toggles the value of the =ORDERED=
54 The variable =org-agenda-dim-blocked-tasks= controls how blocked
55 entries should appear in the agenda, where they can be dimmed or
58 Furthermore, you can use the variable
59 =org-enforce-todo-checkbox-dependencies= to block TODO entries
60 from switching to DONE while any checkboxes are unchecked in the entry.
62 *** Support for shift-selection in Emacs 23
64 Customize the variable =org-support-shift-select= to use S-cursor
65 key for selecting text. Make sure that you carefully read the
66 docstring of that variable first.
68 *** Adding and removing checkboxes from many lines
70 The command =C-c C-x C-b= normally toggles checkbox status in the
71 current line, or in all lines in the region. With prefix
72 argument it now either adds or removes the checkbox.
74 This was a requested by Daniel Clemente.
80 - Improved behavior of conversion commands =C-c -= and =C-c *=
81 - Table formulas may now reference fields in other tables
82 - A final hline is imagined in each table, for the sake of references
83 - A tags-todo search can now ignore timestamped items
84 - =\par= can be used to force a paragraph break, also in footnotes
89 *** Improved behavior of conversion commands =C-c -= and =C-c *=
91 The conversion commands =C-c -= and =C-c *= are now better
92 behaved and therefore more useful, I hope.
94 If there is an active region, these commands will act on the
95 region, otherwise on the current line.
97 - C-c - :: This command turns headings or normal lines into
98 items, or items into normal lines. When there is a
99 region, everything depends on the first line of the
101 - if it is a item, turn all items in the region into
103 - if it is a headline, turn all headlines in the region
105 - if it is a normal line, turn all lines into items.
106 - special case: if there is no active region and the
107 current line is an item, cycle the bullet type of the
109 - C-c * :: This command turns items and normal lines into
110 headings, or headings into normal lines. When there is
111 a region, everything depends on the first line of the
113 - if it is a item, turn all items in the region into
115 - if it is a headline, turn all headlines in the region
117 - if it is a normal line, turn all lines into headlines.
119 *** Table formulas may now reference fields in other tables
121 You may now reference constants, fields and ranges from a
122 different table, either in the current file or even in a
123 different file. The syntax is
125 : remote(NAME-OR-ID,REF)
127 where /NAME/ can be the name of a table in the current file as
128 set by a =#+TBLNAME: NAME= line before the table. It can also be
129 the ID of an entry, even in a different file, and the reference
130 then refers to the first table in that entry. /REF/ is an
131 absolute field or range reference, valid in the referenced table.
132 Note that since there is no "current filed" for the remote table,
133 all row and column references must be absolute, not relative.
135 *** A final hline is imagined in each table, for the sake of references
137 Even if a table does not end with a hline (mine never do because I
138 think it is not pretty), for the sake of references you can
139 assume there is one. So in the following table
148 a reference like =@I$1..@II$2= will now work.
150 *** A tags-todo search can now ignore timestamped items
151 The variables =org-agenda-todo-ignore-with-date=,
152 =org-agenda-todo-ignore-with-date=, and
153 =org-agenda-todo-ignore-with-date= make it possible to
154 exclude TODO entries which have this kind of planning info
155 associated with them. This is most useful for people who
156 schedule everything, and who use the TODO list mainly to find
157 things that are not yet scheduled. Thomas Morgan pointed out
158 that also the tags-todo search may serve exactly this
159 purpose, and that it might be good to have a way to make
160 these variables also apply to the tags-todo search. I can
161 see that, but could not convince myself to make this the
162 default. A new variable must be set to make this happen:
163 =org-agenda-tags-todo-honor-ignore-options=.
165 *** =\par= can be used to force a paragraph break, also in footnotes
167 The LaTeX idiom =\par= will insert a paragraph break at that
168 location. Normally you would simply leave an empty line to get
169 such a break, but this is useful for footnotes whose
170 definitions may not contain empty lines.
173 ** Incompatible changes
175 *** Short examples must have a space after the colon
177 Short literal examples can be created by preceding lines
178 with a colon. Such lines must now have a space after the
179 colon. I believe this is already general practice, but now
180 it must be like this. The only exception are lines what are
181 empty except for the colon.
185 *** Include files can now also process switches
187 The example and src switches like =-n= can now also be added
188 to include file statements:
190 : #+INCLUDE "~/.emacs" src emacs-lisp -n -r
192 Thanks to Manish for pointing out that this was not yet
195 *** Examples can be exported to HTML as text areas
197 You can now specify a =-t= switch to an example or src block,
198 to make it export to HTML as a text area. To change the
199 defaults for height (number of lines in the example) and
200 width of this area (80), use the =-h= and =-w= switches.
202 Thanks to Ulf Stegemann for driving this development.
204 *** LaTeX_CLASS can be given as a property
206 When exporting a single subtree by selecting it as a region
207 before export, the LaTeX class for the export will be taken
208 from the =LaTeX_CLASS= property of the entry if present.
210 Thanks to Robert Goldman for this request.
212 *** Better handling of inlined images in different backends
214 Two new variables govern which kind of files can be inlined
215 during export. These are
216 =org-export-html-inline-image-extensions= and
217 =org-export-latex-inline-image-extensions=. Remember that
218 links are turned into an inline image if they are a pure link
219 with no description. HTML files can inline /.png/, /.jpg/,
220 and /.gif/ files, while LaTeX files, when processed with
221 /pdflatex/, can inline /.png/, /.jpg/, and /.pdf/ files.
222 These also represent the default settings for the new
223 variables. Note that this means that pure links to /.pdf/
224 files will be inlined - to avoid this for a particular link,
225 make sure that the link has a description part which is not
226 equal to the link part.
228 *** Links by ID now continue to work in HTML exported files
230 If you make links by ID, these links will now still work in
231 HTML exported files, provided that you keep the relative path
232 from link to target file the same.
234 Thanks to Friedrich Delgado Friedrichs for pushing this over
237 *** The relative timer can be paused
239 The new command `C-c C-x ,' will pause the relative timer.
240 When the relative timer is running, its value will be shown
241 in the mode line. To get rid of this display, you need to
242 really stop the timer with `C-u C-c C-x ,'.
244 Thanks to Alan Davis for driving this change.
246 *** The attachment directory may now be chosen by the user
248 Instead of using the automatic, unique directory related to
249 the entry ID, you can also use a chosen directory for the
250 attachments of an entry. This directory is specified by the
251 ATTACH_DIR property. You can use `C-c C-a s' to set this
254 Thanks to Jason Jackson for this proposal.
256 *** You can use a single attachment directory for a subtree
258 By setting the property ATTACH_DIR_INHERIT, you can now tell
259 Org that children of the entry should use the same directory
260 for attachments, unless a child explicitly defines its own
261 directory with the ATTACH_DIR property. You can use the
262 command `C-c C-a i' to set this property in an entry.
269 - Line numbers and references in literal examples
270 - New hooks for export preprocessing
271 - Capture column view into a different file
277 Org-mode now directly supports the creation of footnotes. In
278 contrast to the /footnote.el/ package, Org-mode's footnotes are
279 designed for work on a larger document, not only for one-off
280 documents like emails. The basic syntax is similar to the one
281 used by /footnote.el/, i.e. a footnote is defined in a paragraph
282 that is started by a footnote marker in square brackets in column
283 0, no indentation allowed. The footnote reference is simply the
284 marker in square brackets inside text. For example:
287 The Org homepage[fn:1] now looks a lot better than it used to.
289 [fn:1] The link is: http://orgmode.org
292 Org-mode extends the number-based syntax to /named/ footnotes and
293 optional inline definition. Using plain numbers as markers is
294 supported for backward compatibility, but not encouraged because
295 of possible conflicts with LaTeX syntax. Here are the valid
298 - [1] :: A plain numeric footnote marker.
300 - [fn:name] :: A named footnote reference, where `name' is a
301 unique label word or, for simplicity of automatic creation,
304 - [fn:: This is the inline definition of this footnote] :: A
305 LaTeX-like anonymous footnote where the definition is given
306 directly at the reference point.
308 - [fn:name: a definition] :: An inline definition of a footnote,
309 which also specifies a name for the note. Since Org allows
310 multiple references to the same note, you can then use use
311 `[fn:name]' to create additional references.
313 Footnote labels can be created automatically, or you create names
314 yourself. This is handled by the variable
315 =org-footnote-auto-label= and its corresponding =#+STARTUP=
316 keywords, see the docstring of that variable for details.
318 The following command handles footnotes:
320 - C-c C-x f :: The footnote action command. When the cursor is
321 on a footnote reference, jump to the definition. When it is
322 at a definition, jump to the (first) reference. Otherwise,
323 create a new footnote. Depending on the variable
324 `org-footnote-define-inline' (with associated =#+STARTUP=
325 options =fninline= and =nofninline=), the definitions will
326 be placed right into the text as part of the reference, or
327 separately into the location determined by the variable
328 =org-footnote-section=.
329 When this command is called with a prefix argument, a menu
330 of additional options is offered:
331 - s :: Sort the footnote definitions by reference sequence.
332 During editing, Org makes no effort to sort footnote
333 definitions into a particular sequence. If you want
334 them sorted, use this command, which will also move
335 entries according to =org-footnote-section=.
336 - n :: Normalize the footnotes by collecting all
337 definitions (including inline definitions) into a
338 special section, and then numbering them in
339 sequence. The references will then also be
340 numbers. This is meant to be the final step before
341 finishing a document (e.g. sending off an email).
342 The exporters do this automatically, and so could
343 something like `message-send-hook'.
344 - d :: Delete the footnote at point, and all references to it.
346 - C-c C-c :: If the cursor is on a footnote reference, jump to
347 the definition. If it is a the definition, jump back to the
348 reference. When called with a prefix argument at either
349 location, offer the same menu as `C-u C-c C-x f'.
351 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
352 corresponding definition/reference, and you can use the
353 usual commands to follow these links.
355 Org-mode's footnote support is designed so that it should also
356 work in buffers that are not in Org-mode, for example in email
357 messages. Just bind =org-footnote-action= to a global key like
360 The main trigger for this development came from a hook function
361 written by Paul Rivier, to implement named footnotes and to
362 convert them to numbered ones before export. Thanks, Paul!
364 Thanks also to Scot Becker for a thoughtful post bringing this
365 subject back onto the discussion table, and to Matt Lundin for
366 the idea of named footnotes and his prompt testing of the new
369 *** Line numbers and references in literal examples
371 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
372 do now allow optional line numbering in the example.
373 Furthermore, links to specific code lines are supported, greatly
374 increasing Org-mode's utility for writing tutorials and other
377 Code references use special labels embedded directly into the
378 source code. Such labels look like "(ref:name)" and must be
379 unique within a document. Org-mode links with "(name)" in the
380 link part will be correctly interpreted, both while working with
381 an Org file (internal links), and while exporting to the
382 different backends. Line numbering and code references are
383 supported for all three major backends, HTML, LaTeX, and ASCII.
384 In the HTML backend, hovering the mouse over a link to a source
385 line will remote-highlight the referenced code line.
387 The options for the BEGIN lines are:
389 - -n :: Number the lines in the example
390 - +n :: Like -n, but continue numbering from where the previous
392 - -r :: Remove the coderef cookies from the example, and replace
393 links to this reference with line numbers. This option
394 takes only effect if either -n or +n are given as well.
395 If -r is not given, coderefs simply use the label name.
396 - -l "fmt" :: Define a local format for coderef labels, see the
397 variable =org-coderef-label-format= for details. Use this
398 of the default syntax causes conflicts with the code in the
399 code snippet you are using.
404 #+begin_src emacs-lisp -n -r
405 (defmacro org-unmodified (&rest body) (ref:def)
406 "Execute body without changing `buffer-modified-p'."
407 `(set-buffer-modified-p (ref:back)
408 (prog1 (buffer-modified-p) ,@body)))
410 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
414 When exported, this is translated to:
415 #+begin_src emacs-lisp -n -r
416 (defmacro org-unmodified (&rest body) (ref:def)
417 "Execute body without changing `buffer-modified-p'."
418 `(set-buffer-modified-p (ref:back)
419 (prog1 (buffer-modified-p) ,@body)))
421 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
424 Thanks to Ilya Shlyakhter for proposing this feature set. Thanks
425 to Sebastian Rose for the key Javascript element that made the
426 remote highlighting possible.
428 *** New hooks for export preprocessing
429 The export preprocessor now runs more hooks, to allow
430 better-timed tweaking by user functions:
432 - =org-export-preprocess-hook= ::
433 Pretty much the first thing in the preprocessor. But org-mode
434 is already active in the preprocessing buffer.
436 - =org-export-preprocess-after-include-files-hook= ::
437 This is run after the contents of included files have been inserted.
439 - =org-export-preprocess-after-tree-selection-hook= ::
440 This is run after selection of trees to be exported has
441 happened. This selection includes tags-based selection, as
442 well as removal of commented and archived trees.
444 - =org-export-preprocess-before-backend-specifics-hook= ::
445 Hook run before backend-specific functions are called during preprocessing.
447 - =org-export-preprocess-final-hook= ::
448 Hook for preprocessing an export buffer. This is run as the
449 last thing in the preprocessing buffer, just before returning
450 the buffer string to the backend.
452 *** Capture column view into a different file
454 The :id parameter for the dynamic block capturing column view
455 can now truly be an ID that will also be found in a
456 different file. Also, it can be like =file:path/to/file=, to
457 capture the global column view from a different file.
459 Thanks to Francois Lagarde for his report that IDs outside
460 the current file would not work.
463 Cleanup of many small bugs, and one new feature.
467 *** References to last table row with special names
469 Fields in the last row of a table can now be referenced with
470 $LR1, $LR2, etc. These references can appear both on the
471 left hand side and right hand side of a formula.
475 This version reverses the introduction of @0 as a reference to
476 the last rwo in a table, because of a conflict with the use of
477 @0 for the current row.
482 - All known LaTeX export issues fixed
483 - Captions and attributes for figures and tables.
484 - Better implementation for entry IDs
485 - Spreadsheet references to the last table line.
486 - Old syntax for link attributes abandoned
488 ** Incompatible changes
489 *** Old syntax for link attributes abandoned
491 There used to be a syntax for setting link attributes for
492 HTML export by enclosing the attributes into double braces
493 and adding them to the link itself, like
496 [[./img/a.jpg{{alt="an image"}}] ]
499 This syntax is not longer supported, use instead
502 ,#+ATTR_HTML: alt="an image"
508 *** All known LaTeX export issues fixed
510 All the remaining issues with the LaTeX exporter have hopefully
511 been addressed in this release. In particular, this covers
512 quoting of special characters in tables and problems with
513 exporting files where the headline is in the first line, or with
516 *** Captions and attributes for figures and tables.
518 Tables, and Hyperlinks that represent inlined images, can now be
519 equipped with additional information that will be used during
520 export. The information will be taken from the following special
521 lines in the buffer and apply to the first following table or
524 - #+CAPTION: :: The caption of the image or table. This string
525 should be processed according to the export backend, but
526 this is not yet done.
528 - #+LABEL: :: A label to identify the figure/table for cross
529 references. For HTML export, this string will become the
530 ID for the ~<div class="figure">~ element that encapsulates
531 the image tag and the caption. For LaTeX export, this
532 string will be used as the argument of a ~\label{...}~
533 macro. These labels will be available for internal links
534 like ~[[label][Table] ]~.
536 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
537 added as attributes into the ~<img...>~ tag. This string
538 will not be processed, so it should have immediately the
541 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
543 For /images/, this string is directly inserted into
544 the optional argument of the ~\includegraphics[...]{file}~
545 command, to specify scaling, clipping and other options.
546 This string will not be processed, so it should have
547 immediately the right format, like =width=5cm,angle=90=.\\
548 For /tables/, this can currently contain the keyword
549 =longtable=, to request typesetting of the table using the
550 longtable package, which automatically distributes the table
551 over several pages if needed. Also, the attributes line may
552 contain an alignment string for the tabular environment, like
553 =longtable,align=l|lrl=
555 For LaTeX export, if either a caption or a label is given, the element
556 will be exported as a float, i.e. wrapped into a figure or table
559 *** Better implementation for entry IDs
561 Unique identifiers for entries can now be used more efficiently.
562 Internally, a hash array has replaced the alist used so far to
563 keep track of the files in which an ID is defined. This makes it
564 quite fast to find an entry by ID.
566 There is a new link type which looks like this:
569 id:GLOBALLY-UNIQUE-IDENTIFIER
572 This link points to a specific entry. When you move the entry to
573 a different file, for example if you move it to an archive
574 file, the link will continue to work.
576 The file /org-id.el/ contains an API that can be used to write
577 code using these identifiers, including creating IDs and finding
578 them wherever they are.
580 Org has its own method to create unique identifiers, but if the system
581 has /uuidgen/ command installed (Mac's and Linux systems generally
582 do), it will be used by default (a change compared to the earlier
583 implmentation, where you explicitdly had to opt for uuidgen). You can
584 also select the method by hand, using the variable =org-id-method=.
586 If the ID system ever gets confused about where a certain ID is, it
587 initiates a global scan of all agenda files with associated archives,
588 all files previously known containing any IDs, and all currently
589 visited Org-mode files to rebuild the hash. You can also initiate
590 this by hand: =M-x org-id-update-id-locations=. Running this command
591 will also dump into the =*Messages*= buffer information about any
592 duplicate IDs. These should not exist, and Org will never /make/ the
593 same ID twice, but if you /copy/ an entry with its properties,
594 duplicate IDs will inevitably be produced. Unfortunately, this is
595 unavoidable in a plain text system that allows you to edit the text in
596 arbitrary ways, and a portion of care on your side is needed to keep
599 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
600 This is also a change from previous versions where the file was
601 =~/.org=id-locations=. Therefore, you can remove this old file
602 if you have it. I am not sure what will happen if the =.emacs.d=
603 directory does not exists in your setup, but in modern Emacsen, I
604 believe it should exist. If you do not want to use IDs across
605 files, you can avoid the overhead with tracking IDs by
606 customizing the variable =org-id-track-globally=. IDs can then
607 still be used for links inside a single file.
609 IDs will also be used when you create a new link to an Org-mode
610 buffer. If you use =org-store-link= (normally at =C-c l=) inside
611 en entry in an Org-mode buffer, and ID property will be created
612 if it does not exist, and the stored link will be an =id:= link.
613 If you prefer the much less secure linking to headline text, you
614 can configure the variable =org-link-to-org-use-id=. The default
615 setting for this variable is =create-if-interactive=, meaning
616 that an ID will be created when you store a link interactively,
617 but not if you happen to be in an Org-mode file while you create
618 a remember note (which usually has a link to the place where you
619 were when starting remember).
621 *** Spreadsheet references to the last table line.
623 You may now use =@0= to reference the last dataline in a table
624 in a stable way. This is useful in particular for automatically
625 generated tables like the ones using /org-collector.el/ by Eric
631 - New relative timer to support timed notes
632 - Special faces can be set for individual tags
633 - The agenda shows now all tags, including inherited ones.
634 - Exclude some tags from inheritance.
635 - More special values for time comparisons in property searches
636 - Control for exporting meta data
637 - Cut and Paste with hot links from w3m to Org
638 - LOCATION can be inherited for iCalendar export
639 - Relative row references crossing hlines now throw an error
641 ** Incompatible Changes
643 *** Relative row references crossing hlines now throw an error
645 Relative row references in tables look like this: "@-4" which
646 means the forth row above this one. These row references are
647 not allowed to cross horizontal separator lines (hlines). So
648 far, when a row reference violates this policy, Org would
649 silently choose the field just next to the hline.
651 Tassilo Horn pointed out that this kind of hidden magic is
652 actually confusing and may cause incorrect formulas, and I do
653 agree. Therefore, trying to cross a hline with a relative
654 reference will now throw an error.
656 If you need the old behavior, customize the variable
657 `org-table-error-on-row-ref-crossing-hline'.
661 *** New relative timer to support timed notes
663 Org now supports taking timed notes, useful for example while
664 watching a video, or during a meeting which is also recorded.
667 Insert a relative time into the buffer. The first time
668 you use this, the timer will be started. When called
669 with a prefix argument, the timer is reset to 0.
672 Insert a description list item with the current relative
673 time. With a prefix argument, first reset the timer to 0.
676 Once the time list has been initiated, you can also use the
677 normal item-creating command to insert the next timer item.
680 Reset the timer without inserting anything into the buffer.
681 By default, the timer is reset to 0. When called with a
682 =C-u= prefix, reset the timer to specific starting
683 offset. The user is prompted for the offset, with a
684 default taken from a timer string at point, if any, So this
685 can be used to restart taking notes after a break in the
686 process. When called with a double prefix argument
687 =C-c C-u=, change all timer strings in the active
688 region by a certain amount. This can be used to fix timer
689 strings if the timer was not started at exactly the right
692 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
693 contributions to this idea.
695 *** Special faces can be set for individual tags
697 You may now use the variable =org-tag-faces= to define the
698 face used for specific tags, much in the same way as you can
699 do for TODO keywords.
701 Thanks to Samuel Wales for this proposal.
703 *** The agenda shows now all tags, including inherited ones.
705 This request has come up often, most recently it was
706 formulated by Tassilo Horn.
708 If you prefer the old behavior of only showing the local
709 tags, customize the variable =org-agenda-show-inherited-tags=.
711 *** Exclude some tags from inheritance.
713 So far, the only way to select tags for inheritance was to
714 allow it for all tags, or to do a positive selection using
715 one of the more complex settings for
716 `org-use-tag-inheritance'. It may actually be better to
717 allow inheritance for all but a few tags, which was difficult
718 to achieve with this methodology.
720 A new option, `org-tags-exclude-from-inheritance', allows to
721 specify an exclusion list for inherited tags.
723 *** More special values for time comparisons in property searches
725 In addition to =<now>=, =<today>=, =<yesterday>=, and
726 =<tomorrow>=, there are more special values accepted now in
727 time comparisons in property searches: You may use strings
728 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
729 week, month, and year, respectively
731 Thanks to Linday Todd for this proposal.
733 *** Control for exporting meta data
735 All the metadata in a headline, i.e. the TODO keyword, the
736 priority cookie, and the tags, can now be excluded from
737 export with appropriate options:
739 | Variable | Publishing property | OPTIONS switch |
740 |-------------------------------+---------------------+----------------|
741 | org-export-with-todo-keywords | :todo-keywords | todo: |
742 | org-export-with-tags | :tags | tags: |
743 | org-export-with-priority | :priority | pri: |
745 *** Cut and Paste with hot links from w3m to Org
747 You can now use the key =C-c C-x M-w= in a w3m buffer with
748 HTML content to copy either the region or the entire file in
749 a special way. When you yank this text back into an Org-mode
750 buffer, all links from the w3m buffer will continue to work
753 For this to work you need to load the new file /org-w3m.el./
754 Please check your org-modules variable to make sure that this
757 Thanks for Richard Riley for the idea and to Andy Stewart for
760 *** LOCATION can be inherited for iCalendar export
762 The LOCATION property can now be inherited during iCalendar
763 export if you configure =org-use-property-inheritance= like
766 #+begin_src emacs-lisp
767 (setq org-use-property-inheritance '("LOCATION"))
774 - Keybindings in Remember buffers can be configured
775 - Support for ido completion
776 - New face for date lines in agenda column view
777 - Invisible targets become now anchors in headlines.
778 - New contributed file /org-exp-blocks.el/
779 - New contributed file /org-eval-light.el/
781 - BBDB links may use regular expressions.
782 - Link abbreviations can use %h to insert a url-encoded target value
783 - Improved XHTML compliance
787 *** Keybindings in Remember buffers can be configured
789 The remember buffers created with Org's extensions are in
790 Org-mode, which is nice to prepare snippets that will
791 actually be stored in Org-mode files. However, this makes it
792 hard to configure key bindings without modifying the Org-mode
793 keymap. There is now a minor mode active in these buffers,
794 `org-remember-mode', and its keymap org-remember-mode-map can
795 be used for key bindings. By default, this map only contains
796 the bindings for =C-c C-c= to store the note, and =C-c C-k=
797 to abort it. Use `org-remember-mode-hook' to define your own
800 #+begin_src emacs-lisp
802 'org-remember-mode-hook
804 (define-key org-remember-mode-map
805 "\C-x\C-s" 'org-remember-finalize)))
808 If you wish, you can also use this to free the =C-c C-c=
809 binding (by binding this key to nil in the minor mode map),
810 so that you can use =C-c C-c= again to set tags.
812 This modification is based on a request by Tim O'Callaghan.
814 *** Support for ido completion
816 You can now get the completion interface from /ido.el/ for
817 many of Org's internal completion commands by turning on the
818 variable =org-completion-use-ido=. =ido-mode= must also be
819 active before you can use this.
821 This change is based upon a request by Samuel Wales.
823 *** New face for date lines in agenda column view
825 When column view is active in the agenda, and when you have
826 summarizing properties, the date lines become normal column
827 lines and the separation between different days becomes
828 harder to see. If this bothers you, you can now customize
829 the face =org-agenda-column-dateline=.
831 This is based on a request by George Pearson.
833 *** Invisible targets become now anchors in headlines.
835 These anchors can be used to jump to a directly with an HTML
836 link, just like the =sec-xxx= IDs. For example, the
837 following will make a http link
838 =//domain/path-to-my-file.html#dummy= work:
845 This is based on a request by Matt Lundin.
847 *** New contributed file /org-exp-blocks.el/
849 This new file implements special export behavior of
850 user-defined blocks. The currently supported blocks are
852 - comment :: Comment blocks with author-specific markup
853 - ditaa :: conversion of ASCII art into pretty png files
854 using Stathis Sideris' /ditaa.jar/ program
855 - dot :: creation of graphs in the /dot/ language
856 - R :: Sweave type exporting using the R program
858 For more details and examples, see the file commentary in
861 Kudos to Eric Schulte for this new functionality, after
862 /org-plot.el/ already his second major contribution. Thanks
863 to Stathis for this excellent program, and for allowing us to
864 bundle it with Org-mode.
866 *** New contributed file /org-eval-light.el/
868 This module gives control over execution Emacs Lisp code
869 blocks included in a file.
871 Thanks to Eric Schulte also for this file.
875 You can now configure Org to understand many links created
876 with the Emacs Planner package, so you can cut text from
877 planner pages and paste them into Org-mode files without
878 having to re-write the links. Among other things, this means
879 that the command =org-open-at-point-global= which follows
880 links not only in Org-mode, but in arbitrary files like
881 source code files etc, will work also with links created by
882 planner. The following customization is needed to make all of
885 #+begin_src emacs-lisp
886 (setq org-link-translation-function
887 'org-translate-link-from-planner)
890 I guess an inverse translator could be written and integrated
893 *** BBDB links may use regular expressions.
895 This did work all along, but only now I have documented it.
897 *** =yank-pop= works again after yanking an outline tree
899 Samuel Wales had noticed that =org-yank= did mess up this
900 functionality. Now you can use =yank-pop= again, the only
901 restriction is that the so-yanked text will not be
902 pro/demoted or folded.
904 *** Link abbreviations can use %h to insert a url-encoded target value
906 Thanks to Steve Purcell for a patch to this effect.
908 *** Improved XHTML compliance
910 Thanks to Sebastian Rose for pushing this.
912 *** Many bug fixes again.
917 - A region of entries can now be refiled with a single command
918 - Fine-tuning the behavior of `org-yank'
919 - Formulas for clocktables
920 - Better implementation of footnotes for HTML export
921 - More languages for HTML export.
925 *** A region of entries can now be refiled with a single command
927 With =transient-make-mode= active (=zmacs-regions= under
928 XEmacs), you can now select a region of entries and refile
929 them all with a single =C-c C-w= command.
931 Thanks to Samuel Wales for this useful proposal.
933 *** Fine-tuning the behavior of =org-yank=
935 The behavior of Org's yanking command has been further
936 fine-tuned in order to avoid some of the small annoyances
939 - Calling =org-yank= with a prefix arg will stop any special
940 treatment and directly pass through to the normal =yank=
941 command. Therefore, you can now force a normal yank with
944 - Subtrees will only be folded after a yank if doing so will
945 now swallow any non-white characters after the yanked text.
946 This is, I think a really important change to make the
947 command work more sanely.
949 *** Formulas for clocktables
951 You can now add formulas to a clock table, either by hand, or
952 with a =:formula= parameter. These formulas can be used to
953 create additional columns with further analysis of the
956 Thanks to Jurgen Defurne for triggering this addition.
958 *** Better implementation of footnotes for HTML export
960 The footnote export in 6.11 really was not good enough. Now
961 it works fine. If you have customized
962 =footnote-section-tag=, make sure that your customization is
963 matched by =footnote-section-tag-regexp=.
965 Thanks to Sebastian Rose for pushing this change.
967 *** More languages for HTML export.
969 More languages are supported during HTML export. This is
970 only relevant for the few special words Org inserts, like
971 "Table of Contents", or "Footnotes". Also the encoding
972 issues with this feature seem to be solved now.
974 Thanks to Sebastian Rose for pushing me to fix the encoding
981 - Yanking subtree with =C-y= now adjusts the tree level
982 - State changes can now be shown in the log mode in the agenda
983 - Footnote in HTML export are now collected at the end of the document
984 - HTML export now validates again as XHTML
985 - The clock can now be resumed after exiting and re-starting Emacs
986 - Clock-related data can be saved and resumed across Emacs sessions
987 - Following file links can now use C-u C-u to force use of an external app
988 - Inserting absolute files names now abbreviates links with "~"
989 - Links to attachment files
990 - Completed repeated tasks listed briefly in agenda
991 - Remove buffers created during publishing are removed
995 *** Yanking subtree with =C-y= now adjusts the tree level
996 When yanking a cut/copied subtree or a series of trees, the
997 normal yank key =C-y= now adjusts the level of the tree to
998 make it fit into the current outline position, without losing
999 its identity, and without swallowing other subtrees.
1001 This uses the command =org-past-subtree=. An additional
1002 change in that command has been implemented: Normally, this
1003 command picks the right outline level from the surrounding
1004 *visible* headlines, and uses the smaller one. So if the
1005 cursor is between a level 4 and a level 3 headline, the tree
1006 will be pasted as level 3. If the cursor is actually *at*
1007 the beginning of a headline, the level of that headline will
1008 be used. For example, lets say you have a tree like this:
1014 ,(2)* Level one again
1017 with (1) and (2) indicating possible cursor positions for the
1018 insertion. When at (1), the tree will be pasted as level 2.
1019 When at (2), it will be pasted as level 1.
1021 If you do not want =C-y= to behave like this, configure the
1022 variable =org-yank-adjusted-subtrees=.
1024 Thanks to Samuel Wales for this idea and a partial implementation.
1026 *** State changes can now be shown in the log mode in the agenda
1028 If you configure the variable =org-agenda-log-mode-items=,
1029 you can now request that all logged state changes be included
1030 in the agenda when log mode is active. If you find this too
1031 much for normal applications, you can also temporarily
1032 request the inclusion of state changes by pressing =C-u l= in
1035 This was a request by Hsiu-Khuern Tang.
1037 You can also press `C-u C-u l' to get *only* log items in the
1038 agenda, withour any timestamps/deadlines etc.
1040 *** Footnote in HTML export are now collected at the end of the document
1041 Previously, footnotes would be left in the document where
1042 they are defined, now they are all collected and put into a
1043 special =<div>= at the end of the document.
1045 Thanks to Sebastian Rose for this request.
1047 *** HTML export now validates again as XHTML.
1049 Thanks to Sebastian Rose for pushing this cleanup.
1051 *** The clock can now be resumed after exiting and re-starting Emacs
1053 If the option =org-clock-in-resume= is t, and the first clock
1054 line in an entry is unclosed, clocking into that task resumes
1055 the clock from that time.
1057 Thanks to James TD Smith for a patch to this effect.
1059 *** Clock-related data can be saved and resumed across Emacs sessions
1061 The data saved include the contents of =org-clock-history=,
1062 and the running clock, if there is one.
1064 To use this, you will need to add to your .emacs
1066 #+begin_src emacs-lisp
1067 (setq org-clock-persist t)
1068 (setq org-clock-in-resume t)
1069 (org-clock-persistence-insinuate)
1072 Thanks to James TD Smith for a patch to this effect.
1074 *** Following file links can now use C-u C-u to force use of an external app.
1076 So far you could only bypass your setup in `org-file-apps'
1077 and force opening a file link in Emacs by using a =C-u= prefix arg
1078 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
1079 an external application. Which external application depends
1080 on your system. On Mac OS X and Windows, =open= is used. On
1081 a GNU/Linux system, the mailcap settings are used.
1083 This was a proposal by Samuel Wales.
1085 *** Inserting absolute files names now abbreviates links with "~".
1087 Inserting file links with =C-u C-c C-l= was buggy if the
1088 setting of `org-link-file-path-type' was `adaptive' (the
1089 default). Absolute file paths were not abbreviated relative
1090 to the users home directory. This bug has been fixed.
1092 Thanks to Matt Lundin for the report.
1094 *** Links to attachment files
1096 Even though one of the purposes of entry attachments was to
1097 reduce the number of links in an entry, one might still want
1098 to have the occasional link to one of those files. You can
1099 now use link abbreviations to set up a special link type that
1100 points to attachments in the current entry. Note that such
1101 links will only work from within the same entry that has the
1102 attachment, because the directory path is entry specific.
1103 Here is the setup you need:
1105 #+begin_src emacs-lisp
1106 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
1109 After this, a link like this will work
1112 [[att:some-attached-file.txt]]
1114 This was a proposal by Lindsay Todd.
1116 *** Completed repeated tasks listed briefly in agenda
1118 When a repeating task, listed in the daily/weekly agenda under
1119 today's date, is completed from the agenda, it is listed as
1120 DONE in the agenda until the next update happens. After the
1121 next update, the task will have disappeared, of course,
1122 because the new date is no longer today.
1124 *** Remove buffers created during publishing are removed
1126 Buffers that are created during publishing are now deleted
1127 when the publishing is over. At least I hope it works like this.
1133 - Secondary agenda filtering is becoming a killer feature
1134 - Setting tags has now its own binding, =C-c C-q=
1135 - Todo state changes can trigger tag changes
1136 - C-RET will now always insert a new headline, never an item.
1137 - Customize org-mouse.el feature set to free up mouse events
1138 - New commands for export all the way to PDF (through LaTeX)
1139 - Some bug fixed for LaTeX export, more bugs remain.
1143 *** Enhancements to secondary agenda filtering
1145 This is, I believe, becoming a killer feature. It allows you
1146 to define fewer and more general custom agenda commands, and
1147 then to do the final narrowing to specific tasks you are
1148 looking for very quickly, much faster than calling a new
1151 If you have not tries this yet, you should!
1153 **** You can now refining the current filter by an additional criterion
1154 When filtering an existing agenda view with =/=, you can
1155 now narrow down the existing selection by an additional
1156 condition. Do do this, use =\= instead of =/= to add the
1157 additional criterion. You can also press =+= or =-= after
1158 =/= to add a positive or negative condition. A condition
1159 can be a TAG, or an effort estimate limit, see below.
1161 **** It is now possible to filter for effort estimates
1162 This means to filter the agenda for the value of the Effort
1163 property. For this you should best set up global allowed
1164 values for effort estimates, with
1166 #+begin_src emacs-lisp
1167 (setq org-global-properties
1168 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
1171 You may then select effort limits with single keys in the
1172 filter. It works like this: After =/= or =\=, first select
1173 the operator which you want to use to compare effort
1176 : < Select entries with effort smaller than or equal to the limit
1177 : > Select entries with effort larger than or equal to the limit
1178 : = Select entries with effort equal to the limit
1180 After that, you can press a single digit number which is
1181 used as an index to the allowed effort estimates.
1183 If you do not use digits to fast-select tags, you can even
1184 skip the operator, which will then default to
1185 `org-agenda-filter-effort-default-operator', which is by
1188 Thanks to Manish for the great idea to include fast effort
1189 filtering into the agenda filtering process.
1191 **** The mode line will show the active filter
1192 For example, if there is a filter in place that does select
1193 for HOME tags, against EMAIL tags, and for tasks with an
1194 estimated effort smaller than 30 minutes, the mode-line with
1195 show =+HOME-EMAIL+<0:30=
1197 **** The filter now persists when the agenda view is refreshed
1198 All normal refresh commands, including those that move the
1199 weekly agenda from one week to the next, now keep the
1200 current filter in place.
1202 You need to press =/ /= to turn off the filter. However,
1203 when you run a new agenda command, for example going from
1204 the weekly agenda to the TODO list, the filter will be
1207 *** Setting tags has now its own binding, =C-c C-q=
1209 You can still use =C-c C-c= on a headline, but the new
1210 binding should be considered as the main binding for this
1211 command. The reasons for this change are:
1213 - Using =C-c C-c= for tags is really out of line with other
1216 - I hate it in Remember buffers when I try to set tags and I
1217 cannot, because =C-c C-c= exits the buffer :-(
1219 - =C-c C-q= will also work when the cursor is somewhere down
1220 in the entry, it does not have to be on the headline.
1222 *** Todo state changes can trigger tag changes
1224 The new option =org-todo-state-tags-triggers= can be used to
1225 define automatic changes to tags when a TODO state changes.
1226 For example, the setting
1228 : (setq org-todo-state-tags-triggers
1229 : '((done ("Today" . nil) ("NEXT" . nil))
1230 : ("WAITING" ("Today" . t))))
1232 will make sure that any change to any of the DONE states will
1233 remove tags "Today" and "NEXT", while switching to the
1234 "WAITING" state will trigger the tag "Today" to be added.
1236 I use this mostly to get rid of TODAY and NEXT tags which I
1237 apply to select an entry for execution in the near future,
1238 which I often prefer to specific time scheduling.
1240 *** C-RET will now always insert a new headline, never an item.
1241 The new headline is inserted after the current subtree.
1243 Thanks to Peter Jones for patches to fine-tune this behavior.
1245 *** Customize org-mouse.el feature set
1246 There is a new variable =org-mouse-features= which gives you
1247 some control about what features of org-mouse you want to
1248 use. Turning off some of the feature will free up the
1249 corresponding mouse events, or will avoid activating special
1250 regions for mouse clicks. By default I have urned off the
1251 feature to use drag mouse events to move or promote/demote
1252 entries. You can of course turn them back on if you wish.
1254 This variable may still change in the future, allowing more
1255 fine-grained control.
1257 *** New commands for export to PDF
1259 This is using LaTeX export, and then processes it to PDF
1262 : C-c C-e p process to PDF.
1263 : C-c C-e d process to PDF, and open the file.
1266 - \usepackage{graphicx} is now part of the standard class
1268 - Several bugs fixed, but definitely not all of them :-(
1270 *** New option `org-log-state-notes-insert-after-drawers'
1272 Set this to =t= if you want state change notes to be inserted
1273 after any initial drawers, i.e drawers the immediately follow
1274 the headline and the planning line (the one with
1275 DEADLINE/SCHEDULED/CLOSED information).
1279 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1283 *** =org-file-apps= now uses regular repressions instead of extensions
1284 Just like in =auto-mode-alist=, car's in the variable
1285 =org-file-apps= that are strings are now interpreted as
1286 regular expressions that are matched against a file name. So
1287 instead of "txt", you should now write "\\.txt\\'" to make
1288 sure the matching is done correctly (even though "txt" will
1289 be recognized and still be interpreted as an extension).
1291 There is now a shortcut to get many file types visited by
1292 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
1293 any files that are matched by `auto-mode-alist' will be
1296 *** Changes to the attachment system
1298 - The default method to attach a file is now to copy it
1299 instead of moving it.
1300 - You can modify the default method using the variable
1301 `org-attach-method'. I believe that most Unix people want
1302 to set it to `ln' to create hard links.
1303 - The keys =c=, =m=, and =l= specifically select =copy=,
1304 =move=, or =link=, respectively, as the attachment method
1305 for a file, overruling `org-attach-method'.
1306 - To create a new attachment as an Emacs buffer, you have not
1307 now use =n= instead of =c=.
1308 - The file list is now always retrieved from the directory
1309 itself, not from the "Attachments" property. We still
1310 keep this property by default, but you can turn it off, by
1311 customizing the variable =org-attach-file-list-property=.
1315 ** Incompatible changes
1317 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
1319 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
1323 *** The default structure of IDs has changed
1325 IDs created by Org have changed a bit:
1326 - By default, there is no prefix on the ID. There used to be
1327 an "Org" prefix, but I now think this is not necessary.
1328 - IDs use only lower-case letters, no upper-case letters
1329 anymore. The reason for this is that IDs are now also used
1330 as directory names for org-attach, and some systems do not
1331 distinguish upper and lower case in the file system.
1332 - The ID string derived from the current time is now
1333 /reversed/ to become an ID. This assures that the first
1334 two letters of the ID change fast, so hat it makes sense to
1335 split them off to create subdirectories to balance load.
1336 - You can now set the `org-id-method' to `uuidgen' on systems
1339 *** =C-c C-a= no longer calls `show-all'
1341 The reason for this is that =C-c C-a= is now used for the
1342 attachment system. On the rare occasions that this command
1343 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
1345 *** New attachment system
1347 You can now attach files to each node in the outline tree.
1348 This works by creating special directories based on the ID of
1349 an entry, and storing files in these directories. Org can
1350 keep track of changes to the attachments by automatically
1351 committing changes to git. See the manual for more
1354 Thanks to John Wiegley who contributed this fantastic new
1355 concept and wrote org-attach.el to implement it.
1357 *** New remember template escapes
1359 : %^{prop}p to insert a property
1360 : %k the heading of the item currently being clocked
1361 : %K a link to the heading of the item currently being clocked
1363 Also, when you exit remember with =C-2 C-c C-c=, the item
1364 will be filed as a child of the item currently being
1365 clocked. So the idea is, if you are working on something and
1366 think of a new task related to this or a new note to be
1367 added, you can use this to quickly add information to that
1370 Thanks to James TD Smith for a patch to this effect.
1372 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
1374 Thanks to James TD Smith for a patch to this effect.
1376 *** New file in contrib: lisp/org-checklist.el
1378 This module deals with repeated tasks that have checkbox
1381 Thanks to James TD Smith for this contribution.
1383 *** New in-buffer setting #+STYLE
1385 It can be used to locally set the variable
1386 `org-export-html-style-extra'. Several such lines are
1387 allowed-, they will all be concatenated. For an example on
1388 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1394 - Filtering existing agenda views with respect to a tag
1395 - Editing fixed-width regions with picture or artist mode
1396 - /org-plot.el/ is now part of Org
1397 - Tags can be used to select the export part of a document
1398 - Prefix interpretation when storing remember notes
1399 - Yanking inserts folded subtrees
1400 - Column view capture tables can have formulas, plotting info
1401 - In column view, date stamps can be changed with S-cursor keys
1402 - The note buffer for clocking out now mentions the task
1403 - Sorting entries alphabetically ignores TODO keyword and priority
1404 - Agenda views can sort entries by TODO state
1405 - New face =org-scheduled= for entries scheduled in the future.
1406 - Remember templates for gnus links can use the :to escape.
1407 - The file specification in a remember template may be a function
1408 - Categories in iCalendar export include local tags
1409 - It is possible to define filters for column view
1410 - Disabling integer increment during table Field copy
1411 - Capturing column view is on `C-c C-x i'
1412 - And tons of bugs fixed.
1415 ** Incompatible changes
1417 *** Prefix interpretation when storing remember notes has changed
1419 The prefix argument to the `C-c C-c' command that finishes a
1420 remember process is now interpreted differently:
1422 : C-c C-c Store the note to predefined file and headline
1423 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1424 : in its new location.
1425 : C-1 C-c C-c Select the storage location interactively
1426 : C-0 C-c C-c Re-use the last used location
1428 This was requested by John Wiegley.
1430 *** Capturing column view is now on `C-c C-x i'
1432 The reason for this change was that `C-c C-x r' is also used
1433 as a tty key replacement.
1435 *** Categories in iCalendar export now include local tags
1437 The locally defined tags are now listed as categories when
1438 exporting to iCalendar format. Org's traditional file/tree
1439 category is now the last category in this list. Configure
1440 the variable =org-icalendar-categories= to modify or revert
1443 This was a request by Charles Philip Chan.
1447 *** Secondary filtering of agenda views.
1449 You can now easily and interactively filter an existing
1450 agenda view with respect to a tag. This command is executed
1451 with the =/= key in the agenda. You will be prompted for a
1452 tag selection key, and all entries that do not contain or
1453 inherit the corresponding tag will be hidden. With a prefix
1454 argument, the opposite filter is applied: entries that
1455 do have the tag will be hidden.
1457 This operation only /hides/ lines in the agenda buffer, it
1458 does not remove them. Changing the secondary filtering does
1459 not require a new search and is very fast.
1461 If you press TAB at the tag selection prompt, you will be
1462 switched to a completion interface to select a tag. This is
1463 useful when you want to select a tag that does not have a
1464 direct access character.
1466 A double =/ /= will restore the original agenda view by
1467 unhiding any hidden lines.
1469 This functionality was John Wiegley's idea. It is a simpler
1470 implementation of some of the query-editing features proposed
1471 and implemented some time ago by Christopher League (see the
1472 file contrib/lisp/org-interactive-query.el).
1474 *** Editing fixed-width regions with picture or artist mode
1476 The command @<code>C-c '@</code> (that is =C-c= followed by a
1477 single quote) can now also be used to switch to a special
1478 editing mode for fixed-width sections. The default mode is
1479 =artist-mode= which allows you to create ASCII drawings.
1481 It works like this: Enter the editing mode with
1482 @<code>C-c '@</code>. An indirect buffer will be created and
1483 narrowed to the fixed-width region. Edit the drawing, and
1484 press @<code>C-c '@</code> again to exit.
1486 Lines in a fixed-width region should be preceded by a colon
1487 followed by at least one space. These will be removed during
1488 editing, and then added back when you exit the editing mode.
1490 Using the command in an empty line will create a new
1493 This new feature arose from a discussion involving Scott
1494 Otterson, Sebastian Rose and Will Henney.
1496 *** /org-plot.el/ is now part of Org.
1498 You can run it by simple calling org-plot/gnuplot.
1499 Documentation is not yet included with Org, please refer to
1500 http://github.com/eschulte/org-plot/tree/master until we have
1501 moved the docs into Org or Worg.
1503 Thanks to Eric Schulte for this great contribution.
1505 *** Tags can be used to select the export part of a document
1507 You may now use tags to select parts of a document for
1508 inclusion into the export, and to exclude other parts. This
1509 behavior is governed by two new variables:
1510 =org-export-select-tags= and =org-export-exclude-tags=.
1511 These default to =("export")= and =("noexport")=, but can be
1512 changed, even to include a list of several tags.
1514 Org first checks if any of the /select/ tags is present in
1515 the buffer. If yes, all trees that do not carry one of these
1516 tags will be excluded. If a selected tree is a subtree, the
1517 heading hierarchy above it will also be selected for export,
1518 but not the text below those headings. If none of the select
1519 tags is found anywhere in the buffer, the whole buffer will
1520 be selected for export. Finally, all subtrees that are
1521 marked by any of the /exclude/ tags will be removed from the
1524 You may set these tags with in-buffer options
1525 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1527 I love this feature. Thanks to Richard G Riley for coming
1530 *** Prefix interpretation when storing remember notes
1532 The prefix argument to the `C-c C-c' command that finishes a
1533 remember process is now interpreted differently:
1535 : C-c C-c Store the note to predefined file and headline
1536 : C-u C-c C-c Like C-c C-c, but immediately visit the note
1537 : in its new location.
1538 : C-1 C-c C-c Select the storage location interactively
1539 : C-0 C-c C-c Re-use the last used location
1541 This was requested by John Wiegley.
1543 *** Yanking inserts folded subtrees
1545 If the kill is a subtree or a sequence of subtrees, yanking
1546 them with =C-y= will leave all the subtrees in a folded
1547 state. This basically means, that kill and yank are now
1548 much more useful in moving stuff around in your outline. If
1549 you do not like this, customize the variable
1550 =org-yank-folded-subtrees=.
1552 Right now, I am only binding =C-y= to this new function,
1553 should I modify all bindings of yank? Do we need to amend
1556 This feature was requested by John Wiegley.
1558 *** Column view capture tables can have formulas, plotting info
1560 If you attach formulas and plotting instructions to a table
1561 capturing column view, these extra lines will now survive an
1562 update of the column view capture, and any formulas will be
1563 re-applied to the captured table. This works by keeping any
1564 continuous block of comments before and after the actual
1567 *** In column view, date stamps can be changed with S-cursor keys
1569 If a property value is a time stamp, S-left and S-right can
1570 now be used to shift this date around while in column view.
1572 This was a request by Chris Randle.
1574 *** The note buffer for clocking out now mentions the task
1576 This was a request by Peter Frings.
1578 *** Sorting entries alphabetically ignores TODO keyword and priority
1580 Numerical and alphanumerical sorting now skips any TODO
1581 keyword or priority cookie when constructing the comparison
1582 string. This was a request by Wanrong Lin.
1584 *** Agenda views can sort entries by TODO state
1586 You can now define a sorting strategy for agenda entries that
1587 does look at the TODO state of the entries. Sorting by TODO
1588 entry does first separate the non-done from the done states.
1589 Within each class, the entries are sorted not alphabetically,
1590 but in definition order. So if you have a sequence of TODO
1591 entries defined, the entries will be sorted according to the
1592 position of the keyword in this sequence.
1594 This follows an idea and sample implementation by Christian
1597 *** New face =org-scheduled= for entries scheduled in the future.
1599 This was a request by Richard G Riley.
1601 *** Remember templates for gnus links can now use the :to escape.
1603 Thanks to Tommy Lindgren for a patch to this effect.
1604 *** The file specification in a remember template may now be a function
1606 Thanks to Gregory Sullivan for a patch to this effect.
1608 *** Categories in iCalendar export now include local tags
1610 The locally defined tags are now listed as categories when
1611 exporting to iCalendar format. Org's traditional file/tree
1612 category is now the last category in this list. Configure
1613 the variable =org-icalendar-categories= to modify or revert
1616 This was a request by Charles Philip Chan.
1618 *** It is now possible to define filters for column view
1620 The filter can modify the value that will be displayed in a
1621 column, for example it can cut out a part of a time stamp.
1622 For more information, look at the variable
1623 =org-columns-modify-value-for-display-function=.
1625 *** Disabling integer increment during table field copy
1627 Prefix arg 0 to S-RET does the trick.
1629 This was a request by Chris Randle.
1634 For older Changes, see [[file:Changes_old.org]]