From ebbf085ec715f19029a03a10236605cfcac25150 Mon Sep 17 00:00:00 2001 From: Carsten Dominik Date: Thu, 1 Apr 2010 13:15:36 +0200 Subject: [PATCH] Add the list of changes for release 6.35 --- ORGWEBPAGE/Changes.org | 529 ++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 526 insertions(+), 3 deletions(-) diff --git a/ORGWEBPAGE/Changes.org b/ORGWEBPAGE/Changes.org index 19f1b92df..5b3b05510 100644 --- a/ORGWEBPAGE/Changes.org +++ b/ORGWEBPAGE/Changes.org @@ -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. + +*** 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::=, 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 --> -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 -- 2.11.4.GIT