From efc228bcdfbdfdef7cf2932dceca1d613df6d4a1 Mon Sep 17 00:00:00 2001 From: Carsten Dominik Date: Sat, 15 May 2010 08:34:21 +0200 Subject: [PATCH 01/12] Changes for version 7.00 --- ORGWEBPAGE/Changes.org | 179 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 178 insertions(+), 1 deletion(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index b7352b319..aa72b2f96 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -6,11 +6,188 @@ #+STARTUP: indent hidestars +* Version 7.00 + + :PROPERTIES: + :VISIBILITY: content + :CUSTOM_ID: v7.00 + :END: + +** Incompatible Changes + +*** 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: + +1. =org-export-docbook-xslt-proc-command= +2. =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: + +1. =%i=: input file argument +2. =%o=: output file argument +3. =%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=. + +*** SOME STUFF ABOUT ORG BAMEL NEEDS TO BE HERE + +** Details + +*** 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 make available +[[http://orgmode.org/org-remember.pdf][a static copy of theformer chapter about remember]]. + +The new system has a better implementation and more +possibilities. 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 + + and convince yourself that everything is OK. The 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) + + You may also use `C-c r' once you have decided to move over to + the new implementation. + +*** Emacs 21 support has been dropped + +Do not use Org mode 7.xx with Emacs 21, use an older version. + +*** 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. + +*** New module org-taskjuggler.el helps to create Gantt charts + +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 Babel is now part of the Org core +HERE WE NEED SOME HINTS ON HOW TO SWITCH OVER OLD CODE + +*** 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 pushing 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 to be killed by `C-k' + +This was a request by Scott Otterson. +See the new variable `org-ctrl-k-protect-subtree'. + +*** Implement pretty display of sub- and superscripts. + +The command =C-c C-x \= toggles the display or Org's special +entities like =\alpha= as pretty unicode characters. Also, sub +and superscripts are displayed in a pretty way. + +Thanks to Eric Schulte and Ulf Stegeman for making this possible. + +*** Add Anthony Lander's org-mac-link-grabber.el + +Thanks to Anthony Lander for this contribution. + +*** Implement caching of refile targets + +*** 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. + +*** LaTeX export: Implement table* environment for wide tables + +Thanks to Chris Gray for a patch to this effect. + + +*** Remove or renew ID property in clone template + +Thanks to David Maus for this change + +*** 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). * Version 6.36 :PROPERTIES: - :VISIBILITY: content :CUSTOM_ID: v6.36 :END: From 3d5ab9646adea545ee3f0f0e229fa063d811556b Mon Sep 17 00:00:00 2001 From: Eric Schulte Date: Tue, 29 Jun 2010 11:36:45 -0700 Subject: [PATCH 02/12] added "Org-babel configuration changes" to "Incomparable Changes" --- ORGWEBPAGE/Changes.org | 72 +++++++++++++++++++++++++++++++++++++++++- 1 file changed, 71 insertions(+), 1 deletion(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index aa72b2f96..69d3a9f23 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -54,7 +54,77 @@ specify the XSLT stylesheet that you want to use on a per-file basis. This setting overrides =org-export-docbook-xslt-stylesheet=. -*** SOME STUFF ABOUT ORG BAMEL NEEDS TO BE HERE +*** 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 +cleared out unnecessary configuration variables -- which is great +unless you already have these variables set. + +We have eliminated 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-babl-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 and most important change, is that to conform to Emacs +guidelines, the prefix =org-babel-*= in all require lines, has +been changed to =ob-*=, this means that *every language-specific +require* will need to be changed. Also, since Babel now loads by +default with Org-mode you should remove any +#+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. + +Whew! that seems like a lot of effort for a /simplification/ of +configuration. ** Details From b81f4119edd49f7d8c4f44f134dbf1939e5dc291 Mon Sep 17 00:00:00 2001 From: Eric Schulte Date: Tue, 29 Jun 2010 12:09:00 -0700 Subject: [PATCH 03/12] fleshing out "Org Babel is now part of the Org core" --- ORGWEBPAGE/Changes.org | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index 69d3a9f23..d0701d2e0 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -55,6 +55,9 @@ basis. This setting overrides =org-export-docbook-xslt-stylesheet=. *** Org-babel configuration changes +:PROPERTIES: +:CUSTOM_ID: ob-configuration-changes +:END: Babel took the integration into Org-mode as an opportunity to do some much needed house cleaning. Most importantly we have cleared out unnecessary configuration variables -- which is great @@ -181,7 +184,16 @@ 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 Babel is now part of the Org core -HERE WE NEED SOME HINTS ON HOW TO SWITCH OVER OLD CODE +See [[#ob-configuration-changes][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_ also, 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. *** A property value of "nil" now means to unset a property From a22e9cb2379c6bce043063f67d6c814ea118ec60 Mon Sep 17 00:00:00 2001 From: Eric Schulte Date: Mon, 5 Jul 2010 10:56:16 -0700 Subject: [PATCH 04/12] updated changes.org to reflect new developments in the safety-babel branch --- ORGWEBPAGE/Changes.org | 93 +++++++++++++++++++++++++++++++++--------- 1 file changed, 73 insertions(+), 20 deletions(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index d0701d2e0..812dfe5fb 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -60,13 +60,80 @@ basis. This setting overrides :END: Babel took the integration into Org-mode as an opportunity to do some much needed house cleaning. Most importantly we have -cleared out unnecessary configuration variables -- which is great -unless you already have these variables set. +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. -We have eliminated the two main internal lists of languages, -namely +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= +- =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 @@ -111,21 +178,7 @@ language, e.g. (add-to-list 'org-babel-default-header-args:sh '(:shebang . "#!/bin/bash")) #+end_src - -The final and most important change, is that to conform to Emacs -guidelines, the prefix =org-babel-*= in all require lines, has -been changed to =ob-*=, this means that *every language-specific -require* will need to be changed. Also, since Babel now loads by -default with Org-mode you should remove any -#+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. - + Whew! that seems like a lot of effort for a /simplification/ of configuration. From 298b90e9cea88809a99e82a87ca7b47419d03a80 Mon Sep 17 00:00:00 2001 From: Eric Schulte Date: Mon, 5 Jul 2010 11:02:55 -0700 Subject: [PATCH 05/12] updated changes.org to reflect the new Babel security measures --- ORGWEBPAGE/Changes.org | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index 812dfe5fb..8af868a90 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -178,7 +178,31 @@ language, e.g. (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. From 4f670b53b6b78cac197eaf3ec0538aef95c3181b Mon Sep 17 00:00:00 2001 From: Carsten Dominik Date: Sat, 15 May 2010 08:34:21 +0200 Subject: [PATCH 06/12] Changes for version 7.00 --- ORGWEBPAGE/Changes.org | 179 ++++++++++++++++++++++++++++++++++++++++- 1 file changed, 178 insertions(+), 1 deletion(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index b7352b319..aa72b2f96 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -6,11 +6,188 @@ #+STARTUP: indent hidestars +* Version 7.00 + + :PROPERTIES: + :VISIBILITY: content + :CUSTOM_ID: v7.00 + :END: + +** Incompatible Changes + +*** 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: + +1. =org-export-docbook-xslt-proc-command= +2. =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: + +1. =%i=: input file argument +2. =%o=: output file argument +3. =%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=. + +*** SOME STUFF ABOUT ORG BAMEL NEEDS TO BE HERE + +** Details + +*** 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 make available +[[http://orgmode.org/org-remember.pdf][a static copy of theformer chapter about remember]]. + +The new system has a better implementation and more +possibilities. 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 + + and convince yourself that everything is OK. The 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) + + You may also use `C-c r' once you have decided to move over to + the new implementation. + +*** Emacs 21 support has been dropped + +Do not use Org mode 7.xx with Emacs 21, use an older version. + +*** 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. + +*** New module org-taskjuggler.el helps to create Gantt charts + +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 Babel is now part of the Org core +HERE WE NEED SOME HINTS ON HOW TO SWITCH OVER OLD CODE + +*** 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 pushing 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 to be killed by `C-k' + +This was a request by Scott Otterson. +See the new variable `org-ctrl-k-protect-subtree'. + +*** Implement pretty display of sub- and superscripts. + +The command =C-c C-x \= toggles the display or Org's special +entities like =\alpha= as pretty unicode characters. Also, sub +and superscripts are displayed in a pretty way. + +Thanks to Eric Schulte and Ulf Stegeman for making this possible. + +*** Add Anthony Lander's org-mac-link-grabber.el + +Thanks to Anthony Lander for this contribution. + +*** Implement caching of refile targets + +*** 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. + +*** LaTeX export: Implement table* environment for wide tables + +Thanks to Chris Gray for a patch to this effect. + + +*** Remove or renew ID property in clone template + +Thanks to David Maus for this change + +*** 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). * Version 6.36 :PROPERTIES: - :VISIBILITY: content :CUSTOM_ID: v6.36 :END: From 83539af9bf448b80918303e26901d7b32f3a3b35 Mon Sep 17 00:00:00 2001 From: Eric Schulte Date: Tue, 29 Jun 2010 11:36:45 -0700 Subject: [PATCH 07/12] added "Org-babel configuration changes" to "Incomparable Changes" --- ORGWEBPAGE/Changes.org | 72 +++++++++++++++++++++++++++++++++++++++++- 1 file changed, 71 insertions(+), 1 deletion(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index aa72b2f96..69d3a9f23 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -54,7 +54,77 @@ specify the XSLT stylesheet that you want to use on a per-file basis. This setting overrides =org-export-docbook-xslt-stylesheet=. -*** SOME STUFF ABOUT ORG BAMEL NEEDS TO BE HERE +*** 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 +cleared out unnecessary configuration variables -- which is great +unless you already have these variables set. + +We have eliminated 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-babl-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 and most important change, is that to conform to Emacs +guidelines, the prefix =org-babel-*= in all require lines, has +been changed to =ob-*=, this means that *every language-specific +require* will need to be changed. Also, since Babel now loads by +default with Org-mode you should remove any +#+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. + +Whew! that seems like a lot of effort for a /simplification/ of +configuration. ** Details From 3e94fbcdeb408a365767ee9f88022ecb8672a798 Mon Sep 17 00:00:00 2001 From: Eric Schulte Date: Tue, 29 Jun 2010 12:09:00 -0700 Subject: [PATCH 08/12] fleshing out "Org Babel is now part of the Org core" --- ORGWEBPAGE/Changes.org | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index 69d3a9f23..d0701d2e0 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -55,6 +55,9 @@ basis. This setting overrides =org-export-docbook-xslt-stylesheet=. *** Org-babel configuration changes +:PROPERTIES: +:CUSTOM_ID: ob-configuration-changes +:END: Babel took the integration into Org-mode as an opportunity to do some much needed house cleaning. Most importantly we have cleared out unnecessary configuration variables -- which is great @@ -181,7 +184,16 @@ 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 Babel is now part of the Org core -HERE WE NEED SOME HINTS ON HOW TO SWITCH OVER OLD CODE +See [[#ob-configuration-changes][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_ also, 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. *** A property value of "nil" now means to unset a property From d258dffcf520c02cf44d142a20d449ebf5aa7e55 Mon Sep 17 00:00:00 2001 From: Eric Schulte Date: Mon, 5 Jul 2010 10:56:16 -0700 Subject: [PATCH 09/12] updated changes.org to reflect new developments in the safety-babel branch --- ORGWEBPAGE/Changes.org | 93 +++++++++++++++++++++++++++++++++--------- 1 file changed, 73 insertions(+), 20 deletions(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index d0701d2e0..812dfe5fb 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -60,13 +60,80 @@ basis. This setting overrides :END: Babel took the integration into Org-mode as an opportunity to do some much needed house cleaning. Most importantly we have -cleared out unnecessary configuration variables -- which is great -unless you already have these variables set. +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. -We have eliminated the two main internal lists of languages, -namely +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= +- =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 @@ -111,21 +178,7 @@ language, e.g. (add-to-list 'org-babel-default-header-args:sh '(:shebang . "#!/bin/bash")) #+end_src - -The final and most important change, is that to conform to Emacs -guidelines, the prefix =org-babel-*= in all require lines, has -been changed to =ob-*=, this means that *every language-specific -require* will need to be changed. Also, since Babel now loads by -default with Org-mode you should remove any -#+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. - + Whew! that seems like a lot of effort for a /simplification/ of configuration. From d2cb09e2e58ad7d56db63cc45adc3d655525d59d Mon Sep 17 00:00:00 2001 From: Eric Schulte Date: Mon, 5 Jul 2010 11:02:55 -0700 Subject: [PATCH 10/12] updated changes.org to reflect the new Babel security measures --- ORGWEBPAGE/Changes.org | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index 812dfe5fb..8af868a90 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -178,7 +178,31 @@ language, e.g. (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. From 9dcbdbf8dac9b5e6d2a63fb2139a9bc03fc1fb95 Mon Sep 17 00:00:00 2001 From: Carsten Dominik Date: Mon, 12 Jul 2010 11:30:55 +0200 Subject: [PATCH 11/12] Finalize the list of changes for 7.01 --- ORGWEBPAGE/Changes.org | 198 +++++++++++++++++++++++------------------ 1 file changed, 110 insertions(+), 88 deletions(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index 8af868a90..e43e8c738 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -15,49 +15,24 @@ ** Incompatible Changes -*** Customizable variable changes for DocBook exporter +*** Emacs 21 support has been dropped -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: +Do not use Org mode 7.xx with Emacs 21, use an older version, for +example [[http://orgmode.org/org-6.36c.zip][version 6.36c]]. -1. =org-export-docbook-xslt-proc-command= -2. =org-export-docbook-xsl-fo-proc-command= +*** XEmacs support requires the XEmacs development version -Instead of using =%s= in the format control string for all -arguments, now we use /three/ different format spec characters: - -1. =%i=: input file argument -2. =%o=: output file argument -3. =%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=. +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. *** Org-babel configuration changes :PROPERTIES: :CUSTOM_ID: ob-configuration-changes :END: + 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 @@ -137,7 +112,7 @@ well as the two main internal lists of languages, namely so any config lines which mention those variables, can/should be stripped out in their entirety. This includes any calls to the -=org-babl-add-interpreter= function, whose sole purpose was to +=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 @@ -206,14 +181,88 @@ 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: + +1. =org-export-docbook-xslt-proc-command= +2. =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: + +1. =%i=: input file argument +2. =%o=: output file argument +3. =%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 [[#ob-configuration-changes][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 [[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. + +*** 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. + +*** Implement pretty display of 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. 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. + *** 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 make available -[[http://orgmode.org/org-remember.pdf][a static copy of theformer chapter about remember]]. +This replaces the earlier system org-remember. In the current +manual, only =org-capture= is described in detail. For people who +prefer to continue to use =org-remember=, we make available a +static copy of the [[http://orgmode.org/org-remember.pdf][former chapter about remember]]. The new system has a better implementation and more possibilities. See [[http://thread.gmane.org/gmane.emacs.orgmode/26441/focus%3D26441][Carsten's announcement]] for more details. @@ -225,53 +274,31 @@ To switch over to the new system: : 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, + 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. The save the + 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 +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) - You may also use `C-c r' once you have decided to move over to - the new implementation. + 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. -*** Emacs 21 support has been dropped +*** New module to create Gantt charts -Do not use Org mode 7.xx with Emacs 21, use an older version. - -*** 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. - -*** New module org-taskjuggler.el helps to create Gantt charts - -Christian Egli's org-taskjuggler.el module is now part of Org +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 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. - -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_ also, 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. - *** A property value of "nil" now means to unset a property This can be useful in particular with property inheritance, if @@ -287,25 +314,26 @@ change. 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 to be killed by `C-k' +*** Make it possible to protect hidden subtrees to be killed by =C-k= This was a request by Scott Otterson. -See the new variable `org-ctrl-k-protect-subtree'. - -*** Implement pretty display of sub- and superscripts. - -The command =C-c C-x \= toggles the display or Org's special -entities like =\alpha= as pretty unicode characters. Also, sub -and superscripts are displayed in a pretty way. - -Thanks to Eric Schulte and Ulf Stegeman for making this possible. +See the new variable =org-ctrl-k-protect-subtree=. *** Add Anthony Lander's org-mac-link-grabber.el +This module allows to grab links to all kinds of applications on +a mac. + Thanks to Anthony Lander for this contribution. *** Implement caching of refile targets +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: @@ -333,16 +361,10 @@ changes. Thanks to Chris Gray for a patch to this effect. - -*** Remove or renew ID property in clone template +*** When cloning entries, remove or renew ID property Thanks to David Maus for this change -*** 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). * Version 6.36 From 520088bd0c4b94c981f444fc1ce2aecfe1de9ec0 Mon Sep 17 00:00:00 2001 From: Carsten Dominik Date: Thu, 15 Jul 2010 19:32:06 +0200 Subject: [PATCH 12/12] More work on the list of changes --- ORGWEBPAGE/Changes.org | 160 +++++++++-------------------------------- 1 file changed, 34 insertions(+), 126 deletions(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index 8ad3d216f..03dd321cb 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -6,12 +6,11 @@ #+STARTUP: indent hidestars -* Version 7.00 - - :PROPERTIES: - :VISIBILITY: content - :CUSTOM_ID: v7.00 - :END: +* Version 7.01 +:PROPERTIES: +:VISIBILITY: content +:CUSTOM_ID: v7.01 +:END: ** Incompatible Changes @@ -286,7 +285,7 @@ buffer that lists all entities available in Org. Thanks to Ulf Stegeman for adding the necessary structure to the internal entity list. -*** Implement pretty display of sub- and superscripts. +*** 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 @@ -298,20 +297,10 @@ Thanks to Eric Schulte and Ulf Stegeman for making this possible. *** The default capture system for Org mode is now called org-capture -This replaces the earlier system org-remember. In the current -manual, only =org-capture= is described in detail. For people who -prefer to continue to use =org-remember=, we make available a -static copy of the [[http://orgmode.org/org-remember.pdf][former chapter about remember]]. -======= -** Details - -*** 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 make available [[http://orgmode.org/org-remember.pdf][a static copy of theformer chapter about remember]]. ->>>>>>> 298b90e9cea88809a99e82a87ca7b47419d03a80 The new system has a better implementation and more possibilities. See [[http://thread.gmane.org/gmane.emacs.orgmode/26441/focus%3D26441][Carsten's announcement]] for more details. @@ -323,33 +312,21 @@ To switch over to the new system: : M-x org-capture-import-remember-templates RET to get a translated version of your remember templates into the -<<<<<<< HEAD new variable =org-capture-templates=. This will "mostly" work, -======= - new variable `org-capture-templates'. This will "mostly" work, ->>>>>>> 298b90e9cea88809a99e82a87ca7b47419d03a80 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 -<<<<<<< HEAD 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 -======= - and convince yourself that everything is OK. The save the - customization. - -2. Bind the command `org-capture' to a key, similar to what you did ->>>>>>> 298b90e9cea88809a99e82a87ca7b47419d03a80 with org-remember: : (define-key global-map "\C-cc" 'org-capture) -<<<<<<< HEAD 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 @@ -360,96 +337,14 @@ To switch over to the new system: 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. -======= - You may also use `C-c r' once you have decided to move over to - the new implementation. +*** Refile targets can now be cached -*** Emacs 21 support has been dropped - -Do not use Org mode 7.xx with Emacs 21, use an older version. - -*** 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. - -*** New module org-taskjuggler.el helps to create Gantt charts - -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 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. - -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_ also, 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. - ->>>>>>> 298b90e9cea88809a99e82a87ca7b47419d03a80 -*** 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 pushing 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. - -<<<<<<< HEAD -*** Make it possible to protect hidden subtrees to be killed by =C-k= - -This was a request by Scott Otterson. -See the new variable =org-ctrl-k-protect-subtree=. - -*** Add Anthony Lander's org-mac-link-grabber.el - -This module allows to grab links to all kinds of applications on -a mac. - -======= -*** Make it possible to protect hidden subtrees to be killed by `C-k' - -This was a request by Scott Otterson. -See the new variable `org-ctrl-k-protect-subtree'. - -*** Implement pretty display of sub- and superscripts. - -The command =C-c C-x \= toggles the display or Org's special -entities like =\alpha= as pretty unicode characters. Also, sub -and superscripts are displayed in a pretty way. - -Thanks to Eric Schulte and Ulf Stegeman for making this possible. - -*** Add Anthony Lander's org-mac-link-grabber.el - ->>>>>>> 298b90e9cea88809a99e82a87ca7b47419d03a80 -Thanks to Anthony Lander for this contribution. - -*** Implement caching of refile targets - -<<<<<<< HEAD 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=. -======= ->>>>>>> 298b90e9cea88809a99e82a87ca7b47419d03a80 *** Enhanced functionality of the clock resolver Here are the new options for the clock resolver: @@ -473,28 +368,41 @@ 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 pushing 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. -<<<<<<< HEAD *** When cloning entries, remove or renew ID property Thanks to David Maus for this change -======= - -*** Remove or renew ID property in clone template - -Thanks to David Maus for this change - -*** 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). ->>>>>>> 298b90e9cea88809a99e82a87ca7b47419d03a80 - * Version 6.36 :PROPERTIES: