|
@@ -6,7 +6,7 @@
|
|
|
|
|
|
#+STARTUP: indent hidestars
|
|
|
|
|
|
-* Version 6.35 (in preparation)
|
|
|
+* Version 6.35
|
|
|
:PROPERTIES:
|
|
|
:VISIBILITY: content
|
|
|
:CUSTOM_ID: v6.35
|
|
@@ -16,32 +16,49 @@
|
|
|
|
|
|
*** Changes to the intended use of =org-export-latex-classes=
|
|
|
|
|
|
-So far this variable has been used to specify the
|
|
|
-=\documentclass= macro as well as all the =\usepackage= calls
|
|
|
+So far this variable has been used to specify the complete header
|
|
|
+of the LaTeX document, including all the =\usepackage= calls
|
|
|
necessary for the document. This setup makes it difficult to
|
|
|
maintain the list of packages that Org itself would like to call,
|
|
|
-for example for the special symbol support it needs.
|
|
|
+for example for the special symbol support it needs. Each time I
|
|
|
+have to add a package, I have to ask people to revise the
|
|
|
+configuration of this variable. In this release, I have tried to
|
|
|
+fix this.
|
|
|
+
|
|
|
+First of all, you can *opt out of this change* in the following
|
|
|
+way: You can say: /I want to have full control over headers, and
|
|
|
+I will take responsibility to include the packages Org needs/.
|
|
|
+If that is what you want, add this to your configuration and skip
|
|
|
+the rest of this section (except maybe for the description of the
|
|
|
+=[EXTRA]= place holder):
|
|
|
+
|
|
|
+#+begin_src emacs-lisp
|
|
|
+ (setq org-export-latex-default-packages-alist nil
|
|
|
+ org-export-latex-packages-alist nil)
|
|
|
+#+end_src
|
|
|
+
|
|
|
+/Continue to read here if you want to go along with the modified
|
|
|
+setup./
|
|
|
|
|
|
There are now two variables that should be used to list the LaTeX
|
|
|
packages that need to be included in all classes. The header
|
|
|
-definition in =org-export-latex-classes= should then only contain
|
|
|
-the =\documentclass= macro, and packages for this specific class
|
|
|
-definition.
|
|
|
+definition in =org-export-latex-classes= should then not contain
|
|
|
+the corresponding =\usepackage= calls (see below).
|
|
|
|
|
|
-The two variables are:
|
|
|
+The two new variables are:
|
|
|
|
|
|
1. =org-export-latex-default-packages-alist= :: This is the
|
|
|
variable where Org-mode itself puts the packages it needs.
|
|
|
- If possible, you should not change this variable - in fact,
|
|
|
- I have considered to make this a constant and to not allow
|
|
|
- it customized. However, there is one exception when it
|
|
|
- might be necessary to change it: if one of the packages
|
|
|
+ Normally you should not change this variable. The only
|
|
|
+ reason to change it anyway is when one of these packages
|
|
|
causes a conflict with another package you want to use.
|
|
|
+ Then you can remove that packages and hope that you are not
|
|
|
+ using Org-mode functionality that needs it.
|
|
|
|
|
|
2. =org-export-latex-packages-alist= :: This is the variable
|
|
|
- where you should put the packages that you'd like to use
|
|
|
- across all classes. For example, I am putting =amsmath= and
|
|
|
- =tikz= here, because I always want to have them.
|
|
|
+ where you can put the packages that you'd like to use across
|
|
|
+ all classes. For example, I am putting =amsmath= and =tikz=
|
|
|
+ here, because I always want to have them.
|
|
|
|
|
|
The sequence how these customizations will show up in the LaTeX
|
|
|
document are:
|
|
@@ -50,12 +67,57 @@ document are:
|
|
|
3. =org-export-latex-packages-alist=
|
|
|
4. Buffer-specific things set with =#+LaTeX_HEADER:=
|
|
|
|
|
|
-If you have currently customized =org-export-latex-classes=, you
|
|
|
-should revise that customization and remove any package call that
|
|
|
-are covered by =org-export-latex-default-packages-alist=, and you
|
|
|
-should consider to move packages that you use in all classes to
|
|
|
-=org-export-latex-packages-alist=.
|
|
|
+If you want more control about which segment is placed where, or
|
|
|
+if you want, for a specific class, have full control over the
|
|
|
+header and exclude some of the automatic building blocks, you can
|
|
|
+put the following macro-like place holders into the header:
|
|
|
|
|
|
+#+begin_example
|
|
|
+[DEFAULT-PACKAGES] \usepackage statements for default packages
|
|
|
+[NO-DEFAULT-PACKAGES] do not include any of the default packages
|
|
|
+[PACKAGES] \usepackage statements for packages
|
|
|
+[NO-PACKAGES] do not include the packages
|
|
|
+[EXTRA] the stuff from #+LaTeX_HEADER
|
|
|
+[NO-EXTRA] do not include #+LaTeX_HEADER stuff
|
|
|
+#+end_example
|
|
|
+
|
|
|
+If you have currently customized =org-export-latex-classes=, you
|
|
|
+should revise that customization and remove any package calls that
|
|
|
+are covered by =org-export-latex-default-packages-alist=. This
|
|
|
+applies to the following packages:
|
|
|
+
|
|
|
+- inputenc
|
|
|
+- fontenc
|
|
|
+- fixltx2e
|
|
|
+- graphicx
|
|
|
+- longtable
|
|
|
+- float
|
|
|
+- wrapfig
|
|
|
+- soul
|
|
|
+- t1enc
|
|
|
+- textcomp
|
|
|
+- marvosym
|
|
|
+- wasysym
|
|
|
+- latexsym
|
|
|
+- amssymb
|
|
|
+- hyperref
|
|
|
+- microtype
|
|
|
+
|
|
|
+If one of these packages creates a conflict with another package
|
|
|
+you are using, you can remove it from
|
|
|
+=org-export-latex-default-packages-alist=. But then you risk
|
|
|
+that some of the advertised export features of Org will not work
|
|
|
+properly.
|
|
|
+
|
|
|
+You can also consider moving packages that you use in all classes
|
|
|
+to =org-export-latex-packages-alist=. If necessary, put the
|
|
|
+place holders so that the packages get loaded in the right
|
|
|
+sequence. As said above, for backward compatibility, if you omit
|
|
|
+the place holders, all the variables will dump their content at
|
|
|
+the end of the header.
|
|
|
+
|
|
|
+Damn, this has become more complex than I wanted it to be. I
|
|
|
+hope that in practice, this will not be complicated at all.
|
|
|
|
|
|
*** The constant =org-html-entities= is obsolete
|
|
|
|
|
@@ -77,12 +139,12 @@ org-document-title
|
|
|
org-document-info
|
|
|
org-document-info-keyword
|
|
|
|
|
|
-In addition, the variable org-hidden-keywords can be used to make the
|
|
|
-corresponding keywords disappear.
|
|
|
+In addition, the variable =org-hidden-keywords= can be used to
|
|
|
+make the corresponding keywords disappear.
|
|
|
|
|
|
-Patch by Dan Davison
|
|
|
+Thanks to Dan Davison for this feature.
|
|
|
|
|
|
-*** Implement a simpler way to specify faces for tags and todo keywords
|
|
|
+*** Simpler way to specify faces for tags and todo keywords
|
|
|
|
|
|
The variables =org-todo-keyword-faces=, =org-tag-faces=, and
|
|
|
=org-priority-faces= now accept simple color names as
|
|
@@ -96,16 +158,16 @@ The change is based on an idea and patch by Ryan Thompson.
|
|
|
|
|
|
*** <N> in tables now means fixed width, not maximum width
|
|
|
|
|
|
-Requested by Michael Brand
|
|
|
+Requested by Michael Brand.
|
|
|
|
|
|
-*** Improve level cycling function
|
|
|
+*** Better level cycling function
|
|
|
|
|
|
=TAB= in an empty headline cycles the level of that headline
|
|
|
through likely states. Ryan Thompson implemented an improved
|
|
|
version of this function, which does not depend upon when exactly
|
|
|
this command is used. Thanks to Ryan for this improvement.
|
|
|
|
|
|
-*** Improve adaptive filling
|
|
|
+*** Adaptive filling
|
|
|
|
|
|
For paragraph text, =org-adaptive-fill-function= did not handle the
|
|
|
base case of regular text which needed to be filled. This is now
|
|
@@ -114,13 +176,13 @@ to be filled correctly.
|
|
|
|
|
|
Thanks to Dan Hackney for this patch.
|
|
|
|
|
|
-*** Make `org-reveal' (=C-c C-r=) also decrypt encrypted entries
|
|
|
+*** `org-reveal' (=C-c C-r=) also decrypts encrypted entries (org-crypt.el)
|
|
|
|
|
|
Thanks to Richard Riley for triggering this change.
|
|
|
|
|
|
-*** Improve automatic letter selection for TODO keywords
|
|
|
+*** Better automatic letter selection for TODO keywords
|
|
|
|
|
|
-When all first letters of keywords have been used, Org no assigns
|
|
|
+When all first letters of keywords have been used, Org now assigns
|
|
|
more meaningful characters based on the keywords.
|
|
|
|
|
|
Thanks to Mikael Fornius for this patch.
|
|
@@ -140,23 +202,23 @@ possible.
|
|
|
The coding system of the LaTeX class will now be set to the value
|
|
|
corresponding to the buffer's file coding system. This happens
|
|
|
if your setup sets up the file to have a line
|
|
|
-=\usepackage[AUTO]{inputenc}=.
|
|
|
+=\usepackage[AUTO]{inputenc}= (the default setup does this).
|
|
|
|
|
|
*** New exporters to Latin-1 and UTF-8
|
|
|
|
|
|
-While Ulf was going through the entities list to improve the
|
|
|
-LaTeX export, he had the great idea to provide representations for
|
|
|
-many of the entities in Latin-1, and for all of them in UTF-8.
|
|
|
-This means that we can now export files rich in special symbols
|
|
|
-to Latin-1 and to UTF-8 files. These new exporters can be
|
|
|
-reached with the commands =C-c C-e n= and =C-c C-e u=,
|
|
|
-respectively.
|
|
|
+While Ulf Stegemann was going through the entities list to
|
|
|
+improve the LaTeX export, he had the great idea to provide
|
|
|
+representations for many of the entities in Latin-1, and for all
|
|
|
+of them in UTF-8. This means that we can now export files rich
|
|
|
+in special symbols to Latin-1 and to UTF-8 files. These new
|
|
|
+exporters can be reached with the commands =C-c C-e n= and =C-c
|
|
|
+C-e u=, respectively.
|
|
|
|
|
|
When there is no representation for a given symbol in the
|
|
|
targeted coding system, you can choose to keep the TeX-macro-like
|
|
|
representation, or to get an "explanatory" representation. For
|
|
|
example, =\simeq= could be represented as "[approx. equal to]".
|
|
|
-Please use the variable `org-entities-ascii-explanatory' to state
|
|
|
+Please use the variable =org-entities-ascii-explanatory= to state
|
|
|
your preference.
|
|
|
|
|
|
*** Full label/reference support in HTML, Docbook, and LaTeX backends
|
|
@@ -231,12 +293,13 @@ C-u M-x org-publish-all
|
|
|
|
|
|
Whenever an Org file is published in this project, a new file
|
|
|
with the extension "orgx" will be written. It contains the index
|
|
|
-entries. When all project files are published, Org will produce
|
|
|
-a new file "theindex.inc" containing the index as a to-level
|
|
|
-tree. This file can be included into any project file using
|
|
|
+entries and corresponding jump target names. When all project
|
|
|
+files are published, Org will produce a new file "theindex.inc"
|
|
|
+containing the index as a to-level tree. This file can be
|
|
|
+included into any project file using
|
|
|
|
|
|
#+begin_src org
|
|
|
-#+include: "theindex.inc"
|
|
|
+ ,#+include: "theindex.inc"
|
|
|
#+end_src
|
|
|
|
|
|
Org-mode will also create a file "theindex.org" with this include
|
|
@@ -247,7 +310,7 @@ overwritten by Org.
|
|
|
|
|
|
Thanks to Stefan Vollmar for initiating and driving this feature.
|
|
|
|
|
|
-FIXME: Still need to do the LaTeX portion
|
|
|
+*** TODO Still need to do the LaTeX portion
|
|
|
|
|
|
** MobileOrg
|
|
|
|
|
@@ -278,8 +341,8 @@ considered for this command by binding =org-agenda-entry-types=
|
|
|
temporarily in the options section of the command. This can lead
|
|
|
to significant speedups, because instead of laboriously finding
|
|
|
entries and then rejecting them, a whole search cycle is skipped.
|
|
|
-For more information see the new section in [[http://orgmode.org/worg/org-tutorials/org-custom-agenda-commands.php#sec-5][Matt Lundin's agenda
|
|
|
-custom command tutorial]].
|
|
|
+For more information see the new section in
|
|
|
+[[http://orgmode.org/worg/org-tutorials/org-custom-agenda-commands.php#sec-5][Matt Lundin's agenda custom command tutorial]].
|
|
|
|
|
|
Thanks to Matt Lundin for this feature.
|
|
|
|
|
@@ -329,6 +392,12 @@ the time is moved into the time stamp.
|
|
|
|
|
|
Thanks to Stephen Eglen for this feature.
|
|
|
|
|
|
+*** The customization group org-font-lock has been renamed
|
|
|
+
|
|
|
+The new name is `org-appearance'.
|
|
|
+
|
|
|
+Thanks to Dan Davison for a patch to this effect.
|
|
|
+
|
|
|
*** The TODO list: Allow skipping scheduled or deadlined entries
|
|
|
|
|
|
Skipping TODO entries in the global TODO list based on whether
|
|
@@ -365,7 +434,7 @@ Extension: \.pdf::\([0-9]+\)\'
|
|
|
Command: evince "%s" -p %1
|
|
|
#+end_example
|
|
|
|
|
|
-Thanks to Jan Böker for a patch to this effect.
|
|
|
+Thanks to Jan Böcker for a patch to this effect.
|
|
|
|
|
|
** Clocking
|
|
|
|
|
@@ -399,7 +468,7 @@ tables to be broken.
|
|
|
|
|
|
** Misc
|
|
|
|
|
|
-*** Add logging support for refiling
|
|
|
+*** New logging support for refiling
|
|
|
|
|
|
Whenever you refile an item, a time stamp and even a note can be
|
|
|
added to this entry. For details, see the new option
|
|
@@ -419,7 +488,7 @@ org-table-current-line
|
|
|
org-table-goto-line
|
|
|
#+end_example
|
|
|
|
|
|
-*** Tables: Introduce field coordinates for formulas, improve docs
|
|
|
+*** Tables: Field coordinates for formulas, and improved docs
|
|
|
|
|
|
Calc and Emacs-Lisp formulas for tables can access the current
|
|
|
field coordinates with =@#= and =$#= for row and column,
|
|
@@ -427,6 +496,9 @@ respectively. These can be useful in some formulas. For
|
|
|
example, to sequentially number the fields in a column, use
|
|
|
~=@#~ as column equation.
|
|
|
|
|
|
+One application is to copy a column from a different table. See
|
|
|
+the manual for details.
|
|
|
+
|
|
|
Thanks to Michael Brand for this feature.
|
|
|
|
|
|
*** Archiving: Allow to reverse order in target node
|
|
@@ -460,11 +532,11 @@ So when you are prompted for a date, you can now answer like this
|
|
|
2/5 --> <CURRENT-YEAR>-02-05
|
|
|
#+end_example
|
|
|
|
|
|
-*** Update org-timer.el so that we only allow one timer.
|
|
|
+*** org-timer.el now allows just one timer
|
|
|
|
|
|
There is now only a single free timer supported by org-timer.el.
|
|
|
Thanks to Bastien for cleaning this up, after a bug report in
|
|
|
-this area by Frederic Couchet.
|
|
|
+this area by Frédéric Couchet.
|
|
|
|
|
|
*** Remember: Allow to file as sibling of current clock
|
|
|
|
|
@@ -473,38 +545,40 @@ last filed entry.
|
|
|
|
|
|
Patch by Lukasz Stelmach.
|
|
|
|
|
|
-*** Org-reveal: Double prefix arg show the entire subtree of the parent
|
|
|
+*** Org-reveal: Double prefix arg shows the entire subtree of the parent
|
|
|
|
|
|
This can help to get out of an inconsistent state produced for
|
|
|
example by viewing from the agenda.
|
|
|
|
|
|
-This was a request my Matt Lundin.
|
|
|
+This was a request by Matt Lundin.
|
|
|
|
|
|
*** Add org-secretary.el by Juan Reyero to the contrib directory
|
|
|
|
|
|
-Org-secretary is a possible setup for group work using Org-mode.
|
|
|
+org-secretary.el is a possible setup for group work using
|
|
|
+Org-mode.
|
|
|
|
|
|
Thanks to Juan Reyero for this contribution.
|
|
|
|
|
|
** Babel
|
|
|
-Eric has compiled the following list of changes in and around
|
|
|
-org-babel.
|
|
|
-
|
|
|
-- added support for Matlab and Octave
|
|
|
-- added support for C and C++ code blocks
|
|
|
-- added support for the Oz programming language
|
|
|
-- can now force literal interpretation of table cell contents
|
|
|
- with extra "$" in table formula
|
|
|
-- variable references which look like lisp forms are now
|
|
|
- evaluated
|
|
|
-- inline source blocks will always return string output
|
|
|
-- no longer adding extension during tangling when filename is
|
|
|
- provided
|
|
|
-- code block parameters are now available when initializing a
|
|
|
- session
|
|
|
-- added `org-babel-execute-hook' which runs after code block
|
|
|
- execution
|
|
|
-- working directories and remote execution
|
|
|
+
|
|
|
+Eric and Dan have compiled the following list of changes in and
|
|
|
+around org-babel.
|
|
|
+
|
|
|
+- Added support for Matlab and Octave.
|
|
|
+- Added support for C and C++ code blocks.
|
|
|
+- Added support for the Oz programming language.
|
|
|
+ Thanks to Torsten Anders for this contribution
|
|
|
+- Can now force literal interpretation of table cell contents
|
|
|
+ with extra "$" in table formula.
|
|
|
+ Thanks to Maurizio Vitale for this suggestion.
|
|
|
+- Variable references which look like lisp forms are now
|
|
|
+ evaluated.
|
|
|
+- No longer adding extension during tangling when filename is
|
|
|
+ provided.
|
|
|
+ Thanks to Martin G. Skjæveland and Nicolas Girard for prompting this.
|
|
|
+- Added `org-babel-execute-hook' which runs after code block
|
|
|
+ execution.
|
|
|
+- Working directories and remote execution
|
|
|
|
|
|
This introduces a new header argument :dir. For the duration of
|
|
|
source block execution, default-directory is set to the value
|
|
@@ -520,14 +594,16 @@ org-babel.
|
|
|
interpreter executable will be sought in tramp-remote-path, and
|
|
|
if found will execute on the remote machine in the specified
|
|
|
remote directory.
|
|
|
-- Remove org-R from contrib
|
|
|
+- Tramp syntax can be used to tangle to remote files.
|
|
|
+ Thanks to Maurizio Vitale and Rémi Vanicat.
|
|
|
+- org-R removed from contrib.
|
|
|
- gnuplot can now return it's string output -- when session is
|
|
|
- set to "none"
|
|
|
-- prevent quoting of strings in shell variables
|
|
|
-- now including source code block arguments w/source name on
|
|
|
- export
|
|
|
-- now able to reference file links as results
|
|
|
-- allow pdf/png generation directly from latex source blocks
|
|
|
+ set to "none".
|
|
|
+- Now including source code block arguments w/source name on
|
|
|
+ export.
|
|
|
+- Now able to reference file links as results.
|
|
|
+- Allow pdf/png generation directly from latex source blocks
|
|
|
+ with :file header argument.
|
|
|
|
|
|
|
|
|
* Version 6.34
|
|
@@ -573,7 +649,7 @@ call function to do something special with text links.
|
|
|
|
|
|
Thanks to Paul Sexton for this contribution.
|
|
|
|
|
|
-**** Add Jan Böker's org-docview.el
|
|
|
+**** Add Jan Böcker's org-docview.el
|
|
|
|
|
|
This new module allows links to various file types using docview,
|
|
|
where Emacs displays images of document pages. Docview link
|
|
@@ -582,7 +658,7 @@ page 131 of the Org-mode manual:
|
|
|
|
|
|
: [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]]
|
|
|
|
|
|
-Thanks to Jan Böker for this contribution.
|
|
|
+Thanks to Jan Böcker for this contribution.
|
|
|
|
|
|
**** New link types that force special ways of opening the file
|
|
|
|