Release 6.20h
[org-mode.git] / ORGWEBPAGE / Changes.org
blob71646465b42afa916fa10b15d41f92d1ba796ec1
1 #   -*- mode: org; fill-column: 65 -*-
3 #+STARTUP: showstars
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
10 #+LINK_UP: index.html
11 #+LINK_HOME: http://orgmode.org
13 * Version 6.20
14  :PROPERTIES:
15  :VISIBILITY: content
16  :END:
18 ** Details
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:
37 #+begin_src org
38 ,* TODO Blocked until (two) is done
39 ,** DONE one
40 ,** TODO two
42 ,* Parent
43 ,  :PROPERTIES:
44 ,    :ORDERED: t
45 ,  :END:
46 ,** TODO a
47 ,** TODO b, needs to wait for (a)
48 ,** TODO c, needs to wait for (a) and (b)
49 #+end_src
51 The command =C-c C-x o= toggles the value of the =ORDERED=
52 property.
54 The variable =org-agenda-dim-blocked-tasks= controls how blocked
55 entries should appear in the agenda, where they can be dimmed or
56 even made invisible.
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.
76 * Version 6.19
78 ** Overview
79    
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
86 ** Details
87    
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
100          region:
101          - if it is a item, turn all items in the region into
102            normal lines.
103          - if it is a headline, turn all headlines in the region
104            into items. 
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
108            current list.
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
112          region:
113          - if it is a item, turn all items in the region into
114            headlines.
115          - if it is a headline, turn all headlines in the region
116            into normal lines. 
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
141 #+begin_src org
142 | a | b |
143 |---+---|
144 | 1 | 2 |
145 | 3 | 4 |
146 #+end_src
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.
172 * Version 6.18
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.    
183 ** Details
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
193     supported.
195 *** Examples can be exported to HTML as text areas
196     
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
235     the line.
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
252     property.
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.
264 * Version 6.17
266 ** Overview
268 - Footnote support
269 - Line numbers and references in literal examples 
270 - New hooks for export preprocessing 
271 - Capture column view into a different file
273 ** Details
275 *** Footnote support
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:
286 #+begin_src org
287 The Org homepage[fn:1] now looks a lot better than it used to.
289 [fn:1] The link is: http://orgmode.org
290 #+end_src
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
296 references:
298 - [1] ::  A plain numeric footnote marker.
299          
300 - [fn:name] :: A named footnote reference, where `name' is a
301      unique label word or, for simplicity of automatic creation,
302      a number. 
303      
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.
345             
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
358 =C-c f=.
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
367 features.
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
375 similar documents.
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
391          example left off.
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.
401 Here is an example:
403 #+begin_example -k
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)))
409 #+end_src
410 [[(def)][Line (def)]] contains the macro name.  Later at line [[(back)]],
411 backquoting is used.
412 #+end_example
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)))
420 #+end_src
421 [[(def)][Line (def)]] contains the macro name.  Later at line [[(back)]],
422 backquoting is used.
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.
462 * Version 6.16
463   Cleanup of many small bugs, and one new feature.
465 ** Details
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.
473 * Version 6.15f
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.
479 * Version 6.15
480 ** Overview
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
495 #+begin_example
496 [[./img/a.jpg{{alt="an image"}}] ]
497 #+end_example
499 This syntax is not longer supported, use instead
501 #+begin_src org
502 ,#+ATTR_HTML: alt="an image"
503 [[./img/a.jpg] ]
504 #+end_src
506 ** Details
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
514 an active region.
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
522 link.
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
539      right format.
541 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
542      tables.\\
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
557 environment.
559 *** Better implementation for entry IDs
560     
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:
568 #+begin_example
569 id:GLOBALLY-UNIQUE-IDENTIFIER
570 #+end_example
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
597 this system clean.
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
626 Schulte.
628 * Version 6.14
629 ** Overview
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
644     
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.
655     
656     If you need the old behavior, customize the variable
657     `org-table-error-on-row-ref-crossing-hline'.
659 ** Details
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.
666     - =C-c C-x .= :: 
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.
671     - =C-c C-x -= :: 
672       Insert a description list item with the current relative
673       time.  With a prefix argument, first reset the timer to 0.
675     - =M-RET= ::
676       Once the time list has been initiated, you can also use the
677       normal item-creating command to insert the next timer item.
679     - =C-c C-x 0= :: 
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
690       moment.
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
751     under Org-mode.
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
755     is turned on.
757     Thanks for Richard Riley for the idea and to Andy Stewart for
758     the implementation.
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
764     this:
766 #+begin_src emacs-lisp
767 (setq org-use-property-inheritance '("LOCATION"))
768 #+end_src
770 * Version 6.13
772 ** Overview
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/
780    - Link translation
781    - BBDB links may use regular expressions.
782    - Link abbreviations can use %h to insert a url-encoded target value
783    - Improved XHTML compliance
785 ** Details
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
798     bindings like
800 #+begin_src emacs-lisp
801 (add-hook
802  'org-remember-mode-hook
803  (lambda ()
804    (define-key org-remember-mode-map
805      "\C-x\C-s" 'org-remember-finalize)))
806 #+end_src
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:
840 #+begin_src org
841 ,# <<dummy>>
842 ,*** a headline
843 #+end_src
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
859     /org-exp-blocks.el/.
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.
873 *** Link translation
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
883     this work
885 #+begin_src emacs-lisp
886 (setq org-link-translation-function
887       'org-translate-link-from-planner)
888 #+end_src
890    I guess an inverse translator could be written and integrated
891    into Planner.
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.
913     
914 * Version 6.12
915 ** Overview
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.
923 ** Details
925 *** A region of entries can now be refiled with a single command
926     
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
937     this command caused.
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
942       =C-u C-y=.
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
954     measured times.
956     Thanks to Jurgen Defurne for triggering this addition.
958 *** Better implementation of footnotes for HTML export
959     
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
975     problems.
977 * Version 6.11
979 ** Overview
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
993 ** Details
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:
1010 #+begin_src org
1011 ,* Level one
1012 ,** Level two
1013 ,(1)
1014 ,(2)* Level one again
1015 #+end_src
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
1033     the agenda.
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
1060     
1061     The data saved include the contents of =org-clock-history=,
1062     and the running clock, if there is one.
1063     
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)
1070 #+end_src
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)))
1107 #+end_src
1109     After this, a link like this will work
1111 #+BEGIN_EXAMPLE
1112      [[att:some-attached-file.txt]]
1113 #+END_EXAMPLE
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.
1123     
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.
1129 * Version 6.10
1131 ** Overview
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.
1141 ** Details
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
1149     agenda command.
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")))
1169 #+end_src
1170       
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
1174      estimates:
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
1186      default =<=.
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
1205      switched off.
1206    
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
1214       uses of =C-c C-c=.
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
1260     using pdflatex.
1262     : C-c C-e p     process to PDF.
1263     : C-c C-e d     process to PDF, and open the file.
1265 *** LaTeX export
1266     - \usepackage{graphicx} is now part of the standard class
1267       definitions.
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).
1277 * Version 6.09
1278 ** Incompatible
1279 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1281 ** Details
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
1294     visited in emacs.
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=.
1313 * Version 6.08
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.
1321 ** 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
1337       which support it.
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
1352     information.
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
1368     task.
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.
1373     
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
1379     lists below them.
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]].
1390 * Version 6.07
1392 ** Overview
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
1441     this behavior.
1443     This was a request by Charles Philip Chan.
1445 ** Details
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
1491     fixed-width region.
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
1522     export buffer.
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
1528     up with the idea.
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
1554     =yank-pop= as well?
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
1565     table.
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
1575     
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
1595     Egli.
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
1614     this behavior.
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.
1632 * Older changes
1634   For older Changes, see [[file:Changes_old.org]]
1637