Further additions to Changes.org

ORGWEBPAGE/Changes.org

@@ -30,6 +30,62 @@ the root of the org-mode repository.
 Failure to update this repository will cause loading of
 org-test.el to throw errors.
 ** Details
+*** Fontify code in code blocks.
+
+Source code in code block can now be fontified.  Please customize
+the varable =org-src-fontify-natively=, but be prepared for some
+editing delays in large blocks.  Thanks to Dan Davison for this.
+
+*** Language-mode commands are available in the Org-buffer
+    The most general machinery for doing this is the macro
+    `org-babel-do-in-edit-buffer'. There is also the convenience
+    function `org-babel-do-key-sequence-in-edit-buffer' which makes
+    use of this macro, and is bound to C-c C-v C-x and C-c C-v x. If
+    there is an active region contained within the code block, then
+    this is inherited by the edit buffer. Some examples of the sorts
+    of usage this permits are
+
+C-c C-v C-x M-;       comment region according to language
+C-c C-v C-x C-M-\     indent region according to language
+
+Users can make these more convenient, e.g.
+
+(defun my/org-comment-dwim (&optional arg)
+    (interactive "P")
+    (or (org-babel-do-key-sequence-in-edit-buffer "\M-;")
+        (comment-dwim arg)))
+
+(define-key org-mode-map "\M-;" 'my/org-comment-dwim)
+
+A common instance of this general pattern is built in to Org-mode,
+controlled by the variable `org-src-tab-acts-natively': if this
+variable is set, then TAB in a code block has the effect that it would
+have in the language major mode buffer.
+
+*** Org-babel commands are available in language-mode edit buffer
+    Mirroring the language-native commands in Org buffers above, a new
+    macro `org-src-do-at-code-block' and convenience function
+    `org-src-do-key-sequence-at-code-block' provide the converse. When
+    used in a language major-mode edit buffer (i.e. a buffer generated
+    by C-c '), `org-src-do-key-sequence-at-code-block' executes a key
+    sequence at the code block in the source Org buffer.  The command
+    bound to the key sequence in the Org-babel key map is executed
+    remotely with point temporarily at the start of the code block in
+    the Org buffer.
+
+    The command is not bound to a key by default, to avoid conflicts
+    with language major mode bindings. To bind it to C-c @ in all
+    language major modes, you could use
+
+  (add-hook 'org-src-mode-hook
+            (lambda () (define-key org-src-mode-map "\C-c@"
+                    'org-src-do-key-sequence-at-code-block)))
+
+    In that case, for example, C-c @ t issued in code edit buffers
+    would tangle the current Org code block, C-c @ e would execute
+    the block and C-c @ h would display the other available
+    Org-babel commands.
+
 *** Multi-line header arguments to code blocks
 Code block header arguments can now span multiple lines using the
 new =#+header:= or =#+headers:= lines preceding a code block or
@@ -105,14 +161,35 @@ Allows exporting directly from a string to the specified export format.
 *** Code block header argument ":noweb tangle"
 Only expands <<noweb>> syntax references when tangling, not during
 export (weaving).
+*** New function `org-babel-switch-to-session-with-code'
+C-c C-v z (`org-babel-switch-to-session-with-code') is a variant of
+C-c C-v C-z (`org-babel-switch-to-session'): instead of switching to
+the session buffer, it splits the window between (a) the session
+buffer and (b) a language major-mode edit buffer for the code block in
+question. This can be convenient for using language major mode for
+interacting with the session buffer.
+
+*** Improvements to R sessions
+    R now uses standard ESS code evaluation machinery in the :results
+    value case, which avoids unnecessary output to the comint
+    buffer. In addition, the R command responsible for writing the
+    result to file is hidden from the user.  Finally, the R code edit
+    buffer generated by C-c ' is automatically linked to the ESS
+    session if the current code block is using :session.
+
 *** Temporary file directory
 All babel temporary files are now kept in a single sub-directory in
 the /tmp directory and are cleaned up when Emacs exits.
 
-*** Function for demarcating blocks `ob-demarcate-block'
+*** Function for demarcating blocks `org-babel-demarcate-block'
 Can be called to wrap the region in a block, or to split the block
 around point, bound to (C-c C-v d).
 
+*** Function for marking code block contents `org-babel-mark-block'
+    Bound to C-M-h in the babel key map (i.e. C-c C-v C-M-h by
+    default).  This can be useful in conjunction with
+    `org-babel-do-in-edit-buffer', for example for language-native
+    commenting or indenting of the whole block.
 *** Lists of anniversaries are now handeled better
 
 When several anniversaries are defined in the bbdb anniversaries
@@ -175,8 +252,21 @@ documentation of MobileOrg and Appendix B of the manual for more
 details.
 
 *** LaTeX minted package for fontified source code export
+Patch by Dan Davison.
+
+A non-nil value of `org-export-latex-minted' means to export source
+code using the minted package, which will fontify source code
+with color.  If you want to use this, you need to make LaTeX use the
+minted package. Add minted to `org-export-latex-packages-alist', for
+example using customize, or with something like
 
-Patch by Dan Davison FIXME
+  (require 'org-latex)
+  (add-to-list 'org-export-latex-packages-alist '("" "minted"))
+
+In addition, it is neccessary to install
+pygments (http://pygments.org), and to configure
+`org-latex-to-pdf-process' so that the -shell-escape option is
+passed to pdflatex.
     
 *** MobileOrg: Do not force to insert IDs
 
@@ -213,12 +303,6 @@ property upon export.
 
 Thanks to David Maus for a patch to this effect.
 
-*** Fontify code in code blocks.
-
-Source code in code block can now be fontified.  Please customize
-the varable =org-src-fontify-natively=, but be prepared for some
-editing delays in larger blocks.  Thanks to Dan Davison for this.
-
 *** LaTeX package fixes
 
 We updated the list of default packages loaded by LaTeX exported