Re: Org-mode release 7.01

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

On Jul 19, 2010, at 3:47 PM, Ista Zahn wrote:

> Hi all,
> Just a quick note that the documentation for org-babel does not appear
> to be in place yet. That is, when I click on the "Source Code" link
> from http://orgmode.org/manual/  I get a 404 Not Found error.

The documentation is in place, but there is a broken link.

The correct link is here:

http://orgmode.org/manual/Working-With-Source-Code.html#Working-With-Source-Code

I will soon upload a minor fix 7.01a which will also fix the link.

- Carsten

>
> Looking forward to trying out the new version, thanks to everyone
> involved! Org-mode has completely changed the way I use emacs. It is
> simply amazing.
>
> Best,
> Ista
>
> On Mon, Jul 19, 2010 at 6:43 AM, Carsten Dominik
> <carsten.dominik@gmail.com> wrote:
>> Hi everyone,
>>
>> I have just released version 7.01 of Org mode.
>>
>> This is a major release, and we have worked months on getting
>> it together.  Most important is of cause the complete integration
>> of Org Babel into  Org mode.  Many thanks to Eric Schulte and
>> Dan Davison who have worked tirelessly to make this happen.
>> Thomas S. Dye gets credit here as well because he did a lot of
>> work on documentation and function/variable docstrings.
>>
>> Also, I need to shout out my gratitude to the increasing number of
>> volunteers in the project.
>>
>> John Wiegley's patchwork server has done wonders for streamlining the
>> process of reviewing and applying patches.  I have applied dozens of
>> patches though this process, just in the last week.
>>
>> The issue tracker by David Maus has finally brought some structure
>> into the stream of ideas and reports on this mailing list, at a
>> moment when I was about to falter under the amount of work
>> maintaining this project means for me.  Frankly,  right now I
>> don't know how I would do things without David's competent and
>> efficient help - he has effectively and silently become
>> co-maintainer of this project.
>>
>> Below these tips above the waterline, there is an iceberg of
>> contributions large and small by so many people.  We have 54 people
>> with FSF papers now, and more contributors of tiny patches.  Also
>> there are the volunteers that manage the mailing list, Worg, and
>> the FAQ.  I am truly humbled and made proud at the same time by
>> each and every contribution that the Org mode projects receives.
>> These contributions made Org mode the phenomenon it now is.
>>
>> Thanks, thanks, thanks!
>>
>> Enjoy!
>>
>> - Carsten
>>
>> P.S. If you are trying to find the 7.01 release on the master branch
>> in the repository, you will not.  The releases are now on a new  
>> branch,
>> called "maint", which will contain only commits that are also  
>> releases.
>> This will make it easier to make minor fixes to a release while  
>> development
>> continues on the master branch.
>>
>> P.P.S.  The feature freeze is over now.
>>
>>
>>
>>
>>                      Changes in Version 7.01
>>                      =======================
>>
>> Incompatible Changes
>> ~~~~~~~~~~~~~~~~~~~~~
>>
>> Emacs 21 support has been dropped
>> ==================================
>>
>> Do not use Org mode 7.xx with Emacs 21, use [version 6.36c] instead.
>>
>>
>> [version 6.36c]: http://orgmode.org/org-6.36c.zip
>>
>> 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
>>
>>  (require 'org-babel)
>>     or
>>
>>  (require 'org-babel-init)
>>     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)
>>
>>  (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)))
>>
>>           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.
>>
>>  (require 'org-babel-R)
>>           should be changed to
>>
>>  (require 'ob-R)
>>
>> 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 clojure :shebang #!/usr/bin/env clj
>>    (println "with a shebang line, I can be run as a script!")
>>  #+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.
>>
>>
>>  ;; 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"))
>>
>> 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.
>>
>>  ;; I don't want to be prompted on every code block evaluation
>>  (setq org-confirm-babel-evaluate nil)
>>
>> 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.
>>
>>  ;; I don't want to execute code blocks with C-c C-c
>>  (setq org-babel-no-eval-on-ctrl-c-ctrl-c t)
>>
>> 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=.
>>
>> Details
>> ~~~~~~~~
>>
>> Org Babel is now part of the Org core
>> ======================================
>> See [Org-babel configuration changes] for instructions on how to
>> update your babel configuration.
>>
>> The most significant result of this change is that Babel now has
>> documentation!  It is part of Org-mode's documentation, see
>> Chapter 14 [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.
>>
>>
>> [Org-babel configuration changes]: #ob-configuration-changes
>> [Working With Source Code]:
>> http://orgmode.org/manual/Working-with-source-code.html#Working-with-source-code
>>
>> The default capture system for Org mode is now called org-capture
>> ==================================================================
>>
>> 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 [chapter about remember].
>>
>> The new system has a technically cleaner implementation and more
>> possibilities for capturing different types of data.  See
>> [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
>>
>>   and convince yourself that everything is OK.  Then save the
>>   customization.
>>
>> 2. Bind the command =org-capture= to a key, similar to what you did
>>   with org-remember:
>>
>>   (define-key global-map "\C-cc" 'org-capture)
>>
>>   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.
>>
>>
>>   [chapter about remember]: http://orgmode.org/org-remember.pdf
>>   [Carsten's announcement]:
>> http://thread.gmane.org/gmane.emacs.orgmode/26441/focus%3D26441
>>
>> Implement pretty display of entities, sub-, and superscripts.
>> ==============================================================
>>
>> 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=.
>>
>> Thanks to Eric Schulte and Ulf Stegeman for making this possible.
>>
>> Help system for finding entities
>> =================================
>>
>> 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.
>>
>> New module to create Gantt charts
>> ==================================
>>
>> Christian Egli's /org-taskjuggler.el/ module is now part of Org.
>> He also wrote a [tutorial] for it.
>>
>>
>> [tutorial]: http://orgmode.org/worg/org-tutorials/org-taskjuggler.php
>>
>> Refile targets can now be cached
>> =================================
>>
>> 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=.
>>
>> Enhanced functionality of the clock resolver
>> =============================================
>>
>> Here are the new options for the clock resolver:
>>
>> 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 property value of "nil" now means to unset a property
>> ========================================================
>>
>> 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.
>>
>> Thanks to Robert Goldman and Bernt Hansen for suggesting this
>> change.
>>
>> The problem with comment syntax has finally been fixed
>> =======================================================
>>
>> Thanks to Leo who has been on a year-long quest to get this fixed
>> and finally found the right way to do it.
>>
>> Make it possible to protect hidden subtrees from being killed by =C- 
>> k=
>> = 
>> = 
>> =====================================================================
>>
>> 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.
>>
>> - Carsten
>>
>>
>>
>>
>> _______________________________________________
>> Emacs-orgmode mailing list
>> Please use `Reply All' to send replies to the list.
>> Emacs-orgmode@gnu.org
>> http://lists.gnu.org/mailman/listinfo/emacs-orgmode
>>
>
>
>
> -- 
> Ista Zahn
> Graduate student
> University of Rochester
> Department of Clinical and Social Psychology
> http://yourpsyche.org
>
> _______________________________________________
> Emacs-orgmode mailing list
> Please use `Reply All' to send replies to the list.
> Emacs-orgmode@gnu.org
> http://lists.gnu.org/mailman/listinfo/emacs-orgmode

- Carsten