mirror of https://github.com/Chizi123/.emacs.d.git

Chizi123
2018-11-21 e75a20334813452c6912c090d70a0de2c805f94d
commit | author | age
76bbd0 1 ORG NEWS -- history of user-visible changes.   -*- mode: org; coding: utf-8 -*-
C 2
3 #+LINK: doc https://orgmode.org/worg/doc.html#%s
4 #+LINK: git https://code.orgmode.org/bzg/org-mode/commit/%s
5
6 Copyright (C) 2012-2018 Free Software Foundation, Inc.
7 See the end of the file for license conditions.
8
9 Please send Org bug reports to mailto:emacs-orgmode@gnu.org.
10
11 * Version 9.1
12
13 ** Incompatible changes
14
15 *** Variables relative to clocksum duration are obsolete
16
17 ~org-time-clocksum-format~, ~org-time-clocksum-use-fractional~ and
18 ~org-time-clocksum-fractional-format~ are obsolete.  If you changed
19 them, consider modifying ~org-duration-format~ instead.
20
21 Variable ~org-time-clocksum-use-effort-durations~ is also obsolete.
22 Consider setting ~org-duration-units~ instead.
23
24 *** ~org-at-timestamp-p~ optional argument accepts different values
25
26 See docstrings for the allowed values.  For backward compatibility,
27 ~(org-at-timestamp-p t)~ is still supported, but should be updated
28 accordingly.
29
30 *** ~org-capture-templates~ no longer accepts S-expressions as file names
31
32 Since functions are allowed there, a straightforward way to migrate
33 is to turn, e.g.,
34
35 : (file (sexp))
36
37 into
38
39 : (file (lambda () (sexp)))
40
41 *** Deleted contributed packages
42
43 =org-ebib.el, =org-bullets.el= and =org-mime.el= have been deleted
44 from the contrib/ directory.
45
46 You can now find them here :
47
48 - https://github.com/joostkremers/ebib
49 - https://github.com/sabof/org-bullets
50 - https://github.com/org-mime/org-mime
51
52 *** Change ~org-texinfo-classes~ value
53 The value cannot support functions to create sectioning commands
54 anymore.  Also, the sectioning commands should include commands for
55 appendices.  See the docstring for more information.
56 *** Removal of ~:sitemap-sans-extension~
57
58 The publishing property is no longer recognized, as a consequence of
59 changes to site-map generation.
60
61 You can get the same functionality by setting ~:sitemap-format-entry~
62 to the following
63
64 #+BEGIN_SRC elisp
65 (lambda (entry style project)
66   (cond ((not (directory-name-p entry))
67      (format "[[file:%s][%s]]"
68          (file-name-sans-extension entry)
69          (org-publish-find-title entry project)))
70     ((eq style 'tree) (file-name-nondirectory (directory-file-name entry)))
71     (t entry)))
72 #+END_SRC
73
74 *** Change signature for ~:sitemap-function~
75
76 ~:sitemap-function~ now expects to be called with two arguments.  See
77 ~org-publish-project-alist~ for details.
78
79 *** Change signature for some properties in ~org-list-to-generic~
80
81 ~:istart~, ~:icount~, ~:iend~ and ~:isep~ now expect the type of the
82 list as their first argument.
83
84 *** Change signature for ~org-get-repeater~
85 The optional argument is now a string to extract the repeater from.
86 See docstring for details.
87
88 *** Change signature for ~org-time-string-to-time~
89 See docstring for changes.
90
91 *** Change order of items in ~org-agenda-time-grid~
92 ~org-agenda-time-grid~ gained an extra item to allow users to customize
93 the string displayed after times in the agenda. See docstring for
94 details.
95
96 *** ~tags-todo~ custom searches now include DONE keywords
97
98 Use "/!" markup when filtering TODO keywords to get only not-done TODO
99 keywords.
100
101 *** ~org-split-string~ returns ~("")~ when called on an empty string
102 It used to return nil.
103 *** Removal of =ob-scala.el=
104
105 See [[https://github.com/ensime/emacs-scala-mode/issues/114][this github issue]].
106
107 You can use =ob-scala.el= as packaged in scala-mode, available from the
108 MELPA repository.
109
110 ** New features
111 *** iCalendar export uses inheritance for TIMEZONE and LOCATION properties
112 Both these properties can be inherited during iCalendar export,
113 depending on the value of ~org-use-property-inheritance~.
114 *** iCalendar export respects a TIMEZONE property
115 Set the TIMEZONE property on an entry to specify a time zone for that
116 entry only during iCalendar export.  The property value should be
117 specified as in "Europe/London".
118 *** ~org-attach~ can move directory contents
119 When setting a new directory for an entry, org-attach offers to move
120 files over from the old directory.  Using a prefix arg will reset the
121 directory to old, ID based one.
122 *** New Org duration library
123 This new library implements tools to read and print time durations in
124 various formats (e.g., "H:MM", or "1d 2h 3min"...).
125
126 See ~org-duration-to-minutes~ and ~org-duration-from-minutes~
127 docstrings.
128
129 *** Agenda
130 **** New variable : ~org-agenda-show-future-repeats~
131 **** New variable : ~org-agenda-prefer-last-repeat~
132 **** New variable : ~org-deadline-past-days~
133 See docstring for details.
134 **** Binding C-c C-x < for ~org-agenda-set-restriction-lock-from-agenda~
135 **** New auto-align default setting for =org-agenda-tags-column=
136
137 =org-agenda-tags-column= can now be set to =auto=, which will
138 automatically align tags to the right edge of the window.  This is now
139 the default setting.
140
141 *** New value for ~org-publish-sitemap-sort-folders~
142
143 The new ~ignore~ value effectively allows toggling inclusion of
144 directories in published site-maps.
145
146 *** Babel
147
148 **** Scheme: support for tables
149 **** Scheme: new variable: ~org-babel-scheme-null-to~
150
151 This new custom option allows you to use an empty list or null symbol to
152 format the table output, initially assigned to ~hlines~.
153
154 **** Scheme: new header ~:prologue~
155
156 A new block code header has been created for Org Babel that enables
157 developers to prepend code to the scheme block being processed.
158
159 Multiple ~:prologue~ headers can be added each of them using a string
160 with the content to be added.
161
162 The scheme blocks are prepared by surrounding the code in the block
163 with a let form. The content of the ~:prologue~ headers are prepended
164 before this let form.
165
166 **** Support for hledger accounting reports added
167 **** Clojure: new setting ~org-babel-clojure-sync-nrepl-timeout~
168
169 Creation of a new setting to specify the Cider timeout.  By setting
170 the =org-babel-clojure-sync-nrepl-timeout= setting option.  The value
171 is in seconds and if set to =nil= then no timeout will occur.
172 **** Clojure: new header ~:show-process~
173
174 A new block code header has been created for Org Babel that enables
175 developers to output the process of an ongoing process into a new
176 window/buffer.
177
178 You can tell Org Babel to output the process of a running code block.
179
180 To show that output you only have to specify the =:show-process=
181 option in the code block's header like this:
182
183 #+begin_example
184 ,#+BEGIN_SRC clojure :results output :show-process t
185   (dotimes [n 10]
186     (println n ".")
187     (Thread/sleep 500))
188 ,#+END_SRC
189 #+end_example
190
191 If =:show-process= is specified that way, then when you will run the
192 code using =C-c C-c= a new window will open in Emacs.  Everything that
193 is output by the REPL will immediately be added to that new window.
194
195 When the processing of the code is finished, then the window and its
196 buffer will be closed and the results will be reported in the
197 =#+RESULTS= section.
198
199 Note that the =:results= parameter's behavior is *not* changed.  If
200 =silent= is specified, then no result will be displayed.  If =output=
201 is specified then all the output from the window will appears in the
202 results section.  If =value= is specified, then only the last returned
203 value of the code will be displayed in the results section.
204
205 **** Maxima: new headers ~:prologue~ and ~:epilogue~
206 Babel options ~:prologue~ and ~:epilogue~ have been implemented for
207 Maxima src blocks which prepend and append, respectively, the given
208 code strings.  This can be useful for specifying formatting settings
209 which would add clutter to exported code.  For instance, you can use
210 this ~:prologue "fpprintprec: 2; linel: 50;"~ for presenting Maxima
211 results in a beamer presentation.
212 **** PlantUML: add support for header arguments
213
214 [[http://plantuml.com/][Plantuml]] source blocks now support the [[https://orgmode.org/manual/prologue.html#prologue][~:prologue~]], [[https://orgmode.org/manual/epilogue.html#epilogue][~:epilogue~]] and
215 [[https://orgmode.org/manual/var.html#var][~:var~]] header arguments.
216
217 **** SQL: new engine added ~sqsh~
218
219 A new engine was added to support ~sqsh~ command line utility for use
220 against Microsoft SQL Server or Sybase SQL server.
221
222 More information on ~sqsh~ can be found here: [[https://sourceforge.net/projects/sqsh/][sourceforge/sqsh]]
223
224 To use ~sqsh~ in an *sql* =SRC_BLK= set the =:engine= like this:
225
226 #+begin_example
227 ,#+BEGIN_SRC sql :engine sqsh :dbhost my_host :dbuser master :dbpassword pass :database support
228 Select * From Users
229 Where clue > 0
230 ,#+END_SRC
231 #+end_example
232
233 **** SQL: new engine added =vertica=
234
235 A new engine was added to support vsql command line utility for use
236 against HP Vertica.
237
238 More information on =vsql= can be found here: [[https://my.vertica.com/docs/7.2.x/HTML/index.htm#Authoring/ConnectingToHPVertica/vsql/UsingVsql.htm][my.vertica.com]]
239
240 To use =vertica= in an sql =SRC_BLK= set the =:engine= like this:
241
242 #+BEGIN_EXAMPLE
243   ,#+BEGIN_SRC sql :engine vertica :dbhost my_host :dbuser dbadmin :dbpassword pw :database vmart
244   SELECT * FROM nodes;
245   ,#+END_SRC
246 #+END_EXAMPLE
247 **** C++: New header ~:namespaces~
248
249 The new ~:namespaces~ export option can be used to specify namespaces
250 to be used within a C++ org source block.  Its usage is similar to
251 ~:includes~, in that it can accept multiple, space-separated
252 namespaces to use.  This header is equivalent to adding ~using
253 namespace <name>;~ in the source block. Here is a "Hello World" in C++
254 using ~:namespaces~:
255
256 #+begin_example
257   ,#+BEGIN_SRC C++ :results output :namespaces std :includes <iostream>
258     cout << "Hello World" << endl;
259   ,#+END_SRC
260 #+end_example
261
262 **** Support for Vala language
263
264 [[https://wiki.gnome.org/Projects/Vala][Vala]] language blocks support two special header arguments:
265
266 - ~:flags~ passes arguments to the compiler
267 - ~:cmdline~ passes commandline arguments to the generated executable
268
269 Support for [[https://orgmode.org/manual/var.html#var][~:var~]] does not exist yet, also there is no [[https://orgmode.org/manual/session.html#session][~:session~]]
270 support because Vala is a compiled language.
271
272 The Vala compiler binary can be changed via the ~defcustom~
273 ~org-babel-vala-compiler~.
274
275 *** New ~function~ scope argument for the Clock Table
276 Added a nullary function that returns a list of files as a possible
277 argument for the scope of the clock table.
278 *** Export
279 **** Implement vernacular table of contents in Markdown exporter
280 Global table of contents are generated using vanilla Markdown syntax
281 instead of HTML.  Also #+TOC keyword, including local table of
282 contents, are now supported.
283 **** Add Slovenian translations
284 **** Implement ~org-export-insert-image-links~
285 This new function is meant to be used in back-ends supporting images
286 as descriptions of links, a.k.a. image links.  See its docstring for
287 details.
288 **** New macro : ~{{{n}}}~
289 This macro creates and increment multiple counters in a document.  See
290 manual for details.
291 **** Add global macros through ~org-export-global-macros~
292 With this variable, one can define macros available for all documents.
293 **** New keyword ~#+EXPORT_FILE_NAME~
294 Similarly to ~:EXPORT_FILE_NAME:~ property, this keyword allows the
295 user to specify the name of the output file upon exporting the
296 document.  This also has an effect on publishing.
297 **** Horizontal rules are no longer ignored in LaTeX table math mode
298 **** Use ~compilation-mode~ for compilation output
299 **** Plain lists accept a new ~:separator~ attribute in Texinfo
300
301 The new ~:separator~ attribute splits a tag from a description list
302 item into multiple parts.  This allows to have two-column tables with
303 multiple entries in the first column.  See manual for more details.
304
305 **** ~latex-environment~ elements support ~caption~ keywords for LaTeX export
306 *** ~org-edit-special~ can edit LaTeX environments
307
308 Using ~C-c '~ on a LaTeX environment opens a sub-editing buffer.  By
309 default, major mode in that buffer is ~latex-mode~, but it can be
310 changed by configuring ~org-src-lang-modes~.
311
312 *** ~org-list-to-generic~ includes a new property: ~:ifmt~
313
314 ~:ifmt~ is a function to be called on the body of each item.  See
315 ~org-list-to-generic~ documentation for details.
316
317 *** New variable : ~org-bibtex-headline-format-function~
318 This allow to use a different title than entry title.
319
320 *** ~org-attach~ supports attaching files from URLs
321
322 Using ~C-c C-a u~ prompts for a URL pointing to a file to be attached
323 to the document.
324
325 *** New option for ~org-refile-use-outline-path~
326 ~org-refile-use-outline-path~ now supports the setting ~buffer-name~,
327 which causes refile targets to be prefixed with the buffer’s
328 name. This is particularly useful when used in conjunction with
329 ~uniquify.el~.
330
331 *** ~org-file-contents~ now allows the FILE argument to be a URL.
332 This allows ~#+SETUPFILE:~ to accept a URL instead of a local file
333 path.  The URL contents are auto-downloaded and saved to a temporary
334 cache ~org--file-cache~.  A new optional argument ~NOCACHE~ is added
335 to ~org-file-contents~.
336
337 *** ~org-mode-restart~ now resets the newly added ~org--file-cache~.
338 Using ~C-c C-c~ on any keyword (like ~#+SETUPFILE~) will reset the
339 that file cache.
340
341 *** New option : ~org-table-duration-hour-zero-padding~
342 This variable allow computed durations in tables to be zero-padded.
343
344 *** New mode switch for table formulas : =U=
345 This mode omits seconds in durations.
346
347 ** Removed functions
348
349 *** Org Timeline
350
351 This feature has been removed.  Use a custom agenda view, possibly
352 narrowed to current buffer to achieve a similar functionality.
353
354 *** ~org-agenda-skip-entry-when-regexp-matches~ is obsolete
355
356 Use ~org-agenda-skip-if~ instead.
357
358 *** ~org-agenda-skip-subtree-when-regexp-matches~ is obsolete
359
360 Use ~org-agenda-skip-if~ instead.
361
362 *** ~org-agenda-skip-entry-when-regexp-matches-in-subtree~ is obsolete
363
364 Use ~org-agenda-skip-if~ instead.
365
366 *** ~org-minutes-to-clocksum-string~ is obsolete
367
368 Use ~org-duration-from-minutes~ instead.
369
370 *** ~org-hh:mm-string-to-minutes~ is obsolete
371
372 Use ~org-duration-to-minutes~ instead.
373
374 *** ~org-duration-string-to-minutes~ is obsolete
375
376 Use ~org-duration-to-minutes~ instead.
377
378 *** ~org-gnus-nnimap-cached-article-number~ is removed.
379
380 This function relied on ~nnimap-group-overview-filename~, which was
381 removed from Gnus circa September 2010.
382
383 ** Removed options
384
385 *** ~org-agenda-repeating-timestamp-show-all~ is removed.
386
387 For an equivalent to a ~nil~ value, set
388 ~org-agenda-show-future-repeats~ to nil and
389 ~org-agenda-prefer-last-repeat~ to ~t~.
390
391 *** ~org-gnus-nnimap-query-article-no-from-file~ is removed.
392
393 This variable has no effect, as it was relying on a function that was
394 removed from Gnus circa September 2010.
395
396 *** ~org-usenet-links-prefer-google~ is obsolete.
397
398 Use ~org-gnus-prefer-web-links~ instead.
399
400 *** ~org-publish-sitemap-file-entry-format~ is deprecated
401
402 One can provide new ~:sitemap-format-entry~ property for a function
403 equivalent to the removed format string.
404
405 *** ~org-enable-table-editor~ is removed.
406
407 Setting it to a ~nil~ value broke some other features (e.g., speed
408 keys).
409
410 *** ~org-export-use-babel~ cannot be set to ~inline-only~
411
412 The variable is now a boolean.
413
414 *** ~org-texinfo-def-table-markup~ is obsolete
415
416 Use ~org-texinfo-table-default-markup~ instead.
417
418 ** New functions
419
420 *** ~org-publish-find-property~
421
422 This function can be used as a tool to format entries in a site-map,
423 in addition to ~org-publish-find-title~ and ~org-publish-find-date~.
424
425 *** ~org-list-to-org~
426
427 It is the reciprocal of ~org-list-to-lisp~, which see.
428
429 *** ~org-agenda-set-restriction-lock-from-agenda~
430
431 Call ~org-agenda-set-restriction-lock~ from the agenda.
432
433 ** Miscellaneous
434
435 *** The Library of Babel now on Worg
436
437 The library-of-babel.org used to be accessible from the =doc/=
438 directory, distributed with Org’s core.  It is now accessible
439 from the Worg community-driven documentation [[https://orgmode.org/worg/library-of-babel.html][here]].
440
441 If you want to contribute to it, please see [[https://orgmode.org/worg/org-contribute.html][how to contribute]].
442
443 *** Allow multiple columns view
444
445 Columns view is not limited to a single buffer anymore.
446 *** Org Attach obeys ~dired-dwim-target~
447
448 When a Dired buffer is opened next to the Org document being edited,
449 the prompt for file to attach can start in the Dired buffer's
450 directory if `dired-dwim-target' in non-nil.
451
452 *** ~org-fill-paragraph~ can now fill a whole region
453 *** More specific anniversary descriptions
454
455 Anniversary descriptions (used in the agenda view, for instance)
456 include the point in time, when the anniversary appears.  This is,
457 in its most general form, just the date of the anniversary.  Or
458 more specific terms, like "today", "tomorrow" or "in n days" are
459 used to describe the time span.
460
461 This feature allows to automatically change the description of an
462 anniversary, depending on if it occurs in the next few days or
463 far away in the future.
464
465 *** Computed dates in tables appear as inactive time stamps
466
467 *** Save point before opening a file with an unknown search option
468
469 When following a file link with a search option (e.g., =::#custom-id=)
470 that doesn't exist in the target file, save position before raising an
471 error.  As a consequence, it is possible to jump back to the original
472 document with ~org-mark-ring-goto~ (default binding =C-c &=).
473
474 *** ~org-get-heading~ accepts two more optional arguments
475
476 See docstring for details.
477
478 *** New option ~org-babel-uppercase-example-markers~
479
480 This variable is a ~defcustom~ and replaces the variable
481 ~org-babel-capitalize-example-region-markers~, which is a ~defvar~ and
482 is now obsolete.
483 *** =INCLUDE= keywords in commented trees are now ignored.
484 *** Default value for ~org-texinfo-text-markup-alist~ changed.
485
486 Now ~=...=~ markup uses ~@samp{}~ instead of ~@verb{}~.  You can use
487 ~@verb{}~ again by customizing the variable.
488 *** Texinfo exports example blocks as ~@example~
489 *** Texinfo exports inline src blocks as ~@code{}~
490 *** Texinfo default table markup is ~@asis~
491 It used to be ~@samp~ but ~@asis~ is neutral and, therefore, more
492 suitable as a default value.
493 *** Texinfo default process includes ~--no-split~ option
494 *** New entities : ~\dollar~ and ~\USD~
495 *** Support for date style URLs in =org-protocol://open-source=
496     URLs like =https://cool-blog.com/2017/05/20/cool-post/= are
497     covered by rewrite rules.
498
499 *** Add (C) =COMMENT= support to ~org-structure-template-alist~
500
501 * Version 9.0
502
503 ** Incompatible changes
504
505 *** Emacs 23 support has been dropped
506
507 From now on, Org expects at least Emacs 24.3, although Emacs 24.4 or
508 above is suggested.
509
510 *** XEmacs support has been dropped
511
512 Incomplete compatibility layer with XEmacs has been removed.  If you
513 want to take over maintenance of this compatibility, please contact
514 our mailing list.
515
516 *** New syntax for export blocks
517
518 Export blocks are explicitly marked as such at the syntax level to
519 disambiguate their parsing from special blocks.  The new syntax is
520
521 #+BEGIN_SRC org
522 ,#+BEGIN_EXPORT backend
523 ...
524 ,#+END_EXPORT
525 #+END_SRC
526
527 instead of
528
529 #+BEGIN_SRC org
530 ,#+BEGIN_backend
531 ...
532 ,#+END_backend
533 #+END_SRC
534
535 As a consequence, =INCLUDE= keywords syntax is modified, e.g.,
536
537 #+BEGIN_SRC org
538 ,#+INCLUDE: "file.org" HTML
539 #+END_SRC
540
541 becomes
542
543 #+BEGIN_SRC org
544 ,#+INCLUDE: "file.org" export html
545 #+END_SRC
546
547 The following function repairs export blocks and =INCLUDE= keywords
548 using previous syntax:
549
550 #+BEGIN_SRC emacs-lisp
551 (defun org-repair-export-blocks ()
552   "Repair export blocks and INCLUDE keywords in current buffer."
553   (interactive)
554   (when (eq major-mode 'org-mode)
555     (let ((case-fold-search t)
556           (back-end-re (regexp-opt
557                         '("HTML" "ASCII" "LATEX" "ODT" "MARKDOWN" "MD" "ORG"
558                           "MAN" "BEAMER" "TEXINFO" "GROFF" "KOMA-LETTER")
559                         t)))
560       (org-with-wide-buffer
561        (goto-char (point-min))
562        (let ((block-re (concat "^[ \t]*#\\+BEGIN_" back-end-re)))
563          (save-excursion
564            (while (re-search-forward block-re nil t)
565              (let ((element (save-match-data (org-element-at-point))))
566                (when (eq (org-element-type element) 'special-block)
567                  (save-excursion
568                    (goto-char (org-element-property :end element))
569                    (save-match-data (search-backward "_"))
570                    (forward-char)
571                    (insert "EXPORT")
572                    (delete-region (point) (line-end-position)))
573                  (replace-match "EXPORT \\1" nil nil nil 1))))))
574        (let ((include-re
575               (format "^[ \t]*#\\+INCLUDE: .*?%s[ \t]*$" back-end-re)))
576          (while (re-search-forward include-re nil t)
577            (let ((element (save-match-data (org-element-at-point))))
578              (when (and (eq (org-element-type element) 'keyword)
579                         (string= (org-element-property :key element) "INCLUDE"))
580                (replace-match "EXPORT \\1" nil nil nil 1)))))))))
581 #+END_SRC
582
583 Moreover, ~:export-block~ keyword used in ~org-export-define-backend~ and
584 ~org-export-define-derived-backend~ is no longer used and needs to be
585 removed.
586
587 *** Footnotes
588
589 **** [1]-like constructs are not valid footnotes
590
591 Using =[1]= as a footnote was already discouraged in the manual, since
592 it introduced too many false-positives in many Org documents.  These
593 constructs are now unsupported.
594
595 If you used =[N]= in some of your documents, consider turning them into
596 =[fn:N]=.
597
598 **** /Org Footnote/ library doesn't handle non-Org buffers
599
600 Commands for footnotes in an Org document no longer try to do
601 something in non-Org ones.  If you need to have footnotes there,
602 consider using the =footnote.el= library, shipped with Emacs.
603
604 In particular, ~org-footnote-tag-for-non-org-mode-files~ no longer
605 exists.
606
607 *** ~org-file-apps~ no longer accepts S-expressions as commands
608
609 The variable now accepts functions of two arguments instead of plain
610 S-expressions.  Replacing an S-expression with an appropriate function
611 is straightforward.  For example
612
613 : ("pdf" . (foo))
614
615 becomes
616
617 : ("pdf" . (lambda (file link) (foo)))
618
619 *** The ~{{{modification-time}}}~ macro can get time via =vc=
620
621 The modification time will be determined via =vc.el= if the second
622 argument is non-nil.  See the manual for details.
623
624 *** Preparation and completion functions in publishing projects change signature
625
626 Preparation and completion functions are now called with an argument,
627 which is the project property list.  It used to be dynamically scoped
628 through the ~project-plist~ variable.
629
630 *** Old Babel header properties are no longer supported
631
632 Using header arguments as property names is no longer possible.  As
633 such, the following
634
635 #+BEGIN_EXAMPLE
636 ,* Headline
637 :PROPERTIES:
638 :exports: code
639 :var: a=1 b=2
640 :var+: c=3
641 :END:
642 #+END_EXAMPLE
643
644 should be written instead
645
646 #+BEGIN_EXAMPLE
647 ,* Headline
648 :PROPERTIES:
649 :header-args: :exports code
650 :header-args+: :var a=1 b=2
651 :header-args+: :var c=3
652 :END:
653 #+END_EXAMPLE
654
655 Please note that, however, old properties were defined at the source
656 block definition.  Current ones are defined where the block is called.
657
658 ** New features
659
660 *** ~org-eww~ has been moved into core
661 *** New org-protocol key=value syntax
662
663 Org-protocol can now handle query-style parameters such as:
664
665 #+begin_example
666 org-protocol://store-link?url=http:%2F%2Flocalhost%2Findex.html&title=The%20title
667 org-protocol://capture?template=x&title=Hello&body=World&url=http:%2F%2Fexample.com
668 #+end_example
669
670 Old-style links such as
671 : org-protocol://store-link:/http:%2F%2Flocalhost%2Findex.html/The%20title
672 continue to be supported.
673
674 If you have defined your own handler functions for
675 ~org-protocol-protocol-alist~, change them to accept either a property
676 list (for new-style links) or a string (for old-style links).  Use
677 ~org-protocol-parse-parameters~ to convert old-style links into property
678 lists.
679
680 *** New Org linter library
681
682 ~org-lint~ can check syntax and report common issues in Org documents.
683
684 *** New option ~date-tree-last~ for ~org-agenda-insert-diary-strategy~
685
686 When ~org-agenda-insert-diary-strategy~ is set to ~date-tree-last~, diary
687 entries are added to last in the date tree.
688
689 *** New ~vbar~ entity
690
691 ~\vbar~ or ~\vbar{}~ will be exported unconditionally as a =|=,
692 unlike to existing ~\vert~, which is expanded as ~&vert;~ when using
693 a HTML derived export back-end.
694
695 *** Export
696
697 **** New =#+latex_compiler= keyword to set LaTeX compiler.
698
699 PDFLaTeX, XeLaTeX, and LuaLaTeX are supported.  See the manual for
700 details.
701
702 **** New option ~org-export-with-broken-links~
703
704 This option tells the export process how to behave when encountering
705 a broken internal link.  See its docstring for more information.
706
707 **** Attributes support in custom language environments for LaTeX export
708
709 Custom language environments for LaTeX export can now define the
710 string to be inserted during export, using attributes to indicate the
711 position of the elements. See variable ~org-latex-custom-lang-environments~
712 for more details.
713
714 **** New Texinfo ~options~ attribute on special blocks
715
716 Using ~:options~ as a Texinfo attribute, it is possible to add
717 information to custom environments.  See manual for details.
718
719 **** New HTML ~id~ attributes on special, example and quote blocks
720
721 If the block has a =#+NAME:= attribute assigned, then the HTML element
722 will have an ~id~ attribute with that name in the HTML export. This
723 enables one to create links to these elements in other places, e.g.,
724 ~<a href="#name">text</a>~.
725
726 **** Listings with captions are now numbered in HTML export
727
728 The class associated to the numbering is "listing-number".  If you
729 don't want these blocks to be numbered, as it was the case until now,
730 You may want to add ~.listing-number { display: none; }~ to the CSS
731 used.
732
733 **** Line Numbering in SRC/EXAMPLE blocks support arbitrary start number
734
735 The ~-n~ option to ~SRC~ and ~EXAMPLE~ blocks can now take a numeric
736 argument to specify the staring line number for the source or example
737 block.  The ~+n~ option can now take a numeric argument that will be
738 added to the last line number from the previous block as the starting
739 point for the SRC/EXAMPLE block.
740
741 #+BEGIN_SRC org
742 ,#+BEGIN_SRC emacs-lisp -n 20
743 ;; this will export with line number 20
744 (message "This is line 21")
745 ,#+END_SRC
746 ,#+BEGIN_SRC emacs-lisp +n 10
747 ;; This will be listed as line 31
748 (message "This is line 32")
749 ,#+END_SRC
750 #+END_SRC
751
752 **** Allow toggling center for images in LaTeX export
753
754 With the global variable ~org-latex-images-centered~ or the local
755 attribute ~:center~ it is now possible to center an image in LaTeX
756 export.
757
758 **** Default CSS class ~org-svg~ for SVG images in HTML export
759
760 SVG images exported in HTML are now by default assigned a CSS class
761 ~org-svg~ if no CSS class is specified with the ~:class~ attribute. By
762 default, the CSS styling of class ~org-svg~ specifies an image width of
763 90\thinsp{}% of the container the image.
764
765 **** Markdown footnote export customization
766
767 Variables ~org-md-footnotes-section~ and ~org-md-footnote-format~
768 introduced for =ox-md.el=.  Both new variables define template strings
769 which can be used to customize the format of the exported footnotes
770 section and individual footnotes, respectively.
771
772 *** Babel
773
774 **** Blocks with coderefs labels can now be evaluated
775
776 The labels are removed prior to evaluating the block.
777
778 **** Support for Lua language
779 **** Support for SLY in Lisp blocks
780
781 See ~org-babel-lisp-eval-fn~ to activate it.
782
783 **** Support for Stan language
784
785 New ob-stan.el library.
786
787 Evaluating a Stan block can produce two different results.
788
789 1. Dump the source code contents to a file.
790
791    This file can then be used as a variable in other blocks, which
792    allows interfaces like RStan to use the model.
793
794 2. Compile the contents to a model file.
795
796    This provides access to the CmdStan interface.  To use this, set
797    ~org-babel-stan-cmdstan-directory~ and provide a ~:file~ argument
798    that does not end in ".stan".
799
800 For more information and usage examples, visit
801 https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-stan.html
802
803 **** Support for Oracle databases via ~sqlplus~
804
805 =ob-sql= library supports running SQL blocks against an Oracle
806 database using ~sqlplus~.  Use with properties like this (all
807 mandatory):
808
809 #+BEGIN_EXAMPLE
810 :engine oracle
811 :dbhost <host.com>
812 :dbport <1521>
813 :dbuser <username>
814 :database <database>
815 :dbpassword <secret>
816 #+END_EXAMPLE
817
818 **** Improved support to Microsoft SQL Server via ~sqlcmd~
819
820 =ob-sql= library removes support to the ~msosql~ engine which uses the
821 deprecated ~osql~ command line tool, and replaces it with ~mssql~
822 engine which uses the ~sqlcmd~ command line tool.  Use with properties
823 like this:
824
825 #+BEGIN_EXAMPLE
826 :engine mssql
827 :dbhost <host.com>
828 :dbuser <username>
829 :dbpassword <secret>
830 :database <database>
831 #+END_EXAMPLE
832
833 If you want to use the *trusted connection* feature, omit *both* the
834 =dbuser= and =dbpassword= properties and add =cmdline -E= to the properties.
835
836 If your Emacs is running in a Cygwin environment, the =ob-sql= library
837 can pass the converted path to the =sqlcmd= tool.
838
839 **** Improved support of header arguments for postgresql
840
841 The postgresql engine in a sql code block supports now ~:dbport~ nd
842 ~:dbpassword~ as header arguments.
843
844 **** Support for additional plantuml output formats
845
846 The support for output formats of [[http://plantuml.com/][plantuml]] has been extended to now
847 include:
848
849 All Diagrams:
850 - png ::
851 - svg ::
852 - eps ::
853 - pdf ::
854 - vdx ::
855 - txt :: ASCII art
856 - utxt :: ASCII art using unicode characters
857
858 Class Diagrams:
859 - xmi ::
860 - html ::
861
862 State Diagrams:
863 - scxml ::
864
865 The output formats are determined by the file extension specified
866 using the :file property, e.g.:
867
868 #+begin_src plantuml :file diagram.png
869 @startuml
870 Alice -> Bob: Authentication Request
871 Bob --> Alice: Authentication Response
872
873 Alice -> Bob: Another authentication Request
874 Alice <-- Bob: another authentication Response
875 @enduml
876 #+end_src
877
878 Please note that *pdf* *does not work out of the box* and needs additional
879 setup in addition to plantuml.  See [[http://plantuml.com/pdf.html]] for
880 details and setup information.
881
882 *** Rewrite of radio lists
883
884 Radio lists, i.e, Org plain lists in foreign buffers, have been
885 rewritten to be on par with Radio tables.  You can use a large set of
886 parameters to control how a given list should be rendered.  See manual
887 for details.
888
889 *** org-bbdb-anniversaries-future
890
891 Used like ~org-bbdb-anniversaries~, it provides a few days warning for
892 upcoming anniversaries (default: 7 days).
893
894 *** Clear non-repeated SCHEDULED upon repeating a task
895
896 If the task is repeated, and therefore done at least one, scheduling
897 information is no longer relevant.  It is therefore removed.
898
899 See [[git:481719fbd5751aaa9c672b762cb43aea8ee986b0][commit message]] for more information.
900
901 *** Support for ISO week trees
902
903 ISO week trees are an alternative date tree format that orders entries
904 by ISO week and not by month.
905
906 For example:
907
908 : * 2015
909 : ** 2015-W35
910 : ** 2015-W36
911 : *** 2015-08-31 Monday
912
913 They are supported in org-capture via ~file+weektree~ and
914 ~file+weektree+prompt~ target specifications.
915
916 *** Accept ~:indent~ parameter when capturing column view
917
918 When defining a "columnview" dynamic block, it is now possible to add
919 an :indent parameter, much like the one in the clock table.
920
921 On the other hand, stars no longer appear in an ITEM field.
922
923 *** Columns view
924
925 **** ~org-columns~ accepts a prefix argument
926
927 When called with a prefix argument, ~org-columns~ apply to the whole
928 buffer unconditionally.
929
930 **** New variable : ~org-agenda-view-columns-initially~
931
932 The variable used to be a ~defvar~, it is now a ~defcustom~.
933
934 **** Allow custom summaries
935
936 It is now possible to add new summary types, or override those
937 provided by Org by customizing ~org-columns-summary-types~, which see.
938
939 **** Allow multiple summaries for any property
940
941 Columns can now summarize the same property using different summary
942 types.
943
944 *** Preview LaTeX snippets in buffers not visiting files
945 *** New option ~org-attach-commit~
946
947 When non-nil, commit attachments with git, assuming the document is in
948 a git repository.
949
950 *** Allow conditional case-fold searches in ~org-occur~
951
952 When set to ~smart~, the new variable ~org-occur-case-fold-search~ allows
953 to mimic =isearch.el=: if the regexp searched contains any upper case
954 character (or character class), the search is case sensitive.
955 Otherwise, it is case insensitive.
956
957 *** More robust repeated =ox-latex= footnote handling
958
959 Repeated footnotes are now numbered by referring to a label in the
960 first footnote.
961
962 *** The ~org-block~ face is inherited by ~src-blocks~
963
964 This works also when =org-src-fontify-natively= is non-nil.  It is also
965 possible to specify per-languages faces.  See =org-src-block-faces= and
966 the manual for details.
967
968 *** Links are now customizable
969
970 Links can now have custom colors, tooltips, keymaps, display behavior,
971 etc.  Links are now centralized in ~org-link-parameters~.
972
973 ** New functions
974
975 *** ~org-next-line-empty-p~
976
977 It replaces the deprecated ~next~ argument to ~org-previous-line-empty-p~.
978
979 *** ~org-show-children~
980
981 It is a faster implementation of ~outline-show-children~.
982
983 ** Removed functions
984
985 *** ~org-agenda-filter-by-tag-refine~ has been removed.
986
987 Use ~org-agenda-filter-by-tag~ instead.
988
989 *** ~org-agenda-todayp~ is deprecated.
990
991 Use ~org-agenda-today-p~ instead.
992
993 *** ~org-babel-get-header~ is removed.
994
995 Use ~org-babel--get-vars~ or ~assq~ instead, as applicable.
996
997 *** ~org-babel-trim~ is deprecated.
998
999 Use ~org-trim~ instead.
1000
1001 *** ~org-element-remove-indentation~ is deprecated.
1002
1003 Use ~org-remove-indentation~ instead.
1004
1005 *** ~org-image-file-name-regexp~ is deprecated
1006
1007 Use ~image-file-name-regexp~ instead.
1008 The never-used-in-core ~extensions~ argument has been dropped.
1009
1010 *** ~org-list-parse-list~ is deprecated
1011
1012 Use ~org-list-to-lisp~ instead.
1013
1014 *** ~org-on-heading-p~ is deprecated
1015
1016 A comment to this effect was in the source code since 7.8.03, but
1017 now a byte-compiler warning will be generated as well.
1018
1019 *** ~org-table-p~ is deprecated
1020
1021 Use ~org-at-table-p~ instead.
1022
1023 *** ~org-table-recognize-table.el~ is deprecated
1024
1025 It was not called by any org code since 2010.
1026
1027 *** Various reimplementations of cl-lib functions are deprecated
1028
1029 The affected functions are:
1030 - ~org-count~
1031 - ~org-remove-if~
1032 - ~org-remove-if-not~
1033 - ~org-reduce~
1034 - ~org-every~
1035 - ~org-some~
1036
1037 Additionally, ~org-sublist~ is deprecated in favor of ~cl-subseq~.  Note
1038 the differences in indexing conventions: ~org-sublist~ is 1-based and
1039 end-inclusive; ~cl-subseq~ is 0-based and end-exclusive.
1040
1041 ** Removed options
1042
1043 *** Remove all options related to ~ido~ or ~iswitchb~
1044
1045 This includes ~org-completion-use-iswitchb~ and ~org-completion-use-ido~.
1046 Instead Org uses regular functions, e.g., ~completion-read~ so as to
1047 let those libraries operate.
1048
1049 *** Remove ~org-list-empty-line-terminates-plain-lists~
1050
1051 Two consecutive blank lines always terminate all levels of current
1052 plain list.
1053
1054 *** ~fixltx2e~ is removed from ~org-latex-default-packages-alist~
1055
1056 fixltx2e is obsolete, see LaTeX News 22.
1057
1058 ** Miscellaneous
1059 *** Add Icelandic smart quotes
1060 *** Allow multiple receiver locations in radio tables and lists
1061 *** Allow angular links within link descriptions
1062
1063 It is now allowed to write, e.g.,
1064 ~[[http:orgmode.org][<file:unicorn.png>]]~ as an equivalent to
1065 ~[[http:orgmode.org][file:unicorn.png]]~.  The advantage of the former
1066 is that spaces are allowed within the path.
1067
1068 *** Beamer export back-ends uses ~org-latex-prefer-user-labels~
1069 *** ~:preparation-function~ called earlier during publishing
1070
1071 Functions in this list are called before any file is associated to the
1072 current project.  Thus, they can be used to generate to be published
1073 Org files.
1074
1075 *** Function ~org-remove-indentation~ changes.
1076
1077 The new algorithm doesn't remove TAB characters not used for
1078 indentation.
1079
1080 *** Secure placeholders in capture templates
1081
1082 Placeholders in capture templates are no longer expanded recursively.
1083 However, ~%(...)~ constructs are expanded very late, so you can fill
1084 the contents of the S-exp with the replacement text of non-interactive
1085 placeholders.  As before, interactive ones are still expanded as the
1086 very last step, so the previous statement doesn't apply to them.
1087
1088 Note that only ~%(...)~ placeholders initially present in the
1089 template, or introduced using a file placeholder, i.e., ~%[...]~ are
1090 expanded.  This prevents evaluating potentially malicious code when
1091 another placeholder, e.g., ~%i~ expands to a S-exp.
1092
1093 *** Links stored by ~org-gnus-store-link~ in nnir groups
1094
1095 Since gnus nnir groups are temporary, ~org-gnus-store-link~ now refers
1096 to the article's original group.
1097
1098 *** ~org-babel-check-confirm-evaluate~ is now a function instead of a macro
1099
1100 The calling convention has changed.
1101
1102 *** HTML export table row customization changes
1103
1104 Variable ~org-html-table-row-tags~ has been split into
1105 ~org-html-table-row-open-tag~ and ~org-html-table-row-close-tag~.
1106 Both new variables can be either a string or a function which will be
1107 called with 6 parameters.
1108
1109 *** =ITEM= special property returns headline without stars
1110 *** Rename ~org-insert-columns-dblock~ into ~org-columns-insert-dblock~
1111
1112 The previous name is, for the time being, kept as an obsolete alias.
1113
1114 *** ~org-trim~ can preserve leading indentation.
1115
1116 When setting a new optional argument to a non-nil value, ~org-trim~
1117 preserves leading indentation while removing blank lines at the
1118 beginning of the string.  The behavior is identical for white space at
1119 the end of the string.
1120
1121 *** Function ~org-info-export~ changes.
1122
1123 HTML links created from certain info links now point to =gnu.org= URL's rather
1124 than just to local files. For example info links such as =info:emacs#List
1125 Buffers= used to be converted to HTML links like this:
1126
1127 : <a href="emacs.html#List-Buffers">emacs#List Buffers</a>
1128
1129 where local file =emacs.html= is referenced.
1130 For most folks this file does not exist.
1131 Thus the new behavior is to generate this HTML link instead:
1132
1133 : <a href="https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#List-Buffers">emacs#List Buffers</a>
1134
1135 All emacs related info links are similarly translated plus few other
1136 =gnu.org= manuals.
1137
1138 *** Repeaters with a ~++~ interval and a time can be shifted to later today
1139
1140 Previously, if a recurring task had a timestamp of
1141 ~<2016-01-01 Fri 20:00 ++1d>~ and was completed on =2016-01-02= at
1142 =08:00=, the task would skip =2016-01-02= and would be rescheduled for
1143 =2016-01-03=.  Timestamps with ~++~ cookies and a specific time will
1144 now shift to the first possible future occurrence, even if the
1145 occurrence is later the same day the task is completed.  (Timestamps
1146 already in the future are still shifted one time further into the
1147 future.)
1148
1149 *** ~org-mobile-action-alist~ is now a defconst
1150
1151 It used to be a defcustom, with a warning that it shouldn't be
1152 modified anyway.
1153
1154 *** ~file+emacs~ and ~file+sys~ link types are deprecated
1155
1156 They are still supported in Org 9.0 but will eventually be removed in
1157 a later release.  Use ~file~ link type along with universal arguments
1158 to force opening it in either Emacs or with system application.
1159
1160 *** New defcustom ~org-babel-J-command~ stores the j command
1161 *** New defalias ~org-babel-execute:j~
1162
1163 Allows J source blocks be indicated by letter j.  Previously the
1164 indication letter was solely J.
1165
1166 *** ~org-open-line~ ignores tables at the very beginning of the buffer
1167
1168 When ~org-special-ctrl-o~ is non-nil, it is impractical to create
1169 a blank line above a table at the beginning of the document. Now, as
1170 a special case, ~org-open-line~ behaves normally in this situation.
1171
1172 *** ~org-babel-hash-show-time~ is now customizable
1173
1174 The experimental variable used to be more or less confidential, as
1175 a ~defvar~.
1176
1177 *** New ~:format~ property to parsed links
1178
1179 It defines the format of the original link.  Possible values are:
1180 ~plain~, ~bracket~ and ~angle~.
1181
1182 * Version 8.3
1183
1184 ** Incompatible changes
1185
1186 *** Properties drawers syntax changes
1187
1188 Properties drawers are now required to be located right after a
1189 headline and its planning line, when applicable.
1190
1191 It will break some documents as TODO states changes were sometimes
1192 logged before the property drawer.
1193
1194 The following function will repair them:
1195
1196 #+BEGIN_SRC emacs-lisp
1197 (defun org-repair-property-drawers ()
1198   "Fix properties drawers in current buffer.
1199 Ignore non Org buffers."
1200   (when (eq major-mode 'org-mode)
1201     (org-with-wide-buffer
1202      (goto-char (point-min))
1203      (let ((case-fold-search t)
1204            (inline-re (and (featurep 'org-inlinetask)
1205                            (concat (org-inlinetask-outline-regexp)
1206                                    "END[ \t]*$"))))
1207        (org-map-entries
1208         (lambda ()
1209           (unless (and inline-re (org-looking-at-p inline-re))
1210             (save-excursion
1211               (let ((end (save-excursion (outline-next-heading) (point))))
1212                 (forward-line)
1213                 (when (org-looking-at-p org-planning-line-re) (forward-line))
1214                 (when (and (< (point) end)
1215                            (not (org-looking-at-p org-property-drawer-re))
1216                            (save-excursion
1217                              (and (re-search-forward org-property-drawer-re end t)
1218                                   (eq (org-element-type
1219                                        (save-match-data (org-element-at-point)))
1220                                       'drawer))))
1221                   (insert (delete-and-extract-region
1222                            (match-beginning 0)
1223                            (min (1+ (match-end 0)) end)))
1224                   (unless (bolp) (insert "\n"))))))))))))
1225 #+END_SRC
1226
1227 *** Using "COMMENT" is now equivalent to commenting with "#"
1228
1229 If you used "COMMENT" in headlines to prevent a subtree from being
1230 exported, you can still do it but all information within the subtree
1231 is now commented out, i.e. no #+OPTIONS line will be parsed or taken
1232 into account when exporting.
1233
1234 If you want to exclude a headline from export while using its contents
1235 for setting options, use =:noexport:= (see =org-export-exclude-tags=.)
1236
1237 *** =#+CATEGORY= keywords no longer apply partially to document
1238
1239 It was possible to use several such keywords and have them apply to
1240 the text below until the next one, but strongly deprecated since Org
1241 5.14 (2008).
1242
1243 =#+CATEGORY= keywords are now global to the document.  You can use node
1244 properties to set category for a subtree, e.g.,
1245
1246 #+BEGIN_SRC org
1247 ,* Headline
1248    :PROPERTIES:
1249    :CATEGORY: some category
1250    :END:
1251 #+END_SRC
1252
1253 *** New variable to control visibility when revealing a location
1254
1255 ~org-show-following-heading~, ~org-show-siblings~, ~org-show-entry-below~
1256 and ~org-show-hierarchy-above~ no longer exist.  Instead, visibility is
1257 controlled through a single variable: ~org-show-context-detail~, which
1258 see.
1259
1260 *** Replace disputed keys again when reading a date
1261
1262 ~org-replace-disputed-keys~ has been ignored when reading date since
1263 version 8.1, but the former behavior is restored again.
1264
1265 Keybinding for reading date can be customized with a new variable
1266 ~org-read-date-minibuffer-local-map~.
1267
1268 *** No default title is provided when =TITLE= keyword is missing
1269
1270 Skipping =TITLE= keyword no longer provides the current file name, or
1271 buffer name, as the title.  Instead, simply ignore the title.
1272
1273 *** Default bindings of =C-c C-n= and =C-c C-p= changed
1274
1275 The key sequences =C-c C-n= and =C-c C-p= are now bound to
1276 ~org-next-visible-heading~ and ~org-previous-visible-heading~
1277 respectively, rather than the =outline-mode= versions of these
1278 functions.  The Org version of these functions skips over inline tasks
1279 (and even-level headlines when ~org-odd-levels-only~ is set).
1280
1281 *** ~org-element-context~ no longer return objects in keywords
1282
1283 ~org-element-context~ used to return objects on some keywords, i.e.,
1284 =TITLE=, =DATE= and =AUTHOR=.  It now returns only the keyword.
1285
1286 *** ~org-timer-default-timer~ type changed from number to string
1287
1288 If you have, in your configuration, something like =(setq
1289 org-timer-default-timer 10)= replace it with =(setq
1290 org-timer-default-timer "10")=.
1291
1292 *** Functions signature changes
1293
1294 The following functions require an additional argument.  See their
1295 docstring for more information.
1296
1297 - ~org-export-collect-footnote-definitions~
1298 - ~org-html-format-headline-function~
1299 - ~org-html-format-inlinetask-function~
1300 - ~org-latex-format-headline-function~
1301 - ~org-latex-format-inlinetask-function~
1302 - ~org-link-search~
1303
1304 ** New features
1305
1306 *** Default lexical evaluation of emacs-lisp src blocks
1307
1308 Emacs-lisp src blocks in babel are now evaluated using lexical
1309 scoping.  There is a new header to control this behavior.
1310
1311 The default results in an eval with lexical scoping.
1312 :lexical yes
1313
1314 This turns lexical scoping off in the eval (the former behavior).
1315 :lexical no
1316
1317 This uses the lexical environment with x=42 in the eval.
1318 :lexical '((x . 42))
1319
1320 *** Behavior of ~org-return~ changed
1321
1322 If point is before or after the headline title, insert a new line
1323 without changing the headline.
1324
1325 *** Hierarchies of tags
1326
1327 The functionality of nesting tags in hierarchies is added to org-mode.
1328 This is the generalization of what was previously called "Tag groups"
1329 in the manual.  That term is now changed to "Tag hierarchy".
1330
1331 The following in-buffer definition:
1332
1333 #+BEGIN_SRC org
1334   ,#+TAGS: [ Group : SubOne SubTwo ]
1335   ,#+TAGS: [ SubOne : SubOne1 SubOne2 ]
1336   ,#+TAGS: [ SubTwo : SubTwo1 SubTwo2 ]
1337 #+END_SRC
1338
1339 Should be seen as the following tree of tags:
1340
1341 - Group
1342   - SubOne
1343     - SubOne1
1344     - SubOne2
1345   - SubTwo
1346     - SubTwo1
1347     - SubTwo2
1348
1349 Searching for "Group" should return all tags defined above.  Filtering
1350 on SubOne filters also it's sub-tags.  Etc.
1351
1352 There is no limit on the depth for the tag hierarchy.
1353
1354 *** Additional syntax for non-unique grouptags
1355
1356 Additional syntax is defined for grouptags if the tags in the group
1357 don't have to be distinct on a heading.
1358
1359 Grouptags had to previously be defined with { }.  This syntax is
1360 already used for exclusive tags and Grouptags need their own,
1361 non-exclusive syntax.  This behavior is achieved with [ ].  Note: { }
1362 can still be used also for Grouptags but then only one of the given
1363 tags can be used on the headline at the same time.  Example:
1364
1365 [ group : sub1 sub2 ]
1366
1367 #+BEGIN_SRC org
1368 ,* Test                                                            :sub1:sub2:
1369 #+END_SRC
1370
1371 This is a more general case than the already existing syntax for
1372 grouptags; { }.
1373
1374 *** Define regular expression patterns as tags
1375
1376 Tags can be defined as grouptags with regular expressions as
1377 "sub-tags".
1378
1379 The regular expressions in the group must be marked up within { }.
1380 Example use:
1381
1382 : #+TAGS: [ Project : {P@.+} ]
1383
1384 Searching for the tag Project will now list all tags also including
1385 regular expression matches for P@.+.  This is good for example for
1386 projects tagged with a common identifier, i.e. P@2014_OrgTags.
1387
1388 *** Filtering in the agenda on grouptags (Tag hierarchies)
1389
1390 Filtering in the agenda on grouptags filters all of the related tags.
1391 Except if a filter is applied with a (double) prefix-argument.
1392
1393 Filtering in the agenda on subcategories does not filter the "above"
1394 levels anymore.
1395
1396 If a grouptag contains a regular expression the regular expression
1397 is also used as a filter.
1398
1399 *** Minor refactoring of ~org-agenda-filter-by-tag~
1400
1401 Now uses the argument ARG and optional argument exclude instead of
1402 strip and narrow.  ARG because the argument has multiple purposes and
1403 makes more sense than strip now.  The term "narrowing" is changed to
1404 exclude.
1405
1406 The main purpose is for the function to make more logical sense when
1407 filtering on tags now when tags can be structured in hierarchies.
1408
1409 *** Babel: support for sed scripts
1410
1411 Thanks to Bjarte Johansen for this feature.
1412
1413 *** Babel: support for Processing language
1414
1415 New ob-processing.el library.
1416
1417 This library implements necessary functions for implementing editing
1418 of Processing code blocks, viewing the resulting sketches in an
1419 external viewer, and HTML export of the sketches.
1420
1421 Check the documentation for more details.
1422
1423 Thanks to Jarmo Hurri for this feature.
1424
1425 *** New behavior for ~org-toggle-latex-fragment~
1426
1427 The new behavior is the following:
1428
1429 - With a double prefix argument or with a single prefix argument when
1430   point is before the first headline, toggle overlays in the whole
1431   buffer;
1432
1433 - With a single prefix argument, toggle overlays in the current
1434   subtree;
1435
1436 - On latex code, toggle overlay at point;
1437
1438 - Otherwise, toggle overlays in the current section.
1439
1440 *** Additional markup with =#+INCLUDE= keyword
1441
1442 The content of the included file can now be optionally marked up, for
1443 instance as HTML.  See the documentation for details.
1444
1445 *** File links with =#+INCLUDE= keyword
1446
1447 Objects can be extracted via =#+INCLUDE= using file links.  It is
1448 possible to include only the contents of the object.  See manual for
1449 more information.
1450
1451 *** Drawers do not need anymore to be referenced in =#+DRAWERS=
1452
1453 One can use a drawer without listing it in the =#+DRAWERS= keyword,
1454 which is now obsolete.  As a consequence, this change also deprecates
1455 ~org-drawers~ variable.
1456
1457 *** ~org-edit-special~ can edit export blocks
1458
1459 Using C-c ' on an export block now opens a sub-editing buffer.  Major
1460 mode in that buffer is determined by export backend name (e.g.,
1461 "latex" \to "latex-mode").  You can define exceptions to this rule by
1462 configuring ~org-src-lang-modes~, which see.
1463
1464 *** Additional =:hline= processing to ob-shell
1465
1466 If the argument =:hlines yes= is present in a babel call, an optional
1467 argument =:hlines-string= can be used to define a string to use as a
1468 representation for the lisp symbol ='hline= in the shell program.  The
1469 default is =hline=.
1470
1471 *** Markdown export supports switches in source blocks
1472
1473 For example, it is now possible to number lines using the =-n= switch in
1474 a source block.
1475
1476 *** New option in ASCII export
1477
1478 Plain lists can have an extra margin by setting ~org-ascii-list-margin~
1479 variable to an appropriate integer.
1480
1481 *** New blocks in ASCII export
1482
1483 ASCII export now supports =#+BEGIN_JUSTIFYRIGHT= and =#+BEGIN_JUSTIFYLEFT=
1484 blocks.  See documentation for details.
1485
1486 *** More back-end specific publishing options
1487
1488 The number of publishing options specific to each back-end has been
1489 increased.  See manual for details.
1490
1491 *** Export inline source blocks
1492
1493 Inline source code was used to be removed upon exporting.  They are
1494 now handled as standard code blocks, i.e., the source code can appear
1495 in the output, depending on the parameters.
1496
1497 *** Extend ~org-export-first-sibling-p~ and ~org-export-last-sibling-p~
1498
1499 These functions now support any element or object, not only headlines.
1500
1501 *** New function: ~org-export-table-row-in-header-p~
1502
1503 *** New function: ~org-export-get-reference~
1504
1505 *** New function: ~org-element-lineage~
1506
1507 This function deprecates ~org-export-get-genealogy~.  It also provides
1508 more features.  See docstring for details.
1509
1510 *** New function: ~org-element-copy~
1511
1512 *** New filter: ~org-export-filter-body-functions~
1513
1514 Functions in this filter are applied on the body of the exported
1515 document, before wrapping it within the template.
1516
1517 *** New :environment parameter when exporting example blocks to LaTeX
1518
1519 : #+ATTR_LATEX: :environment myverbatim
1520 : #+BEGIN_EXAMPLE
1521 : This sentence is false.
1522 : #+END_EXAMPLE
1523
1524 will be exported using =@samp(myverbatim)= instead of =@samp(verbatim)=.
1525
1526 *** Various improvements on radio tables
1527
1528 Radio tables feature now relies on Org's export framework ("ox.el").
1529 ~:no-escape~ parameter no longer exists, but additional global
1530 parameters are now supported: ~:raw~, ~:backend~.  Moreover, there are new
1531 parameters specific to some pre-defined translators, e.g.,
1532 ~:environment~ and ~:booktabs~ for ~orgtbl-to-latex~.  See translators
1533 docstrings (including ~orgtbl-to-generic~) for details.
1534
1535 *** Non-floating minted listings in Latex export
1536
1537 It is not possible to specify =#+attr_latex: :float nil= in conjunction
1538 with source blocks exported by the minted package.
1539
1540 *** Field formulas can now create columns as needed
1541
1542 Previously, evaluating formulas that referenced out-of-bounds columns
1543 would throw an error. A new variable ~org-table-formula-create-columns~
1544 was added to adjust this behavior. It is now possible to silently add
1545 new columns, to do so with a warning or to explicitly ask the user
1546 each time.
1547
1548 *** ASCII plot
1549
1550 Ability to plot values in a column through ASCII-art bars.  See manual
1551 for details.
1552
1553 *** New hook: ~org-archive-hook~
1554
1555 This hook is called after successfully archiving a subtree, with point
1556 on the original subtree, not yet deleted.
1557
1558 *** New option: ~org-attach-archive-delete~
1559
1560 When non-nil, attachments from archived subtrees are removed.
1561
1562 *** New option: ~org-latex-caption-above~
1563
1564 This variable generalizes ~org-latex-table-caption-above~, which is now
1565 deprecated.  In addition to tables, it applies to source blocks,
1566 special blocks and images.  See docstring for more information.
1567
1568 *** New option: ~org-latex-prefer-user-labels~
1569
1570 See the docstring for more information.
1571
1572 *** Export unnumbered headlines
1573
1574 Headlines, for which the property ~UNNUMBERED~ is non-nil, are now
1575 exported without section numbers irrespective of their levels.  The
1576 property is inherited by children.
1577
1578 *** Tables can be sorted with an arbitrary function
1579
1580 It is now possible to specify a function, both programmatically,
1581 through a new optional argument, and interactively with ~f~ or ~F~ keys,
1582 to sort a table.
1583
1584 *** Table of contents can be local to a section
1585
1586 The ~TOC~ keywords now accepts an optional ~local~ parameter.  See manual
1587 for details.
1588
1589 *** Countdown timers can now be paused
1590
1591 ~org-timer-pause-time~ now pauses and restarts both relative and
1592 countdown timers.
1593
1594 *** New option ~only-window~ for ~org-agenda-window-setup~
1595
1596 When ~org-agenda-window-setup~ is set to ~only-window~, the agenda is
1597 displayed as the sole window of the current frame.
1598
1599 *** ~{{{date}}}~ macro supports optional formatting argument
1600
1601 It is now possible to supply and optional formatting argument to
1602 ~{{{date}}}~. See manual for details.
1603
1604 *** ~{{{property}}}~ macro supports optional search argument
1605
1606 It is now possible to supply an optional search option to
1607 ~{{{property}}}~ in order to retrieve remote properties optional.  See
1608 manual for details.
1609
1610 *** New option ~org-export-with-title~
1611
1612 It is possible to suppress the title insertion with ~#+OPTIONS:
1613 title:nil~ or globally using the variable ~org-export-with-title~.
1614
1615 *** New entities family: "\_ "
1616
1617 "\_ " are used to insert up to 20 contiguous spaces in various
1618 back-ends.  In particular, this family can be used to introduce
1619 leading spaces within table cells.
1620
1621 *** New MathJax configuration options
1622
1623 Org uses the MathJax CDN by default.  See the manual and the docstring
1624 of ~org-html-mathjax-options~ for details.
1625
1626 *** New behavior in `org-export-options-alist'
1627
1628 When defining a back-end, it is now possible to specify to give
1629 `parse' behavior on a keyword.  It is equivalent to call
1630 `org-element-parse-secondary-string' on the value.
1631
1632 However, parsed =KEYWORD= is automatically associated to an
1633 =:EXPORT_KEYWORD:= property, which can be used to override the keyword
1634 value during a subtree export.  Moreover, macros are expanded in such
1635 keywords and properties.
1636
1637 *** Viewport support in html export
1638
1639 Viewport for mobile-optimized website is now automatically inserted
1640 when exporting to html.  See ~org-html-viewport~ for details.
1641
1642 *** New ~#+SUBTITLE~ export keyword
1643
1644 Org can typeset a subtitle in some export backends.  See the manual
1645 for details.
1646
1647 *** Remotely edit a footnote definition
1648
1649 Calling ~org-edit-footnote-reference~ (C-c ') on a footnote reference
1650 allows to edit its definition, as long as it is not anonymous, in a
1651 dedicated buffer.  It works even if buffer is currently narrowed.
1652
1653 *** New function ~org-delete-indentation~ bound to ~M-^~
1654
1655 Work as ~delete-indentation~ unless at heading, in which case text is
1656 added to headline text.
1657
1658 *** Support for images in Texinfo export
1659
1660 ~Texinfo~ back-end now handles images.  See the manual for details.
1661
1662 *** Support for captions in Texinfo export
1663
1664 Tables and source blocks can now have captions.  Additionally, lists
1665 of tables and lists of listings can be inserted in the document with
1666 =#+TOC= keyword.
1667
1668 *** Countdown timer support hh:mm:ss format
1669
1670 In addition to setting countdown timers in minutes, they can also be
1671 set using the hh:mm:ss format.
1672
1673 *** Extend ~org-clone-subtree-with-time-shift~
1674
1675 ~org-clone-subtree-with-time-shift~ now accepts 0 as an argument for the
1676 number of clones, which removes the repeater from the original subtree
1677 and creates one shifted, repeating clone.
1678
1679 *** New time block for clock tables: ~untilnow~
1680
1681 It encompasses all past closed clocks.
1682
1683 *** Support for the ~polyglossia~ LaTeX package
1684
1685 See the docstring of ~org-latex-classes~ and
1686 ~org-latex-guess-polyglossia-language~ for details.
1687
1688 *** None-floating tables, graphics and blocks can have captions
1689
1690 *** `org-insert-heading' can be forced to insert top-level headline
1691
1692 ** Removed functions
1693
1694 *** Removed function ~org-translate-time~
1695
1696 Use ~org-timestamp-translate~ instead.
1697
1698 *** Removed function ~org-beamer-insert-options-template~
1699
1700 This function inserted a Beamer specific template at point or in
1701 current subtree.  Use ~org-export-insert-default-template~ instead, as
1702 it provides more features and covers all export back-ends.  It is also
1703 accessible from the export dispatcher.
1704
1705 *** Removed function ~org-timer-cancel-timer~
1706
1707 ~org-timer-stop~ now stops both relative and countdown timers.
1708
1709 *** Removed function ~org-export-solidify-link-text~
1710
1711 This function, being non-bijective, introduced bug in internal
1712 references.  Use ~org-export-get-reference~ instead.
1713
1714 *** Removed function ~org-end-of-meta-data-and-drawers~
1715
1716 The function is superseded by ~org-end-of-meta-data~, called with an
1717 optional argument.
1718
1719 *** Removed functions ~org-table-colgroup-line-p~, ~org-table-cookie-line-p~
1720
1721 These functions were left-over from pre 8.0 era.  They are not correct
1722 anymore.  Since they are not needed, they have no replacement.
1723
1724 ** Removed options
1725
1726 *** ~org-list-empty-line-terminates-plain-lists~ is deprecated
1727
1728 It will be kept in code base until next release, for backward
1729 compatibility.
1730
1731 If you need to separate consecutive lists with blank lines, always use
1732 two of them, as if this option was nil (default value).
1733
1734 *** ~org-export-with-creator~ is a boolean
1735
1736 Special ~comment~ value is no longer allowed.  It is possible to use a
1737 body filter to add comments about the creator at the end of the
1738 document instead.
1739
1740 *** Removed option =org-html-use-unicode-chars=
1741
1742 Setting this to non-nil was problematic as it converted characters
1743 everywhere in the buffer, possibly corrupting URLs.
1744
1745 *** Removed option =org-babel-sh-command=
1746
1747 This undocumented option defaulted to the value of =shell-file-name= at
1748 the time of loading =ob-shell=.  The new behavior is to use the value
1749 of =shell-file-name= directly when the shell langage is =shell=.  To chose
1750 a different shell, either customize =shell-file-name= or bind this
1751 variable locally.
1752
1753 *** Removed option =org-babel-sh-var-quote-fmt=
1754
1755 This undocumented option was supposed to provide different quoting
1756 styles when changing the shell type.  Changing the shell type can now
1757 be done directly from the source block and the quoting style has to be
1758 compatible across all shells, so a customization doesn't make sense
1759 anymore.  The chosen hard coded quoting style conforms to POSIX.
1760
1761 *** Removed option ~org-insert-labeled-timestamps-at-point~
1762
1763 Setting this option to anything else that the default value (nil)
1764 would create invalid planning info.  This dangerous option is now
1765 removed.
1766
1767 *** Removed option ~org-koma-letter-use-title~
1768
1769 Use org-export-with-title instead.  See also below.
1770
1771 *** Removed option ~org-entities-ascii-explanatory~
1772
1773 This variable has no effect since Org 8.0.
1774
1775 *** Removed option ~org-table-error-on-row-ref-crossing-hline~
1776
1777 This variable has no effect since August 2009.
1778
1779 *** Removed MathML-related options from ~org-html-mathjax-options~
1780
1781 MathJax automatically chooses the best display technology based on the
1782 end-users browser.  You may force initial usage of MathML via
1783 ~org-html-mathjax-template~ or by setting the ~path~ property of
1784 ~org-html-mathjax-options~.
1785
1786 *** Removed comment-related filters
1787
1788 ~org-export-filter-comment-functions~ and
1789 ~org-export-filter-comment-block-functions~ variables do not exist
1790 anymore.
1791
1792 ** Miscellaneous
1793
1794 *** Strip all meta data from ITEM special property
1795
1796 ITEM special property does not contain TODO, priority or tags anymore.
1797
1798 *** File names in links accept are now compatible with URI syntax
1799
1800 Absolute file names can now start with =///= in addition to =/=. E.g.,
1801 =[[file:///home/me/unicorn.jpg]]=.
1802
1803 *** Footnotes in included files are now local to the file
1804
1805 As a consequence, it is possible to include multiple Org files with
1806 footnotes in a master document without being concerned about footnote
1807 labels colliding.
1808
1809 *** Mailto links now use regular URI syntax
1810
1811 This change deprecates old Org syntax for mailto links:
1812 =mailto:user@domain::Subject=.
1813
1814 *** =QUOTE= keywords do not exist anymore
1815
1816 =QUOTE= keywords have been deprecated since Org 8.2.
1817
1818 *** Select tests to perform with the build system
1819
1820 The build system has been enhanced to allow test selection with a
1821 regular expression by defining =BTEST_RE= during the test invocation.
1822 This is especially useful during bisection to find just when a
1823 particular test failure was introduced.
1824
1825 *** Exact heading search for external links ignore spaces and cookies
1826
1827 Exact heading search for links now ignore spaces and cookies. This is
1828 the case for links of the form ~file:projects.org::*task title~, as well
1829 as links of the form ~file:projects.org::some words~ when
1830 ~org-link-search-must-match-exact-headline~ is not nil.
1831
1832 *** ~org-latex-hyperref-template~, ~org-latex-title-command~ formatting
1833
1834 New formatting keys are supported.  See the respective docstrings.
1835 Note, ~org-latex-hyperref-template~ has a new default value.
1836
1837 *** ~float, wasysym, marvosym~ are removed from ~org-latex-default-packages-alist~
1838
1839 If you require any of these package add them to your preamble via
1840 ~org-latex-packages-alist~. Org also uses default LaTeX ~\tolerance~ now.
1841
1842 *** When exporting, throw an error on unresolved id/fuzzy links and code refs
1843
1844 This helps spotting wrong links.
1845
1846 * Version 8.2
1847
1848 ** Incompatible changes
1849 *** =ob-sh.el= renamed to =ob-shell=
1850 This may require two changes in user config.
1851
1852 1. In =org-babel-do-load-languages=, change =(sh . t)= to =(shell . t)=.
1853 2. Edit =local.mk= files to change the value of =BTEST_OB_LANGUAGES=
1854    to remove "sh" and include "shell".
1855
1856 *** Combine org-mac-message.el and org-mac-link-grabber into org-mac-link.el
1857
1858 Please remove calls to =(require 'org-mac-message)= and =(require
1859 'org-mac-link-grabber)= in your =.emacs= initialization file.  All you
1860 need now is =(require 'org-mac-link)=.
1861
1862 Additionally, replace any calls to =ogml-grab-link= to
1863 =org-mac-grab-link=.  For example, replace this line:
1864
1865 : (define-key org-mode-map (kbd "C-c g") 'omgl-grab-link)
1866
1867 with this:
1868
1869 : (define-key org-mode-map (kbd "C-c g") 'org-mac-grab-link)
1870
1871 *** HTML export: Replace =HTML_HTML5_FANCY= by =:html-html5-fancy= (...)
1872
1873 Some of the HTML specific export options in Org <8.1 are either nil or
1874 t, like =#+HTML_INCLUDE_STYLE=.  We replaced these binary options with
1875 option keywords like :html-include-style.
1876
1877 So you need to replace
1878
1879 : #+HTML_INCLUDE_STYLE: t
1880
1881 by
1882
1883 : #+OPTIONS: :html-include-style t
1884
1885 Options affected by this change: =HTML5_FANCY=, =HTML_INCLUDE_SCRIPTS=
1886 and =HTML_INCLUDE_STYLE=.
1887
1888 *** Add an argument to ~org-export-to-file~ and ~org-export-to-buffer~
1889
1890 ~org-export-to-file~ and ~org-export-to-file~ can run in a different
1891 process when provided a non-nil =ASYNC= optional argument, without
1892 relying on ~org-export-async-start~ macro.
1893
1894 Since =ASYNC= is the first of optional arguments, you have to shift
1895 the other optional arguments accordingly.
1896
1897 *** Export back-ends are now structures
1898
1899 Export back-ends are now structures, and stored as such in the
1900 communication channel during an export process.  In other words, from
1901 now on, ~(plist-get info :back-end)~ will return a structure instead
1902 of a symbol.
1903
1904 Arguments in hooks and in filters are still symbols, though.
1905
1906 ** Important bugfixes
1907
1908 *** [[doc:org-insert-heading][org-insert-heading]] has been rewritten and bugs are now fixed
1909 *** The replacement of disputed keys is now turned of when reading a date
1910
1911 *** Match string for sparse trees can now contain a slash in a property value
1912
1913     You can now have searches like SOMEPROP="aaa/bbb".  Until now,
1914     this would break because the slash would be interpreted as the
1915     separator starting a TOTO match string.
1916 ** New features
1917
1918 *** =C-c ^ x= will now sort checklist items by their checked status
1919
1920 See [[doc:org-sort-list][org-sort-list]]: hitting =C-c ^ x= will put checked items at the end
1921 of the list.
1922 *** Various LaTeX export enhancements
1923
1924 - Support SVG images
1925 - Support for .pgf files
1926 - LaTeX Babel blocks can now be exported as =.tikz= files
1927 - Allow =latexmk= as an option for [[doc:org-latex-pdf-process][org-latex-pdf-process]]
1928 - When using =\usepackage[AUTO]{babel}=, AUTO will automatically be
1929   replaced with a value compatible with ~org-export-default-language~
1930   or ~LANGUAGE~ keyword.
1931 - The dependency on the =latexsym= LaTeX package has been removed, we
1932   now use =amssymb= symbols by default instead.
1933
1934 *** New functions for paragraph motion
1935
1936     The commands =C-down= and =C-up= now invoke special commands
1937     that use knowledge from the org-elements parser to move the cursor
1938     in a paragraph-like way.
1939
1940 *** New entities in =org-entities.el=
1941
1942 Add support for ell, imath, jmath, varphi, varpi, aleph, gimel, beth,
1943 dalet, cdots, S (§), dag, ddag, colon, therefore, because, triangleq,
1944 leq, geq, lessgtr, lesseqgtr, ll, lll, gg, ggg, prec, preceq,
1945 preccurlyeq, succ, succeq, succurlyeq, setminus, nexist(s), mho,
1946 check, frown, diamond.  Changes loz, vert, checkmark, smile and tilde.
1947
1948 *** Anonymous export back-ends
1949
1950 ~org-export-create-backend~ can create anonymous export back-ends,
1951 which can then be passed to export functions like
1952 ~org-export-to-file~, ~org-export-to-buffer~ or ~org-export-as~.
1953
1954 It allows for quick translation of Org syntax without the overhead of
1955 registering a new back-end.
1956
1957 *** New agenda fortnight view
1958
1959     The agenda has not, in addition to day, week, month, and year
1960     views, also a fortnight view covering 14 days.
1961 ** New options
1962
1963 *** New option [[doc:org-bookmark-names-plist][org-bookmark-names-plist]]
1964
1965 This allows to specify the names of automatic bookmarks.
1966 *** New option [[doc:org-agenda-ignore-drawer-properties][org-agenda-ignore-drawer-properties]]
1967
1968 This allows more flexibility when optimizing the agenda generation.
1969 See https://orgmode.org/worg/agenda-optimization.html for details.
1970 *** New option: [[doc:org-html-link-use-abs-url][org-html-link-use-abs-url]] to force using absolute URLs
1971
1972 This is an export/publishing option, and should be used either within
1973 the =#+OPTIONS= line(s) or within a [[doc:org-publish-project-alist][org-publish-project-alist]].
1974
1975 Setting this option to =t= is needed when the HTML output does not
1976 allow relative URLs.  For example, the =contrib/lisp/ox-rss.el=
1977 library produces a RSS feed, and RSS feeds need to use absolute URLs,
1978 so a combination of =:html-link-home "..." and :html-link-use-abs-url
1979 t= is required---see the configuration example in the comment section
1980 of =ox-rss.el=.
1981
1982 *** New option [[doc:org-babel-ditaa-java-cmd][org-babel-ditaa-java-cmd]]
1983
1984 This makes java executable configurable for ditaa blocks.
1985
1986 *** New options [[doc:org-babel-latex-htlatex][org-babel-latex-htlatex]] and [[doc:org-babel-latex-htlatex-packages][org-babel-latex-htlatex-packages]]
1987
1988 This enables SVG generation from latex code blocks.
1989
1990 *** New option: [[doc:org-habit-show-done-always-green][org-habit-show-done-always-green]]
1991
1992 See [[https://lists.gnu.org/r/emacs-orgmode/2013-05/msg00214.html][this message]] from Max Mikhanosha.
1993
1994 *** New option: [[doc:org-babel-inline-result-wrap][org-babel-inline-result-wrap]]
1995
1996 If you set this to the following
1997
1998 : (setq org-babel-inline-result-wrap "$%s$")
1999
2000 then inline code snippets will be wrapped into the formatting string.
2001
2002 *** New option: [[doc:org-special-ctrl-o][org-special-ctrl-o]]
2003
2004     This variable can be used to turn off the special behavior of
2005     =C-o= in tables.
2006 ** New contributed packages
2007
2008 - =ox-bibtex.el= by Nicolas Goaziou :: an utility to handle BibTeX
2009      export to both LaTeX and HTML exports.  It uses the [[http://www.lri.fr/~filliatr/bibtex2html/][bibtex2html]]
2010      software.
2011
2012 - =org-screenshot.el= by Max Mikhanosha :: an utility to handle
2013      screenshots easily from Org, using the external tool [[http://freecode.com/projects/scrot][scrot]].
2014
2015 ** Miscellaneous
2016
2017 *** "QUOTE" keywords in headlines are deprecated
2018
2019 "QUOTE" keywords are an undocumented feature in Org.  When a headline
2020 starts with the keyword "QUOTE", its contents are parsed as
2021 a ~quote-section~ and treated as an example block.  You can achieve
2022 the same with example blocks.
2023
2024 This feature is deprecated and will be removed in the next Org
2025 release.
2026
2027 * Version 8.0.1
2028
2029 ** Installation
2030
2031 Installation instructions have been updated and simplified.
2032
2033 If you have troubles installing or updating Org, focus on these
2034 instructions:
2035
2036 - when updating via a =.zip/.tar.gz= file, you only need to set the
2037   =load-path= in your =.emacs=.  Set it before any other Org
2038   customization that would call autoloaded Org functions.
2039
2040 - when updating by pulling Org's Git repository, make sure to create the
2041   correct autoloads.  You can do this by running =~$ make autoloads= (to
2042   only create the autoloads) or by running =~$ make= (to also compile
2043   the Emacs lisp files.)  =~$ make help= and =~$ make helpall= gives you
2044   detailed explanations.
2045
2046 - when updating through ELPA (either from GNU ELPA or from Org ELPA),
2047   you have to install Org's ELPA package in a session where no Org
2048   function has been called already.
2049
2050 When in doubt, run =M-x org-version RET= and see if you have a mixed-up
2051 installation.
2052
2053 See https://orgmode.org/org.html#Installation for details.
2054
2055 ** Incompatible changes
2056
2057 Org 8.0 is the most disruptive major version of Org.
2058
2059 If you configured export options, you will have to update some of them.
2060
2061 If you used =#+ATTR_*= keywords, the syntax of the attributes changed and
2062 you will have to update them.
2063
2064 Below is a list of changes for which you need to take action.
2065
2066 See https://orgmode.org/worg/org-8.0.html for the most recent version of
2067 this list and for detailed instructions on how to migrate.
2068
2069 **** New export engine
2070
2071 Org 8.0 comes with a new export engine written by Nicolas Goaziou.  This
2072 export engine relies on ~org-element.el~ (Org's syntax parser), which was
2073 already in Org's core.  This new export engine triggered the rewriting of
2074 /all/ export back-ends.
2075
2076 The most visible change is the export dispatcher, accessible through the
2077 keybinding =C-c C-e=.  By default, this menu only shows some of the
2078 built-in export formats, but you can add more formats by loading them
2079 directly (e.g., =(require 'ox-texinfo)= or by configuring the option
2080 [[doc:org-export-backends][org-export-backends]].
2081
2082 More contributed back-ends are available from the =contrib/= directory, the
2083 corresponding files start with the =ox-= prefix.
2084
2085 If you customized an export back-end (like HTML or LaTeX), you will need to
2086 rename some options so that your customization is not lost.  Typically, an
2087 option starting with =org-export-html-= is now named =org-html-=.  See the
2088 manual for details and check [[https://orgmode.org/worg/org-8.0.html][this Worg page]] for directions.
2089
2090 **** New syntax for #+ATTR_HTML/LaTeX/... options
2091
2092      : #+ATTR_HTML width="200px"
2093
2094      should now be written
2095
2096      : #+ATTR_HTML :width 200px
2097
2098      Keywords like =#+ATTR_HTML= and =#+ATTR_LaTeX= are defined in their
2099      respective back-ends, and the list of supported parameters depends on
2100      each backend.  See Org's manual for details.
2101
2102 **** ~org-remember.el~ has been removed
2103
2104      You cannot use =remember.el= anymore to capture notes.
2105
2106      Support for remember templates has been obsoleted since long, it is
2107      now fully removed.
2108
2109      Use =M-x org-capture-import-remember-templates RET= to import your
2110      remember templates into capture templates.
2111
2112 **** ~org-jsinfo.el~ has been merged into ~ox-html.el~
2113
2114      If you were requiring ~ox-jsinfo.el~ in your ~.emacs.el~ file, you
2115      will have to remove this requirement from your initialization file.
2116
2117 **** Note for third-party developers
2118
2119      The name of the files for export back-end have changed: we now use the
2120      prefix =ox-= for those files (like we use the =ob-= prefix for Babel
2121      files.)  For example ~org-html.el~ is now ~ox-html.el~.
2122
2123      If your code relies on these files, please update the names in your
2124      code.
2125
2126 **** Packages moved from core to contrib
2127
2128      Since packages in Org's core are meant to be part of GNU Emacs, we try
2129      to be minimalist when it comes to adding files into core.  For 8.0, we
2130      moved some contributions into the =contrib/= directory.
2131
2132      The rationale for deciding that these files should live in =contrib/=
2133      is either because they rely on third-party software that is not
2134      included in Emacs, or because they are not targeting a significant
2135      user-base.
2136
2137      - org-colview-xemacs.el
2138      - org-mac-message.el
2139      - org-mew.el
2140      - org-wl.el
2141      - ox-freedmind.el
2142      - ox-taskjuggler.el
2143
2144      Note that ~ox-freedmind.el~ has been rewritten by Jambunathan,
2145      ~org-mew.el~ has been enhanced by Tokuya Kameshima and
2146      ~ox-taskjuggler.el~ by Nicolas Goaziou and others.
2147
2148      Also, the Taskjuggler exporter now uses TJ3 by default.  John Hendy
2149      wrote [[https://orgmode.org/worg/org-tutorials/org-taskjuggler3.html][a tutorial on Worg]] for the TJ3 export.
2150
2151 ** New packages in core
2152
2153 *** ~ob-makefile.el~ by Eric Schulte and Thomas S. Dye
2154
2155     =ob-makefile.el= implements Org Babel support for Makefile tangling.
2156
2157 *** ~ox-man.el~ by Luis Anaya
2158
2159     =ox-man.el= allows you to export Org files to =man= pages.
2160
2161 *** ~ox-md.el~ by Nicolas Goaziou
2162
2163     =ox-md.el= allows you to export Org files to Markdown files, using the
2164     vanilla [[http://daringfireball.net/projects/markdown/][Markdown syntax]].
2165
2166 *** ~ox-texinfo.el~ by Jonathan Leech-Pepin
2167
2168     =ox-texinfo.el= allows you to export Org files to [[https://www.gnu.org/software/texinfo/][Texinfo]] files.
2169
2170 ** New packages in contrib
2171
2172 *** ~ob-julia.el~ by G. Jay Kerns
2173
2174     [[http://julialang.org/][Julia]] is a new programming language.
2175
2176     =ob-julia.el= provides Org Babel support for evaluating Julia source
2177     code.
2178
2179 *** ~ob-mathomatic.el~ by Luis Anaya
2180
2181     [[http://www.mathomatic.org/][mathomatic]] a portable, command-line, educational CAS and calculator
2182     software, written entirely in the C programming language.
2183
2184     ~ob-mathomatic.el~ provides Org Babel support for evaluating mathomatic
2185     entries.
2186
2187 *** ~ob-tcl.el~ by Luis Anaya
2188
2189     ~ob-tcl.el~ provides Org Babel support for evaluating [[http://www.tcl.tk/][Tcl]] source code.
2190
2191 *** ~org-bullets.el~ by Evgeni Sabof
2192
2193     Display bullets instead of stars for headlines.
2194
2195     Also see [[https://orgmode.org/worg/org-faq.html#sec-8-12][this updated FAQ]] on how to display another character than "*"
2196     for starting headlines.
2197
2198 *** ~org-favtable.el~ by Marc-Oliver Ihm
2199
2200     ~org-favtable.el~ helps you to create and update a table of favorite
2201     locations in org, keeping the most frequently visited lines right at
2202     the top.  This table is called "favtable".  See the documentation on
2203     [[https://orgmode.org/worg/org-contrib/org-favtable.html][Worg]].
2204
2205 *** ~ox-confluence.el~ by Sébastien Delafond
2206
2207     ~ox-confluence.el~ lets you convert Org files to [[https://confluence.atlassian.com/display/DOC/Confluence%2BWiki%2BMarkup][Confluence Wiki]] files.
2208
2209 *** ~ox-deck.el~ and ~ox-s5.el~ by Rick Frankel
2210
2211     [[http://imakewebthings.com/deck.js/][deck.js]] is a javascript library for displaying HTML ages as
2212     presentations.  ~ox-deck.el~ exports Org files to HTML presentations
2213     using =deck.js=.
2214
2215     [[http://meyerweb.com/eric/tools/s5/][s5]] is a set of scripts which also allows to display HTML pages as
2216     presentations.  ~ox-s5.el~ exports Org files to HTML presentations
2217     using =s5=.
2218
2219 *** ~ox-groff.el~ by Luis Anaya and Nicolas Goaziou
2220
2221     The [[https://www.gnu.org/software/groff/][groff]] (GNU troff) software is a typesetting package which reads
2222     plain text mixed with formatting commands and produces formatted
2223     output.
2224
2225     Luis Anaya and Nicolas Goaziou implemented ~ox-groff.el~ to allow
2226     conversion from Org files to groff.
2227
2228 *** ~ox-koma-letter.el~ by Nicolas Goaziou and Alan Schmitt
2229
2230     This back-end allow to export Org pages to the =KOMA Scrlttr2= format.
2231
2232 *** ~ox-rss.el~ by Bastien
2233
2234     This back-end lets you export Org pages to RSS 2.0 feeds.  Combined
2235     with the HTML publishing feature, this allows you to build a blog
2236     entirely with Org.
2237
2238 ** New features
2239
2240 *** Export
2241
2242 **** New export generic options
2243
2244 If you use Org exporter, we advise you to re-read [[https://orgmode.org/org.html#Exporting][the manual section about
2245 it]].  It has been updated and includes new options.
2246
2247 Among the new/updated export options, three are of particular importance:
2248
2249 - [[doc:org-export-allow-bind-keywords][org-export-allow-bind-keywords]] :: This option replaces the old option
2250      =org-export-allow-BIND= and the default value is =nil=, not =confirm=.
2251      You will need to explicitly set this to =t= in your initialization
2252      file if you want to allow =#+BIND= keywords.
2253
2254 - [[doc:org-export-with-planning][org-export-with-planning]] :: This new option controls the export of
2255      =SCHEDULED:, DEADLINE:, CLOSED:= lines, and planning information is
2256      now skipped by default during export.  This use to be the job of
2257      [[doc:org-export-with-timestamps][org-export-with-timestamps]], but this latter option has been given a
2258      new role: it controls the export of /standalone time-stamps/.  When
2259      set to =nil=, Org will not export active and inactive time-stamps
2260      standing on a line by themselves or within a paragraph that only
2261      contains time-stamps.
2262
2263 To check if an option has been introduced or its default value changed in
2264 Org 8.0, do =C-h v [option] RET= and check if the documentation says that
2265 the variable has been introduced (or changed) in version 24.4 of Emacs.
2266
2267 **** Enhanced default stylesheet for the HTML exporter
2268
2269 See the new default value of [[doc:org-html-style-default][org-html-style-default]].
2270
2271 **** New tags, classes and ids for the HTML exporter
2272
2273 See the new default value of [[doc:org-html-divs][org-html-divs]].
2274
2275 **** Support for tikz pictures in LaTeX export
2276 **** ~org-man.el~: New export function for "man" links
2277 **** ~org-docview.el~: New export function for docview links
2278 *** Structure editing
2279
2280 **** =C-u C-u M-RET= inserts a heading at the end of the parent subtree
2281 **** Cycling to the =CONTENTS= view keeps inline tasks folded
2282
2283 [[doc:org-cycle-hook][org-cycle-hook]] as a new function [[doc:org-cycle-hide-inline-tasks][org-cycle-hide-inline-tasks]] which
2284 prevents the display of inline tasks when showing the content of a subtree.
2285
2286 **** =C-c -= in a region makes a list item for each line
2287
2288 This is the opposite of the previous behavior, where =C-c -= on a region
2289 would create one item for the whole region, and where =C-u C-c -= would
2290 create an item for each line.  Now =C-c -= on the selected region creates
2291 an item per line, and =C-u C-c -= creates a single item for the whole
2292 region.
2293
2294 **** When transposing words, markup characters are now part of the words
2295
2296 In Emacs, you can transpose words with =M-t=.  Transposing =*these*
2297 _words__= will preserve markup.
2298
2299 **** New command [[doc:org-set-property-and-value][org-set-property-and-value]] bound to =C-c C-x P=
2300
2301 This command allows you to quickly add both the property and its value.  It
2302 is useful in buffers where there are many properties and where =C-c C-x p=
2303 can slow down the flow of editing too much.
2304
2305 **** New commands [[doc:org-next-block][org-next-block]] and [[doc:org-previous-block][org-previous-block]]
2306
2307 These commands allow you to go to the previous block (=C-c M-b= or the
2308 speedy key =B=) or to the next block (=C-c M-f= or the speedy key =F=.)
2309
2310 **** New commands [[doc:org-drag-line-forward][org-drag-line-forward]] and [[doc:org-drag-line-backward][org-drag-line-backward]]
2311
2312 These commands emulate the old behavior of =M-<down>= and =M-<up>= but are
2313 now bound to =S-M-<down>= and =S-M-<up>= respectively, since =M-<down>= and
2314 =M-<up>= now drag the whole element at point (a paragraph, a table, etc.)
2315 forward and backward.
2316
2317 **** When a list item has a checkbox, inserting a new item uses a checkbox too
2318 **** When sorting entries/items, only the description of links is considered
2319
2320 Now Org will sort this list
2321
2322 : - [[http://abc.org][B]]
2323 : - [[http://def.org][A]]
2324
2325 like this:
2326
2327 : - [[http://def.org][A]]
2328 : - [[http://abc.org][B]]
2329
2330 by comparing the descriptions, not the links.
2331 Same when sorting headlines instead of list items.
2332 **** New option =orgstruct-heading-prefix-regexp=
2333
2334 For example, setting this option to "^;;; " in Emacs lisp files and using
2335 =orgstruct-mode= in those files will allow you to cycle through visibility
2336 states as if lines starting with ";;; *..." where headlines.
2337
2338 In general, you want to set =orgstruct-heading-prefix-regexp= as a file
2339 local variable.
2340
2341 **** New behavior of [[doc:org-clone-subtree-with-time-shift][org-clone-subtree-with-time-shift]]
2342
2343 The default is now to ask for a time-shift only when there is a time-stamp.
2344 When called with a universal prefix argument =C-u=, it will not ask for a
2345 time-shift even if there is a time-stamp.
2346
2347 **** New option [[doc:org-agenda-restriction-lock-highlight-subtree][org-agenda-restriction-lock-highlight-subtree]]
2348
2349 This defaults to =t= so that the whole subtree is highlighted when you
2350 restrict the agenda view to it with =C-c C-x <= (or the speed command =<=).
2351 The default setting helps ensuring that you are not adding tasks after the
2352 restricted region.  If you find this highlighting too intrusive, set this
2353 option to =nil=.
2354 **** New option [[doc:org-closed-keep-when-no-todo][org-closed-keep-when-no-todo]]
2355
2356 When switching back from a =DONE= keyword to a =TODO= keyword, Org now
2357 removes the =CLOSED= planning information, if any.  It also removes this
2358 information when going back to a non-TODO state (e.g., with =C-c C-t SPC=).
2359 If you want to keep the =CLOSED= planning information when removing the
2360 TODO keyword, set [[doc:org-closed-keep-when-no-todo][org-closed-keep-when-no-todo]] to =t=.
2361
2362 **** New option [[doc:org-image-actual-width][org-image-actual-width]]
2363
2364 This option allows you to change the width of in-buffer displayed images.
2365 The default is to use the actual width of the image, but you can use a
2366 fixed value for all images, or fall back on an attribute like
2367
2368 : #+attr_html: :width 300px
2369 *** Scheduled/deadline
2370
2371 **** Implement "delay" cookies for scheduled items
2372
2373 If you want to delay the display of a scheduled task in the agenda, you can
2374 now use a delay cookie like this: =SCHEDULED: <2004-12-25 Sat -2d>=.  The
2375 task is still scheduled on the 25th but will appear in your agenda starting
2376 from two days later (i.e. from March 27th.)
2377
2378 Imagine for example that your co-workers are not done in due time and tell
2379 you "we need two more days".  In that case, you may want to delay the
2380 display of the task in your agenda by two days, but you still want the task
2381 to appear as scheduled on March 25th.
2382
2383 In case the task contains a repeater, the delay is considered to affect all
2384 occurrences; if you want the delay to only affect the first scheduled
2385 occurrence of the task, use =--2d= instead.  See [[doc:org-scheduled-delay-days][org-scheduled-delay-days]]
2386 and [[doc:org-agenda-skip-scheduled-delay-if-deadline][org-agenda-skip-scheduled-delay-if-deadline]] for details on how to
2387 control this globally or per agenda.
2388
2389 **** Use =C-u C-u C-c C-s= will insert a delay cookie for scheduled tasks
2390
2391 See the previous section for why delay cookies may be useful.
2392
2393 **** Use =C-u C-u C-c C-d= will insert a warning delay for deadline tasks
2394
2395 =C-u C-u C-c C-d= now inserts a warning delay to deadlines.
2396 *** Calendar, diary and appts
2397
2398 **** New variable [[doc:org-read-date-minibuffer-local-map][org-read-date-minibuffer-local-map]]
2399
2400 By default, this new local map uses "." to go to today's date, like in the
2401 normal =M-x calendar RET=.  If you want to deactivate this and to reassign
2402 the "@" key to =calendar-goto-today=, use this:
2403
2404 #+BEGIN_SRC emacs-lisp
2405   ;; Unbind "." in Org's calendar:
2406   (define-key org-read-date-minibuffer-local-map (kbd ".") nil)
2407
2408   ;; Bind "@" to `calendar-goto-today':
2409   (define-key org-read-date-minibuffer-local-map
2410               (kbd "@")
2411               (lambda () (interactive) (org-eval-in-calendar '(calendar-goto-today))))
2412 #+END_SRC
2413
2414 **** In Org's calendar, =!= displays diary entries of the date at point
2415
2416 This is useful when you want to check if you don't already have an
2417 appointment when setting new ones with =C-c .= or =C-c s=.  =!= will
2418 call =diary-view-entries= and display the diary in a separate buffer.
2419
2420 **** [[doc:org-diary][org-diary]]: only keep the descriptions of links
2421
2422 [[doc:org-diary][org-diary]] returns diary information from Org files, but it returns it
2423 in a diary buffer, not in an Org mode buffer.  When links are displayed,
2424 only show their description, not the full links.
2425 *** Agenda
2426
2427 **** New agenda type =agenda*= and entry types =:scheduled* :deadline*=
2428
2429 When defining agenda custom commands, you can now use =agenda*=: this will
2430 list entries that have both a date and a time.  This is useful when you
2431 want to build a list of appointments.
2432
2433 You can also set [[doc:org-agenda-entry-types][org-agenda-entry-types]] either globally or locally in
2434 each agenda custom command and use =:timestamp*= and/or =:deadline*= there.
2435
2436 Another place where this is useful is your =.diary= file:
2437
2438 : %%(org-diary :scheduled*) ~/org/rdv.org
2439
2440 This will list only entries from =~/org/rdv.org= that are scheduled with a
2441 time value (i.e. appointments).
2442
2443 **** New agenda sorting strategies
2444
2445 [[doc:org-agenda-sorting-strategy][org-agenda-sorting-strategy]] allows these new sorting strategies:
2446
2447 | Strategy       | Explanations                             |
2448 |----------------+------------------------------------------|
2449 | timestamp-up   | Sort by any timestamp, early first       |
2450 | timestamp-down | Sort by any timestamp, late first        |
2451 | scheduled-up   | Sort by scheduled timestamp, early first |
2452 | scheduled-down | Sort by scheduled timestamp, late first  |
2453 | deadline-up    | Sort by deadline timestamp, early first  |
2454 | deadline-down  | Sort by deadline timestamp, late first   |
2455 | ts-up          | Sort by active timestamp, early first    |
2456 | ts-down        | Sort by active timestamp, late first     |
2457 | tsia-up        | Sort by inactive timestamp, early first  |
2458 | tsia-down      | Sort by inactive timestamp, late first   |
2459
2460 **** New options to limit the number of agenda entries
2461
2462 You can now limit the number of entries in an agenda view.  This is
2463 different from filters: filters only /hide/ the entries in the agenda,
2464 while limits are set while generating the list of agenda entries.
2465
2466 These new options are available:
2467
2468 - [[doc:org-agenda-max-entries][org-agenda-max-entries]] :: limit by number of entries.
2469 - [[doc:org-agenda-max-todos][org-agenda-max-todos]] :: limit by number of TODOs.
2470 - [[doc:org-agenda-max-tags][org-agenda-max-tags]] :: limit by number of tagged entries.
2471 - [[doc:org-agenda-max-effort][org-agenda-max-effort]] :: limit by effort (minutes).
2472
2473 For example, if you locally set [[doc:org-agenda-max-todos][org-agenda-max-todos]] to 3 in an agenda
2474 view, the agenda will be limited to the first three todos.  Other entries
2475 without a TODO keyword or beyond the third TODO headline will be ignored.
2476
2477 When setting a limit (e.g. about an effort's sum), the default behavior is
2478 to exclude entries that cannot be checked against (e.g. entries that have
2479 no effort property.)  To include other entries too, you can set the limit
2480 to a negative number.  For example =(setq org-agenda-max-tags -3)= will not
2481 show the fourth tagged headline (and beyond), but it will also show
2482 non-tagged headlines.
2483
2484 **** =~= in agenda view sets temporary limits
2485
2486 You can hit =~= in the agenda to temporarily set limits: this will
2487 regenerate the agenda as if the limits were set.  This is useful for
2488 example when you want to only see a list of =N= tasks, or a list of tasks
2489 that take only =N= minutes.
2490
2491 **** "=" in agenda view filters by regular expressions
2492
2493 You can now filter agenda entries by regular expressions using ~=~.  =C-u
2494 == will filter entries out.  Regexp filters are cumulative.  You can set
2495 [[doc:org-agenda-regexp-filter-preset][org-agenda-regexp-filter-preset]] to suit your needs in each agenda view.
2496
2497 **** =|= in agenda view resets all filters
2498
2499 Since it's common to combine tag filters, category filters, and now regexp
2500 filters, there is a new command =|= to reset all filters at once.
2501
2502 **** Allow writing an agenda to an =.org= file
2503
2504 You can now write an agenda view to an =.org= file.  It copies the
2505 headlines and their content (but not subheadings) into the new file.
2506
2507 This is useful when you want to quickly share an agenda containing the full
2508 list of notes.
2509
2510 **** New commands to drag an agenda line forward (=M-<down>=) or backward (=M-<up>=)
2511
2512 It sometimes handy to move agenda lines around, just to quickly reorganize
2513 your tasks, or maybe before saving the agenda to a file.  Now you can use
2514 =M-<down>= and =M-<up>= to move the line forward or backward.
2515
2516 This does not persist after a refresh of the agenda, and this does not
2517 change the =.org= files who contribute to the agenda.
2518
2519 **** Use =%b= for displaying "breadcrumbs" in the agenda view
2520
2521 [[doc:org-agenda-prefix-format][org-agenda-prefix-format]] now allows to use a =%b= formatter to tell Org
2522 to display "breadcrumbs" in the agenda view.
2523
2524 This is useful when you want to display the task hierarchy in your agenda.
2525
2526 **** Use =%l= for displaying the headline's level in the agenda view
2527
2528 [[doc:org-agenda-prefix-format][org-agenda-prefix-format]] allows to use a =%l= formatter to tell Org to
2529 display entries with additional spaces corresponding to their level in the
2530 outline tree.
2531
2532 **** [[doc:org-agenda-write][org-agenda-write]] will ask before overwriting an existing file
2533
2534 =M-x org-agenda-write RET= (or =C-c C-w= from an agenda buffer) used to
2535 overwrite preexisting file with the same name without confirmation.  It now
2536 asks for a confirmation.
2537
2538 **** New commands =M-m= and =M-*= to toggle (all) mark(s) for bulk action
2539
2540 - [[doc:org-agenda-bulk-toggle][org-agenda-bulk-toggle]] :: this command is bound to =M-m= and toggles
2541      the mark of the entry at point.
2542
2543 - [[doc:org-agenda-bulk-toggle-all][org-agenda-bulk-toggle-all]] :: this command is bound to =M-*= and
2544      toggles all the marks in the current agenda.
2545
2546 **** New option [[doc:org-agenda-search-view-max-outline-level][org-agenda-search-view-max-outline-level]]
2547
2548 This option sets the maximum outline level to display in search view.
2549 E.g. when this is set to 1, the search view will only show headlines of
2550 level 1.
2551
2552 **** New option [[doc:org-agenda-todo-ignore-time-comparison-use-seconds][org-agenda-todo-ignore-time-comparison-use-seconds]]
2553
2554 This allows to compare times using seconds instead of days when honoring
2555 options like =org-agenda-todo-ignore-*= in the agenda display.
2556
2557 **** New option [[doc:org-agenda-entry-text-leaders][org-agenda-entry-text-leaders]]
2558
2559 This allows you to get rid of the ">" character that gets added in front of
2560 entries excerpts when hitting =E= in the agenda view.
2561
2562 **** New formatting string for past deadlines in [[doc:org-agenda-deadline-leaders][org-agenda-deadline-leaders]]
2563
2564 The default formatting for past deadlines is ="%2d d. ago: "=, which makes
2565 it explicit that the deadline is in the past.  You can configure this via
2566 [[doc:org-agenda-deadline-leaders][org-agenda-deadline-leaders]].  Note that the width of the formatting
2567 string is important to keep the agenda alignment clean.
2568
2569 **** New allowed value =repeated-after-deadline= for [[doc:org-agenda-skip-scheduled-if-deadline-is-shown][org-agenda-skip-scheduled-if-deadline-is-shown]]
2570
2571 When [[doc:org-agenda-skip-scheduled-if-deadline-is-shown][org-agenda-skip-scheduled-if-deadline-is-shown]] is set to
2572 =repeated-after-deadline=, the agenda will skip scheduled items if they are
2573 repeated beyond the current deadline.
2574
2575 **** New option for [[doc:org-agenda-skip-deadline-prewarning-if-scheduled][org-agenda-skip-deadline-prewarning-if-scheduled]]
2576
2577 This variable may be set to nil, t, the symbol `pre-scheduled', or a number
2578 which will then give the number of days before the actual deadline when the
2579 prewarnings should resume.  The symbol `pre-scheduled' eliminates the
2580 deadline prewarning only prior to the scheduled date.
2581
2582 Read the full docstring for details.
2583
2584 **** [[doc:org-class][org-class]] now supports holiday strings in the skip-weeks parameter
2585
2586 For example, this task will now be skipped only on new year's day:
2587
2588     : * Task
2589     :   <%%(org-class 2012 1 1 2013 12 12 2 "New Year's Day")>
2590 *** Capture
2591
2592 **** Allow =C-1= as a prefix for [[doc:org-agenda-capture][org-agenda-capture]] and [[doc:org-capture][org-capture]]
2593
2594 With a =C-1= prefix, the capture mechanism will use the =HH:MM= value at
2595 point (if any) or the current =HH:MM= time as the default time for the
2596 capture template.
2597
2598 **** Expand keywords within %(sexp) placeholder in capture templates
2599
2600 If you use a =%:keyword= construct within a =%(sexp)= construct, Org will
2601 expand the keywords before expanding the =%(sexp)=.
2602
2603 **** Allow to contextualize capture (and agenda) commands by checking the name of the buffer
2604
2605 [[doc:org-capture-templates-contexts][org-capture-templates-contexts]] and [[doc:org-agenda-custom-commands-contexts][org-agenda-custom-commands-contexts]]
2606 allow you to define what capture templates and what agenda commands should
2607 be available in various contexts.  It is now possible for the context to
2608 check against the name of the buffer.
2609 *** Tag groups
2610
2611 Using =#+TAGS: { Tag1 : Tag2 Tag3 }= will define =Tag1= as a /group tag/
2612 (note the colon after =Tag1=).  If you search for =Tag1=, it will return
2613 headlines containing either =Tag1=, =Tag2= or =Tag3= (or any combination
2614 of those tags.)
2615
2616 You can use group tags for sparse tree in an Org buffer, for creating
2617 agenda views, and for filtering.
2618
2619 See https://orgmode.org/org.html#Tag-groups for details.
2620
2621 *** Links
2622
2623 **** =C-u C-u M-x org-store-link RET= will ignore non-core link functions
2624
2625 Org knows how to store links from Org buffers, from info files and from
2626 other Emacs buffers.  Org can be taught how to store links from any buffer
2627 through new link protocols (see [[https://orgmode.org/org.html#Adding-hyperlink-types]["Adding hyperlink types"]] in the manual.)
2628
2629 Sometimes you want Org to ignore added link protocols and store the link
2630 as if the protocol was not known.
2631
2632 You can now do this with =C-u C-u M-x org-store-link RET=.
2633
2634 **** =C-u C-u C-u M-x org-store-link RET= on an active region will store links for each lines
2635
2636 Imagine for example that you want to store a link for every message in a
2637 Gnus summary buffer.  In that case =C-x h C-u C-u C-u M-x org-store-link
2638 RET= will store a link for every line (i.e. message) if the region is
2639 active.
2640
2641 **** =C-c C-M-l= will add a default description for links which don't have one
2642
2643 =C-c C-M-l= inserts all stored links.  If a link does not have a
2644 description, this command now adds a default one, so that we are not mixing
2645 with-description and without-description links when inserting them.
2646
2647 **** No curly braces to bracket links within internal links
2648
2649 When storing a link to a headline like
2650
2651 : * See [[https://orgmode.org][Org website]]
2652
2653 [[doc:org-store-link][org-store-link]] used to convert the square brackets into curly brackets.
2654 It does not anymore, taking the link description or the link path, when
2655 there is no description.
2656 *** Table
2657
2658 **** Switching between #+TBLFM lines
2659
2660 If you have several =#+TBLFM= lines below a table, =C-c C-c= on a line will
2661 apply the formulas from this line, and =C-c C-c= on another line will apply
2662 those other formulas.
2663
2664 **** You now use "nan" for empty fields in Calc formulas
2665
2666 If empty fields are of interest, it is recommended to reread the section
2667 [[https://orgmode.org/org.html#Formula-syntax-for-Calc][3.5.2 Formula syntax for Calc]] of the manual because the description for the
2668 mode strings has been clarified and new examples have been added towards
2669 the end.
2670
2671 **** Handle localized time-stamps in formulas evaluation
2672
2673 If your =LOCALE= is set so that Org time-stamps use another language than
2674 english, and if you make time computations in Org's table, it now works by
2675 internally converting the time-stamps with a temporary =LOCALE=C= before
2676 doing computation.
2677
2678 **** New lookup functions
2679
2680 There are now three lookup functions:
2681
2682 - [[doc:org-loopup-first][org-loopup-first]]
2683 - [[doc:org-loopup-last][org-loopup-last]]
2684 - [[doc:org-loopup-all][org-loopup-all]]
2685
2686 See [[https://orgmode.org/org.html#Lookup-functions][the manual]] for details.
2687 *** Startup keywords
2688
2689 These new startup keywords are now available:
2690
2691 | Startup keyword                  | Option                                      |
2692 |----------------------------------+---------------------------------------------|
2693 | =#+STARTUP: logdrawer=           | =(setq org-log-into-drawer t)=              |
2694 | =#+STARTUP: nologdrawer=         | =(setq org-log-into-drawer nil)=            |
2695 |----------------------------------+---------------------------------------------|
2696 | =#+STARTUP: logstatesreversed=   | =(setq org-log-states-order-reversed t)=    |
2697 | =#+STARTUP: nologstatesreversed= | =(setq org-log-states-order-reversed nil)=  |
2698 |----------------------------------+---------------------------------------------|
2699 | =#+STARTUP: latexpreview=        | =(setq org-startup-with-latex-preview t)=   |
2700 | =#+STARTUP: nolatexpreview=      | =(setq org-startup-with-latex-preview nil)= |
2701
2702 *** Clocking
2703
2704 **** New option [[doc:org-clock-rounding-minutes][org-clock-rounding-minutes]]
2705
2706 E.g. if [[doc:org-clock-rounding-minutes][org-clock-rounding-minutes]] is set to 5, time is 14:47 and you
2707 clock in: then the clock starts at 14:45.  If you clock out within the next
2708 5 minutes, the clock line will be removed; if you clock out 8 minutes after
2709 your clocked in, the clock out time will be 14:50.
2710
2711 **** New option [[doc:org-time-clocksum-use-effort-durations][org-time-clocksum-use-effort-durations]]
2712
2713 When non-nil, =C-c C-x C-d= uses effort durations.  E.g., by default, one
2714 day is considered to be a 8 hours effort, so a task that has been clocked
2715 for 16 hours will be displayed as during 2 days in the clock display or in
2716 the clocktable.
2717
2718 See [[doc:org-effort-durations][org-effort-durations]] on how to set effort durations and
2719 [[doc:org-time-clocksum-format][org-time-clocksum-format]] for more on time clock formats.
2720
2721 **** New option [[doc:org-clock-x11idle-program-name][org-clock-x11idle-program-name]]
2722
2723 This allows to set the name of the program which prints X11 idle time in
2724 milliseconds.  The default is to use =x11idle=.
2725
2726 **** New option [[doc:org-use-last-clock-out-time-as-effective-time][org-use-last-clock-out-time-as-effective-time]]
2727
2728 When non-nil, use the last clock out time for [[doc:org-todo][org-todo]].  Note that this
2729 option has precedence over the combined use of [[doc:org-use-effective-time][org-use-effective-time]] and
2730 [[doc:org-extend-today-until][org-extend-today-until]].
2731
2732 **** =S-<left/right>= on a clocksum column will update the sum by updating the last clock
2733 **** =C-u 3 C-S-<up/down>= will update clock timestamps synchronously by 3 units
2734 **** New parameter =:wstart= for clocktables to define the week start day
2735 **** New parameter =:mstart= to state the starting day of the month
2736 **** Allow relative times in clocktable tstart and tend options
2737 **** The clocktable summary is now a caption
2738 **** =:tstart= and =:tend= and friends allow relative times like "<-1w>" or "<now>"
2739 *** Babel
2740
2741 **** You can now use =C-c C-k= for [[doc:org-edit-src-abort][org-edit-src-abort]]
2742
2743 This allows you to quickly cancel editing a source block.
2744
2745 **** =C-u C-u M-x org-babel-tangle RET= tangles by the target file of the block at point
2746
2747 This is handy if you want to tangle all source code blocks that have the
2748 same target than the block at point.
2749
2750 **** New options for auto-saving the base buffer or the source block editing buffer
2751
2752 When [[doc:org-edit-src-turn-on-auto-save][org-edit-src-turn-on-auto-save]] is set to =t=, editing a source block
2753 in a new window will turn on =auto-save-mode= and save the code in a new
2754 file under the same directory than the base Org file.
2755
2756 When [[doc:org-edit-src-auto-save-idle-delay][org-edit-src-auto-save-idle-delay]] is set to a number of minutes =N=,
2757 the base Org buffer will be saved after this number of minutes of idle
2758 time.
2759
2760 **** New =:post= header argument post-processes results
2761
2762      This header argument may be used to pass the results of the current
2763      code block through another code block for post-processing.  See the
2764      manual for a usage example.
2765
2766 **** Commented out heading are ignored when collecting blocks for tangling
2767
2768 If you comment out a heading (with =C-c ;= anywhere on the heading or in
2769 the subtree), code blocks from within this heading are now ignored when
2770 collecting blocks for tangling.
2771
2772 **** New option [[doc:org-babel-hash-show-time][org-babel-hash-show-time]] to show a time-stamp in the result hash
2773 **** Do not ask for confirmation if cached value is current
2774
2775 Do not run [[doc:org-babel-confirm-evaluate][org-babel-confirm-evaluate]] if source block has a cache and the
2776 cache value is current as there is no evaluation involved in this case.
2777 **** =ob-sql.el= and =ob-python.el= have been improved.
2778 **** New Babel files only need to =(require 'ob)=
2779
2780 When writing a new Babel file, you now only need to use =(require 'ob)=
2781 instead of requiring each Babel library one by one.
2782 *** Faces
2783
2784 - Org now fontifies radio link targets by default
2785 - In the agenda, use [[doc:org-todo-keyword-faces][org-todo-keyword-faces]] to highlight selected TODO keywords
2786 - New face [[doc:org-priority][org-priority]], enhanced fontification of priority cookies in agenda
2787 - New face [[doc:org-tag-group][org-tag-group]] for group tags
2788
2789 ** Miscellaneous
2790
2791 - New speedy key =s= pour [[doc:org-narrow-to-subtree][org-narrow-to-subtree]]
2792 - Handling of [[doc:org-html-table-row][org-html-table-row]] has been updated (incompatible change)
2793 - [[doc:org-export-html-table-tag][org-export-html-table-tag]] is replaced by [[doc:org-html-table-default-attributes][org-html-table-default-attributes]]
2794 - Support using =git-annex= with Org attachments
2795 - org-protocol: Pass optional value using query in url to capture from protocol
2796 - When the refile history is empty, use the current filename as default
2797 - When you cannot change the TODO state of a task, Org displays the blocking task
2798 - New option [[doc:org-mobile-allpriorities][org-mobile-allpriorities]]
2799 - org-bibtex.el now use =visual-line-mode= instead of the deprecated =longlines-mode=
2800 - [[doc:org-format-latex-options][org-format-latex-options]] allows to set the foreground/background colors automatically
2801 - New option [[doc:org-archive-file-header-format][org-archive-file-header-format]]
2802 - New "neg" entity in [[doc:org-entities][org-entities]]
2803 - New function [[doc:org-docview-export][org-docview-export]] to export docview links
2804 - New =:eps= header argument for ditaa code blocks
2805 - New option [[doc:org-gnus-no-server][org-gnus-no-server]] to start Gnus with =gnus-no-server=
2806 - Org is now distributed with =htmlize.el= version 1.43
2807 - ~org-drill.el~ has been updated to version 2.3.7
2808 - ~org-mac-iCal.el~ now supports OS X versions up to 10.8
2809 - Various improvements to ~org-contacts.el~ and =orgpan.el=
2810
2811 ** Outside Org
2812
2813 *** Spanish translation of the Org guide by David Arroyo Menéndez
2814
2815 David (and others) translated the Org compact guide in spanish:
2816
2817 You can read the [[https://orgmode.org/worg/orgguide/orgguide.es.pdf][PDF guide]].
2818
2819 *** ~poporg.el~ and ~outorg.el~
2820
2821 Two new libraries (~poporg.el~ by François Pinard and ~outorg.el~ by
2822 Thorsten Jolitz) now enable editing of comment-sections from source-code
2823 buffers in temporary Org-mode buffers, making the full editing power of
2824 Org-mode available.  ~outorg.el~ comes together with ~outshine.el~ and
2825 ~navi-mode.el~, two more libraries by Thorsten Jolitz with the goal to give
2826 source-code buffers the /look & feel/ of Org-mode buffers while greatly
2827 improving navigation and structure editing.  A detailed description can be
2828 found here: https://orgmode.org/worg/org-tutorials/org-outside-org.html
2829
2830 Here are two screencasts demonstrating Thorsten's tools:
2831
2832 - [[http://youtu.be/nqE6YxlY0rw]["Modern conventions for Emacs Lisp files"]]
2833 - [[http://www.youtube.com/watch?v%3DII-xYw5VGFM][Exploring Bernt Hansen's Org-mode tutorial with 'navi-mode']]
2834
2835 *** MobileOrg for iOS
2836
2837 MobileOrg for iOS back in the App Store The 1.6.0 release was focused on
2838 the new Dropbox API and minor bug fixes but also includes a new ability to
2839 launch in Capture mode.  Track development and contribute [[https://github.com/MobileOrg/mobileorg/issues][on github]].
2840
2841 * Version 7.9.3
2842
2843 ** New option [[doc::org-agenda-use-tag-inheritance][org-agenda-use-tag-inheritance]]
2844
2845 [[doc::org-use-tag-inheritance][org-use-tag-inheritance]] controls whether tags are inherited when
2846 org-tags-view is called (either in =tags=, =tags-tree= or =tags-todo=
2847 agenda views.)
2848
2849 When generating other agenda types such as =agenda=, =todo= and
2850 =todo-tree=, tags inheritance is not used when selecting the entries
2851 to display.  Still, you might want to have all tag information correct
2852 in the agenda buffer, e.g. for tag filtering.  In that case, add the
2853 agenda type to this variable.
2854
2855 Setting this variable to nil should considerably speeds up the agenda
2856 generation.
2857
2858 Note that the default was to display inherited tags in the agenda
2859 lines even if `org-use-tag-inheritance' was nil.  The default is now
2860 to *never* display inherited tags in agenda lines, but to /know/ about
2861 them when the agenda type is listed in [[doc::org-agenda-use-tag-inheritance][org-agenda-use-tag-inheritance]].
2862
2863 ** New default value nil for [[doc::org-agenda-dim-blocked-tasks][org-agenda-dim-blocked-tasks]]
2864
2865 Using `nil' as the default value speeds up the agenda generation.  You
2866 can hit `#' (or `C-u #') in agenda buffers to temporarily dim (or turn
2867 invisible) blocked tasks.
2868
2869 ** New speedy keys for [[doc::org-speed-commands-default][org-speed-commands-default]]
2870
2871 You can now use `:' (instead of `;') for setting tags---this is
2872 consistent with using the `:' key in agenda view.
2873
2874 You can now use `=' for [[doc::org-columns][org-columns]].
2875
2876 ** =org-float= is now obsolete, use =diary-float= instead
2877 ** No GPL manual anymore
2878
2879 There used to be a GPL version of the Org manual, but this is not the
2880 case anymore, the Free Software Foundation does not permit this.
2881
2882 The GNU FDL license is now included in the manual directly.
2883
2884 ** Enhanced compatibility with Emacs 22 and XEmacs
2885
2886 Thanks to Achim for his work on enhancing Org's compatibility with
2887 various Emacsen.  Things may not be perfect, but Org should work okay
2888 in most environments.
2889
2890 * Version 7.9.2
2891
2892 ** New ELPA repository for Org packages
2893
2894 You can now add the Org ELPA repository like this:
2895
2896 #+BEGIN_SRC emacs-lisp
2897 (add-to-list 'package-archives '("org" . "https://orgmode.org/elpa/") t)
2898 #+END_SRC
2899
2900 It contains both the =org-*.tar= package (the core Org distribution, also
2901 available through https://elpa.gnu.org) and the =org-plus*.tar= package (the
2902 extended Org distribution, with non-GNU packages from the =contrib/=
2903 directory.)
2904
2905 See https://orgmode.org/elpa/
2906
2907 ** Overview of the new keybindings
2908
2909    | Keybinding      | Speedy | Command                     |
2910    |-----------------+--------+-----------------------------|
2911    | =C-c C-x C-z=   |        | [[doc::org-clock-resolve][org-clock-resolve]]           |
2912    | =C-c C-x C-q=   |        | [[doc::org-clock-cancel][org-clock-cancel]]            |
2913    | =C-c C-x C-x=   |        | [[doc::org-clock-in-last][org-clock-in-last]]           |
2914    | =M-h=           |        | [[doc::org-mark-element][org-mark-element]]            |
2915    | =*=             |        | [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]]    |
2916    | =C-c C-M-l=     |        | [[doc::org-insert-all-links][org-insert-all-links]]        |
2917    | =C-c C-x C-M-v= |        | [[doc::org-redisplay-inline-images][org-redisplay-inline-images]] |
2918    | =C-c C-x E=     | =E=    | [[doc::org-inc-effort][org-inc-effort]]              |
2919    |                 | =#=    | [[doc::org-toggle-comment][org-toggle-comment]]          |
2920    |                 | =:=    | [[doc::org-columns][org-columns]]                 |
2921    |                 | =W=    | Set =APPT_WARNTIME=          |
2922    | =k=             |        | [[doc::org-agenda-capture][org-agenda-capture]]          |
2923    | C-c ,           | ,      | [[doc::org-priority][org-priority]]                |
2924
2925 ** New package and Babel language
2926
2927 *** =org-eshell.el= by Konrad Hinsen is now in Org
2928
2929     =org-eshell.el= allows you to create links from [[https://www.gnu.org/software/emacs/manual/html_node/eshell/index.html][Eshell]].
2930
2931 *** Support for execution of Scala code blocks (see ob-scala.el)
2932 *** Support for execution of IO code blocks (see ob-io.el)
2933
2934 ** Incompatible changes
2935
2936    - If your code relies on =org-write-agenda=, please use
2937      [[doc::org-agenda-write][org-agenda-write]] from now on.
2938
2939    - If your code relies on =org-make-link=, please use =concat=
2940      instead.
2941
2942    - =org-link-to-org-use-id= has been renamed to
2943      =org-id-link-to-org-use-id= and its default value is nil.  The
2944      previous default was =create-if-interactive-and-no-custom-id=.
2945
2946 ** New features and user-visible changes
2947
2948 *** Org Element
2949
2950     =org-element.el= is a toolbox for parsing and analyzing "elements"
2951     in an Org-mode buffer.  This has been written by Nicolas Goaziou
2952     and has been tested for quite some time.  It is now part of Org's
2953     core and many core functions rely on this package.
2954
2955     Two functions might be particularly handy for users:
2956     =org-element-at-point= and =org-element-context=.
2957
2958     See the docstrings for more details.
2959
2960     Below is a list of editing and navigating commands that now rely
2961     on =org-element.el=.
2962
2963 **** [[doc::org-fill-paragraph][org-fill-paragraph]] has been completely rewritten
2964
2965      The filling mechanisms now rely on org-element, trying to do the
2966      right thing on each element in various contexts.  E.g. filling in
2967      a list item will preserve indentation; filling in message-mode
2968      will fall back on the relevant filling functions; etc.
2969
2970 **** [[doc::org-metaup][org-metaup]] and [[doc::org-metadown][org-metadown]] will drag the element backward/forward
2971
2972      If you want to get the old behavior (i.e. moving a line up and
2973      down), you can first select the line as an active region, then
2974      =org-metaup= or =org-metadown= to move the region backward or
2975      forward.  This also works with regions bigger than just one line.
2976
2977 **** [[doc::org-up-element][org-up-element]] and [[doc::org-down-element][org-down-element]] (respectively =C-c C-^= and =C-c C-_=)
2978
2979      This will move the point up/down in the hierarchy of elements.
2980
2981 **** [[doc::org-backward-element][org-backward-element]] and [[doc::org-forward-element][org-forward-element]] (respectively =M-{= and =M-}=)
2982
2983      This will move the point backward/forward in the hierarchy of
2984      elements.
2985
2986 **** [[doc::org-narrow-to-element][org-narrow-to-element]] will narrow to the element at point
2987 **** [[doc::org-mark-element][org-mark-element]] will mark the element at point
2988
2989      This command is bound to =M-h= and will mark the element at
2990      point.  If the point is at a paragraph, it will mark the
2991      paragraph.  If the point is at a list item, it will mark the list
2992      item.  Etc.
2993
2994      Note that if point is at the beginning of a list, it will mark
2995      the whole list.
2996
2997      To mark a subtree, you can either use =M-h= on the headline
2998      (since there is no ambiguity about the element you're at) or
2999      [[doc::org-mark-subtree][org-mark-subtree]] (=C-c @=) anywhere in the subtree.
3000
3001      Invoking [[doc::org-mark-element][org-mark-element]] repeatedly will try to mark the next
3002      element on top of the previous one(s).  E.g. hitting =M-h= twice
3003      on a headline will mark the current subtree and the next one on
3004      the same level.
3005
3006 *** Org Agenda
3007
3008 **** New option [[doc::org-agenda-sticky][org-agenda-sticky]]
3009
3010      There is a new option =org-agenda-sticky= which enables "sticky"
3011      agendas.  Sticky agendas remain opened in the background so that
3012      you don't need to regenerate them each time you hit the
3013      corresponding keystroke.  This is a big time saver.
3014
3015      When [[doc::org-agenda-sticky][org-agenda-sticky]] is =non-nil=, the agenda buffer will be
3016      named using the agenda key and its description.  In sticky
3017      agendas, the =q= key will just bury the agenda buffers and
3018      further agenda commands will show existing buffer instead of
3019      generating new ones.
3020
3021      If [[doc::org-agenda-sticky][org-agenda-sticky]] is set to =nil=, =q= will kill the single
3022      agenda buffer.
3023
3024 **** New option [[doc::org-agenda-custom-commands-contexts][org-agenda-custom-commands-contexts]]
3025
3026      Setting this option allows you to define specific context where
3027      agenda commands should be available from.  For example, when set
3028      to this value
3029
3030      #+BEGIN_SRC emacs-lisp
3031   (setq org-agenda-custom-commands-contexts
3032         '(("p" (in-file . "\\.txt"))))
3033 #+END_SRC
3034
3035      then the =p= agenda command will only be available from buffers
3036      visiting *.txt files.  See the docstring and the manual for more
3037      details on how to use this.
3038
3039 **** Changes in bulk actions
3040
3041      The set of commands starting with =k ...= as been deleted and the
3042      features have been merged into the "bulk action" feature.
3043
3044      After you marked some entries in the agenda, if you call =B s=,
3045      the agenda entries will be rescheduled using the date at point if
3046      on a date header.  If you are on an entry with a timestamp, you
3047      will be prompted for a date to reschedule your marked entries to,
3048      using the timestamp at point as the default prompt.
3049
3050      You can now use =k= to capture the marked entry and use the date
3051      at point as an overriding date for the capture template.
3052
3053      To bind this behavior to =M-x org-capture RET= (or its
3054      keybinding), set the new option [[doc::org-capture-use-agenda-date][org-capture-use-agenda-date]] to
3055      =t=.
3056
3057 **** =N= and =P= in the agenda will move to the next/previous item
3058
3059 **** New command [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]] to mark all items
3060
3061      This new command is bound to =*= in agenda mode.
3062
3063      There is also a new option [[doc::org-agenda-bulk-mark-char][org-agenda-bulk-mark-char]] to set the
3064      character to use as a mark for bulk actions.
3065
3066 **** New option [[doc::org-agenda-persistent-marks][org-agenda-persistent-marks]]
3067
3068      When set to =non-nil=, marks will remain visible after a bulk
3069      action.  You can temporarily toggle this by pressing =p= when
3070      invoking [[doc::org-agenda-bulk-action][org-agenda-bulk-action]].  Marks are deleted if your
3071      rebuild the agenda buffer or move to another date/span (e.g. with
3072      =f= or =w=).
3073
3074 **** New option [[doc::org-agenda-skip-timestamp-if-deadline-is-shown][org-agenda-skip-timestamp-if-deadline-is-shown]]
3075
3076      =Non-nil= means skip timestamp line if same entry shows because
3077      of deadline.
3078
3079      In the agenda of today, an entry can show up multiple times
3080      because it has both a plain timestamp and has a nearby deadline.
3081      When this variable is t, then only the deadline is shown and the
3082      fact that the entry has a timestamp for or including today is not
3083      shown.  When this variable is =nil=, the entry will be shown
3084      several times.
3085
3086 **** New =todo-unblocked= and =nottodo-unblocked= skip conditions
3087
3088      See the [[https://orgmode.org/cgit.cgi/org-mode.git/commit/?id=f426da][git commit]] for more explanations.
3089
3090 **** Allow category filtering in the agenda
3091
3092      You can now filter the agenda by category.  Pressing "<" will
3093      filter by the category of the item on the current line, and
3094      pressing "<" again will remove the filter.  You can combine tag
3095      filters and category filters.
3096
3097      You can use =org-agenda-category-filter= in your custom agenda
3098      views and =org-agenda-category-filter-preset= in your main
3099      configuration.
3100
3101      See also the new command [[doc::org-agenda-filter-by-top-category][org-agenda-filter-by-top-category]]:
3102      hitting =^= will filter by "Top" category: only show entries that
3103      are of the same category than the Top category of the entry at
3104      point.
3105
3106 *** Org Links
3107
3108 **** Inserting links
3109
3110      When inserting links through [[doc::org-insert-link][org-insert-link]], the description is
3111      now displayed first, followed by the literal link, as the
3112      description is often more useful when you look for the link you
3113      want to insert.
3114
3115      Completion now complete both literal links and description.  If
3116      you complete a description, the literal link and its description
3117      will be inserted directly, whereas when you complete the literal
3118      link, you will be prompted for a description (as with Org 7.8.)
3119
3120      In the completion buffer, links to the current buffer are now
3121      highlighted.
3122
3123 **** New templates =%h= and =%(sexp)= for abbreviated links
3124
3125      On top of =%s= template, which is replaced by the link tag in
3126      abbreviated links, you can now use =%h= (which does the same than =%s=
3127      but does not hexify the tag) and =%(sexp)= (which can run a function
3128      that takes the tag as its own argument.)
3129
3130 **** New link type =help=
3131
3132      You can now create links from =help= buffers.
3133
3134      For example, if you request help for the command [[doc::org-agenda][org-agenda]] with
3135      =C-h f org-agenda RET=, creating a link from this buffer will let
3136      you go back to the same buffer.
3137
3138 **** New command [[doc::org-insert-all-links][org-insert-all-links]]
3139
3140      This will insert all links as list items.  With a universal
3141      prefix argument, links will not be deleted from the variable
3142      =org-stored-links=.
3143
3144      This new command is bound to =C-c C-M-l=.
3145
3146 **** New option [[doc::org-url-hexify-p][org-url-hexify-p]]
3147
3148      When set to =nil=, the =URL= part of a link will not be hexified.
3149
3150 **** Org can now open multiple shell links
3151
3152 **** New option [[doc::org-doi-server-url][org-doi-server-url]] to specify an alternate DOI server
3153
3154 **** RET now follows time stamps links
3155
3156 *** Org Editing
3157
3158 **** [[doc::org-todo][org-todo]] and =org-archive-*= can now loop in the active region
3159
3160      When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, using
3161      [[doc::org-todo][org-todo]] or =org-archive-*= commands in the active region will
3162      loop over headlines.  This is handy if you want to set the TODO
3163      keyword for several items, or archive them quickly.
3164
3165 **** You can now set tags for headlines in a region
3166
3167      If [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, then
3168      selecting the region and hitting =C-c C-q= will set the tags for
3169      all headlines in the region.
3170
3171 **** New command [[doc::org-insert-drawer][org-insert-drawer]] to insert a drawer interactively
3172
3173 **** Comments start with "^[ \t]*# " anywhere on a line
3174
3175      Note that the space after the hashtag is mandatory.  Comments
3176      with "^#+" are not supported anymore.
3177
3178 **** New speed key =#= to toggle the COMMENT cookie on a headline
3179
3180 **** =indent-region-function= is now set to [[doc::org-indent-region][org-indent-region]]
3181
3182      =C-M-\= should now produce useful results.
3183
3184      You can unindent the buffer with [[doc::org-unindent-buffer][org-unindent-buffer]].
3185
3186 **** New option [[doc::org-allow-promoting-top-level-subtree][org-allow-promoting-top-level-subtree]]
3187
3188      When =non-nil=, =S-M-<left>= will promote level-1 subtrees
3189      containing other subtrees.  The level-1 headline will be
3190      commented out.  You can revert to the previous state with =M-x
3191      undo RET=.
3192
3193 *** Org Clock
3194
3195 **** New keybinding =C-c C-x C-z= for [[doc::org-clock-resolve][org-clock-resolve]]
3196
3197 **** New keybinding =C-c C-x C-q= for [[doc::org-clock-cancel][org-clock-cancel]]
3198
3199 **** New command [[doc::org-clock-in-last][org-clock-in-last]] to clock in the last clocked item
3200
3201      This command is bound to =C-c C-x C-x= and will clock in the last
3202      clocked entry, if any.
3203
3204 **** =C-u M-x= [[doc::org-clock-out][org-clock-out]] =RET= now prompts for a state to switch to
3205
3206 **** =S-M-<up/down>= on a clock timestamps adjusts the previous/next clock
3207
3208 **** New option [[doc::org-clock-continuously][org-clock-continuously]]
3209
3210      When set to =nil=, clocking in a task will first try to find the
3211      last clocked out task and restart from when that task was clocked
3212      out.
3213
3214      You can temporarily activate continuous clocking with =C-u C-u
3215      C-u M-x= [[doc::org-clock-in][org-clock-in]] =RET= (three universal prefix arguments)
3216      and =C-u C-u M-x= [[org-clock-in-last][org-clock-in-last]] =RET= (two universal prefix
3217      arguments).
3218
3219
3220 **** New option [[doc::org-clock-frame-title-format][org-clock-frame-title-format]]
3221
3222      This option sets the value of =frame-title-format= when clocking
3223      in.
3224
3225 **** New options for controlling the clockreport display
3226
3227      [[doc::org-clock-file-time-cell-format][org-clock-file-time-cell-format]]: Format string for the file time
3228      cells in clockreport.
3229
3230      [[doc::org-clock-total-time-cell-format][org-clock-total-time-cell-format]]: Format string for the total
3231      time cells in clockreport.
3232
3233
3234 **** New options for controlling the clock/timer display
3235
3236      [[doc::org-clock-clocked-in-display][org-clock-clocked-in-display]]: control whether the current clock
3237      is displayed in the mode line and/or frame title.
3238
3239      [[doc::org-timer-display][org-timer-display]]: control whether the current timer is displayed
3240      in the mode line and/or frame title.
3241
3242      This allows the clock and timer to be displayed in the frame
3243      title instead of, or as well as, the mode line.  This is useful
3244      for people with limited space in the mode line but with ample
3245      space in the frame title.
3246
3247 *** Org Appearance
3248
3249 **** New option [[doc::org-custom-properties][org-custom-properties]]
3250
3251      The visibility of properties listed in this options can be turn
3252      on/off with [[doc::org-toggle-custom-properties-visibility][org-toggle-custom-properties-visibility]].  This might
3253      be useful for properties used by third-part tools or that you
3254      don't want to see temporarily.
3255
3256 **** New command [[doc::org-redisplay-inline-images][org-redisplay-inline-images]]
3257
3258      This will redisplay all images.  It is bound to =C-c C-x C-M-v=.
3259
3260 **** New entities in =org-entities.el=
3261
3262      There are these new entities:
3263
3264      : ("tilde" "\\~{}" nil "&tilde;" "~" "~" "~")
3265      : ("slash" "/" nil "/" "/" "/" "/")
3266      : ("plus" "+" nil "+" "+" "+" "+")
3267      : ("under" "\\_" nil "_" "_" "_" "_")
3268      : ("equal" "=" nil "=" "=" "=" "=")
3269      : ("asciicirc" "\\textasciicircum{}" nil "^" "^" "^" "^")
3270
3271 **** New face =org-list-dt= for definition terms
3272 **** New face =org-date-selected= for the selected calendar day
3273 **** New face value for =org-document-title=
3274
3275      The face is back to a normal height.
3276
3277 *** Org Columns
3278
3279 **** New speed command =:= to activate the column view
3280 **** New special property =CLOCKSUM_T= to display today's clocked time
3281
3282      You can use =CLOCKSUM_T= the same way you use =CLOCKSUM=.  It
3283      will display the time spent on tasks for today only.
3284
3285 **** Use the =:COLUMNS:= property in columnview dynamic blocks
3286
3287      If the =:COLUMNS:= is set in a subtree, the columnview dynamic
3288      block will use its value as the column format.
3289
3290 **** Consider inline tasks when computing a sum
3291
3292 *** Org Dates and Time Stamps
3293
3294 **** Enhanced [[doc::org-sparse-tree][org-sparse-tree]]
3295
3296      =C-c /= can now check for time ranges.
3297
3298      When checking for dates with =C-c /= it is useful to change the
3299      type of dates that you are interested in.  You can now do this
3300      interactively with =c= after =C-c /= and/or by setting
3301      [[doc::org-sparse-tree-default-date-type][org-sparse-tree-default-date-type]] to the default value you want.
3302
3303 **** Support for hourly repeat cookies
3304
3305      You can now use
3306
3307      : SCHEDULED: <2012-08-20 lun. 08:00 +1h>
3308
3309      if you want to add an hourly repeater to an entry.
3310
3311 **** =C-u C-u C-c .= inserts a time-stamp with no prompt
3312
3313 **** When (setq [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] 'time), accept days in the prompt
3314
3315      "8am Wed" and "Wed 8am" are now acceptable values when entering a
3316      date from the prompt.  If [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] is set to
3317      =time=, this will produce the expected prompt indication.
3318
3319 **** New option [[doc::org-datetree-add-timestamp][org-datetree-add-timestamp]]
3320
3321      When set to =non-nil=, datetree entries will also have a
3322      timestamp.  This is useful if you want to see these entries in a
3323      sparse tree with =C-c /=.
3324
3325 *** Org Capture
3326
3327 **** New command [[doc::org-capture-string][org-capture-string]]
3328
3329      M-x [[doc::org-capture-string][org-capture-string]] RET will prompt for a string and a capture
3330      template.  The string will be used as an annotation for the
3331      template.  This is useful when capturing in batch mode as it lets
3332      you define the content of the template without being in Emacs.
3333
3334 **** New option [[doc::org-capture-templates-contexts][org-capture-templates-contexts]]
3335
3336      Setting this option allows you to define specific context where
3337      capture templates should be available from.  For example, when
3338      set to this value
3339
3340      #+BEGIN_SRC emacs-lisp
3341   (setq org-capture-templates-contexts
3342         '(("c" (in-mode . "message-mode"))))
3343 #+END_SRC
3344
3345      then the =c= capture template will only be available from
3346      =message-mode= buffers.  See the docstring and the manual for
3347      more details on how to use this.
3348
3349 **** New =%l= template to insert the literal link
3350 **** New option [[doc::org-capture-bookmark][org-capture-bookmark]]
3351
3352      Org used to automatically add a bookmark with capture a note.
3353      You can now turn this on by setting [[doc::org-capture-bookmark][org-capture-bookmark]] to
3354      =nil=.
3355
3356 **** Expand =%<num>= escape sequences into text entered for <num>'th =%^{PROMPT}= escape
3357
3358      See the manual for more explanations.
3359
3360 **** More control over empty lines
3361
3362      You can use =:empty-lines-before= and =:empty-lines-after= to
3363      control the insertion of empty lines.  Check the manual for more
3364      explanations.
3365
3366 **** New hook [[doc::org-capture-prepare-finalize-hook][org-capture-prepare-finalize-hook]]
3367
3368      This new hook runs before the finalization process starts.
3369
3370 *** Org Export
3371
3372 **** New functions =orgtbl-to-table.el= and =orgtbl-to-unicode=
3373
3374      =orgtbl-to-table.el= convert the table to a =table.el= table, and
3375      =orgtbl-to-unicode= will use =ascii-art-to-unicode.el= (when
3376      available) to print beautiful tables.
3377
3378 **** [[doc::org-table-export][org-table-export]] now a bit clever about the target format
3379
3380      When you specify a file name like =table.csv=, [[doc::org-table-export][org-table-export]]
3381      will now suggest =orgtbl-to-csv= the default method for exporting
3382      the table.
3383
3384 **** New option [[doc::org-export-date-timestamp-format][org-export-date-timestamp-format]]
3385
3386      The option allows to set a time string format for Org timestamps
3387      in the #+DATE option.
3388
3389 **** LaTeX: New options for exporting table rules :tstart, :hline and :tend
3390
3391      See [[doc::org-export-latex-tables-hline][org-export-latex-tables-hline]] and [[doc::org-export-latex-tables-tend][org-export-latex-tables-tend]].
3392
3393 **** LaTeX: You can now set =:hfmt= from =#+ATTR_LaTeX=
3394 **** Beamer: Add support and keybinding for the =exampleblock= environment
3395
3396      Add support for these languages in [[doc::org-export-language-setup][org-export-language-setup]].
3397      More languages are always welcome.
3398
3399 **** Beamer: New option [[doc::org-beamer-inherited-properties][org-beamer-inherited-properties]]
3400
3401      This option allows Beamer export to inherit some properties.
3402      Thanks to Carsten for implementing this.
3403
3404 **** ODT: Add support for ODT export in org-bbdb.el
3405 **** ODT: Add support for indented tables (see [[https://orgmode.org/cgit.cgi/org-mode.git/commit/?id=e9fd33][this commit]] for details)
3406 **** ODT: Improve the conversion from ODT to other formats
3407 **** ASCII: Swap the level-1/level-2 characters to underline the headlines
3408 **** Support for Chinese, simplified Chinese, Russian, Ukrainian and Japanese
3409 **** HTML: New option [[doc::org-export-html-date-format-string][org-export-html-date-format-string]]
3410
3411      Format string to format the date and time in HTML export.  Thanks
3412      to Sébastien Vauban for this patch.
3413
3414 *** Org Babel
3415
3416 **** New =:results drawer= parameter
3417
3418 =:results drawer= replaces =:results wrap=, which is deprecated but still
3419 supported.
3420
3421 **** =:results org= now put results in a =#+BEGIN_SRC org= block
3422
3423 =:results org= used to put results in a =#+BEGIN_ORG= block but it now puts
3424 results in a =#+BEGIN_SRC org= block, with comma-escaped lines.
3425
3426 =#+BEGIN_ORG= blocks are obsolete.
3427
3428 **** Exporting =#+BEGIN_SRC org= blocks exports the code
3429
3430 It used to exports the results of the code.
3431
3432 *** Miscellaneous
3433
3434 **** New menu entry for [[doc::org-refile][org-refile]]
3435 **** Allow capturing to encrypted entries
3436
3437 If you capture to an encrypted entry, it will be decrypted before
3438 inserting the template then re-encrypted after finalizing the capture.
3439
3440 **** Inactive timestamps are now handled in tables
3441
3442 Calc can do computation on active time-stamps like <2012-09-29 sat.>.
3443 Inactive time-stamps in a table's cell are now internally deactivated so
3444 that Calc formulas can operate on them.
3445
3446 **** [[doc::org-table-number-regexp][org-table-number-regexp]] can now accept comma as decimal mark
3447 **** Org allows a new property =APPT_WARNTIME=
3448
3449      You can set it with the =W= speedy key or set it manually.  When
3450      set, exporting to iCalendar and [[doc::org-agenda-to-appt][org-agenda-to-appt]] will use the
3451      value of this property as the number of minutes for the warning
3452      alarm.
3453
3454 **** New command [[doc::org-inc-effort][org-inc-effort]]
3455
3456      This will increment the effort value.
3457
3458      It is bound to =C-c C-x E= and to =E= as a speedy command.
3459
3460 **** Attach: Add support for creating symbolic links
3461
3462      =org-attach-method= now supports a new method =lns=, allowing to
3463      attach symbolic links.
3464
3465 **** Archive: you can now archive to a datetree
3466
3467 **** New option [[doc::org-inlinetask-show-first-star][org-inlinetask-show-first-star]]
3468
3469      =Non-nil= means display the first star of an inline task as
3470      additional marker.  When =nil=, the first star is not shown.
3471
3472 **** New option [[doc::org-latex-preview-ltxpng-directory][org-latex-preview-ltxpng-directory]]
3473
3474      This lets you define the path for the =ltxpng/= directory.
3475
3476 **** You can now use imagemagick instead of dvipng to preview LaTeX fragments
3477 **** You can now turn off [[doc::orgstruct++-mode][orgstruct++-mode]] safely
3478 **** =C-u C-c C-c= on list items to add check boxes
3479
3480      =C-u C-c C-c= will add an empty check box on a list item.
3481
3482      When hit from the top of the list, it will add check boxes for
3483      all top level list items.
3484
3485 **** =org-list-ending-method= and =org-list-end-regexp= are now obsolete
3486
3487      Fall back on using =org-list-end-re= only, which see.
3488
3489 **** org-feed.el now expands =%(sexp)= templates
3490 **** New option [[doc::org-protocol-data-separator][org-protocol-data-separator]]
3491
3492 **** New option [[doc::org-ditaa-jar-option][org-ditaa-jar-option]] to specify the ditaa jar file
3493
3494 **** New possible value for [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]]
3495
3496      When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is set to
3497      =start-level=, the command will loop over the active region but
3498      will only act upon entries that are of the same level than the
3499      first headline in the region.
3500
3501 **** New option [[doc::org-habit-show-all-today][org-habit-show-all-today]]
3502
3503      When set to =t=, show all (even unscheduled) habits on today's
3504      agenda.
3505
3506 ** Important bug fixes
3507
3508 *** M-TAB on options keywords perform completion correctly again
3509
3510     If you hit =M-TAB= on keywords like =#+TITLE=, Org will try to
3511     perform completion with meaningful values.
3512
3513 *** Add licenses to javascript embedded and external code snippets
3514
3515     Embedded javascript code produced when exporting an Org file to
3516     HTML is now licensed under GPLv3 (or later), and the copyright is
3517     owned by the Free Software Foundation, Inc.
3518
3519     The javascript code for embedding MathJax in the browser mentions
3520     the MathJax copyright and the Apache 2.0 license.
3521
3522     The javascript code for embedding =org-injo.js= in the browser
3523     mentions the copyright of Sebastian Rose and the GPLv3 (or later)
3524     license.
3525
3526     =org-export-html-scripts= is now a variable, so that you can adapt
3527     the code and the license to your needs.
3528
3529     See https://www.gnu.org/philosophy/javascript-trap.html for
3530     explanations on why these changes were necessary.
3531
3532 * Version 7.8.11
3533
3534 ** Incompatible changes
3535
3536 *** Emacs 21 support has been dropped
3537
3538     Do not use Org mode 7.xx with Emacs 21, use [[https://orgmode.org/org-6.36c.zip][version 6.36c]] instead.
3539
3540 *** XEmacs support requires the XEmacs development version
3541
3542     To use Org mode 7.xx with XEmacs, you need to run the developer
3543     version of XEmacs.  We were about to drop XEmacs support entirely,
3544     but Michael Sperber stepped in and made changes to XEmacs that
3545     made it easier to keep the support.  Thanks to Michael for this
3546     last-minute save.
3547
3548 *** New keys for TODO sparse trees
3549
3550     The key =C-c C-v= is now reserved for Org Babel action.  TODO
3551     sparse trees can still be made with =C-c / t= (all not-done
3552     states) and =C-c / T= (specific states).
3553
3554 *** The Agenda =org-agenda-ndays= is now obsolete
3555
3556     The variable =org-agenda-ndays= is obsolete - please use
3557     =org-agenda-span= instead.
3558
3559     Thanks to Julien Danjou for this.
3560
3561 *** Changes to the intended use of =org-export-latex-classes=
3562
3563     So far this variable has been used to specify the complete header
3564     of the LaTeX document, including all the =\usepackage= calls
3565     necessary for the document.  This setup makes it difficult to
3566     maintain the list of packages that Org itself would like to call,
3567     for example for the special symbol support it needs.
3568
3569     First of all, you can *opt out of this change* in the following
3570     way: You can say: /I want to have full control over headers, and I
3571     will take responsibility to include the packages Org needs/.  If
3572     that is what you want, add this to your configuration and skip the
3573     rest of this section (except maybe for the description of the
3574     =[EXTRA]= place holder):
3575
3576     #+begin_src emacs-lisp
3577    (setq org-export-latex-default-packages-alist nil
3578          org-export-latex-packages-alist nil)
3579     #+end_src
3580
3581     /Continue to read here if you want to go along with the modified
3582     setup./
3583
3584     There are now two variables that should be used to list the LaTeX
3585     packages that need to be included in all classes.  The header
3586     definition in =org-export-latex-classes= should then not contain
3587     the corresponding =\usepackage= calls (see below).
3588
3589     The two new variables are:
3590
3591     1. =org-export-latex-default-packages-alist= :: This is the
3592          variable where Org-mode itself puts the packages it needs.
3593          Normally you should not change this variable.  The only
3594          reason to change it anyway is when one of these packages
3595          causes a conflict with another package you want to use.  Then
3596          you can remove that packages and hope that you are not using
3597          Org-mode functionality that needs it.
3598
3599     2. =org-export-latex-packages-alist= :: This is the variable where
3600          you can put the packages that you'd like to use across all
3601          classes.
3602
3603     The sequence how these customizations will show up in the LaTeX
3604     document are:
3605
3606     1. Header from =org-export-latex-classes=
3607     2. =org-export-latex-default-packages-alist=
3608     3. =org-export-latex-packages-alist=
3609     4. Buffer-specific things set with =#+LaTeX_HEADER:=
3610
3611     If you want more control about which segment is placed where, or
3612     if you want, for a specific class, have full control over the
3613     header and exclude some of the automatic building blocks, you can
3614     put the following macro-like place holders into the header:
3615
3616     #+begin_example
3617     [DEFAULT-PACKAGES]      \usepackage statements for default packages
3618     [NO-DEFAULT-PACKAGES]   do not include any of the default packages
3619     [PACKAGES]              \usepackage statements for packages
3620     [NO-PACKAGES]           do not include the packages
3621     [EXTRA]                 the stuff from #+LaTeX_HEADER
3622     [NO-EXTRA]              do not include #+LaTeX_HEADER stuff
3623     #+end_example
3624
3625     If you have currently customized =org-export-latex-classes=, you
3626     should revise that customization and remove any package calls that
3627     are covered by =org-export-latex-default-packages-alist=.  This
3628     applies to the following packages:
3629
3630     - inputenc
3631     - fontenc
3632     - fixltx2e
3633     - graphicx
3634     - longtable
3635     - float
3636     - wrapfig
3637     - soul
3638     - t1enc
3639     - textcomp
3640     - marvosym
3641     - wasysym
3642     - latexsym
3643     - amssymb
3644     - hyperref
3645
3646     If one of these packages creates a conflict with another package
3647     you are using, you can remove it from
3648     =org-export-latex-default-packages-alist=.  But then you risk that
3649     some of the advertised export features of Org will not work
3650     properly.
3651
3652     You can also consider moving packages that you use in all classes
3653     to =org-export-latex-packages-alist=.  If necessary, put the place
3654     holders so that the packages get loaded in the right sequence.  As
3655     said above, for backward compatibility, if you omit the place
3656     holders, all the variables will dump their content at the end of
3657     the header.
3658
3659 *** The constant =org-html-entities= is obsolete
3660
3661     Its content is now part of the new constant =org-entities=, which
3662     is defined in the file org-entities.el.  =org-html-entities= was
3663     an internal variable, but it is possible that some users did write
3664     code using it.
3665
3666 *** =org-bbdb-anniversary-format-alist= has changed
3667
3668     Please check the docstring and update your settings accordingly.
3669
3670 *** Deleted =org-mode-p=
3671
3672     This function has been deleted: please update your code.
3673
3674 ** Important new features
3675
3676 *** New Org to ODT exporter
3677
3678     Jambunathan's Org to ODT exporter is now part of Org.
3679
3680     To use it, it `C-c C-e o' in an Org file.  See the documentation
3681     for more information on how to customize it.
3682
3683 *** org-capture.el is now the default capture system
3684
3685     This replaces the earlier system org-remember.  The manual only
3686     describes org-capture, but for people who prefer to continue to
3687     use org-remember, we keep a static copy of the former manual
3688     section [[https://orgmode.org/org-remember.pdf][chapter about remember]].
3689
3690     The new system has a technically cleaner implementation and more
3691     possibilities for capturing different types of data.  See
3692     [[http://thread.gmane.org/gmane.emacs.orgmode/26441/focus%3D26441][Carsten's announcement]] for more details.
3693
3694     To switch over to the new system:
3695
3696     1. Run
3697
3698      : M-x org-capture-import-remember-templates RET
3699
3700        to get a translated version of your remember templates into the
3701        new variable =org-capture-templates=.  This will "mostly" work,
3702        but maybe not for all cases.  At least it will give you a good
3703        place to modify your templates.  After running this command,
3704        enter the customize buffer for this variable with
3705
3706      : M-x customize-variable RET org-capture-templates RET
3707
3708        and convince yourself that everything is OK.  Then save the
3709        customization.
3710
3711     2. Bind the command =org-capture= to a key, similar to what you did
3712        with org-remember:
3713
3714      : (define-key global-map "\C-cc" 'org-capture)
3715
3716        If your fingers prefer =C-c r=, you can also use this key once
3717        you have decided to move over completely to the new
3718        implementation.  During a test time, there is nothing wrong
3719        with using both system in parallel.
3720
3721 ** New libraries
3722
3723 *** New Org libraries
3724 **** org-eshell.el (Konrad Hinsen)
3725
3726      Implement links to eshell buffers.
3727
3728 **** org-special-blocks (Carsten Dominik)
3729
3730      This package generalizes the #+begin_foo and #+end_foo tokens.
3731
3732      To use, put the following in your init file:
3733
3734      #+BEGIN_EXAMPLE
3735 (require 'org-special-blocks)
3736 #+END_EXAMPLE
3737
3738      The tokens #+begin_center, #+begin_verse, etc. existed
3739      previously.  This package generalizes them (at least for the
3740      LaTeX and html exporters).  When a #+begin_foo token is
3741      encountered by the LaTeX exporter, it is expanded
3742      into \begin{foo}.  The text inside the environment is not
3743      protected, as text inside environments generally is.
3744      When #+begin_foo is encountered by the html exporter, a div with
3745      class foo is inserted into the HTML file.  It is up to the user
3746      to add this class to his or her stylesheet if this div is to mean
3747      anything.
3748
3749 **** org-taskjuggler.el (Christian Egli)
3750
3751      Christian Egli's /org-taskjuggler.el/ module is now part of Org.
3752      He also wrote a [[https://orgmode.org/worg/org-tutorials/org-taskjuggler.php][tutorial]] for it.
3753
3754 **** org-ctags.el (Paul Sexton)
3755
3756      Targets like =<<my target>>= can now be found by Emacs' etag
3757      functionality, and Org-mode links can be used to to link to
3758      etags, also in non-Org-mode files.  For details, see the file
3759      /org-ctags.el/.
3760
3761      This feature uses a new hook =org-open-link-functions= which will
3762      call function to do something special with text links.
3763
3764      Thanks to Paul Sexton for this contribution.
3765
3766 **** org-docview.el (Jan Böcker)
3767
3768      This new module allows links to various file types using docview, where
3769      Emacs displays images of document pages.  Docview link types can point
3770      to a specific page in a document, for example to page 131 of the
3771      Org-mode manual:
3772
3773      : [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]]
3774
3775      Thanks to Jan Böcker for this contribution.
3776
3777 *** New Babel libraries
3778
3779 - ob-picolisp.el (Thorsten Jolitz)
3780 - ob-fortran.el (Sergey Litvinov)
3781 - ob-shen.el (Eric Schulte)
3782 - ob-maxima.el (Eric S Fraga)
3783 - ob-java.el (Eric Schulte)
3784 - ob-lilypond.el (Martyn Jago)
3785 - ob-awk.el (Eric Schulte)
3786
3787 ** Other new features and various enhancements
3788
3789 *** Hyperlinks
3790
3791 **** Org-Bibtex -- major improvements
3792
3793      Provides support for managing bibtex bibliographical references
3794      data in headline properties.  Each headline corresponds to a
3795      single reference and the relevant bibliographic meta-data is
3796      stored in headline properties, leaving the body of the headline
3797      free to hold notes and comments.  Org-bibtex is aware of all
3798      standard bibtex reference types and fields.
3799
3800      The key new functions are
3801
3802      - org-bibtex-check :: queries the user to flesh out all required
3803           (and with prefix argument optional) bibtex fields available
3804           for the specific reference =type= of the current headline.
3805
3806      - org-bibtex-create :: Create a new entry at the given level,
3807           using org-bibtex-check to flesh out the relevant fields.
3808
3809      - org-bibtex-yank :: Yank a bibtex entry on the kill ring as a
3810           formatted Org-mode headline into the current buffer
3811
3812      - org-bibtex-export-to-kill-ring :: Export the current headline
3813           to the kill ring as a formatted bibtex entry.
3814
3815 **** org-gnus.el now allows link creation from messages
3816
3817      You can now create links from messages.  This is particularly
3818      useful when the user wants to stored messages that he sends, for
3819      later check.  Thanks to Ulf Stegemann for the patch.
3820
3821 **** Modified link escaping
3822
3823      David Maus worked on `org-link-escape'.  See [[http://article.gmane.org/gmane.emacs.orgmode/37888][his message]]:
3824
3825      : Percent escaping is used in Org mode to escape certain characters
3826      : in links that would either break the parser (e.g. square brackets
3827      : in link target oder description) or are not allowed to appear in
3828      : a particular link type (e.g. non-ascii characters in a http:
3829      : link).
3830      :
3831      : With this change in place Org will apply percent escaping and
3832      : unescaping more consistently especially for non-ascii characters.
3833      : Additionally some of the outstanding bugs or glitches concerning
3834      : percent escaped links are solved.
3835
3836      Thanks a lot to David for this work.
3837
3838 **** Make =org-store-link= point to directory in a dired buffer
3839
3840      When, in a dired buffer, the cursor is not in a line listing a
3841      file, `org-store-link' will store a link to the directory.
3842
3843      Patch by Stephen Eglen.
3844
3845 **** Allow regexps in =org-file-apps= to capture link parameters
3846
3847      The way extension regexps in =org-file-apps= are handled has
3848      changed.  Instead of matching against the file name, the regexps
3849      are now matched against the whole link, and you can use grouping
3850      to extract link parameters which you can then use in a command
3851      string to be executed.
3852
3853      For example, to allow linking to PDF files using the syntax
3854      =file:/doc.pdf::<page number>=, you can add the following entry
3855      to org-file-apps:
3856
3857      #+begin_example
3858      Extension: \.pdf::\([0-9]+\)\'
3859      Command:   evince "%s" -p %1
3860      #+end_example
3861
3862      Thanks to Jan Böcker for a patch to this effect.
3863
3864 *** Dates and time
3865
3866 **** Allow relative time when scheduling/adding a deadline
3867
3868      You can now use relative duration strings like "-2d" or "++3w"
3869      when calling =org-schedule= or =org-deadline=: it will schedule
3870      (or set the deadline for) the item respectively two days before
3871      today and three weeks after the current timestamp, if any.
3872
3873      You can use this programmatically: =(org-schedule nil "+2d")=
3874      will work on the current entry.
3875
3876      You can also use this while (bulk-)rescheduling and
3877      (bulk-)resetting the deadline of (several) items from the agenda.
3878
3879      Thanks to Memnon Anon for a heads up about this!
3880
3881 **** American-style dates are now understood by =org-read-date=
3882
3883      So when you are prompted for a date, you can now answer like this
3884
3885      #+begin_example
3886      2/5/3         --> 2003-02-05
3887      2/5           --> <CURRENT-YEAR>-02-05
3888      #+end_example
3889
3890 *** Agenda
3891
3892 **** =org-agenda-custom-commands= has a default value
3893
3894      This option used to be `nil' by default.  This now has a default
3895      value, displaying an agenda and all TODOs.  See the docstring for
3896      details.  Thanks to Carsten for this.
3897
3898 **** Improved filtering through =org-agenda-to-appt=
3899
3900      The new function allows the user to refine the scope of entries
3901      to pass to =org-agenda-get-day-entries= and allows to filter out
3902      entries using a function.
3903
3904      Thanks to Peter Münster for raising a related issue and to
3905      Tassilo Horn for this idea.  Also thanks to Peter Münster for
3906      [[git:68ffb7a7][fixing a small bug]] in the final implementation.
3907
3908 **** Allow ap/pm times in agenda time grid
3909
3910      Times in the agenda can now be displayed in am/pm format.  See
3911      the new variable =org-agenda-timegrid-use-ampm=.  Thanks to
3912      C. A. Webber for a patch to this effect.
3913
3914 **** Agenda: Added a bulk "scattering" command
3915
3916      =B S= in the agenda buffer will cause tasks to be rescheduled a
3917      random number of days into the future, with 7 as the default.
3918      This is useful if you've got a ton of tasks scheduled for today,
3919      you realize you'll never deal with them all, and you just want
3920      them to be distributed across the next N days.  When called with
3921      a prefix arg, rescheduling will avoid weekend days.
3922
3923      Thanks to John Wiegley for this.
3924
3925 *** Exporting
3926
3927 **** Simplification of org-export-html-preamble/postamble
3928
3929      When set to `t', export the preamble/postamble as usual, honoring
3930      the =org-export-email/author/creator-info= variables.
3931
3932      When set to a formatting string, insert this string.  See the
3933      docstring of these variable for details about available
3934      %-sequences.
3935
3936      You can set =:html-preamble= in publishing project in the same
3937      way: `t' means to honor =:email/creator/author-info=, and a
3938      formatting string will insert a string.
3939
3940 **** New exporters to Latin-1 and UTF-8
3941
3942      While Ulf Stegemann was going through the entities list to
3943      improve the LaTeX export, he had the great idea to provide
3944      representations for many of the entities in Latin-1, and for all
3945      of them in UTF-8.  This means that we can now export files rich
3946      in special symbols to Latin-1 and to UTF-8 files.  These new
3947      exporters can be reached with the commands =C-c C-e n= and =C-c
3948      C-e u=, respectively.
3949
3950      When there is no representation for a given symbol in the
3951      targeted coding system, you can choose to keep the TeX-macro-like
3952      representation, or to get an "explanatory" representation.  For
3953      example, =\simeq= could be represented as "[approx. equal to]".
3954      Please use the variable =org-entities-ascii-explanatory= to state
3955      your preference.
3956
3957 **** HTML export: Add class to outline containers using property
3958
3959      The =HTML_CONTAINER_CLASS= property can now be used to add a
3960      class name to the outline container of a node in HTML export.
3961
3962 **** Throw an error when creating an image from a LaTeX snippet fails
3963
3964      This behavior can be configured with the new option variable
3965      =org-format-latex-signal-error=.
3966
3967 **** Support for creating BEAMER presentations from Org-mode documents
3968
3969      Org-mode documents or subtrees can now be converted directly in
3970      to BEAMER presentation.  Turning a tree into a simple
3971      presentations is straight forward, and there is also quite some
3972      support to make richer presentations as well.  See the [[https://orgmode.org/manual/Beamer-class-export.html#Beamer-class-export][BEAMER
3973      section]] in the manual for more details.
3974
3975      Thanks to everyone who has contributed to the discussion about
3976      BEAMER support and how it should work.  This was a great example
3977      for how this community can achieve a much better result than any
3978      individual could.
3979
3980 *** Refiling
3981
3982 **** Refile targets can now be cached
3983
3984      You can turn on caching of refile targets by setting the variable
3985      =org-refile-use-cache=.  This should speed up refiling if you
3986      have many eligible targets in many files.  If you need to update
3987      the cache because Org misses a newly created entry or still
3988      offers a deleted one, press =C-0 C-c C-w=.
3989
3990 **** New logging support for refiling
3991
3992      Whenever you refile an item, a time stamp and even a note can be
3993      added to this entry.  For details, see the new option
3994      =org-log-refile=.
3995
3996      Thanks to Charles Cave for this idea.
3997
3998 *** Completion
3999
4000 **** In-buffer completion is now done using John Wiegley's pcomplete.el
4001
4002      Thanks to John Wiegley for much of this code.
4003
4004 *** Tables
4005
4006 **** New command =org-table-transpose-table-at-point=
4007
4008      See the docstring.  This hack from Juan Pechiar is now part of
4009      Org's core.  Thanks to Juan!
4010
4011 **** Display field's coordinates when editing it with =C-c `=
4012
4013      When editing a field with =C-c `=, the field's coordinate will
4014      the displayed in the buffer.
4015
4016      Thanks to Michael Brand for a patch to this effect.
4017
4018 **** Spreadsheet computation of durations and time values
4019
4020      If you want to compute time values use the =T= flag, either in
4021      Calc formulas or Elisp formulas:
4022
4023      | Task 1 | Task 2 |   Total |
4024      |--------+--------+---------|
4025      |  35:00 |  35:00 | 1:10:00 |
4026      #+TBLFM: @2$3=$1+$2;T
4027
4028      Values must be of the form =[HH:]MM:SS=, where hours are
4029      optional.
4030
4031      Thanks to Martin Halder, Eric Schulte and Carsten for code and
4032      feedback on this.
4033
4034 **** Implement formulas applying to field ranges
4035
4036      Carsten implemented this field-ranges formulas.
4037
4038      : A frequently requested feature for tables has been to be able to define
4039      : row formulas in a way similar to column formulas.  The patch below allows
4040      : things like
4041      :
4042      : @3=
4043      : @2$2..@5$7=
4044      : @I$2..@II$4=
4045      :
4046      : as the left hand side for table formulas in order to write a formula that
4047      : is valid for an entire column or for a rectangular section in a
4048      : table.
4049
4050      Thanks a lot to Carsten for this.
4051
4052 **** Sending radio tables from org buffers is now allowed
4053
4054      Org radio tables can no also be sent inside Org buffers.  Also,
4055      there is a new hook which get called after a table has been sent.
4056
4057      Thanks to Seweryn Kokot.
4058
4059 *** Lists
4060
4061 **** Improved handling of lists
4062
4063      Nicolas Goaziou extended and improved the way Org handles lists.
4064
4065      1. Indentation of text determines again end of items in
4066         lists. So, some text less indented than the previous item
4067         doesn't close the whole list anymore, only all items more
4068         indented than it.
4069
4070      2. Alphabetical bullets are implemented, through the use of the
4071         variable `org-alphabetical-lists'. This also adds alphabetical
4072         counters like [@c] or [@W].
4073
4074      3. Lists can now safely contain drawers, inline tasks, or various
4075         blocks, themselves containing lists. Two variables are
4076         controlling this: `org-list-forbidden-blocks', and
4077         `org-list-export-context'.
4078
4079      4. Improve `newline-and-indent' (C-j): used in an item, it will
4080         keep text from moving at column 0. This allows to split text
4081         and make paragraphs and still not break the list.
4082
4083      5. Improve `org-toggle-item' (C-c -): used on a region with
4084         standard text, it will change the region into one item. With a
4085         prefix argument, it will fallback to the previous behavior and
4086         make every line in region an item. It permits to easily
4087         integrate paragraphs inside a list.
4088
4089      6. `fill-paragraph' (M-q) now understands lists. It can freely be
4090         used inside items, or on text just after a list, even with no
4091         blank line around, without breaking list structure.
4092
4093      Thanks a lot to Nicolas for all this!
4094
4095 *** Inline display of linked images
4096
4097     Images can now be displayed inline.  The key C-c C-x C-v does
4098     toggle the display of such images.  Note that only image links
4099     that have no description part will be inlined.
4100
4101 *** Implement offsets for ordered lists
4102
4103     If you want to start an ordered plain list with a number different
4104     from 1, you can now do it like this:
4105
4106     : 1. [@start:12] will star a lit a number 12
4107
4108 *** Babel: code block body expansion for table and preview
4109
4110     In org-babel, code is "expanded" prior to evaluation. I.e. the
4111     code that is actually evaluated comprises the code block contents,
4112     augmented with the extra code which assigns the referenced data to
4113     variables. It is now possible to preview expanded contents, and
4114     also to expand code during during tangling. This expansion takes
4115     into account all header arguments, and variables.
4116
4117     A new keybinding `C-c M-b p' bound to `org-babel-expand-src-block'
4118     can be used from inside of a source code block to preview its
4119     expanded contents (which can be very useful for debugging).
4120     tangling
4121
4122     The expanded body can now be tangled, this includes variable
4123     values which may be the results of other source-code blocks, or
4124     stored in headline properties or tables. One possible use for this
4125     is to allow those using org-babel for their emacs initialization
4126     to store values (e.g. usernames, passwords, etc...) in headline
4127     properties or in tables.
4128
4129     Org-babel now supports three new header arguments, and new default
4130     behavior for handling horizontal lines in tables (hlines), column
4131     names, and rownames across all languages.
4132
4133 *** Editing Convenience and Appearance
4134
4135 **** New command =org-copy-visible= (=C-c C-x v=)
4136
4137      This command will copy the visible text in the region into the
4138      kill ring.  Thanks to Florian Beck for this function and to
4139      Carsten for adding it to org.el and documenting it!
4140
4141 **** Make it possible to protect hidden subtrees from being killed by =C-k=
4142
4143      See the new variable =org-ctrl-k-protect-subtree=.  This was a
4144      request by Scott Otterson.
4145
4146 **** Implement pretty display of entities, sub-, and superscripts.
4147
4148      The command =C-c C-x \= toggles the display of Org's special
4149      entities like =\alpha= as pretty unicode characters.  Also, sub
4150      and superscripts are displayed in a pretty way (raised/lower
4151      display, in a smaller font).  If you want to exclude sub- and
4152      superscripts, see the variable
4153      =org-pretty-entities-include-sub-superscripts=.
4154
4155      Thanks to Eric Schulte and Ulf Stegeman for making this possible.
4156
4157 **** New faces for title, date, author and email address lines
4158
4159      The keywords in these lines are now dimmed out, and the title is
4160      displayed in a larger font, and a special font is also used for
4161      author, date, and email information.  This is implemented by the
4162      following new faces:
4163
4164      =org-document-title=
4165      =org-document-info=
4166      =org-document-info-keyword=
4167
4168      In addition, the variable =org-hidden-keywords= can be used to
4169      make the corresponding keywords disappear.
4170
4171      Thanks to Dan Davison for this feature.
4172
4173 **** Simpler way to specify faces for tags and todo keywords
4174
4175      The variables =org-todo-keyword-faces=, =org-tag-faces=, and
4176      =org-priority-faces= now accept simple color names as
4177      specifications.  The colors will be used as either foreground or
4178      background color for the corresponding keyword.  See also the
4179      variable =org-faces-easy-properties=, which governs which face
4180      property is affected by this setting.
4181
4182      This is really a great simplification for setting keyword faces.
4183      The change is based on an idea and patch by Ryan Thompson.
4184
4185 **** <N> in tables now means fixed width, not maximum width
4186
4187      Requested by Michael Brand.
4188
4189 **** Better level cycling function
4190
4191      =TAB= in an empty headline cycles the level of that headline
4192      through likely states.  Ryan Thompson implemented an improved
4193      version of this function, which does not depend upon when exactly
4194      this command is used.  Thanks to Ryan for this improvement.
4195
4196 **** Adaptive filling
4197
4198      For paragraph text, =org-adaptive-fill-function= did not handle
4199      the base case of regular text which needed to be filled.  This is
4200      now fixed.  Among other things, it allows email-style ">"
4201      comments to be filled correctly.
4202
4203      Thanks to Dan Hackney for this patch.
4204
4205 **** `org-reveal' (=C-c C-r=) also decrypts encrypted entries (org-crypt.el)
4206
4207      Thanks to Richard Riley for triggering this change.
4208
4209 **** Better automatic letter selection for TODO keywords
4210
4211      When all first letters of keywords have been used, Org now
4212      assigns more meaningful characters based on the keywords.
4213
4214      Thanks to Mikael Fornius for this patch.
4215
4216 *** Clocking
4217
4218 **** Clock: Allow synchronous update of timestamps in CLOCK log
4219
4220      Using =S-M-<up/down>= on CLOCK log timestamps will
4221      increase/decrease the two timestamps on this line so that
4222      duration will keep the same.  Note that duration can still be
4223      slightly modified in case a timestamp needs some rounding.
4224
4225      Thanks to Rainer Stengele for this idea.
4226
4227 **** Localized clock tables
4228
4229      Clock tables now support a new new =:lang= parameter, allowing
4230      the user to customize the localization of the table headers.  See
4231      the variable =org-clock-clocktable-language-setup= which controls
4232      available translated strings.
4233
4234 **** Show clock overruns in mode line
4235
4236      When clocking an item with a planned effort, overrunning the
4237      planned time is now made visible in the mode line, for example
4238      using the new face =org-mode-line-clock-overrun=, or by adding an
4239      extra string given by =org-task-overrun-text=.
4240
4241      Thanks to Richard Riley for a patch to this effect.
4242
4243 **** Clock reports can now include the running, incomplete clock
4244
4245      If you have a clock running, and the entry being clocked falls
4246      into the scope when creating a clock table, the time so far spent
4247      can be added to the total.  This behavior depends on the setting
4248      of =org-clock-report-include-clocking-task=.  The default is
4249      =nil=.
4250
4251      Thanks to Bernt Hansen for this useful addition.
4252
4253 *** Misc
4254
4255 **** Improvements with inline tasks and indentation
4256
4257      There is now a configurable way on how to export inline tasks.
4258      See the new variable =org-inlinetask-export-templates=.
4259
4260      Thanks to Nicolas Goaziou for coding these changes.
4261
4262 **** A property value of "nil" now means to unset a property
4263
4264      This can be useful in particular with property inheritance, if
4265      some upper level has the property, and some grandchild of it
4266      would like to have the default settings (i.e. not overruled by a
4267      property) back.
4268
4269      Thanks to Robert Goldman and Bernt Hansen for suggesting this
4270      change.
4271
4272 **** New helper functions in org-table.el
4273
4274      There are new functions to access and write to a specific table field.
4275      This is for hackers, and maybe for the org-babel people.
4276
4277      #+begin_example
4278      org-table-get
4279      org-table-put
4280      org-table-current-line
4281      org-table-goto-line
4282      #+end_example
4283
4284 **** Archiving: Allow to reverse order in target node
4285
4286      The new option =org-archive-reversed-order= allows to have
4287      archived entries inserted in a last-on-top fashion in the target
4288      node.
4289
4290      This was requested by Tom.
4291
4292 **** Org-reveal: Double prefix arg shows the entire subtree of the parent
4293
4294      This can help to get out of an inconsistent state produced for
4295      example by viewing from the agenda.
4296
4297      This was a request by Matt Lundin.
4298
4299 * License
4300
4301   This file is part of GNU Emacs.
4302
4303   GNU Emacs is free software: you can redistribute it and/or modify
4304   it under the terms of the GNU General Public License as published by
4305   the Free Software Foundation, either version 3 of the License, or
4306   (at your option) any later version.
4307
4308   GNU Emacs is distributed in the hope that it will be useful,
4309   but WITHOUT ANY WARRANTY; without even the implied warranty of
4310   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
4311   GNU General Public License for more details.
4312
4313   You should have received a copy of the GNU General Public License
4314   along with GNU Emacs.  If not, see <https://www.gnu.org/licenses/>.