Add the list of changes for release 6.35
This commit is contained in:
Carsten Dominik
parent
8fdf80bb5b
commit
ebbf085ec7
|
|
@ -6,9 +6,532 @@
|
|||
|
||||
#+STARTUP: indent hidestars
|
||||
|
||||
* Version 6.34
|
||||
* Version 6.35 (in preparation)
|
||||
:PROPERTIES:
|
||||
:VISIBILITY: content
|
||||
:CUSTOM_ID: v6.35
|
||||
:END:
|
||||
|
||||
** Incompatible Changes
|
||||
|
||||
*** 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
|
||||
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.
|
||||
|
||||
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.
|
||||
|
||||
The two 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
|
||||
causes a conflict with another package you want to use.
|
||||
|
||||
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.
|
||||
|
||||
The sequence how these customizations will show up in the LaTeX
|
||||
document are:
|
||||
1. Header from =org-export-latex-classes=
|
||||
2. =org-export-latex-default-packages-alist=
|
||||
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=.
|
||||
|
||||
|
||||
*** The constant =org-html-entities= is obsolete
|
||||
|
||||
Its content is now part of the new constant =org-entities=, which
|
||||
is defined in the file org-entities.el. =org-html-entities= was
|
||||
an internal variable, but it is possible that some users did
|
||||
write code using it - this is why I am mentioning it here.
|
||||
|
||||
** Editing Convenience and Appearance
|
||||
|
||||
*** New faces for title, date, author and email address lines.
|
||||
|
||||
The keywords in these lines are now dimmed out, and the title is
|
||||
displayed in a larger font, and a special font is also used for
|
||||
author, date, and email information. This is implemented by the
|
||||
following new faces:
|
||||
|
||||
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.
|
||||
|
||||
Patch by Dan Davison
|
||||
|
||||
*** Implement a 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
|
||||
specifications. The colors will be used as either foreground or
|
||||
background color for the corresponding keyword. See also the
|
||||
variable =org-faces-easy-properties=, which governs which face
|
||||
property is affected by this setting.
|
||||
|
||||
This is really a great simplification for setting keyword faces.
|
||||
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
|
||||
|
||||
*** Improve 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
|
||||
|
||||
For paragraph text, =org-adaptive-fill-function= did not handle the
|
||||
base case of regular text which needed to be filled. This is now
|
||||
fixed. Among other things, it allows email-style ">" comments
|
||||
to be filled correctly.
|
||||
|
||||
Thanks to Dan Hackney for this patch.
|
||||
|
||||
*** Make `org-reveal' (=C-c C-r=) also decrypt encrypted entries
|
||||
|
||||
Thanks to Richard Riley for triggering this change.
|
||||
|
||||
*** Improve automatic letter selection for TODO keywords
|
||||
|
||||
When all first letters of keywords have been used, Org no assigns
|
||||
more meaningful characters based on the keywords.
|
||||
|
||||
Thanks to Mikael Fornius for this patch.
|
||||
|
||||
** Export
|
||||
|
||||
*** Much better handling of entities for LaTeX export
|
||||
|
||||
Special entities like =\therefore= and =\alpha= now know if
|
||||
they need to be in LaTeX math mode and are formatted accordingly.
|
||||
|
||||
Thanks to Ulf Stegemann for the tedious work to make this
|
||||
possible.
|
||||
|
||||
*** LaTeX export: Set coding system automatically
|
||||
|
||||
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}=.
|
||||
|
||||
*** 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.
|
||||
|
||||
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
|
||||
your preference.
|
||||
|
||||
*** Full label/reference support in HTML, Docbook, and LaTeX backends
|
||||
|
||||
=#+LABEL= definitions for tables and figures are now fully
|
||||
implemented in the LaTeX, Docbook, and HTML interfaces.
|
||||
=\ref{xxx}= is expanded to a valid link in all backends.
|
||||
|
||||
*** BEAMER export: Title of the outline frame is now customizable
|
||||
|
||||
The new option =org-outline-frame-title= allows to set the
|
||||
title for outline frames in Beamer presentations.
|
||||
|
||||
Patch by Lukasz Stelmach.
|
||||
|
||||
*** BEAMER export: fragile frames are better recognized
|
||||
|
||||
A =lstlisting= environment now also triggers the fragile option in
|
||||
a beamer frame, just like =verbatim= environments do.
|
||||
|
||||
Thanks to Eric Schulte for this patch.
|
||||
|
||||
*** BEAMER export: Protect <...> macro arguments
|
||||
|
||||
Macros for the BEAMER package can have arguments in angular
|
||||
brackets. These are now protected just like normal arguments.
|
||||
|
||||
Requested by Bill Jackson.
|
||||
|
||||
*** HTML export: Add class to outline containers using property
|
||||
|
||||
The =HTML_CONTAINER_CLASS= property can now be used to add a
|
||||
class name to the outline container of a node in HTML export.
|
||||
|
||||
*** New option =org-export-email-info= to turn off export of the email address
|
||||
|
||||
Default is actually off now.
|
||||
|
||||
*** Throw an error when creating an image from a LaTeX snippet fails
|
||||
|
||||
This behavior can be configured with the new option variable
|
||||
=org-format-latex-signal-error=.
|
||||
|
||||
** Index generation
|
||||
|
||||
Org-mode can now produce a 2-level subject index spanning an
|
||||
entire publishing project. Write index entries in your files as
|
||||
|
||||
#+begin_src org
|
||||
,* What is org-mode?
|
||||
#+index: Org-mode
|
||||
#+index: Definitions!Org-mode
|
||||
#+end_src
|
||||
|
||||
where the first line will produce an index entry /Org-mode/,
|
||||
while the second line will create /Definitions/ with a sub-item
|
||||
/Org-mode/. Three-level entries are not supported.
|
||||
|
||||
To produce the index, set
|
||||
|
||||
#+begin_src emacs-lisp
|
||||
:makeindex t
|
||||
#+end_src
|
||||
|
||||
in the project definition in =org-publish-project-alist=. You
|
||||
may have to force re-export of all files to get the index by
|
||||
using a =C-u= prefix to the publishing command:
|
||||
|
||||
#+begin_example
|
||||
C-u M-x org-publish-all
|
||||
#+end_example
|
||||
|
||||
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
|
||||
|
||||
#+begin_src org
|
||||
#+include: "theindex.inc"
|
||||
#+end_src
|
||||
|
||||
Org-mode will also create a file "theindex.org" with this include
|
||||
statement, and you can build a more complex structure (for
|
||||
example style definitions, top and home links, etc) around this
|
||||
statement. When this file already exists, it will not be
|
||||
overwritten by Org.
|
||||
|
||||
Thanks to Stefan Vollmar for initiating and driving this feature.
|
||||
|
||||
FIXME: Still need to do the LaTeX portion
|
||||
|
||||
** MobileOrg
|
||||
|
||||
*** Encrypting stage files for MobileOrg
|
||||
|
||||
Since the use of (often pubic) servers is needed for MobileOrg,
|
||||
it is now possible to encrypt the files to be staged for
|
||||
MobileOrg. Version 1.2 of MobileOrg will be needed for this
|
||||
feature, and Richard Moreland will show instructions on his
|
||||
website once that is available. Basically, on the Org-side this
|
||||
will require the following settings:
|
||||
|
||||
#+begin_src emacs-lisp
|
||||
(setq org-mobile-use-encryption t
|
||||
org-mobile-encryption-password "My_MobileOrg_Password")
|
||||
#+end_src
|
||||
|
||||
So the password will be visible in your local setup, but since
|
||||
the encryption is only for the public server, this seems
|
||||
acceptable.
|
||||
|
||||
** Agenda
|
||||
|
||||
*** Specify entry types as an option
|
||||
|
||||
Custom Agenda commands can now limit the sets of entry types
|
||||
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]].
|
||||
|
||||
Thanks to Matt Lundin for this feature.
|
||||
|
||||
*** Speed up multiple calls to org-diary by only doing buffer prep once
|
||||
|
||||
Also a patch by Matt Lundin.
|
||||
|
||||
*** Show and hide deadlines in the agenda
|
||||
|
||||
You can now hide all deadline entries in the agenda by pressing
|
||||
=!=.
|
||||
|
||||
Thanks to John Wiegley for this feature.
|
||||
|
||||
*** Agenda: Allow to suppress deadline warnings for entries also scheduled
|
||||
|
||||
The the docstring of the variable
|
||||
=org-agenda-skip-deadline-prewarning-if-scheduled=.
|
||||
|
||||
*** Expand file names in org-agenda-files (external file case)
|
||||
|
||||
If you are using a file to manage the list of agenda files, the
|
||||
names in this file can now contain environment variables and "~"
|
||||
to write them more compactly and portable.
|
||||
|
||||
Thanks to Mikael Fornius for a patch to this effect.
|
||||
|
||||
*** Agenda: Allow TODO conditions in the skip functions
|
||||
|
||||
The agenda skip function has now special support for skipping
|
||||
based on the TODO state. Here are just two examples, see the
|
||||
manual for more information.
|
||||
|
||||
#+begin_src emacs-lisp
|
||||
(org-agenda-skip-entry-if 'todo '(\"TODO\" \"WAITING\"))
|
||||
(org-agenda-skip-entry-if 'nottodo 'done)
|
||||
#+end_src
|
||||
|
||||
Thanks to Lukasz Stelmach for this patch.
|
||||
|
||||
*** Extracting the time-of-day when adding diary entries
|
||||
|
||||
The time of day can now be extracted from new diary entries made
|
||||
from the agenda with (for example) =i d=. When
|
||||
=org-agenda-insert-diary-extract-time= is set, this is done, and
|
||||
the time is moved into the time stamp.
|
||||
|
||||
Thanks to Stephen Eglen for this feature.
|
||||
|
||||
*** The TODO list: Allow skipping scheduled or deadlined entries
|
||||
|
||||
Skipping TODO entries in the global TODO list based on whether
|
||||
they are scheduled or have a deadline can now be controlled in
|
||||
more detail. Please see the docstrings of
|
||||
=org-agenda-todo-ignore-scheduled= and
|
||||
=org-agenda-todo-ignore-deadline=.
|
||||
|
||||
Thanks to Lukasz Stelmach for patches to this effect.
|
||||
|
||||
** Hyperlinks
|
||||
|
||||
*** Make =org-store-link= point to directory in a dired buffer
|
||||
|
||||
When, in a dired buffer, the cursor is not in a line listing a
|
||||
file, `org-store-link' will store a link to the directory.
|
||||
|
||||
Patch by Stephen Eglen.
|
||||
|
||||
*** Allow regexps in =org-file-apps= to capture link parameters
|
||||
|
||||
The way extension regexps in =org-file-apps= are handled has
|
||||
changed. Instead of matching against the file name, the regexps
|
||||
are now matched against the whole link, and you can use grouping
|
||||
to extract link parameters which you can then use in a command
|
||||
string to be executed.
|
||||
|
||||
For example, to allow linking to PDF files using the syntax
|
||||
=file:/doc.pdf::<page number>=, you can add the following entry to
|
||||
org-file-apps:
|
||||
|
||||
#+begin_example
|
||||
Extension: \.pdf::\([0-9]+\)\'
|
||||
Command: evince "%s" -p %1
|
||||
#+end_example
|
||||
|
||||
Thanks to Jan Böker for a patch to this effect.
|
||||
|
||||
** Clocking
|
||||
|
||||
*** Show clock overruns in mode line
|
||||
|
||||
When clocking an item with a planned effort, overrunning the
|
||||
planned time is now made visible in the mode line, for example
|
||||
using the new face =org-mode-line-clock-overrun=, or by adding an
|
||||
extra string given by =org-task-overrun-text=.
|
||||
|
||||
Thanks to Richard Riley for a patch to this effect.
|
||||
|
||||
** Tables
|
||||
|
||||
*** Repair the broken support for table.el tables again.
|
||||
|
||||
Tables created with the table.el package now finally work again
|
||||
in Org-mode. While you cannot edit the table directly in the
|
||||
buffer, you can use =C-c '= to edit it nicely in a temporary
|
||||
buffer.
|
||||
|
||||
Export of these tables to HTML seem to work without problems.
|
||||
Export to LaTeX is imperfect. If fails if the table contains
|
||||
special characters that will be replaced by the exporter before
|
||||
formatting the table. The replacement operation changes the
|
||||
length of some lines, breaking the alignment of the table fields.
|
||||
Unfortunately this is not easy to fix. It is also not an option
|
||||
to not do these replacements. The table.el LaTeX exporter will
|
||||
for example not escape "&" in table fields, causing the exported
|
||||
tables to be broken.
|
||||
|
||||
** Misc
|
||||
|
||||
*** Add 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
|
||||
=org-log-refile=.
|
||||
|
||||
Thanks to Charles Cave for this idea.
|
||||
|
||||
*** New helper functions in org-table.el
|
||||
|
||||
There are new functions to access and write to a specific table
|
||||
field. This is for hackers, and maybe for the org-babel people.
|
||||
|
||||
#+begin_example
|
||||
org-table-get
|
||||
org-table-put
|
||||
org-table-current-line
|
||||
org-table-goto-line
|
||||
#+end_example
|
||||
|
||||
*** Tables: Introduce field coordinates for formulas, improve docs
|
||||
|
||||
Calc and Emacs-Lisp formulas for tables can access the current
|
||||
field coordinates with =@#= and =$#= for row and column,
|
||||
respectively. These can be useful in some formulas. For
|
||||
example, to sequentially number the fields in a column, use
|
||||
~=@#~ as column equation.
|
||||
|
||||
Thanks to Michael Brand for this feature.
|
||||
|
||||
*** Archiving: Allow to reverse order in target node
|
||||
|
||||
The new option =org-archive-reversed-order= allows to have
|
||||
archived entries inserted in a last-on-top fashion in the target
|
||||
node.
|
||||
|
||||
Requested by Tom.
|
||||
|
||||
*** Better documentation on calc accuracy in tables
|
||||
|
||||
Thanks to Michael Brand for this fix.
|
||||
|
||||
*** Clock reports can now include the running, incomplete clock
|
||||
|
||||
If you have a clock running, and the entry being clocked falls
|
||||
into the scope when creating a clock table, the time so far spent
|
||||
can be added to the total. This behavior depends on the setting
|
||||
of =org-clock-report-include-clocking-task=. The default is
|
||||
=nil=.
|
||||
|
||||
Thanks to Bernt Hansen for this useful addition.
|
||||
|
||||
*** American-style dates are now understood by =org-read-date=
|
||||
|
||||
So when you are prompted for a date, you can now answer like this
|
||||
|
||||
#+begin_example
|
||||
2/5/3 --> 2003-02-05
|
||||
2/5 --> <CURRENT-YEAR>-02-05
|
||||
#+end_example
|
||||
|
||||
*** Update org-timer.el so that we only allow 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.
|
||||
|
||||
*** Remember: Allow to file as sibling of current clock
|
||||
|
||||
=C-3 C-c C-c= will file the remember entry as a sibling of the
|
||||
last filed entry.
|
||||
|
||||
Patch by Lukasz Stelmach.
|
||||
|
||||
*** Org-reveal: Double prefix arg show 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.
|
||||
|
||||
*** Add org-secretary.el by Juan Reyero to the contrib directory
|
||||
|
||||
Org-secretary 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
|
||||
|
||||
This introduces a new header argument :dir. For the duration of
|
||||
source block execution, default-directory is set to the value
|
||||
of this header argument. Consequences include:
|
||||
|
||||
- external interpreter processes run in that directory
|
||||
- new session processes run in that directory (but existing
|
||||
ones are unaffected)
|
||||
- relative paths for file output are relative to that directory
|
||||
|
||||
The name of a directory on a remote machine may be specified
|
||||
with tramp syntax (/user@host:path), in which case the
|
||||
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
|
||||
- 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
|
||||
|
||||
|
||||
* Version 6.34
|
||||
:PROPERTIES:
|
||||
:CUSTOM_ID: v6.34
|
||||
:END:
|
||||
|
||||
|
|
@ -50,7 +573,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öker's org-docview.el
|
||||
|
||||
This new module allows links to various file types using docview,
|
||||
where Emacs displays images of document pages. Docview link
|
||||
|
|
@ -59,7 +582,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öker for this contribution.
|
||||
|
||||
**** New link types that force special ways of opening the file
|
||||
|
||||
|
|
|
|||
Loading…
Reference in New Issue