Website: Minor fixes.
[org-mode/org-tableheadings.git] / ORGWEBPAGE / Changes.org
blob1d715a3f782205c90d9b732b106d20a6b0dfa510
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.17
15 ** Overview
17 - Footnote support
18 - Line numbers and references in literal examples 
19 - New hooks for export preprocessing 
20 - Capture column view into a different file
22 ** Details
24 *** Footnote support
26 Org-mode now directly supports the creation of footnotes.  In
27 contrast to the /footnote.el/ package, Org-mode's footnotes are
28 designed for work on a larger document, not only for one-off
29 documents like emails.  The basic syntax is similar to the one
30 used by /footnote.el/, i.e. a footnote is defined in a paragraph
31 that is started by a footnote marker in square brackets in column
32 0, no indentation allowed.  The footnote reference is simply the
33 marker in square brackets inside text.  For example:
35 #+begin_src org
36 The Org homepage[fn:1] now looks a lot better than it used to.
37 ...
38 [fn:1] The link is: http://orgmode.org
39 #+end_src
41 Org-mode extends the number-based syntax to /named/ footnotes and
42 optional inline definition.  Using plain numbers as markers is
43 supported for backward compatibility, but not encouraged because
44 of possible conflicts with LaTeX syntax.  Here are the valid
45 references:
47 - [1] ::  A plain numeric footnote marker.
48          
49 - [fn:name] :: A named footnote reference, where `name' is a
50      unique label word or, for simplicity of automatic creation,
51      a number. 
52      
53 - [fn:: This is the inline definition of this footnote] :: A
54      LaTeX-like anonymous footnote where the definition is given
55      directly at the reference point.
57 - [fn:name: a definition] :: An inline definition of a footnote,
58      which also specifies a name for the note.  Since Org allows
59      multiple references to the same note, you can then use use
60      `[fn:name]' to create additional references.
62 Footnote labels can be created automatically, or you create names
63 yourself.  This is handled by the variable
64 =org-footnote-auto-label= and its corresponding =#+STARTUP=
65 keywords, see the docstring of that variable for details.
67 The following command handles footnotes:
69 - C-c C-x f :: The footnote action command.  When the cursor is
70      on a footnote reference, jump to the definition.  When it is
71      at a definition, jump to the (first) reference.  Otherwise,
72      create a new footnote.  Depending on the variable
73      `org-footnote-define-inline' (with associated =#+STARTUP=
74      options =fninline= and =nofninline=), the definitions will
75      be placed right into the text as part of the reference, or
76      separately into the location determined by the variable
77      =org-footnote-section=.
78      When this command is called with a prefix argument, a menu
79      of additional options is offered:
80      - s :: Sort the footnote definitions by reference sequence.
81             During editing, Org makes no effort to sort footnote
82             definitions into a particular sequence.  If you want
83             them sorted, use this command, which will also move
84             entries according to =org-footnote-section=.
85      - n :: Normalize the footnotes by collecting all
86             definitions (including inline definitions) into a
87             special section, and then numbering them in
88             sequence.  The references will then also be
89             numbers.  This is meant to be the final step before
90             finishing a document (e.g. sending off an email).
91             The exporters do this automatically, and so could 
92             something like `message-send-hook'.
93      - d :: Delete the footnote at point, and all references to it.
94             
95 - C-c C-c :: If the cursor is on a footnote reference, jump to
96      the definition.  If it is a the definition, jump back to the
97      reference.  When called with a prefix argument at either
98      location, offer the same menu as `C-u C-c C-x f'.
100 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
101      corresponding definition/reference, and you can use the
102      usual commands to follow these links.
104 Org-mode's footnote support is designed so that it should also
105 work in buffers that are not in Org-mode, for example in email
106 messages.  Just bind =org-footnote-action= to a global key like
107 =C-c f=.
109 The main trigger for this development came from a hook function
110 written by Paul Rivier, to implement named footnotes and to
111 convert them to numbered ones before export.  Thanks, Paul!
113 Thanks also to Scot Becker for a thoughtful post bringing this
114 subject back onto the discussion table, and to Matt Lundin for
115 the idea of named footnotes and his prompt testing of the new
116 features.
118 *** Line numbers and references in literal examples
120 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
121 do now allow optional line numbering in the example.
122 Furthermore, links to specific code lines are supported, greatly
123 increasing Org-mode's utility for writing tutorials and other
124 similar documents.
126 Code references use special labels embedded directly into the
127 source code.  Such labels look like "(ref:name)" and must be
128 unique within a document.  Org-mode links with "(name)" in the
129 link part will be correctly interpreted, both while working with
130 an Org file (internal links), and while exporting to the
131 different backends.  Line numbering and code references are
132 supported for all three major backends, HTML, LaTeX, and ASCII.
133 In the HTML backend, hovering the mouse over a link to a source
134 line will remote-highlight the referenced code line.
136 The options for the BEGIN lines are:
138  - -n :: Number the lines in the example
139  - +n :: Like -n, but continue numbering from where the previous
140          example left off.
141  - -r :: Remove the coderef cookies from the example, and replace
142          links to this reference with line numbers.  This option
143          takes only effect if either -n or +n are given as well.
144          If -r is not given, coderefs simply use the label name.
145  - -l "fmt" :: Define a local format for coderef labels, see the
146       variable =org-coderef-label-format= for details.  Use this
147       of the default syntax causes conflicts with the code in the
148       code snippet you are using.
150 Here is an example:
152 #+begin_example -k
153 #+begin_src emacs-lisp -n -r
154 (defmacro org-unmodified (&rest body)                   (ref:def)
155   "Execute body without changing `buffer-modified-p'."
156   `(set-buffer-modified-p                              (ref:back)
157     (prog1 (buffer-modified-p) ,@body)))
158 #+end_src
159 [[(def)][Line (def)]] contains the macro name.  Later at line [[(back)]],
160 backquoting is used.
161 #+end_example
163 When exported, this is translated to:
164 #+begin_src emacs-lisp -n -r
165 (defmacro org-unmodified (&rest body)                   (ref:def)
166   "Execute body without changing `buffer-modified-p'."
167   `(set-buffer-modified-p                              (ref:back)
168     (prog1 (buffer-modified-p) ,@body)))
169 #+end_src
170 [[(def)][Line (def)]] contains the macro name.  Later at line [[(back)]],
171 backquoting is used.
173 Thanks to Ilya Shlyakhter for proposing this feature set.  Thanks
174 to Sebastian Rose for the key Javascript element that made the
175 remote highlighting possible.
177 *** New hooks for export preprocessing
178     The export preprocessor now runs more hooks, to allow
179     better-timed tweaking by user functions:
181 - =org-export-preprocess-hook= ::
182   Pretty much the first thing in the preprocessor.  But org-mode
183   is already active in the preprocessing buffer.
185 - =org-export-preprocess-after-include-files-hook= ::
186   This is run after the contents of included files have been inserted.
188 - =org-export-preprocess-after-tree-selection-hook= ::
189   This is run after selection of trees to be exported has
190   happened.  This selection includes tags-based selection, as
191   well as removal of commented and archived trees.
193 - =org-export-preprocess-before-backend-specifics-hook= ::
194   Hook run before backend-specific functions are called during preprocessing.
196 - =org-export-preprocess-final-hook= ::
197   Hook for preprocessing an export buffer.  This is run as the
198   last thing in the preprocessing buffer, just before returning
199   the buffer string to the backend.
201 *** Capture column view into a different file
203     The :id parameter for the dynamic block capturing column view
204     can now truly be an ID that will also be found in a
205     different file.  Also, it can be like =file:path/to/file=, to
206     capture the global column view from a different file.
208     Thanks to Francois Lagarde for his report that IDs outside
209     the current file would not work.
211 * Version 6.16
212   :PROPERTIES:
213   :VISIBILITY: content
214   :END:
215   Cleanup of many small bugs, and one new feature.
217 ** Details
219 *** References to last table row with special names
221     Fields in the last row of a table can now be referenced with
222     $LR1, $LR2, etc.  These references can appear both on the
223     left hand side and right hand side of a formula.
225 * Version 6.15f
227   This version reverses the introduction of @0 as a reference to
228   the last rwo in a table, because of a conflict with the use of
229   @0 for the current row.
231 * Version 6.15
232 ** Overview
234 - All known LaTeX export issues fixed 
235 - Captions and attributes for figures and tables. 
236 - Better implementation for entry IDs 
237 - Spreadsheet references to the last table line. 
238 - Old syntax for link attributes abandoned 
240 ** Incompatible changes
241 *** Old syntax for link attributes abandoned
243 There used to be a syntax for setting link attributes for
244 HTML export by enclosing the attributes into double braces
245 and adding them to the link itself, like
247 #+begin_example
248 [[./img/a.jpg{{alt="an image"}}] ]
249 #+end_example
251 This syntax is not longer supported, use instead
253 #+begin_src org
254 ,#+ATTR_HTML: alt="an image"
255 [[./img/a.jpg] ]
256 #+end_src
258 ** Details
260 *** All known LaTeX export issues fixed
262 All the remaining issues with the LaTeX exporter have hopefully
263 been addressed in this release.  In particular, this covers
264 quoting of special characters in tables and problems with
265 exporting files where the headline is in the first line, or with
266 an active region.
268 *** Captions and attributes for figures and tables.
270 Tables, and Hyperlinks that represent inlined images, can now be
271 equipped with additional information that will be used during
272 export.  The information will be taken from the following special
273 lines in the buffer and apply to the first following table or
274 link.
276 - #+CAPTION: :: The caption of the image or table.  This string
277      should be processed according to the export backend, but
278      this is not yet done.
280 - #+LABEL: :: A label to identify the figure/table for cross
281      references.  For HTML export, this string will become the
282      ID for the ~<div class="figure">~ element that encapsulates
283      the image tag and the caption.  For LaTeX export, this
284      string will be used as the argument of a ~\label{...}~
285      macro.  These labels will be available for internal links
286      like ~[[label][Table] ]~.
288 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
289      added as attributes into the ~<img...>~ tag.  This string
290      will not be processed, so it should have immediately the
291      right format.
293 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
294      tables.\\
295      For /images/, this string is directly inserted into
296      the optional argument of the ~\includegraphics[...]{file}~
297      command, to specify scaling, clipping and other options.
298      This string will not be processed, so it should have
299      immediately the right format, like =width=5cm,angle=90=.\\       
300      For /tables/, this can currently contain the keyword
301      =longtable=, to request typesetting of the table using the
302      longtable package, which automatically distributes the table
303      over several pages if needed.  Also, the attributes line may
304      contain an alignment string for the tabular environment, like
305      =longtable,align=l|lrl=
307 For LaTeX export, if either a caption or a label is given, the element
308 will be exported as a float, i.e. wrapped into a figure or table
309 environment.
311 *** Better implementation for entry IDs
312     
313 Unique identifiers for entries can now be used more efficiently.
314 Internally, a hash array has replaced the alist used so far to
315 keep track of the files in which an ID is defined.  This makes it
316 quite fast to find an entry by ID.
318 There is a new link type which looks like this:
320 #+begin_example
321 id:GLOBALLY-UNIQUE-IDENTIFIER
322 #+end_example
324 This link points to a specific entry.  When you move the entry to
325 a different file, for example if you move it to an archive
326 file, the link will continue to work.
328 The file /org-id.el/ contains an API that can be used to write
329 code using these identifiers, including creating IDs and finding
330 them wherever they are.
332 Org has its own method to create unique identifiers, but if the system
333 has /uuidgen/ command installed (Mac's and Linux systems generally
334 do), it will be used by default (a change compared to the earlier
335 implmentation, where you explicitdly had to opt for uuidgen).  You can
336 also select the method by hand, using the variable =org-id-method=.
338 If the ID system ever gets confused about where a certain ID is, it
339 initiates a global scan of all agenda files with associated archives,
340 all files previously known containing any IDs, and all currently
341 visited Org-mode files to rebuild the hash.  You can also initiate
342 this by hand: =M-x org-id-update-id-locations=.  Running this command
343 will also dump into the =*Messages*= buffer information about any
344 duplicate IDs.  These should not exist, and Org will never /make/ the
345 same ID twice, but if you /copy/ an entry with its properties,
346 duplicate IDs will inevitably be produced.  Unfortunately, this is
347 unavoidable in a plain text system that allows you to edit the text in
348 arbitrary ways, and a portion of care on your side is needed to keep
349 this system clean.
351 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
352 This is also a change from previous versions where the file was
353 =~/.org=id-locations=.  Therefore, you can remove this old file
354 if you have it.  I am not sure what will happen if the =.emacs.d=
355 directory does not exists in your setup, but in modern Emacsen, I
356 believe it should exist.  If you do not want to use IDs across
357 files, you can avoid the overhead with tracking IDs by
358 customizing the variable =org-id-track-globally=.  IDs can then
359 still be used for links inside a single file.
361 IDs will also be used when you create a new link to an Org-mode
362 buffer.  If you use =org-store-link= (normally at =C-c l=) inside
363 en entry in an Org-mode buffer, and ID property will be created
364 if it does not exist, and the stored link will be an =id:= link.
365 If you prefer the much less secure linking to headline text, you
366 can configure the variable =org-link-to-org-use-id=.  The default
367 setting for this variable is =create-if-interactive=, meaning
368 that an ID will be created when you store a link interactively,
369 but not if you happen to be in an Org-mode file while you create
370 a remember note (which usually has a link to the place where you
371 were when starting remember).
373 *** Spreadsheet references to the last table line.
375 You may now use =@0= to reference the last dataline in a table
376 in a stable way.  This is useful in particular for automatically
377 generated tables like the ones using /org-collector.el/ by Eric
378 Schulte.
380 * Version 6.14
381 ** Overview
383    - New relative timer to support timed notes 
384    - Special faces can be set for individual tags 
385    - The agenda shows now all tags, including inherited ones. 
386    - Exclude some tags from inheritance. 
387    - More special values for time comparisons in property searches 
388    - Control for exporting meta data 
389    - Cut and Paste with hot links from w3m to Org 
390    - LOCATION can be inherited for iCalendar export 
391    - Relative row references crossing hlines now throw an error 
393 ** Incompatible Changes
395 *** Relative row references crossing hlines now throw an error
396     
397     Relative row references in tables look like this: "@-4" which
398     means the forth row above this one.  These row references are
399     not allowed to cross horizontal separator lines (hlines).  So
400     far, when a row reference violates this policy, Org would
401     silently choose the field just next to the hline.
403     Tassilo Horn pointed out that this kind of hidden magic is
404     actually confusing and may cause incorrect formulas, and I do
405     agree.  Therefore, trying to cross a hline with a relative
406     reference will now throw an error.
407     
408     If you need the old behavior, customize the variable
409     `org-table-error-on-row-ref-crossing-hline'.
411 ** Details
413 *** New relative timer to support timed notes
415     Org now supports taking timed notes, useful for example while
416     watching a video, or during a meeting which is also recorded.
418     - =C-c C-x .= :: 
419       Insert a relative time into the buffer.  The first time
420       you use this, the timer will be started.  When called
421       with a prefix argument, the timer is reset to 0.
423     - =C-c C-x -= :: 
424       Insert a description list item with the current relative
425       time.  With a prefix argument, first reset the timer to 0.
427     - =M-RET= ::
428       Once the time list has been initiated, you can also use the
429       normal item-creating command to insert the next timer item.
431     - =C-c C-x 0= :: 
432       Reset the timer without inserting anything into the buffer.
433       By default, the timer is reset to 0.  When called with a
434       =C-u= prefix, reset the timer to specific starting
435       offset.  The user is prompted for the offset, with a
436       default taken from a timer string at point, if any, So this
437       can be used to restart taking notes after a break in the
438       process.  When called with a double prefix argument
439       =C-c C-u=, change all timer strings in the active
440       region by a certain amount.  This can be used to fix timer
441       strings if the timer was not started at exactly the right
442       moment.
444     Thanks to Alan Dove, Adam Spiers, and Alan Davis for
445     contributions to this idea.
447 *** Special faces can be set for individual tags
449     You may now use the variable =org-tag-faces= to define the
450     face used for specific tags, much in the same way as you can
451     do for TODO keywords.
453     Thanks to Samuel Wales for this proposal.
455 *** The agenda shows now all tags, including inherited ones.
457     This request has come up often, most recently it was
458     formulated by Tassilo Horn.
460     If you prefer the old behavior of only showing the local
461     tags, customize the variable =org-agenda-show-inherited-tags=.
463 *** Exclude some tags from inheritance.
465     So far, the only way to select tags for inheritance was to
466     allow it for all tags, or to do a positive selection using
467     one of the more complex settings for
468     `org-use-tag-inheritance'.  It may actually be better to
469     allow inheritance for all but a few tags, which was difficult
470     to achieve with this methodology.
472     A new option, `org-tags-exclude-from-inheritance', allows to
473     specify an exclusion list for inherited tags.
475 *** More special values for time comparisons in property searches
477     In addition to =<now>=, =<today>=, =<yesterday>=, and
478     =<tomorrow>=, there are more special values accepted now in
479     time comparisons in property searches:  You may use strings
480     like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
481     week, month, and year, respectively
483     Thanks to Linday Todd for this proposal.
485 *** Control for exporting meta data
487     All the metadata in a headline, i.e. the TODO keyword, the
488     priority cookie, and the tags, can now be excluded from
489     export with appropriate options:
491     | Variable                      | Publishing property | OPTIONS switch |
492     |-------------------------------+---------------------+----------------|
493     | org-export-with-todo-keywords | :todo-keywords      | todo:          |
494     | org-export-with-tags          | :tags               | tags:          |
495     | org-export-with-priority      | :priority           | pri:           |
497 *** Cut and Paste with hot links from w3m to Org
499     You can now use the key =C-c C-x M-w= in a w3m buffer with
500     HTML content to copy either the region or the entire file in
501     a special way.  When you yank this text back into an Org-mode
502     buffer, all links from the w3m buffer will continue to work
503     under Org-mode.
505     For this to work you need to load the new file /org-w3m.el./
506     Please check your org-modules variable to make sure that this
507     is turned on.
509     Thanks for Richard Riley for the idea and to Andy Stewart for
510     the implementation.
512 *** LOCATION can be inherited for iCalendar export
514     The LOCATION property can now be inherited during iCalendar
515     export if you configure =org-use-property-inheritance= like
516     this:
518 #+begin_src emacs-lisp
519 (setq org-use-property-inheritance '("LOCATION"))
520 #+end_src
522 * Version 6.13
524 ** Overview
526    - Keybindings in Remember buffers can be configured
527    - Support for ido completion
528    - New face for date lines in agenda column view
529    - Invisible targets become now anchors in headlines.
530    - New contributed file /org-exp-blocks.el/
531    - New contributed file /org-eval-light.el/
532    - Link translation
533    - BBDB links may use regular expressions.
534    - Link abbreviations can use %h to insert a url-encoded target value
535    - Improved XHTML compliance
537 ** Details
539 *** Keybindings in Remember buffers can be configured
541     The remember buffers created with Org's extensions are in
542     Org-mode, which is nice to prepare snippets that will
543     actually be stored in Org-mode files.  However, this makes it
544     hard to configure key bindings without modifying the Org-mode
545     keymap.  There is now a minor mode active in these buffers,
546     `org-remember-mode', and its keymap org-remember-mode-map can
547     be used for key bindings.  By default, this map only contains
548     the bindings for =C-c C-c= to store the note, and =C-c C-k=
549     to abort it.  Use `org-remember-mode-hook' to define your own
550     bindings like
552 #+begin_src emacs-lisp
553 (add-hook
554  'org-remember-mode-hook
555  (lambda ()
556    (define-key org-remember-mode-map
557      "\C-x\C-s" 'org-remember-finalize)))
558 #+end_src
560     If you wish, you can also use this to free the =C-c C-c=
561     binding (by binding this key to nil in the minor mode map),
562     so that you can use =C-c C-c= again to set tags.
564     This modification is based on a request by Tim O'Callaghan.
566 *** Support for ido completion
568     You can now get the completion interface from /ido.el/ for
569     many of Org's internal completion commands by turning on the
570     variable =org-completion-use-ido=. =ido-mode= must also be
571     active before you can use this.
573     This change is based upon a request by Samuel Wales.
575 *** New face for date lines in agenda column view
577     When column view is active in the agenda, and when you have
578     summarizing properties, the date lines become normal column
579     lines and the separation between different days becomes
580     harder to see.  If this bothers you, you can now customize
581     the face =org-agenda-column-dateline=.
583     This is based on a request by George Pearson.
585 *** Invisible targets become now anchors in headlines.
587     These anchors can be used to jump to a directly with an HTML
588     link, just like the =sec-xxx= IDs.  For example, the
589     following will make a http link
590     =//domain/path-to-my-file.html#dummy= work:
592 #+begin_src org
593 ,# <<dummy>>
594 ,*** a headline
595 #+end_src
597     This is based on a request by Matt Lundin.
599 *** New contributed file /org-exp-blocks.el/
601     This new file implements special export behavior of
602     user-defined blocks.  The currently supported blocks are
604     - comment :: Comment blocks with author-specific markup
605     - ditaa ::  conversion of ASCII art into pretty png files
606          using Stathis  Sideris' /ditaa.jar/ program
607     - dot :: creation of graphs in the /dot/ language
608     - R :: Sweave type exporting using the R program
610     For more details and examples, see the file commentary in
611     /org-exp-blocks.el/.
613     Kudos to Eric Schulte for this new functionality, after
614     /org-plot.el/ already his second major contribution.  Thanks
615     to Stathis for this excellent program, and for allowing us to
616     bundle it with Org-mode.
618 *** New contributed file /org-eval-light.el/
620     This module gives control over execution Emacs Lisp code
621     blocks included in a file.
623     Thanks to Eric Schulte also for this file.
625 *** Link translation
627     You can now configure Org to understand many links created
628     with the Emacs Planner package, so you can cut text from
629     planner pages and paste them into Org-mode files without
630     having to re-write the links.  Among other things, this means
631     that the command =org-open-at-point-global= which follows
632     links not only in Org-mode, but in arbitrary files like
633     source code files etc, will work also with links created by
634     planner. The following customization is needed to make all of
635     this work
637 #+begin_src emacs-lisp
638 (setq org-link-translation-function
639       'org-translate-link-from-planner)
640 #+end_src
642    I guess an inverse translator could be written and integrated
643    into Planner.
645 *** BBDB links may use regular expressions.
647     This did work all along, but only now I have documented it.
649 *** =yank-pop= works again after yanking an outline tree
651     Samuel Wales had noticed that =org-yank= did mess up this
652     functionality.  Now you can use =yank-pop= again, the only
653     restriction is that the so-yanked text will not be
654     pro/demoted or folded.
656 *** Link abbreviations can use %h to insert a url-encoded target value
658     Thanks to Steve Purcell for a patch to this effect.
660 *** Improved XHTML compliance
662     Thanks to Sebastian Rose for pushing this.
664 *** Many bug fixes again.
665     
666 * Version 6.12
667 ** Overview
669    - A region of entries can now be refiled with a single command
670    - Fine-tuning the behavior of `org-yank'
671    - Formulas for clocktables
672    - Better implementation of footnotes for HTML export
673    - More languages for HTML export.
675 ** Details
677 *** A region of entries can now be refiled with a single command
678     
679     With =transient-make-mode= active (=zmacs-regions= under
680     XEmacs), you can now select a region of entries and refile
681     them all with a single =C-c C-w= command.
683     Thanks to Samuel Wales for this useful proposal.
685 *** Fine-tuning the behavior of =org-yank=
687     The behavior of Org's yanking command has been further
688     fine-tuned in order to avoid some of the small annoyances
689     this command caused.
691     - Calling =org-yank= with a prefix arg will stop any special
692       treatment and directly pass through to the normal =yank=
693       command.  Therefore, you can now force a normal yank with
694       =C-u C-y=.
696     - Subtrees will only be folded after a yank if doing so will
697       now swallow any non-white characters after the yanked text.
698       This is, I think a really important change to make the
699       command work more sanely.
701 *** Formulas for clocktables
703     You can now add formulas to a clock table, either by hand, or
704     with a =:formula= parameter.  These formulas can be used to
705     create additional columns with further analysis of the
706     measured times.
708     Thanks to Jurgen Defurne for triggering this addition.
710 *** Better implementation of footnotes for HTML export
711     
712     The footnote export in 6.11 really was not good enough.  Now
713     it works fine.  If you have customized
714     =footnote-section-tag=, make sure that your customization is
715     matched by =footnote-section-tag-regexp=.
717     Thanks to Sebastian Rose for pushing this change.
719 *** More languages for HTML export.
721     More languages are supported during HTML export.  This is
722     only relevant for the few special words Org inserts, like
723     "Table of Contents", or "Footnotes".  Also the encoding
724     issues with this feature seem to be solved now.
726     Thanks to Sebastian Rose for pushing me to fix the encoding
727     problems.
729 * Version 6.11
731 ** Overview
733    - Yanking subtree with =C-y= now adjusts the tree level
734    - State changes can now be shown in the log mode in the agenda
735    - Footnote in HTML export are now collected at the end of the document
736    - HTML export now validates again as XHTML
737    - The clock can now be resumed after exiting and re-starting Emacs
738    - Clock-related data can be saved and resumed across Emacs sessions
739    - Following file links can now use C-u C-u to force use of an external app
740    - Inserting absolute files names now abbreviates links with "~"
741    - Links to attachment files
742    - Completed repeated tasks listed briefly in agenda
743    - Remove buffers created during publishing are removed
745 ** Details
747 *** Yanking subtree with =C-y= now adjusts the tree level
748     When yanking a cut/copied subtree or a series of trees, the
749     normal yank key =C-y= now adjusts the level of the tree to
750     make it fit into the current outline position, without losing
751     its identity, and without swallowing other subtrees.
753     This uses the command =org-past-subtree=.  An additional
754     change in that command has been implemented: Normally, this
755     command picks the right outline level from the surrounding
756     *visible* headlines, and uses the smaller one.  So if the
757     cursor is between a level 4 and a level 3 headline, the tree
758     will be pasted as level 3.  If the cursor is actually *at*
759     the beginning of a headline, the level of that headline will
760     be used.  For example, lets say you have a tree like this:
762 #+begin_src org
763 ,* Level one
764 ,** Level two
765 ,(1)
766 ,(2)* Level one again
767 #+end_src
769     with (1) and (2) indicating possible cursor positions for the
770     insertion.  When at (1), the tree will be pasted as level 2.
771     When at (2), it will be pasted as level 1.
773     If you do not want =C-y= to behave like this, configure the
774     variable =org-yank-adjusted-subtrees=.
776     Thanks to Samuel Wales for this idea and a partial implementation.
778 *** State changes can now be shown in the log mode in the agenda
780     If you configure the variable =org-agenda-log-mode-items=,
781     you can now request that all logged state changes be included
782     in the agenda when log mode is active.  If you find this too
783     much for normal applications, you can also temporarily
784     request the inclusion of state changes by pressing =C-u l= in
785     the agenda.
787     This was a request by Hsiu-Khuern Tang.
789     You can also press `C-u C-u l' to get *only* log items in the
790     agenda, withour any timestamps/deadlines etc.
792 *** Footnote in HTML export are now collected at the end of the document
793     Previously, footnotes would be left in the document where
794     they are defined, now they are all collected and put into a
795     special =<div>= at the end of the document.
797     Thanks to Sebastian Rose for this request.
799 *** HTML export now validates again as XHTML.
801     Thanks to Sebastian Rose for pushing this cleanup.
803 *** The clock can now be resumed after exiting and re-starting Emacs
805     If the option =org-clock-in-resume= is t, and the first clock
806     line in an entry is unclosed, clocking into that task resumes
807     the clock from that time.
809     Thanks to James TD Smith for a patch to this effect.
811 *** Clock-related data can be saved and resumed across Emacs sessions
812     
813     The data saved include the contents of =org-clock-history=,
814     and the running clock, if there is one.
815     
816     To use this, you will need to add to your .emacs
818 #+begin_src emacs-lisp
819 (setq org-clock-persist t)
820 (setq org-clock-in-resume t)
821 (org-clock-persistence-insinuate)
822 #+end_src
824     Thanks to James TD Smith for a patch to this effect.
826 *** Following file links can now use C-u C-u to force use of an external app.
828     So far you could only bypass your setup in `org-file-apps'
829     and force opening a file link in Emacs by using a =C-u= prefix arg
830     with =C-c C-o=.  Now you can call =C-u C-u C-c C-o= to force
831     an external application.  Which external application depends
832     on your system.  On Mac OS X and Windows, =open= is used.  On
833     a GNU/Linux system, the mailcap settings are used.
835     This was a proposal by Samuel Wales.
837 *** Inserting absolute files names now abbreviates links with "~".
839     Inserting file links with =C-u C-c C-l= was buggy if the
840     setting of `org-link-file-path-type' was `adaptive' (the
841     default).  Absolute file paths were not abbreviated relative
842     to the users home directory.  This bug has been fixed.
844     Thanks to Matt Lundin for the report.
846 *** Links to attachment files
848     Even though one of the purposes of entry attachments was to
849     reduce the number of links in an entry, one might still want
850     to have the occasional link to one of those files.  You can
851     now use link abbreviations to set up a special link type that
852     points to attachments in the current entry.  Note that such
853     links will only work from within the same entry that has the
854     attachment, because the directory path is entry specific.
855     Here is the setup you need:
857 #+begin_src emacs-lisp
858 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
859 #+end_src
861     After this, a link like this will work
863 #+BEGIN_EXAMPLE
864      [[att:some-attached-file.txt]]
865 #+END_EXAMPLE
866     This was a proposal by Lindsay Todd.
868 *** Completed repeated tasks listed briefly in agenda
870     When a repeating task, listed in the daily/weekly agenda under
871     today's date, is completed from the agenda, it is listed as
872     DONE in the agenda until the next update happens.  After the
873     next update, the task will have disappeared, of course,
874     because the new date is no longer today.
875     
876 *** Remove buffers created during publishing are removed
878     Buffers that are created during publishing are now deleted
879     when the publishing is over.  At least I hope it works like this.
881 * Version 6.10
883 ** Overview
885    - Secondary agenda filtering is becoming a killer feature
886    - Setting tags has now its own binding, =C-c C-q=
887    - Todo state changes can trigger tag changes
888    - C-RET will now always insert a new headline, never an item.
889    - Customize org-mouse.el feature set to free up mouse events
890    - New commands for export all the way to PDF (through LaTeX)
891    - Some bug fixed for LaTeX export, more bugs remain.
893 ** Details
895 *** Enhancements to secondary agenda filtering
897     This is, I believe, becoming a killer feature.  It allows you
898     to define fewer and more general custom agenda commands, and
899     then to do the final narrowing to specific tasks you are
900     looking for very quickly, much faster than calling a new
901     agenda command.
903     If you have not tries this yet, you should!
905 **** You can now refining the current filter by an additional criterion
906       When filtering an existing agenda view with =/=, you can
907       now narrow down the existing selection by an additional
908       condition.  Do do this, use =\= instead of =/= to add the
909       additional criterion.  You can also press =+= or =-= after
910       =/= to add a positive or negative condition.  A condition
911       can be a TAG, or an effort estimate limit, see below.
913 **** It is now possible to filter for effort estimates
914      This means to filter the agenda for the value of the Effort
915      property.  For this you should best set up global allowed
916      values for effort estimates, with
918 #+begin_src emacs-lisp
919 (setq org-global-properties
920       '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
921 #+end_src
922       
923      You may then select effort limits with single keys in the
924      filter.  It works like this:  After =/= or =\=, first select
925      the operator which you want to use to compare effort
926      estimates:
928      : <   Select entries with effort smaller than or equal to the limit
929      : >   Select entries with effort larger than or equal to the limit
930      : =   Select entries with effort equal to the limit
932      After that, you can press a single digit number which is
933      used as an index to the allowed effort estimates.
935      If you do not use digits to fast-select tags, you can even
936      skip the operator, which will then default to
937      `org-agenda-filter-effort-default-operator', which is by
938      default =<=.
940      Thanks to Manish for the great idea to include fast effort
941      filtering into the agenda filtering process.
943 **** The mode line will show the active filter
944      For example, if there is a filter in place that does select
945      for HOME tags, against EMAIL tags, and for tasks with an
946      estimated effort smaller than 30 minutes, the mode-line with
947      show =+HOME-EMAIL+<0:30=
949 **** The filter now persists when the agenda view is refreshed
950      All normal refresh commands, including those that move the
951      weekly agenda from one week to the next, now keep the
952      current filter in place.
954      You need to press =/ /= to turn off the filter.  However,
955      when you run a new agenda command, for example going from
956      the weekly agenda to the TODO list, the filter will be
957      switched off.
958    
959 *** Setting tags has now its own binding, =C-c C-q=
961     You can still use =C-c C-c= on a headline, but the new
962     binding should be considered as the main binding for this
963     command.  The reasons for this change are:
965     - Using =C-c C-c= for tags is really out of line with other
966       uses of =C-c C-c=.
968     - I hate it in Remember buffers when I try to set tags and I
969       cannot, because =C-c C-c= exits the buffer :-(
971     - =C-c C-q= will also work when the cursor is somewhere down
972       in the entry, it does not have to be on the headline.
974 *** Todo state changes can trigger tag changes
976     The new option =org-todo-state-tags-triggers= can be used to
977     define automatic changes to tags when a TODO state changes.
978     For example, the setting
980     : (setq org-todo-state-tags-triggers
981     :       '((done ("Today" . nil) ("NEXT" . nil))
982     :         ("WAITING" ("Today" . t))))    
984     will make sure that any change to any of the DONE states will
985     remove tags "Today" and "NEXT", while switching to the
986     "WAITING" state will trigger the tag "Today" to be added.
988     I use this mostly to get rid of TODAY and NEXT tags which I
989     apply to select an entry for execution in the near future,
990     which I often prefer to specific time scheduling.
992 *** C-RET will now always insert a new headline, never an item.
993     The new headline is inserted after the current subtree.
995     Thanks to Peter Jones for patches to fine-tune this behavior.
997 *** Customize org-mouse.el feature set
998     There is a new variable =org-mouse-features= which gives you
999     some control about what features of org-mouse you want to
1000     use.  Turning off some of the feature will free up the
1001     corresponding mouse events, or will avoid activating special
1002     regions for mouse clicks.  By default I have urned off the
1003     feature to use drag mouse events to move or promote/demote
1004     entries.  You can of course turn them back on if you wish.
1006     This variable may still change in the future, allowing more
1007     fine-grained control.
1009 *** New commands for export to PDF
1011     This is using LaTeX export, and then processes it to PDF
1012     using pdflatex.
1014     : C-c C-e p     process to PDF.
1015     : C-c C-e d     process to PDF, and open the file.
1017 *** LaTeX export
1018     - \usepackage{graphicx} is now part of the standard class
1019       definitions.
1020     - Several bugs fixed, but definitely not all of them :-(
1022 *** New option `org-log-state-notes-insert-after-drawers'
1024     Set this to =t= if you want state change notes to be inserted
1025     after any initial drawers, i.e drawers the immediately follow
1026     the headline and the planning line (the one with
1027     DEADLINE/SCHEDULED/CLOSED information).
1029 * Version 6.09
1030 ** Incompatible
1031 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
1033 ** Details
1035 *** =org-file-apps= now uses regular repressions instead of extensions
1036     Just like in =auto-mode-alist=, car's in the variable
1037     =org-file-apps= that are strings are now interpreted as
1038     regular expressions that are matched against a file name.  So
1039     instead of "txt", you should now write "\\.txt\\'" to make
1040     sure the matching is done correctly (even though "txt" will
1041     be recognized and still be interpreted as an extension).
1043     There is now a shortcut to get many file types visited by
1044     Emacs.  If org-file-apps contains `(auto-mode . emacs)', then
1045     any files that are matched by `auto-mode-alist' will be
1046     visited in emacs.
1048 *** Changes to the attachment system
1050     - The default method to attach a file is now to copy it
1051       instead of moving it.
1052     - You can modify the default method using the variable
1053       `org-attach-method'.  I believe that most Unix people want
1054       to set it to `ln' to create hard links.
1055     - The keys =c=, =m=, and =l= specifically select =copy=,
1056       =move=, or =link=, respectively, as the attachment method
1057       for a file, overruling  `org-attach-method'.
1058     - To create a new attachment as an Emacs buffer, you have not
1059       now use =n= instead of =c=.
1060     - The file list is now always retrieved from the directory
1061       itself, not from the "Attachments" property.  We still
1062       keep this property by default, but you can turn it off, by
1063       customizing the variable =org-attach-file-list-property=.
1065 * Version 6.08
1067 ** Incompatible changes
1069    - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
1071    - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
1073 ** Details
1075 *** The default structure of IDs has changed
1077     IDs created by Org have changed a bit:
1078     - By default, there is no prefix on the ID.  There used to be
1079       an "Org" prefix, but I now think this is not necessary.
1080     - IDs use only lower-case letters, no upper-case letters
1081       anymore.  The reason for this is that IDs are now also used
1082       as directory names for org-attach, and some systems do not
1083       distinguish upper and lower case in the file system.
1084     - The ID string derived from the current time is now
1085       /reversed/ to become an ID.  This assures that the first
1086       two letters of the ID change fast, so hat it makes sense to
1087       split them off to create subdirectories to balance load.
1088     - You can now set the `org-id-method' to `uuidgen' on systems
1089       which support it.
1091 *** =C-c C-a= no longer calls `show-all'
1093     The reason for this is that =C-c C-a= is now used for the
1094     attachment system.  On the rare occasions that this command
1095     is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
1097 *** New attachment system
1099     You can now attach files to each node in the outline tree.
1100     This works by creating special directories based on the ID of
1101     an entry, and storing files in these directories.  Org can
1102     keep track of changes to the attachments by automatically
1103     committing changes to git.  See the manual for more
1104     information.
1106     Thanks to John Wiegley who contributed this fantastic new
1107     concept and wrote org-attach.el to implement it.
1109 *** New remember template escapes
1111     : %^{prop}p   to insert a property
1112     : %k          the heading of the item currently being clocked
1113     : %K          a link to the heading of the item currently being clocked
1115     Also, when you exit remember with =C-2 C-c C-c=, the item
1116     will be filed as a child of the item currently being
1117     clocked.  So the idea is, if you are working on something and
1118     think of a new task related to this or a new note to be
1119     added, you can use this to quickly add information to that
1120     task.
1122     Thanks to James TD Smith for a patch to this effect.
1124 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
1125     
1126     Thanks to James TD Smith for a patch to this effect.
1128 *** New file in contrib: lisp/org-checklist.el
1130     This module deals with repeated tasks that have checkbox
1131     lists below them.
1133     Thanks to James TD Smith for this contribution.
1135 *** New in-buffer setting #+STYLE
1137     It can be used to locally set the variable
1138     `org-export-html-style-extra'.  Several such lines are
1139     allowed-, they will all be concatenated.  For an example on
1140     how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
1142 * Version 6.07
1144 ** Overview
1146    - Filtering existing agenda views with respect to a tag
1147    - Editing fixed-width regions with picture or artist mode
1148    - /org-plot.el/ is now part of Org
1149    - Tags can be used to select the export part of a document
1150    - Prefix interpretation when storing remember notes
1151    - Yanking inserts folded subtrees
1152    - Column view capture tables can have formulas, plotting info
1153    - In column view, date stamps can be changed with S-cursor keys
1154    - The note buffer for clocking out now mentions the task
1155    - Sorting entries alphabetically ignores TODO keyword and priority
1156    - Agenda views can sort entries by TODO state
1157    - New face =org-scheduled= for entries scheduled in the future.
1158    - Remember templates for gnus links can use the :to escape.
1159    - The file specification in a remember template may be a function
1160    - Categories in iCalendar export include local tags
1161    - It is possible to define filters for column view
1162    - Disabling integer increment during table Field copy
1163    - Capturing column view is on `C-c C-x i'
1164    - And tons of bugs fixed.  
1167 ** Incompatible changes
1169 *** Prefix interpretation when storing remember notes has changed
1171     The prefix argument to the `C-c C-c' command that finishes a
1172     remember process is now interpreted differently:
1174     : C-c C-c       Store the note to predefined file and headline
1175     : C-u C-c C-c   Like C-c C-c, but immediately visit the note
1176     :               in its new location.
1177     : C-1 C-c C-c   Select the storage location interactively
1178     : C-0 C-c C-c   Re-use the last used location
1180     This was requested by John Wiegley.
1182 *** Capturing column view is now on `C-c C-x i'
1184     The reason for this change was that `C-c C-x r' is also used
1185     as a tty key replacement.
1187 *** Categories in iCalendar export now include local tags
1189     The locally defined tags are now listed as categories when
1190     exporting to iCalendar format.  Org's traditional file/tree
1191     category is now the last category in this list.  Configure
1192     the variable =org-icalendar-categories= to modify or revert
1193     this behavior.
1195     This was a request by Charles Philip Chan.
1197 ** Details
1199 *** Secondary filtering of agenda views.
1201     You can now easily and interactively filter an existing
1202     agenda view with respect to a tag.  This command is executed
1203     with the =/= key in the agenda.  You will be prompted for a
1204     tag selection key, and all entries that do not contain or
1205     inherit the corresponding tag will be hidden.  With a prefix
1206     argument, the opposite filter is applied: entries that
1207     do have the tag will be hidden.
1209     This operation only /hides/ lines in the agenda buffer, it
1210     does not remove them.  Changing the secondary filtering does
1211     not require a new search and is very fast.
1213     If you press TAB at the tag selection prompt, you will be
1214     switched to a completion interface to select a tag.  This is
1215     useful when you want to select a tag that does not have a
1216     direct access character.
1218     A double =/ /= will restore the original agenda view by
1219     unhiding any hidden lines.
1221     This functionality was John Wiegley's idea.  It is a simpler
1222     implementation of some of the query-editing features proposed
1223     and implemented some time ago by Christopher League (see the
1224     file contrib/lisp/org-interactive-query.el).
1226 *** Editing fixed-width regions with picture or artist mode
1228     The command @<code>C-c '@</code> (that is =C-c= followed by a
1229     single quote) can now also be used to switch to a special
1230     editing mode for fixed-width sections.  The default mode is
1231     =artist-mode= which allows you to create ASCII drawings.
1233     It works like this: Enter the editing mode with
1234     @<code>C-c '@</code>.  An indirect buffer will be created and
1235     narrowed to the fixed-width region.  Edit the drawing, and
1236     press @<code>C-c '@</code> again to exit.
1238     Lines in a fixed-width region should be preceded by a colon
1239     followed by at least one space.  These will be removed during
1240     editing, and then added back when you exit the editing mode.
1242     Using the command in an empty line will create a new
1243     fixed-width region.
1245     This new feature arose from a discussion involving Scott
1246     Otterson, Sebastian Rose and Will Henney.
1248 *** /org-plot.el/ is now part of Org.
1250     You can run it by simple calling org-plot/gnuplot.
1251     Documentation is not yet included with Org, please refer to
1252     http://github.com/eschulte/org-plot/tree/master until we have
1253     moved the docs into Org or Worg.
1255     Thanks to Eric Schulte for this great contribution.
1257 *** Tags can be used to select the export part of a document
1259     You may now use tags to select parts of a document for
1260     inclusion into the export, and to exclude other parts.  This
1261     behavior is governed by two new variables:
1262     =org-export-select-tags= and =org-export-exclude-tags=.
1263     These default to =("export")= and =("noexport")=, but can be
1264     changed, even to include a list of several tags.
1266     Org first checks if any of the /select/ tags is present in
1267     the buffer.  If yes, all trees that do not carry one of these
1268     tags will be excluded.  If a selected tree is a subtree, the
1269     heading hierarchy above it will also be selected for export,
1270     but not the text below those headings.  If none of the select
1271     tags is found anywhere in the buffer, the whole buffer will
1272     be selected for export.  Finally, all subtrees that are
1273     marked by any of the /exclude/ tags will be removed from the
1274     export buffer.
1276     You may set these tags with in-buffer options
1277     =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
1279     I love this feature.  Thanks to Richard G Riley for coming
1280     up with the idea.
1282 *** Prefix interpretation when storing remember notes
1284     The prefix argument to the `C-c C-c' command that finishes a
1285     remember process is now interpreted differently:
1287     : C-c C-c       Store the note to predefined file and headline
1288     : C-u C-c C-c   Like C-c C-c, but immediately visit the note
1289     :               in its new location.
1290     : C-1 C-c C-c   Select the storage location interactively
1291     : C-0 C-c C-c   Re-use the last used location
1293     This was requested by John Wiegley.
1295 *** Yanking inserts folded subtrees
1297     If the kill is a subtree or a sequence of subtrees, yanking
1298     them with =C-y= will leave all the subtrees in a folded
1299     state.  This basically means, that kill and yank are now
1300     much more useful in moving stuff around in your outline.  If
1301     you do not like this, customize the variable
1302     =org-yank-folded-subtrees=.
1304     Right now, I am only binding =C-y= to this new function,
1305     should I modify all bindings of yank?  Do we need to amend
1306     =yank-pop= as well?
1308     This feature was requested by John Wiegley.
1310 *** Column view capture tables can have formulas, plotting info
1312     If you attach formulas and plotting instructions to a table
1313     capturing column view, these extra lines will now survive an
1314     update of the column view capture, and any formulas will be
1315     re-applied to the captured table.  This works by keeping any
1316     continuous block of comments before and after the actual
1317     table.
1319 *** In column view, date stamps can be changed with S-cursor keys
1321     If a property value is a time stamp, S-left and S-right can
1322     now be used to shift this date around while in column view.
1324     This was a request by Chris Randle.
1326 *** The note buffer for clocking out now mentions the task
1327     
1328     This was a request by Peter Frings.
1330 *** Sorting entries alphabetically ignores TODO keyword and priority
1332     Numerical and alphanumerical sorting now skips any TODO
1333     keyword or priority cookie when constructing the comparison
1334     string.  This was a request by Wanrong Lin.
1336 *** Agenda views can sort entries by TODO state
1338     You can now define a sorting strategy for agenda entries that
1339     does look at the TODO state of the entries.  Sorting by TODO
1340     entry does first separate the non-done from the done states.
1341     Within each class, the entries are sorted not alphabetically,
1342     but in definition order.  So if you have a sequence of TODO
1343     entries defined, the entries will be sorted according to the
1344     position of the keyword in this sequence.
1346     This follows an idea and sample implementation by Christian
1347     Egli.
1349 *** New face =org-scheduled= for entries scheduled in the future.
1351     This was a request by Richard G Riley.
1353 *** Remember templates for gnus links can now use the :to escape.
1355     Thanks to Tommy Lindgren for a patch to this effect.
1356 *** The file specification in a remember template may now be a function
1358     Thanks to Gregory Sullivan for a patch to this effect.
1360 *** Categories in iCalendar export now include local tags
1362     The locally defined tags are now listed as categories when
1363     exporting to iCalendar format.  Org's traditional file/tree
1364     category is now the last category in this list.  Configure
1365     the variable =org-icalendar-categories= to modify or revert
1366     this behavior.
1368     This was a request by Charles Philip Chan.
1370 *** It is now possible to define filters for column view
1372     The filter can modify the value that will be displayed in a
1373     column, for example it can cut out a part of a time stamp.
1374     For more information, look at the variable
1375     =org-columns-modify-value-for-display-function=.
1377 *** Disabling integer increment during table field copy
1379     Prefix arg 0 to S-RET does the trick.
1381     This was a request by Chris Randle.
1384 * Older changes
1386   For older Changes, see [[file:Changes_old.org]]
1389