diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS index 2de5f62db..6f52c4f13 100644 --- a/etc/ORG-NEWS +++ b/etc/ORG-NEWS @@ -9,14 +9,21 @@ See the end of the file for license conditions. Please send Org bug reports to mailto:emacs-orgmode@gnu.org. * Version 9.0 + ** Incompatible changes + *** Emacs 23 support has been dropped + From now on, Org expects at least Emacs 24.3, although Emacs 24.4 or above is suggested. + *** XEmacs support has been dropped + Incomplete compatibility layer with XEmacs has been removed. If you want to preserve this compatibility, you can contact our mailing list. + *** New syntax for export blocks + Export blocks are explicitly marked as such at the syntax level to disambiguate their parsing from special blocks. The new syntax is @@ -86,21 +93,27 @@ and ~org-export-define-derived-backend~ is no longer used and needs to be removed. *** Footnotes + **** [1]-like constructs are not valid footnotes + Using =[1]= as a footnote was already discouraged in the manual, since it introduced too many false-positives in many Org documents. These constructs are now unsupported. If you used =[N]= in some of your documents, consider turning them into =[fn:N]=. + **** /Org Footnote/ library doesn't handle non-Org buffers + Commands for footnotes in an Org document no longer try to do something in non-Org ones. If you need to have footnotes there, consider using =footnote.el= library, shipped with Emacs. In particular, ~org-footnote-tag-for-non-org-mode-files~ no longer exists. + *** ~org-file-apps~ no longer accepts S-expressions as commands + The variable now accepts functions of two arguments instead of plain S-expressions. Replacing a S-expresion with an appropriate function is straightforward. For example @@ -110,14 +123,20 @@ is straightforward. For example becomes : ("pdf" . (lambda (file link) (foo))) + *** The ~{{{modification-time}}}~ macro can obtain time via =vc= + The modification time will be determined via =vc.el= if the second argument is non-nil. See the manual for details. + *** Preparation and completion functions in publishing projects change signature + Preparation and completion functions are now called with an argument, which is the project property list. It used to be dynamically scoped through the ~project-plist~ variable. + *** Old Babel header properties are no longer supported + Using header arguments as property names is no longer possible. As such, the following @@ -143,8 +162,11 @@ should be written instead Please note that, however, old properties were defined at the source block definition. Current ones are defined where the block is called. + ** New features + *** ~org-eww~ is moved into core + *** New org-protocol key=value syntax Org-protocol can now handle query-style parameters such as: @@ -165,47 +187,66 @@ list (for new-style links) or a string (for old-style links). Use property lists. *** Org linter + ~org-lint~ can check syntax and report common issues in Org documents. + *** New option ~date-tree-last~ for ~org-agenda-insert-diary-strategy~ + When ~org-agenda-insert-diary-strategy~ is set to ~date-tree-last~, diary entries are added to last in the date tree. + *** New ~vbar~ entity + ~\vbar~ or ~\vbar{}~ will be exported unconditionnally as a =|=, unlike to existing ~\vert~, which is expanded as ~|~ when using a HTML derived export back-end. + *** Export + **** New =#+latex_compiler= keyword to set LaTeX compiler. + PDFLaTeX, XeLaTeX, and LuaLaTeX are supported. See the manual for details. + **** New option ~org-export-with-broken-links~ + This option tells the export process how to behave when encountering a broken internal link. See its docstring for more information. **** Attributes support in custom language environments for LaTeX export + Custom language environments for LaTeX export can now define the string to be inserted during export, using attributes to indicate the position of the elements. See variable ~org-latex-custom-lang-environments~ for more details. **** New Texinfo ~options~ attribute on special blocks + Using ~:options~ as a Texinfo attribute, it is possible to add information to custom environments. See manual for details. + **** New HTML ~id~ attributes on special, example and quote blocks + If the block has a =#+NAME:= attribute assigned, then the HTML element will have an ~id~ attribute with that name in the HTML export. This enables one to create links to these elements in other places, e.g., ~text~. + **** Listings with captions are now numbered in HTML export + The class associated to the numbering is "listing-number". If you don't want these blocks to be numbered, as it was the case until now, You may want to add ~.listing-number { display: none; }~ to the CSS used. + **** Line Numbering in SRC/EXAMPLE blocks support arbitrary start number + The ~-n~ option to ~SRC~ and ~EXAMPLE~ blocks can now take a numeric argument to specify the staring line number for the source or example block. The ~+n~ option can now take a numeric argument that will be added to the last line number from the previous block as the starting point for the SRC/EXAMPLE block. + #+BEGIN_SRC org ,#+BEGIN_SRC emacs-lisp -n 20 ;; this will export with line number 20 @@ -216,27 +257,40 @@ point for the SRC/EXAMPLE block. (message "This is line 32") ,#+END_SRC #+END_SRC + **** Allow toggling center for images in LaTeX export + With the global variable ~org-latex-images-centered~ or the local attribute ~:center~ it is now possible to center an image in LaTeX export. + **** Default CSS class ~org-svg~ for SVG images in HTML export + SVG images exported in HTML are now by default assigned a CSS class ~org-svg~ if no CSS class is specified with the ~:class~ attribute. By default, the CSS styling of class ~org-svg~ specifies an image width of 90\thinsp{}% of the container the image. + **** Markdown footnote export customization + Variables ~org-md-footnotes-section~ and ~org-md-footnote-format~ introduced for =ox-md.el=. Both new variables define template strings which can be used to customize the format of the exported footnotes section and individual footnotes, respectively. + *** Babel + **** Blocks with coderefs labels can now be evaluated + The labels are removed prior to evaluating the block. + **** Support for Lua language **** Support for SLY in Lisp blocks + See ~org-babel-lisp-eval-fn~ to activate it. + **** Support for Stan language + New ob-stan.el library. Evaluating a Stan block can produce two different results. @@ -254,7 +308,9 @@ Evaluating a Stan block can produce two different results. For more information and usage examples, visit http://orgmode.org/worg/org-contrib/babel/languages/ob-doc-stan.html + **** Support for Oracle databases via ~sqlplus~ + =ob-sql= library supports running SQL blocks against an Oracle database using ~sqlplus~. Use with properties like this (all mandatory): @@ -267,7 +323,9 @@ mandatory): :database :dbpassword #+END_EXAMPLE + **** Improved support to Microsoft SQL Server via ~sqlcmd~ + =ob-sql= library removes support to the ~msosql~ engine which uses the deprecated ~osql~ command line tool, and replaces it with ~mssql~ engine which uses the ~sqlcmd~ command line tool. Use with properties @@ -287,10 +345,14 @@ properties. If your Emacs is running in a Cygwin environment, the =ob-sql= library can pass the converted path to the =sqlcmd= tool. + **** Improved support of header arguments for postgresql + The postgresql engine in a sql code block supports now ~:dbport~ nd ~:dbpassword~ as header arguments. + **** Support for additional plantuml output formats + The support for output formats of [[http://plantuml.com/][plantuml]] has been extended to now include: @@ -326,20 +388,28 @@ Alice <-- Bob: another authentication Response Please note that *pdf* *does not work out of the box* and needss additional setup in addition to plantuml. See [[http://plantuml.com/pdf.html]] for details and setup information. + *** Rewrite of radio lists + Radio lists, i.e, Org plain lists in foreign buffers, have been rewritten to be on par with Radio tables. You can use a large set of parameters to control how a given list should be rendered. See manual for details. + *** org-bbdb-anniversaries-future + Used like org-bbdb-anniversaries, it provides a few days warning for upcoming anniversaries (default: 7 days). + *** Clear non-repeated SCHEDULED upon repeating a task + If the task is repeated, and therefore done at least one, scheduling information is no longer relevant. It is therefore removed. See [[git:481719fbd5751aaa9c672b762cb43aea8ee986b0][commit message]] for more information. + *** Support for ISO week trees + ISO week trees are an alternative date tree format that orders entries by ISO week and not by month. @@ -352,76 +422,120 @@ For example: They are supported in org-capture via ~file+weektree~ and ~file+weektree+prompt~ target specifications. + *** Accept ~:indent~ parameter when capturing column view + When defining a "columnview" dynamic block, it is now possible to add an :indent parameter, much like the one in the clock table. On the other hand, stars no longer appear in an ITEM field. + *** Columns view + **** ~org-columns~ accepts a prefix argument -pWhen called with a prefix argument, ~org-columns~ apply to the whole + +When called with a prefix argument, ~org-columns~ apply to the whole buffer unconditionally. + **** New variable : ~org-agenda-view-columns-initially~ + The variable used to be a ~defvar~, it is now a ~defcustom~. + **** Allow custom summaries + It is now possible to add new summary types, or override those provided by Org by customizing ~org-columns-summary-types~, which see. + **** Allow multiple summaries for any property + Columns can now summarize the same property using different summary types. + *** Preview LaTeX snippets in buffers not visiting files *** New option ~org-attach-commit~ + When non-nil, commit attachments with git, assuming the document is in a git repository. + *** Allow conditional case-fold searches in ~org-occur~ + When set to ~smart~, the new variable ~org-occur-case-fold-search~ allows to mimic =isearch.el=: if the regexp searched contains any upper case character (or character class), the search is case sensitive. Otherwise, it is case insensitive. + *** More robust repeated =ox-latex= footnote handling + Repeated footnotes are now numbered by referring to a label in the first footnote. + *** The ~org-block~ face is inherited by ~src-blocks~ + This works also when =org-src-fontify-natively= is non-nil. It is also possible to specify per-languages faces. See =org-src-block-faces= and the manual for details. + *** Links are now customizable + Links can now have custom colors, tooltips, keymaps, display behavior, -etc... Links are now centralized in ~org-link-parameters~. +etc. Links are now centralized in ~org-link-parameters~. + ** New functions + *** ~org-next-line-empty-p~ + It replaces the deprecated ~next~ argument to ~org-previous-line-empty-p~. + *** ~org-show-children~ + It is a faster implementation of ~outline-show-children~. ** Removed functions + *** ~org-agenda-filter-by-tag-refine~ has been removed. + Use ~org-agenda-filter-by-tag~ instead. + *** ~org-agenda-todayp~ is deprecated. + Use ~org-agenda-today-p~ instead. + *** ~org-babel-get-header~ is removed. + Use ~org-babel--get-vars~ or ~assq~ instead, as applicable. + *** ~org-babel-trim~ is deprecated. + Use ~org-trim~ instead. + *** ~org-element-remove-indentation~ is deprecated. + Use ~org-remove-indentation~ instead. + *** ~org-image-file-name-regexp~ is deprecated + Use ~image-file-name-regexp~ instead. The never-used-in-core ~extensions~ argument has been dropped. *** ~org-list-parse-list~ is deprecated + Use ~org-list-to-lisp~ instead. + *** ~org-on-heading-p~ is deprecated + A comment to this effect was in the source code since 7.8.03, but now a byte-compiler warning will be generated as well. *** ~org-table-p~ is deprecated + Use ~org-at-table-p~ instead. *** ~org-table-recognize-table.el~ is deprecated + It was not called by any org code since 2010. *** Various reimplementations of cl-lib functions are deprecated + The affected functions are: - ~org-count~ - ~org-remove-if~ @@ -435,36 +549,46 @@ the differences in indexing conventions: ~org-sublist~ is 1-based and end-inclusive; ~cl-subseq~ is 0-based and end-exclusive. ** Removed options + *** Remove all options related to ~ido~ or ~iswitchb~ + This includes ~org-completion-use-iswitchb~ and ~org-completion-use-ido~. Instead Org uses regular functions, e.g., ~completion-read~ so as to let those libraries operate. + *** Remove ~org-list-empty-line-terminates-plain-lists~ + Two consecutive blank lines always terminate all levels of current plain list. + *** ~fixltx2e~ is removed from ~org-latex-default-packages-alist~ + fixltx2e is obsolete, see LaTeX News 22. + ** Miscellaneous *** Add Icelandic smart quotes *** Allow multiple receiver locations in radio tables and lists *** Allow angular links within link descriptions + It is now allowed to write, e.g., ~[[http:orgmode.org][]]~ as an equivalent to ~[[http:orgmode.org][file:unicorn.png]]~. The advantage of the former is that spaces are allowed within the path. *** Beamer export back-ends uses ~org-latex-prefer-user-labels~ - *** ~:preparation-function~ called earlier during publishing + Functions in this list are called before any file is associated to the current projet. Thus, they can be used to generate to be published Org files. *** Function ~org-remove-indentation~ changes. + The new algorithm doesn't remove TAB characters not used for indentation. *** Secure placeholders in capture templates + Placeholders in capture templates are no longer expanded recursively. However, ~%(...)~ constructs are expanded very late, so you can fill the contents of the S-exp with the replacement text of non-interactive @@ -477,25 +601,35 @@ expanded. This prevents evaluating potentially malicious code when another placeholder, e.g., ~%i~ expands to a S-exp. *** Links stored by ~org-gnus-store-link~ in nnir groups + Since gnus nnir groups are temporary, ~org-gnus-store-link~ now refers to the article's original group. *** ~org-babel-check-confirm-evaluate~ is now a function instead of a macro + The calling convention has changed. + *** HTML export table row customization changes + Variable ~org-html-table-row-tags~ has been split into ~org-html-table-row-open-tag~ and ~org-html-table-row-close-tag~. Both new variables can be either a string or a function which will be called with 6 parameters. + *** =ITEM= special property returns headline without stars *** Rename ~org-insert-columns-dblock~ into ~org-columns-insert-dblock~ + The previous name is, for the time being, kept as an obsolete alias. + *** ~org-trim~ can preserve leading indentation. + When setting a new optional argument to a non-nil value, ~org-trim~ preserves leading indentation while removing blank lines at the beginning of the string. The behavior is identical for white space at the end of the string. + *** Function ~org-info-export~ changes. + HTML links created from certain info links now point to =gnu.org= URL's rather than just to local files. For example info links such as =info:emacs#List Buffers= used to be converted to HTML links like this: @@ -508,8 +642,11 @@ Thus the new behavior is to generate this HTML link instead: : emacs#List Buffers -All emacs related info links are similarly translated plus few other =gnu.org= manuals. +All emacs related info links are similarly translated plus few other +=gnu.org= manuals. + *** Repeaters with a ~++~ interval and a time can be shifted to later today + Previously, if a recurring task had a timestamp of ~<2016-01-01 Fri 20:00 ++1d>~ and was completed on =2016-01-02= at =08:00=, the task would skip =2016-01-02= and would be rescheduled for @@ -518,27 +655,40 @@ now shift to the first possible future occurrence, even if the occurrence is later the same day the task is completed. (Timestamps already in the future are still shifted one time further into the future.) + *** ~org-mobile-action-alist~ is now a defconst + It used to be a defcustom, with a warning that it shouldn't be modified anyway. + *** ~file+emacs~ and ~file+sys~ link types are deprecated + They are still supported in Org 9.0 but will eventually be removed in a later release. Use ~file~ link type along with universal arguments to force opening it in either Emacs or with system application. + *** New defcustom ~org-babel-J-command~ stores the j command *** New defalias ~org-babel-execute:j~ + Allows J source blocks be indicated by letter j. Previously the indication letter was solely J. + *** ~org-open-line~ ignores tables at the very beginning of the buffer + When ~org-special-ctrl-o~ is non-nil, it is impractical to create a blank line above a table at the beginning of the document. Now, as a special case, ~org-open-line~ behaves normally in this situation. + *** ~org-babel-hash-show-time~ is now customizable + The experimental variable used to be more or less confidential, as a ~defvar~. + *** New ~:format~ property to parsed links + It defines the format of the original link. Possible values are: ~plain~, ~bracket~ and ~angle~. + * Version 8.3 ** Incompatible changes