Dependencies: Integrate John Wiegley's TODO dependency code.
[org-mode/org-tableheadings.git] / ORGWEBPAGE / Changes.org
blob4de51aed4ac2ac6640725b824c2a2fc21ba17290
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
15 ** Details
16 *** Support for simple TODO dependencies
18 John Wiegley's code for enforcing simple TODO dependencies has
19 been integrated into Org-mode.  Thanks John!
21 The structure of Org files (hierarchy and lists) makes it easy to
22 define TODO dependencies.  A parent TODO task should not be
23 marked DONE until all subtasks (defined as children tasks) are
24 marked as DONE.  And sometimes there is a logical sequence to a
25 number of (sub)tasks, so that one task cannot be acted upon
26 before all siblings above it are done.  If you customize the
27 variable =org-enforce-todo-dependencies=, Org will block entries
28 from changing state while they have children that are not DONE.
29 Furthermore, if an entry has a property =ORDERED=, each of its
30 children will be blocked until all earlier siblings are marked
31 DONE.  Here is an example:
33 #+begin_src org
34 ,* TODO Blocked until (two) is done
35 ,** DONE one
36 ,** TODO two
38 ,* Parent
39 ,  :PROPERTIES:
40 ,    :ORDERED: t
41 ,  :END:
42 ,** TODO a
43 ,** TODO b, needs to wait for (a)
44 ,** TODO c, needs to wait for (a) and (b)
45 #+end_src
46 The variable =org-agenda-dim-blocked-tasks= controls how blocked
47 entries should appear in the agenda, where they can be dimmed or
48 even made invisible.
50 ** Version 6.19
51   :PROPERTIES:
52   :VISIBILITY: content
53   :END:
56 ** Overview
57    
58 - Improved behavior of conversion commands =C-c -= and =C-c *=
59 - Table formulas may now reference fields in other tables
60 - A final hline is imagined in each table, for the sake of references
61 - A tags-todo search can now ignore timestamped items
62 - =\par= can be used to force a paragraph break, also in footnotes
64 ** Details
65    
67 *** Improved behavior of conversion commands =C-c -= and =C-c *=
69     The conversion commands =C-c -= and =C-c *= are now better
70     behaved and therefore more useful, I hope.
72     If there is an active region, these commands will act on the
73     region, otherwise on the current line.
75     - C-c - :: This command turns headings or normal lines into
76          items, or items into normal lines.  When there is a
77          region, everything depends on the first line of the
78          region:
79          - if it is a item, turn all items in the region into
80            normal lines.
81          - if it is a headline, turn all headlines in the region
82            into items. 
83          - if it is a normal line, turn all lines into items.
84          - special case: if there is no active region and the
85            current line is an item, cycle the bullet type of the
86            current list.
87     - C-c * :: This command turns items and normal lines into
88          headings, or headings into normal lines.  When there is
89          a region, everything depends on the first line of the
90          region:
91          - if it is a item, turn all items in the region into
92            headlines.
93          - if it is a headline, turn all headlines in the region
94            into normal lines. 
95          - if it is a normal line, turn all lines into headlines.
97 *** Table formulas may now reference fields in other tables
99 You may now reference constants, fields and ranges from a
100 different table, either in the current file or even in a
101 different file.  The syntax is
103 : remote(NAME-OR-ID,REF)
105 where /NAME/ can be the name of a table in the current file as
106 set by a =#+TBLNAME: NAME= line before the table.  It can also be
107 the ID of an entry, even in a different file, and the reference
108 then refers to the first table in that entry.  /REF/ is an
109 absolute field or range reference, valid in the referenced table.
110 Note that since there is no "current filed" for the remote table,
111 all row and column references must be absolute, not relative.
113 *** A final hline is imagined in each table, for the sake of references
115 Even if a table does not end with a hline (mine never do because I
116 think it is not pretty), for the sake of references you can
117 assume there is one.  So in the following table
119 #+begin_src org
120 | a | b |
121 |---+---|
122 | 1 | 2 |
123 | 3 | 4 |
124 #+end_src
126 a reference like =@I$1..@II$2= will now work.
128 *** A tags-todo search can now ignore timestamped items
129     The variables =org-agenda-todo-ignore-with-date=,
130     =org-agenda-todo-ignore-with-date=, and
131     =org-agenda-todo-ignore-with-date= make it possible to
132     exclude TODO entries which have this kind of planning info
133     associated with them.  This is most useful for people who
134     schedule everything, and who use the TODO list mainly to find
135     things that are not yet scheduled.  Thomas Morgan pointed out
136     that also the tags-todo search may serve exactly this
137     purpose, and that it might be good to have a way to make
138     these variables also apply to the tags-todo search.  I can
139     see that, but could not convince myself to make this the
140     default.  A new variable must be set to make this happen:
141     =org-agenda-tags-todo-honor-ignore-options=.
143 *** =\par= can be used to force a paragraph break, also in footnotes
145 The LaTeX idiom =\par= will insert a paragraph break at that
146 location.  Normally you would simply leave an empty line to get
147 such a break, but this is useful for footnotes whose
148 definitions may not contain empty lines.
150 * Version 6.18
151 ** Incompatible changes
153 *** Short examples must have a space after the colon
155     Short literal examples can be created by preceding lines
156     with a colon.  Such lines must now have a space after the
157     colon.  I believe this is already general practice, but now
158     it must be like this.  The only exception are lines what are
159     empty except for the colon.    
161 ** Details
163 *** Include files can now also process switches
165     The example and src switches like =-n= can now also be added
166     to include file statements:
168 : #+INCLUDE "~/.emacs" src emacs-lisp -n -r
170     Thanks to Manish for pointing out that this was not yet
171     supported.
173 *** Examples can be exported to HTML as text areas
174     
175     You can now specify a =-t= switch to an example or src block,
176     to make it export to HTML as a text area.  To change the
177     defaults for height (number of lines in the example) and
178     width of this area (80), use the =-h= and =-w= switches.
180     Thanks to Ulf Stegemann for driving this development.
182 *** LaTeX_CLASS can be given as a property
184     When exporting a single subtree by selecting it as a region
185     before export, the LaTeX class for the export will be taken
186     from the =LaTeX_CLASS= property of the entry if present.
188     Thanks to Robert Goldman for this request.
190 *** Better handling of inlined images in different backends
192     Two new variables govern which kind of files can be inlined
193     during export.  These are
194     =org-export-html-inline-image-extensions= and
195     =org-export-latex-inline-image-extensions=.  Remember that
196     links are turned into an inline image if they are a pure link
197     with no description.  HTML files can inline /.png/, /.jpg/,
198     and /.gif/ files, while LaTeX files, when processed with
199     /pdflatex/, can inline /.png/, /.jpg/, and /.pdf/ files.
200     These also represent the default settings for the new
201     variables.  Note that this means that pure links to /.pdf/
202     files will be inlined - to avoid this for a particular link,
203     make sure that the link has a description part which is not
204     equal to the link part.
206 *** Links by ID now continue to work in HTML exported files
208     If you make links by ID, these links will now still work in
209     HTML exported files, provided that you keep the relative path
210     from link to target file the same.
212     Thanks to Friedrich Delgado Friedrichs for pushing this over
213     the line.
215 *** The relative timer can be paused
217     The new command `C-c C-x ,' will pause the relative timer.
218     When the relative timer is running, its value will be shown
219     in the mode line.  To get rid of this display, you need to
220     really stop the timer with `C-u C-c C-x ,'.
222     Thanks to Alan Davis for driving this change.
224 *** The attachment directory may now be chosen by the user
226     Instead of using the automatic, unique directory related to
227     the entry ID, you can also use a chosen directory for the
228     attachments of an entry.  This directory is specified by the
229     ATTACH_DIR property.  You can use `C-c C-a s' to set this
230     property.
232     Thanks to Jason Jackson for this proposal.
234 *** You can use a single attachment directory for a subtree
236     By setting the property ATTACH_DIR_INHERIT, you can now tell
237     Org that children of the entry should use the same directory
238     for attachments, unless a child explicitly defines its own
239     directory with the ATTACH_DIR property.  You can use the
240     command `C-c C-a i' to set this property in an entry.
242 * Version 6.17
244 ** Overview
246 - Footnote support
247 - Line numbers and references in literal examples 
248 - New hooks for export preprocessing 
249 - Capture column view into a different file
251 ** Details
253 *** Footnote support
255 Org-mode now directly supports the creation of footnotes.  In
256 contrast to the /footnote.el/ package, Org-mode's footnotes are
257 designed for work on a larger document, not only for one-off
258 documents like emails.  The basic syntax is similar to the one
259 used by /footnote.el/, i.e. a footnote is defined in a paragraph
260 that is started by a footnote marker in square brackets in column
261 0, no indentation allowed.  The footnote reference is simply the
262 marker in square brackets inside text.  For example:
264 #+begin_src org
265 The Org homepage[fn:1] now looks a lot better than it used to.
267 [fn:1] The link is: http://orgmode.org
268 #+end_src
270 Org-mode extends the number-based syntax to /named/ footnotes and
271 optional inline definition.  Using plain numbers as markers is
272 supported for backward compatibility, but not encouraged because
273 of possible conflicts with LaTeX syntax.  Here are the valid
274 references:
276 - [1] ::  A plain numeric footnote marker.
277          
278 - [fn:name] :: A named footnote reference, where `name' is a
279      unique label word or, for simplicity of automatic creation,
280      a number. 
281      
282 - [fn:: This is the inline definition of this footnote] :: A
283      LaTeX-like anonymous footnote where the definition is given
284      directly at the reference point.
286 - [fn:name: a definition] :: An inline definition of a footnote,
287      which also specifies a name for the note.  Since Org allows
288      multiple references to the same note, you can then use use
289      `[fn:name]' to create additional references.
291 Footnote labels can be created automatically, or you create names
292 yourself.  This is handled by the variable
293 =org-footnote-auto-label= and its corresponding =#+STARTUP=
294 keywords, see the docstring of that variable for details.
296 The following command handles footnotes:
298 - C-c C-x f :: The footnote action command.  When the cursor is
299      on a footnote reference, jump to the definition.  When it is
300      at a definition, jump to the (first) reference.  Otherwise,
301      create a new footnote.  Depending on the variable
302      `org-footnote-define-inline' (with associated =#+STARTUP=
303      options =fninline= and =nofninline=), the definitions will
304      be placed right into the text as part of the reference, or
305      separately into the location determined by the variable
306      =org-footnote-section=.
307      When this command is called with a prefix argument, a menu
308      of additional options is offered:
309      - s :: Sort the footnote definitions by reference sequence.
310             During editing, Org makes no effort to sort footnote
311             definitions into a particular sequence.  If you want
312             them sorted, use this command, which will also move
313             entries according to =org-footnote-section=.
314      - n :: Normalize the footnotes by collecting all
315             definitions (including inline definitions) into a
316             special section, and then numbering them in
317             sequence.  The references will then also be
318             numbers.  This is meant to be the final step before
319             finishing a document (e.g. sending off an email).
320             The exporters do this automatically, and so could 
321             something like `message-send-hook'.
322      - d :: Delete the footnote at point, and all references to it.
323             
324 - C-c C-c :: If the cursor is on a footnote reference, jump to
325      the definition.  If it is a the definition, jump back to the
326      reference.  When called with a prefix argument at either
327      location, offer the same menu as `C-u C-c C-x f'.
329 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
330      corresponding definition/reference, and you can use the
331      usual commands to follow these links.
333 Org-mode's footnote support is designed so that it should also
334 work in buffers that are not in Org-mode, for example in email
335 messages.  Just bind =org-footnote-action= to a global key like
336 =C-c f=.
338 The main trigger for this development came from a hook function
339 written by Paul Rivier, to implement named footnotes and to
340 convert them to numbered ones before export.  Thanks, Paul!
342 Thanks also to Scot Becker for a thoughtful post bringing this
343 subject back onto the discussion table, and to Matt Lundin for
344 the idea of named footnotes and his prompt testing of the new
345 features.
347 *** Line numbers and references in literal examples
349 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
350 do now allow optional line numbering in the example.
351 Furthermore, links to specific code lines are supported, greatly
352 increasing Org-mode's utility for writing tutorials and other
353 similar documents.
355 Code references use special labels embedded directly into the
356 source code.  Such labels look like "(ref:name)" and must be
357 unique within a document.  Org-mode links with "(name)" in the
358 link part will be correctly interpreted, both while working with
359 an Org file (internal links), and while exporting to the
360 different backends.  Line numbering and code references are
361 supported for all three major backends, HTML, LaTeX, and ASCII.
362 In the HTML backend, hovering the mouse over a link to a source
363 line will remote-highlight the referenced code line.
365 The options for the BEGIN lines are:
367  - -n :: Number the lines in the example
368  - +n :: Like -n, but continue numbering from where the previous
369          example left off.
370  - -r :: Remove the coderef cookies from the example, and replace
371          links to this reference with line numbers.  This option
372          takes only effect if either -n or +n are given as well.
373          If -r is not given, coderefs simply use the label name.
374  - -l "fmt" :: Define a local format for coderef labels, see the
375       variable =org-coderef-label-format= for details.  Use this
376       of the default syntax causes conflicts with the code in the
377       code snippet you are using.
379 Here is an example:
381 #+begin_example -k
382 #+begin_src emacs-lisp -n -r
383 (defmacro org-unmodified (&rest body)                   (ref:def)
384   "Execute body without changing `buffer-modified-p'."
385   `(set-buffer-modified-p                              (ref:back)
386     (prog1 (buffer-modified-p) ,@body)))
387 #+end_src
388 [[(def)][Line (def)]] contains the macro name.  Later at line [[(back)]],
389 backquoting is used.
390 #+end_example
392 When exported, this is translated to:
393 #+begin_src emacs-lisp -n -r
394 (defmacro org-unmodified (&rest body)                   (ref:def)
395   "Execute body without changing `buffer-modified-p'."
396   `(set-buffer-modified-p                              (ref:back)
397     (prog1 (buffer-modified-p) ,@body)))
398 #+end_src
399 [[(def)][Line (def)]] contains the macro name.  Later at line [[(back)]],
400 backquoting is used.
402 Thanks to Ilya Shlyakhter for proposing this feature set.  Thanks
403 to Sebastian Rose for the key Javascript element that made the
404 remote highlighting possible.
406 *** New hooks for export preprocessing
407     The export preprocessor now runs more hooks, to allow
408     better-timed tweaking by user functions:
410 - =org-export-preprocess-hook= ::
411   Pretty much the first thing in the preprocessor.  But org-mode
412   is already active in the preprocessing buffer.
414 - =org-export-preprocess-after-include-files-hook= ::
415   This is run after the contents of included files have been inserted.
417 - =org-export-preprocess-after-tree-selection-hook= ::
418   This is run after selection of trees to be exported has
419   happened.  This selection includes tags-based selection, as
420   well as removal of commented and archived trees.
422 - =org-export-preprocess-before-backend-specifics-hook= ::
423   Hook run before backend-specific functions are called during preprocessing.
425 - =org-export-preprocess-final-hook= ::
426   Hook for preprocessing an export buffer.  This is run as the
427   last thing in the preprocessing buffer, just before returning
428   the buffer string to the backend.
430 *** Capture column view into a different file
432     The :id parameter for the dynamic block capturing column view
433     can now truly be an ID that will also be found in a
434     different file.  Also, it can be like =file:path/to/file=, to
435     capture the global column view from a different file.
437     Thanks to Francois Lagarde for his report that IDs outside
438     the current file would not work.
440 * Version 6.16
441   Cleanup of many small bugs, and one new feature.
443 ** Details
445 *** References to last table row with special names
447     Fields in the last row of a table can now be referenced with
448     $LR1, $LR2, etc.  These references can appear both on the
449     left hand side and right hand side of a formula.
451 * Version 6.15f
453   This version reverses the introduction of @0 as a reference to
454   the last rwo in a table, because of a conflict with the use of
455   @0 for the current row.
457 * Version 6.15
458 ** Overview
460 - All known LaTeX export issues fixed 
461 - Captions and attributes for figures and tables. 
462 - Better implementation for entry IDs 
463 - Spreadsheet references to the last table line. 
464 - Old syntax for link attributes abandoned 
466 ** Incompatible changes
467 *** Old syntax for link attributes abandoned
469 There used to be a syntax for setting link attributes for
470 HTML export by enclosing the attributes into double braces
471 and adding them to the link itself, like
473 #+begin_example
474 [[./img/a.jpg{{alt="an image"}}] ]
475 #+end_example
477 This syntax is not longer supported, use instead
479 #+begin_src org
480 ,#+ATTR_HTML: alt="an image"
481 [[./img/a.jpg] ]
482 #+end_src
484 ** Details
486 *** All known LaTeX export issues fixed
488 All the remaining issues with the LaTeX exporter have hopefully
489 been addressed in this release.  In particular, this covers
490 quoting of special characters in tables and problems with
491 exporting files where the headline is in the first line, or with
492 an active region.
494 *** Captions and attributes for figures and tables.
496 Tables, and Hyperlinks that represent inlined images, can now be
497 equipped with additional information that will be used during
498 export.  The information will be taken from the following special
499 lines in the buffer and apply to the first following table or
500 link.
502 - #+CAPTION: :: The caption of the image or table.  This string
503      should be processed according to the export backend, but
504      this is not yet done.
506 - #+LABEL: :: A label to identify the figure/table for cross
507      references.  For HTML export, this string will become the
508      ID for the ~<div class="figure">~ element that encapsulates
509      the image tag and the caption.  For LaTeX export, this
510      string will be used as the argument of a ~\label{...}~
511      macro.  These labels will be available for internal links
512      like ~[[label][Table] ]~.
514 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
515      added as attributes into the ~<img...>~ tag.  This string
516      will not be processed, so it should have immediately the
517      right format.
519 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
520      tables.\\
521      For /images/, this string is directly inserted into
522      the optional argument of the ~\includegraphics[...]{file}~
523      command, to specify scaling, clipping and other options.
524      This string will not be processed, so it should have
525      immediately the right format, like =width=5cm,angle=90=.\\       
526      For /tables/, this can currently contain the keyword
527      =longtable=, to request typesetting of the table using the
528      longtable package, which automatically distributes the table
529      over several pages if needed.  Also, the attributes line may
530      contain an alignment string for the tabular environment, like
531      =longtable,align=l|lrl=
533 For LaTeX export, if either a caption or a label is given, the element
534 will be exported as a float, i.e. wrapped into a figure or table
535 environment.
537 *** Better implementation for entry IDs
538     
539 Unique identifiers for entries can now be used more efficiently.
540 Internally, a hash array has replaced the alist used so far to
541 keep track of the files in which an ID is defined.  This makes it
542 quite fast to find an entry by ID.
544 There is a new link type which looks like this:
546 #+begin_example
547 id:GLOBALLY-UNIQUE-IDENTIFIER
548 #+end_example
550 This link points to a specific entry.  When you move the entry to
551 a different file, for example if you move it to an archive
552 file, the link will continue to work.
554 The file /org-id.el/ contains an API that can be used to write
555 code using these identifiers, including creating IDs and finding
556 them wherever they are.
558 Org has its own method to create unique identifiers, but if the system
559 has /uuidgen/ command installed (Mac's and Linux systems generally
560 do), it will be used by default (a change compared to the earlier
561 implmentation, where you explicitdly had to opt for uuidgen).  You can
562 also select the method by hand, using the variable =org-id-method=.
564 If the ID system ever gets confused about where a certain ID is, it
565 initiates a global scan of all agenda files with associated archives,
566 all files previously known containing any IDs, and all currently
567 visited Org-mode files to rebuild the hash.  You can also initiate
568 this by hand: =M-x org-id-update-id-locations=.  Running this command
569 will also dump into the =*Messages*= buffer information about any
570 duplicate IDs.  These should not exist, and Org will never /make/ the
571 same ID twice, but if you /copy/ an entry with its properties,
572 duplicate IDs will inevitably be produced.  Unfortunately, this is
573 unavoidable in a plain text system that allows you to edit the text in
574 arbitrary ways, and a portion of care on your side is needed to keep
575 this system clean.
577 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
578 This is also a change from previous versions where the file was
579 =~/.org=id-locations=.  Therefore, you can remove this old file
580 if you have it.  I am not sure what will happen if the =.emacs.d=
581 directory does not exists in your setup, but in modern Emacsen, I
582 believe it should exist.  If you do not want to use IDs across
583 files, you can avoid the overhead with tracking IDs by
584 customizing the variable =org-id-track-globally=.  IDs can then
585 still be used for links inside a single file.
587 IDs will also be used when you create a new link to an Org-mode
588 buffer.  If you use =org-store-link= (normally at =C-c l=) inside
589 en entry in an Org-mode buffer, and ID property will be created
590 if it does not exist, and the stored link will be an =id:= link.
591 If you prefer the much less secure linking to headline text, you
592 can configure the variable =org-link-to-org-use-id=.  The default
593 setting for this variable is =create-if-interactive=, meaning
594 that an ID will be created when you store a link interactively,
595 but not if you happen to be in an Org-mode file while you create
596 a remember note (which usually has a link to the place where you
597 were when starting remember).
599 *** Spreadsheet references to the last table line.
601 You may now use =@0= to reference the last dataline in a table
602 in a stable way.  This is useful in particular for automatically
603 generated tables like the ones using /org-collector.el/ by Eric
604 Schulte.
606 * Version 6.14
607 ** Overview
609    - New relative timer to support timed notes 
610    - Special faces can be set for individual tags 
611    - The agenda shows now all tags, including inherited ones. 
612    - Exclude some tags from inheritance. 
613    - More special values for time comparisons in property searches 
614    - Control for exporting meta data 
615    - Cut and Paste with hot links from w3m to Org 
616    - LOCATION can be inherited for iCalendar export 
617    - Relative row references crossing hlines now throw an error 
619 ** Incompatible Changes
621 *** Relative row references crossing hlines now throw an error
622     
623     Relative row references in tables look like this: "@-4" which
624     means the forth row above this one.  These row references are
625     not allowed to cross horizontal separator lines (hlines).  So
626     far, when a row reference violates this policy, Org would
627     silently choose the field just next to the hline.
629     Tassilo Horn pointed out that this kind of hidden magic is
630     actually confusing and may cause incorrect formulas, and I do
631     agree.  Therefore, trying to cross a hline with a relative
632     reference will now throw an error.
633     
634     If you need the old behavior, customize the variable
635     `org-table-error-on-row-ref-crossing-hline'.
637 ** Details
639 *** New relative timer to support timed notes
641     Org now supports taking timed notes, useful for example while
642     watching a video, or during a meeting which is also recorded.
644     - =C-c C-x .= :: 
645       Insert a relative time into the buffer.  The first time
646       you use this, the timer will be started.  When called
647       with a prefix argument, the timer is reset to 0.
649     - =C-c C-x -= :: 
650       Insert a description list item with the current relative
651       time.  With a prefix argument, first reset the timer to 0.
653     - =M-RET= ::
654       Once the time list has been initiated, you can also use the
655       normal item-creating command to insert the next timer item.
657     - =C-c C-x 0= :: 
658       Reset the timer without inserting anything into the buffer.
659       By default, the timer is reset to 0.  When called with a
660       =C-u= prefix, reset the timer to specific starting
661       offset.  The user is prompted for the offset, with a
662       default taken from a timer string at point, if any, So this
663       can be used to restart taking notes after a break in the
664       process.  When called with a double prefix argument
665       =C-c C-u=, change all timer strings in the active
666       region by a certain amount.  This can be used to fix timer
667       strings if the timer was not started at exactly the right
668       moment.
670     Thanks to Alan Dove, Adam Spiers, and Alan Davis for
671     contributions to this idea.
673 *** Special faces can be set for individual tags
675     You may now use the variable =org-tag-faces= to define the
676     face used for specific tags, much in the same way as you can
677     do for TODO keywords.
679     Thanks to Samuel Wales for this proposal.
681 *** The agenda shows now all tags, including inherited ones.
683     This request has come up often, most recently it was
684     formulated by Tassilo Horn.
686     If you prefer the old behavior of only showing the local
687     tags, customize the variable =org-agenda-show-inherited-tags=.
689 *** Exclude some tags from inheritance.
691     So far, the only way to select tags for inheritance was to
692     allow it for all tags, or to do a positive selection using
693     one of the more complex settings for
694     `org-use-tag-inheritance'.  It may actually be better to
695     allow inheritance for all but a few tags, which was difficult
696     to achieve with this methodology.
698     A new option, `org-tags-exclude-from-inheritance', allows to
699     specify an exclusion list for inherited tags.
701 *** More special values for time comparisons in property searches
703     In addition to =<now>=, =<today>=, =<yesterday>=, and
704     =<tomorrow>=, there are more special values accepted now in
705     time comparisons in property searches:  You may use strings
706     like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
707     week, month, and year, respectively
709     Thanks to Linday Todd for this proposal.
711 *** Control for exporting meta data
713     All the metadata in a headline, i.e. the TODO keyword, the
714     priority cookie, and the tags, can now be excluded from
715     export with appropriate options:
717     | Variable                      | Publishing property | OPTIONS switch |
718     |-------------------------------+---------------------+----------------|
719     | org-export-with-todo-keywords | :todo-keywords      | todo:          |
720     | org-export-with-tags          | :tags               | tags:          |
721     | org-export-with-priority      | :priority           | pri:           |
723 *** Cut and Paste with hot links from w3m to Org
725     You can now use the key =C-c C-x M-w= in a w3m buffer with
726     HTML content to copy either the region or the entire file in
727     a special way.  When you yank this text back into an Org-mode
728     buffer, all links from the w3m buffer will continue to work
729     under Org-mode.
731     For this to work you need to load the new file /org-w3m.el./
732     Please check your org-modules variable to make sure that this
733     is turned on.
735     Thanks for Richard Riley for the idea and to Andy Stewart for
736     the implementation.
738 *** LOCATION can be inherited for iCalendar export
740     The LOCATION property can now be inherited during iCalendar
741     export if you configure =org-use-property-inheritance= like
742     this:
744 #+begin_src emacs-lisp
745 (setq org-use-property-inheritance '("LOCATION"))
746 #+end_src
748 * Version 6.13
750 ** Overview
752    - Keybindings in Remember buffers can be configured
753    - Support for ido completion
754    - New face for date lines in agenda column view
755    - Invisible targets become now anchors in headlines.
756    - New contributed file /org-exp-blocks.el/
757    - New contributed file /org-eval-light.el/
758    - Link translation
759    - BBDB links may use regular expressions.
760    - Link abbreviations can use %h to insert a url-encoded target value
761    - Improved XHTML compliance
763 ** Details
765 *** Keybindings in Remember buffers can be configured
767     The remember buffers created with Org's extensions are in
768     Org-mode, which is nice to prepare snippets that will
769     actually be stored in Org-mode files.  However, this makes it
770     hard to configure key bindings without modifying the Org-mode
771     keymap.  There is now a minor mode active in these buffers,
772     `org-remember-mode', and its keymap org-remember-mode-map can
773     be used for key bindings.  By default, this map only contains
774     the bindings for =C-c C-c= to store the note, and =C-c C-k=
775     to abort it.  Use `org-remember-mode-hook' to define your own
776     bindings like
778 #+begin_src emacs-lisp
779 (add-hook
780  'org-remember-mode-hook
781  (lambda ()
782    (define-key org-remember-mode-map
783      "\C-x\C-s" 'org-remember-finalize)))
784 #+end_src
786     If you wish, you can also use this to free the =C-c C-c=
787     binding (by binding this key to nil in the minor mode map),
788     so that you can use =C-c C-c= again to set tags.
790     This modification is based on a request by Tim O'Callaghan.
792 *** Support for ido completion
794     You can now get the completion interface from /ido.el/ for
795     many of Org's internal completion commands by turning on the
796     variable =org-completion-use-ido=. =ido-mode= must also be
797     active before you can use this.
799     This change is based upon a request by Samuel Wales.
801 *** New face for date lines in agenda column view
803     When column view is active in the agenda, and when you have
804     summarizing properties, the date lines become normal column
805     lines and the separation between different days becomes
806     harder to see.  If this bothers you, you can now customize
807     the face =org-agenda-column-dateline=.
809     This is based on a request by George Pearson.
811 *** Invisible targets become now anchors in headlines.
813     These anchors can be used to jump to a directly with an HTML
814     link, just like the =sec-xxx= IDs.  For example, the
815     following will make a http link
816     =//domain/path-to-my-file.html#dummy= work:
818 #+begin_src org
819 ,# <<dummy>>
820 ,*** a headline
821 #+end_src
823     This is based on a request by Matt Lundin.
825 *** New contributed file /org-exp-blocks.el/
827     This new file implements special export behavior of
828     user-defined blocks.  The currently supported blocks are
830     - comment :: Comment blocks with author-specific markup
831     - ditaa ::  conversion of ASCII art into pretty png files
832          using Stathis  Sideris' /ditaa.jar/ program
833     - dot :: creation of graphs in the /dot/ language
834     - R :: Sweave type exporting using the R program
836     For more details and examples, see the file commentary in
837     /org-exp-blocks.el/.
839     Kudos to Eric Schulte for this new functionality, after
840     /org-plot.el/ already his second major contribution.  Thanks
841     to Stathis for this excellent program, and for allowing us to
842     bundle it with Org-mode.
844 *** New contributed file /org-eval-light.el/
846     This module gives control over execution Emacs Lisp code
847     blocks included in a file.
849     Thanks to Eric Schulte also for this file.
851 *** Link translation
853     You can now configure Org to understand many links created
854     with the Emacs Planner package, so you can cut text from
855     planner pages and paste them into Org-mode files without
856     having to re-write the links.  Among other things, this means
857     that the command =org-open-at-point-global= which follows
858     links not only in Org-mode, but in arbitrary files like
859     source code files etc, will work also with links created by
860     planner. The following customization is needed to make all of
861     this work
863 #+begin_src emacs-lisp
864 (setq org-link-translation-function
865       'org-translate-link-from-planner)
866 #+end_src
868    I guess an inverse translator could be written and integrated
869    into Planner.
871 *** BBDB links may use regular expressions.
873     This did work all along, but only now I have documented it.
875 *** =yank-pop= works again after yanking an outline tree
877     Samuel Wales had noticed that =org-yank= did mess up this
878     functionality.  Now you can use =yank-pop= again, the only
879     restriction is that the so-yanked text will not be
880     pro/demoted or folded.
882 *** Link abbreviations can use %h to insert a url-encoded target value
884     Thanks to Steve Purcell for a patch to this effect.
886 *** Improved XHTML compliance
888     Thanks to Sebastian Rose for pushing this.
890 *** Many bug fixes again.
891     
892 * Version 6.12
893 ** Overview
895    - A region of entries can now be refiled with a single command
896    - Fine-tuning the behavior of `org-yank'
897    - Formulas for clocktables
898    - Better implementation of footnotes for HTML export
899    - More languages for HTML export.
901 ** Details
903 *** A region of entries can now be refiled with a single command
904     
905     With =transient-make-mode= active (=zmacs-regions= under
906     XEmacs), you can now select a region of entries and refile
907     them all with a single =C-c C-w= command.
909     Thanks to Samuel Wales for this useful proposal.
911 *** Fine-tuning the behavior of =org-yank=
913     The behavior of Org's yanking command has been further
914     fine-tuned in order to avoid some of the small annoyances
915     this command caused.
917     - Calling =org-yank= with a prefix arg will stop any special
918       treatment and directly pass through to the normal =yank=
919       command.  Therefore, you can now force a normal yank with
920       =C-u C-y=.
922     - Subtrees will only be folded after a yank if doing so will
923       now swallow any non-white characters after the yanked text.
924       This is, I think a really important change to make the
925       command work more sanely.
927 *** Formulas for clocktables
929     You can now add formulas to a clock table, either by hand, or
930     with a =:formula= parameter.  These formulas can be used to
931     create additional columns with further analysis of the
932     measured times.
934     Thanks to Jurgen Defurne for triggering this addition.
936 *** Better implementation of footnotes for HTML export
937     
938     The footnote export in 6.11 really was not good enough.  Now
939     it works fine.  If you have customized
940     =footnote-section-tag=, make sure that your customization is
941     matched by =footnote-section-tag-regexp=.
943     Thanks to Sebastian Rose for pushing this change.
945 *** More languages for HTML export.
947     More languages are supported during HTML export.  This is
948     only relevant for the few special words Org inserts, like
949     "Table of Contents", or "Footnotes".  Also the encoding
950     issues with this feature seem to be solved now.
952     Thanks to Sebastian Rose for pushing me to fix the encoding
953     problems.
955 * Version 6.11
957 ** Overview
959    - Yanking subtree with =C-y= now adjusts the tree level
960    - State changes can now be shown in the log mode in the agenda
961    - Footnote in HTML export are now collected at the end of the document
962    - HTML export now validates again as XHTML
963    - The clock can now be resumed after exiting and re-starting Emacs
964    - Clock-related data can be saved and resumed across Emacs sessions
965    - Following file links can now use C-u C-u to force use of an external app
966    - Inserting absolute files names now abbreviates links with "~"
967    - Links to attachment files
968    - Completed repeated tasks listed briefly in agenda
969    - Remove buffers created during publishing are removed
971 ** Details
973 *** Yanking subtree with =C-y= now adjusts the tree level
974     When yanking a cut/copied subtree or a series of trees, the
975     normal yank key =C-y= now adjusts the level of the tree to
976     make it fit into the current outline position, without losing
977     its identity, and without swallowing other subtrees.
979     This uses the command =org-past-subtree=.  An additional
980     change in that command has been implemented: Normally, this
981     command picks the right outline level from the surrounding
982     *visible* headlines, and uses the smaller one.  So if the
983     cursor is between a level 4 and a level 3 headline, the tree
984     will be pasted as level 3.  If the cursor is actually *at*
985     the beginning of a headline, the level of that headline will
986     be used.  For example, lets say you have a tree like this:
988 #+begin_src org
989 ,* Level one
990 ,** Level two
991 ,(1)
992 ,(2)* Level one again
993 #+end_src
995     with (1) and (2) indicating possible cursor positions for the
996     insertion.  When at (1), the tree will be pasted as level 2.
997     When at (2), it will be pasted as level 1.
999     If you do not want =C-y= to behave like this, configure the
1000     variable =org-yank-adjusted-subtrees=.
1002     Thanks to Samuel Wales for this idea and a partial implementation.
1004 *** State changes can now be shown in the log mode in the agenda
1006     If you configure the variable =org-agenda-log-mode-items=,
1007     you can now request that all logged state changes be included
1008     in the agenda when log mode is active.  If you find this too
1009     much for normal applications, you can also temporarily
1010     request the inclusion of state changes by pressing =C-u l= in
1011     the agenda.
1013     This was a request by Hsiu-Khuern Tang.
1015     You can also press `C-u C-u l' to get *only* log items in the
1016     agenda, withour any timestamps/deadlines etc.
1018 *** Footnote in HTML export are now collected at the end of the document
1019     Previously, footnotes would be left in the document where
1020     they are defined, now they are all collected and put into a
1021     special =<div>= at the end of the document.
1023     Thanks to Sebastian Rose for this request.
1025 *** HTML export now validates again as XHTML.
1027     Thanks to Sebastian Rose for pushing this cleanup.
1029 *** The clock can now be resumed after exiting and re-starting Emacs
1031     If the option =org-clock-in-resume= is t, and the first clock
1032     line in an entry is unclosed, clocking into that task resumes
1033     the clock from that time.
1035     Thanks to James TD Smith for a patch to this effect.
1037 *** Clock-related data can be saved and resumed across Emacs sessions
1038     
1039     The data saved include the contents of =org-clock-history=,
1040     and the running clock, if there is one.
1041     
1042     To use this, you will need to add to your .emacs
1044 #+begin_src emacs-lisp
1045 (setq org-clock-persist t)
1046 (setq org-clock-in-resume t)
1047 (org-clock-persistence-insinuate)
1048 #+end_src
1050     Thanks to James TD Smith for a patch to this effect.
1052 *** Following file links can now use C-u C-u to force use of an external app.
1054     So far you could only bypass your setup in `org-file-apps'
1055     and force opening a file link in Emacs by using a =C-u= prefix arg
1056     with =C-c C-o=.  Now you can call =C-u C-u C-c C-o= to force
1057     an external application.  Which external application depends
1058     on your system.  On Mac OS X and Windows, =open= is used.  On
1059     a GNU/Linux system, the mailcap settings are used.
1061     This was a proposal by Samuel Wales.
1063 *** Inserting absolute files names now abbreviates links with "~".
1065     Inserting file links with =C-u C-c C-l= was buggy if the
1066     setting of `org-link-file-path-type' was `adaptive' (the
1067     default).  Absolute file paths were not abbreviated relative
1068     to the users home directory.  This bug has been fixed.
1070     Thanks to Matt Lundin for the report.
1072 *** Links to attachment files
1074     Even though one of the purposes of entry attachments was to
1075     reduce the number of links in an entry, one might still want
1076     to have the occasional link to one of those files.  You can
1077     now use link abbreviations to set up a special link type that
1078     points to attachments in the current entry.  Note that such
1079     links will only work from within the same entry that has the
1080     attachment, because the directory path is entry specific.
1081     Here is the setup you need:
1083 #+begin_src emacs-lisp
1084 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
1085 #+end_src
1087     After this, a link like this will work
1089 #+BEGIN_EXAMPLE
1090      [[att:some-attached-file.txt]]
1091 #+END_EXAMPLE
1092     This was a proposal by Lindsay Todd.
1094 *** Completed repeated tasks listed briefly in agenda
1096     When a repeating task, listed in the daily/weekly agenda under
1097     today's date, is completed from the agenda, it is listed as
1098     DONE in the agenda until the next update happens.  After the
1099     next update, the task will have disappeared, of course,
1100     because the new date is no longer today.
1101     
1102 *** Remove buffers created during publishing are removed
1104     Buffers that are created during publishing are now deleted
1105     when the publishing is over.  At least I hope it works like this.
1107 * Version 6.10
1109 ** Overview
1111    - Secondary agenda filtering is becoming a killer feature
1112    - Setting tags has now its own binding, =C-c C-q=
1113    - Todo state changes can trigger tag changes
1114    - C-RET will now always insert a new headline, never an item.
1115    - Customize org-mouse.el feature set to free up mouse events
1116    - New commands for export all the way to PDF (through LaTeX)
1117    - Some bug fixed for LaTeX export, more bugs remain.
1119 ** Details
1121 *** Enhancements to secondary agenda filtering
1123     This is, I believe, becoming a killer feature.  It allows you
1124     to define fewer and more general custom agenda commands, and
1125     then to do the final narrowing to specific tasks you are
1126     looking for very quickly, much faster than calling a new
1127     agenda command.
1129     If you have not tries this yet, you should!
1131 **** You can now refining the current filter by an additional criterion
1132       When filtering an existing agenda view with =/=, you can
1133       now narrow down the existing selection by an additional
1134       condition.  Do do this, use =\= instead of =/= to add the
1135       additional criterion.  You can also press =+= or =-= after
1136       =/= to add a positive or negative condition.  A condition
1137       can be a TAG, or an effort estimate limit, see below.
1139 **** It is now possible to filter for effort estimates
1140      This means to filter the agenda for the value of the Effort
1141      property.  For this you should best set up global allowed
1142      values for effort estimates, with
1144 #+begin_src emacs-lisp
1145 (setq org-global-properties
1146       '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
1147 #+end_src
1148       
1149      You may then select effort limits with single keys in the
1150      filter.  It works like this:  After =/= or =\=, first select
1151      the operator which you want to use to compare effort
1152      estimates:
1154      : <   Select entries with effort smaller than or equal to the limit
1155      : >   Select entries with effort larger than or equal to the limit
1156      : =   Select entries with effort equal to the limit
1158      After that, you can press a single digit number which is
1159      used as an index to the allowed effort estimates.
1161      If you do not use digits to fast-select tags, you can even
1162      skip the operator, which will then default to
1163      `org-agenda-filter-effort-default-operator', which is by
1164      default =<=.
1166      Thanks to Manish for the great idea to include fast effort
1167      filtering into the agenda filtering process.
1169 **** The mode line will show the active filter
1170      For example, if there is a filter in place that does select
1171      for HOME tags, against EMAIL tags, and for tasks with an
1172      estimated effort smaller than 30 minutes, the mode-line with
1173      show =+HOME-EMAIL+<0:30=
1175 **** The filter now persists when the agenda view is refreshed
1176      All normal refresh commands, including those that move the
1177      weekly agenda from one week to the next, now keep the
1178      current filter in place.
1180      You need to press =/ /= to turn off the filter.  However,
1181      when you run a new agenda command, for example going from
1182      the weekly agenda to the TODO list, the filter will be
1183      switched off.
1184    
1185 *** Setting tags has now its own binding, =C-c C-q=
1187     You can still use =C-c C-c= on a headline, but the new
1188     binding should be considered as the main binding for this
1189     command.  The reasons for this change are:
1191     - Using =C-c C-c= for tags is really out of line with other
1192       uses of =C-c C-c=.
1194     - I hate it in Remember buffers when I try to set tags and I
1195       cannot, because =C-c C-c= exits the buffer :-(
1197     - =C-c C-q= will also work when the cursor is somewhere down
1198       in the entry, it does not have to be on the headline.
1200 *** Todo state changes can trigger tag changes
1202     The new option =org-todo-state-tags-triggers= can be used to
1203     define automatic changes to tags when a TODO state changes.
1204     For example, the setting
1206     : (setq org-todo-state-tags-triggers
1207     :       '((done ("Today" . nil) ("NEXT" . nil))
1208     :         ("WAITING" ("Today" . t))))    
1210     will make sure that any change to any of the DONE states will
1211     remove tags "Today" and "NEXT", while switching to the
1212     "WAITING" state will trigger the tag "Today" to be added.
1214     I use this mostly to get rid of TODAY and NEXT tags which I
1215     apply to select an entry for execution in the near future,
1216     which I often prefer to specific time scheduling.
1218 *** C-RET will now always insert a new headline, never an item.
1219     The new headline is inserted after the current subtree.
1221     Thanks to Peter Jones for patches to fine-tune this behavior.
1223 *** Customize org-mouse.el feature set
1224     There is a new variable =org-mouse-features= which gives you
1225     some control about what features of org-mouse you want to
1226     use.  Turning off some of the feature will free up the
1227     corresponding mouse events, or will avoid activating special
1228     regions for mouse clicks.  By default I have urned off the
1229     feature to use drag mouse events to move or promote/demote
1230     entries.  You can of course turn them back on if you wish.
1232     This variable may still change in the future, allowing more
1233     fine-grained control.
1235 *** New commands for export to PDF
1237     This is using LaTeX export, and then processes it to PDF
1238     using pdflatex.
1240     : C-c C-e p     process to PDF.
1241     : C-c C-e d     process to PDF, and open the file.
1243 *** LaTeX export
1244     - \usepackage{graphicx} is now part of the standard class
1245       definitions.
1246     - Several bugs fixed, but definitely not all of them :-(
1248 *** New option `org-log-state-notes-insert-after-drawers'
1250     Set this to =t= if you want state change notes to be inserted
1251     after any initial drawers, i.e drawers the immediately follow
1252     the headline and the planning line (the one with
1253     DEADLINE/SCHEDULED/CLOSED information).
1255 * Version 6.09
1256 ** Incompatible
1257 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1259 ** Details
1261 *** =org-file-apps= now uses regular repressions instead of extensions
1262     Just like in =auto-mode-alist=, car's in the variable
1263     =org-file-apps= that are strings are now interpreted as
1264     regular expressions that are matched against a file name.  So
1265     instead of "txt", you should now write "\\.txt\\'" to make
1266     sure the matching is done correctly (even though "txt" will
1267     be recognized and still be interpreted as an extension).
1269     There is now a shortcut to get many file types visited by
1270     Emacs.  If org-file-apps contains `(auto-mode . emacs)', then
1271     any files that are matched by `auto-mode-alist' will be
1272     visited in emacs.
1274 *** Changes to the attachment system
1276     - The default method to attach a file is now to copy it
1277       instead of moving it.
1278     - You can modify the default method using the variable
1279       `org-attach-method'.  I believe that most Unix people want
1280       to set it to `ln' to create hard links.
1281     - The keys =c=, =m=, and =l= specifically select =copy=,
1282       =move=, or =link=, respectively, as the attachment method
1283       for a file, overruling  `org-attach-method'.
1284     - To create a new attachment as an Emacs buffer, you have not
1285       now use =n= instead of =c=.
1286     - The file list is now always retrieved from the directory
1287       itself, not from the "Attachments" property.  We still
1288       keep this property by default, but you can turn it off, by
1289       customizing the variable =org-attach-file-list-property=.
1291 * Version 6.08
1293 ** Incompatible changes
1295    - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
1297    - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
1299 ** Details
1301 *** The default structure of IDs has changed
1303     IDs created by Org have changed a bit:
1304     - By default, there is no prefix on the ID.  There used to be
1305       an "Org" prefix, but I now think this is not necessary.
1306     - IDs use only lower-case letters, no upper-case letters
1307       anymore.  The reason for this is that IDs are now also used
1308       as directory names for org-attach, and some systems do not
1309       distinguish upper and lower case in the file system.
1310     - The ID string derived from the current time is now
1311       /reversed/ to become an ID.  This assures that the first
1312       two letters of the ID change fast, so hat it makes sense to
1313       split them off to create subdirectories to balance load.
1314     - You can now set the `org-id-method' to `uuidgen' on systems
1315       which support it.
1317 *** =C-c C-a= no longer calls `show-all'
1319     The reason for this is that =C-c C-a= is now used for the
1320     attachment system.  On the rare occasions that this command
1321     is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
1323 *** New attachment system
1325     You can now attach files to each node in the outline tree.
1326     This works by creating special directories based on the ID of
1327     an entry, and storing files in these directories.  Org can
1328     keep track of changes to the attachments by automatically
1329     committing changes to git.  See the manual for more
1330     information.
1332     Thanks to John Wiegley who contributed this fantastic new
1333     concept and wrote org-attach.el to implement it.
1335 *** New remember template escapes
1337     : %^{prop}p   to insert a property
1338     : %k          the heading of the item currently being clocked
1339     : %K          a link to the heading of the item currently being clocked
1341     Also, when you exit remember with =C-2 C-c C-c=, the item
1342     will be filed as a child of the item currently being
1343     clocked.  So the idea is, if you are working on something and
1344     think of a new task related to this or a new note to be
1345     added, you can use this to quickly add information to that
1346     task.
1348     Thanks to James TD Smith for a patch to this effect.
1350 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
1351     
1352     Thanks to James TD Smith for a patch to this effect.
1354 *** New file in contrib: lisp/org-checklist.el
1356     This module deals with repeated tasks that have checkbox
1357     lists below them.
1359     Thanks to James TD Smith for this contribution.
1361 *** New in-buffer setting #+STYLE
1363     It can be used to locally set the variable
1364     `org-export-html-style-extra'.  Several such lines are
1365     allowed-, they will all be concatenated.  For an example on
1366     how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1368 * Version 6.07
1370 ** Overview
1372    - Filtering existing agenda views with respect to a tag
1373    - Editing fixed-width regions with picture or artist mode
1374    - /org-plot.el/ is now part of Org
1375    - Tags can be used to select the export part of a document
1376    - Prefix interpretation when storing remember notes
1377    - Yanking inserts folded subtrees
1378    - Column view capture tables can have formulas, plotting info
1379    - In column view, date stamps can be changed with S-cursor keys
1380    - The note buffer for clocking out now mentions the task
1381    - Sorting entries alphabetically ignores TODO keyword and priority
1382    - Agenda views can sort entries by TODO state
1383    - New face =org-scheduled= for entries scheduled in the future.
1384    - Remember templates for gnus links can use the :to escape.
1385    - The file specification in a remember template may be a function
1386    - Categories in iCalendar export include local tags
1387    - It is possible to define filters for column view
1388    - Disabling integer increment during table Field copy
1389    - Capturing column view is on `C-c C-x i'
1390    - And tons of bugs fixed.  
1393 ** Incompatible changes
1395 *** Prefix interpretation when storing remember notes has changed
1397     The prefix argument to the `C-c C-c' command that finishes a
1398     remember process is now interpreted differently:
1400     : C-c C-c       Store the note to predefined file and headline
1401     : C-u C-c C-c   Like C-c C-c, but immediately visit the note
1402     :               in its new location.
1403     : C-1 C-c C-c   Select the storage location interactively
1404     : C-0 C-c C-c   Re-use the last used location
1406     This was requested by John Wiegley.
1408 *** Capturing column view is now on `C-c C-x i'
1410     The reason for this change was that `C-c C-x r' is also used
1411     as a tty key replacement.
1413 *** Categories in iCalendar export now include local tags
1415     The locally defined tags are now listed as categories when
1416     exporting to iCalendar format.  Org's traditional file/tree
1417     category is now the last category in this list.  Configure
1418     the variable =org-icalendar-categories= to modify or revert
1419     this behavior.
1421     This was a request by Charles Philip Chan.
1423 ** Details
1425 *** Secondary filtering of agenda views.
1427     You can now easily and interactively filter an existing
1428     agenda view with respect to a tag.  This command is executed
1429     with the =/= key in the agenda.  You will be prompted for a
1430     tag selection key, and all entries that do not contain or
1431     inherit the corresponding tag will be hidden.  With a prefix
1432     argument, the opposite filter is applied: entries that
1433     do have the tag will be hidden.
1435     This operation only /hides/ lines in the agenda buffer, it
1436     does not remove them.  Changing the secondary filtering does
1437     not require a new search and is very fast.
1439     If you press TAB at the tag selection prompt, you will be
1440     switched to a completion interface to select a tag.  This is
1441     useful when you want to select a tag that does not have a
1442     direct access character.
1444     A double =/ /= will restore the original agenda view by
1445     unhiding any hidden lines.
1447     This functionality was John Wiegley's idea.  It is a simpler
1448     implementation of some of the query-editing features proposed
1449     and implemented some time ago by Christopher League (see the
1450     file contrib/lisp/org-interactive-query.el).
1452 *** Editing fixed-width regions with picture or artist mode
1454     The command @<code>C-c '@</code> (that is =C-c= followed by a
1455     single quote) can now also be used to switch to a special
1456     editing mode for fixed-width sections.  The default mode is
1457     =artist-mode= which allows you to create ASCII drawings.
1459     It works like this: Enter the editing mode with
1460     @<code>C-c '@</code>.  An indirect buffer will be created and
1461     narrowed to the fixed-width region.  Edit the drawing, and
1462     press @<code>C-c '@</code> again to exit.
1464     Lines in a fixed-width region should be preceded by a colon
1465     followed by at least one space.  These will be removed during
1466     editing, and then added back when you exit the editing mode.
1468     Using the command in an empty line will create a new
1469     fixed-width region.
1471     This new feature arose from a discussion involving Scott
1472     Otterson, Sebastian Rose and Will Henney.
1474 *** /org-plot.el/ is now part of Org.
1476     You can run it by simple calling org-plot/gnuplot.
1477     Documentation is not yet included with Org, please refer to
1478     http://github.com/eschulte/org-plot/tree/master until we have
1479     moved the docs into Org or Worg.
1481     Thanks to Eric Schulte for this great contribution.
1483 *** Tags can be used to select the export part of a document
1485     You may now use tags to select parts of a document for
1486     inclusion into the export, and to exclude other parts.  This
1487     behavior is governed by two new variables:
1488     =org-export-select-tags= and =org-export-exclude-tags=.
1489     These default to =("export")= and =("noexport")=, but can be
1490     changed, even to include a list of several tags.
1492     Org first checks if any of the /select/ tags is present in
1493     the buffer.  If yes, all trees that do not carry one of these
1494     tags will be excluded.  If a selected tree is a subtree, the
1495     heading hierarchy above it will also be selected for export,
1496     but not the text below those headings.  If none of the select
1497     tags is found anywhere in the buffer, the whole buffer will
1498     be selected for export.  Finally, all subtrees that are
1499     marked by any of the /exclude/ tags will be removed from the
1500     export buffer.
1502     You may set these tags with in-buffer options
1503     =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1505     I love this feature.  Thanks to Richard G Riley for coming
1506     up with the idea.
1508 *** Prefix interpretation when storing remember notes
1510     The prefix argument to the `C-c C-c' command that finishes a
1511     remember process is now interpreted differently:
1513     : C-c C-c       Store the note to predefined file and headline
1514     : C-u C-c C-c   Like C-c C-c, but immediately visit the note
1515     :               in its new location.
1516     : C-1 C-c C-c   Select the storage location interactively
1517     : C-0 C-c C-c   Re-use the last used location
1519     This was requested by John Wiegley.
1521 *** Yanking inserts folded subtrees
1523     If the kill is a subtree or a sequence of subtrees, yanking
1524     them with =C-y= will leave all the subtrees in a folded
1525     state.  This basically means, that kill and yank are now
1526     much more useful in moving stuff around in your outline.  If
1527     you do not like this, customize the variable
1528     =org-yank-folded-subtrees=.
1530     Right now, I am only binding =C-y= to this new function,
1531     should I modify all bindings of yank?  Do we need to amend
1532     =yank-pop= as well?
1534     This feature was requested by John Wiegley.
1536 *** Column view capture tables can have formulas, plotting info
1538     If you attach formulas and plotting instructions to a table
1539     capturing column view, these extra lines will now survive an
1540     update of the column view capture, and any formulas will be
1541     re-applied to the captured table.  This works by keeping any
1542     continuous block of comments before and after the actual
1543     table.
1545 *** In column view, date stamps can be changed with S-cursor keys
1547     If a property value is a time stamp, S-left and S-right can
1548     now be used to shift this date around while in column view.
1550     This was a request by Chris Randle.
1552 *** The note buffer for clocking out now mentions the task
1553     
1554     This was a request by Peter Frings.
1556 *** Sorting entries alphabetically ignores TODO keyword and priority
1558     Numerical and alphanumerical sorting now skips any TODO
1559     keyword or priority cookie when constructing the comparison
1560     string.  This was a request by Wanrong Lin.
1562 *** Agenda views can sort entries by TODO state
1564     You can now define a sorting strategy for agenda entries that
1565     does look at the TODO state of the entries.  Sorting by TODO
1566     entry does first separate the non-done from the done states.
1567     Within each class, the entries are sorted not alphabetically,
1568     but in definition order.  So if you have a sequence of TODO
1569     entries defined, the entries will be sorted according to the
1570     position of the keyword in this sequence.
1572     This follows an idea and sample implementation by Christian
1573     Egli.
1575 *** New face =org-scheduled= for entries scheduled in the future.
1577     This was a request by Richard G Riley.
1579 *** Remember templates for gnus links can now use the :to escape.
1581     Thanks to Tommy Lindgren for a patch to this effect.
1582 *** The file specification in a remember template may now be a function
1584     Thanks to Gregory Sullivan for a patch to this effect.
1586 *** Categories in iCalendar export now include local tags
1588     The locally defined tags are now listed as categories when
1589     exporting to iCalendar format.  Org's traditional file/tree
1590     category is now the last category in this list.  Configure
1591     the variable =org-icalendar-categories= to modify or revert
1592     this behavior.
1594     This was a request by Charles Philip Chan.
1596 *** It is now possible to define filters for column view
1598     The filter can modify the value that will be displayed in a
1599     column, for example it can cut out a part of a time stamp.
1600     For more information, look at the variable
1601     =org-columns-modify-value-for-display-function=.
1603 *** Disabling integer increment during table field copy
1605     Prefix arg 0 to S-RET does the trick.
1607     This was a request by Chris Randle.
1610 * Older changes
1612   For older Changes, see [[file:Changes_old.org]]
1615