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