summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBastien Guerry <bzg@altern.org>2012-04-26 18:48:56 +0200
committerBastien Guerry <bzg@altern.org>2012-04-26 18:48:56 +0200
commita1a5c15e7e278e1806d98c27d74f94f2a475b132 (patch)
treeddd26df66db0f8df6444a46cf6aca3292eaf867a
parent580add2f4148fea949a4db5550577911ee6d756e (diff)
downloadorg-mode-a1a5c15e7e278e1806d98c27d74f94f2a475b132.tar.gz
etc/ORG-NEWS: Major rewriting.
-rw-r--r--etc/ORG-NEWS3717
1 files changed, 715 insertions, 3002 deletions
diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS
index bf617b0..56ecda8 100644
--- a/etc/ORG-NEWS
+++ b/etc/ORG-NEWS
@@ -1,830 +1,311 @@
-ORG NEWS -*- org -*-
-
-* Version 7.8
-
-** Summary
-
-- Jambunathan's ODT exporter is now part of Org's core.
-- Nicolas' new export engine is now part of =contrib/=
-- Standard code block keywords
-- 10 new committers
-- Many bugfixes
-
-See below for details.
-
-** New committers who signed the FSF copyright assigment
-
-Here is the list of new contributors who signed the FSF papers
-since Org 7.7 - welcome, and thanks for your contributions!
-
-- Andreas Leha
-- Christian Moe
-- Julian Gehring
-- Max Mikhanosha
-- Michael Brand
-- Niels Giessen
-- Pieter Praet
-- Sergey Litvinov
-- Thomas Holst
-- Thorsten Jolitz
-
-** The ODT exporter is now part of Org's core
-
-- Full refresh of the OpenDocument Text section in the
- manual. All new features listed below are fully-documented.
-- Associate custom styles on per-file basis using
- =#+ODT_STYLES_FILE:= directive.
-- Fontify code listings using an enhanced version of
- =htmlfontify.el= and generate line numbers natively.
-- Embed MathML and OpenDocument formula files.
-- Use LaTeX to MathML converter -- say MathToWeb
- (http://www.mathtoweb.com/) -- for handling LaTeX Math
- fragments.
-- In tables, use column width cookies to control relative width
- of columns.
-- Also for tables, you can specify custom styles using
- =#+ATTR_ODT:= lines.
-- Lots of bug fixes.
-
-*Experimental*
-
-The following features are /experimental/. These features are
-specific to the ODT export engine and their implementation and
-usage could change considerably in future versions.
-
-- Support for list tables -- see this [[http://lists.gnu.org/archive/html/emacs-orgmode/2011-09/msg00017.html][message on the list]].
-- Support for annotation blocks -- see this [[http://lists.gnu.org/archive/html/emacs-orgmode/2011-10/msg01251.html][message on the list]].
-
-Special thanks to Jambunathan for his work and his patience
-through the process of integrating this vital contribution into
-Org's core.
-
-** New export engine by Nicolas
-
-See the comment sections in org-element.el and in org-export.el
-(in =contrib/lisp/=). Also check the experimental LaTeX exporter
-using in =EXPERIMENTAL/org-e-latex.el=.
-
-Check Nicolas' announcement [[http://comments.gmane.org/gmane.emacs.orgmode/49416][on the list]] and hack around!
-
-Thanks a lot to Nicolas for this great and promising achievement.
-
-** Incompatible changes
-
-*** Standardized code block keywords
-
-Following a round of on-list discussion, many code block synonyms
-have been removed. You can safely move forward the following
-syntax:
-
-- call lines are specified with #+call:
-- code blocks are named with #+name:
-- results are named with #+name:, however results generated by a
- code block may still be labeled with #+results:, and tables
- named with #+tblname: will be considered to be named results
-
-The following function may be used to update an existing Org-mode
-buffer to the new syntax:
-
-#+begin_src emacs-lisp
- (defun update-org-buffer ()
- "Update an Org-mode buffer to the new data, code block and call line syntax."
- (interactive)
- (save-excursion
- (flet ((to-re (lst) (concat "^[ \t]*#\\+" (regexp-opt lst t)
- "\\(\\[\\([[:alnum:]]+\\)\\]\\)?\\:[ \t]*"))
- (update (re new)
- (goto-char (point-min))
- (while (re-search-forward re nil t)
- (replace-match new nil nil nil 1))))
- (let ((old-re (to-re '("RESULTS" "DATA" "SRCNAME" "SOURCE")))
- (lob-re (to-re '("LOB")))
- (case-fold-search t))
- (update old-re "name")
- (update lob-re "call")))))
-#+end_src
-
-*Note*: If an old version of Org-mode (e.g., the one shipped with
-Emacs) is installed on your system, many of the important
-variables will be pre-defined with a =defvar= and *will not* have
-their values automatically updated -- these include the
-following:
-
-- =org-babel-data-names=
-- =org-babel-result-regexp=
-- =org-babel-src-block-regexp=
-- =org-babel-src-name-regexp=
-- =org-babel-src-name-w-name-regexp=
-
-It may be necessary to either remove the source code of older
-versions of Org-mode or to explicitly evaluate the ob.el file.
-
-*** Removed the =#+BABEL:= keyword
-
-Code block header arguments may now be specified using the
-standard =#+Property:= keyword. See [[#accumulating-property-keywords][Property names ending in =+=
-accumulate]] for more information on the extended property syntax.
-
-*** Deleted =org-mode-p=
-
-This function has been deleted: please update your hacks if you
-relied on it.
-
-** New features and user-visible improvements
-
-*** Day names are optional when you type timestamps manually
-
-You can type "<2011-12-12>" or [2011-12-12] and modify this timestamps with
-S-<right> like other timestamps. Thanks to Carsten for implementing this.
-
-*** Improved filtering through =org-agenda-to-appt=
-
-The new function allows the user to refine the scope of entries
-to pass to =org-agenda-get-day-entries= and allows to filter out
-entries using a function.
-
-Thanks to Peter Münster for raising a related issue and to
-Tassilo Horn for this idea. Also thanks to Peter Münster for
-[[git:68ffb7a7][fixing a small bug]] in the final implementation.
-
-*** =org-agenda-date-later= jumps to today when modifying past date
-
-The command =org-agenda-date-later= (<S-right> in the Agenda
-Mode) directly jumps to today. Thanks to Carsten for
-implementing this.
-
-*** Use prefix arg 0 to inhibit note taking for TODO change
-
-See Carsten's comment: "Sometimes I want to quickly make a few TODOs done
-in the agenda and I want to bypass the note taking I have normally set
-up. With this change, I can press `0 t d' in the agenda to do this."
-
-Thanks to Carsten for implementing this.
-
-*** Various improvements to =org-indent.el=
-
-Nicolas Goaziou worked on refactoring and improving
-=org-indent.el=, which should now be faster. It also better
-combines with =visual-line-mode=.
-
-*** Property names ending in =+= accumulate
-
-This results in the following behavior.
-
-#+begin_src org
- ,#+property: var foo=1
- ,#+property: var+ bar=2
-
- ,#+begin_src emacs-lisp
- , (+ foo bar)
- ,#+end_src
-
- ,#+results:
- ,: 3
-
- ,#+begin_src emacs-lisp
- , (org-entry-get (point) "var" t)
- ,#+end_src
-
- ,#+results:
- ,: foo=1 bar=2
-
- ,* overwriting a file-wide property
- , :PROPERTIES:
- , :var: foo=7
- , :END:
-
- ,#+begin_src emacs-lisp
- , foo
- ,#+end_src
-
- ,#+results:
- ,: 7
-
- ,#+begin_src emacs-lisp
- , (org-entry-get (point) "var" t)
- ,#+end_src
-
- ,#+results:
- ,: foo=7
-
- ,* appending to a file-wide property
- , :PROPERTIES:
- , :var+: baz=3
- , :END:
-
- ,#+begin_src emacs-lisp
- , (+ foo bar baz)
- ,#+end_src
-
- ,#+results:
- ,: 6
-
- ,#+begin_src emacs-lisp
- , (org-entry-get (point) "var" t)
- ,#+end_src
-
- ,#+results:
- ,: foo=1 bar=2 baz=3
-#+end_src
-
-*** =org-agenda-custom-commands= has a default value
-
-This option used to be `nil' by default. This now has a default
-value, displaying an agenda and all TODOs. See the docstring for
-details. Thanks to Carsten for this.
-
-*** =outline-demote/promote= points to =org-demote/promote-subtree=
-
-Users who use this outline commands in =outline-mode= will want
-them to behave the Org way in Org. Thanks to Michael Brand for
-the suggestion.
-
-*** New escape characters for =org-log-note-headings=
-
-The option =org-log-note-headings= now supports %d and %D for
-inactive and active timestamps. This affect the behavior of the
-command =org-store-log-note=. Thanks to John J Foerch for a
-patch for this.
-
-*** New command =org-table-transpose-table-at-point=
-
-See the docstring. This hack from Juan Pechiar is now part of
-Org's core. Thanks to Juan!
-
-*** Allow recursive edit of minibuffer
-
-You can now use the command =C-c != (=org-time-stamp-inactive=)
-when prompted e.g. for a link name. This is because the central
-function =org-completing-read= now support recursive edit. Only
-=C-c != is available at the moment, but if you can think of a
-useful command to use, please let me know.
-
-Thanks to Skip Collins for the idea and to Nick Dokos for the
-implementation.
-
-*** Allow dynamic construction of the publishing destination
-
-Thanks to Kai Tetzlaff for adding this.
-
-*** Set the capture default time to the prompt time
-
-In the file+datetree+promt target type, the user is being asked
-for a date, where to file an entry. In the template, he can use
-the escape placeholders for active and inactive time stamps. So
-far, these were filled with todays date. This behavior changed
-so that, also at %t and %u, the date to use is the one entered at
-the prompt.
-
-Reported by Erik Hetzner and fixed by Carsten.
-
-*** =org-agenda-skip-additional-timestamps-same-entry= defaults to `nil'
-*** org-sudoku.el -- small sudoku solver
-
-Carsten wrote org-sudoku.el, a little sudoku solver, which lives
-in the contrib/ directory.
-
-From [[http://permalink.gmane.org/gmane.emacs.orgmode/45474][his message]]: "my daughter got stuck with a couple of SUDOKU
-puzzles during the vacation (where wh had no internet
-connection), so I hacked a small SUDOKU solver that reads a 9x9
-Org table and solves it as a sudoku puzzle. A little silly, but
-maybe fun for someone - I have pushed it into the contrib/lisp
-directory."
-** Code Block related features and improvements
-*** Added [[http://cran.r-project.org/web/packages/tikzDevice/index.html][tikzDevice]] support to ob-R.el
-*** Support for Pico Lisp code blocks
-
-Thanks to Thorsten Jolitz Pico Lisp code blocks are now
-supported. See =ob-picolisp.el= for more information.
-
-*** Extension to the =eval= code block header argument
-
-The =eval= code block header argument now accepts four (six)
-possible values the meaning of which is shown in the table below.
-
-| never or no | The code block will not be evaluated under any |
-| | circumstances. |
-| query | Evaluation of the code block will require a query. |
-| never-export or no-export | The code block will not be evaluated during export |
-| | but may still be called |
-| query-export | Evaluation of the code block during export will |
-| | require a query. |
-
-*** Update of intermediate results during code block evaluation
-
-When set to t, the new =org-babel-update-intermediate= variable
-will update in-buffer results for code blocks which are evaluated
-in the resolution of a variable reference. This can be used to
-ensure that the latest returned results are always shown in
-buffer.
-
-*** Support for Fortran code block is now in the core
-
-Thanks to Sergey Litvinov for contributing this support.
-
-*** The =sbe= function allows header argument specification
-
-If first variable is a string and not a cons cell, then interpret
-it as a string of header arguments to be passed to the code
-block.
-
-*** Support for Shen code blocks
-
-See http://www.shenlanguage.org/ for information on Shen.
-
-A major mode for shen code blocks is available through the GNU
-ELPA.
-
-** New options and faces
-
-*** New option =org-export-html-headline-anchor-format=
-
-Format for anchors in HTML headlines.
-
-It requires to %s: both will be replaced by the anchor referring
-to the headline (e.g. "sec-2"). When set to `nil', don't insert
-HTML anchors in headlines.
-
-This was requested by Alan L Tyree.
-
-*** New option =org-table-formula-field-format=
-
-Format for fields which contain the result of a formula.
-For example, using \"~%s~\" will display the result within tilde
-characters. Beware that modifying the display can prevent the
-field from being used in another formula.
-
-Thanks to Dov Grobgeld for this idea.
-
-*** New option =org-loop-over-headlines-in-active-region=
-
-When set to `t', some commands will loop over the active
-region. Currently, =org-schedule= and =org-deadline= uses this
-option: pressing =C-c C-s= or =C-c C-d= when the region is active
-will let you schedule/deadline all the visible headlines in the
-region.
-
-Thanks a lot to David Maus for implementing this.
-
-*** New option =org-catch-invisible-edits=
-
-This option makes it possible to check what is the right thing to do before
-editing invisible regions. Here are the possible values of this option:
-
-: +nil Do not check, so just do invisible edits.
-: +error Throw an error and do nothing.
-: +show Make point visible, and do the requested edit.
-: +show-and-error Make point visible, then throw an error and abort the edit.
-: +smart Make point visible, and do insertion/deletion if it is
-: adjacent to visible text and the change feels predictable.
-
-See the docstring for more details.
-
-Thanks to Carsten for implementing this.
-
-*** New option =org-export-latex-table-caption-above=
-
-Let the user place a caption above its table in LaTeX.
-Thanks to Thomas Dye for a patch to this effect.
-
-*** New option =org-agenda-follow-indirect=
-
-By setting `org-agenda-follow-indirect' to a non-nil value,
-`org-agenda-follow-mode' will use an indirect buffer to display
-only the current item, rather than the whole agenda file in which
-it lives.
-
-Thanks to Dave Abrahams for implementing this.
-
-*** New option =org-refile-active-region-within-subtree=
-
-Non-nil means also refile active region within a subtree.
-
-By default =org-refile= doesn't allow refiling regions if they
-don't contain a set of subtrees, but it might be convenient to do
-so sometimes: in that case, the first line of the region is
-converted to a headline before refiling.
-
-Thanks to Jeff Horn for raising the issue of refiling a list
-item, and to Nicolas Goaziou, Nick Dokos and Suvayu Ali for
-discussing them patiently.
-
-*** New option =org-latex-to-mathml-convert-command=
-
-This option lets you specify a way to convert LaTeX fragments to
-MathML. See also =org-latex-to-mathml-jar-file= and the
-docstring of =org-create-math-formula=.
-
-Thanks to Jambunathan K for implementing this.
-
-*** New option =org-properties-postprocess-alist=
-
-See its docstring:
-
-: Alist of properties and functions to adjust inserted values.
-: Elements of this alist must be of the form
-:
-: ([string] [function])
-:
-: where [string] must be a property name and [function] must be a
-: lambda expression: this lambda expression must take one argument,
-: the value to adjust, and return the new value as a string.
-:
-: For example, this element will allow the property "Remaining"
-: to be updated wrt the relation between the "Effort" property
-: and the clock summary:
-:
-: (("Remaining"
-: (lambda(value)
-: (let ((clocksum (org-clock-sum-current-item))
-: (effort (org-duration-string-to-minutes
-: (org-entry-get (point) "Effort"))))
-: (org-minutes-to-hh:mm-string (- effort clocksum))))))
-
-This is inspired by a request from Pascal Mattia.
-
-*** New options =org-habit-today-glyph= and =org-habit-completed-glyph=
-
-This gives you control over the character used for displaying
-today (default is `!') and days on which a task has been
-completed (default is `*'). Thanks to John Wiegley for this.
-
-*** New option =org-bibtex-type-property-name=
-
-Configurable property name for bibtex entry types. Thanks to
-Eric Schulte for this.
-
-*** New face =org-agenda-filter-tags=
-
-This face is used for highlighting the tag(s) filter in the
-modeline. Thanks to Sébastien Vauban for this idea and its
-implementation.
-
-*** New faces =org-agenda-calendar-event= and =org-agenda-calendar-sexp=
-
-=org-agenda-calendar-event= is the face used to show events and
-appointments in the agenda, and =org-agenda-calendar-sexp= the
-one used to show events computed from a S-expression.
-
-Thanks to Sébastien Vauban for this addition.
-
-** Important bugfixes
-
-*** Respect =org-export-with-tags= when exporting a subtree
-
-Thanks to Suvayu Ali for spotting this problem and fixing it.
-
-*** Fix XEmacs compatibility issue when creating an indirect buffer
-
-Thanks to Michael Sperber for this fix.
-
-** Testing
-
-*** New test function =org-test-with-temp-text-in-file=
-
-* Version 7.7
-
-** COMMENT Incompatible changes
-** New features and user-visible improvements
-
-*** New command =org-copy-visible= (=C-c C-x v=)
-
-This command will copy the visible text in the region into the
-kill ring.
-
-Thanks to Florian Beck for this function and to Carsten for
-adding it to org.el and documenting it!
-
-*** New hook =org-ctrl-c-ctrl-c-final-hook=
-
-This hook will be called when nothing special can be performed by
-the busy =C-c C-c= key. Thanks to Paul Sexton for this idea!
-
-*** Allow relative time when scheduling/adding a deadline
-
-You can now use relative duration strings like "-2d" or "++3w"
-when calling =org-schedule= or =org-deadline=: it will schedule
-(or set the deadline for) the item respectively two days before
-today and three weeks after the current timestamp, if any.
-
-You can use this programmatically: =(org-schedule nil "+2d")=
-will work on the current entry.
-
-You can also use this while (bulk-)rescheduling and
-(bulk-)resetting the deadline of (several) items from the agenda.
-
-Thanks to Memnon Anon for a heads up about this!
-
-*** New functions: =org-todo-yesterday= and =org-agenda-todo-yesterday=
-
-This is useful when you need to mark things done yesterday.
-
-Thanks to Max Mikhanosha for this patch.
-
-*** =org-set-property= defaults to the last interactively modified property
-
-When setting a property with =C-c C-x p=, it will offered the
-last interactively modified property as a default choice. If
-this command is called on a property line, the property in this
-line will take precedence over the last set property.
-
-*** Clock: Allow synchronous update of timestamps in CLOCK log
-
-Using =S-M-<up/down>= on CLOCK log timestamps will
-increase/decrease the two timestamps on this line so that
-duration will keep the same. Note that duration can still be
-slightly modified in case a timestamp needs some rounding.
-
-Thanks to Rainer Stengele for this idea.
-
-*** Clock: New function =org-clock-remove-empty-clock-drawer=
-
-This function removes empty =CLOCK= drawers and has been added to
-=org-clock-out-hook=: when clocking out, if no CLOCK log has been
-inserted and the drawer is empty, the drawer will be removed.
-
-*** Capture: new escape sequence =%F= for templates
-
-Using =%F= in capture templates will insert the full path of the
-file or the directory the capture mechanism was called from
-(whereas =%f= only insert the filename.)
-
-Thanks to Nicolas Goaziou for this change.
-
-*** Agenda: new variable =org-agenda-bulk-custom-functions= for custom bulk functions
-
-When using =org-agenda-bulk-action= in agenda view, the user
-could already call custom functions by pressing =f= and entering
-the function's name.
-
-This variable lets the user add custom choices and reach them
-more quickly. Set the variable to an alist of keys (chars) and
-functions, and these keys will be accessible through the
-=org-agenda-bulk-action= interface.
-
-If there is a conflict between custom keys and hardcoded choices,
-the latter ones take precedence.
-
-Thanks to Julien Cubizolles for triggering this idea.
-
-*** Refile: exclude irrelevant headings
-
-When refiling from an org-mode buffer, the current heading and
-its subheadings will be excluded from the list of possible
-targets.
-
-This only works when =org-refile-use-cache= is =nil= and in
-org-mode buffers, not in agenda buffers.
-
-Thanks to Jason Dunsmore for this idea!
-
-*** Lists: new variable =org-list-use-circular-motion=
-
-This variable allows some commands to consider lists as cyclic
-structures. For example, when non-nil, moving past the last item
-of a list with S-down will bring you back to the first one.
-
-*** Lists: New variable =org-list-indent-offset=
-
-This variable helps improving readability of sub-items by
-increasing their indentation. E.g., if =org-list-indent-offset=
-is set to 2, you may see the following list:
-
-#+begin_example
-- First item
- - Sub-item 1
- - Sub-item 2
-- Second item
-#+end_example
-
-*** Table: New flag ";t" to tailor the display of computed durations
-
-See the new variable =org-table-duration-custom-format= and the
-updated example from the manual:
-
-| Task 1 | Task 2 | Total |
-|---------+----------+-------|
-| 3:02:20 | -2:07:00 | 0.92 |
-#+TBLFM: @2$3=$1+$2;t
-
-In this example, =0.92= is a fraction of hour, the default for
-=org-table-duration-custom-format=.
-
-Thanks to Daniel E. Doherty for discussions about this.
-
-*** Table: display field's coordinates when editing it with =C-c `=
-
-When editing a field with =C-c `=, the field's coordinate will
-the displayed in the buffer.
-
-Thanks to Michael Brand for a patch to this effect.
-
-*** Babel: support for =java= code blocks
-
-Evaluation of blocks of Java code is now possible. Currently
-only external evaluation of Java code is supported (i.e., no
-session evaluation) and only the =:results output= results are
-collected. Code blocks are compiled to a Java class file which
-are then evaluated and the values printed to STDOUT are returned.
-
-Java code blocks required a =:classname= header argument which is
-used by the compiler to name =.java= and =.class= files.
-
-Example Java code block:
-#+begin_src org
- ,#+begin_src java :classname myfirstjavaprog
- , class myfirstjavaprog
- , {
- , public static void main(String args[])
- , {
- , System.out.println("Hello World!");
- , }
- , }
- ,#+end_src
-
- ,#+results:
- ,: Hello World!
-#+end_src
-
-*** Babel: support for =fortran= code blocks by Sergey Litvinov
-
-The =contrib/babel/langs/= contains the new library
-=ob-fortran.el= by Sergey Litvinov.
-
-Thanks to him for this addition.
-
-*** Babel: support for the [[http://fomus.sourceforge.net/][fomus]] language by Torsten Anders
-
-=ob-fomus.el= has been added to =contrib/babel/langs/=.
-
-Thanks to Torsten Anders for contributing this functionality.
-
-*** Publish: hide .orgx files and use theindex.org directly
-
-When :makeindex is `non-nil' in the publishing options, Org will
-export an index. It populates the directory with .orgx files:
-those files are now hidden (.file.orgx). Also the index is
-directly stored in the file =theindex.org=, not in the file
-=theindex.inc= (which you can delete).
-
-Thanks to Nathan Neff and Carsten for pointing at the problems
-and solutions.
-
-*** Export: new variable =org-export-html-divs= to allow custom divs
-
-The default value of =org-export-html-divs= is =("preamble"
-"content" "postamble")= and is used to define the =<div "%s">=
-for the main structure of the exported HTML file.
-
-Note that modifying the default value will break compatibility
-with the =org-info.js= script.
-
-Also note that the variable =org-export-html-content-div= will
-still be checked for compatibility reasons but is not a custom
-variable anymore.
-
-Thanks to Sébastian Vauban for a preliminary version of this
-patch.
-
-*** Export: new variable =org-export-latex-quotes= to customize quotes in LaTeX export
-
-This allows users to define what quotes they want to use as a
-replacement of english double-quotes while exporting to LaTeX.
-
-In particular, if you use the csquote package, you can configure
-Org to output something like \endquote{some quoted text} instead
-of "some quoted text".
-
-Thanks to Frederik for bringing this issue up, and to Thomas S.
-Dye, Nick Dokos and Stefan Nobis for elaborating this solution.
-
-** Important bugfixes
-
-*** Duration computations now work for complex ranges in tables
-
-Thanks to Christian Moe for signaling this problem.
-
-*** Handle recursive setup files correctly
-
-Thanks to Stefan Vollmar for mentioning this problem.
-
-** Details
-
-*** =org-map-entries= can now have 'region as its scope
-
-Thanks to David Maus for suggesting related improvements to
-=org-map-entries=. This one prepares the possibility of letting
-some commands to loop over the active region.
-
-*** org-depend.el: new chain-find-next trigger option
-
-See the updated docstring of this file.
-
-Thanks a lot to Max Mikhanosha for this!
-
-*** Export: new experimental exporter to MoinMoin by Puneeth Chaganti.
-
-The =EXPERIMENTAL/= directory contains a new file org-mm.el that
-allows you to export an Org file to a MoinMoin file.
-
-Thanks to Puneeth Chaganti for this addition.
-
-*** Export: new default for =org-export-html-preamble=
-
-The default value included the title. It now defaults to the
-empty string, as the title is hardcoded and included in the
-"content" div. Including the title here is necessary to let
-=org-info.js= find it and display the page properly.
-
-*** Export: new variable =org-lparse-use-flashy-warning= defaulting to =nil=
+ORG NEWS -*- org -*-
+
+
+* Incompatible changes
+
+** Emacs 21 support has been dropped
+ :PROPERTIES:
+ :OrgVersion: 7.01
+ :END:
+
+ Do not use Org mode 7.xx with Emacs 21, use [[http://orgmode.org/org-6.36c.zip][version 6.36c]] instead.
+
+** XEmacs support requires the XEmacs development version
+ :PROPERTIES:
+ :OrgVersion: 7.01
+ :END:
+
+ To use Org mode 7.xx with XEmacs, you need to run the developer
+ version of XEmacs. We were about to drop XEmacs support entirely,
+ but Michael Sperber stepped in and made changes to XEmacs that made
+ it easier to keep the support. Thanks to Michael for this
+ last-minute save.
+
+** New keys for TODO sparse trees
+ :PROPERTIES:
+ :OrgVersion: 7.01
+ :END:
+
+ The key =C-c C-v= is now reserved for Org Babel action. TODO sparse
+ trees can still be made with =C-c / t= (all not-done states) and =C-c /
+ T= (specific states).
+
+** The Agenda =org-agenda-ndays= is now obsolete
+ :PROPERTIES:
+ :OrgVersion: 7.4
+ :END:
+
+ The variable =org-agenda-ndays= is obsolete - please use
+ =org-agenda-span= instead.
+
+ Thanks to Julien Danjou for this.
+
+** Changes to the intended use of =org-export-latex-classes=
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
+
+ So far this variable has been used to specify the complete header of the
+ LaTeX document, including all the =\usepackage= calls necessary for the
+ document. This setup makes it difficult to maintain the list of
+ packages that Org itself would like to call, for example for the special
+ symbol support it needs.
+
+ First of all, you can *opt out of this change* in the following way: You
+ can say: /I want to have full control over headers, and I will take
+ responsibility to include the packages Org needs/. If that is what you
+ want, add this to your configuration and skip the rest of this section
+ (except maybe for the description of the =[EXTRA]= place holder):
+
+ #+begin_src emacs-lisp
+ (setq org-export-latex-default-packages-alist nil
+ org-export-latex-packages-alist nil)
+ #+end_src
+
+ /Continue to read here if you want to go along with the modified setup./
+
+ There are now two variables that should be used to list the LaTeX
+ packages that need to be included in all classes. The header definition
+ in =org-export-latex-classes= should then not contain the corresponding
+ =\usepackage= calls (see below).
+
+ The two new variables are:
+
+ 1. =org-export-latex-default-packages-alist= :: This is the variable
+ where Org-mode itself puts the packages it needs. Normally you
+ should not change this variable. The only reason to change it
+ anyway is when one of these packages causes a conflict with another
+ package you want to use. Then you can remove that packages and
+ hope that you are not using Org-mode functionality that needs it.
+
+ 2. =org-export-latex-packages-alist= :: This is the variable where you
+ can put the packages that you'd like to use across all classes.
+
+ The sequence how these customizations will show up in the LaTeX
+ document are:
+
+ 1. Header from =org-export-latex-classes=
+ 2. =org-export-latex-default-packages-alist=
+ 3. =org-export-latex-packages-alist=
+ 4. Buffer-specific things set with =#+LaTeX_HEADER:=
+
+ If you want more control about which segment is placed where, or if you
+ want, for a specific class, have full control over the header and
+ exclude some of the automatic building blocks, you can put the following
+ macro-like place holders into the header:
+
+ #+begin_example
+ [DEFAULT-PACKAGES] \usepackage statements for default packages
+ [NO-DEFAULT-PACKAGES] do not include any of the default packages
+ [PACKAGES] \usepackage statements for packages
+ [NO-PACKAGES] do not include the packages
+ [EXTRA] the stuff from #+LaTeX_HEADER
+ [NO-EXTRA] do not include #+LaTeX_HEADER stuff
+ #+end_example
+
+ If you have currently customized =org-export-latex-classes=, you should
+ revise that customization and remove any package calls that are covered
+ by =org-export-latex-default-packages-alist=. This applies to the
+ following packages:
+
+ - inputenc
+ - fontenc
+ - fixltx2e
+ - graphicx
+ - longtable
+ - float
+ - wrapfig
+ - soul
+ - t1enc
+ - textcomp
+ - marvosym
+ - wasysym
+ - latexsym
+ - amssymb
+ - hyperref
+
+ If one of these packages creates a conflict with another package you are
+ using, you can remove it from =org-export-latex-default-packages-alist=.
+ But then you risk that some of the advertised export features of Org
+ will not work properly.
+
+ You can also consider moving packages that you use in all classes to
+ =org-export-latex-packages-alist=. If necessary, put the place holders
+ so that the packages get loaded in the right sequence. As said above,
+ for backward compatibility, if you omit the place holders, all the
+ variables will dump their content at the end of the header.
-Flashy and verbose warnings while exporting to ODT have been
-disabled. Set this to =t= if you want it back.
+** The constant =org-html-entities= is obsolete
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
+
+ Its content is now part of the new constant =org-entities=, which is
+ defined in the file org-entities.el. =org-html-entities= was an internal
+ variable, but it is possible that some users did write code using it.
+
+** `org-bbdb-anniversary-format-alist' has changed
+ :PROPERTIES:
+ :OrgVersion: 7.5
+ :END:
+
+ Please check the docstring and update your settings accordingly.
+
+** Deleted =org-mode-p=
+ :PROPERTIES:
+ :OrgVersion: 7.8
+ :END:
+
+ This function has been deleted: please update your code.
+
+* Important new features
+
+** New Org to ODT exporter
+ :PROPERTIES:
+ :OrgVersion: 7.8
+ :END:
+
+ Jambunathan's Org to ODT exporter is now part of Org.
+
+ To use it, it `C-c C-e o' in an Org file. See the documentation for more
+ information on how to customize it.
+
+** org-capture.el is now the default capture system
+ :PROPERTIES:
+ :OrgVersion: 7.01
+ :END:
+
+ This replaces the earlier system org-remember. The manual only describes
+ org-capture, but for people who prefer to continue to use org-remember,
+ we keep a static copy of the former manual section [[http://orgmode.org/org-remember.pdf][chapter about
+ remember]].
+
+ The new system has a technically cleaner implementation and more
+ possibilities for capturing different types of data. See [[http://thread.gmane.org/gmane.emacs.orgmode/26441/focus%3D26441][Carsten's
+ announcement]] for more details.
+
+ To switch over to the new system:
+
+ 1. Run
+
+ : M-x org-capture-import-remember-templates RET
+
+ to get a translated version of your remember templates into the
+ new variable =org-capture-templates=. This will "mostly" work,
+ but maybe not for all cases. At least it will give you a good
+ place to modify your templates. After running this command,
+ enter the customize buffer for this variable with
+
+ : M-x customize-variable RET org-capture-templates RET
-*** Export: new default value for =org-export-latex-image-default-option=
+ and convince yourself that everything is OK. Then save the
+ customization.
-This used to be =width=10em= and this is now width=.9\linewidth,
-which makes more sense.
+ 2. Bind the command =org-capture= to a key, similar to what you did
+ with org-remember:
-Thanks to Sebastien Vauban for this suggestion.
+ : (define-key global-map "\C-cc" 'org-capture)
-*** Export: allow =org-export-latex-href-format= to have only one "%s"
+ If your fingers prefer =C-c r=, you can also use this key once
+ you have decided to move over completely to the new
+ implementation. During a test time, there is nothing wrong
+ with using both system in parallel.
-This is useful when you want to use \url{link} instead of the
-default \href{link}{path}.
+* New libraries
-Thanks to Henri-Paul Indiogine for bringing this up.
+** New Org libraries
+*** org-eshell.el (Konrad Hinsen)
+ :PROPERTIES:
+ :OrgVersion: 7.8
+ :END:
-** Known issues
+ Implement links to eshell buffers.
-*** The ODT exporter will choke when using some Org-defined strings
+*** org-special-blocks (Carsten Dominik)
+ :PROPERTIES:
+ :OrgVersion: 7.8
+ :END:
-For example, using the hungarian version of the table of
-contents, as defined in =org-export-language-setup=, the ODT
-exporter will complain about a problem with the translated
-string.
+This package generalizes the #+begin_foo and #+end_foo tokens.
-The workaround is to customize =org-export-language-setup=
-and to use accents directly.
+To use, put the following in your init file:
-* Version 7.6
+#+BEGIN_EXAMPLE
+(require 'org-special-blocks)
+#+END_EXAMPLE
-** Incompatible changes
-** New features and user-visible improvements
+The tokens #+begin_center, #+begin_verse, etc. existed previously. This
+package generalizes them (at least for the LaTeX and html exporters). When
+a #+begin_foo token is encountered by the LaTeX exporter, it is expanded
+into \begin{foo}. The text inside the environment is not protected, as
+text inside environments generally is. When #+begin_foo is encountered by
+the html exporter, a div with class foo is inserted into the HTML file. It
+is up to the user to add this class to his or her stylesheet if this div is
+to mean anything.
-*** Integration of Jambunathan's OpenDocumentText Exporter
+*** org-taskjuggler.el (Christian Egli)
+ :PROPERTIES:
+ :OrgVersion: 7.01
+ :END:
-**** Activation
+ Christian Egli's /org-taskjuggler.el/ module is now part of Org. He
+ also wrote a [[http://orgmode.org/worg/org-tutorials/org-taskjuggler.php][tutorial]] for it.
-Org-mode 7.6 supports exporting to OpenDocument Text (=odt=)
-format using org-odt.el. Depending on how you installed Org,
-this module can be enabled in one of the following ways:
+*** org-ctags.el (Paul Sexton)
+ :PROPERTIES:
+ :OrgVersion: 6.34
+ :END:
-1. If you have downloaded the Org from the Web, either as a
- distribution =.zip= or =.tar.gz= file, or as a Git archive,
- enable the =odt= option in the variable =org-modules=.
+ Targets like =<<my target>>= can now be found by Emacs' etag
+ functionality, and Org-mode links can be used to to link to etags, also
+ in non-Org-mode files. For details, see the file /org-ctags.el/.
-2. If you are using Org-mode 7.6 that comes bundled with
- Emacs-24.0.50 (or future Emacs-24.1), then you can install the
- OpenDocumentText exporter using the package manager. Check
- the list of available packages with =M-x list-packages= and
- install the =org-odt= package.
+ This feature uses a new hook =org-open-link-functions= which will call
+ function to do something special with text links.
-Thanks a lot to Jambunathan K for this great contribution.
+ Thanks to Paul Sexton for this contribution.
-**** Keybindings
+*** org-docview.el (Jan Böcker)
+ :PROPERTIES:
+ :OrgVersion: 6.34
+ :END:
-The following interactive commands are provided:
+ This new module allows links to various file types using docview, where
+ Emacs displays images of document pages. Docview link types can point
+ to a specific page in a document, for example to page 131 of the
+ Org-mode manual:
-1. =C-c C-e o= (=org-export-as-odt=): Export as an =odt= file.
+ : [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]]
-2. =C-c C-e O= (=org-export-as-odt-and-open=): Export as an =odt=
- file and open the resulting file.
+ Thanks to Jan Böcker for this contribution.
-See the =contrib/odt/README.org= file for further details; you
-may check in particular the commands =M-x org-lparse= and =M-x
-org-export-convert=.
+** New Babel libraries
-*** Ob-Lilypond -- new Babel language to allow score generation
+- ob-picolisp.el (Thorsten Jolitz)
+- ob-fortran.el (Sergey Litvinov)
+- ob-shen.el (Eric Schulte)
+- ob-maxima.el (Eric S Fraga)
+- ob-java.el (Eric Schulte)
+- ob-lilypond.el (Martyn Jago)
+- ob-awk.el (Eric Schulte)
-ob-lilypond - an org-babel language, provided to allow LilyPond
-music score generation, complete with optional auditioning via
-midi, whilst leveraging the full power of org mode, and literate
-programming. See https://github.com/mjago/ob-lilypond for more
-documentation.
+* Other new features and various enhancements
-Thanks to Martyn Jago for this addition.
+** Hyperlinks
*** Org-Bibtex -- major improvements
+ :PROPERTIES:
+ :OrgVersion: 7.6
+ :END:
-Provides support for managing bibtex bibliographical references
-data in headline properties. Each headline corresponds to a
-single reference and the relevant bibliographic meta-data is
-stored in headline properties, leaving the body of the headline
-free to hold notes and comments. Org-bibtex is aware of all
-standard bibtex reference types and fields.
+ Provides support for managing bibtex bibliographical references
+ data in headline properties. Each headline corresponds to a
+ single reference and the relevant bibliographic meta-data is
+ stored in headline properties, leaving the body of the headline
+ free to hold notes and comments. Org-bibtex is aware of all
+ standard bibtex reference types and fields.
-The key new functions are
+ The key new functions are
- org-bibtex-check :: queries the user to flesh out all required
(and with prefix argument optional) bibtex fields available
@@ -839,270 +320,25 @@ The key new functions are
- org-bibtex-export-to-kill-ring :: Export the current headline
to the kill ring as a formatted bibtex entry.
-*** Spreadsheet computation of durations and time values
-
-If you want to compute time values use the =T= flag, either in
-Calc formulas or Elisp formulas:
-
-| Task 1 | Task 2 | Total |
-|--------+--------+---------|
-| 35:00 | 35:00 | 1:10:00 |
-#+TBLFM: @2$3=$1+$2;T
-
-Values must be of the form =[HH:]MM:SS=, where hours are
-optional.
-
-Thanks to Martin Halder, Eric Schulte and Carsten for code and
-feedback on this.
-
-*** Links within inlined footnotes.
-
-It as also possible to have footnotes side-by-side correctly
-exported. New variables =org-export-latex-footnote-separator=,
-=org-export-html-footnote-separator= and
-=org-export-docbook-footnote-separator= are used to separate them
-in that case.
-
-Fontification of footnotes is also more accurate.
-
-*** New variable =org-export-with-tasks=
-
-Non-nil means include TODO items for export.
-
-This may have the following values:
-
-- t include tasks independent of state.
-- todo include only tasks that are not yet done.
-- done include only tasks that are already done.
-- nil remove all tasks before export
-- list of TODO kwds keep only tasks with these keywords
-
-Thanks to Carsten for implementing this!
-
-*** New variable =org-export-latex-timestamp-inactive-markup=
-
-This variable allows the user to define the LaTeX markup for
-inactive timestamps. It defaults to the same markup than active
-timestamps. Thanks to Eric S Fraga for this patch.
-
-*** New =org-default= face
-
-=M-x customize-face RET org-default RET= will let you define the
-default face for =org-mode= buffers.
-
-*** Babel improvements
-**** In line code block call syntax
-It is now possible to call code blocks from within blocks of
-prose.
-
-The new syntax is exactly analogous to the existing =#+call:=
-line syntax, only it may be present embedded in a block of prose
-for example =call_double(num=8)= would call the =double= code
-block assigning the =num= variable to the value =8=.
-
-**** Optional variable names in code block calls
-Variable names are now optional when passing variables to a code
-block reference. Un-named variables will be assigned in order as
-shown below.
-
-: #+source: minus
-: #+begin_src emacs-lisp :var a=0 :var b=0
-: (- a b)
-: #+end_src
-:
-: #+call: minus(a=8, b=4)
-:
-: #+call: minus(8,4)
-
-**** Sub-tree ID as valid code block variable reference
-It is now possible to assign the textual contents of an Org-mode
-subtree to a code block variable using the ID of the subtree.
-Both custom IDs and Org-mode IDs may be used. For example;
-
-#+begin_src org
- ,#+begin_src sh :var text=foo
- , echo "$text"|wc
- ,#+end_src
-
- ,#+results:
- ,: 8 58 415
-
- ,* example foo
- , :PROPERTIES:
- , :CUSTOM_ID: foo
- , :END:
-
- ,Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Donec
- ,hendrerit tempor tellus. Donec pretium posuere tellus. Proin quam
- ,nisl, tincidunt et, mattis eget, convallis nec, purus. Cum sociis
- ,natoque penatibus et magnis dis parturient montes, nascetur ridiculus
- ,mus. Nulla posuere. Donec vitae dolor. Nullam tristique diam non
- ,turpis. Cras placerat accumsan nulla. Nullam rutrum. Nam vestibulum
- ,accumsan nisl.
-#+end_src
-
-**** =org-babel-tangle-body-hook= for reprocessing code block bodies during tangling
-**** =padline= header argument controls newline padding during tangling
-**** Maxima code blocks are now supported
-Thanks to Eric Fraga for contributing this support.
-**** =awk= code blocks are now supported
-**** Added =xmpfilter= to Ruby code blocks for annotated code output
-**** New =noweb-ref= header argument
-
-This header argument may be used to concatenate the bodies of
-many code blocks into a single noweb reference. This brings
-Org-mode's tangling functionality in line with traditional noweb
-tangling.
-
-A no web reference like the following
-
-#+begin_src org
- ,#+begin_src sh
- , <<the-ref>>
- ,#+end_src
-#+end_src
-
-will now expand to include the bodies of all code blocks which
-are named =the-ref=, as well as all code blocks which have a
-=:noweb-ref= header argument set to the value =the-ref=.
-
-*** New tests
-
-The =tests/= directory has been extensively updated.
-
-** Important bugfixes
-
-*** Org-exp-blocks --- proper handling of recursively nested blocks
-
-During export pre-processing org-exp-blocks will now ensure that
-all matched blocks contain a proper balanced number of
-recursively nested blocks.
-
-Before this fix nested blocks such as the following would break
-during export.
-
-#+begin_src org
- ,#+begin_src org
- , ,#+begin_example
- , , nested example
- , ,#+end_example
- ,#+end_src
-#+end_src
-
-*** List handling
-
-Fix an infinite loop when a list has an end of block string
-without the corresponding beginning.
-
-Auto-filling cannot happen at a location where it would otherwise
-insert a new item.
-
-** Details
-
-*** Footnotes have gone through some bug-fixing:
-
-- properly ignore footnotes in comments,
-- export calls to previously defined footnotes in LaTeX using
- \footnotemark,
-- export footnotes before first heading (LaTeX),
-- export footnotes when selecting a subtree not holding their
- definition (LaTeX).
-
-*** Many small bug fixes have been applied to list handling
-
-- fix `org-timer-item',
-- fix insertion of a new item with a non-nil `indent-tabs-mode',
-- fix use of `fill-region' in an item,
-- correct export lists within footnotes and footnotes within lists,
-- correctly export lists containing macros,
-- don't ignore with-case specification when sorting a list,
-- better indentation handling when changing an item to an headline
- or the other way,
-- fix check-boxes' cookies updating.
-
-* Version 7.5
-
-** Incompatible changes
-
-*** Code block variable initialized with Emacs Lisp code in tables and lists
-
-It is no longer possible to assign code block variables using
-executable Emacs Lisp statements contained in tables or lists.
-As per the following example.
-#+tblname: table
-| (a b c) |
-
-#+begin_src perl :var data=table[0,0]
- $data
-#+end_src
-
-#+results:
-: (a b c)
-
-Thanks to Vladimir Alexiev for raising this issue.
-
-*** `org-bbdb-anniversary-format-alist' has changed
-
-Please check the docstring and update your settings accordingly.
-** New features and user-visible improvements
-
-*** Implement formulas applying to field ranges
-
-Carsten implemented this field-ranges formulas.
-
-: A frequently requested feature for tables has been to be able to define
-: row formulas in a way similar to column formulas. The patch below allows
-: things like
-:
-: @3=
-: @2$2..@5$7=
-: @I$2..@II$4=
-:
-: as the left hand side for table formulas in order to write a formula that
-: is valid for an entire column or for a rectangular section in a
-: table.
-
-Thanks a lot to Carsten for this.
-
-*** Improved handling of lists
-
-Nicolas Goaziou extended and improved the way Org handles lists.
-
-1. Indentation of text determines again end of items in
- lists. So, some text less indented than the previous item
- doesn't close the whole list anymore, only all items more
- indented than it.
-
-2. Alphabetical bullets are implemented, through the use of the
- variable `org-alphabetical-lists'. This also adds alphabetical
- counters like [@c] or [@W].
-
-3. Lists can now safely contain drawers, inline tasks, or various
- blocks, themselves containing lists. Two variables are
- controlling this: `org-list-forbidden-blocks', and
- `org-list-export-context'.
-
-4. Improve `newline-and-indent' (C-j): used in an item, it will
- keep text from moving at column 0. This allows to split text
- and make paragraphs and still not break the list.
+*** org-gnus.el now allows link creation from messages
+ :PROPERTIES:
+ :OrgVersion: 7.5
+ :END:
-5. Improve `org-toggle-item' (C-c -): used on a region with
- standard text, it will change the region into one item. With a
- prefix argument, it will fallback to the previous behavior and
- make every line in region an item. It permits to easily
- integrate paragraphs inside a list.
+ You can now create links from messages. This is particularily
+ useful when the user wants to stored messages that he sends, for
+ later check. Thanks to Ulf Stegemann for the patch.
-6. `fill-paragraph' (M-q) now understands lists. It can freely be
- used inside items, or on text just after a list, even with no
- blank line around, without breaking list structure.
-Thanks a lot to Nicolas for all this!
*** Modified link escaping
+ :PROPERTIES:
+ :OrgVersion: 7.5
+ :END:
-David Maus worked on `org-link-escape'. See [[http://article.gmane.org/gmane.emacs.orgmode/37888][his message]]:
+ David Maus worked on `org-link-escape'. See [[http://article.gmane.org/gmane.emacs.orgmode/37888][his message]]:
: Percent escaping is used in Org mode to escape certain characters
: in links that would either break the parser (e.g. square brackets
@@ -1115,2118 +351,595 @@ David Maus worked on `org-link-escape'. See [[http://article.gmane.org/gmane.em
: Additionally some of the outstanding bugs or glitches concerning
: percent escaped links are solved.
-Thanks a lot to David for this work.
-
-*** Simplification of org-export-html-preamble/postamble
-
-When set to `t', export the preamble/postamble as usual, honoring
-the =org-export-email/author/creator-info= variables.
-
-When set to a formatting string, insert this string. See the
-docstring of these variable for details about available
-%-sequences.
-
-You can set =:html-preamble= in publishing project in the same
-way: `t' means to honor =:email/creator/author-info=, and a
-formatting string will insert a string.
-
-*** New command `org-agenda-append-agenda'
-
-You can now use `org-agenda-append-agenda' to dynamically add new
-agendas views to the current one. It is particularily useful to
-compare multiple small agendas.
-
-*** Localized clock tables
-
-Clock tables now support a new new =:lang= parameter, allowing
-the user to customize the localization of the table headers. See
-the variable =org-clock-clocktable-language-setup= which controls
-available translated strings.
-
-*** New sorting options when publishing projects
-
-The =:sitemap-sort-file= option now allows sorting the sitemap
-file (anti-)alphabetically and (anti-)chronogically. Thanks a
-lot to Manuel Giraud for a patch to this effet.
-
-*** Testing with ERT
-
-Martyn Jago added new tests to =testing/= - thanks to him!
-*** New file in contrib/: org-notmuch.el
-
-Org is now distributed with =org-notmuch.el=, by Matthieu
-Lemerre. See explanations in the header of =org-notmuch.el=:
-
-: =org-notmuch.el= implements links to notmuch messages and
-: "searchs". A search is a query to be performed by notmuch; it is
-: the equivalent to folders in other mail clients. Similarly, mails
-: are refered to by a query, so both a link can refer to several
-: mails.
-
-*** org-gnus.el now allows link creation from messages
-
-You can now create links from messages. This is particularily
-useful when the user wants to stored messages that he sends, for
-later check. Thanks to Ulf Stegemann for the patch.
-
-** Important bug fixes
-
-*** Capturing to narrowed buffers
-
-You can now safely capture entries to narrowed buffers. Thanks a
-lot to Memnon Anon for bringing this up.
-
-*** Better handling of the new `org-agenda-span' variable
-
-Agendas were a bit confused by the introduction of this variable,
-in particular block agendas. This is now fixed.
-
-Thanks to Julien and Carsten for helping find the right fix for
-this issue, and to Michael Brand and Matt Lundin for their
-patient testing and reporting.
-
-*** Security warning: using org-crypt with auto-save
-
-To prevent Emacs from auto-saving encrypted entries in clear
-text, the user should not use auto-save with org-crypt.el. We
-now send a warning when users are both using auto-saving and
-org-crypt.el. Thanks to Peter Jones for bringing this up.
-
-** Details
-
-*** Babel
-**** :file argument causes results to be written to file for all languages
-:file <filename> should be understood as saying "write the result
-to <filename> and return a link to <filename>".
-
-This works for all languages. For graphics languages (e.g. ditaa, dot,
-gnuplot) there is no change in behavior: "result" in the above is the
-graphics, and a link to the image is placed in the org buffer. For
-general-purpose languages (e.g. emacs-lisp, python, R, ruby, shell),
-the "result" written to file is the normal org-babel result (string,
-number, table).
-
-In order to return a file link from a src block without telling babel
-to save any results to that file, use :results <filename> and do not
-use :file. The code block can of course write arbitrary content to
-<filename>.
-
-Some examples:
-
-Save the output of ls -l as a .csv file (recall that :results value is
-the default):
-
-#+begin_src sh :file dirlisting.csv :sep ,
- ls -l
-#+end_src
-
-Send the text output of ls -l directly to file:
-
-#+begin_src sh :results output :file dirlisting.txt
- ls -l
-#+end_src
-
-**** R requires :results graphics :file filename when generating graphics
-":results graphics" is now required in addition to ":file
-filename" in order for graphical output to be sent automatically
-to file. If :file is supplied, but not ":results graphics", then
-non-graphical, "value" or "output" results are written to file,
-depending on which of those options is in effect.
-**** Calc code blocks can now accept vectors
-For example;
-
-#+begin_src calc :var y=[1 2 3]
- 3 y
-#+end_src
-
-#+results:
-: [3, 6, 9]
-
-Thanks to Eric S. Fraga for raising this issue
+ Thanks a lot to David for this work.
-**** Code blocks with empty bodies are now acceptable
-Previously these caused errors on export. Thanks to Martyn Jago
-for this patch.
-
-**** Emacs Lisp variable assignments which don't eval cleanly passed literally
-
-This makes it possible to easily pass through non-elisp variable
-assignments which may initially look like valid elisp.
-
-**** Unified naming of =c++= functions to =C++=
-Thanks to Martyn Jago for this patch.
-
-**** `org-babel-execute-buffer' and `org-babel-execute-subtree' now eval inline code blocks as well
-
-**** New :mkdirp header argument creates parent dirs of tangle targets
-
-**** New ":comments noweb" option for wrapping noweb references in comment links
-
-This can be useful to allow backward linking from tangle code
-files to the original code block holding noweb-expanded content.
-
-**** Allow detangling of text containing '\'s -- Thanks to Seth Burleigh
-
-**** =:sep= specifies table separator when opening or writing tabular results
-
-**** `org-edit-src-content-indentation' can now be a buffer-local variable
-*** All export configuration variables can now be buffer-local variables
-*** org-complete.el has been renamed to org-pcomplete.el
-
-In case you were manually loading =org-complete.el= (which is
-*not* necessary anyway), please be aware that the name of this
-library was changed to =org-pcomplete.el=.
-
-*** New user options for LaTeX source code export via minted and listings packages
-
-New variables `org-export-latex-listings-options' and
-`org-export-latex-minted-options' allow package options to be
-controlled; `org-export-latex-custom-lang-environments' allows
-arbitrary configuration on a per-language basis.
-
-*** Effort durations now support 2d, 2m, etc.
-
-Effort duration can now be set as 2h (for 2 hours), etc. This
-will be converted to minutes automatically when clocking in an
-entry with an effort property. See the =org-effort-durations=
-variable.
-
-Thanks a lot to Lawrence Mitchell for this patch.
-
-*** New option :clock-keep for capture templates
-
-A capture template with =:clock-keep t= will prevent the refiling
-process from clocking out the entry. If =:clock-resume= is also
-`t', =:clock-keep= will take precedence and =:clock-resume= will
-be ignored.
-
-So now =:immediate-finish t :clock-in t :clock-keep t= makes
-sense: it will capture a new task and clock it.
-
-*** Misc
-
-**** New command `org-agenda-bulk-mark-regexp'
-
-=M-x org-agenda-bulk-mark-regexp RET= will mark agenda entries
-which headings match against a regular expression. You can call
-this command with the `%' key from an agenda buffer.
-
-**** New command `org-agenda-reset-view'
-
-Julien Danjou implemented this:
-
-: This new command lets you switch to day/week/month/year view.
-:
-: When switching to day or week view, this setting becomes the default for
-: subsequent agenda refreshes. Since month and year views are slow to
-: create, they do not become the default. A numeric prefix argument may be
-: used to jump directly to a specific day of the year, ISO week, month, or
-: year, respectively. For example, `32 d' jumps to February 1st, `9 w' to
-: ISO week number 9. When setting day, week, or month view, a year may be
-: encoded in the prefix argument as well. For example, `200712 w' will jump
-: to week 12 in 2007. If such a year specification has only one or two
-: digits, it will be mapped to the interval 1938-2037. `v SPC'' will reset to
-: what is set in `org-agenda-span'.
-
-Thanks a lot to Julien for this.
-
-**** New options for ignoring past or future items in the global todo list
-
-This patch gives users greater control over which past or future items
-they would like to ignore in the global todo list. By setting
-org-agenda-todo-ignore-scheduled to 7, for instance, a user can ignore all
-items scheduled 7 or more days in the future. Similarly, by setting
-org-agenda-todo-ignore-scheduled to -1, a user can ignore all items that
-are truly in the past (unlike the 'past setting, which ignores items
-scheduled today).
-
-See the docstrings of these variables:
-
-- org-agenda-todo-ignore-deadlines
-- org-agenda-todo-ignore-scheduled
-- org-agenda-todo-ignore-timestamp
-
-Thanks a lot to Matt Lundin for implementing this and to Paul
-Sexton for the idea.
-
-**** New variable `org-export-table-remove-empty-lines'
-
-When set to `nil', don't remove empty tables when exporting
-tables. This was requested by Eric S Fraga.
-
-**** New variable `org-table-fix-formulas-confirm'
-
-Sometime, editing the structure of a table should not edit the
-corresponding formulas. This new variable lets the user decide
-whether he wants to confirm formula fixes or not.
-
-**** New variable `org-export-initial-scope'
-
-This variable controls the initial scope when exporting with `org-export'.
-It can be set to 'buffer or 'subtree. If there is an active region, tell
-it when prompting the user for an export command.
-
-**** Show and use the default refile location
-
-M-x org-refile RET now shows the default refile location. Thanks to
-Tassilo Horn for a patch to this effect.
-
-**** New variable `org-archive-subtree-add-inherited-tags'
-
-Non-nil means append inherited tags when archiving a subtree.
-
-**** New variable `org-export-current-backend'
-
-This variable is dynamically set by exporters. You can check
-against its value anytime in your code to see if you are
-exporting to HTML, LaTeX, etc. Possible values are 'html,
-'latex, 'ascii, 'docbook. Thanks to Eric Schulte and Dan Davison
-for ideas and patches in this area.
-
-**** New hook `org-clock-before-select-task-hook'
-
-Hook called in task selection just before prompting the user.
-
-Thanks to Benjamin Drieu for the patch.
-
-**** = = emphasis now uses \protectedtexttt
-**** Author's email now included in the LaTeX title
-
-When `org-export-email-info' is non-nil, the LaTeX title will
-also include the author's email. Thanks to Lawrence Mitchell for
-the patch.
+*** Make =org-store-link= point to directory in a dired buffer
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-**** Update contrib/scripts/ditaa.jar to ditaa v0.9 of 2009-11-24
+ When, in a dired buffer, the cursor is not in a line listing a
+ file, `org-store-link' will store a link to the directory.
-**** New variable `org-mobile-files-exclude-regexp'
+ Patch by Stephen Eglen.
-This variable lets you exclude files that you don't want in
-org-mobile-files.
-**** New variable `org-confirm-elisp-link-not-regexp'
-Set this to a regexp if you want to skip the confirmation step for
-Elisp/Shell code matching this regexp.
+*** Allow regexps in =org-file-apps= to capture link parameters
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-**** New variable `org-attach-store-link-p'
+ The way extension regexps in =org-file-apps= are handled has
+ changed. Instead of matching against the file name, the regexps
+ are now matched against the whole link, and you can use grouping
+ to extract link parameters which you can then use in a command
+ string to be executed.
-When set to `t', store link to the attached file, at its original location.
+ For example, to allow linking to PDF files using the syntax
+ =file:/doc.pdf::<page number>=, you can add the following entry to
+ org-file-apps:
-**** `org-table-use-standard-references' now defaults to 'from
+ #+begin_example
+ Extension: \.pdf::\([0-9]+\)\'
+ Command: evince "%s" -p %1
+ #+end_example
-**** Better `org-agenda-repeating-timestamp-show-all'
+ Thanks to Jan Böcker for a patch to this effect.
-When this is set to a list of TODO keywords, the agenda will only show
-occurrences of repeating stamps for these TODO keywords.
+** Dates and time
-**** New command `org-narrow-to-block'
+*** Allow relative time when scheduling/adding a deadline
+ :PROPERTIES:
+ :OrgVersion: 7.7
+ :END:
-This command (`C-x n b') will narrow the buffer to the current block.
-* Version 7.4
+ You can now use relative duration strings like "-2d" or "++3w"
+ when calling =org-schedule= or =org-deadline=: it will schedule
+ (or set the deadline for) the item respectively two days before
+ today and three weeks after the current timestamp, if any.
-** Incompatible changes
+ You can use this programmatically: =(org-schedule nil "+2d")=
+ will work on the current entry.
-*** Agenda: rework ndays and span handling
+ You can also use this while (bulk-)rescheduling and
+ (bulk-)resetting the deadline of (several) items from the agenda.
-The variable =org-agenda-ndays= is obsolete - please use
-=org-agenda-span= instead.
+ Thanks to Memnon Anon for a heads up about this!
-Thanks to Julien Danjou for this.
-** Details
-*** Improvements with inline tasks and indentation
-There is now a configurable way on how to export inline tasks. See
-the new variable =org-inlinetask-export-templates=.
+*** American-style dates are now understood by =org-read-date=
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-Thanks to Nicolas Goaziou for coding these changes.
+ So when you are prompted for a date, you can now answer like this
-*** Agenda: Added a bulk "scattering" command
+ #+begin_example
+ 2/5/3 --> 2003-02-05
+ 2/5 --> <CURRENT-YEAR>-02-05
+ #+end_example
-=B S= in the agenda buffer will cause tasks to be rescheduled a random
-number of days into the future, with 7 as the default. This is useful
-if you've got a ton of tasks scheduled for today, you realize you'll
-never deal with them all, and you just want them to be distributed
-across the next N days. When called with a prefix arg, rescheduling
-will avoid weekend days.
+** Agenda
-Thanks to John Wiegley for this.
+*** =org-agenda-custom-commands= has a default value
+ :PROPERTIES:
+ :OrgVersion: 7.8
+ :END:
-*** In-buffer completion is now done using John Wiegleys pcomplete.el
+ This option used to be `nil' by default. This now has a default
+ value, displaying an agenda and all TODOs. See the docstring for
+ details. Thanks to Carsten for this.
-Thanks to John Wiegley for much of this code.
-*** Sending radio tables from org buffers is now allowed
+*** Improved filtering through =org-agenda-to-appt=
+ :PROPERTIES:
+ :OrgVersion: 7.8
+ :END:
-Org radio tables can no also be sent inside Org buffers. Also,
-there is a new hook which get called after a table has been sent.
+ The new function allows the user to refine the scope of entries
+ to pass to =org-agenda-get-day-entries= and allows to filter out
+ entries using a function.
-Thanks to Seweryn Kokot.
+ Thanks to Peter Münster for raising a related issue and to
+ Tassilo Horn for this idea. Also thanks to Peter Münster for
+ [[git:68ffb7a7][fixing a small bug]] in the final implementation.
-*** Command names shown in manual
-The reference manual now lists command names for most commands.
-Thanks to Andreas Röhler who started this project.
*** Allow ap/pm times in agenda time grid
+ :PROPERTIES:
+ :OrgVersion: 7.4
+ :END:
-Times in the agenda can now be displayed in am/pm format. See the new
-variable =org-agenda-timegrid-use-ampm=. Thanks to C. A. Webber for
-a patch to this effect.
-
-*** Rewriten clock table code
-
-The entire clocktable code has been rewritten to add more options and
-to make hacking time reports easier.
-
-Thanks to Erwin Vrolijk for a patch introducing clock tables for
-quarters.
-
-*** Babel
-**** Add =msosql= engine to sql code blocks
-SQL code blocks can now be executed using the =myosql= engine
-using the osql command (from MS SQL Server) on Windows systems.
-
-Thanks to Sébastien Vauban for this contribution.
-
-**** Python code blocks now accept a =preamble= header argument
-This allows specification of coding declarations and library imports
-which must take place in the beginning of a file of executed python
-code (note this header argument is used during code block evaluation
-unlike the =shebang= header argument which is used during tangling).
-For example
-
-#+begin_src org
- ,#+begin_src python :preamble # -*- coding: utf-8 -*- :return s
- ,s = "é"
- ,#+end_src
-#+end_src
-
-Thanks to Vincent Beffara for this idea.
-
-**** Code block name is shown during evaluation query
-When the user is queried about the evaluation of a named code block
-the name of the code block is now displayed.
-
-Thanks to Tom Dye for this suggestion.
-
-**** Clojure code blocks results insertion
-The results of Clojure code blocks have been improved in two ways.
-1. lazy sequences are now expanded for insertion into the Org-mode
- buffer
-2. pretty printing of results is now possible with both "code" and
- "data" pretty print formats
-
-Thanks to Rick Moynihan for suggesting these changes.
-
-**** Python code blocks now accept a =:return= header argument
-This alleviates the need to explicitly insert return statements into
-the bode of Python code blocks. This change both
-- allows the same python code blocks to be run both in sessions and
- externally
-- removes the floating =return= statements which violated python
- syntax
-
-Thanks to Darlan Cavalcante for proposing this feature.
-
-**** =:results wrap= header argument wraps code block results
-The new =:results wrap= wraps code blocks results in a custom
-environment making it possible to offset their contents during
-export. For example
-
-#+begin_src org
- ,#+begin_src emacs-lisp :results wrap
- , "code block results"
- ,#+end_src
-
- ,#+results:
- ,#+BEGIN_RESULT
- ,: code block results
- ,#+END_RESULT
-#+end_src
-
-Thanks to Sébastien Vauban for persistently suggesting this enhancement.
-
-**** Code block error buffer wiped clean between executions
-Previously the code block error buffer accumulated errors making it
-difficult to distinguish between previous and current errors. This
-buffer is now cleaned before every interactive code block evaluation.
-
-**** Lists now recognized by code blocks
-It is now possible for code blocks to both read and write list
-contents from and to Org-mode buffers. For example
-
-#+begin_src org
- ,#+results: a-list
- ,- babel
- ,- and
- ,- org-mode
-
- ,#+source: a-list
- ,#+begin_src emacs-lisp :var lst=a-list :results list
- , (reverse lst)
- ,#+end_src
-#+end_src
-
-**** Calc added as a supported code block language
-The Emacs Calc package can be used through =calc= code blocks allowing
-both regular arithmetic operations as well as stack based
-calculation. For example
-
-#+begin_src org
- ,#+source: calc-stack
- ,#+begin_src calc
- , 8
- , 1
- , '+
- , 9
- , '*
- ,#+end_src
-
- ,#+results: calc-stack
- ,: 81
-
- ,#+source: calc-arithmetic
- ,#+begin_src calc :var in=calc-stack
- , in / 9
- ,#+end_src
-
- ,#+results: calc-arithmetic
- ,: 9
-#+end_src
-
-**** "org-babel-detangle" propagates change to source code files into code blocks
-`org-babel-detangle' can be used to propagate changes to pure source
-code files tangled from embedded code blocks in Org-mode files back to
-the original code blocks in the Org-mode file. This can be used on
-collaborative projects to keep embedded code blocks up to date with
-edits made in pure source code files.
-
-* Version 7.02
-
-** Incompatible Changes
-*** Code block hashes
-Due to changes in the code resolving code block header arguments
-hashing of code block results should now re-run a code block when
-an argument to the code block has changed. As a result of this
-change *all* code blocks with cached results will be re-run after
-upgrading to the latest version.
-
-*** Testing update
-Anyone using the org-mode test suite will need to update the jump
-repository for test navigation by executing the following from
-the root of the org-mode repository.
-: git submodule update
-Failure to update this repository will cause loading of
-org-test.el to throw errors.
-** Details
-*** Org-babel speed commands
-All Org-babel commands (behind the C-c C-v key prefix) are now
-available as speed commands when the point is on the first line of a
-code block. This uses the existing Org-mode speed key mechanisms.
-
-Thanks to Jambunathan K for implementation this new feature.
-
-*** Fontify code in code blocks.
-
-Source code in code blocks can now be fontified. Please customize the
-varable =org-src-fontify-natively=. For very large blocks (several
-hundreds of lines) there can be delays in editing such fontified
-blocks, in which case C-c ' should be used to bring up a dedicated
-edit buffer.
-
-Thanks to Dan Davison for this.
-
-*** Language-mode commands are available in the Org-buffer
- The most general machinery for doing this is the macro
- `org-babel-do-in-edit-buffer'. There is also the convenience
- function `org-babel-do-key-sequence-in-edit-buffer' which makes
- use of this macro, and is bound to C-c C-v C-x and C-c C-v x. If
- there is an active region contained within the code block, then
- this is inherited by the edit buffer. Some examples of the sorts
- of usage this permits are
-
-C-c C-v C-x M-; comment region according to language
-C-c C-v C-x C-M-\ indent region according to language
-
-Users can make these more convenient, e.g.
-
-(defun my/org-comment-dwim (&optional arg)
- (interactive "P")
- (or (org-babel-do-key-sequence-in-edit-buffer "\M-;")
- (comment-dwim arg)))
-
-(define-key org-mode-map "\M-;" 'my/org-comment-dwim)
-
-A common instance of this general pattern is built in to Org-mode,
-controlled by the variable `org-src-tab-acts-natively': if this
-variable is set, then TAB in a code block has the effect that it would
-have in the language major mode buffer.
-
-*** Org-babel commands are available in language-mode edit buffer
- Mirroring the language-native commands in Org buffers above, a new
- macro `org-src-do-at-code-block' and convenience function
- `org-src-do-key-sequence-at-code-block' provide the converse. When
- used in a language major-mode edit buffer (i.e. a buffer generated
- by C-c '), `org-src-do-key-sequence-at-code-block' executes a key
- sequence at the code block in the source Org buffer. The command
- bound to the key sequence in the Org-babel key map is executed
- remotely with point temporarily at the start of the code block in
- the Org buffer.
-
- The command is not bound to a key by default, to avoid conflicts
- with language major mode bindings. To bind it to C-c @ in all
- language major modes, you could use
-
- (add-hook 'org-src-mode-hook
- (lambda () (define-key org-src-mode-map "\C-c@"
- 'org-src-do-key-sequence-at-code-block)))
-
- In that case, for example, C-c @ t issued in code edit buffers
- would tangle the current Org code block, C-c @ e would execute
- the block and C-c @ h would display the other available
- Org-babel commands.
-
-*** Multi-line header arguments to code blocks
-Code block header arguments can now span multiple lines using the
-new =#+header:= or =#+headers:= lines preceding a code block or
-nested in between the name and body of a named code block.
-Examples are given below.
-
-- multi-line header arguments on an un-named code block
- : #+headers: :var data1=1
- : #+begin_src emacs-lisp :var data2=2
- : (message "data1:%S, data2:%S" data1 data2)
- : #+end_src
- :
- : #+results:
- : : data1:1, data2:2
-
-- multi-line header arguments on a named code block
- : #+source: named-block
- : #+header: :var data=2
- : #+begin_src emacs-lisp
- : (message "data:%S" data)
- : #+end_src
- :
- : #+results: named-block
- : : data:2
-
-*** Unified handling of variable expansion for code blocks
-The code used to resolve variable references in code block header
-arguments has now been consolidated. This both simplifies the
-code base (especially the language-specific files), and ensures
-that the arguments to a code block will not be evaluated multiple
-times. This change should not be externally visible to the
-Org-mode user.
-*** Improved Caching
-Code block caches now notice if the value of a variable argument
-to the code block has changed, if this is the case the cache is
-invalidated and the code block is re-run. The following example
-can provide intuition for the new behavior.
-#+begin_src org :exports code
- ,#+srcname: random
- ,#+begin_src R :cache yes
- ,runif(1)
- ,#+end_src
-
- ,#+results[a2a72cd647ad44515fab62e144796432793d68e1]: random
- ,: 0.4659510825295
-
- ,#+srcname: caller
- ,#+begin_src emacs-lisp :var x=random :cache yes
- ,x
- ,#+end_src
-
- ,#+results[bec9c8724e397d5df3b696502df3ed7892fc4f5f]: caller
- ,: 0.254227238707244
-#+end_src
-
-*** Added :headers header argument for LaTeX code blocks
-This makes it possible to set LaTeX options which must take place in
-the document pre-amble for LaTeX code blocks. This header argument
-accepts either a single string or a list, e.g.
-
-#+begin_src org
- ,#+begin_src latex :headers \usepackage{lmodern} :file name1.pdf
- , latex body
- ,#+end_src
-
- ,#+begin_src latex :headers '("\\usepackage{mathpazo}" "\\usepackage{fullpage}") :file name2.pdf
- , latex body
- ,#+end_src
-#+end_src
-
-*** New function `org-export-string'
-Allows exporting directly from a string to the specified export format.
-*** Code block header argument ":noweb tangle"
-Only expands <<noweb>> syntax references when tangling, not during
-export (weaving).
-*** New function `org-babel-switch-to-session-with-code'
-C-c C-v z (`org-babel-switch-to-session-with-code') is a variant of
-C-c C-v C-z (`org-babel-switch-to-session'): instead of switching to
-the session buffer, it splits the window between (a) the session
-buffer and (b) a language major-mode edit buffer for the code block in
-question. This can be convenient for using language major mode for
-interacting with the session buffer.
-
-*** Improvements to R sessions
- R now uses standard ESS code evaluation machinery in the :results
- value case, which avoids unnecessary output to the comint
- buffer. In addition, the R command responsible for writing the
- result to file is hidden from the user. Finally, the R code edit
- buffer generated by C-c ' is automatically linked to the ESS
- session if the current code block is using :session.
-
-*** Temporary file directory
-All babel temporary files are now kept in a single sub-directory in
-the /tmp directory and are cleaned up when Emacs exits.
-
-*** Function for demarcating blocks `org-babel-demarcate-block'
-Can be called to wrap the region in a block, or to split the block
-around point, bound to (C-c C-v d).
-
-*** Function for marking code block contents `org-babel-mark-block'
- Bound to C-M-h in the babel key map (i.e. C-c C-v C-M-h by
- default). This can be useful in conjunction with
- `org-babel-do-in-edit-buffer', for example for language-native
- commenting or indenting of the whole block.
-*** Lists of anniversaries are now handeled better
-
-When several anniversaries are defined in the bbdb anniversaries
-field (separated by semicolon), this is now handled nicely by the
-agenda.
-
-Thanks to Łukasz Stelmach for a patch to this effect.
-
-*** Table fields are now aligned better, new <c> cookie.
-
-In HTML export, table fields are now properly aligned in accord
-with automatic alignment in org, or as set by the =<r>=, =<l>=, and
-=<c>= cookies. The =<c>= cookie is new and has no effect in
-Org, but it does do the right thing in HTML export. A LaTeX export
-implementation will follow, but is currently still missing.
-
-*** Update freemind converter to include body text
-
-The freemind exporter now incorporates body text into the mind
-map.
-
-Thanks to Lennard Borgman for this patch.
-
-*** Make footnotes work correctly in message-mode
-The footnotes code now searches for =message-signature-separator=
-(which is "-- " by default) in order to place footnotes before the
-signature. Thanks to Tassilo Horn for this patch.
-
-*** Improve XEmacs compatibility
-
-Org-mode 7.02 now runs again in 21.4.22 if the new XEmacs base
-package is installed.
-
-Thanks to Uwe Bauer, Volker Ziegler, Michael Sperber and others
-for a discussion that lead to this nice result.
-
-*** Make it configurable wether agenda jumping prefers the future
-
-When jumping to a date from the agenda using the =j= key, you may
-or may not like the property of Org's date reader to prefer the
-future when you enter incomplete dates. This can now be
-configured using the variable =org-agenda-jump-prefer-future'.
-
-*** Add publishing functions for ASCII, Latin-1 and UTF-8
-
-There are now publishing functions =org-publish-org-to-ascii=,
-=org-publish-org-to-latin1=, and =org-publish-org-to-utf8=.
-
-Thanks to Matthias Danzl for showing how to do this.
-
-*** Indentation and headline insertion after inline tasks
-
-Indentation in inline tasks, and headline insertion after inline
-tasks now behave as expected.
-
-*** Encryption in MobileOrg finally works
-
-As soon as MobilOrg 1.5 hits the Apple's AppStore, you can
-encrypt your org files on public servers. Please see the
-documentation of MobileOrg and Appendix B of the manual for more
-details.
-
-*** MobileOrg: Do not force to insert IDs
-
-If you dislike the property of MobileOrg to insert ID properties
-for in all entries being part of an agenda view, you can now turn
-this off using the variable
-=org-mobile-force-id-on-agenda-items=. When this variable is set
-to =nil=, MobileOrg will use outline paths to identify entries.
-Note that this may fail if several entries have identical outline
-paths.
-
-*** LaTeX minted package for fontified source code export
-Patch by Dan Davison.
-
-A non-nil value of `org-export-latex-minted' means to export source
-code using the minted package, which will fontify source code
-with color. If you want to use this, you need to make LaTeX use the
-minted package. Add minted to `org-export-latex-packages-alist', for
-example using customize, or with something like
-
- (require 'org-latex)
- (add-to-list 'org-export-latex-packages-alist '("" "minted"))
-
-In addition, it is neccessary to install
-pygments (http://pygments.org), and to configure
-`org-latex-to-pdf-process' so that the -shell-escape option is
-passed to pdflatex.
-
-*** Allow to use texi2dvi or rubber for processing LaTeX to pdf
-
-Please see the variable =org-export-latex-to-pdf-process= for
-more information.
+ Times in the agenda can now be displayed in am/pm format. See the new
+ variable =org-agenda-timegrid-use-ampm=. Thanks to C. A. Webber for
+ a patch to this effect.
-Thanks to Olivier Schwander for the rubber part.
-*** New STARTUP keywords to turn on inline images
-If you want to inline images whenever you visit an Org file, use
-
-: #+STARTUP: inlineimages
-
-*** Support for user-extensible speed commands.
-
-There is a new hook =org-speed-command-hook=. Thanks to
-Jambunathan for a patch to this effect.
-
-*** Add macro to insert property values into exported text
-
-you can use {{{property{NAME}}}} to insert the value of a
-property upon export.
-
-Thanks to David Maus for a patch to this effect.
-
-*** LaTeX package fixes
+*** Agenda: Added a bulk "scattering" command
+ :PROPERTIES:
+ :OrgVersion: 7.4
+ :END:
-We updated the list of default packages loaded by LaTeX exported
-files.
+ =B S= in the agenda buffer will cause tasks to be rescheduled a random
+ number of days into the future, with 7 as the default. This is useful
+ if you've got a ton of tasks scheduled for today, you realize you'll
+ never deal with them all, and you just want them to be distributed
+ across the next N days. When called with a prefix arg, rescheduling
+ will avoid weekend days.
-*** Allow "#" and "%" in tags
+ Thanks to John Wiegley for this.
-Tags can now also contain the characters =#= and =%=, in addition
-to =@= and letters.
+** Exporting
-*** Show command names in manual
+*** Simplification of org-export-html-preamble/postamble
+ :PROPERTIES:
+ :OrgVersion: 7.5
+ :END:
-Andreas Röhler is adding command names to keys in the manual.
-This will take a while to complete, but a start has been made.
+ When set to `t', export the preamble/postamble as usual, honoring the
+ =org-export-email/author/creator-info= variables.
-*** Make backslash escape "-" in property matches
+ When set to a formatting string, insert this string. See the docstring
+ of these variable for details about available %-sequences.
-When entering a tags/property query, "-" is a logical operator.
-However, "-" is also allowed in property names. So you can now
-write "SOME\-NAME" to work around this issue.
+ You can set =:html-preamble= in publishing project in the same way: `t'
+ means to honor =:email/creator/author-info=, and a formatting string
+ will insert a string.
-This was a request by Ilya Shlyakhter.
+*** New exporters to Latin-1 and UTF-8
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
+
+ While Ulf Stegemann was going through the entities list to improve the
+ LaTeX export, he had the great idea to provide representations for many
+ of the entities in Latin-1, and for all of them in UTF-8. This means
+ that we can now export files rich in special symbols to Latin-1 and to
+ UTF-8 files. These new exporters can be reached with the commands =C-c
+ C-e n= and =C-c C-e u=, respectively.
+
+ When there is no representation for a given symbol in the targeted
+ coding system, you can choose to keep the TeX-macro-like
+ representation, or to get an "explanatory" representation. For
+ example, =\simeq= could be represented as "[approx. equal to]". Please
+ use the variable =org-entities-ascii-explanatory= to state your
+ preference.
-*** Document quick insertion of empty structural elements
+*** HTML export: Add class to outline containers using property
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-Org-mode has a built-in template mechanism for inserting block
-templates. This was undocumented until now.
+ The =HTML_CONTAINER_CLASS= property can now be used to add a class name
+ to the outline container of a node in HTML export.
-Thanks to Jambunathan K for the patch.
+*** Throw an error when creating an image from a LaTeX snippet fails
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-*** Implement MathJax support
+ This behavior can be configured with the new option variable
+ =org-format-latex-signal-error=.
-Org-mode now uses MathJax to display math on web pages. We serve
-MathJax from the orgmode.org server, at least for the time being
-(thanks Bastien!). If you are going to use this for pages which
-are viewed often, please install MathJax on your own webserver.
+*** Support for creating BEAMER presentations from Org-mode documents
+ :PROPERTIES:
+ :OrgVersion: 6.34
+ :END:
-To return to the old way of creating images and inserting them
-into web pages, you would have to set
+ Org-mode documents or subtrees can now be converted directly in to
+ BEAMER presentation. Turning a tree into a simple presentations is
+ straight forward, and there is also quite some support to make richer
+ presentations as well. See the [[http://orgmode.org/manual/Beamer-class-export.html#Beamer-class-export][BEAMER section]] in the manual for more
+ details.
-: (setq org-export-with-LaTeX-fragments 'dvipng)
+ Thanks to everyone who has contributed to the discussion about BEAMER
+ support and how it should work. This was a great example for how this
+ community can achieve a much better result than any individual could.
-or on a per-file basis
+** Refiling
-: #+OPTIONS: LaTeX:dvipng
+*** Refile targets can now be cached
+ :PROPERTIES:
+ :OrgVersion: 7.01
+ :END:
-*** Agenda: Allow compact two-column display in agenda dispatcher
+ You can turn on caching of refile targets by setting the variable
+ =org-refile-use-cache=. This should speed up refiling if you have many
+ eligible targets in many files. If you need to update the cache
+ because Org misses a newly created entry or still offers a deleted one,
+ press =C-0 C-c C-w=.
-If you have many custom agenda commands, you can have the display
-in the dispatcher use two columns with the following settings
+*** New logging support for refiling
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-: (setq org-agenda-menu-show-match nil
-: org-agenda-menu-two-column t)
+ Whenever you refile an item, a time stamp and even a note can be added
+ to this entry. For details, see the new option =org-log-refile=.
-This was a request by John Wiegley.
+ Thanks to Charles Cave for this idea.
-*** Add org-wikinodes.el as a contributed package
+** Completion
-One frequent request has been to be able to use CamelCase words
-for automatic cross links in a Wiki created by Org. THis is now
-possible with org-wikinodes.el, which is available in the contrib
-directory. We also have some [[http://orgmode.org/worg/org-contrib/org-wikinodes.php][documentation]] for this feature up
-on Worg.
+*** In-buffer completion is now done using John Wiegleys pcomplete.el
+ :PROPERTIES:
+ :OrgVersion: 7.4
+ :END:
-*** Timer/clock enhancements
+ Thanks to John Wiegley for much of this code.
-=org-timer-set-timer= displays a countdown timer in the modeline.
-From the agenda, `J' invokes =org-agenda-clock-goto=.
+** Tables
-* Version 7.01
+*** New command =org-table-transpose-table-at-point=
+ :PROPERTIES:
+ :OrgVersion: 7.8
+ :END:
-** Incompatible Changes
+ See the docstring. This hack from Juan Pechiar is now part of Org's
+ core. Thanks to Juan!
-*** Emacs 21 support has been dropped
+*** Display field's coordinates when editing it with =C-c `=
+ :PROPERTIES:
+ :OrgVersion: 7.7
+ :END:
-Do not use Org mode 7.xx with Emacs 21, use [[http://orgmode.org/org-6.36c.zip][version 6.36c]] instead.
+ When editing a field with =C-c `=, the field's coordinate will the
+ displayed in the buffer.
-*** XEmacs support requires the XEmacs development version
-
-To use Org mode 7.xx with XEmacs, you need to run the developer
-version of XEmacs. I was about to drop XEmacs support entirely,
-but Michael Sperber stepped in and made changes to XEmacs that
-made it easier to keep the support. Thanks to Michael for this
-last-minute save. I had hoped to be able to remove
-xemacs/noutline.el from release 7 by moving it into XEmacs, but
-this is not yet done.
-
-*** Org-babel configuration changes
-
-Babel took the integration into Org-mode as an opportunity to do
-some much needed house cleaning. Most importantly we have
-simplified the enabling of language support, and cleared out
-unnecessary configuration variables -- which is great unless you
-already have a working configuration under the old model.
-
-The most important changes regard the /location/ and /enabling/
-of Babel (both core functionality and language specific support).
-
-- Babel :: Babel is now part of the core of Org-mode, so it is
- now loaded along with the rest of Org-mode. That means that
- there is /no configuration/ required to enable the main
- Babel functionality. For current users, this means that
- statements like
- #+begin_src emacs-lisp
- (require 'org-babel)
- #+end_src
- or
- #+begin_src emacs-lisp
- (require 'org-babel-init)
- #+end_src
- that may by lying around in your configuration must now be
- removed.
-- load path :: Babel (including all language specific files --
- aside from those which are located in the =contrib/=
- directory for reasons of licencing) now lives in the base of
- the Org-mode lisp directory, so /no additional directories/
- need to be added to your load path to use babel. For Babel
- users this means that statements adding babel-specific
- directories to your load-path should now be removed from
- your config.
-- language support :: It is no longer necessary to require
- language specific support on a language-by-language basis.
- Specific language support should now be managed through the
- `org-babel-load-languages' variable. This variable can be
- customized using the Emacs customization interface, or
- through the addition of something like the following to your
- configuration (note: any language not mentioned will /not/
- be enabled, aside from =emacs-lisp= which is enabled by
- default)
- #+begin_src emacs-lisp
- (org-babel-do-load-languages
- 'org-babel-load-languages
- '((R . t)
- (ditaa . t)
- (dot . t)
- (emacs-lisp . t)
- (gnuplot . t)
- (haskell . nil)
- (ocaml . nil)
- (python . t)
- (ruby . t)
- (screen . nil)
- (sh . t)
- (sql . nil)
- (sqlite . t)))
- #+end_src
-
- Despite this change it is still possible to add
- language support through the use of =require=
- statements, however to conform to Emacs file-name
- regulations all Babel language files have changed
- prefix from =org-babel-*= to =ob-*=, so the require
- lines must also change e.g.
- #+begin_src emacs-lisp
- (require 'org-babel-R)
- #+end_src
- should be changed to
- #+begin_src emacs-lisp
- (require 'ob-R)
- #+end_src
-
-We have eliminated the =org-babel-tangle-w-comments= variable as
-well as the two main internal lists of languages, namely
-- =org-babel-interpreters= and
-- =org-babel-tangle-langs=
-
-so any config lines which mention those variables, can/should be
-stripped out in their entirety. This includes any calls to the
-=org-babel-add-interpreter= function, whose sole purpose was to
-add languages to the =org-babel-interpreters= variable.
-
-With those calls stripped out, we may still in some cases want to
-associate a file name extension with certain languages, for
-example we want all of our emacs-lisp files to end in a =.el=, we
-can do this will the =org-babel-tangle-lang-exts= variable. In
-general you shouldn't need to touch this as it already has
-defaults for most common languages, and if a language is not
-present in org-babel-tangle-langs, then babel will just use the
-language name, so for example a file of =c= code will have a =.c=
-extension by default, shell-scripts (identified with =sh=) will
-have a =.sh= extension etc...
-
-The configuration of /shebang/ lines now lives in header
-arguments. So the shebang for a single file can be set at the
-code block level, e.g.
-
-#+begin_src org
- ,#+begin_src clojure :shebang #!/usr/bin/env clj
- , (println "with a shebang line, I can be run as a script!")
- ,#+end_src
-#+end_src
-
-Note that whenever a file is tangled which includes a /shebang/
-line, Babel will make the file executable, so there is good
-reason to only add /shebangs/ at the source-code block level.
-However if you're sure that you want all of your code in some
-language (say shell scripts) to tangle out with shebang lines,
-then you can customize the default header arguments for that
-language, e.g.
-
-#+begin_src emacs-lisp
- ;; ensure this variable is defined defined
- (unless (boundp 'org-babel-default-header-args:sh)
- (setq org-babel-default-header-args:sh '()))
-
- ;; add a default shebang header argument
- (add-to-list 'org-babel-default-header-args:sh
- '(:shebang . "#!/bin/bash"))
-#+end_src
-
-The final important change included in this release is the
-addition of new security measures into Babel. These measures are
-in place to protect users from the accidental or uninformed
-execution of code. Along these lines /every/ execution of a code
-block will now require an explicit confirmation from the user.
-These confirmations can be stifled through customization of the
-`org-confirm-babel-evaluate' variable, e.g.
-#+begin_src emacs-lisp
- ;; I don't want to be prompted on every code block evaluation
- (setq org-confirm-babel-evaluate nil)
-#+end_src
-
-In addition, it is now possible to remove code block evaluation
-form the =C-c C-c= keybinding. This can be done by setting the
-=org-babel-no-eval-on-ctrl-c-ctrl-c= variable to a non-nil value,
-e.g.
-#+begin_src emacs-lisp
- ;; I don't want to execute code blocks with C-c C-c
- (setq org-babel-no-eval-on-ctrl-c-ctrl-c t)
-#+end_src
-
-An additional keybinding has been added for code block
-evaluation, namely =C-c C-v e=.
-
-Whew! that seems like a lot of effort for a /simplification/ of
-configuration.
-
-*** New keys for TODO sparse trees
-
-The key =C-c C-v= is now reserved for Org Babel action. TODO
-sparse trees can still be made with =C-c / t= (all not-done
-states) and =C-c / T= (specific states).
-
-*** Customizable variable changes for DocBook exporter
-
-To make it more flexible for users to provide DocBook exporter
-related commands, we start to use format-spec to format the
-commands in this release. If you use DocBook exporter and use it
-to export Org files to PDF and/or FO format, the settings of the
-following two customizable variables need to be changed:
-
-- =org-export-docbook-xslt-proc-command=
-- =org-export-docbook-xsl-fo-proc-command=
-
-Instead of using =%s= in the format control string for all
-arguments, now we use /three/ different format spec characters:
-
-- =%i=: input file argument
-- =%o=: output file argument
-- =%s=: XSLT stylesheet argument
-
-For example, if you set =org-export-docbook-xslt-proc-command= to
-
-: java com.icl.saxon.StyleSheet -o %s %s /path/to/docbook.xsl
-
-in the past, now you need to change it to
-
-: java com.icl.saxon.StyleSheet -o %o %i %s
-
-and set a new customizable variable called
-=org-export-docbook-xslt-stylesheet= to =/path/to/docbook.xsl=.
-
-Please check the documentation of these two variables for more
-details and other examples.
-
-Along with the introduction of variable
-=org-export-docbook-xslt-stylesheet=, we also added a new
-in-buffer setting called =#+XSLT:=. You can use this setting to
-specify the XSLT stylesheet that you want to use on a per-file
-basis. This setting overrides
-=org-export-docbook-xslt-stylesheet=.
+ Thanks to Michael Brand for a patch to this effect.
-** Details
+*** Spreadsheet computation of durations and time values
+ :PROPERTIES:
+ :OrgVersion: 7.6
+ :END:
-*** Org Babel is now part of the Org core
-See [[#ob-configuration-changes][Org-babel configuration changes]] for instructions on how to
-update your babel configuration.
+ If you want to compute time values use the =T= flag, either in Calc
+ formulas or Elisp formulas:
-The most significant result of this change is that Babel now has
-documentation! It is part of Org-mode's documentation, see
-Chapter 14 [[http://orgmode.org/manual/Working-with-source-code.html#Working-with-source-code][Working With Source Code]]. The Babel keybindings
-are now listed in the refcard, and can be viewed from any
-Org-mode buffer by pressing =C-c C-v h=. In addition this
-integration has included a number of bug fixes, and a significant
-amount of internal code cleanup.
+ | Task 1 | Task 2 | Total |
+ |--------+--------+---------|
+ | 35:00 | 35:00 | 1:10:00 |
+ #+TBLFM: @2$3=$1+$2;T
-*** The default capture system for Org mode is now called org-capture
+ Values must be of the form =[HH:]MM:SS=, where hours are optional.
-This replaces the earlier system org-remember. The manual only
-describes org-capture, but for people who prefer to continue to
-use org-remember, we keep a static copy of the former manual
-section [[http://orgmode.org/org-remember.pdf][chapter about remember]].
+ Thanks to Martin Halder, Eric Schulte and Carsten for code and feedback
+ on this.
-The new system has a technically cleaner implementation and more
-possibilities for capturing different types of data. See
-[[http://thread.gmane.org/gmane.emacs.orgmode/26441/focus%3D26441][Carsten's announcement]] for more details.
+*** Implement formulas applying to field ranges
+ :PROPERTIES:
+ :OrgVersion: 7.5
+ :END:
+
+ Carsten implemented this field-ranges formulas.
+
+ : A frequently requested feature for tables has been to be able to define
+ : row formulas in a way similar to column formulas. The patch below allows
+ : things like
+ :
+ : @3=
+ : @2$2..@5$7=
+ : @I$2..@II$4=
+ :
+ : as the left hand side for table formulas in order to write a formula that
+ : is valid for an entire column or for a rectangular section in a
+ : table.
+
+ Thanks a lot to Carsten for this.
-To switch over to the new system:
+*** Sending radio tables from org buffers is now allowed
+ :PROPERTIES:
+ :OrgVersion: 7.4
+ :END:
-1. Run
+ Org radio tables can no also be sent inside Org buffers. Also, there
+ is a new hook which get called after a table has been sent.
- : M-x org-capture-import-remember-templates RET
+ Thanks to Seweryn Kokot.
- to get a translated version of your remember templates into the
- new variable =org-capture-templates=. This will "mostly" work,
- but maybe not for all cases. At least it will give you a good
- place to modify your templates. After running this command,
- enter the customize buffer for this variable with
+** Lists
- : M-x customize-variable RET org-capture-templates RET
+*** Improved handling of lists
+ :PROPERTIES:
+ :OrgVersion: 7.5
+ :END:
- and convince yourself that everything is OK. Then save the
- customization.
+ Nicolas Goaziou extended and improved the way Org handles lists.
-2. Bind the command =org-capture= to a key, similar to what you did
- with org-remember:
+ 1. Indentation of text determines again end of items in lists. So, some
+ text less indented than the previous item doesn't close the whole
+ list anymore, only all items more indented than it.
- : (define-key global-map "\C-cc" 'org-capture)
+ 2. Alphabetical bullets are implemented, through the use of the
+ variable `org-alphabetical-lists'. This also adds alphabetical
+ counters like [@c] or [@W].
- If your fingers prefer =C-c r=, you can also use this key once
- you have decided to move over completely to the new
- implementation. During a test time, there is nothing wrong
- with using both system in parallel.
+ 3. Lists can now safely contain drawers, inline tasks, or various
+ blocks, themselves containing lists. Two variables are controlling
+ this: `org-list-forbidden-blocks', and `org-list-export-context'.
-*** Implement pretty display of entities, sub-, and superscripts.
+ 4. Improve `newline-and-indent' (C-j): used in an item, it will keep
+ text from moving at column 0. This allows to split text and make
+ paragraphs and still not break the list.
-The command =C-c C-x \= toggles the display of Org's special
-entities like =\alpha= as pretty unicode characters. Also, sub
-and superscripts are displayed in a pretty way (raised/lower
-display, in a smaller font). If you want to exclude sub- and
-superscripts, see the variable
-=org-pretty-entities-include-sub-superscripts=.
+ 5. Improve `org-toggle-item' (C-c -): used on a region with standard
+ text, it will change the region into one item. With a prefix
+ argument, it will fallback to the previous behavior and make every
+ line in region an item. It permits to easily integrate paragraphs
+ inside a list.
-Thanks to Eric Schulte and Ulf Stegeman for making this possible.
+ 6. `fill-paragraph' (M-q) now understands lists. It can freely be used
+ inside items, or on text just after a list, even with no blank line
+ around, without breaking list structure.
-*** Help system for finding entities
+ Thanks a lot to Nicolas for all this!
-The new command =M-x org-entities-help= creates a structured
-buffer that lists all entities available in Org. Thanks to Ulf
-Stegeman for adding the necessary structure to the internal
-entity list.
+** Inline display of linked images
+ :PROPERTIES:
+ :OrgVersion: 6.36
+ :END:
-*** New module to create Gantt charts
+ Images can now be displayed inline. The key C-c C-x C-v does toggle the
+ display of such images. Note that only image links that have no
+ description part will be inlined.
-Christian Egli's /org-taskjuggler.el/ module is now part of Org.
-He also wrote a [[http://orgmode.org/worg/org-tutorials/org-taskjuggler.php][tutorial]] for it.
+** Implement offsets for ordered lists
+ :PROPERTIES:
+ :OrgVersion: 6.36
+ :END:
-*** Refile targets can now be cached
+ If you want to start an ordered plain list with a number different from
+ 1, you can now do it like this:
-You can turn on caching of refile targets by setting the variable
-=org-refile-use-cache=. This should speed up refiling if you
-have many eligible targets in many files. If you need to update
-the cache because Org misses a newly created entry or still
-offers a deleted one, press =C-0 C-c C-w=.
+ : 1. [@start:12] will star a lit a number 12
-*** Enhanced functionality of the clock resolver
+** Babel: code block body expansion for table and preview
+ :PROPERTIES:
+ :OrgVersion: 6.36
+ :END:
-Here are the new options for the clock resolver:
+ In org-babel, code is "expanded" prior to evaluation. I.e. the code that
+ is actually evaluated comprises the code block contents, augmented with
+ the extra code which assigns the referenced data to variables. It is now
+ possible to preview expanded contents, and also to expand code during
+ during tangling. This expansion takes into account all header arguments,
+ and variables.
-: i/q/C-g Ignore this question; the same as keeping all the idle time.
-:
-: k/K Keep X minutes of the idle time (default is all). If this
-: amount is less than the default, you will be clocked out
-: that many minutes after the time that idling began, and then
-: clocked back in at the present time.
-: g/G Indicate that you \"got back\" X minutes ago. This is quite
-: different from 'k': it clocks you out from the beginning of
-: the idle period and clock you back in X minutes ago.
-: s/S Subtract the idle time from the current clock. This is the
-: same as keeping 0 minutes.
-: C Cancel the open timer altogether. It will be as though you
-: never clocked in.
-: j/J Jump to the current clock, to make manual adjustments.
-
-For all these options, using uppercase makes your final state
-to be CLOCKED OUT. Thanks to John Wiegley for making these
-changes.
+ A new key-binding `C-c M-b p' bound to `org-babel-expand-src-block' can
+ be used from inside of a source code block to preview its expanded
+ contents (which can be very useful for debugging). tangling
-*** A property value of "nil" now means to unset a property
+ The expanded body can now be tangled, this includes variable values
+ which may be the results of other source-code blocks, or stored in
+ headline properties or tables. One possible use for this is to allow
+ those using org-babel for their emacs initialization to store values
+ (e.g. usernames, passwords, etc...) in headline properties or in tables.
-This can be useful in particular with property inheritance, if
-some upper level has the property, and some grandchild of it
-would like to have the default settings (i.e. not overruled by a
-property) back.
+ Org-babel now supports three new header arguments, and new default
+ behavior for handling horizontal lines in tables (hlines), column names,
+ and rownames across all languages.
-Thanks to Robert Goldman and Bernt Hansen for suggesting this
-change.
+** Editing Convenience and Appearance
-*** The problem with comment syntax has finally been fixed
+*** New command =org-copy-visible= (=C-c C-x v=)
+ :PROPERTIES:
+ :OrgVersion: 7.7
+ :END:
-Thanks to Leo who has been on a year-long quest to get this fixed
-and finally found the right way to do it.
+ This command will copy the visible text in the region into the kill
+ ring. Thanks to Florian Beck for this function and to Carsten for
+ adding it to org.el and documenting it!
*** Make it possible to protect hidden subtrees from being killed by =C-k=
+ :PROPERTIES:
+ :OrgVersion: 7.01
+ :END:
-This was a request by Scott Otterson.
-See the new variable =org-ctrl-k-protect-subtree=.
-
-*** New module org-mac-link-grabber.el
-
-This module allows to grab links to all kinds of applications on
-a mac. It is available in the contrib directory.
-
-Thanks to Anthony Lander for this contribution.
-
-*** LaTeX export: Implement table* environment for wide tables
-
-Thanks to Chris Gray for a patch to this effect.
-
-*** When cloning entries, remove or renew ID property
-
-Thanks to David Maus for this change.
-
-* Version 6.36
-
-** Details
-*** Inline display of linked images
-
-Images can now be displayed inline. The key C-c C-x C-v does toggle the
-display of such images. Note that only image links that have no
-description part will be inlined.
-
-*** Implement offsets for ordered lists
-
-If you want to start an ordered plain list with a number different from 1,
-you can now do it like this:
-
-: 1. [@start:12] will star a lit a number 12
-
-*** Extensions to storing and opening links to Wanderlust messages
+ See the new variable =org-ctrl-k-protect-subtree=. This was a request
+ by Scott Otterson.
-- Remove filter conditions for messages in a filter folder
-
- If customization variable `org-wl-link-remove-filter' is non-nil, filter
- conditions are stripped of the folder name.
-
-- Create web links for messages in a Shimbun folder
-
- If customization variable `org-wl-shimbun-prefer-web-links' is non-nil,
- calling `org-store-link' on a Shimbun message creates a web link to the
- messages source, indicated in the Xref: header field.
-
-- Create web links for messages in a nntp folder
-
- If customization variable `org-wl-nntp-prefer-web-links' is non-nil,
- calling `org-store-link' on a nntp message creates a web link either to
- gmane.org if the group can be read trough gmane or to googlegroups
- otherwise. In both cases the message-id is used as reference.
-
-- Open links in namazu search folder
-
- If `org-wl-open' is called with one prefix, WL opens a namazu search
- folder for message's message-id using `org-wl-namazu-default-index' as
- search index. If this variable is nil or `org-wl-open' is called with
- two prefixes Org asks for the search index to use.
-
-Thanks to David Maus for these changes.
-
-*** Org-babel: code block body expansion for table and preview
-
-In org-babel, code is "expanded" prior to evaluation. I.e. the code that is
-actually evaluated comprises the code block contents, augmented with the
-extra code which assigns the referenced data to variables. It is now
-possible to preview expanded contents, and also to expand code during
-during tangling. This expansion takes into account all header arguments,
-and variables.
-
-A new key-binding C-c M-b p bound to `org-babel-expand-src-block' can be
-used from inside of a source code block to preview its expanded contents
-(which can be very useful for debugging). tangling
-
-The expanded body can now be tangled, this includes variable values which
-may be the results of other source-code blocks, or stored in headline
-properties or tables. One possible use for this is to allow those using
-org-babel for their emacs initialization to store values (e.g. usernames,
-passwords, etc…) in headline properties or in tables.
-
-Org-babel now supports three new header arguments, and new default behavior
-for handling horizontal lines in tables (hlines), column names, and
-rownames across all languages.
-
-* Version 6.35
-
-** Incompatible Changes
-
-*** Changes to the intended use of =org-export-latex-classes=
+*** Implement pretty display of entities, sub-, and superscripts.
+ :PROPERTIES:
+ :OrgVersion: 7.01
+ :END:
-So far this variable has been used to specify the complete header of the
-LaTeX document, including all the =\usepackage= calls necessary for the
-document. This setup makes it difficult to maintain the list of packages
-that Org itself would like to call, for example for the special symbol
-support it needs. Each time I have to add a package, I have to ask people
-to revise the configuration of this variable. In this release, I have
-tried to fix this.
+ The command =C-c C-x \= toggles the display of Org's special entities
+ like =\alpha= as pretty unicode characters. Also, sub and superscripts
+ are displayed in a pretty way (raised/lower display, in a smaller
+ font). If you want to exclude sub- and superscripts, see the variable
+ =org-pretty-entities-include-sub-superscripts=.
-First of all, you can *opt out of this change* in the following way: You
-can say: /I want to have full control over headers, and I will take
-responsibility to include the packages Org needs/. If that is what you
-want, add this to your configuration and skip the rest of this section
-(except maybe for the description of the =[EXTRA]= place holder):
+ Thanks to Eric Schulte and Ulf Stegeman for making this possible.
-#+begin_src emacs-lisp
- (setq org-export-latex-default-packages-alist nil
- org-export-latex-packages-alist nil)
-#+end_src
-
-/Continue to read here if you want to go along with the modified
-setup./
-
-There are now two variables that should be used to list the LaTeX
-packages that need to be included in all classes. The header
-definition in =org-export-latex-classes= should then not contain
-the corresponding =\usepackage= calls (see below).
-
-The two new variables are:
-
-1. =org-export-latex-default-packages-alist= :: This is the
- variable where Org-mode itself puts the packages it needs.
- Normally you should not change this variable. The only
- reason to change it anyway is when one of these packages
- causes a conflict with another package you want to use.
- Then you can remove that packages and hope that you are not
- using Org-mode functionality that needs it.
-
-2. =org-export-latex-packages-alist= :: This is the variable
- where you can put the packages that you'd like to use across
- all classes. For example, I am putting =amsmath= and =tikz=
- here, because I always want to have them.
-
-The sequence how these customizations will show up in the LaTeX
-document are:
-1. Header from =org-export-latex-classes=
-2. =org-export-latex-default-packages-alist=
-3. =org-export-latex-packages-alist=
-4. Buffer-specific things set with =#+LaTeX_HEADER:=
-
-If you want more control about which segment is placed where, or
-if you want, for a specific class, have full control over the
-header and exclude some of the automatic building blocks, you can
-put the following macro-like place holders into the header:
-
-#+begin_example
-[DEFAULT-PACKAGES] \usepackage statements for default packages
-[NO-DEFAULT-PACKAGES] do not include any of the default packages
-[PACKAGES] \usepackage statements for packages
-[NO-PACKAGES] do not include the packages
-[EXTRA] the stuff from #+LaTeX_HEADER
-[NO-EXTRA] do not include #+LaTeX_HEADER stuff
-#+end_example
-
-If you have currently customized =org-export-latex-classes=, you
-should revise that customization and remove any package calls that
-are covered by =org-export-latex-default-packages-alist=. This
-applies to the following packages:
-
-- inputenc
-- fontenc
-- fixltx2e
-- graphicx
-- longtable
-- float
-- wrapfig
-- soul
-- t1enc
-- textcomp
-- marvosym
-- wasysym
-- latexsym
-- amssymb
-- hyperref
-
-If one of these packages creates a conflict with another package
-you are using, you can remove it from
-=org-export-latex-default-packages-alist=. But then you risk
-that some of the advertised export features of Org will not work
-properly.
-
-You can also consider moving packages that you use in all classes
-to =org-export-latex-packages-alist=. If necessary, put the
-place holders so that the packages get loaded in the right
-sequence. As said above, for backward compatibility, if you omit
-the place holders, all the variables will dump their content at
-the end of the header.
-
-Damn, this has become more complex than I wanted it to be. I
-hope that in practice, this will not be complicated at all.
-
-*** The constant =org-html-entities= is obsolete
-
-Its content is now part of the new constant =org-entities=, which
-is defined in the file org-entities.el. =org-html-entities= was
-an internal variable, but it is possible that some users did
-write code using it - this is why I am mentioning it here.
-
-** Editing Convenience and Appearance
+*** New faces for title, date, author and email address lines
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-*** New faces for title, date, author and email address lines.
+ The keywords in these lines are now dimmed out, and the title is
+ displayed in a larger font, and a special font is also used for author,
+ date, and email information. This is implemented by the following new
+ faces:
-The keywords in these lines are now dimmed out, and the title is
-displayed in a larger font, and a special font is also used for
-author, date, and email information. This is implemented by the
-following new faces:
+ =org-document-title=
+ =org-document-info=
+ =org-document-info-keyword=
-org-document-title
-org-document-info
-org-document-info-keyword
+ In addition, the variable =org-hidden-keywords= can be used to make the
+ corresponding keywords disappear.
-In addition, the variable =org-hidden-keywords= can be used to
-make the corresponding keywords disappear.
-
-Thanks to Dan Davison for this feature.
+ Thanks to Dan Davison for this feature.
*** Simpler way to specify faces for tags and todo keywords
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-The variables =org-todo-keyword-faces=, =org-tag-faces=, and
-=org-priority-faces= now accept simple color names as
-specifications. The colors will be used as either foreground or
-background color for the corresponding keyword. See also the
-variable =org-faces-easy-properties=, which governs which face
-property is affected by this setting.
+ The variables =org-todo-keyword-faces=, =org-tag-faces=, and
+ =org-priority-faces= now accept simple color names as specifications.
+ The colors will be used as either foreground or background color for
+ the corresponding keyword. See also the variable
+ =org-faces-easy-properties=, which governs which face property is
+ affected by this setting.
-This is really a great simplification for setting keyword faces.
-The change is based on an idea and patch by Ryan Thompson.
+ This is really a great simplification for setting keyword faces. The
+ change is based on an idea and patch by Ryan Thompson.
*** <N> in tables now means fixed width, not maximum width
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-Requested by Michael Brand.
+ Requested by Michael Brand.
*** Better level cycling function
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-=TAB= in an empty headline cycles the level of that headline
-through likely states. Ryan Thompson implemented an improved
-version of this function, which does not depend upon when exactly
-this command is used. Thanks to Ryan for this improvement.
+ =TAB= in an empty headline cycles the level of that headline through
+ likely states. Ryan Thompson implemented an improved version of this
+ function, which does not depend upon when exactly this command is used.
+ Thanks to Ryan for this improvement.
*** Adaptive filling
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-For paragraph text, =org-adaptive-fill-function= did not handle the
-base case of regular text which needed to be filled. This is now
-fixed. Among other things, it allows email-style ">" comments
-to be filled correctly.
+ For paragraph text, =org-adaptive-fill-function= did not handle the
+ base case of regular text which needed to be filled. This is now
+ fixed. Among other things, it allows email-style ">" comments to be
+ filled correctly.
-Thanks to Dan Hackney for this patch.
+ Thanks to Dan Hackney for this patch.
*** `org-reveal' (=C-c C-r=) also decrypts encrypted entries (org-crypt.el)
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-Thanks to Richard Riley for triggering this change.
+ Thanks to Richard Riley for triggering this change.
*** Better automatic letter selection for TODO keywords
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-When all first letters of keywords have been used, Org now assigns
-more meaningful characters based on the keywords.
-
-Thanks to Mikael Fornius for this patch.
-
-** Export
-
-*** Much better handling of entities for LaTeX export
-
-Special entities like =\therefore= and =\alpha= now know if
-they need to be in LaTeX math mode and are formatted accordingly.
-
-Thanks to Ulf Stegemann for the tedious work to make this
-possible.
-
-*** LaTeX export: Set coding system automatically
-
-The coding system of the LaTeX class will now be set to the value
-corresponding to the buffer's file coding system. This happens
-if your setup sets up the file to have a line
-=\usepackage[AUTO]{inputenc}= (the default setup does this).
-
-*** New exporters to Latin-1 and UTF-8
-
-While Ulf Stegemann was going through the entities list to
-improve the LaTeX export, he had the great idea to provide
-representations for many of the entities in Latin-1, and for all
-of them in UTF-8. This means that we can now export files rich
-in special symbols to Latin-1 and to UTF-8 files. These new
-exporters can be reached with the commands =C-c C-e n= and =C-c
-C-e u=, respectively.
-
-When there is no representation for a given symbol in the
-targeted coding system, you can choose to keep the TeX-macro-like
-representation, or to get an "explanatory" representation. For
-example, =\simeq= could be represented as "[approx. equal to]".
-Please use the variable =org-entities-ascii-explanatory= to state
-your preference.
-
-*** Full label/reference support in HTML, Docbook, and LaTeX backends
-
-=#+LABEL= definitions for tables and figures are now fully
-implemented in the LaTeX, Docbook, and HTML interfaces.
-=\ref{xxx}= is expanded to a valid link in all backends.
-
-*** BEAMER export: Title of the outline frame is now customizable
-
-The new option =org-outline-frame-title= allows to set the
-title for outline frames in Beamer presentations.
-
-Patch by Łukasz Stelmach.
-
-*** BEAMER export: fragile frames are better recognized
-
-A =lstlisting= environment now also triggers the fragile option in
-a beamer frame, just like =verbatim= environments do.
-
-Thanks to Eric Schulte for this patch.
+ When all first letters of keywords have been used, Org now assigns more
+ meaningful characters based on the keywords.
-*** BEAMER export: Protect <...> macro arguments
+ Thanks to Mikael Fornius for this patch.
-Macros for the BEAMER package can have arguments in angular
-brackets. These are now protected just like normal arguments.
-
-Requested by Bill Jackson.
-
-*** HTML export: Add class to outline containers using property
-
-The =HTML_CONTAINER_CLASS= property can now be used to add a
-class name to the outline container of a node in HTML export.
-
-*** New option =org-export-email-info= to turn off export of the email address
-
-Default is actually off now.
-
-*** Throw an error when creating an image from a LaTeX snippet fails
-
-This behavior can be configured with the new option variable
-=org-format-latex-signal-error=.
-
-** Index generation
-
-Org-mode can now produce a 2-level subject index spanning an
-entire publishing project. Write index entries in your files as
-
-#+begin_src org
-,* What is org-mode?
-#+index: Org-mode
-#+index: Definitions!Org-mode
-#+end_src
-
-where the first line will produce an index entry /Org-mode/,
-while the second line will create /Definitions/ with a sub-item
-/Org-mode/. Three-level entries are not supported.
-
-To produce the index, set
-
-#+begin_src emacs-lisp
-:makeindex t
-#+end_src
-
-in the project definition in =org-publish-project-alist=. You
-may have to force re-export of all files to get the index by
-using a =C-u= prefix to the publishing command:
-
-#+begin_example
-C-u M-x org-publish-all
-#+end_example
-
-Whenever an Org file is published in this project, a new file
-with the extension "orgx" will be written. It contains the index
-entries and corresponding jump target names. When all project
-files are published, Org will produce a new file "theindex.inc"
-containing the index as a to-level tree. This file can be
-included into any project file using
-
-#+begin_src org
- ,#+include: "theindex.inc"
-#+end_src
-
-Org-mode will also create a file "theindex.org" with this include
-statement, and you can build a more complex structure (for
-example style definitions, top and home links, etc) around this
-statement. When this file already exists, it will not be
-overwritten by Org.
-
-Thanks to Stefan Vollmar for initiating and driving this feature.
-
-*** TODO Still need to do the LaTeX portion
-
-** MobileOrg
-
-*** Encrypting stage files for MobileOrg
-
-Since the use of (often pubic) servers is needed for MobileOrg,
-it is now possible to encrypt the files to be staged for
-MobileOrg. Version 1.2 of MobileOrg will be needed for this
-feature, and Richard Moreland will show instructions on his
-website once that is available. Basically, on the Org-side this
-will require the following settings:
-
-#+begin_src emacs-lisp
- (setq org-mobile-use-encryption t
- org-mobile-encryption-password "My_MobileOrg_Password")
-#+end_src
-
-So the password will be visible in your local setup, but since
-the encryption is only for the public server, this seems
-acceptable.
-
-** Agenda
-
-*** Specify entry types as an option
-
-Custom Agenda commands can now limit the sets of entry types
-considered for this command by binding =org-agenda-entry-types=
-temporarily in the options section of the command. This can lead
-to significant speedups, because instead of laboriously finding
-entries and then rejecting them, a whole search cycle is skipped.
-For more information see the new section in
-[[http://orgmode.org/worg/org-tutorials/org-custom-agenda-commands.php#sec-5][Matt Lundin's agenda custom command tutorial]].
-
-Thanks to Matt Lundin for this feature.
-
-*** Speed up multiple calls to org-diary by only doing buffer prep once
-
-Also a patch by Matt Lundin.
-
-*** Show and hide deadlines in the agenda
-
-You can now hide all deadline entries in the agenda by pressing
-=!=.
-
-Thanks to John Wiegley for this feature.
-
-*** Agenda: Allow to suppress deadline warnings for entries also scheduled
-
-The the docstring of the variable
-=org-agenda-skip-deadline-prewarning-if-scheduled=.
-
-*** Expand file names in org-agenda-files (external file case)
-
-If you are using a file to manage the list of agenda files, the
-names in this file can now contain environment variables and "~"
-to write them more compactly and portable.
-
-Thanks to Mikael Fornius for a patch to this effect.
-
-*** Agenda: Allow TODO conditions in the skip functions
-
-The agenda skip function has now special support for skipping
-based on the TODO state. Here are just two examples, see the
-manual for more information.
-
-#+begin_src emacs-lisp
-(org-agenda-skip-entry-if 'todo '(\"TODO\" \"WAITING\"))
-(org-agenda-skip-entry-if 'nottodo 'done)
-#+end_src
-
-Thanks to Łukasz Stelmach for this patch.
-
-*** Extracting the time-of-day when adding diary entries
-
-The time of day can now be extracted from new diary entries made
-from the agenda with (for example) =i d=. When
-=org-agenda-insert-diary-extract-time= is set, this is done, and
-the time is moved into the time stamp.
-
-Thanks to Stephen Eglen for this feature.
-
-*** The customization group org-font-lock has been renamed
-
-The new name is `org-appearance'.
-
-Thanks to Dan Davison for a patch to this effect.
-
-*** The TODO list: Allow skipping scheduled or deadlined entries
-
-Skipping TODO entries in the global TODO list based on whether
-they are scheduled or have a deadline can now be controlled in
-more detail. Please see the docstrings of
-=org-agenda-todo-ignore-scheduled= and
-=org-agenda-todo-ignore-deadline=.
-
-Thanks to Łukasz Stelmach for patches to this effect.
-
-** Hyperlinks
-
-*** Make =org-store-link= point to directory in a dired buffer
-
-When, in a dired buffer, the cursor is not in a line listing a
-file, `org-store-link' will store a link to the directory.
-
-Patch by Stephen Eglen.
-
-*** Allow regexps in =org-file-apps= to capture link parameters
+** Clocking
-The way extension regexps in =org-file-apps= are handled has
-changed. Instead of matching against the file name, the regexps
-are now matched against the whole link, and you can use grouping
-to extract link parameters which you can then use in a command
-string to be executed.
+*** Clock: Allow synchronous update of timestamps in CLOCK log
+ :PROPERTIES:
+ :OrgVersion: 7.7
+ :END:
-For example, to allow linking to PDF files using the syntax
-=file:/doc.pdf::<page number>=, you can add the following entry to
-org-file-apps:
+ Using =S-M-<up/down>= on CLOCK log timestamps will increase/decrease
+ the two timestamps on this line so that duration will keep the same.
+ Note that duration can still be slightly modified in case a timestamp
+ needs some rounding.
-#+begin_example
-Extension: \.pdf::\([0-9]+\)\'
-Command: evince "%s" -p %1
-#+end_example
+ Thanks to Rainer Stengele for this idea.
-Thanks to Jan Böcker for a patch to this effect.
+*** Localized clock tables
+ :PROPERTIES:
+ :OrgVersion: 7.5
+ :END:
-** Clocking
+ Clock tables now support a new new =:lang= parameter, allowing the user
+ to customize the localization of the table headers. See the variable
+ =org-clock-clocktable-language-setup= which controls available
+ translated strings.
*** Show clock overruns in mode line
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-When clocking an item with a planned effort, overrunning the
-planned time is now made visible in the mode line, for example
-using the new face =org-mode-line-clock-overrun=, or by adding an
-extra string given by =org-task-overrun-text=.
-
-Thanks to Richard Riley for a patch to this effect.
+ When clocking an item with a planned effort, overrunning the planned
+ time is now made visible in the mode line, for example using the new
+ face =org-mode-line-clock-overrun=, or by adding an extra string given
+ by =org-task-overrun-text=.
-** Tables
+ Thanks to Richard Riley for a patch to this effect.
-*** Repair the broken support for table.el tables again.
+*** Clock reports can now include the running, incomplete clock
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-Tables created with the table.el package now finally work again
-in Org-mode. While you cannot edit the table directly in the
-buffer, you can use =C-c '= to edit it nicely in a temporary
-buffer.
+ If you have a clock running, and the entry being clocked falls into the
+ scope when creating a clock table, the time so far spent can be added
+ to the total. This behavior depends on the setting of
+ =org-clock-report-include-clocking-task=. The default is =nil=.
-Export of these tables to HTML seem to work without problems.
-Export to LaTeX is imperfect. If fails if the table contains
-special characters that will be replaced by the exporter before
-formatting the table. The replacement operation changes the
-length of some lines, breaking the alignment of the table fields.
-Unfortunately this is not easy to fix. It is also not an option
-to not do these replacements. The table.el LaTeX exporter will
-for example not escape "&" in table fields, causing the exported
-tables to be broken.
+ Thanks to Bernt Hansen for this useful addition.
** Misc
-*** New logging support for refiling
-
-Whenever you refile an item, a time stamp and even a note can be
-added to this entry. For details, see the new option
-=org-log-refile=.
+*** Improvements with inline tasks and indentation
+ :PROPERTIES:
+ :OrgVersion: 7.4
+ :END:
-Thanks to Charles Cave for this idea.
+ There is now a configurable way on how to export inline tasks. See the
+ new variable =org-inlinetask-export-templates=.
-*** New helper functions in org-table.el
+ Thanks to Nicolas Goaziou for coding these changes.
-There are new functions to access and write to a specific table
-field. This is for hackers, and maybe for the org-babel people.
+*** A property value of "nil" now means to unset a property
+ :PROPERTIES:
+ :OrgVersion: 7.01
+ :END:
-#+begin_example
-org-table-get
-org-table-put
-org-table-current-line
-org-table-goto-line
-#+end_example
+ This can be useful in particular with property inheritance, if some
+ upper level has the property, and some grandchild of it would like to
+ have the default settings (i.e. not overruled by a property) back.
-*** Tables: Field coordinates for formulas, and improved docs
+ Thanks to Robert Goldman and Bernt Hansen for suggesting this change.
-Calc and Emacs-Lisp formulas for tables can access the current
-field coordinates with =@#= and =$#= for row and column,
-respectively. These can be useful in some formulas. For
-example, to sequentially number the fields in a column, use
-~=@#~ as column equation.
+*** New helper functions in org-table.el
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-One application is to copy a column from a different table. See
-the manual for details.
+ There are new functions to access and write to a specific table field.
+ This is for hackers, and maybe for the org-babel people.
-Thanks to Michael Brand for this feature.
+ #+begin_example
+ org-table-get
+ org-table-put
+ org-table-current-line
+ org-table-goto-line
+ #+end_example
*** Archiving: Allow to reverse order in target node
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-The new option =org-archive-reversed-order= allows to have
-archived entries inserted in a last-on-top fashion in the target
-node.
-
-Requested by Tom.
-
-*** Better documentation on calc accuracy in tables
-
-Thanks to Michael Brand for this fix.
-
-*** Clock reports can now include the running, incomplete clock
-
-If you have a clock running, and the entry being clocked falls
-into the scope when creating a clock table, the time so far spent
-can be added to the total. This behavior depends on the setting
-of =org-clock-report-include-clocking-task=. The default is
-=nil=.
-
-Thanks to Bernt Hansen for this useful addition.
+ The new option =org-archive-reversed-order= allows to have archived
+ entries inserted in a last-on-top fashion in the target node.
-*** American-style dates are now understood by =org-read-date=
-
-So when you are prompted for a date, you can now answer like this
-
-#+begin_example
-2/5/3 --> 2003-02-05
-2/5 --> <CURRENT-YEAR>-02-05
-#+end_example
-
-*** org-timer.el now allows just one timer
-
-There is now only a single free timer supported by org-timer.el.
-Thanks to Bastien for cleaning this up, after a bug report in
-this area by Frédéric Couchet.
-
-*** Remember: Allow to file as sibling of current clock
-
-=C-3 C-c C-c= will file the remember entry as a sibling of the
-last filed entry.
-
-Patch by Łukasz Stelmach.
+ This was requested by Tom.
*** Org-reveal: Double prefix arg shows the entire subtree of the parent
+ :PROPERTIES:
+ :OrgVersion: 6.35
+ :END:
-This can help to get out of an inconsistent state produced for
-example by viewing from the agenda.
-
-This was a request by Matt Lundin.
-
-*** Add org-secretary.el by Juan Reyero to the contrib directory
-
-org-secretary.el is a possible setup for group work using
-Org-mode.
-
-Thanks to Juan Reyero for this contribution.
-
-** Babel
-
-Eric and Dan have compiled the following list of changes in and
-around org-babel.
-
-- Added support for Matlab and Octave.
-- Added support for C and C++ code blocks.
-- Added support for the Oz programming language.
- Thanks to Torsten Anders for this contribution
-- Can now force literal interpretation of table cell contents
- with extra "$" in table formula.
- Thanks to Maurizio Vitale for this suggestion.
-- Variable references which look like lisp forms are now
- evaluated.
-- No longer adding extension during tangling when filename is
- provided.
- Thanks to Martin G. Skjæveland and Nicolas Girard for prompting this.
-- Added `org-babel-execute-hook' which runs after code block
- execution.
-- Working directories and remote execution
-
- This introduces a new header argument :dir. For the duration of
- source block execution, default-directory is set to the value
- of this header argument. Consequences include:
-
- - external interpreter processes run in that directory
- - new session processes run in that directory (but existing
- ones are unaffected)
- - relative paths for file output are relative to that directory
-
- The name of a directory on a remote machine may be specified
- with tramp syntax (/user@host:path), in which case the
- interpreter executable will be sought in tramp-remote-path, and
- if found will execute on the remote machine in the specified
- remote directory.
-- Tramp syntax can be used to tangle to remote files.
- Thanks to Maurizio Vitale and Rémi Vanicat.
-- org-R removed from contrib.
-- gnuplot can now return it's string output -- when session is
- set to "none".
-- Now including source code block arguments w/source name on
- export.
-- Now able to reference file links as results.
-- Allow pdf/png generation directly from latex source blocks
- with :file header argument.
-
-* Version 6.34
-
-** Incompatible changes
-
-*** Tags in org-agenda-auto-exclude-function must be lower case.
-
-When defining an =org-agenda-auto-exclude-function=, you need to
-be aware that tag that is being passed into the function is
-always lower case - even if it was defined in upper case
-originally.
-
-** Details
-
-*** Support for creating BEAMER presentations from Org-mode documents
-
-Org-mode documents or subtrees can now be converted directly in
-to BEAMER presentation. Turning a tree into a simple
-presentations is straight forward, and there is also quite some
-support to make richer presentations as well. See the [[http://orgmode.org/manual/Beamer-class-export.html#Beamer-class-export][BEAMER
-section]] in the manual for more details.
-
-Thanks to everyone who has contributed to the discussion about
-BEAMER support and how it should work. This was a great example
-for how this community can achieve a much better result than any
-individual could.
-
-*** Hyperlinks
-
-**** Add Paul Sexton's org-ctags.el
-
-Targets like =<<my target>>= can now be found by Emacs' etag
-functionality, and Org-mode links can be used to to link to
-etags, also in non-Org-mode files. For details, see the file
-/org-ctags.el/.
-
-This feature uses a new hook =org-open-link-functions= which will
-call function to do something special with text links.
-
-Thanks to Paul Sexton for this contribution.
-
-**** Add Jan Böcker's org-docview.el
-
-This new module allows links to various file types using docview,
-where Emacs displays images of document pages. Docview link
-types can point to a specific page in a document, for example to
-page 131 of the Org-mode manual:
-
-: [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]]
-
-Thanks to Jan Böcker for this contribution.
-
-**** New link types that force special ways of opening the file
-
-- =file+sys:/path/to/file= will use the system to open the file,
- like double-clicking would.
-- file+emacs:/path/to/file will force opening the linked file
- with Emacs.
-
-This was a request by John Wiegley.
-
-**** Open all links in a node
-
-When using =C-c C-o= on a headline to get a list of links in the
-entry, pressing =RET= will open *all* links. This allows
-something like projects to be defined, with a number of files
-that have to be opened by different applications.
-
-This was a request by John Wiegley.
-
-*** Agenda Views
-
-**** Improve the logic of the search view.
-
-The logic of search views is changed a bit. See the docstring of
-the function =or-search-view=.
-
-These changes resulted from a discussion with Matt Lundin.
-
-**** New face for entries from the Emacs diary
-
-Entries that enter the Agenda through the Emacs diary now get the
-face =org-agenda-diary=.
-
-This was a request by Thierry Volpiatto.
-
-**** New function `org-diary-class' to schedule classes with skipped weeks.
-
-This was a request by Daniel Martins.
-
-**** Empty matcher means prompt in agenda custom commands
-
-When an agenda custom command has an empty string as MATCH
-element, so far this would lead to a meaningless search using an
-empty matcher. Now an empty (or white) string will be
-interpreted just like a nil matcher, i.e. the user will be
-prompted for the match.
-
-**** Agenda: Selectively remove some tags from agenda display
-
-If you use tags very extensively, you might want to exclude some
-from being displayed in the agenda, in order to keep the display
-compact. See the new option =org-agenda-hide-tags-regexp= for
-details.
-
-This was largely a patch by Martin Pohlack.
-
-*** Export
-
-**** Direct export of only the current subtree
-
-Pressing =1= after =C-c C-e= and before the key that selects the
-export backend, only the current subtree will be exported,
-exactly as it you had selected it first with =C-c @=. So for
-example, =C-c C-e 1 b= will export the current subtree to HTML
-and open the result in the browser.
-
-**** Direct export of enclosing node
-
-Pressing =SPC= after =C-c C-e= and before the key that selects
-the export backend, the enclosing subree that is set up for
-subtree export will be exported, exactly as it you had selected
-it first with =C-c @=. So for example, =C-c C-e SPC d= will find
-the enclosing node with a LaTeX_CLASS property or an
-EXPORT_FILE_NAME property and export that.
-
-**** Caching export images
-
-Images that are created for example using LaTeX or ditaa for
-inclusion into exported files are now cached. This works by
-adding a hash to the image name, that reflects the source code
-and all relevant settings. So as long as the hash does not
-change, the image does not have to be made again. His can lead
-to a substantial reduction in export/publishing times.
-
-Thanks to Eric Schulte for a patch to this effect.
-
-**** Preserving line breaks for export no longer works
-
-ASCII export always preserves them - no other export format
-does. We had attempted to use =\obeylines= for this in LaTeX,
-but that does create too many problems.
-
-**** New symbols =\EUR= and =\checkmark=
-
-=\EUR= symbols from Marvosym package, and =\checkmark= are now
-supported symbols in Org-mode, i.e. they will be exported
-properly to the various backends.
-
-**** Allow LaTeX_CLASS_OPTIONS to set options, also from a property
-
-You can set the options to the =\documentclass= command on a
-per-file basis, using
-
-: #+LaTeX_CLASS_OPTIONS: [11pt]
-
-or on a per-tree basis using the corresponding property. The
-defined string will replace the default options entirely.
-
-**** The encoding of LaTeX files is now handled property
-
-Org now makes sure that the encoding used by the file created
-through the export mechanism is reflected correctly in the
-
-: \usepackage[CODINGSYSTEM]{inputenc}
-
-command. So as long as the =org-export-latex-classes= definition
-contains an =\usepackage[utf8]{inputenc}= statement, that
-statement will be modified so that the correct option is used.
-
-If you wan to use special encodings, for example =utf8x= instead
-of =utf8=, see the variable =org-export-latex-inputenc-alist=.
-
-This was a request by Francesco Pizzolante.
-
-*** Property API enhancements
-
-**** Make a new special property BLOCKED, indicating if entry is blocked
-
-A new special property BLOCKED returns "t" when the entry is
-blocked from switching the TODO state to a DONE state.
-
-This was a request by John Wiegley.
-
-**** New hooks for external support for allowed property values
-
-It is now possible to hook into Org in order to provide the
-allowed values for any property with a lisp function. See the
-docstring of the variable =org-property-allowed-value-functions=
-
-**** Allow unrestricted completion on properties
-
-When listing the allowed values for a property, for example with
-a =:name_ALL:= property, completion on these values enforces that
-one of the values will be chosen. Now, if you add ":ETC" to the
-list of allowed values, it will be interpreted as a switch, and
-the completion will be non-restrictive, so you can also choose to
-type a new value.
-
-*** Changes to Org-babel
-
-- The documentation for Org-babel has been drastically improved
- and is available on Worg at
- http://orgmode.org/worg/org-contrib/babel/
-- Source-code block names are now exported to HTML and LaTeX
-- Org-babel functions are now bound to keys behind a common key
- prefix (see
- http://orgmode.org/worg/org-contrib/babel/reference.php#sec-5)
-- Results are now foldable with TAB
-- Header argument values can now be lisp forms
-- Readable aliases for #+srcname: and #+resname:
-- Sha1 hash based caching of results in buffer
-- Can now index into variable values
-- org-babel-clojure now supports multiple named sessions
-
-*** Miscellaneous changes
-
-**** Make =C-c r C= customize remember templates
-
-=C-c r C= is now a shortcut for
-
-: M-x customize-variable RET org-remember-templates RET
-
-This was a proposal by Adam Spiers.
-
-**** Use John Gruber's regular expression for URL's
-
-We now use a better regexp to spot plain links in text. This
-regexp is adopted from [[http://daringfireball.net/2009/11/liberal_regex_for_matching_urls][John Gruber's blogpost]].
-
-Thanks to William Henney for the pointer.
-
-**** Implement tag completion of all tags in all agenda files
-
-The new option =org-complete-tags-always-offer-all-agenda-tags=
-makes Org complete all tags from all agenda files if non-nil.
-Usually, setting it locally to t in org-remember buffers is the
-most useful application of this new feature.
+ This can help to get out of an inconsistent state produced for example
+ by viewing from the agenda.
-Thanks to Tassilo Horn for a patch to this effect.
+ This was a request by Matt Lundin.