1 # -*- mode: org; fill-column: 65 -*-
5 #+TITLE: Org-mode list of user-visible changes
6 #+AUTHOR: Carsten Dominik
7 #+EMAIL: carsten at orgmode dot org
8 #+OPTIONS: H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:{} *:t TeX:t LaTeX:nil f:nil
9 #+INFOJS_OPT: view:info toc:1 path:org-info.js tdepth:2 ftoc:t
11 #+LINK_HOME: http://orgmode.org
23 Macro processing for export has been enhanced:
25 - You can use arguments in a macro, for example
27 #+macro hello Greet the $1: Hello $1
29 which would turn ={{{hello(world)}}}= into =Greet the world: Hello world=
31 - The macro value can be an emacs-lisp for to be evaluated at the
35 ,#+macro: datetime (eval (format-time-string "$1"))
38 - More built-in default macros:
39 - date(FORMAT_TIME_STRING) :: Time/Date of export
40 - time(FORMAT_TIME_STRING) :: Same as date
41 - modification-time(FORMAT_TIME_STRING) :: Last modification of file
42 - input-file :: Name of the input file
44 The new built-in macros have been requested by Daniel Clemente.
46 *** Link completion for files and bbdb names
48 Org now has a general mechanism how modules can provide enhanced
49 support (for example through completion) when adding a link. For
50 example, when inserting a link with =C-c C-l=, you can now type
51 =file:= followed by =RET= to get completion support for inserting
52 a file. After entering =bbdb:= and =RET=, a completion interface
53 will allow to complete names in the BBDB database. These are the
54 only ones implemented right now, but modules that add a link type
55 =xyz:= can simple define =org-xyz-complete-link= that should
56 return the full link with prefix after aiding the used to create
57 the link. For example, if you have =http= links that you have to
58 insert very often, you could define a function
59 =org-http-complete-link= to help selecting the most common ones.
61 *** Source file publishing
63 It is now easy to publish the Org sources along with, for
64 example, HTML files. In your publishing project, replace
66 : :publishing-function org-publish-org-to-html
70 : :publishing-function (org-publish-org-to-html org-publish-org-to-org)
74 to get both the plain org file and an htmlized version that
75 looks like your editing buffer published along with the HTML
78 *** Push exported stuff to kill ring
80 All exporters now push the produced material onto the kill-ring
81 in Emacs, and also to the external clipboard and the primary
82 selection to make it easy to paste this under many circumstances.
84 *** Tables in LaTeX without centering
85 Set the variable `org-export-latex-tables-centered' to nil if you
86 prefer tables not to be horizontally centered. Note that
87 longtable tables are always centered.
89 *** LaTeX export: TODO markup configurable
91 The markup for TODO keywords in LaTeX export is now configurable
92 using the variable =org-export-latex-todo-keyword-markup=.
94 *** ASCII export to buffer
96 ASCII export has now the same command variations as the other
97 export backends, for example exporting to a temporary buffer
100 The was a request by Samuel Wales.
102 *** Accessibility improvements for HTTP tables
104 When exporting tables to HTML, Org now adds =scope= attributes to
105 all header fields, in order to support screen readers.
107 =org-export-html-table-use-header-tags-for-first-column= will
108 request using =<th>= instead of =<td>= also in the entire first
109 column, so that also row information can be scoped. This was
110 triggered by a request by Jan Buchal, and as usually Sebastian
111 Rose came up with the right implementation.
113 *** Timezone information in iCalendar files
115 The timezone information in iCalendar files is now written in the
116 correct format, and can be set in the variable
117 =org-ical-timezone=. This variable is initialized from the =TZ=
118 environment variable.
120 *** New contributed package /org-special-blocks.el/
122 The package turns any "undefined" =#+begin_...= blocks into LaTeX
123 environments for LaTeX export, and into =<div>= tags for HTML
126 Thanks to Chris Gray for this contribution.
128 *** More flexibility about placing logging notes.
130 Logging into a drawer can now also be set for individual
131 subtrees using the =LOG_INTO_DRAWER= property.
133 Requested by Daniel J. Sinder
137 Reloading Org has moved to a new key, =C-c C-x !=, and is now
138 also available in the agenda.
140 *** Start Agenda with log mode active
141 Set the new option =org-agenda-start-with-log-mode= to have
142 log mode turned on from the start. Or set this option for
143 specific custom commands.
145 Thanks to Benjamin Andresen for a patch to this effect.
147 *** Agenda speed optimizations
149 Depending on circumstances, construction the agenda has become a
152 Triggered by Eric S Fraga's reports about using Org on a slow
153 computer like a netbook.
155 *** New face for today in agenda
157 The date that is today can now be highlighted in the agenda by
158 customizing the face =org-agenda-date-today=.
160 Thanks to Dmitri Minaev for a patch to this effect.
162 *** Properties to disambiguate statistics
164 When an entry has both check boxes and TODO children, it is not
165 clear what kind of statistics a cookie should show You can now use
166 the =COOKIE_DATA= property to disambiguate, by giving it a value
167 "todo" or "checkbox".
169 Thanks to Ulf Stegeman, who was persistent enough to push this
170 change past my initial resistance.
172 *** Checkboxes and TODO items: recursive statistics
174 Setting the variable =org-hierarchical-checkbox-statistics= to
175 =nil= will make statistics cookies count all checkboxes in the
176 lit hierarchy below it.
178 Setting the variable =org-hierarchical-todo-statistics= to
179 =nil= will do the same for TODO items.
181 To turn on recursive statistics only for a single subtree, add the
182 word "recursive" to the =COOKIE_DATA= property. Note that you
183 can have such a property containing both "todo" or "checkbox" for
184 disambiguation, and the word "recursive", separated by a space
187 The change for checkboxes was a patch by Richard Klinda.
189 *** New operators for column view
191 Column view has new operators for computing the minimum,
192 maximum, and mean of property values.
194 Thanks to Mikael Fornius for a patch to this effect.
202 Entries can now define a =CUSTOM_ID= property. This property
203 must be a valid ID according to HTML rules, and it will be used
204 in HTML export as the main target ID for this entry. That means,
205 both the table of conents and other internal links will
206 automatically point to this ID instead of the automatic ID like
207 =sec-1.1=. This is useful to create humar-readable permanent
208 links to these location in a document.
210 The user is responsible to make sure that custom IDs are unique
213 Links written like =[[#my-target-name] ]= can be used to target a
216 When using =C-c l= to store a link to a headline that has a
217 custom ID, Org will now create two links at the same time. One
218 link will be to the custom ID. The other will be to the globaly
219 unique ID property. When inserting the line with =C-c C-l=, you
220 need to decide which one you want to use. Use the ID links for
221 entries that are expected to move from one file to the next. Use
222 custom ID links publishing projects, when you are sure that te
223 entry will stay in that file. See also the variable
224 =org-link-to-org-use-id=.
226 *** Remember to non-org files
228 If the target headline part of a remember template definition
229 entry is =top= or =bottom=, the target file may now be a
230 non-Org-mode file. In this case, the content of the remember
231 buffer will be added to that file without enforcing an Org-like
232 headline. Sorry, Russel, that this took so long.
234 *** New property to turn off todo dependencies locally
236 Setting the property =NOBLOCKING= will turn off TODO dependency
237 checking for this entry.
241 A new function is called to verify tasks that are about to be
242 selected as remember targets. See the new variable
243 =org-refile-target-verify-function=.
245 *** New version org ditaa.jar
247 Thanks to Stathis Sideris.
249 *** htmlize.el is now in the contrib directory
251 The latest version of htmlize.el is now the in the contrib
252 directory of Org. Thanks to Hrvoje Niksic for allowing this.
259 ** Major new features
263 We now do have a fully functional DocBook exporter, contributed by
264 Baoqiu Cui. Simple press =C-c e D= to export the current file to
265 DocBook format. You can also get direct conversion to PDF if you have
266 made the correct setup, please see the manual for details.
268 Kudos to Baoqiu for this fantastic addition, and my personal thanks
269 for doing this in a such a smooth way that I did not have to do
272 *** Protocols for external access to Emacs and Org
274 /org-protocol.el/ is a new module that supersedes both
275 /org-annotation-helper.el/ and /org-browser.el/ and replaces them
276 with a more abstracted interface. /org-protocol/ intercepts
277 calls from emacsclient to trigger custom actions without external
278 dependencies. Only one protocol has to be configured with your
279 external applications or the operating system, to trigger an
280 arbitrary number of custom actions. Just register your custom
281 sub-protocol and handler with the new variable
282 =org-protocol-protocol-alist=.
284 org-protocol comes the with three standard protocol handlers (in
285 parenthesis the name of the sub-protocol):
286 - =org-protocol-remember= (=remember=) :: Trigger remember
287 - =org-protocol-store-link= (=store-link=) :: Store a link
288 - =org-protocol-open-source= (=open-source=) :: Find the local
289 source of a remote web page.
291 Passing data to emacs is now as easy as calling
293 : emacsclient org-protocol://sub-protocol://data
295 For more information see the [[http://orgmode.org/worg/org-contrib/org-protocol.php][online documentation]]
297 Thanks to Sebastian Rose for this really beautiful module.
301 Inline tasks are tasks that have all the properties of normal
302 outline nodes, including the ability to store meta data like
303 scheduling dates, TODO state, tags and properties. But these
304 tasks are not meant to introduce additional outline structure, at
305 least as far as visibility cycling and export is concerned. They
306 are useful for adding tasks in extensive pieces of text where
307 interruption of the flow or restructuring is unwanted.
309 This feature is not turned on by default, you need to configure
310 =org-modules= to turn it on, or simply add to you .emacs file:
312 : (require 'org-inlinetask)
314 After that, tasks with level 15 (30 stars when using
315 org-odd-levels-only) will be treated as inline tasks, and
316 fontification will make obvious which tasks are treated in this
319 *** Input from RSS feeds
321 Org can now collect tasks from an RSS feed, a great method to get
322 stuff from online call and note-taking services into your trusted
323 system. You need to configure the feeds in the variable
324 =org-feed-alist=. The manual contains a short description, more
325 detailed information is [[http://orgmode.org/worg/org-contrib/org-feed.php][available on Worg]].
327 Full credit goes to Brad Bozarth who really [[http://thread.gmane.org/gmane.emacs.orgmode/12251][paved the way]] for this
328 exciting new feature.
333 *** Allow modification of table attributes in HTML export
335 The #+ATTR_HTML line can now be used to set attributes for a
336 table. Attributes listed in that line will replace existing
337 attributes in =org-export-html-table-tag=, or will add new ones.
340 : #+ATTR_HTML: border="2" rules="all" frame="all"
341 : #+CAPTION: Finally a table with lines!
346 *** LaTeX low levels are now exported as itemize lists
348 LaTeX export now treats hierarchy levels 4,5, etc as itemize
349 lists, not as description lists as before. This is more
350 consistent with the behavior of HTML export. You can configure
351 this behavior using the variable =org-export-latex-low-levels=.
353 *** Markup for centering.
355 Text can be exported centered with
359 ,Everything should be made as simple as possible, \\
364 *** Sitemap file is now /sitemap.org/
366 Org-publish can produce a list of all files in a project.
367 Previously the file containing this list was called "index.org",
368 really a brain-dead default because during publication it would
369 overwrite the "index.html" file of the website.
371 The default file name is now "sitemap.org"
373 *** Protect explicit target links in HTML export
375 If a link is =[[#name] [desc]]=, the href produced when exporting
376 the file will be exactly href="#name". So starting a link target
377 with # will indicate that there will be an explicit target for
380 *** HTML export: Allow "- ___" to explicitly terminate a list
382 If a list contains "- ___" (three underscores) as an item, this
383 terminates the list, ignoring this item. This is an experimental
384 feature, it may disappear again if we find other ways to deal
385 with literal examples right after lists.
387 See [[http://thread.gmane.org/gmane.emacs.orgmode/12299/focus%3D12312][this mailing list thread]] for context.
391 *** Changing the time of an entry from the agenda
393 We now have a way to change not only the date, but also the start
394 time of an entry from the agenda. The date is normally changed
395 with S-right/left. Now, if you add a C-u prefix, the hour will
396 be changed. If you immediately press S-right/left again, hours
397 will continue to be changed. A double prefix will do the same
398 for minutes. If the entry has a time range like 14:40-16:00,
399 then both times will change, preserving the length of the
402 *** Show saved PDF agenda view with prefix arg
404 When writing an agenda view to a PDF file, supplying a a prefix
405 argument (=C-u C-x C-w=) will get the new file displayed
408 This was a request by Alan E Davis.
410 *** Filter for entries with no effort defined
412 During secondary agenda filtering, pressing "?" now will install a
413 filter that selects entries which do not have an effort defined.
415 This new model was necessary because we needed to stop interpreting
416 entries with no effort defines as 0 effort. This was inconsistent,
417 because for normal agenda sorting, the treatment of these entries
418 depends on the variable =org-sort-agenda-noeffort-is-high=. Now this
419 variable is also respected during filtering.
421 This new feature resulted from a [[http://thread.gmane.org/gmane.emacs.orgmode/12493][discussion]] with Matt Lundin and
424 *** Introduce user-defined sorting operators
426 The new variable =org-agenda-cmp-user-defined= can contain a
427 function to test how two entries should be compared during
428 sorting. The symbols =user-defined-up= and =user-defined-down=
429 can then be part of any sorting strategy.
431 This was a request by Samuel Wales.
433 *** Indentation of subitems in the agenda
435 When a tags/property match does match an entry and it's
436 sublevels, the sublevels used to be indented by dots, to indicate
437 that the matches likely result from tag inheritance. This is now
438 no longer the default, so the subitems will not get special
439 indentation. You can get this behavior back with
441 : (setq org-tags-match-list-sublevels 'indented)
443 *** Stuck projects search now searches subtrees of unstuck projects
445 When, during a stuck-project search, a project tree is identified
446 as not stuck, so far the search would continue after the end of
447 the project tree. From now on, the search continues in the
448 subtree, so that stuck subprojects can still be identified.
453 *** Citations: Use RefTeX to insert citations
455 RefTeX can now be used to create a citation in Org-mode buffers.
456 Setup the buffer with
459 ,#+BIBLIOGRAPHY: bibbase style
462 and create citations with =C-c C-x [=.
464 Together with org-exp-bibtex.el by Taru Karttunen (available as a
465 contributed package), this provides a great environment for
466 including citations into HTML and LaTeX documents.
468 *** Changing time ranges as a block
470 When using the S-cursor keys to change the first time in a time
473 : <2009-04-01 Wed 14:40-16:40>
475 then the end time will change along, so that the duration of the
476 event will stay the same.
478 This was a request by Anupam Sengupta.
480 *** New sparse tree command
482 A new sparse tree command shows entries with times after a certain
483 date. Keys are =C-c / a=, this command is for symmetry
488 A new command allows to create clone copies of the current entry,
489 with shifted dates in all stamps in the entry. This is useful to
490 create, for example, a series of entries for a limited time
491 period. I am using it to prepare lectures, for example.
493 *** New face for checkboxes
495 Checkboxes now have their own face, =org-checkbox=. This can be
496 used for nice effects, for example choosing a face with a box
499 #+begin_src emacs-lisp
501 (org-checkbox ((t (:background "#444444" :foreground "white"
502 :box (:line-width 1 :style released-button)))))
505 *** M-a and M-e for navigation in a table field
507 In tables fields, the sentence commands =M-a= and =M-e= are
508 redefined to jump to the beginning or end of the field.
510 This was a request by Bastien Guerry.
512 *** Backup files for remember buffers
514 Sometimes users report that they lost data when not immediately
515 storing a new remember note, and then later exiting Emacs or
516 starting a new remember process.
518 Now you can set the variable =org-remember-backup-directory=.
519 Each remember buffer created will then get its own unique file
520 name in that directory, and the file will be removed only if the
521 storing of the note to an Org files was successful.
523 *** org-mac-message.el: New functions to access flagged mail
525 Christopher Suckling has added functionality to
526 /org-mac-message.el/. In particular, you can now select a number
527 of messages and easily get links to all of them with a single
528 command. For details, see the [[http://orgmode.org/worg/org-contrib/org-mac-message.php][online documentation]].
530 *** Read-date: New hook
532 The new hook =org-read-date-minibuffer-setup-hook= is called when
533 setting up the minibuffer for reading a date. If can be used to
534 install new keys into the temporary keymap used there.
542 ** Incompatible changes
545 *** Tag searches are now case-sensitive
547 From this release on, tag searches will be case sensitive. While
548 I still think it would be nice to have them case-insensitive,
549 this was both an inconsistency (TODO keyword searches have always
550 been case-sensitive), and trouble for coding some efficient
551 algorithms. So please make sure that you give the tags with
552 correct casing when prompted for a match expression.
554 *** New key for creating tags/property sparse trees
556 The key to produce a sparse tree matching tags and properties is
557 now =C-c / m= instead of =C-c a T=. This is also more consistent
558 with the =C-c a m= key for the corresponding agenda view.
559 =C-c / T= will still work for now, but it is no longer advertised
560 in the documentation and may go away at any time in the future.
562 *** IDs in HTML have "ID-" prefix when generated by uuidgen
564 /uuidgen/ generates IDs that often start with a number, not a
565 latter. However, IDs and names in XHTML must start with a letter.
566 Therefore, IDs in HTML files will now get an "ID-" prefix if they
567 have been generated by uuidgen. This means that id links from one
568 file to another may stop working until all files have been
571 *** In agenda, only priority cookies get the special face
573 So far, an entire task would get a special face when
574 =org-agenda-fontify-priorities= was set. Now, the default value
575 for this variable is the symbol =cookies=, which means that on
576 the cookie is fontified. Set it to =t= if you want the entire
577 task headline to be fontified.
581 *** PDF export of agenda views
583 Agenda views can now be exported to PDF files by writing them to
584 a file with extension ".pdf". Internally this works by first
585 producing the postscript version and then converting that to PDF
586 using the ghostview utility =ps2pdf=. Make sure that this
587 utility is installed on your system.
589 The postscript version will not be removed, it will stay around.
591 *** Inline some entry text for Agenda View export
593 When exporting an agenda view to HTML or PDF for printing or
594 remote access, one of the problems can be that information stored
595 in entries below the headline is not accessible in that format.
597 You can now copy some of that information to the agenda view
598 before exporting it. For this you need to set the variable
599 =org-agenda-add-entry-text-maxlines= to a number greater than 0.
601 #+begin_src emacs-lisp
602 (setq org-agenda-add-entry-text-maxlines 20)
605 Or you can do this with the settings in a custom agenda view,
608 #+begin_src emacs-lisp
610 ((org-agenda-ndays 1)
611 (org-agenda-add-entry-text-maxlines 5))
612 ("agenda-today.pdf"))
615 *** Improved ASCII export of links
617 ASCII export of links works now much better. If a link has a
618 link and a description part which are different, then the
619 description will remain in the text while the link part will be
620 moved to the end of the current section, before the next heading,
621 as a footnote-like construct.
623 Configure the variable =org-export-ascii-links-to-notes= if you
624 prefer the links to be shown in the text. In this case, Org will
625 make an attempt to wrap the line which may have become
626 significantly longer by showing the link.
628 Thanks to Samuel Wales for pointing out the bad state of ASCII
631 *** Custom agenda commands can specify a filter preset
633 If a custom agenda command specifies a value for
634 =org-agenda-filter-preset= in its options, the initial view of
635 the agenda will be filterd by the specified tags. Applying a
636 filter with =/= will then always add to that preset filter,
637 clearing the filter with =/ /= will set it back to the preset.
638 Here is an example of a custom agenda view that will display the
639 agenda, but hide all entries with tags =FLUFF= or =BLUFF=:
641 #+begin_src emacs-lisp
643 ((org-agenda-filter-preset '("-FLUFF" "-BLUFF"))))
646 This is in response to a [[http://thread.gmane.org/gmane.emacs.orgmode/11752][thread on the mailing list]], started by
647 Daniel Clemente and with great contributions by Bernt Hansen and
650 *** Exporting of citations to LaTeX and HTML, using BibTeX
652 Citations can now me made using BibTeX, and will be exported to
653 LaTeX and HTML. This is implemented in a contributed package by
654 Taru Karttunen, /org-exp-bibtex.el/. Kudos to Taru for this
655 really nice addition.
657 *** Finally a way to specify keywords and description for HTML export
662 #+DESCRIPTION: This page is all about ....
663 #+KEYWORDS: org-mode, indexing, publishing
666 To specify the content of the description and keywords meta tags
669 *** org-collector.el is now a contributed package
671 /org-collector.el/ provides functions to create tables by
672 collecting and processing properties from entries in a specific
673 scope like the current tree or file, or even from all agenda
674 files. General lisp expressions can be used to manipulate the
675 property values before they are inserted into an org-mode table,
676 for example as a dynamic block that is easy to update.
678 Thanks to Eric Schulte for yet another great contribution to
681 *** Update of org2rem.el
683 /org2rem.el/ has been updated significantly and now does a more
684 comprehensive job of exporting Org events to remind.
686 Thanks to Sharad Pratap for this update.
688 *** New div around the entire page in HTMP export
690 A new =<div id=content>= is wrapped around the entire page,
691 everything that is inside =<body>=.
693 This means that you need to update /org-info.js/ (if you have a
694 local copy). It will be safe todo so, because the new
695 org-info.js still handles older pages correctly. Thanks to
696 Sebastian Rose for making these changes so quicky.
698 *** Clustering characters for undo
700 When typing in Org-mode, undo will now remove up to 20 characters
701 at a time with a single undo command. This is how things work
702 normally in Emacs, but the special binding of characters in
703 Org-mode made this impossible until now.
705 Thanks to Martin Pohlack for a patch which mimicks the behavior
706 of the Emacs command loop for the Org version of
707 =self-insert-command=. Note that this will not work in headlines
708 and tables because typing there will do a lot of extra work.
710 There might be a small typing performance hit resulting from this
711 change - please report in the mailing list if this is noticeable
714 *** Separate settings for special C-a and C-e
716 The variable `org-special-ctrl-a/e' now allows separate settings
717 for =C-a= and =C-e=. For example
719 #+begin_src emacs-lisp
720 (setq org-special-ctrl-a/e '(reversed . t))
723 Thanks to Alan Davis for this proposal.
725 *** orgstruct++-mode improvements
727 In addition to =orgstruct-mode= which allows to use some Org-mode
728 structure commands in other major modes, there is a more invasive
729 version of this mode: =orgstruct++-mode=. This mode will import
730 all paragraph and line wrapping variables into the major mode, so
731 that, for example, during typing the auto-fill wrapping of items
732 will work just like in Org-mode. This change is not reversible,
733 so turning off =orgstruct++-mode= will not remove these settings
734 again. =orgstruct++-mode= is most useful in text modes like
735 message-mode or =magit-log-edit-mode=. Furthermore,
736 =orgstruct++-mode= will recognize plain list context not only in
737 the first line of an item, but also further down, so that =M-RET=
738 will correctly insert new items.
740 Thanks to Austin Frank for requesting some of these changes.
742 *** Promotion and demotion works for regions now
744 =M-right= and =M-left= now do demote and promote all headlines in
747 *** Match syntax for tags/properties is now described in a single place
749 The manual chapters about tags and about properties now only
750 refer to the section about agenda views, where the general syntax
751 of tag/property matches is described.
753 *** Macro replacement
755 A string like ={{{ title }}}= will be replaced by the title of
756 the document, ={{{ email }}}= by the email setting of the author
757 and similarly for other export settings given in =#+...= lines.
758 In addition to that, you can define an arbitrary number of
762 ,#+MACRO: myaddress 41 Onestreet, 12345 New York, NY
764 ,my address is {{{myaddress}}}, see you there.
767 Macro replacement is the very first thing that happens during
768 export, and macros will be replaced even in source code and other
771 *** New reload command, with keyboard access
773 There is now a special command to reload all Org Lisp files, so
774 that you can stay in your Emacs session while pulling and
775 compiling changes to Org. The command to reload the compiled
776 files (if available) is =C-c C-x r=. If no compiled files are
777 found, uncompiled ones will be loaded. If you want to force
778 loading of uncompiled code (great for producing backtraces), use
779 a prefix arg: =C-u C-c C-x r=. Both commands are available in
782 This new command was inspired by one written earlier by Bernt
785 *** Faces for priority cookies can now be set freely
787 The new variable =org-priority-faces= can be used to set faces
790 *** New key for creating tags/property sparse trees
792 The key to produce a sparse tree matching tags and properties is
793 now =C-c / m= instead of =C-c a T=. This is more consistent with
794 the =C-c a m= key for the corresponding agenda view. =C-c / T=
795 will still work for now, but it is no longer advertised in the
796 documentation and may go away at any time in the future.
798 *** IDs in HTML have "ID-" prefix when generated by uuidgen
800 /uuidgen/ generates IDs that often start with a number, not a
801 letter. However, IDs and names in XHTML must start with a letter.
802 Therefore, IDs in HTML files will now get an "ID-" prefix if they
803 have been generated by /uuidgen/. This means that id links from one
804 file to another may stop working until all files have been
805 exported again, so that both links and targets have the new prefix.
807 *** In agenda, only priority cookies get the special face
809 So far, an entire task would get a special face when
810 =org-agenda-fontify-priorities= was set. Now, the default value
811 for this variable is the symbol =cookies=, which means that on
812 the cookie is fontified. Set it to =t= if you want the entire
813 task headline to be fontified.
815 *** Turning off time-of-day search in headline
817 Some people like to put a creation time stamp into a headline and
818 then get confused if the time-of-day found in there shows up as
819 the time-of-day of the deadline/scheduling entry for this
820 headline. The reason for this is that Org searches the headline
821 for a free-format time when trying to sort the entry into the
822 agenda, and that search accidentally finds the time in the
823 creation time stamp or something else that happens to look like a
824 time. If this is more painful than useful for you, configure the
825 new variable =org-agenda-search-headline-for-time=.
834 - Capture state change notes into a drawer
835 - Clock lines are now captured into the LOGBOOK drawer as well
836 - Added org-R.el to contrib directory
837 - Allow individual formatting of each TODO keyword in HTML export
838 - New hooks for add-ons to tap into context-sensitive commands
839 - Publishing files irrespective of extension
840 - New variable index in the manual
841 - The ORDERED property also influences checkboxes
842 - The ORDERED property can be tracked with a tag
843 - You may now specify line breaks in the fast tags interface
844 - When a TODO is blocked by checkboxes, keep it visible in agenda
845 - LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc.
847 ** Incompatible changes
849 - CLOCK lines will now be captured into the LOGBOOK drawer.
850 See below for details.
854 *** Capture state change notes into a drawer
856 State change notes can now be captured into a drawer =LOGBOOK=,
857 to keep the entry tidy. If this is what you want, you will need
860 #+begin_src emacs-lisp
861 (setq org-log-into-drawer "LOGBOOK")
864 Thanks to Wanrong Lin for this proposal.
866 *** Clock lines are now captured into the LOGBOOK drawer as well
868 The =CLOCK= drawer will be abandoned, clock lines will now also
869 end up in a drawer =LOGBOOK=. The reason for this is that it's a
870 bit useless to have two different drawers for state change notes
871 and clock lines. If you wish to keep the old way, use
873 #+begin_src emacs-lisp
874 (setq org-clock-into-drawer "CLOCK")
877 *** Added org-R.el to contrib directory
879 Dan Davison has contributed /org-R.el/ which is now in the
880 contrib directory. Org-R performs numerical computations and
881 generates graphics. Data can come from org tables, or from csv
882 files; numerical output can be stored in the org buffer as org
883 tables, and links are created to files containing graphical
884 output. Although, behind the scenes, it uses R, you do not need
885 to know anything about R. Common operations, such as tabulating
886 discrete values in a column of an org table, are available "off
887 the shelf" by specifying options on lines starting with =#+R:=.
888 However, you can also provide raw R code to be evaluated. The
889 documentation is currently the worg tutorial at
890 http://orgmode.org/worg/org-tutorials/org-R/org-R.php
892 Thanks to Dan for this great contribution.
894 *** Allow individual formatting of TODO keyword and tags in HTML export
896 TODO keywords in HTML export have the CSS class =todo= or =done=.
897 Tags have the CSS class =tag=. In addition to this, each keyword
898 has now itself as class, so you could do this in your CSS file:
901 .todo { font-weight:bold; }
902 .done { font-weight:bold; }
904 .WAITING { color:orange; }
905 .DONE { color:green; }
908 If any of your keywords causes conflicts with CSS classes used
909 for different purposes (for example a tag "title" would cause a
910 conflict with the class used for formatting the document title),
911 then you can use the variables =org-export-html-tag-class-prefix=
912 and =org-export-html-todo-kwd-class-prefix= to define prefixes
913 for the class names for keywords, for example "kwd-".
915 Thanks to Wanrong Lin for this request, and to Sebastian Rose for
916 help with the implementation.
918 *** New hooks for add-ons to tap into context-sensitive commands
920 Some commands in Org are context-sensitive, they will execute
921 different functions depending on context. The most important
922 example is of course =C-c C-c=, but also the =M-cursor= keys fall
925 Org has now a system of hooks that can be used by add-on packages
926 to install their own functionality into these keys. See the
927 docstring of =org-ctrl-c-ctrl-c-hook= for details. The other
928 hooks are named like =org-metaleft-hook= or
929 =org-shiftmetaright-hook=.
931 *** Publishing files irrespective of extension
933 If you set the =:base-extension= property for a publishing
934 project to the symbol =any=, all files in the directory will be
935 published, irrespective of extension.
937 Thanks to Richard Klinda for a patch to this effect.
939 *** New variable index in the manual
941 A new index in the manual lists all variables mentioned in the
942 manual, about 200 variables in total.
944 *** The ORDERED property also influences checkboxes
946 When an entry has the ORDERED property set, checkboxes in
947 the entry must be completed in order. This was already the case
948 for children TODO items, now it also applies for checkboxes.
950 Thanks to Rainer Stengele for this proposal.
952 *** The ORDERED property can be tracked with a tag
954 The =ORDERED= property is used to flag an entry so that subtasks
955 (both children TODO items and checkboxes) must be completed in
956 order. This property is most easily toggled with the command
957 =C-c C-x o=. A property was chosen for this functionality,
958 because this should be a behavior local to the current task, not
959 inherited like tags. However, properties are normally
960 invisible. If you would like visual feedback on the state of
961 this property, configure the variable
962 =org-track-ordered-property-with-tag=. If you then use =C-c C-x
963 o= to toggle the property, a tag will be toggled as well, for
966 Note that the tag itself has no meaning for the behavior of TODO
967 items and checkboxes, and that changing the tag with the usual
968 tag commands will not influence the property and therefore the
969 behavior of TODO and checkbox commands.
971 *** You may now specify line breaks in the fast tags interface
973 Up to now, the fast tags interface tried to lump as many tags as
974 possible into a single line, with the exception that groups would
975 always be on a line by themselves.
977 Now, if you use several lines to define your tags, like
980 ,#+TAGS: aa(a) bb(b) cc(c)
981 ,#+TAGS: dd(d) ee(e) ff(f)
984 then there will also be a line break after the "cc" tag in the
985 fast tag selection interface. You may also write
988 ,#+TAGS: aa(a) bb(b) cc(c) \n dd(d) ee(e) ff(f)
991 to achieve the same effect, and you can use =\n= several times in
992 order to produce empty lines. In =org-tag-alist=, newlines are
993 represented as =(:newline)=.
995 Thanks to Christopher Suckling for a patch to this effect.
997 *** When a TODO is blocked by checkboxes, keep it visible in agenda
999 When the variable =org-agenda-dim-blocked-tasks= is set to
1000 =invisible=, tasks that are blocked will not be visible in the
1001 agenda. If the blocking is due to child TODO entries, this does
1002 make sense because the children themselves will show up in the
1005 However, as John Rakestraw has [[http://thread.gmane.org/gmane.emacs.orgmode/10939][pointed out]], if the blocking is
1006 done by checkboxes, no trace of these subtasks is left.
1007 Therefore, when the blocking is done by checkboxes, we now
1008 overrule the =invisible= setting and replace it with mere dimming
1011 *** LaTeX can import Org's in-buffer definitions for TITLE, EMAIL etc.
1013 If you configure =org-export-latex-import-inbuffer-stuff=,
1014 in-buffer definitions like #+TITLE will be made available in the
1015 LaTeX file as =\orgTITLE=.
1017 This was a request by Russel Adams.
1025 *** org-choose.el by Tom Breton is now included
1027 Org-choose helps documenting a decision-making process by using
1028 TODO keywords for different degrees of /chosenness/, and by
1029 automatically keeping a set of alternatives in a consistent state.
1031 Documentation for /org-choose.el/ is available [[http://orgmode.org/worg/org-contrib/org-choose.php][here]].
1033 This package inserts itself into Org using hooks, so if other
1034 people would like to do interesting stuff with TODO keywords for
1035 special purposes, looking at Tom's code might be a good way to
1038 Thanks to Tom for this interesting contribution!
1040 *** orgmode.org and Worg css works now better on IE
1042 Thanks to Sebastian Rose for making these changes.
1044 *** When exporting a subtree, headline levels are now relative to parent
1046 This was reported as a bug by William Henney and is fixed now.
1048 *** Inactive dates in tables can be used for sorting.
1050 When sorting table fields or entries by date, Org first tries to
1051 find an active date, and, if none exist, uses a passive date if
1054 This was a request by Hsui-Khuen Tang
1056 *** The default for =org-return-follows-link= is back to =nil=
1058 Setting it to =t= violates Emacs rules to some extent. The
1059 internal implementation of this has been improved, so setting it
1060 to =t= should now be pretty stable.
1062 *** Automatic scheduling of siblings with org-depend.el
1064 The sibling of a DONE task can now automatically be scheduled.
1066 This was a patch by Andrew Hyatt.
1068 *** New skipping conditions
1070 The functions =org-agenda-skip-entry-if= and
1071 =org-agenda-skip-subtree-if= now accept =timestamp= and
1072 =nottimestamp= as additional conditions.
1074 This was in response to a request by Saurabh Agrawal.
1083 *** Changes to some default values of variables:
1085 Here are the new default values:
1088 (setq org-return-follows-link t)
1090 (setq org-use-fast-todo-selection t)
1092 (setq org-yank-adjusted-subtrees nil)
1094 (setq org-tags-column -77)
1096 (setq org-agenda-sorting-strategy
1097 '((agenda time-up priority-down category-keep)
1098 (todo time-up priority-down category-keep)
1099 (tags time-up priority-down category-keep)
1100 (search category-keep)))
1103 *** Final cleanup for Emacs 21.1 pretest
1112 *** Support for simple TODO dependencies
1114 John Wiegley's code for enforcing simple TODO dependencies has
1115 been integrated into Org-mode. Thanks John!
1117 The structure of Org files (hierarchy and lists) makes it easy to
1118 define TODO dependencies. A parent TODO task should not be
1119 marked DONE until all subtasks (defined as children tasks) are
1120 marked as DONE. And sometimes there is a logical sequence to a
1121 number of (sub)tasks, so that one task cannot be acted upon
1122 before all siblings above it are done. If you customize the
1123 variable =org-enforce-todo-dependencies=, Org will block entries
1124 from changing state while they have children that are not DONE.
1125 Furthermore, if an entry has a property =ORDERED=, each of its
1126 children will be blocked until all earlier siblings are marked
1127 DONE. Here is an example:
1130 ,* TODO Blocked until (two) is done
1139 ,** TODO b, needs to wait for (a)
1140 ,** TODO c, needs to wait for (a) and (b)
1143 The command =C-c C-x o= toggles the value of the =ORDERED=
1146 The variable =org-agenda-dim-blocked-tasks= controls how blocked
1147 entries should appear in the agenda, where they can be dimmed or
1148 even made invisible.
1150 Furthermore, you can use the variable
1151 =org-enforce-todo-checkbox-dependencies= to block TODO entries
1152 from switching to DONE while any checkboxes are unchecked in the entry.
1154 *** Support for shift-selection in Emacs 23
1156 Customize the variable =org-support-shift-select= to use S-cursor
1157 key for selecting text. Make sure that you carefully read the
1158 docstring of that variable first.
1160 *** Adding and removing checkboxes from many lines
1162 The command =C-c C-x C-b= normally toggles checkbox status in the
1163 current line, or in all lines in the region. With prefix
1164 argument it now either adds or removes the checkbox.
1166 This was a requested by Daniel Clemente.
1175 - Improved behavior of conversion commands =C-c -= and =C-c *=
1176 - Table formulas may now reference fields in other tables
1177 - A final hline is imagined in each table, for the sake of references
1178 - A tags-todo search can now ignore timestamped items
1179 - =\par= can be used to force a paragraph break, also in footnotes
1184 *** Improved behavior of conversion commands =C-c -= and =C-c *=
1186 The conversion commands =C-c -= and =C-c *= are now better
1187 behaved and therefore more useful, I hope.
1189 If there is an active region, these commands will act on the
1190 region, otherwise on the current line.
1192 - C-c - :: This command turns headings or normal lines into
1193 items, or items into normal lines. When there is a
1194 region, everything depends on the first line of the
1196 - if it is a item, turn all items in the region into
1198 - if it is a headline, turn all headlines in the region
1200 - if it is a normal line, turn all lines into items.
1201 - special case: if there is no active region and the
1202 current line is an item, cycle the bullet type of the
1204 - C-c * :: This command turns items and normal lines into
1205 headings, or headings into normal lines. When there is
1206 a region, everything depends on the first line of the
1208 - if it is a item, turn all items in the region into
1210 - if it is a headline, turn all headlines in the region
1212 - if it is a normal line, turn all lines into headlines.
1214 *** Table formulas may now reference fields in other tables
1216 You may now reference constants, fields and ranges from a
1217 different table, either in the current file or even in a
1218 different file. The syntax is
1220 : remote(NAME-OR-ID,REF)
1222 where /NAME/ can be the name of a table in the current file as
1223 set by a =#+TBLNAME: NAME= line before the table. It can also be
1224 the ID of an entry, even in a different file, and the reference
1225 then refers to the first table in that entry. /REF/ is an
1226 absolute field or range reference, valid in the referenced table.
1227 Note that since there is no "current filed" for the remote table,
1228 all row and column references must be absolute, not relative.
1230 *** A final hline is imagined in each table, for the sake of references
1232 Even if a table does not end with a hline (mine never do because I
1233 think it is not pretty), for the sake of references you can
1234 assume there is one. So in the following table
1243 a reference like =@I$1..@II$2= will now work.
1245 *** A tags-todo search can now ignore timestamped items
1246 The variables =org-agenda-todo-ignore-with-date=,
1247 =org-agenda-todo-ignore-with-date=, and
1248 =org-agenda-todo-ignore-with-date= make it possible to
1249 exclude TODO entries which have this kind of planning info
1250 associated with them. This is most useful for people who
1251 schedule everything, and who use the TODO list mainly to find
1252 things that are not yet scheduled. Thomas Morgan pointed out
1253 that also the tags-todo search may serve exactly this
1254 purpose, and that it might be good to have a way to make
1255 these variables also apply to the tags-todo search. I can
1256 see that, but could not convince myself to make this the
1257 default. A new variable must be set to make this happen:
1258 =org-agenda-tags-todo-honor-ignore-options=.
1260 *** =\par= can be used to force a paragraph break, also in footnotes
1262 The LaTeX idiom =\par= will insert a paragraph break at that
1263 location. Normally you would simply leave an empty line to get
1264 such a break, but this is useful for footnotes whose
1265 definitions may not contain empty lines.
1271 ** Incompatible changes
1273 *** Short examples must have a space after the colon
1275 Short literal examples can be created by preceding lines
1276 with a colon. Such lines must now have a space after the
1277 colon. I believe this is already general practice, but now
1278 it must be like this. The only exception are lines that are
1279 empty except for the colon.
1283 *** Include files can now also process switches
1285 The example and src switches like =-n= can now also be added
1286 to include file statements:
1288 : #+INCLUDE "~/.emacs" src emacs-lisp -n -r
1290 Thanks to Manish for pointing out that this was not yet
1293 *** Examples can be exported to HTML as text areas
1295 You can now specify a =-t= switch to an example or src block,
1296 to make it export to HTML as a text area. To change the
1297 defaults for height (number of lines in the example) and
1298 width of this area (80), use the =-h= and =-w= switches.
1300 Thanks to Ulf Stegemann for driving this development.
1302 *** LaTeX_CLASS can be given as a property
1304 When exporting a single subtree by selecting it as a region
1305 before export, the LaTeX class for the export will be taken
1306 from the =LaTeX_CLASS= property of the entry if present.
1308 Thanks to Robert Goldman for this request.
1310 *** Better handling of inlined images in different backends
1312 Two new variables govern which kind of files can be inlined
1313 during export. These are
1314 =org-export-html-inline-image-extensions= and
1315 =org-export-latex-inline-image-extensions=. Remember that
1316 links are turned into an inline image if they are a pure link
1317 with no description. HTML files can inline /.png/, /.jpg/,
1318 and /.gif/ files, while LaTeX files, when processed with
1319 /pdflatex/, can inline /.png/, /.jpg/, and /.pdf/ files.
1320 These also represent the default settings for the new
1321 variables. Note that this means that pure links to /.pdf/
1322 files will be inlined - to avoid this for a particular link,
1323 make sure that the link has a description part which is not
1324 equal to the link part.
1326 *** Links by ID now continue to work in HTML exported files
1328 If you make links by ID, these links will now still work in
1329 HTML exported files, provided that you keep the relative path
1330 from link to target file the same.
1332 Thanks to Friedrich Delgado Friedrichs for pushing this over
1335 *** The relative timer can be paused
1337 The new command `C-c C-x ,' will pause the relative timer.
1338 When the relative timer is running, its value will be shown
1339 in the mode line. To get rid of this display, you need to
1340 really stop the timer with `C-u C-c C-x ,'.
1342 Thanks to Alan Davis for driving this change.
1344 *** The attachment directory may now be chosen by the user
1346 Instead of using the automatic, unique directory related to
1347 the entry ID, you can also use a chosen directory for the
1348 attachments of an entry. This directory is specified by the
1349 ATTACH_DIR property. You can use `C-c C-a s' to set this
1352 Thanks to Jason Jackson for this proposal.
1354 *** You can use a single attachment directory for a subtree
1356 By setting the property ATTACH_DIR_INHERIT, you can now tell
1357 Org that children of the entry should use the same directory
1358 for attachments, unless a child explicitly defines its own
1359 directory with the ATTACH_DIR property. You can use the
1360 command `C-c C-a i' to set this property in an entry.
1370 - Line numbers and references in literal examples
1371 - New hooks for export preprocessing
1372 - Capture column view into a different file
1376 *** Footnote support
1378 Org-mode now directly supports the creation of footnotes. In
1379 contrast to the /footnote.el/ package, Org-mode's footnotes are
1380 designed for work on a larger document, not only for one-off
1381 documents like emails. The basic syntax is similar to the one
1382 used by /footnote.el/, i.e. a footnote is defined in a paragraph
1383 that is started by a footnote marker in square brackets in column
1384 0, no indentation allowed. The footnote reference is simply the
1385 marker in square brackets inside text. For example:
1388 The Org homepage[fn:1] now looks a lot better than it used to.
1390 [fn:1] The link is: http://orgmode.org
1393 Org-mode extends the number-based syntax to /named/ footnotes and
1394 optional inline definition. Using plain numbers as markers is
1395 supported for backward compatibility, but not encouraged because
1396 of possible conflicts with LaTeX syntax. Here are the valid
1399 - [1] :: A plain numeric footnote marker.
1401 - [fn:name] :: A named footnote reference, where `name' is a
1402 unique label word or, for simplicity of automatic creation,
1405 - [fn:: This is the inline definition of this footnote] :: A
1406 LaTeX-like anonymous footnote where the definition is given
1407 directly at the reference point.
1409 - [fn:name: a definition] :: An inline definition of a footnote,
1410 which also specifies a name for the note. Since Org allows
1411 multiple references to the same note, you can then use use
1412 `[fn:name]' to create additional references.
1414 Footnote labels can be created automatically, or you create names
1415 yourself. This is handled by the variable
1416 =org-footnote-auto-label= and its corresponding =#+STARTUP=
1417 keywords, see the docstring of that variable for details.
1419 The following command handles footnotes:
1421 - C-c C-x f :: The footnote action command. When the cursor is
1422 on a footnote reference, jump to the definition. When it is
1423 at a definition, jump to the (first) reference. Otherwise,
1424 create a new footnote. Depending on the variable
1425 `org-footnote-define-inline' (with associated =#+STARTUP=
1426 options =fninline= and =nofninline=), the definitions will
1427 be placed right into the text as part of the reference, or
1428 separately into the location determined by the variable
1429 =org-footnote-section=.
1430 When this command is called with a prefix argument, a menu
1431 of additional options is offered:
1432 - s :: Sort the footnote definitions by reference sequence.
1433 During editing, Org makes no effort to sort footnote
1434 definitions into a particular sequence. If you want
1435 them sorted, use this command, which will also move
1436 entries according to =org-footnote-section=.
1437 - n :: Normalize the footnotes by collecting all
1438 definitions (including inline definitions) into a
1439 special section, and then numbering them in
1440 sequence. The references will then also be
1441 numbers. This is meant to be the final step before
1442 finishing a document (e.g. sending off an email).
1443 The exporters do this automatically, and so could
1444 something like `message-send-hook'.
1445 - d :: Delete the footnote at point, and all references to it.
1447 - C-c C-c :: If the cursor is on a footnote reference, jump to
1448 the definition. If it is a the definition, jump back to the
1449 reference. When called with a prefix argument at either
1450 location, offer the same menu as `C-u C-c C-x f'.
1452 - C-c C-o or mouse-1/2 :: Footnote labels are also links to the
1453 corresponding definition/reference, and you can use the
1454 usual commands to follow these links.
1456 Org-mode's footnote support is designed so that it should also
1457 work in buffers that are not in Org-mode, for example in email
1458 messages. Just bind =org-footnote-action= to a global key like
1461 The main trigger for this development came from a hook function
1462 written by Paul Rivier, to implement named footnotes and to
1463 convert them to numbered ones before export. Thanks, Paul!
1465 Thanks also to Scot Becker for a thoughtful post bringing this
1466 subject back onto the discussion table, and to Matt Lundin for
1467 the idea of named footnotes and his prompt testing of the new
1470 *** Line numbers and references in literal examples
1472 Literal examples introduced with =#+BEGIN_EXAMPLE= or =#+BEGIN_SRC=
1473 do now allow optional line numbering in the example.
1474 Furthermore, links to specific code lines are supported, greatly
1475 increasing Org-mode's utility for writing tutorials and other
1478 Code references use special labels embedded directly into the
1479 source code. Such labels look like "(ref:name)" and must be
1480 unique within a document. Org-mode links with "(name)" in the
1481 link part will be correctly interpreted, both while working with
1482 an Org file (internal links), and while exporting to the
1483 different backends. Line numbering and code references are
1484 supported for all three major backends, HTML, LaTeX, and ASCII.
1485 In the HTML backend, hovering the mouse over a link to a source
1486 line will remote-highlight the referenced code line.
1488 The options for the BEGIN lines are:
1490 - -n :: Number the lines in the example
1491 - +n :: Like -n, but continue numbering from where the previous
1493 - -r :: Remove the coderef cookies from the example, and replace
1494 links to this reference with line numbers. This option
1495 takes only effect if either -n or +n are given as well.
1496 If -r is not given, coderefs simply use the label name.
1497 - -l "fmt" :: Define a local format for coderef labels, see the
1498 variable =org-coderef-label-format= for details. Use this
1499 of the default syntax causes conflicts with the code in the
1500 code snippet you are using.
1505 #+begin_src emacs-lisp -n -r
1506 (defmacro org-unmodified (&rest body) (ref:def)
1507 "Execute body without changing `buffer-modified-p'."
1508 `(set-buffer-modified-p (ref:back)
1509 (prog1 (buffer-modified-p) ,@body)))
1511 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
1512 backquoting is used.
1515 When exported, this is translated to:
1516 #+begin_src emacs-lisp -n -r
1517 (defmacro org-unmodified (&rest body) (ref:def)
1518 "Execute body without changing `buffer-modified-p'."
1519 `(set-buffer-modified-p (ref:back)
1520 (prog1 (buffer-modified-p) ,@body)))
1522 [[(def)][Line (def)]] contains the macro name. Later at line [[(back)]],
1523 backquoting is used.
1525 Thanks to Ilya Shlyakhter for proposing this feature set. Thanks
1526 to Sebastian Rose for the key Javascript element that made the
1527 remote highlighting possible.
1529 *** New hooks for export preprocessing
1530 The export preprocessor now runs more hooks, to allow
1531 better-timed tweaking by user functions:
1533 - =org-export-preprocess-hook= ::
1534 Pretty much the first thing in the preprocessor. But org-mode
1535 is already active in the preprocessing buffer.
1537 - =org-export-preprocess-after-include-files-hook= ::
1538 This is run after the contents of included files have been inserted.
1540 - =org-export-preprocess-after-tree-selection-hook= ::
1541 This is run after selection of trees to be exported has
1542 happened. This selection includes tags-based selection, as
1543 well as removal of commented and archived trees.
1545 - =org-export-preprocess-before-backend-specifics-hook= ::
1546 Hook run before backend-specific functions are called during preprocessing.
1548 - =org-export-preprocess-final-hook= ::
1549 Hook for preprocessing an export buffer. This is run as the
1550 last thing in the preprocessing buffer, just before returning
1551 the buffer string to the backend.
1553 *** Capture column view into a different file
1555 The :id parameter for the dynamic block capturing column view
1556 can now truly be an ID that will also be found in a
1557 different file. Also, it can be like =file:path/to/file=, to
1558 capture the global column view from a different file.
1560 Thanks to Francois Lagarde for his report that IDs outside
1561 the current file would not work.
1567 Cleanup of many small bugs, and one new feature.
1571 *** References to last table row with special names
1573 Fields in the last row of a table can now be referenced with
1574 $LR1, $LR2, etc. These references can appear both on the
1575 left hand side and right hand side of a formula.
1582 This version reverses the introduction of @0 as a reference to
1583 the last rwo in a table, because of a conflict with the use of
1584 @0 for the current row.
1592 - All known LaTeX export issues fixed
1593 - Captions and attributes for figures and tables.
1594 - Better implementation for entry IDs
1595 - Spreadsheet references to the last table line.
1596 - Old syntax for link attributes abandoned
1598 ** Incompatible changes
1599 *** Old syntax for link attributes abandoned
1601 There used to be a syntax for setting link attributes for
1602 HTML export by enclosing the attributes into double braces
1603 and adding them to the link itself, like
1606 [[./img/a.jpg{{alt="an image"}}] ]
1609 This syntax is not longer supported, use instead
1612 ,#+ATTR_HTML: alt="an image"
1618 *** All known LaTeX export issues fixed
1620 All the remaining issues with the LaTeX exporter have hopefully
1621 been addressed in this release. In particular, this covers
1622 quoting of special characters in tables and problems with
1623 exporting files where the headline is in the first line, or with
1626 *** Captions and attributes for figures and tables.
1628 Tables, and Hyperlinks that represent inlined images, can now be
1629 equipped with additional information that will be used during
1630 export. The information will be taken from the following special
1631 lines in the buffer and apply to the first following table or
1634 - #+CAPTION: :: The caption of the image or table. This string
1635 should be processed according to the export backend, but
1636 this is not yet done.
1638 - #+LABEL: :: A label to identify the figure/table for cross
1639 references. For HTML export, this string will become the
1640 ID for the ~<div class="figure">~ element that encapsulates
1641 the image tag and the caption. For LaTeX export, this
1642 string will be used as the argument of a ~\label{...}~
1643 macro. These labels will be available for internal links
1644 like ~[[label][Table] ]~.
1646 - #+ATTR_HTML: :: Attributes for HTML export of image, to be
1647 added as attributes into the ~<img...>~ tag. This string
1648 will not be processed, so it should have immediately the
1651 - #+ATTR_LaTeX: :: Attributes for LaTeX export of images and
1653 For /images/, this string is directly inserted into
1654 the optional argument of the ~\includegraphics[...]{file}~
1655 command, to specify scaling, clipping and other options.
1656 This string will not be processed, so it should have
1657 immediately the right format, like =width=5cm,angle=90=.\\
1658 For /tables/, this can currently contain the keyword
1659 =longtable=, to request typesetting of the table using the
1660 longtable package, which automatically distributes the table
1661 over several pages if needed. Also, the attributes line may
1662 contain an alignment string for the tabular environment, like
1663 =longtable,align=l|lrl=
1665 For LaTeX export, if either a caption or a label is given, the element
1666 will be exported as a float, i.e. wrapped into a figure or table
1669 *** Better implementation for entry IDs
1671 Unique identifiers for entries can now be used more efficiently.
1672 Internally, a hash array has replaced the alist used so far to
1673 keep track of the files in which an ID is defined. This makes it
1674 quite fast to find an entry by ID.
1676 There is a new link type which looks like this:
1679 id:GLOBALLY-UNIQUE-IDENTIFIER
1682 This link points to a specific entry. When you move the entry to
1683 a different file, for example if you move it to an archive
1684 file, the link will continue to work.
1686 The file /org-id.el/ contains an API that can be used to write
1687 code using these identifiers, including creating IDs and finding
1688 them wherever they are.
1690 Org has its own method to create unique identifiers, but if the system
1691 has /uuidgen/ command installed (Mac's and Linux systems generally
1692 do), it will be used by default (a change compared to the earlier
1693 implmentation, where you explicitdly had to opt for uuidgen). You can
1694 also select the method by hand, using the variable =org-id-method=.
1696 If the ID system ever gets confused about where a certain ID is, it
1697 initiates a global scan of all agenda files with associated archives,
1698 all files previously known containing any IDs, and all currently
1699 visited Org-mode files to rebuild the hash. You can also initiate
1700 this by hand: =M-x org-id-update-id-locations=. Running this command
1701 will also dump into the =*Messages*= buffer information about any
1702 duplicate IDs. These should not exist, and Org will never /make/ the
1703 same ID twice, but if you /copy/ an entry with its properties,
1704 duplicate IDs will inevitably be produced. Unfortunately, this is
1705 unavoidable in a plain text system that allows you to edit the text in
1706 arbitrary ways, and a portion of care on your side is needed to keep
1709 The hash is stored in the file =~/.emacs.d/.org-id-locations=.
1710 This is also a change from previous versions where the file was
1711 =~/.org=id-locations=. Therefore, you can remove this old file
1712 if you have it. I am not sure what will happen if the =.emacs.d=
1713 directory does not exists in your setup, but in modern Emacsen, I
1714 believe it should exist. If you do not want to use IDs across
1715 files, you can avoid the overhead with tracking IDs by
1716 customizing the variable =org-id-track-globally=. IDs can then
1717 still be used for links inside a single file.
1719 IDs will also be used when you create a new link to an Org-mode
1720 buffer. If you use =org-store-link= (normally at =C-c l=) inside
1721 en entry in an Org-mode buffer, and ID property will be created
1722 if it does not exist, and the stored link will be an =id:= link.
1723 If you prefer the much less secure linking to headline text, you
1724 can configure the variable =org-link-to-org-use-id=. The default
1725 setting for this variable is =create-if-interactive=, meaning
1726 that an ID will be created when you store a link interactively,
1727 but not if you happen to be in an Org-mode file while you create
1728 a remember note (which usually has a link to the place where you
1729 were when starting remember).
1731 *** Spreadsheet references to the last table line.
1733 You may now use =@0= to reference the last dataline in a table
1734 in a stable way. This is useful in particular for automatically
1735 generated tables like the ones using /org-collector.el/ by Eric
1744 - New relative timer to support timed notes
1745 - Special faces can be set for individual tags
1746 - The agenda shows now all tags, including inherited ones.
1747 - Exclude some tags from inheritance.
1748 - More special values for time comparisons in property searches
1749 - Control for exporting meta data
1750 - Cut and Paste with hot links from w3m to Org
1751 - LOCATION can be inherited for iCalendar export
1752 - Relative row references crossing hlines now throw an error
1754 ** Incompatible Changes
1756 *** Relative row references crossing hlines now throw an error
1758 Relative row references in tables look like this: "@-4" which
1759 means the forth row above this one. These row references are
1760 not allowed to cross horizontal separator lines (hlines). So
1761 far, when a row reference violates this policy, Org would
1762 silently choose the field just next to the hline.
1764 Tassilo Horn pointed out that this kind of hidden magic is
1765 actually confusing and may cause incorrect formulas, and I do
1766 agree. Therefore, trying to cross a hline with a relative
1767 reference will now throw an error.
1769 If you need the old behavior, customize the variable
1770 `org-table-error-on-row-ref-crossing-hline'.
1774 *** New relative timer to support timed notes
1776 Org now supports taking timed notes, useful for example while
1777 watching a video, or during a meeting which is also recorded.
1780 Insert a relative time into the buffer. The first time
1781 you use this, the timer will be started. When called
1782 with a prefix argument, the timer is reset to 0.
1785 Insert a description list item with the current relative
1786 time. With a prefix argument, first reset the timer to 0.
1789 Once the time list has been initiated, you can also use the
1790 normal item-creating command to insert the next timer item.
1793 Reset the timer without inserting anything into the buffer.
1794 By default, the timer is reset to 0. When called with a
1795 =C-u= prefix, reset the timer to specific starting
1796 offset. The user is prompted for the offset, with a
1797 default taken from a timer string at point, if any, So this
1798 can be used to restart taking notes after a break in the
1799 process. When called with a double prefix argument
1800 =C-c C-u=, change all timer strings in the active
1801 region by a certain amount. This can be used to fix timer
1802 strings if the timer was not started at exactly the right
1805 Thanks to Alan Dove, Adam Spiers, and Alan Davis for
1806 contributions to this idea.
1808 *** Special faces can be set for individual tags
1810 You may now use the variable =org-tag-faces= to define the
1811 face used for specific tags, much in the same way as you can
1812 do for TODO keywords.
1814 Thanks to Samuel Wales for this proposal.
1816 *** The agenda shows now all tags, including inherited ones.
1818 This request has come up often, most recently it was
1819 formulated by Tassilo Horn.
1821 If you prefer the old behavior of only showing the local
1822 tags, customize the variable =org-agenda-show-inherited-tags=.
1824 *** Exclude some tags from inheritance.
1826 So far, the only way to select tags for inheritance was to
1827 allow it for all tags, or to do a positive selection using
1828 one of the more complex settings for
1829 `org-use-tag-inheritance'. It may actually be better to
1830 allow inheritance for all but a few tags, which was difficult
1831 to achieve with this methodology.
1833 A new option, `org-tags-exclude-from-inheritance', allows to
1834 specify an exclusion list for inherited tags.
1836 *** More special values for time comparisons in property searches
1838 In addition to =<now>=, =<today>=, =<yesterday>=, and
1839 =<tomorrow>=, there are more special values accepted now in
1840 time comparisons in property searches: You may use strings
1841 like =<+3d>= or =<-2w>=, with units d, w, m, and y for day,
1842 week, month, and year, respectively
1844 Thanks to Linday Todd for this proposal.
1846 *** Control for exporting meta data
1848 All the metadata in a headline, i.e. the TODO keyword, the
1849 priority cookie, and the tags, can now be excluded from
1850 export with appropriate options:
1852 | Variable | Publishing property | OPTIONS switch |
1853 |-------------------------------+---------------------+----------------|
1854 | org-export-with-todo-keywords | :todo-keywords | todo: |
1855 | org-export-with-tags | :tags | tags: |
1856 | org-export-with-priority | :priority | pri: |
1858 *** Cut and Paste with hot links from w3m to Org
1860 You can now use the key =C-c C-x M-w= in a w3m buffer with
1861 HTML content to copy either the region or the entire file in
1862 a special way. When you yank this text back into an Org-mode
1863 buffer, all links from the w3m buffer will continue to work
1866 For this to work you need to load the new file /org-w3m.el./
1867 Please check your org-modules variable to make sure that this
1870 Thanks for Richard Riley for the idea and to Andy Stewart for
1873 *** LOCATION can be inherited for iCalendar export
1875 The LOCATION property can now be inherited during iCalendar
1876 export if you configure =org-use-property-inheritance= like
1879 #+begin_src emacs-lisp
1880 (setq org-use-property-inheritance '("LOCATION"))
1890 - Keybindings in Remember buffers can be configured
1891 - Support for ido completion
1892 - New face for date lines in agenda column view
1893 - Invisible targets become now anchors in headlines.
1894 - New contributed file /org-exp-blocks.el/
1895 - New contributed file /org-eval-light.el/
1897 - BBDB links may use regular expressions.
1898 - Link abbreviations can use %h to insert a url-encoded target value
1899 - Improved XHTML compliance
1903 *** Keybindings in Remember buffers can be configured
1905 The remember buffers created with Org's extensions are in
1906 Org-mode, which is nice to prepare snippets that will
1907 actually be stored in Org-mode files. However, this makes it
1908 hard to configure key bindings without modifying the Org-mode
1909 keymap. There is now a minor mode active in these buffers,
1910 `org-remember-mode', and its keymap org-remember-mode-map can
1911 be used for key bindings. By default, this map only contains
1912 the bindings for =C-c C-c= to store the note, and =C-c C-k=
1913 to abort it. Use `org-remember-mode-hook' to define your own
1916 #+begin_src emacs-lisp
1918 'org-remember-mode-hook
1920 (define-key org-remember-mode-map
1921 "\C-x\C-s" 'org-remember-finalize)))
1924 If you wish, you can also use this to free the =C-c C-c=
1925 binding (by binding this key to nil in the minor mode map),
1926 so that you can use =C-c C-c= again to set tags.
1928 This modification is based on a request by Tim O'Callaghan.
1930 *** Support for ido completion
1932 You can now get the completion interface from /ido.el/ for
1933 many of Org's internal completion commands by turning on the
1934 variable =org-completion-use-ido=. =ido-mode= must also be
1935 active before you can use this.
1937 This change is based upon a request by Samuel Wales.
1939 *** New face for date lines in agenda column view
1941 When column view is active in the agenda, and when you have
1942 summarizing properties, the date lines become normal column
1943 lines and the separation between different days becomes
1944 harder to see. If this bothers you, you can now customize
1945 the face =org-agenda-column-dateline=.
1947 This is based on a request by George Pearson.
1949 *** Invisible targets become now anchors in headlines.
1951 These anchors can be used to jump to a directly with an HTML
1952 link, just like the =sec-xxx= IDs. For example, the
1953 following will make a http link
1954 =//domain/path-to-my-file.html#dummy= work:
1961 This is based on a request by Matt Lundin.
1963 *** New contributed file /org-exp-blocks.el/
1965 This new file implements special export behavior of
1966 user-defined blocks. The currently supported blocks are
1968 - comment :: Comment blocks with author-specific markup
1969 - ditaa :: conversion of ASCII art into pretty png files
1970 using Stathis Sideris' /ditaa.jar/ program
1971 - dot :: creation of graphs in the /dot/ language
1972 - R :: Sweave type exporting using the R program
1974 For more details and examples, see the file commentary in
1975 /org-exp-blocks.el/.
1977 Kudos to Eric Schulte for this new functionality, after
1978 /org-plot.el/ already his second major contribution. Thanks
1979 to Stathis for this excellent program, and for allowing us to
1980 bundle it with Org-mode.
1982 *** New contributed file /org-eval-light.el/
1984 This module gives control over execution Emacs Lisp code
1985 blocks included in a file.
1987 Thanks to Eric Schulte also for this file.
1989 *** Link translation
1991 You can now configure Org to understand many links created
1992 with the Emacs Planner package, so you can cut text from
1993 planner pages and paste them into Org-mode files without
1994 having to re-write the links. Among other things, this means
1995 that the command =org-open-at-point-global= which follows
1996 links not only in Org-mode, but in arbitrary files like
1997 source code files etc, will work also with links created by
1998 planner. The following customization is needed to make all of
2001 #+begin_src emacs-lisp
2002 (setq org-link-translation-function
2003 'org-translate-link-from-planner)
2006 I guess an inverse translator could be written and integrated
2009 *** BBDB links may use regular expressions.
2011 This did work all along, but only now I have documented it.
2013 *** =yank-pop= works again after yanking an outline tree
2015 Samuel Wales had noticed that =org-yank= did mess up this
2016 functionality. Now you can use =yank-pop= again, the only
2017 restriction is that the so-yanked text will not be
2018 pro/demoted or folded.
2020 *** Link abbreviations can use %h to insert a url-encoded target value
2022 Thanks to Steve Purcell for a patch to this effect.
2024 *** Improved XHTML compliance
2026 Thanks to Sebastian Rose for pushing this.
2028 *** Many bug fixes again.
2036 - A region of entries can now be refiled with a single command
2037 - Fine-tuning the behavior of `org-yank'
2038 - Formulas for clocktables
2039 - Better implementation of footnotes for HTML export
2040 - More languages for HTML export.
2044 *** A region of entries can now be refiled with a single command
2046 With =transient-make-mode= active (=zmacs-regions= under
2047 XEmacs), you can now select a region of entries and refile
2048 them all with a single =C-c C-w= command.
2050 Thanks to Samuel Wales for this useful proposal.
2052 *** Fine-tuning the behavior of =org-yank=
2054 The behavior of Org's yanking command has been further
2055 fine-tuned in order to avoid some of the small annoyances
2056 this command caused.
2058 - Calling =org-yank= with a prefix arg will stop any special
2059 treatment and directly pass through to the normal =yank=
2060 command. Therefore, you can now force a normal yank with
2063 - Subtrees will only be folded after a yank if doing so will
2064 now swallow any non-white characters after the yanked text.
2065 This is, I think a really important change to make the
2066 command work more sanely.
2068 *** Formulas for clocktables
2070 You can now add formulas to a clock table, either by hand, or
2071 with a =:formula= parameter. These formulas can be used to
2072 create additional columns with further analysis of the
2075 Thanks to Jurgen Defurne for triggering this addition.
2077 *** Better implementation of footnotes for HTML export
2079 The footnote export in 6.11 really was not good enough. Now
2080 it works fine. If you have customized
2081 =footnote-section-tag=, make sure that your customization is
2082 matched by =footnote-section-tag-regexp=.
2084 Thanks to Sebastian Rose for pushing this change.
2086 *** More languages for HTML export.
2088 More languages are supported during HTML export. This is
2089 only relevant for the few special words Org inserts, like
2090 "Table of Contents", or "Footnotes". Also the encoding
2091 issues with this feature seem to be solved now.
2093 Thanks to Sebastian Rose for pushing me to fix the encoding
2103 - Yanking subtree with =C-y= now adjusts the tree level
2104 - State changes can now be shown in the log mode in the agenda
2105 - Footnote in HTML export are now collected at the end of the document
2106 - HTML export now validates again as XHTML
2107 - The clock can now be resumed after exiting and re-starting Emacs
2108 - Clock-related data can be saved and resumed across Emacs sessions
2109 - Following file links can now use C-u C-u to force use of an external app
2110 - Inserting absolute files names now abbreviates links with "~"
2111 - Links to attachment files
2112 - Completed repeated tasks listed briefly in agenda
2113 - Remove buffers created during publishing are removed
2117 *** Yanking subtree with =C-y= now adjusts the tree level
2118 When yanking a cut/copied subtree or a series of trees, the
2119 normal yank key =C-y= now adjusts the level of the tree to
2120 make it fit into the current outline position, without losing
2121 its identity, and without swallowing other subtrees.
2123 This uses the command =org-past-subtree=. An additional
2124 change in that command has been implemented: Normally, this
2125 command picks the right outline level from the surrounding
2126 *visible* headlines, and uses the smaller one. So if the
2127 cursor is between a level 4 and a level 3 headline, the tree
2128 will be pasted as level 3. If the cursor is actually *at*
2129 the beginning of a headline, the level of that headline will
2130 be used. For example, lets say you have a tree like this:
2136 ,(2)* Level one again
2139 with (1) and (2) indicating possible cursor positions for the
2140 insertion. When at (1), the tree will be pasted as level 2.
2141 When at (2), it will be pasted as level 1.
2143 If you do not want =C-y= to behave like this, configure the
2144 variable =org-yank-adjusted-subtrees=.
2146 Thanks to Samuel Wales for this idea and a partial implementation.
2148 *** State changes can now be shown in the log mode in the agenda
2150 If you configure the variable =org-agenda-log-mode-items=,
2151 you can now request that all logged state changes be included
2152 in the agenda when log mode is active. If you find this too
2153 much for normal applications, you can also temporarily
2154 request the inclusion of state changes by pressing =C-u l= in
2157 This was a request by Hsiu-Khuern Tang.
2159 You can also press `C-u C-u l' to get *only* log items in the
2160 agenda, withour any timestamps/deadlines etc.
2162 *** Footnote in HTML export are now collected at the end of the document
2163 Previously, footnotes would be left in the document where
2164 they are defined, now they are all collected and put into a
2165 special =<div>= at the end of the document.
2167 Thanks to Sebastian Rose for this request.
2169 *** HTML export now validates again as XHTML.
2171 Thanks to Sebastian Rose for pushing this cleanup.
2173 *** The clock can now be resumed after exiting and re-starting Emacs
2175 If the option =org-clock-in-resume= is t, and the first clock
2176 line in an entry is unclosed, clocking into that task resumes
2177 the clock from that time.
2179 Thanks to James TD Smith for a patch to this effect.
2181 *** Clock-related data can be saved and resumed across Emacs sessions
2183 The data saved include the contents of =org-clock-history=,
2184 and the running clock, if there is one.
2186 To use this, you will need to add to your .emacs
2188 #+begin_src emacs-lisp
2189 (setq org-clock-persist t)
2190 (setq org-clock-in-resume t)
2191 (org-clock-persistence-insinuate)
2194 Thanks to James TD Smith for a patch to this effect.
2196 *** Following file links can now use C-u C-u to force use of an external app.
2198 So far you could only bypass your setup in `org-file-apps'
2199 and force opening a file link in Emacs by using a =C-u= prefix arg
2200 with =C-c C-o=. Now you can call =C-u C-u C-c C-o= to force
2201 an external application. Which external application depends
2202 on your system. On Mac OS X and Windows, =open= is used. On
2203 a GNU/Linux system, the mailcap settings are used.
2205 This was a proposal by Samuel Wales.
2207 *** Inserting absolute files names now abbreviates links with "~".
2209 Inserting file links with =C-u C-c C-l= was buggy if the
2210 setting of `org-link-file-path-type' was `adaptive' (the
2211 default). Absolute file paths were not abbreviated relative
2212 to the users home directory. This bug has been fixed.
2214 Thanks to Matt Lundin for the report.
2216 *** Links to attachment files
2218 Even though one of the purposes of entry attachments was to
2219 reduce the number of links in an entry, one might still want
2220 to have the occasional link to one of those files. You can
2221 now use link abbreviations to set up a special link type that
2222 points to attachments in the current entry. Note that such
2223 links will only work from within the same entry that has the
2224 attachment, because the directory path is entry specific.
2225 Here is the setup you need:
2227 #+begin_src emacs-lisp
2228 (setq org-link-abbrev-alist '(("att" . org-attach-expand-link)))
2231 After this, a link like this will work
2234 [[att:some-attached-file.txt]]
2236 This was a proposal by Lindsay Todd.
2238 *** Completed repeated tasks listed briefly in agenda
2240 When a repeating task, listed in the daily/weekly agenda under
2241 today's date, is completed from the agenda, it is listed as
2242 DONE in the agenda until the next update happens. After the
2243 next update, the task will have disappeared, of course,
2244 because the new date is no longer today.
2246 *** Remove buffers created during publishing are removed
2248 Buffers that are created during publishing are now deleted
2249 when the publishing is over. At least I hope it works like this.
2258 - Secondary agenda filtering is becoming a killer feature
2259 - Setting tags has now its own binding, =C-c C-q=
2260 - Todo state changes can trigger tag changes
2261 - C-RET will now always insert a new headline, never an item.
2262 - Customize org-mouse.el feature set to free up mouse events
2263 - New commands for export all the way to PDF (through LaTeX)
2264 - Some bug fixed for LaTeX export, more bugs remain.
2268 *** Enhancements to secondary agenda filtering
2270 This is, I believe, becoming a killer feature. It allows you
2271 to define fewer and more general custom agenda commands, and
2272 then to do the final narrowing to specific tasks you are
2273 looking for very quickly, much faster than calling a new
2276 If you have not tries this yet, you should!
2278 **** You can now refining the current filter by an additional criterion
2279 When filtering an existing agenda view with =/=, you can
2280 now narrow down the existing selection by an additional
2281 condition. Do do this, use =\= instead of =/= to add the
2282 additional criterion. You can also press =+= or =-= after
2283 =/= to add a positive or negative condition. A condition
2284 can be a TAG, or an effort estimate limit, see below.
2286 **** It is now possible to filter for effort estimates
2287 This means to filter the agenda for the value of the Effort
2288 property. For this you should best set up global allowed
2289 values for effort estimates, with
2291 #+begin_src emacs-lisp
2292 (setq org-global-properties
2293 '(("Effort_ALL" . "0 0:10 0:30 1:00 2:00 3:00 4:00")))
2296 You may then select effort limits with single keys in the
2297 filter. It works like this: After =/= or =\=, first select
2298 the operator which you want to use to compare effort
2301 : < Select entries with effort smaller than or equal to the limit
2302 : > Select entries with effort larger than or equal to the limit
2303 : = Select entries with effort equal to the limit
2305 After that, you can press a single digit number which is
2306 used as an index to the allowed effort estimates.
2308 If you do not use digits to fast-select tags, you can even
2309 skip the operator, which will then default to
2310 `org-agenda-filter-effort-default-operator', which is by
2313 Thanks to Manish for the great idea to include fast effort
2314 filtering into the agenda filtering process.
2316 **** The mode line will show the active filter
2317 For example, if there is a filter in place that does select
2318 for HOME tags, against EMAIL tags, and for tasks with an
2319 estimated effort smaller than 30 minutes, the mode-line with
2320 show =+HOME-EMAIL+<0:30=
2322 **** The filter now persists when the agenda view is refreshed
2323 All normal refresh commands, including those that move the
2324 weekly agenda from one week to the next, now keep the
2325 current filter in place.
2327 You need to press =/ /= to turn off the filter. However,
2328 when you run a new agenda command, for example going from
2329 the weekly agenda to the TODO list, the filter will be
2332 *** Setting tags has now its own binding, =C-c C-q=
2334 You can still use =C-c C-c= on a headline, but the new
2335 binding should be considered as the main binding for this
2336 command. The reasons for this change are:
2338 - Using =C-c C-c= for tags is really out of line with other
2341 - I hate it in Remember buffers when I try to set tags and I
2342 cannot, because =C-c C-c= exits the buffer :-(
2344 - =C-c C-q= will also work when the cursor is somewhere down
2345 in the entry, it does not have to be on the headline.
2347 *** Todo state changes can trigger tag changes
2349 The new option =org-todo-state-tags-triggers= can be used to
2350 define automatic changes to tags when a TODO state changes.
2351 For example, the setting
2353 : (setq org-todo-state-tags-triggers
2354 : '((done ("Today" . nil) ("NEXT" . nil))
2355 : ("WAITING" ("Today" . t))))
2357 will make sure that any change to any of the DONE states will
2358 remove tags "Today" and "NEXT", while switching to the
2359 "WAITING" state will trigger the tag "Today" to be added.
2361 I use this mostly to get rid of TODAY and NEXT tags which I
2362 apply to select an entry for execution in the near future,
2363 which I often prefer to specific time scheduling.
2365 *** C-RET will now always insert a new headline, never an item.
2366 The new headline is inserted after the current subtree.
2368 Thanks to Peter Jones for patches to fine-tune this behavior.
2370 *** Customize org-mouse.el feature set
2371 There is a new variable =org-mouse-features= which gives you
2372 some control about what features of org-mouse you want to
2373 use. Turning off some of the feature will free up the
2374 corresponding mouse events, or will avoid activating special
2375 regions for mouse clicks. By default I have urned off the
2376 feature to use drag mouse events to move or promote/demote
2377 entries. You can of course turn them back on if you wish.
2379 This variable may still change in the future, allowing more
2380 fine-grained control.
2382 *** New commands for export to PDF
2384 This is using LaTeX export, and then processes it to PDF
2387 : C-c C-e p process to PDF.
2388 : C-c C-e d process to PDF, and open the file.
2391 - \usepackage{graphicx} is now part of the standard class
2393 - Several bugs fixed, but definitely not all of them :-(
2395 *** New option `org-log-state-notes-insert-after-drawers'
2397 Set this to =t= if you want state change notes to be inserted
2398 after any initial drawers, i.e drawers the immediately follow
2399 the headline and the planning line (the one with
2400 DEADLINE/SCHEDULED/CLOSED information).
2407 *** =org-file-apps= now uses regular expressions, see [[*%20org%20file%20apps%20now%20uses%20regular%20repressions%20instead%20of%20extensions][below]]
2411 *** =org-file-apps= now uses regular repressions instead of extensions
2412 Just like in =auto-mode-alist=, car's in the variable
2413 =org-file-apps= that are strings are now interpreted as
2414 regular expressions that are matched against a file name. So
2415 instead of "txt", you should now write "\\.txt\\'" to make
2416 sure the matching is done correctly (even though "txt" will
2417 be recognized and still be interpreted as an extension).
2419 There is now a shortcut to get many file types visited by
2420 Emacs. If org-file-apps contains `(auto-mode . emacs)', then
2421 any files that are matched by `auto-mode-alist' will be
2424 *** Changes to the attachment system
2426 - The default method to attach a file is now to copy it
2427 instead of moving it.
2428 - You can modify the default method using the variable
2429 `org-attach-method'. I believe that most Unix people want
2430 to set it to `ln' to create hard links.
2431 - The keys =c=, =m=, and =l= specifically select =copy=,
2432 =move=, or =link=, respectively, as the attachment method
2433 for a file, overruling `org-attach-method'.
2434 - To create a new attachment as an Emacs buffer, you have not
2435 now use =n= instead of =c=.
2436 - The file list is now always retrieved from the directory
2437 itself, not from the "Attachments" property. We still
2438 keep this property by default, but you can turn it off, by
2439 customizing the variable =org-attach-file-list-property=.
2446 ** Incompatible changes
2448 - Changes in the structure of IDs, see [[*The%20default%20structure%20of%20IDs%20has%20changed][here]] for details.
2450 - C-c C-a has been redefined, see [[*%20C%20c%20C%20a%20no%20longer%20calls%20show%20all][here]] for details.
2454 *** The default structure of IDs has changed
2456 IDs created by Org have changed a bit:
2457 - By default, there is no prefix on the ID. There used to be
2458 an "Org" prefix, but I now think this is not necessary.
2459 - IDs use only lower-case letters, no upper-case letters
2460 anymore. The reason for this is that IDs are now also used
2461 as directory names for org-attach, and some systems do not
2462 distinguish upper and lower case in the file system.
2463 - The ID string derived from the current time is now
2464 /reversed/ to become an ID. This assures that the first
2465 two letters of the ID change fast, so hat it makes sense to
2466 split them off to create subdirectories to balance load.
2467 - You can now set the `org-id-method' to `uuidgen' on systems
2470 *** =C-c C-a= no longer calls `show-all'
2472 The reason for this is that =C-c C-a= is now used for the
2473 attachment system. On the rare occasions that this command
2474 is needed, use =M-x show-all=, or =C-u C-u C-u TAB=.
2476 *** New attachment system
2478 You can now attach files to each node in the outline tree.
2479 This works by creating special directories based on the ID of
2480 an entry, and storing files in these directories. Org can
2481 keep track of changes to the attachments by automatically
2482 committing changes to git. See the manual for more
2485 Thanks to John Wiegley who contributed this fantastic new
2486 concept and wrote org-attach.el to implement it.
2488 *** New remember template escapes
2490 : %^{prop}p to insert a property
2491 : %k the heading of the item currently being clocked
2492 : %K a link to the heading of the item currently being clocked
2494 Also, when you exit remember with =C-2 C-c C-c=, the item
2495 will be filed as a child of the item currently being
2496 clocked. So the idea is, if you are working on something and
2497 think of a new task related to this or a new note to be
2498 added, you can use this to quickly add information to that
2501 Thanks to James TD Smith for a patch to this effect.
2503 *** Clicking with mouse-2 on clock info in mode-line visits the clock.
2505 Thanks to James TD Smith for a patch to this effect.
2507 *** New file in contrib: lisp/org-checklist.el
2509 This module deals with repeated tasks that have checkbox
2512 Thanks to James TD Smith for this contribution.
2514 *** New in-buffer setting #+STYLE
2516 It can be used to locally set the variable
2517 `org-export-html-style-extra'. Several such lines are
2518 allowed-, they will all be concatenated. For an example on
2519 how to use it, see the [[http://orgmode.org/worg/org-tutorials/org-publish-html-tutorial.php][publishing tutorial]].
2528 - Filtering existing agenda views with respect to a tag
2529 - Editing fixed-width regions with picture or artist mode
2530 - /org-plot.el/ is now part of Org
2531 - Tags can be used to select the export part of a document
2532 - Prefix interpretation when storing remember notes
2533 - Yanking inserts folded subtrees
2534 - Column view capture tables can have formulas, plotting info
2535 - In column view, date stamps can be changed with S-cursor keys
2536 - The note buffer for clocking out now mentions the task
2537 - Sorting entries alphabetically ignores TODO keyword and priority
2538 - Agenda views can sort entries by TODO state
2539 - New face =org-scheduled= for entries scheduled in the future.
2540 - Remember templates for gnus links can use the :to escape.
2541 - The file specification in a remember template may be a function
2542 - Categories in iCalendar export include local tags
2543 - It is possible to define filters for column view
2544 - Disabling integer increment during table Field copy
2545 - Capturing column view is on `C-c C-x i'
2546 - And tons of bugs fixed.
2549 ** Incompatible changes
2551 *** Prefix interpretation when storing remember notes has changed
2553 The prefix argument to the `C-c C-c' command that finishes a
2554 remember process is now interpreted differently:
2556 : C-c C-c Store the note to predefined file and headline
2557 : C-u C-c C-c Like C-c C-c, but immediately visit the note
2558 : in its new location.
2559 : C-1 C-c C-c Select the storage location interactively
2560 : C-0 C-c C-c Re-use the last used location
2562 This was requested by John Wiegley.
2564 *** Capturing column view is now on `C-c C-x i'
2566 The reason for this change was that `C-c C-x r' is also used
2567 as a tty key replacement.
2569 *** Categories in iCalendar export now include local tags
2571 The locally defined tags are now listed as categories when
2572 exporting to iCalendar format. Org's traditional file/tree
2573 category is now the last category in this list. Configure
2574 the variable =org-icalendar-categories= to modify or revert
2577 This was a request by Charles Philip Chan.
2581 *** Secondary filtering of agenda views.
2583 You can now easily and interactively filter an existing
2584 agenda view with respect to a tag. This command is executed
2585 with the =/= key in the agenda. You will be prompted for a
2586 tag selection key, and all entries that do not contain or
2587 inherit the corresponding tag will be hidden. With a prefix
2588 argument, the opposite filter is applied: entries that
2589 do have the tag will be hidden.
2591 This operation only /hides/ lines in the agenda buffer, it
2592 does not remove them. Changing the secondary filtering does
2593 not require a new search and is very fast.
2595 If you press TAB at the tag selection prompt, you will be
2596 switched to a completion interface to select a tag. This is
2597 useful when you want to select a tag that does not have a
2598 direct access character.
2600 A double =/ /= will restore the original agenda view by
2601 unhiding any hidden lines.
2603 This functionality was John Wiegley's idea. It is a simpler
2604 implementation of some of the query-editing features proposed
2605 and implemented some time ago by Christopher League (see the
2606 file contrib/lisp/org-interactive-query.el).
2608 *** Editing fixed-width regions with picture or artist mode
2610 The command @<code>C-c '@</code> (that is =C-c= followed by a
2611 single quote) can now also be used to switch to a special
2612 editing mode for fixed-width sections. The default mode is
2613 =artist-mode= which allows you to create ASCII drawings.
2615 It works like this: Enter the editing mode with
2616 @<code>C-c '@</code>. An indirect buffer will be created and
2617 narrowed to the fixed-width region. Edit the drawing, and
2618 press @<code>C-c '@</code> again to exit.
2620 Lines in a fixed-width region should be preceded by a colon
2621 followed by at least one space. These will be removed during
2622 editing, and then added back when you exit the editing mode.
2624 Using the command in an empty line will create a new
2627 This new feature arose from a discussion involving Scott
2628 Otterson, Sebastian Rose and Will Henney.
2630 *** /org-plot.el/ is now part of Org.
2632 You can run it by simple calling org-plot/gnuplot.
2633 Documentation is not yet included with Org, please refer to
2634 http://github.com/eschulte/org-plot/tree/master until we have
2635 moved the docs into Org or Worg.
2637 Thanks to Eric Schulte for this great contribution.
2639 *** Tags can be used to select the export part of a document
2641 You may now use tags to select parts of a document for
2642 inclusion into the export, and to exclude other parts. This
2643 behavior is governed by two new variables:
2644 =org-export-select-tags= and =org-export-exclude-tags=.
2645 These default to =("export")= and =("noexport")=, but can be
2646 changed, even to include a list of several tags.
2648 Org first checks if any of the /select/ tags is present in
2649 the buffer. If yes, all trees that do not carry one of these
2650 tags will be excluded. If a selected tree is a subtree, the
2651 heading hierarchy above it will also be selected for export,
2652 but not the text below those headings. If none of the select
2653 tags is found anywhere in the buffer, the whole buffer will
2654 be selected for export. Finally, all subtrees that are
2655 marked by any of the /exclude/ tags will be removed from the
2658 You may set these tags with in-buffer options
2659 =EXPORT_SELECT_TAGS= and =EXPORT_EXCLUDE_TAGS=.
2661 I love this feature. Thanks to Richard G Riley for coming
2664 *** Prefix interpretation when storing remember notes
2666 The prefix argument to the `C-c C-c' command that finishes a
2667 remember process is now interpreted differently:
2669 : C-c C-c Store the note to predefined file and headline
2670 : C-u C-c C-c Like C-c C-c, but immediately visit the note
2671 : in its new location.
2672 : C-1 C-c C-c Select the storage location interactively
2673 : C-0 C-c C-c Re-use the last used location
2675 This was requested by John Wiegley.
2677 *** Yanking inserts folded subtrees
2679 If the kill is a subtree or a sequence of subtrees, yanking
2680 them with =C-y= will leave all the subtrees in a folded
2681 state. This basically means, that kill and yank are now
2682 much more useful in moving stuff around in your outline. If
2683 you do not like this, customize the variable
2684 =org-yank-folded-subtrees=.
2686 Right now, I am only binding =C-y= to this new function,
2687 should I modify all bindings of yank? Do we need to amend
2690 This feature was requested by John Wiegley.
2692 *** Column view capture tables can have formulas, plotting info
2694 If you attach formulas and plotting instructions to a table
2695 capturing column view, these extra lines will now survive an
2696 update of the column view capture, and any formulas will be
2697 re-applied to the captured table. This works by keeping any
2698 continuous block of comments before and after the actual
2701 *** In column view, date stamps can be changed with S-cursor keys
2703 If a property value is a time stamp, S-left and S-right can
2704 now be used to shift this date around while in column view.
2706 This was a request by Chris Randle.
2708 *** The note buffer for clocking out now mentions the task
2710 This was a request by Peter Frings.
2712 *** Sorting entries alphabetically ignores TODO keyword and priority
2714 Numerical and alphanumerical sorting now skips any TODO
2715 keyword or priority cookie when constructing the comparison
2716 string. This was a request by Wanrong Lin.
2718 *** Agenda views can sort entries by TODO state
2720 You can now define a sorting strategy for agenda entries that
2721 does look at the TODO state of the entries. Sorting by TODO
2722 entry does first separate the non-done from the done states.
2723 Within each class, the entries are sorted not alphabetically,
2724 but in definition order. So if you have a sequence of TODO
2725 entries defined, the entries will be sorted according to the
2726 position of the keyword in this sequence.
2728 This follows an idea and sample implementation by Christian
2731 *** New face =org-scheduled= for entries scheduled in the future.
2733 This was a request by Richard G Riley.
2735 *** Remember templates for gnus links can now use the :to escape.
2737 Thanks to Tommy Lindgren for a patch to this effect.
2738 *** The file specification in a remember template may now be a function
2740 Thanks to Gregory Sullivan for a patch to this effect.
2742 *** Categories in iCalendar export now include local tags
2744 The locally defined tags are now listed as categories when
2745 exporting to iCalendar format. Org's traditional file/tree
2746 category is now the last category in this list. Configure
2747 the variable =org-icalendar-categories= to modify or revert
2750 This was a request by Charles Philip Chan.
2752 *** It is now possible to define filters for column view
2754 The filter can modify the value that will be displayed in a
2755 column, for example it can cut out a part of a time stamp.
2756 For more information, look at the variable
2757 =org-columns-modify-value-for-display-function=.
2759 *** Disabling integer increment during table field copy
2761 Prefix arg 0 to S-RET does the trick.
2763 This was a request by Chris Randle.
2768 For older Changes, see [[file:Changes_old.org]]