Re: Release 7.5

[Carsten Dominik <carsten.dominik@gmail.com>]

This is great.  Congratulations to Bastien for getting
to his first release so quickly!  And thanks to everyone else.
All this does make me very happy.

- Carsten

On Mar 7, 2011, at 3:42 PM, Bastien wrote:

> Dear all,
> 
> here it is, release 7.5, my first release as Org's new maintainer.
> 
> This release comes with lots of new features, bug fixes, and fun.
> Special thanks to everyone who helped for this work: it's becoming 
> hard to mention all the contributors, whether it be ideas, feedback
> or code, and sorry in advance if I forgot some names.
> 
> Also don't forget the website now comes with a flatter button, on
> top of the paypal donation link.  Spread the world!
> 
> As always:  *Enjoy* :)
> 
> 
> 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.
> 
>  (a b c)  
> 
>  $data
> 
> 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 or .
> 
> 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.
> 
> 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.
> 
> 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 
> ~~~~~~~~~~~~~~~~~~~~~~~
> 
> David Maus worked on `org-link-escape'.  See [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
> in link target oder description) or are not allowed to appear in
> a particular link type (e.g. non-ascii characters in a http:
> link).
> 
> With this change in place Org will apply percent escaping and
> unescaping more consistently especially for non-ascii characters.
> Additionally some of the outstanding bugs or glitches concerning
> percent escaped links are solved.
> 
> Thanks a lot to David for this work.
> 
> 
> [his message]: http://article.gmane.org/gmane.emacs.orgmode/37888
> 
> 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):
> 
> 
>    ls -l
> 
>  Send the text output of ls -l directly to file:
> 
>    ls -l
> 
> * 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;
> 
>    3 y
> 
>  Thanks to Eric S. Fraga for raising this issue
> 
> * 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.
> 
> * Imagemagick post-processing of LaTeX code block results 
> 
>  It is now possible to use imagemagick to process the output of
>  LaTeX code blocks through to a wide variety of output formats.
>  This patch is thanks to Andreas Leha, the following description
>  is from his email to the mailing list.
> 
>  LaTeX source blocks now have three new options:
> 
>  - :imagemagick
>    When not nil the source block is processed to pdf and the pdf is
>    converted with imagemagick to whatever is given as :file
>    Thus, the format is not limited to png.
> 
>  - :iminoptions
>    This is passed to imagemagick before the pdf file
> 
>  - :imoutoptions
>    This is passed to imagemagick before the output file
> 
>  Small example:
> 
>  will use this command for conversion:
> 
>  convert -density 300 <tmp-pdf> -geometry 400 test.jpg
> 
> * 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.
> 
> * Update contrib/scripts/ditaa.jar to ditaa v0.9 of 2009-11-24 
> 
> * New variable `org-mobile-files-exclude-regexp' 
> 
>  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.
> 
> * New variable `org-attach-store-link-p' 
> 
>  When set to `t', store link to the attached file, at its original location.
> 
> * `org-table-use-standard-references' now defaults to 'from 
> 
> * Better `org-agenda-repeating-timestamp-show-all' 
> 
>  When this is set to a list of TODO keywords, the agenda will only show
>  occurrences of repeating stamps for these TODO keywords.
> 
> * New command `org-narrow-to-block' 
> 
>  This command (`C-x n b') will narrow the buffer to the current block.
> 
> -- 
> Bastien
> 

- Carsten