Commit | Line | Data |
---|---|---|
62803a2e | 1 | ORG NEWS -- history of user-visible changes. -*- mode: org; coding: utf-8 -*- |
2a12997c | 2 | |
c7cf0ebc | 3 | #+LINK: doc http://orgmode.org/worg/doc.html#%s |
271672fa | 4 | #+LINK: git http://orgmode.org/w/?p=org-mode.git;a=commit;h=%s |
c7cf0ebc | 5 | |
ba318903 | 6 | Copyright (C) 2012-2014 Free Software Foundation, Inc. |
2a12997c BG |
7 | See the end of the file for license conditions. |
8 | ||
9 | Please send Org bug reports to emacs-orgmode@gnu.org. | |
10 | ||
271672fa BG |
11 | * Version 8.2.3 |
12 | ||
13 | ** Incompatible changes | |
14 | ||
15 | *** Combine org-mac-message.el and org-mac-link-grabber into org-mac-link.el | |
16 | ||
17 | Please remove calls to =(require 'org-mac-message)= and =(require | |
18 | 'org-mac-link-grabber)= in your =.emacs= initialization file. All you | |
19 | need now is =(require 'org-mac-link)=. | |
20 | ||
21 | Additionally, replace any calls to =ogml-grab-link= to | |
22 | =org-mac-grab-link=. For example, replace this line: | |
23 | ||
24 | : (define-key org-mode-map (kbd "C-c g") 'omgl-grab-link) | |
25 | ||
26 | with this: | |
27 | ||
28 | : (define-key org-mode-map (kbd "C-c g") 'org-mac-grab-link) | |
29 | ||
30 | *** HTML export: Replace =HTML_HTML5_FANCY= by =:html-html5-fancy= (...) | |
31 | ||
32 | Some of the HTML specific export options in Org <8.1 are either nil or | |
33 | t, like =#+HTML_INCLUDE_STYLE=. We replaced these binary options with | |
34 | option keywords like :html-include-style. | |
35 | ||
36 | So you need to replace | |
37 | ||
38 | : #+HTML_INCLUDE_STYLE: t | |
39 | ||
40 | by | |
41 | ||
42 | : #+OPTIONS: :html-include-style t | |
43 | ||
44 | Options affected by this change: =HTML5_FANCY=, =HTML_INCLUDE_SCRIPTS= | |
45 | and =HTML_INCLUDE_STYLE=. | |
46 | ||
47 | *** Add an argument to ~org-export-to-file~ and ~org-export-to-buffer~ | |
48 | ||
49 | ~org-export-to-file~ and ~org-export-to-file~ can run in a different | |
50 | process when provided a non-nil =ASYNC= optional argument, without | |
51 | relying on ~org-export-async-start~ macro. | |
52 | ||
53 | Since =ASYNC= is the first of optional arguments, you have to shift | |
54 | the other optional arguments accordingly. | |
55 | ||
56 | *** Export back-ends are now structures | |
57 | ||
58 | Export back-ends are now structures, and stored as such in the | |
59 | communication channel during an export process. In other words, from | |
60 | now on, ~(plist-get info :back-end)~ will return a structure instead | |
61 | of a symbol. | |
62 | ||
63 | Arguments in hooks and in filters are still symbols, though. | |
64 | ||
65 | ** Important bugfixes | |
66 | ||
67 | *** [[doc:org-insert-heading][org-insert-heading]] has been rewritten and bugs are now fixed | |
68 | *** The replacement of disputed keys is now turned of when reading a date | |
69 | ||
70 | *** Match string for sparse trees can now contain a slash in a property value | |
71 | ||
72 | You can now have searches like SOMEPROP="aaa/bbb". Until now, | |
73 | this would break because the slash would be interpreted as the | |
74 | separator starting a TOTO match string. | |
75 | ** New features | |
76 | ||
77 | *** =C-c ^ x= will now sort checklist items by their checked status | |
78 | ||
79 | See [[doc:org-sort-list][org-sort-list]]: hitting =C-c ^ x= will put checked items at the end | |
80 | of the list. | |
81 | *** Various LaTeX export enhancements | |
82 | ||
83 | - Support SVG images | |
84 | - Support for .pgf files | |
85 | - LaTeX Babel blocks can now be exported as =.tikz= files | |
86 | - Allow =latexmk= as an option for [[doc:org-latex-pdf-process][org-latex-pdf-process]] | |
87 | - When using =\usepackage[AUTO]{babel}=, AUTO will automatically be | |
88 | replaced with a value compatible with ~org-export-default-language~ | |
89 | or ~LANGUAGE~ keyword. | |
90 | - The dependency on the =latexsym= LaTeX package has been removed, we | |
91 | now use =amssymb= symbols by default instead. | |
92 | ||
93 | *** New functions for paragraph motion | |
94 | ||
95 | The commands =C-down= and =C-up= now invoke special commands | |
96 | that use knowledge from the org-elements parser to move the cursor | |
97 | in a paragraph-like way. | |
98 | ||
99 | *** New entities in =org-entities.el= | |
100 | ||
101 | Add support for ell, imath, jmath, varphi, varpi, aleph, gimel, beth, | |
102 | dalet, cdots, S (ยง), dag, ddag, colon, therefore, because, triangleq, | |
103 | leq, geq, lessgtr, lesseqgtr, ll, lll, gg, ggg, prec, preceq, | |
d1389828 | 104 | preccurlyeq, succ, succeq, succurlyeq, setminus, nexist(s), mho, |
271672fa BG |
105 | check, frown, diamond. Changes loz, vert, checkmark, smile and tilde. |
106 | ||
107 | *** Anonymous export back-ends | |
108 | ||
109 | ~org-export-create-backend~ can create anonymous export back-ends, | |
110 | which can then be passed to export functions like | |
111 | ~org-export-to-file~, ~org-export-to-buffer~ or ~org-export-as~. | |
112 | ||
113 | It allows for quick translation of Org syntax without the overhead of | |
114 | registering a new back-end. | |
115 | ||
116 | *** New agenda fortnight view | |
117 | ||
118 | The agenda has not, in addition to day, week, month, and year | |
119 | views, also a fortnight view covering 14 days. | |
120 | ** New options | |
121 | ||
122 | *** New option [[doc:org-bookmark-names-plist][org-bookmark-names-plist]] | |
123 | ||
124 | This allows to specify the names of automatic bookmarks. | |
125 | *** New option [[doc:org-agenda-ignore-drawer-properties][org-agenda-ignore-drawer-properties]] | |
126 | ||
127 | This allows more flexibility when optimizing the agenda generation. | |
128 | See http://orgmode.org/worg/agenda-optimization.html for details. | |
129 | *** New option: [[doc:org-html-link-use-abs-url][org-html-link-use-abs-url]] to force using absolute URLs | |
130 | ||
131 | This is an export/publishing option, and should be used either within | |
132 | the =#+OPTIONS= line(s) or within a [[doc:org-publish-project-alist][org-publish-project-alist]]. | |
133 | ||
134 | Setting this option to =t= is needed when the HTML output does not | |
135 | allow relative URLs. For example, the =contrib/lisp/ox-rss.el= | |
136 | library produces a RSS feed, and RSS feeds need to use absolute URLs, | |
137 | so a combination of =:html-link-home "..." and :html-link-use-abs-url | |
138 | t= is required---see the configuration example in the comment section | |
139 | of =ox-rss.el=. | |
140 | ||
141 | *** New option [[doc:org-babel-ditaa-java-cmd][org-babel-ditaa-java-cmd]] | |
142 | ||
143 | This makes java executable configurable for ditaa blocks. | |
144 | ||
145 | *** New options [[doc:org-babel-latex-htlatex][org-babel-latex-htlatex]] and [[doc:org-babel-latex-htlatex-packages][org-babel-latex-htlatex-packages]] | |
146 | ||
147 | This enables SVG generation from latex code blocks. | |
148 | ||
d1389828 | 149 | *** New option: [[doc:org-habit-show-done-always-green][org-habit-show-done-always-green]] |
271672fa BG |
150 | |
151 | See [[http://lists.gnu.org/archive/html/emacs-orgmode/2013-05/msg00214.html][this message]] from Max Mikhanosha. | |
152 | ||
153 | *** New option: [[doc:org-babel-inline-result-wrap][org-babel-inline-result-wrap]] | |
154 | ||
155 | If you set this to the following | |
156 | ||
157 | : (setq org-babel-inline-result-wrap "$%s$") | |
158 | ||
159 | then inline code snippets will be wrapped into the formatting string. | |
160 | ||
161 | *** New option: [[doc:org-special-ctrl-o][org-special-ctrl-o]] | |
162 | ||
163 | This variable can be used to turn off the special behavior of | |
164 | =C-o= in tables. | |
165 | ** New contributed packages | |
166 | ||
167 | - =ox-bibtex.el= by Nicolas Goaziou :: an utility to handle BibTeX | |
168 | export to both LaTeX and HTML exports. It uses the [[http://www.lri.fr/~filliatr/bibtex2html/][bibtex2html]] | |
169 | software. | |
170 | ||
171 | - =org-screenshot.el= by Max Mikhanosha :: an utility to handle | |
172 | screenshots easily from Org, using the external tool [[http://freecode.com/projects/scrot][scrot]]. | |
173 | ||
174 | * Version 8.0.1 | |
175 | ||
176 | ** Installation | |
177 | ||
178 | Installation instructions have been updated and simplified. | |
179 | ||
180 | If you have troubles installing or updating Org, focus on these | |
181 | instructions: | |
182 | ||
183 | - when updating via a =.zip/.tar.gz= file, you only need to set the | |
184 | =load-path= in your =.emacs=. Set it before any other Org | |
185 | customization that would call autoloaded Org functions. | |
186 | ||
187 | - when updating by pulling Org's Git repository, make sure to create the | |
188 | correct autoloads. You can do this by running =~$ make autoloads= (to | |
189 | only create the autoloads) or by running =~$ make= (to also compile | |
190 | the Emacs lisp files.) =~$ make help= and =~$ make helpall= gives you | |
191 | detailed explanations. | |
192 | ||
193 | - when updating through ELPA (either from GNU ELPA or from Org ELPA), | |
194 | you have to install Org's ELPA package in a session where no Org | |
195 | function has been called already. | |
196 | ||
197 | When in doubt, run =M-x org-version RET= and see if you have a mixed-up | |
198 | installation. | |
199 | ||
200 | See http://orgmode.org/org.html#Installation for details. | |
201 | ||
202 | ** Incompatible changes | |
203 | ||
204 | Org 8.0 is the most disruptive major version of Org. | |
205 | ||
206 | If you configured export options, you will have to update some of them. | |
207 | ||
208 | If you used =#+ATTR_*= keywords, the syntax of the attributes changed and | |
209 | you will have to update them. | |
210 | ||
211 | Below is a list of changes for which you need to take action. | |
212 | ||
213 | See http://orgmode.org/worg/org-8.0.html for the most recent version of | |
214 | this list and for detailed instructions on how to migrate. | |
215 | ||
216 | **** New export engine | |
217 | ||
218 | Org 8.0 comes with a new export engine written by Nicolas Goaziou. This | |
219 | export engine relies on ~org-element.el~ (Org's syntax parser), which was | |
220 | already in Org's core. This new export engine triggered the rewriting of | |
221 | /all/ export back-ends. | |
222 | ||
223 | The most visible change is the export dispatcher, accessible through the | |
224 | keybinding =C-c C-e=. By default, this menu only shows some of the | |
225 | built-in export formats, but you can add more formats by loading them | |
226 | directly (e.g., =(require 'ox-texinfo)= or by configuring the option | |
227 | [[doc:org-export-backends][org-export-backends]]. | |
228 | ||
229 | More contributed back-ends are available from the =contrib/= directory, the | |
230 | corresponding files start with the =ox-= prefix. | |
231 | ||
232 | If you customized an export back-end (like HTML or LaTeX), you will need to | |
233 | rename some options so that your customization is not lost. Typically, an | |
234 | option starting with =org-export-html-= is now named =org-html-=. See the | |
235 | manual for details and check [[http://orgmode.org/worg/org-8.0.html][this Worg page]] for directions. | |
236 | ||
237 | **** New syntax for #+ATTR_HTML/LaTeX/... options | |
238 | ||
239 | : #+ATTR_HTML width="200px" | |
240 | ||
241 | should now be written | |
242 | ||
243 | : #+ATTR_HTML :width 200px | |
244 | ||
245 | Keywords like =#+ATTR_HTML= and =#+ATTR_LaTeX= are defined in their | |
246 | respective back-ends, and the list of supported parameters depends on | |
247 | each backend. See Org's manual for details. | |
248 | ||
249 | **** ~org-remember.el~ has been removed | |
250 | ||
251 | You cannot use =remember.el= anymore to capture notes. | |
252 | ||
253 | Support for remember templates has been obsoleted since long, it is | |
254 | now fully removed. | |
255 | ||
256 | Use =M-x org-capture-import-remember-templates RET= to import your | |
257 | remember templates into capture templates. | |
258 | ||
259 | **** ~org-jsinfo.el~ has been merged into ~ox-html.el~ | |
260 | ||
261 | If you were requiring ~ox-jsinfo.el~ in your ~.emacs.el~ file, you | |
262 | will have to remove this requirement from your initialization file. | |
263 | ||
264 | **** Note for third-party developers | |
265 | ||
266 | The name of the files for export back-end have changed: we now use the | |
267 | prefix =ox-= for those files (like we use the =ob-= prefix for Babel | |
268 | files.) For example ~org-html.el~ is now ~ox-html.el~. | |
269 | ||
270 | If your code relies on these files, please update the names in your | |
271 | code. | |
272 | ||
273 | **** Packages moved from core to contrib | |
274 | ||
275 | Since packages in Org's core are meant to be part of GNU Emacs, we try | |
276 | to be minimalist when it comes to adding files into core. For 8.0, we | |
277 | moved some contributions into the =contrib/= directory. | |
278 | ||
279 | The rationale for deciding that these files should live in =contrib/= | |
d1389828 PE |
280 | is either because they rely on third-party software that is not |
281 | included in Emacs, or because they are not targeting a significant | |
271672fa BG |
282 | user-base. |
283 | ||
284 | - org-colview-xemacs.el | |
285 | - org-mac-message.el | |
286 | - org-mew.el | |
287 | - org-wl.el | |
288 | - ox-freedmind.el | |
289 | - ox-taskjuggler.el | |
290 | ||
291 | Note that ~ox-freedmind.el~ has been rewritten by Jambunathan, | |
292 | ~org-mew.el~ has been enhanced by Tokuya Kameshima and | |
293 | ~ox-taskjuggler.el~ by Nicolas Goaziou and others. | |
294 | ||
295 | Also, the Taskjuggler exporter now uses TJ3 by default. John Hendy | |
296 | wrote [[http://orgmode.org/worg/org-tutorials/org-taskjuggler3.html][a tutorial on Worg]] for the TJ3 export. | |
297 | ||
298 | ** New packages in core | |
299 | ||
300 | *** ~ob-makefile.el~ by Eric Schulte and Thomas S. Dye | |
301 | ||
302 | =ob-makefile.el= implements Org Babel support for Makefile tangling. | |
303 | ||
304 | *** ~ox-man.el~ by Luis Anaya | |
305 | ||
306 | =ox-man.el= allows you to export Org files to =man= pages. | |
307 | ||
308 | *** ~ox-md.el~ by Nicolas Goaziou | |
309 | ||
310 | =ox-md.el= allows you to export Org files to Markdown files, using the | |
311 | vanilla [[http://daringfireball.net/projects/markdown/][Markdown syntax]]. | |
312 | ||
313 | *** ~ox-texinfo.el~ by Jonathan Leech-Pepin | |
314 | ||
315 | =ox-texinfo.el= allows you to export Org files to [[http://www.gnu.org/software/texinfo/][Texinfo]] files. | |
316 | ||
317 | ** New packages in contrib | |
318 | ||
319 | *** ~ob-julia.el~ by G. Jay Kerns | |
320 | ||
321 | [[http://julialang.org/][Julia]] is a new programming language. | |
322 | ||
323 | =ob-julia.el= provides Org Babel support for evaluating Julia source | |
324 | code. | |
325 | ||
326 | *** ~ob-mathomatic.el~ by Luis Anaya | |
327 | ||
328 | [[http://www.mathomatic.org/][mathomatic]] a portable, command-line, educational CAS and calculator | |
329 | software, written entirely in the C programming language. | |
330 | ||
331 | ~ob-mathomatic.el~ provides Org Babel support for evaluating mathomatic | |
332 | entries. | |
333 | ||
334 | *** ~ob-tcl.el~ by Luis Anaya | |
335 | ||
336 | ~ob-tcl.el~ provides Org Babel support for evaluating [[http://www.tcl.tk/][Tcl]] source code. | |
337 | ||
338 | *** ~org-bullets.el~ by Evgeni Sabof | |
339 | ||
340 | Display bullets instead of stars for headlines. | |
341 | ||
342 | Also see [[http://orgmode.org/worg/org-faq.html#sec-8-12][this updated FAQ]] on how to display another character than "*" | |
343 | for starting headlines. | |
344 | ||
345 | *** ~org-favtable.el~ by Marc-Oliver Ihm | |
346 | ||
347 | ~org-favtable.el~ helps you to create and update a table of favorite | |
348 | locations in org, keeping the most frequently visited lines right at | |
349 | the top. This table is called "favtable". See the documentation on | |
350 | [[http://orgmode.org/worg/org-contrib/org-favtable.html][Worg]]. | |
351 | ||
352 | *** ~ox-confluence.el~ by Sรฉbastien Delafond | |
353 | ||
354 | ~ox-confluence.el~ lets you convert Org files to [[https://confluence.atlassian.com/display/DOC/Confluence%2BWiki%2BMarkup][Confluence Wiki]] files. | |
355 | ||
356 | *** ~ox-deck.el~ and ~ox-s5.el~ by Rick Frankel | |
357 | ||
358 | [[http://imakewebthings.com/deck.js/][deck.js]] is a javascript library for displaying HTML ages as | |
359 | presentations. ~ox-deck.el~ exports Org files to HTML presentations | |
360 | using =deck.js=. | |
361 | ||
362 | [[http://meyerweb.com/eric/tools/s5/][s5]] is a set of scripts which also allows to display HTML pages as | |
363 | presentations. ~ox-s5.el~ exports Org files to HTML presentations | |
364 | using =s5=. | |
365 | ||
366 | *** ~ox-groff.el~ by Luis Anaya and Nicolas Goaziou | |
367 | ||
368 | The [[http://www.gnu.org/software/groff/][groff]] (GNU troff) software is a typesetting package which reads | |
369 | plain text mixed with formatting commands and produces formatted | |
370 | output. | |
371 | ||
372 | Luis Anaya and Nicolas Goaziou implemented ~ox-groff.el~ to allow | |
373 | conversion from Org files to groff. | |
374 | ||
375 | *** ~ox-koma-letter.el~ by Nicolas Goaziou and Alan Schmitt | |
376 | ||
377 | This back-end allow to export Org pages to the =KOMA Scrlttr2= format. | |
378 | ||
379 | *** ~ox-rss.el~ by Bastien | |
380 | ||
381 | This back-end lets you export Org pages to RSS 2.0 feeds. Combined | |
382 | with the HTML publishing feature, this allows you to build a blog | |
383 | entirely with Org. | |
384 | ||
385 | ** New features | |
386 | ||
387 | *** Export | |
388 | ||
389 | **** New export generic options | |
390 | ||
391 | If you use Org exporter, we advise you to re-read [[http://orgmode.org/org.html#Exporting][the manual section about | |
392 | it]]. It has been updated and includes new options. | |
393 | ||
394 | Among the new/updated export options, three are of particular importance: | |
395 | ||
396 | - [[doc:org-export-allow-bind-keywords][org-export-allow-bind-keywords]] :: This option replaces the old option | |
397 | =org-export-allow-BIND= and the default value is =nil=, not =confirm=. | |
d1389828 | 398 | You will need to explicitly set this to =t= in your initialization |
271672fa BG |
399 | file if you want to allow =#+BIND= keywords. |
400 | ||
401 | - [[doc:org-export-with-planning][org-export-with-planning]] :: This new option controls the export of | |
402 | =SCHEDULED:, DEADLINE:, CLOSED:= lines, and planning information is | |
403 | now skipped by default during export. This use to be the job of | |
404 | [[doc:org-export-with-timestamps][org-export-with-timestamps]], but this latter option has been given a | |
405 | new role: it controls the export of /standalone time-stamps/. When | |
406 | set to =nil=, Org will not export active and inactive time-stamps | |
407 | standing on a line by themselves or within a paragraph that only | |
408 | contains time-stamps. | |
409 | ||
410 | To check if an option has been introduced or its default value changed in | |
411 | Org 8.0, do =C-h v [option] RET= and check if the documentation says that | |
412 | the variable has been introduced (or changed) in version 24.4 of Emacs. | |
413 | ||
414 | **** Enhanced default stylesheet for the HTML exporter | |
415 | ||
416 | See the new default value of [[doc:org-html-style-default][org-html-style-default]]. | |
417 | ||
418 | **** New tags, classes and ids for the HTML exporter | |
419 | ||
420 | See the new default value of [[doc:org-html-divs][org-html-divs]]. | |
421 | ||
422 | **** Support for tikz pictures in LaTeX export | |
423 | **** ~org-man.el~: New export function for "man" links | |
424 | **** ~org-docview.el~: New export function for docview links | |
425 | *** Structure editing | |
426 | ||
427 | **** =C-u C-u M-RET= inserts a heading at the end of the parent subtree | |
428 | **** Cycling to the =CONTENTS= view keeps inline tasks folded | |
429 | ||
430 | [[doc:org-cycle-hook][org-cycle-hook]] as a new function [[doc:org-cycle-hide-inline-tasks][org-cycle-hide-inline-tasks]] which | |
431 | prevents the display of inline tasks when showing the content of a subtree. | |
432 | ||
433 | **** =C-c -= in a region makes a list item for each line | |
434 | ||
435 | This is the opposite of the previous behavior, where =C-c -= on a region | |
436 | would create one item for the whole region, and where =C-u C-c -= would | |
437 | create an item for each line. Now =C-c -= on the selected region creates | |
438 | an item per line, and =C-u C-c -= creates a single item for the whole | |
439 | region. | |
440 | ||
441 | **** When transposing words, markup characters are now part of the words | |
442 | ||
443 | In Emacs, you can transpose words with =M-t=. Transposing =*these* | |
444 | _words__= will preserve markup. | |
445 | ||
446 | **** New command [[doc:org-set-property-and-value][org-set-property-and-value]] bound to =C-c C-x P= | |
447 | ||
448 | This command allows you to quickly add both the property and its value. It | |
449 | is useful in buffers where there are many properties and where =C-c C-x p= | |
450 | can slow down the flow of editing too much. | |
451 | ||
452 | **** New commands [[doc:org-next-block][org-next-block]] and [[doc:org-previous-block][org-previous-block]] | |
453 | ||
454 | These commands allow you to go to the previous block (=C-c M-b= or the | |
455 | speedy key =B=) or to the next block (=C-c M-f= or the speedy key =F=.) | |
456 | ||
457 | **** New commands [[doc:org-drag-line-forward][org-drag-line-forward]] and [[doc:org-drag-line-backward][org-drag-line-backward]] | |
458 | ||
459 | These commands emulate the old behavior of =M-<down>= and =M-<up>= but are | |
460 | now bound to =S-M-<down>= and =S-M-<up>= respectively, since =M-<down>= and | |
461 | =M-<up>= now drag the whole element at point (a paragraph, a table, etc.) | |
462 | forward and backward. | |
463 | ||
464 | **** When a list item has a checkbox, inserting a new item uses a checkbox too | |
465 | **** When sorting entries/items, only the description of links is considered | |
466 | ||
467 | Now Org will sort this list | |
468 | ||
469 | : - [[http://abc.org][B]] | |
470 | : - [[http://def.org][A]] | |
471 | ||
472 | like this: | |
473 | ||
474 | : - [[http://def.org][A]] | |
475 | : - [[http://abc.org][B]] | |
476 | ||
477 | by comparing the descriptions, not the links. | |
478 | Same when sorting headlines instead of list items. | |
479 | **** New option =orgstruct-heading-prefix-regexp= | |
480 | ||
481 | For example, setting this option to "^;;; " in Emacs lisp files and using | |
482 | =orgstruct-mode= in those files will allow you to cycle through visibility | |
483 | states as if lines starting with ";;; *..." where headlines. | |
484 | ||
485 | In general, you want to set =orgstruct-heading-prefix-regexp= as a file | |
486 | local variable. | |
487 | ||
488 | **** New behavior of [[doc:org-clone-subtree-with-time-shift][org-clone-subtree-with-time-shift]] | |
489 | ||
490 | The default is now to ask for a time-shift only when there is a time-stamp. | |
491 | When called with a universal prefix argument =C-u=, it will not ask for a | |
492 | time-shift even if there is a time-stamp. | |
493 | ||
494 | **** New option [[doc:org-agenda-restriction-lock-highlight-subtree][org-agenda-restriction-lock-highlight-subtree]] | |
495 | ||
496 | This defaults to =t= so that the whole subtree is highlighted when you | |
497 | restrict the agenda view to it with =C-c C-x <= (or the speed command =<=). | |
498 | The default setting helps ensuring that you are not adding tasks after the | |
499 | restricted region. If you find this highlighting too intrusive, set this | |
500 | option to =nil=. | |
501 | **** New option [[doc:org-closed-keep-when-no-todo][org-closed-keep-when-no-todo]] | |
502 | ||
503 | When switching back from a =DONE= keyword to a =TODO= keyword, Org now | |
504 | removes the =CLOSED= planning information, if any. It also removes this | |
505 | information when going back to a non-TODO state (e.g., with =C-c C-t SPC=). | |
506 | If you want to keep the =CLOSED= planning information when removing the | |
507 | TODO keyword, set [[doc:org-closed-keep-when-no-todo][org-closed-keep-when-no-todo]] to =t=. | |
508 | ||
509 | **** New option [[doc:org-image-actual-width][org-image-actual-width]] | |
510 | ||
511 | This option allows you to change the width of in-buffer displayed images. | |
512 | The default is to use the actual width of the image, but you can use a | |
513 | fixed value for all images, or fall back on an attribute like | |
514 | ||
515 | : #+attr_html: :width 300px | |
516 | *** Scheduled/deadline | |
517 | ||
518 | **** Implement "delay" cookies for scheduled items | |
519 | ||
520 | If you want to delay the display of a scheduled task in the agenda, you can | |
521 | now use a delay cookie like this: =SCHEDULED: <2004-12-25 Sat -2d>=. The | |
522 | task is still scheduled on the 25th but will appear in your agenda starting | |
523 | from two days later (i.e. from March 27th.) | |
524 | ||
525 | Imagine for example that your co-workers are not done in due time and tell | |
526 | you "we need two more days". In that case, you may want to delay the | |
527 | display of the task in your agenda by two days, but you still want the task | |
528 | to appear as scheduled on March 25th. | |
529 | ||
530 | In case the task contains a repeater, the delay is considered to affect all | |
531 | occurrences; if you want the delay to only affect the first scheduled | |
532 | occurrence of the task, use =--2d= instead. See [[doc:org-scheduled-delay-days][org-scheduled-delay-days]] | |
533 | and [[doc:org-agenda-skip-scheduled-delay-if-deadline][org-agenda-skip-scheduled-delay-if-deadline]] for details on how to | |
534 | control this globally or per agenda. | |
535 | ||
536 | **** Use =C-u C-u C-c C-s= will insert a delay cookie for scheduled tasks | |
537 | ||
538 | See the previous section for why delay cookies may be useful. | |
539 | ||
540 | **** Use =C-u C-u C-c C-d= will insert a warning delay for deadline tasks | |
541 | ||
542 | =C-u C-u C-c C-d= now inserts a warning delay to deadlines. | |
543 | *** Calendar, diary and appts | |
544 | ||
545 | **** New variable [[doc:org-read-date-minibuffer-local-map][org-read-date-minibuffer-local-map]] | |
546 | ||
547 | By default, this new local map uses "." to go to today's date, like in the | |
548 | normal =M-x calendar RET=. If you want to deactivate this and to reassign | |
549 | the "@" key to =calendar-goto-today=, use this: | |
550 | ||
551 | #+BEGIN_SRC emacs-lisp | |
552 | ;; Unbind "." in Org's calendar: | |
553 | (define-key org-read-date-minibuffer-local-map (kbd ".") nil) | |
554 | ||
555 | ;; Bind "@" to `calendar-goto-today': | |
556 | (define-key org-read-date-minibuffer-local-map | |
557 | (kbd "@") | |
558 | (lambda () (interactive) (org-eval-in-calendar '(calendar-goto-today)))) | |
559 | #+END_SRC | |
560 | ||
561 | **** In Org's calendar, =!= displays diary entries of the date at point | |
562 | ||
563 | This is useful when you want to check if you don't already have an | |
564 | appointment when setting new ones with =C-c .= or =C-c s=. =!= will | |
565 | call =diary-view-entries= and display the diary in a separate buffer. | |
566 | ||
567 | **** [[doc:org-diary][org-diary]]: only keep the descriptions of links | |
568 | ||
569 | [[doc:org-diary][org-diary]] returns diary information from Org files, but it returns it | |
570 | in a diary buffer, not in an Org mode buffer. When links are displayed, | |
571 | only show their description, not the full links. | |
572 | *** Agenda | |
573 | ||
574 | **** New agenda type =agenda*= and entry types =:scheduled* :deadline*= | |
575 | ||
576 | When defining agenda custom commands, you can now use =agenda*=: this will | |
577 | list entries that have both a date and a time. This is useful when you | |
578 | want to build a list of appointments. | |
579 | ||
580 | You can also set [[doc:org-agenda-entry-types][org-agenda-entry-types]] either globally or locally in | |
581 | each agenda custom command and use =:timestamp*= and/or =:deadline*= there. | |
582 | ||
583 | Another place where this is useful is your =.diary= file: | |
584 | ||
585 | : %%(org-diary :scheduled*) ~/org/rdv.org | |
586 | ||
587 | This will list only entries from =~/org/rdv.org= that are scheduled with a | |
588 | time value (i.e. appointments). | |
589 | ||
590 | **** New agenda sorting strategies | |
591 | ||
592 | [[doc:org-agenda-sorting-strategy][org-agenda-sorting-strategy]] allows these new sorting strategies: | |
593 | ||
594 | | Strategy | Explanations | | |
595 | |----------------+------------------------------------------| | |
596 | | timestamp-up | Sort by any timestamp, early first | | |
597 | | timestamp-down | Sort by any timestamp, late first | | |
598 | | scheduled-up | Sort by scheduled timestamp, early first | | |
599 | | scheduled-down | Sort by scheduled timestamp, late first | | |
600 | | deadline-up | Sort by deadline timestamp, early first | | |
601 | | deadline-down | Sort by deadline timestamp, late first | | |
602 | | ts-up | Sort by active timestamp, early first | | |
603 | | ts-down | Sort by active timestamp, late first | | |
604 | | tsia-up | Sort by inactive timestamp, early first | | |
605 | | tsia-down | Sort by inactive timestamp, late first | | |
606 | ||
607 | **** New options to limit the number of agenda entries | |
608 | ||
609 | You can now limit the number of entries in an agenda view. This is | |
610 | different from filters: filters only /hide/ the entries in the agenda, | |
611 | while limits are set while generating the list of agenda entries. | |
612 | ||
613 | These new options are available: | |
614 | ||
615 | - [[doc:org-agenda-max-entries][org-agenda-max-entries]] :: limit by number of entries. | |
616 | - [[doc:org-agenda-max-todos][org-agenda-max-todos]] :: limit by number of TODOs. | |
617 | - [[doc:org-agenda-max-tags][org-agenda-max-tags]] :: limit by number of tagged entries. | |
618 | - [[doc:org-agenda-max-effort][org-agenda-max-effort]] :: limit by effort (minutes). | |
619 | ||
620 | For example, if you locally set [[doc:org-agenda-max-todos][org-agenda-max-todos]] to 3 in an agenda | |
621 | view, the agenda will be limited to the first three todos. Other entries | |
622 | without a TODO keyword or beyond the third TODO headline will be ignored. | |
623 | ||
624 | When setting a limit (e.g. about an effort's sum), the default behavior is | |
625 | to exclude entries that cannot be checked against (e.g. entries that have | |
626 | no effort property.) To include other entries too, you can set the limit | |
627 | to a negative number. For example =(setq org-agenda-max-tags -3)= will not | |
628 | show the fourth tagged headline (and beyond), but it will also show | |
629 | non-tagged headlines. | |
630 | ||
631 | **** =~= in agenda view sets temporary limits | |
632 | ||
633 | You can hit =~= in the agenda to temporarily set limits: this will | |
634 | regenerate the agenda as if the limits were set. This is useful for | |
635 | example when you want to only see a list of =N= tasks, or a list of tasks | |
636 | that take only =N= minutes. | |
637 | ||
638 | **** "=" in agenda view filters by regular expressions | |
639 | ||
640 | You can now filter agenda entries by regular expressions using ~=~. =C-u | |
641 | == will filter entries out. Regexp filters are cumulative. You can set | |
642 | [[doc:org-agenda-regexp-filter-preset][org-agenda-regexp-filter-preset]] to suit your needs in each agenda view. | |
643 | ||
644 | **** =|= in agenda view resets all filters | |
645 | ||
646 | Since it's common to combine tag filters, category filters, and now regexp | |
647 | filters, there is a new command =|= to reset all filters at once. | |
648 | ||
649 | **** Allow writing an agenda to an =.org= file | |
650 | ||
651 | You can now write an agenda view to an =.org= file. It copies the | |
652 | headlines and their content (but not subheadings) into the new file. | |
653 | ||
654 | This is useful when you want to quickly share an agenda containing the full | |
655 | list of notes. | |
656 | ||
d1389828 | 657 | **** New commands to drag an agenda line forward (=M-<down>=) or backward (=M-<up>=) |
271672fa BG |
658 | |
659 | It sometimes handy to move agenda lines around, just to quickly reorganize | |
660 | your tasks, or maybe before saving the agenda to a file. Now you can use | |
661 | =M-<down>= and =M-<up>= to move the line forward or backward. | |
662 | ||
663 | This does not persist after a refresh of the agenda, and this does not | |
664 | change the =.org= files who contribute to the agenda. | |
665 | ||
666 | **** Use =%b= for displaying "breadcrumbs" in the agenda view | |
667 | ||
668 | [[doc:org-agenda-prefix-format][org-agenda-prefix-format]] now allows to use a =%b= formatter to tell Org | |
669 | to display "breadcrumbs" in the agenda view. | |
670 | ||
671 | This is useful when you want to display the task hierarchy in your agenda. | |
672 | ||
673 | **** Use =%l= for displaying the headline's level in the agenda view | |
674 | ||
675 | [[doc:org-agenda-prefix-format][org-agenda-prefix-format]] allows to use a =%l= formatter to tell Org to | |
676 | display entries with additional spaces corresponding to their level in the | |
677 | outline tree. | |
678 | ||
679 | **** [[doc:org-agenda-write][org-agenda-write]] will ask before overwriting an existing file | |
680 | ||
681 | =M-x org-agenda-write RET= (or =C-c C-w= from an agenda buffer) used to | |
682 | overwrite preexisting file with the same name without confirmation. It now | |
683 | asks for a confirmation. | |
684 | ||
685 | **** New commands =M-m= and =M-*= to toggle (all) mark(s) for bulk action | |
686 | ||
687 | - [[doc:org-agenda-bulk-toggle][org-agenda-bulk-toggle]] :: this command is bound to =M-m= and toggles | |
688 | the mark of the entry at point. | |
689 | ||
690 | - [[doc:org-agenda-bulk-toggle-all][org-agenda-bulk-toggle-all]] :: this command is bound to =M-*= and | |
691 | toggles all the marks in the current agenda. | |
692 | ||
693 | **** New option [[doc:org-agenda-search-view-max-outline-level][org-agenda-search-view-max-outline-level]] | |
694 | ||
695 | This option sets the maximum outline level to display in search view. | |
696 | E.g. when this is set to 1, the search view will only show headlines of | |
697 | level 1. | |
698 | ||
699 | **** New option [[doc:org-agenda-todo-ignore-time-comparison-use-seconds][org-agenda-todo-ignore-time-comparison-use-seconds]] | |
700 | ||
701 | This allows to compare times using seconds instead of days when honoring | |
702 | options like =org-agenda-todo-ignore-*= in the agenda display. | |
703 | ||
704 | **** New option [[doc:org-agenda-entry-text-leaders][org-agenda-entry-text-leaders]] | |
705 | ||
706 | This allows you to get rid of the ">" character that gets added in front of | |
707 | entries excerpts when hitting =E= in the agenda view. | |
708 | ||
709 | **** New formatting string for past deadlines in [[doc:org-agenda-deadline-leaders][org-agenda-deadline-leaders]] | |
710 | ||
711 | The default formatting for past deadlines is ="%2d d. ago: "=, which makes | |
712 | it explicit that the deadline is in the past. You can configure this via | |
713 | [[doc:org-agenda-deadline-leaders][org-agenda-deadline-leaders]]. Note that the width of the formatting | |
714 | string is important to keep the agenda alignment clean. | |
715 | ||
716 | **** New allowed value =repeated-after-deadline= for [[doc:org-agenda-skip-scheduled-if-deadline-is-shown][org-agenda-skip-scheduled-if-deadline-is-shown]] | |
717 | ||
718 | When [[doc:org-agenda-skip-scheduled-if-deadline-is-shown][org-agenda-skip-scheduled-if-deadline-is-shown]] is set to | |
719 | =repeated-after-deadline=, the agenda will skip scheduled items if they are | |
d1389828 | 720 | repeated beyond the current deadline. |
271672fa BG |
721 | |
722 | **** New option for [[doc:org-agenda-skip-deadline-prewarning-if-scheduled][org-agenda-skip-deadline-prewarning-if-scheduled]] | |
723 | ||
724 | This variable may be set to nil, t, the symbol `pre-scheduled', or a number | |
725 | which will then give the number of days before the actual deadline when the | |
726 | prewarnings should resume. The symbol `pre-scheduled' eliminates the | |
727 | deadline prewarning only prior to the scheduled date. | |
728 | ||
729 | Read the full docstring for details. | |
730 | ||
731 | **** [[doc:org-class][org-class]] now supports holiday strings in the skip-weeks parameter | |
732 | ||
733 | For example, this task will now be skipped only on new year's day: | |
734 | ||
735 | : * Task | |
736 | : <%%(org-class 2012 1 1 2013 12 12 2 "New Year's Day")> | |
737 | *** Capture | |
738 | ||
739 | **** Allow =C-1= as a prefix for [[doc:org-agenda-capture][org-agenda-capture]] and [[doc:org-capture][org-capture]] | |
740 | ||
741 | With a =C-1= prefix, the capture mechanism will use the =HH:MM= value at | |
742 | point (if any) or the current =HH:MM= time as the default time for the | |
743 | capture template. | |
744 | ||
745 | **** Expand keywords within %(sexp) placeholder in capture templates | |
746 | ||
747 | If you use a =%:keyword= construct within a =%(sexp)= construct, Org will | |
748 | expand the keywords before expanding the =%(sexp)=. | |
749 | ||
750 | **** Allow to contextualize capture (and agenda) commands by checking the name of the buffer | |
751 | ||
752 | [[doc:org-capture-templates-contexts][org-capture-templates-contexts]] and [[doc:org-agenda-custom-commands-contexts][org-agenda-custom-commands-contexts]] | |
753 | allow you to define what capture templates and what agenda commands should | |
754 | be available in various contexts. It is now possible for the context to | |
755 | check against the name of the buffer. | |
756 | *** Tag groups | |
757 | ||
758 | Using =#+TAGS: { Tag1 : Tag2 Tag3 }= will define =Tag1= as a /group tag/ | |
759 | (note the colon after =Tag1=). If you search for =Tag1=, it will return | |
d1389828 | 760 | headlines containing either =Tag1=, =Tag2= or =Tag3= (or any combination |
271672fa BG |
761 | of those tags.) |
762 | ||
763 | You can use group tags for sparse tree in an Org buffer, for creating | |
764 | agenda views, and for filtering. | |
765 | ||
766 | See http://orgmode.org/org.html#Tag-groups for details. | |
767 | ||
768 | *** Links | |
769 | ||
770 | **** =C-u C-u M-x org-store-link RET= will ignore non-core link functions | |
771 | ||
772 | Org knows how to store links from Org buffers, from info files and from | |
773 | other Emacs buffers. Org can be taught how to store links from any buffer | |
774 | through new link protocols (see [[http://orgmode.org/org.html#Adding-hyperlink-types]["Adding hyperlink types"]] in the manual.) | |
775 | ||
776 | Sometimes you want Org to ignore added link protocols and store the link | |
777 | as if the protocol was not known. | |
778 | ||
779 | You can now do this with =C-u C-u M-x org-store-link RET=. | |
780 | ||
781 | **** =C-u C-u C-u M-x org-store-link RET= on an active region will store links for each lines | |
782 | ||
783 | Imagine for example that you want to store a link for every message in a | |
784 | Gnus summary buffer. In that case =C-x h C-u C-u C-u M-x org-store-link | |
785 | RET= will store a link for every line (i.e. message) if the region is | |
786 | active. | |
787 | ||
788 | **** =C-c C-M-l= will add a default description for links which don't have one | |
789 | ||
790 | =C-c C-M-l= inserts all stored links. If a link does not have a | |
791 | description, this command now adds a default one, so that we are not mixing | |
792 | with-description and without-description links when inserting them. | |
793 | ||
794 | **** No curly braces to bracket links within internal links | |
795 | ||
796 | When storing a link to a headline like | |
797 | ||
798 | : * See [[http://orgmode.org][Org website]] | |
799 | ||
800 | [[doc:org-store-link][org-store-link]] used to convert the square brackets into curly brackets. | |
801 | It does not anymore, taking the link description or the link path, when | |
802 | there is no description. | |
803 | *** Table | |
804 | ||
805 | **** Switching between #+TBLFM lines | |
806 | ||
807 | If you have several =#+TBLFM= lines below a table, =C-c C-c= on a line will | |
808 | apply the formulas from this line, and =C-c C-c= on another line will apply | |
809 | those other formulas. | |
810 | ||
811 | **** You now use "nan" for empty fields in Calc formulas | |
812 | ||
813 | If empty fields are of interest, it is recommended to reread the section | |
814 | [[http://orgmode.org/org.html#Formula-syntax-for-Calc][3.5.2 Formula syntax for Calc]] of the manual because the description for the | |
815 | mode strings has been clarified and new examples have been added towards | |
816 | the end. | |
817 | ||
818 | **** Handle localized time-stamps in formulas evaluation | |
819 | ||
820 | If your =LOCALE= is set so that Org time-stamps use another language than | |
821 | english, and if you make time computations in Org's table, it now works by | |
822 | internally converting the time-stamps with a temporary =LOCALE=C= before | |
823 | doing computation. | |
824 | ||
825 | **** New lookup functions | |
826 | ||
827 | There are now three lookup functions: | |
828 | ||
829 | - [[doc:org-loopup-first][org-loopup-first]] | |
830 | - [[doc:org-loopup-last][org-loopup-last]] | |
831 | - [[doc:org-loopup-all][org-loopup-all]] | |
832 | ||
833 | See [[http://orgmode.org/org.html#Lookup-functions][the manual]] for details. | |
834 | *** Startup keywords | |
835 | ||
836 | These new startup keywords are now available: | |
837 | ||
838 | | Startup keyword | Option | | |
839 | |----------------------------------+---------------------------------------------| | |
840 | | =#+STARTUP: logdrawer= | =(setq org-log-into-drawer t)= | | |
841 | | =#+STARTUP: nologdrawer= | =(setq org-log-into-drawer nil)= | | |
842 | |----------------------------------+---------------------------------------------| | |
843 | | =#+STARTUP: logstatesreversed= | =(setq org-log-states-order-reversed t)= | | |
844 | | =#+STARTUP: nologstatesreversed= | =(setq org-log-states-order-reversed nil)= | | |
845 | |----------------------------------+---------------------------------------------| | |
846 | | =#+STARTUP: latexpreview= | =(setq org-startup-with-latex-preview t)= | | |
847 | | =#+STARTUP: nolatexpreview= | =(setq org-startup-with-latex-preview nil)= | | |
848 | ||
849 | *** Clocking | |
850 | ||
851 | **** New option [[doc:org-clock-rounding-minutes][org-clock-rounding-minutes]] | |
852 | ||
853 | E.g. if [[doc:org-clock-rounding-minutes][org-clock-rounding-minutes]] is set to 5, time is 14:47 and you | |
854 | clock in: then the clock starts at 14:45. If you clock out within the next | |
855 | 5 minutes, the clock line will be removed; if you clock out 8 minutes after | |
856 | your clocked in, the clock out time will be 14:50. | |
857 | ||
858 | **** New option [[doc:org-time-clocksum-use-effort-durations][org-time-clocksum-use-effort-durations]] | |
859 | ||
860 | When non-nil, =C-c C-x C-d= uses effort durations. E.g., by default, one | |
861 | day is considered to be a 8 hours effort, so a task that has been clocked | |
862 | for 16 hours will be displayed as during 2 days in the clock display or in | |
863 | the clocktable. | |
864 | ||
865 | See [[doc:org-effort-durations][org-effort-durations]] on how to set effort durations and | |
866 | [[doc:org-time-clocksum-format][org-time-clocksum-format]] for more on time clock formats. | |
867 | ||
868 | **** New option [[doc:org-clock-x11idle-program-name][org-clock-x11idle-program-name]] | |
869 | ||
870 | This allows to set the name of the program which prints X11 idle time in | |
871 | milliseconds. The default is to use =x11idle=. | |
872 | ||
873 | **** New option [[doc:org-use-last-clock-out-time-as-effective-time][org-use-last-clock-out-time-as-effective-time]] | |
874 | ||
875 | When non-nil, use the last clock out time for [[doc:org-todo][org-todo]]. Note that this | |
876 | option has precedence over the combined use of [[doc:org-use-effective-time][org-use-effective-time]] and | |
877 | [[doc:org-extend-today-until][org-extend-today-until]]. | |
878 | ||
879 | **** =S-<left/right>= on a clocksum column will update the sum by updating the last clock | |
880 | **** =C-u 3 C-S-<up/down>= will update clock timestamps synchronously by 3 units | |
881 | **** New parameter =:wstart= for clocktables to define the week start day | |
882 | **** New parameter =:mstart= to state the starting day of the month | |
883 | **** Allow relative times in clocktable tstart and tend options | |
884 | **** The clocktable summary is now a caption | |
885 | **** =:tstart= and =:tend= and friends allow relative times like "<-1w>" or "<now>" | |
886 | *** Babel | |
887 | ||
888 | **** You can now use =C-c C-k= for [[doc:org-edit-src-abort][org-edit-src-abort]] | |
889 | ||
890 | This allows you to quickly cancel editing a source block. | |
891 | ||
892 | **** =C-u C-u M-x org-babel-tangle RET= tangles by the target file of the block at point | |
893 | ||
894 | This is handy if you want to tangle all source code blocks that have the | |
895 | same target than the block at point. | |
896 | ||
897 | **** New options for auto-saving the base buffer or the source block editing buffer | |
898 | ||
899 | When [[doc:org-edit-src-turn-on-auto-save][org-edit-src-turn-on-auto-save]] is set to =t=, editing a source block | |
900 | in a new window will turn on =auto-save-mode= and save the code in a new | |
901 | file under the same directory than the base Org file. | |
902 | ||
903 | When [[doc:org-edit-src-auto-save-idle-delay][org-edit-src-auto-save-idle-delay]] is set to a number of minutes =N=, | |
904 | the base Org buffer will be saved after this number of minutes of idle | |
905 | time. | |
906 | ||
907 | **** New =:post= header argument post-processes results | |
908 | ||
909 | This header argument may be used to pass the results of the current | |
910 | code block through another code block for post-processing. See the | |
911 | manual for a usage example. | |
912 | ||
913 | **** Commented out heading are ignored when collecting blocks for tangling | |
914 | ||
915 | If you comment out a heading (with =C-c ;= anywhere on the heading or in | |
916 | the subtree), code blocks from within this heading are now ignored when | |
917 | collecting blocks for tangling. | |
918 | ||
919 | **** New option [[doc:org-babel-hash-show-time][org-babel-hash-show-time]] to show a time-stamp in the result hash | |
920 | **** Do not ask for confirmation if cached value is current | |
921 | ||
922 | Do not run [[doc:org-babel-confirm-evaluate][org-babel-confirm-evaluate]] if source block has a cache and the | |
923 | cache value is current as there is no evaluation involved in this case. | |
924 | **** =ob-sql.el= and =ob-python.el= have been improved. | |
925 | **** New Babel files only need to =(require 'ob)= | |
926 | ||
927 | When writing a new Babel file, you now only need to use =(require 'ob)= | |
928 | instead of requiring each Babel library one by one. | |
929 | *** Faces | |
930 | ||
931 | - Org now fontifies radio link targets by default | |
932 | - In the agenda, use [[doc:org-todo-keyword-faces][org-todo-keyword-faces]] to highlight selected TODO keywords | |
933 | - New face [[doc:org-priority][org-priority]], enhanced fontification of priority cookies in agenda | |
934 | - New face [[doc:org-tag-group][org-tag-group]] for group tags | |
935 | ||
936 | ** Miscellaneous | |
937 | ||
938 | - New speedy key =s= pour [[doc:org-narrow-to-subtree][org-narrow-to-subtree]] | |
939 | - Handling of [[doc:org-html-table-row][org-html-table-row]] has been updated (incompatible change) | |
940 | - [[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]] | |
941 | - Support using =git-annex= with Org attachments | |
942 | - org-protocol: Pass optional value using query in url to capture from protocol | |
943 | - When the refile history is empty, use the current filename as default | |
944 | - When you cannot change the TODO state of a task, Org displays the blocking task | |
945 | - New option [[doc:org-mobile-allpriorities][org-mobile-allpriorities]] | |
946 | - org-bibtex.el now use =visual-line-mode= instead of the deprecated =longlines-mode= | |
947 | - [[doc:org-format-latex-options][org-format-latex-options]] allows to set the foreground/background colors automatically | |
948 | - New option [[doc:org-archive-file-header-format][org-archive-file-header-format]] | |
949 | - New "neg" entity in [[doc:org-entities][org-entities]] | |
950 | - New function [[doc:org-docview-export][org-docview-export]] to export docview links | |
951 | - New =:eps= header argument for ditaa code blocks | |
952 | - New option [[doc:org-gnus-no-server][org-gnus-no-server]] to start Gnus with =gnus-no-server= | |
953 | - Org is now distributed with =htmlize.el= version 1.43 | |
954 | - ~org-drill.el~ has been updated to version 2.3.7 | |
955 | - ~org-mac-iCal.el~ now supports MacOSX version up to 10.8 | |
956 | - Various improvements to ~org-contacts.el~ and =orgpan.el= | |
957 | ||
958 | ** Outside Org | |
959 | ||
960 | *** Spanish translation of the Org guide by David Arroyo Menรฉndez | |
961 | ||
962 | David (and others) translated the Org compact guide in spanish: | |
963 | ||
964 | You can read the [[http://orgmode.org/worg/orgguide/orgguide.es.pdf][PDF guide]]. | |
965 | ||
966 | *** ~poporg.el~ and ~outorg.el~ | |
967 | ||
968 | Two new libraries (~poporg.el~ by Franรงois Pinard and ~outorg.el~ by | |
969 | Thorsten Jolitz) now enable editing of comment-sections from source-code | |
970 | buffers in temporary Org-mode buffers, making the full editing power of | |
971 | Org-mode available. ~outorg.el~ comes together with ~outshine.el~ and | |
972 | ~navi-mode.el~, two more libraries by Thorsten Jolitz with the goal to give | |
973 | source-code buffers the /look & feel/ of Org-mode buffers while greatly | |
974 | improving navigation and structure editing. A detailed description can be | |
975 | found here: http://orgmode.org/worg/org-tutorials/org-outside-org.html | |
976 | ||
977 | Here are two screencasts demonstrating Thorsten's tools: | |
978 | ||
979 | - [[http://youtu.be/nqE6YxlY0rw]["Modern conventions for Emacs Lisp files"]] | |
980 | - [[http://www.youtube.com/watch?v%3DII-xYw5VGFM][Exploring Bernt Hansen's Org-mode tutorial with 'navi-mode']] | |
981 | ||
982 | *** MobileOrg for iOS | |
983 | ||
984 | MobileOrg for iOS back in the App Store The 1.6.0 release was focused on | |
985 | the new Dropbox API and minor bug fixes but also includes a new ability to | |
986 | launch in Capture mode. Track development and contribute [[https://github.com/MobileOrg/mobileorg/issues][on github]]. | |
987 | ||
c7cf0ebc BG |
988 | * Version 7.9.3 |
989 | ||
990 | ** New option [[doc::org-agenda-use-tag-inheritance][org-agenda-use-tag-inheritance]] | |
991 | ||
992 | [[doc::org-use-tag-inheritance][org-use-tag-inheritance]] controls whether tags are inherited when | |
993 | org-tags-view is called (either in =tags=, =tags-tree= or =tags-todo= | |
994 | agenda views.) | |
995 | ||
996 | When generating other agenda types such as =agenda=, =todo= and | |
997 | =todo-tree=, tags inheritance is not used when selecting the entries | |
998 | to display. Still, you might want to have all tag information correct | |
999 | in the agenda buffer, e.g. for tag filtering. In that case, add the | |
1000 | agenda type to this variable. | |
1001 | ||
1002 | Setting this variable to nil should considerably speeds up the agenda | |
1003 | generation. | |
1004 | ||
1005 | Note that the default was to display inherited tags in the agenda | |
1006 | lines even if `org-use-tag-inheritance' was nil. The default is now | |
1007 | to *never* display inherited tags in agenda lines, but to /know/ about | |
1008 | them when the agenda type is listed in [[doc::org-agenda-use-tag-inheritance][org-agenda-use-tag-inheritance]]. | |
1009 | ||
1010 | ** New default value nil for [[doc::org-agenda-dim-blocked-tasks][org-agenda-dim-blocked-tasks]] | |
1011 | ||
1012 | Using `nil' as the default value speeds up the agenda generation. You | |
1013 | can hit `#' (or `C-u #') in agenda buffers to temporarily dim (or turn | |
1014 | invisible) blocked tasks. | |
1015 | ||
1016 | ** New speedy keys for [[doc::org-speed-commands-default][org-speed-commands-default]] | |
1017 | ||
1018 | You can now use `:' (instead of `;') for setting tags---this is | |
1019 | consistent with using the `:' key in agenda view. | |
1020 | ||
1021 | You can now use `=' for [[doc::org-columns][org-columns]]. | |
1022 | ||
1023 | ** =org-float= is now obsolete, use =diary-float= instead | |
c7cf0ebc BG |
1024 | ** Enhanced compatibility with Emacs 22 and XEmacs |
1025 | ||
1026 | Thanks to Achim for his work on enhancing Org's compatibility with | |
1027 | various Emacsen. Things may not be perfect, but Org should work okay | |
1028 | in most environments. | |
1029 | ||
8223b1d2 | 1030 | * Version 7.9.2 |
2a12997c | 1031 | |
8223b1d2 | 1032 | ** New ELPA repository for Org packages |
2a12997c | 1033 | |
8223b1d2 | 1034 | You can now add the Org ELPA repository like this: |
2a12997c | 1035 | |
8223b1d2 BG |
1036 | #+BEGIN_SRC emacs-lisp |
1037 | (add-to-list 'package-archives '("org" . "http://orgmode.org/elpa/") t) | |
1038 | #+END_SRC | |
2a12997c | 1039 | |
8223b1d2 BG |
1040 | It contains both the =org-*.tar= package (the core Org distribution, also |
1041 | available through http://elpa.gnu.org) and the =org-plus*.tar= package (the | |
1042 | extended Org distribution, with non-GNU packages from the =contrib/= | |
1043 | directory.) | |
2a12997c | 1044 | |
8223b1d2 | 1045 | See http://orgmode.org/elpa/ |
2a12997c | 1046 | |
8223b1d2 | 1047 | ** Overview of the new keybindings |
2a12997c | 1048 | |
8223b1d2 BG |
1049 | | Keybinding | Speedy | Command | |
1050 | |-----------------+--------+-----------------------------| | |
1051 | | =C-c C-x C-z= | | [[doc::org-clock-resolve][org-clock-resolve]] | | |
1052 | | =C-c C-x C-q= | | [[doc::org-clock-cancel][org-clock-cancel]] | | |
1053 | | =C-c C-x C-x= | | [[doc::org-clock-in-last][org-clock-in-last]] | | |
1054 | | =M-h= | | [[doc::org-mark-element][org-mark-element]] | | |
1055 | | =*= | | [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]] | | |
1056 | | =C-c C-M-l= | | [[doc::org-insert-all-links][org-insert-all-links]] | | |
1057 | | =C-c C-x C-M-v= | | [[doc::org-redisplay-inline-images][org-redisplay-inline-images]] | | |
1058 | | =C-c C-x E= | =E= | [[doc::org-inc-effort][org-inc-effort]] | | |
1059 | | | =#= | [[doc::org-toggle-comment][org-toggle-comment]] | | |
1060 | | | =:= | [[doc::org-columns][org-columns]] | | |
1061 | | | =W= | Set =APPT_WARNTIME= | | |
1062 | | =k= | | [[doc::org-agenda-capture][org-agenda-capture]] | | |
1063 | | C-c , | , | [[doc::org-priority][org-priority]] | | |
2a12997c | 1064 | |
06827ec8 | 1065 | ** New package and Babel language |
2a12997c | 1066 | |
8223b1d2 | 1067 | *** =org-eshell.el= by Konrad Hinsen is now in Org |
2a12997c | 1068 | |
8223b1d2 | 1069 | =org-eshell.el= allows you to create links from [[http://www.gnu.org/software/emacs/manual/html_node/eshell/index.html][Eshell]]. |
2a12997c | 1070 | |
8223b1d2 BG |
1071 | *** Support for execution of Scala code blocks (see ob-scala.el) |
1072 | *** Support for execution of IO code blocks (see ob-io.el) | |
1073 | ||
1074 | ** Incompatible changes | |
1075 | ||
1076 | - If your code relies on =org-write-agenda=, please use | |
1077 | [[doc::org-agenda-write][org-agenda-write]] from now on. | |
1078 | ||
1079 | - If your code relies on =org-make-link=, please use =concat= | |
1080 | instead. | |
1081 | ||
1082 | - =org-link-to-org-use-id= has been renamed to | |
1083 | =org-id-link-to-org-use-id= and its default value is nil. The | |
1084 | previous default was =create-if-interactive-and-no-custom-id=. | |
1085 | ||
1086 | ** New features and user-visible changes | |
1087 | ||
1088 | *** Org Element | |
1089 | ||
735135f9 | 1090 | =org-element.el= is a toolbox for parsing and analyzing "elements" |
8223b1d2 BG |
1091 | in an Org-mode buffer. This has been written by Nicolas Goaziou |
1092 | and has been tested for quite some time. It is now part of Org's | |
1093 | core and many core functions rely on this package. | |
1094 | ||
735135f9 | 1095 | Two functions might be particularly handy for users: |
8223b1d2 BG |
1096 | =org-element-at-point= and =org-element-context=. |
1097 | ||
1098 | See the docstrings for more details. | |
1099 | ||
1100 | Below is a list of editing and navigating commands that now rely | |
1101 | on =org-element.el=. | |
1102 | ||
1103 | **** [[doc::org-fill-paragraph][org-fill-paragraph]] has been completely rewritten | |
1104 | ||
1105 | The filling mechanisms now rely on org-element, trying to do the | |
1106 | right thing on each element in various contexts. E.g. filling in | |
1107 | a list item will preserve indentation; filling in message-mode | |
1108 | will fall back on the relevant filling functions; etc. | |
1109 | ||
1110 | **** [[doc::org-metaup][org-metaup]] and [[doc::org-metadown][org-metadown]] will drag the element backward/forward | |
1111 | ||
1112 | If you want to get the old behavior (i.e. moving a line up and | |
1113 | down), you can first select the line as an active region, then | |
1114 | =org-metaup= or =org-metadown= to move the region backward or | |
1115 | forward. This also works with regions bigger than just one line. | |
1116 | ||
1117 | **** [[doc::org-up-element][org-up-element]] and [[doc::org-down-element][org-down-element]] (respectively =C-c C-^= and =C-c C-_=) | |
1118 | ||
1119 | This will move the point up/down in the hierarchy of elements. | |
1120 | ||
1121 | **** [[doc::org-backward-element][org-backward-element]] and [[doc::org-forward-element][org-forward-element]] (respectively =M-{= and =M-}=) | |
1122 | ||
1123 | This will move the point backward/forward in the hierarchy of | |
1124 | elements. | |
1125 | ||
1126 | **** [[doc::org-narrow-to-element][org-narrow-to-element]] will narrow to the element at point | |
1127 | **** [[doc::org-mark-element][org-mark-element]] will mark the element at point | |
1128 | ||
1129 | This command is bound to =M-h= and will mark the element at | |
1130 | point. If the point is at a paragraph, it will mark the | |
1131 | paragraph. If the point is at a list item, it will mark the list | |
1132 | item. Etc. | |
1133 | ||
1134 | Note that if point is at the beginning of a list, it will mark | |
1135 | the whole list. | |
1136 | ||
1137 | To mark a subtree, you can either use =M-h= on the headline | |
1138 | (since there is no ambiguity about the element you're at) or | |
1139 | [[doc::org-mark-subtree][org-mark-subtree]] (=C-c @=) anywhere in the subtree. | |
1140 | ||
1141 | Invoking [[doc::org-mark-element][org-mark-element]] repeatedly will try to mark the next | |
1142 | element on top of the previous one(s). E.g. hitting =M-h= twice | |
1143 | on a headline will mark the current subtree and the next one on | |
1144 | the same level. | |
1145 | ||
1146 | *** Org Agenda | |
1147 | ||
1148 | **** New option [[doc::org-agenda-sticky][org-agenda-sticky]] | |
1149 | ||
1150 | There is a new option =org-agenda-sticky= which enables "sticky" | |
1151 | agendas. Sticky agendas remain opened in the background so that | |
1152 | you don't need to regenerate them each time you hit the | |
1153 | corresponding keystroke. This is a big time saver. | |
1154 | ||
1155 | When [[doc::org-agenda-sticky][org-agenda-sticky]] is =non-nil=, the agenda buffer will be | |
1156 | named using the agenda key and its description. In sticky | |
1157 | agendas, the =q= key will just bury the agenda buffers and | |
1158 | further agenda commands will show existing buffer instead of | |
1159 | generating new ones. | |
1160 | ||
1161 | If [[doc::org-agenda-sticky][org-agenda-sticky]] is set to =nil=, =q= will kill the single | |
1162 | agenda buffer. | |
1163 | ||
1164 | **** New option [[doc::org-agenda-custom-commands-contexts][org-agenda-custom-commands-contexts]] | |
1165 | ||
1166 | Setting this option allows you to define specific context where | |
1167 | agenda commands should be available from. For example, when set | |
1168 | to this value | |
1169 | ||
1170 | #+BEGIN_SRC emacs-lisp | |
1171 | (setq org-agenda-custom-commands-contexts | |
1172 | '(("p" (in-file . "\\.txt")))) | |
1173 | #+END_SRC | |
1174 | ||
1175 | then the =p= agenda command will only be available from buffers | |
1176 | visiting *.txt files. See the docstring and the manual for more | |
1177 | details on how to use this. | |
1178 | ||
1179 | **** Changes in bulk actions | |
1180 | ||
1181 | The set of commands starting with =k ...= as been deleted and the | |
1182 | features have been merged into the "bulk action" feature. | |
1183 | ||
1184 | After you marked some entries in the agenda, if you call =B s=, | |
1185 | the agenda entries will be rescheduled using the date at point if | |
1186 | on a date header. If you are on an entry with a timestamp, you | |
1187 | will be prompted for a date to reschedule your marked entries to, | |
1188 | using the timestamp at point as the default prompt. | |
1189 | ||
1190 | You can now use =k= to capture the marked entry and use the date | |
1191 | at point as an overriding date for the capture template. | |
1192 | ||
1193 | To bind this behavior to =M-x org-capture RET= (or its | |
1194 | keybinding), set the new option [[doc::org-capture-use-agenda-date][org-capture-use-agenda-date]] to | |
1195 | =t=. | |
1196 | ||
1197 | **** =N= and =P= in the agenda will move to the next/previous item | |
1198 | ||
1199 | **** New command [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]] to mark all items | |
1200 | ||
1201 | This new command is bound to =*= in agenda mode. | |
1202 | ||
1203 | There is also a new option [[doc::org-agenda-bulk-mark-char][org-agenda-bulk-mark-char]] to set the | |
1204 | character to use as a mark for bulk actions. | |
1205 | ||
1206 | **** New option [[doc::org-agenda-persistent-marks][org-agenda-persistent-marks]] | |
1207 | ||
1208 | When set to =non-nil=, marks will remain visible after a bulk | |
1209 | action. You can temporarily toggle this by pressing =p= when | |
1210 | invoking [[doc::org-agenda-bulk-action][org-agenda-bulk-action]]. Marks are deleted if your | |
1211 | rebuild the agenda buffer or move to another date/span (e.g. with | |
1212 | =f= or =w=). | |
1213 | ||
1214 | **** New option [[doc::org-agenda-skip-timestamp-if-deadline-is-shown][org-agenda-skip-timestamp-if-deadline-is-shown]] | |
1215 | ||
1216 | =Non-nil= means skip timestamp line if same entry shows because | |
1217 | of deadline. | |
1218 | ||
1219 | In the agenda of today, an entry can show up multiple times | |
1220 | because it has both a plain timestamp and has a nearby deadline. | |
1221 | When this variable is t, then only the deadline is shown and the | |
1222 | fact that the entry has a timestamp for or including today is not | |
1223 | shown. When this variable is =nil=, the entry will be shown | |
1224 | several times. | |
1225 | ||
1226 | **** New =todo-unblocked= and =nottodo-unblocked= skip conditions | |
1227 | ||
1228 | See the [[http://orgmode.org/w/?p%3Dorg-mode.git%3Ba%3Dcommit%3Bh%3Df426da][git commit]] for more explanations. | |
1229 | ||
1230 | **** Allow category filtering in the agenda | |
1231 | ||
1232 | You can now filter the agenda by category. Pressing "<" will | |
1233 | filter by the category of the item on the current line, and | |
1234 | pressing "<" again will remove the filter. You can combine tag | |
1235 | filters and category filters. | |
1236 | ||
1237 | You can use =org-agenda-category-filter= in your custom agenda | |
1238 | views and =org-agenda-category-filter-preset= in your main | |
1239 | configuration. | |
1240 | ||
1241 | See also the new command [[doc::org-agenda-filter-by-top-category][org-agenda-filter-by-top-category]]: | |
1242 | hitting =^= will filter by "Top" category: only show entries that | |
1243 | are of the same category than the Top category of the entry at | |
1244 | point. | |
1245 | ||
1246 | *** Org Links | |
1247 | ||
1248 | **** Inserting links | |
1249 | ||
1250 | When inserting links through [[doc::org-insert-link][org-insert-link]], the description is | |
1251 | now displayed first, followed by the literal link, as the | |
1252 | description is often more useful when you look for the link you | |
1253 | want to insert. | |
1254 | ||
1255 | Completion now complete both literal links and description. If | |
1256 | you complete a description, the literal link and its description | |
1257 | will be inserted directly, whereas when you complete the literal | |
1258 | link, you will be prompted for a description (as with Org 7.8.) | |
1259 | ||
1260 | In the completion buffer, links to the current buffer are now | |
1261 | highlighted. | |
1262 | ||
1263 | **** New templates =%h= and =%(sexp)= for abbreviated links | |
1264 | ||
1265 | On top of =%s= template, which is replaced by the link tag in | |
1266 | abbreviated links, you can now use =%h= (which does the same than =%s= | |
1267 | but does not hexify the tag) and =%(sexp)= (which can run a function | |
1268 | that takes the tag as its own argument.) | |
1269 | ||
1270 | **** New link type =help= | |
1271 | ||
1272 | You can now create links from =help= buffers. | |
1273 | ||
1274 | For example, if you request help for the command [[doc::org-agenda][org-agenda]] with | |
1275 | =C-h f org-agenda RET=, creating a link from this buffer will let | |
1276 | you go back to the same buffer. | |
1277 | ||
1278 | **** New command [[doc::org-insert-all-links][org-insert-all-links]] | |
1279 | ||
1280 | This will insert all links as list items. With a universal | |
1281 | prefix argument, links will not be deleted from the variable | |
1282 | =org-stored-links=. | |
1283 | ||
1284 | This new command is bound to =C-c C-M-l=. | |
1285 | ||
1286 | **** New option [[doc::org-url-hexify-p][org-url-hexify-p]] | |
1287 | ||
1288 | When set to =nil=, the =URL= part of a link will not be hexified. | |
1289 | ||
1290 | **** Org can now open multiple shell links | |
1291 | ||
1292 | **** New option [[doc::org-doi-server-url][org-doi-server-url]] to specify an alternate DOI server | |
1293 | ||
1294 | **** RET now follows time stamps links | |
1295 | ||
1296 | *** Org Editing | |
1297 | ||
1298 | **** [[doc::org-todo][org-todo]] and =org-archive-*= can now loop in the active region | |
1299 | ||
1300 | When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, using | |
1301 | [[doc::org-todo][org-todo]] or =org-archive-*= commands in the active region will | |
1302 | loop over headlines. This is handy if you want to set the TODO | |
1303 | keyword for several items, or archive them quickly. | |
1304 | ||
1305 | **** You can now set tags for headlines in a region | |
1306 | ||
1307 | If [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, then | |
1308 | selecting the region and hitting =C-c C-q= will set the tags for | |
1309 | all headlines in the region. | |
1310 | ||
1311 | **** New command [[doc::org-insert-drawer][org-insert-drawer]] to insert a drawer interactively | |
1312 | ||
1313 | **** Comments start with "^[ \t]*# " anywhere on a line | |
1314 | ||
1315 | Note that the space after the hashtag is mandatory. Comments | |
1316 | with "^#+" are not supported anymore. | |
1317 | ||
1318 | **** New speed key =#= to toggle the COMMENT cookie on a headline | |
1319 | ||
1320 | **** =indent-region-function= is now set to [[doc::org-indent-region][org-indent-region]] | |
1321 | ||
1322 | =C-M-\= should now produce useful results. | |
1323 | ||
1324 | You can unindent the buffer with [[doc::org-unindent-buffer][org-unindent-buffer]]. | |
1325 | ||
1326 | **** New option [[doc::org-allow-promoting-top-level-subtree][org-allow-promoting-top-level-subtree]] | |
1327 | ||
1328 | When =non-nil=, =S-M-<left>= will promote level-1 subtrees | |
1329 | containing other subtrees. The level-1 headline will be | |
1330 | commented out. You can revert to the previous state with =M-x | |
1331 | undo RET=. | |
1332 | ||
1333 | *** Org Clock | |
1334 | ||
1335 | **** New keybinding =C-c C-x C-z= for [[doc::org-clock-resolve][org-clock-resolve]] | |
1336 | ||
1337 | **** New keybinding =C-c C-x C-q= for [[doc::org-clock-cancel][org-clock-cancel]] | |
1338 | ||
1339 | **** New command [[doc::org-clock-in-last][org-clock-in-last]] to clock in the last clocked item | |
1340 | ||
1341 | This command is bound to =C-c C-x C-x= and will clock in the last | |
1342 | clocked entry, if any. | |
1343 | ||
1344 | **** =C-u M-x= [[doc::org-clock-out][org-clock-out]] =RET= now prompts for a state to switch to | |
1345 | ||
1346 | **** =S-M-<up/down>= on a clock timestamps adjusts the previous/next clock | |
1347 | ||
1348 | **** New option [[doc::org-clock-continuously][org-clock-continuously]] | |
1349 | ||
1350 | When set to =nil=, clocking in a task will first try to find the | |
1351 | last clocked out task and restart from when that task was clocked | |
1352 | out. | |
1353 | ||
1354 | You can temporarily activate continuous clocking with =C-u C-u | |
1355 | C-u M-x= [[doc::org-clock-in][org-clock-in]] =RET= (three universal prefix arguments) | |
1356 | and =C-u C-u M-x= [[org-clock-in-last][org-clock-in-last]] =RET= (two universal prefix | |
1357 | arguments). | |
1358 | ||
1359 | ||
1360 | **** New option [[doc::org-clock-frame-title-format][org-clock-frame-title-format]] | |
1361 | ||
1362 | This option sets the value of =frame-title-format= when clocking | |
1363 | in. | |
1364 | ||
1365 | **** New options for controlling the clockreport display | |
1366 | ||
1367 | [[doc::org-clock-file-time-cell-format][org-clock-file-time-cell-format]]: Format string for the file time | |
1368 | cells in clockreport. | |
1369 | ||
1370 | [[doc::org-clock-total-time-cell-format][org-clock-total-time-cell-format]]: Format string for the total | |
1371 | time cells in clockreport. | |
1372 | ||
1373 | ||
1374 | **** New options for controlling the clock/timer display | |
1375 | ||
1376 | [[doc::org-clock-clocked-in-display][org-clock-clocked-in-display]]: control whether the current clock | |
1377 | is displayed in the mode line and/or frame title. | |
1378 | ||
1379 | [[doc::org-timer-display][org-timer-display]]: control whether the current timer is displayed | |
1380 | in the mode line and/or frame title. | |
1381 | ||
1382 | This allows the clock and timer to be displayed in the frame | |
1383 | title instead of, or as well as, the mode line. This is useful | |
1384 | for people with limited space in the mode line but with ample | |
1385 | space in the frame title. | |
1386 | ||
1387 | *** Org Appearance | |
1388 | ||
1389 | **** New option [[doc::org-custom-properties][org-custom-properties]] | |
1390 | ||
1391 | The visibility of properties listed in this options can be turn | |
1392 | on/off with [[doc::org-toggle-custom-properties-visibility][org-toggle-custom-properties-visibility]]. This might | |
1393 | be useful for properties used by third-part tools or that you | |
1394 | don't want to see temporarily. | |
1395 | ||
1396 | **** New command [[doc::org-redisplay-inline-images][org-redisplay-inline-images]] | |
1397 | ||
1398 | This will redisplay all images. It is bound to =C-c C-x C-M-v=. | |
1399 | ||
1400 | **** New entities in =org-entities.el= | |
1401 | ||
1402 | There are these new entities: | |
1403 | ||
1404 | : ("tilde" "\\~{}" nil "˜" "~" "~" "~") | |
1405 | : ("slash" "/" nil "/" "/" "/" "/") | |
1406 | : ("plus" "+" nil "+" "+" "+" "+") | |
1407 | : ("under" "\\_" nil "_" "_" "_" "_") | |
1408 | : ("equal" "=" nil "=" "=" "=" "=") | |
1409 | : ("asciicirc" "\\textasciicircum{}" nil "^" "^" "^" "^") | |
1410 | ||
1411 | **** New face =org-list-dt= for definition terms | |
1412 | **** New face =org-date-selected= for the selected calendar day | |
1413 | **** New face value for =org-document-title= | |
1414 | ||
1415 | The face is back to a normal height. | |
1416 | ||
1417 | *** Org Columns | |
1418 | ||
1419 | **** New speed command =:= to activate the column view | |
1420 | **** New special property =CLOCKSUM_T= to display today's clocked time | |
1421 | ||
1422 | You can use =CLOCKSUM_T= the same way you use =CLOCKSUM=. It | |
1423 | will display the time spent on tasks for today only. | |
1424 | ||
1425 | **** Use the =:COLUMNS:= property in columnview dynamic blocks | |
1426 | ||
1427 | If the =:COLUMNS:= is set in a subtree, the columnview dynamic | |
1428 | block will use its value as the column format. | |
1429 | ||
1430 | **** Consider inline tasks when computing a sum | |
1431 | ||
1432 | *** Org Dates and Time Stamps | |
1433 | ||
1434 | **** Enhanced [[doc::org-sparse-tree][org-sparse-tree]] | |
1435 | ||
1436 | =C-c /= can now check for time ranges. | |
1437 | ||
1438 | When checking for dates with =C-c /= it is useful to change the | |
1439 | type of dates that you are interested in. You can now do this | |
1440 | interactively with =c= after =C-c /= and/or by setting | |
1441 | [[doc::org-sparse-tree-default-date-type][org-sparse-tree-default-date-type]] to the default value you want. | |
1442 | ||
1443 | **** Support for hourly repeat cookies | |
1444 | ||
1445 | You can now use | |
1446 | ||
1447 | : SCHEDULED: <2012-08-20 lun. 08:00 +1h> | |
1448 | ||
1449 | if you want to add an hourly repeater to an entry. | |
1450 | ||
1451 | **** =C-u C-u C-c .= inserts a time-stamp with no prompt | |
1452 | ||
1453 | **** When (setq [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] 'time), accept days in the prompt | |
1454 | ||
1455 | "8am Wed" and "Wed 8am" are now acceptable values when entering a | |
1456 | date from the prompt. If [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] is set to | |
1457 | =time=, this will produce the expected prompt indication. | |
1458 | ||
1459 | **** New option [[doc::org-datetree-add-timestamp][org-datetree-add-timestamp]] | |
1460 | ||
1461 | When set to =non-nil=, datetree entries will also have a | |
1462 | timestamp. This is useful if you want to see these entries in a | |
1463 | sparse tree with =C-c /=. | |
1464 | ||
1465 | *** Org Capture | |
1466 | ||
1467 | **** New command [[doc::org-capture-string][org-capture-string]] | |
1468 | ||
1469 | M-x [[doc::org-capture-string][org-capture-string]] RET will prompt for a string and a capture | |
1470 | template. The string will be used as an annotation for the | |
1471 | template. This is useful when capturing in batch mode as it lets | |
1472 | you define the content of the template without being in Emacs. | |
1473 | ||
1474 | **** New option [[doc::org-capture-templates-contexts][org-capture-templates-contexts]] | |
1475 | ||
1476 | Setting this option allows you to define specific context where | |
1477 | capture templates should be available from. For example, when | |
1478 | set to this value | |
1479 | ||
1480 | #+BEGIN_SRC emacs-lisp | |
1481 | (setq org-capture-templates-contexts | |
1482 | '(("c" (in-mode . "message-mode")))) | |
1483 | #+END_SRC | |
1484 | ||
1485 | then the =c= capture template will only be available from | |
1486 | =message-mode= buffers. See the docstring and the manual for | |
1487 | more details on how to use this. | |
1488 | ||
1489 | **** New =%l= template to insert the literal link | |
1490 | **** New option [[doc::org-capture-bookmark][org-capture-bookmark]] | |
1491 | ||
1492 | Org used to automatically add a bookmark with capture a note. | |
1493 | You can now turn this on by setting [[doc::org-capture-bookmark][org-capture-bookmark]] to | |
1494 | =nil=. | |
1495 | ||
1496 | **** Expand =%<num>= escape sequences into text entered for <num>'th =%^{PROMPT}= escape | |
1497 | ||
1498 | See the manual for more explanations. | |
1499 | ||
1500 | **** More control over empty lines | |
1501 | ||
1502 | You can use =:empty-lines-before= and =:empty-lines-after= to | |
1503 | control the insertion of empty lines. Check the manual for more | |
1504 | explanations. | |
1505 | ||
1506 | **** New hook [[doc::org-capture-prepare-finalize-hook][org-capture-prepare-finalize-hook]] | |
1507 | ||
1508 | This new hook runs before the finalization process starts. | |
1509 | ||
1510 | *** Org Export | |
1511 | ||
1512 | **** New functions =orgtbl-to-table.el= and =orgtbl-to-unicode= | |
1513 | ||
1514 | =orgtbl-to-table.el= convert the table to a =table.el= table, and | |
1515 | =orgtbl-to-unicode= will use =ascii-art-to-unicode.el= (when | |
1516 | available) to print beautiful tables. | |
1517 | ||
1518 | **** [[doc::org-table-export][org-table-export]] now a bit clever about the target format | |
1519 | ||
1520 | When you specify a file name like =table.csv=, [[doc::org-table-export][org-table-export]] | |
1521 | will now suggest =orgtbl-to-csv= the default method for exporting | |
1522 | the table. | |
1523 | ||
1524 | **** New option [[doc::org-export-date-timestamp-format][org-export-date-timestamp-format]] | |
1525 | ||
1526 | The option allows to set a time string format for Org timestamps | |
1527 | in the #+DATE option. | |
1528 | ||
1529 | **** LaTeX: New options for exporting table rules :tstart, :hline and :tend | |
1530 | ||
1531 | See [[doc::org-export-latex-tables-hline][org-export-latex-tables-hline]] and [[doc::org-export-latex-tables-tend][org-export-latex-tables-tend]]. | |
1532 | ||
1533 | **** LaTeX: You can now set =:hfmt= from =#+ATTR_LaTeX= | |
1534 | **** Beamer: Add support and keybinding for the =exampleblock= environment | |
1535 | ||
1536 | Add support for these languages in [[doc::org-export-language-setup][org-export-language-setup]]. | |
1537 | More languages are always welcome. | |
1538 | ||
1539 | **** Beamer: New option [[doc::org-beamer-inherited-properties][org-beamer-inherited-properties]] | |
1540 | ||
1541 | This option allows Beamer export to inherit some properties. | |
1542 | Thanks to Carsten for implementing this. | |
1543 | ||
1544 | **** ODT: Add support for ODT export in org-bbdb.el | |
1545 | **** ODT: Add support for indented tables (see [[http://orgmode.org/w/?p%3Dorg-mode.git%3Ba%3Dcommit%3Bh%3De9fd33][this commit]] for details) | |
1546 | **** ODT: Improve the conversion from ODT to other formats | |
1547 | **** ASCII: Swap the level-1/level-2 characters to underline the headlines | |
1548 | **** Support for Chinese, simplified Chinese, Russian, Ukrainian and Japanese | |
1549 | **** HTML: New option [[doc::org-export-html-date-format-string][org-export-html-date-format-string]] | |
1550 | ||
1551 | Format string to format the date and time in HTML export. Thanks | |
1552 | to Sรฉbastien Vauban for this patch. | |
1553 | ||
1554 | *** Org Babel | |
1555 | ||
1556 | **** New =:results drawer= parameter | |
1557 | ||
1558 | =:results drawer= replaces =:results wrap=, which is deprecated but still | |
1559 | supported. | |
1560 | ||
1561 | **** =:results org= now put results in a =#+BEGIN_SRC org= block | |
1562 | ||
1563 | =:results org= used to put results in a =#+BEGIN_ORG= block but it now puts | |
735135f9 | 1564 | results in a =#+BEGIN_SRC org= block, with comma-escaped lines. |
8223b1d2 BG |
1565 | |
1566 | =#+BEGIN_ORG= blocks are obsolete. | |
1567 | ||
1568 | **** Exporting =#+BEGIN_SRC org= blocks exports the code | |
1569 | ||
1570 | It used to exports the results of the code. | |
1571 | ||
1572 | *** Miscellaneous | |
1573 | ||
1574 | **** New menu entry for [[doc::org-refile][org-refile]] | |
1575 | **** Allow capturing to encrypted entries | |
1576 | ||
735135f9 | 1577 | If you capture to an encrypted entry, it will be decrypted before |
8223b1d2 BG |
1578 | inserting the template then re-encrypted after finalizing the capture. |
1579 | ||
1580 | **** Inactive timestamps are now handled in tables | |
1581 | ||
1582 | Calc can do computation on active time-stamps like <2012-09-29 sat.>. | |
1583 | Inactive time-stamps in a table's cell are now internally deactivated so | |
1584 | that Calc formulas can operate on them. | |
1585 | ||
1586 | **** [[doc::org-table-number-regexp][org-table-number-regexp]] can now accept comma as decimal mark | |
1587 | **** Org allows a new property =APPT_WARNTIME= | |
1588 | ||
1589 | You can set it with the =W= speedy key or set it manually. When | |
1590 | set, exporting to iCalendar and [[doc::org-agenda-to-appt][org-agenda-to-appt]] will use the | |
1591 | value of this property as the number of minutes for the warning | |
1592 | alarm. | |
1593 | ||
1594 | **** New command [[doc::org-inc-effort][org-inc-effort]] | |
1595 | ||
1596 | This will increment the effort value. | |
1597 | ||
1598 | It is bound to =C-c C-x E= and to =E= as a speedy command. | |
1599 | ||
1600 | **** Attach: Add support for creating symbolic links | |
1601 | ||
1602 | =org-attach-method= now supports a new method =lns=, allowing to | |
1603 | attach symbolic links. | |
1604 | ||
1605 | **** Archive: you can now archive to a datetree | |
1606 | ||
1607 | **** New option [[doc::org-inlinetask-show-first-star][org-inlinetask-show-first-star]] | |
1608 | ||
1609 | =Non-nil= means display the first star of an inline task as | |
1610 | additional marker. When =nil=, the first star is not shown. | |
1611 | ||
1612 | **** New option [[doc::org-latex-preview-ltxpng-directory][org-latex-preview-ltxpng-directory]] | |
1613 | ||
1614 | This lets you define the path for the =ltxpng/= directory. | |
1615 | ||
1616 | **** You can now use imagemagick instead of dvipng to preview LaTeX fragments | |
1617 | **** You can now turn off [[doc::orgstruct++-mode][orgstruct++-mode]] safely | |
1618 | **** =C-u C-c C-c= on list items to add check boxes | |
1619 | ||
1620 | =C-u C-c C-c= will add an empty check box on a list item. | |
1621 | ||
1622 | When hit from the top of the list, it will add check boxes for | |
1623 | all top level list items. | |
1624 | ||
1625 | **** =org-list-ending-method= and =org-list-end-regexp= are now obsolete | |
1626 | ||
1627 | Fall back on using =org-list-end-re= only, which see. | |
1628 | ||
1629 | **** org-feed.el now expands =%(sexp)= templates | |
1630 | **** New option [[doc::org-protocol-data-separator][org-protocol-data-separator]] | |
1631 | ||
1632 | **** New option [[doc::org-ditaa-jar-option][org-ditaa-jar-option]] to specify the ditaa jar file | |
1633 | ||
1634 | **** New possible value for [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] | |
1635 | ||
1636 | When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is set to | |
1637 | =start-level=, the command will loop over the active region but | |
1638 | will only act upon entries that are of the same level than the | |
1639 | first headline in the region. | |
1640 | ||
1641 | **** New option [[doc::org-habit-show-all-today][org-habit-show-all-today]] | |
1642 | ||
1643 | When set to =t=, show all (even unscheduled) habits on today's | |
1644 | agenda. | |
1645 | ||
1646 | ** Important bug fixes | |
1647 | ||
1648 | *** M-TAB on options keywords perform completion correctly again | |
1649 | ||
1650 | If you hit =M-TAB= on keywords like =#+TITLE=, Org will try to | |
1651 | perform completion with meaningful values. | |
1652 | ||
1653 | *** Add licenses to javascript embedded and external code snippets | |
1654 | ||
1655 | Embedded javascript code produced when exporting an Org file to | |
1656 | HTML is now licensed under GPLv3 (or later), and the copyright is | |
1657 | owned by the Free Software Foundation, Inc. | |
1658 | ||
1659 | The javascript code for embedding MathJax in the browser mentions | |
1660 | the MathJax copyright and the Apache 2.0 license. | |
1661 | ||
1662 | The javascript code for embedding =org-injo.js= in the browser | |
1663 | mentions the copyright of Sebastian Rose and the GPLv3 (or later) | |
1664 | license. | |
1665 | ||
1666 | =org-export-html-scripts= is now a variable, so that you can adapt | |
1667 | the code and the license to your needs. | |
1668 | ||
1669 | See http://www.gnu.org/philosophy/javascript-trap.html for | |
1670 | explanations on why these changes were necessary. | |
1671 | ||
1672 | * Version 7.8.11 | |
1673 | ||
1674 | ** Incompatible changes | |
1675 | ||
1676 | *** Emacs 21 support has been dropped | |
1677 | ||
1678 | Do not use Org mode 7.xx with Emacs 21, use [[http://orgmode.org/org-6.36c.zip][version 6.36c]] instead. | |
1679 | ||
1680 | *** XEmacs support requires the XEmacs development version | |
1681 | ||
1682 | To use Org mode 7.xx with XEmacs, you need to run the developer | |
1683 | version of XEmacs. We were about to drop XEmacs support entirely, | |
1684 | but Michael Sperber stepped in and made changes to XEmacs that | |
1685 | made it easier to keep the support. Thanks to Michael for this | |
1686 | last-minute save. | |
1687 | ||
1688 | *** New keys for TODO sparse trees | |
1689 | ||
1690 | The key =C-c C-v= is now reserved for Org Babel action. TODO | |
1691 | sparse trees can still be made with =C-c / t= (all not-done | |
1692 | states) and =C-c / T= (specific states). | |
1693 | ||
1694 | *** The Agenda =org-agenda-ndays= is now obsolete | |
1695 | ||
1696 | The variable =org-agenda-ndays= is obsolete - please use | |
1697 | =org-agenda-span= instead. | |
1698 | ||
1699 | Thanks to Julien Danjou for this. | |
1700 | ||
1701 | *** Changes to the intended use of =org-export-latex-classes= | |
1702 | ||
1703 | So far this variable has been used to specify the complete header | |
1704 | of the LaTeX document, including all the =\usepackage= calls | |
1705 | necessary for the document. This setup makes it difficult to | |
1706 | maintain the list of packages that Org itself would like to call, | |
1707 | for example for the special symbol support it needs. | |
1708 | ||
1709 | First of all, you can *opt out of this change* in the following | |
1710 | way: You can say: /I want to have full control over headers, and I | |
1711 | will take responsibility to include the packages Org needs/. If | |
1712 | that is what you want, add this to your configuration and skip the | |
1713 | rest of this section (except maybe for the description of the | |
1714 | =[EXTRA]= place holder): | |
1715 | ||
1716 | #+begin_src emacs-lisp | |
1717 | (setq org-export-latex-default-packages-alist nil | |
1718 | org-export-latex-packages-alist nil) | |
1719 | #+end_src | |
1720 | ||
1721 | /Continue to read here if you want to go along with the modified | |
1722 | setup./ | |
1723 | ||
1724 | There are now two variables that should be used to list the LaTeX | |
1725 | packages that need to be included in all classes. The header | |
1726 | definition in =org-export-latex-classes= should then not contain | |
1727 | the corresponding =\usepackage= calls (see below). | |
1728 | ||
1729 | The two new variables are: | |
1730 | ||
1731 | 1. =org-export-latex-default-packages-alist= :: This is the | |
1732 | variable where Org-mode itself puts the packages it needs. | |
1733 | Normally you should not change this variable. The only | |
1734 | reason to change it anyway is when one of these packages | |
1735 | causes a conflict with another package you want to use. Then | |
1736 | you can remove that packages and hope that you are not using | |
1737 | Org-mode functionality that needs it. | |
1738 | ||
1739 | 2. =org-export-latex-packages-alist= :: This is the variable where | |
1740 | you can put the packages that you'd like to use across all | |
1741 | classes. | |
1742 | ||
1743 | The sequence how these customizations will show up in the LaTeX | |
1744 | document are: | |
1745 | ||
1746 | 1. Header from =org-export-latex-classes= | |
1747 | 2. =org-export-latex-default-packages-alist= | |
1748 | 3. =org-export-latex-packages-alist= | |
1749 | 4. Buffer-specific things set with =#+LaTeX_HEADER:= | |
1750 | ||
1751 | If you want more control about which segment is placed where, or | |
1752 | if you want, for a specific class, have full control over the | |
1753 | header and exclude some of the automatic building blocks, you can | |
1754 | put the following macro-like place holders into the header: | |
1755 | ||
1756 | #+begin_example | |
1757 | [DEFAULT-PACKAGES] \usepackage statements for default packages | |
1758 | [NO-DEFAULT-PACKAGES] do not include any of the default packages | |
1759 | [PACKAGES] \usepackage statements for packages | |
1760 | [NO-PACKAGES] do not include the packages | |
1761 | [EXTRA] the stuff from #+LaTeX_HEADER | |
1762 | [NO-EXTRA] do not include #+LaTeX_HEADER stuff | |
1763 | #+end_example | |
1764 | ||
1765 | If you have currently customized =org-export-latex-classes=, you | |
1766 | should revise that customization and remove any package calls that | |
1767 | are covered by =org-export-latex-default-packages-alist=. This | |
1768 | applies to the following packages: | |
1769 | ||
1770 | - inputenc | |
1771 | - fontenc | |
1772 | - fixltx2e | |
1773 | - graphicx | |
1774 | - longtable | |
1775 | - float | |
1776 | - wrapfig | |
1777 | - soul | |
1778 | - t1enc | |
1779 | - textcomp | |
1780 | - marvosym | |
1781 | - wasysym | |
1782 | - latexsym | |
1783 | - amssymb | |
1784 | - hyperref | |
1785 | ||
1786 | If one of these packages creates a conflict with another package | |
1787 | you are using, you can remove it from | |
1788 | =org-export-latex-default-packages-alist=. But then you risk that | |
1789 | some of the advertised export features of Org will not work | |
1790 | properly. | |
1791 | ||
1792 | You can also consider moving packages that you use in all classes | |
1793 | to =org-export-latex-packages-alist=. If necessary, put the place | |
1794 | holders so that the packages get loaded in the right sequence. As | |
1795 | said above, for backward compatibility, if you omit the place | |
1796 | holders, all the variables will dump their content at the end of | |
1797 | the header. | |
1798 | ||
1799 | *** The constant =org-html-entities= is obsolete | |
1800 | ||
1801 | Its content is now part of the new constant =org-entities=, which | |
1802 | is defined in the file org-entities.el. =org-html-entities= was | |
1803 | an internal variable, but it is possible that some users did write | |
1804 | code using it. | |
1805 | ||
1806 | *** =org-bbdb-anniversary-format-alist= has changed | |
1807 | ||
1808 | Please check the docstring and update your settings accordingly. | |
1809 | ||
1810 | *** Deleted =org-mode-p= | |
1811 | ||
1812 | This function has been deleted: please update your code. | |
1813 | ||
1814 | ** Important new features | |
1815 | ||
1816 | *** New Org to ODT exporter | |
1817 | ||
1818 | Jambunathan's Org to ODT exporter is now part of Org. | |
1819 | ||
1820 | To use it, it `C-c C-e o' in an Org file. See the documentation | |
1821 | for more information on how to customize it. | |
1822 | ||
1823 | *** org-capture.el is now the default capture system | |
1824 | ||
1825 | This replaces the earlier system org-remember. The manual only | |
1826 | describes org-capture, but for people who prefer to continue to | |
1827 | use org-remember, we keep a static copy of the former manual | |
1828 | section [[http://orgmode.org/org-remember.pdf][chapter about remember]]. | |
1829 | ||
1830 | The new system has a technically cleaner implementation and more | |
1831 | possibilities for capturing different types of data. See | |
1832 | [[http://thread.gmane.org/gmane.emacs.orgmode/26441/focus%3D26441][Carsten's announcement]] for more details. | |
1833 | ||
1834 | To switch over to the new system: | |
1835 | ||
1836 | 1. Run | |
1837 | ||
1838 | : M-x org-capture-import-remember-templates RET | |
1839 | ||
1840 | to get a translated version of your remember templates into the | |
1841 | new variable =org-capture-templates=. This will "mostly" work, | |
1842 | but maybe not for all cases. At least it will give you a good | |
1843 | place to modify your templates. After running this command, | |
1844 | enter the customize buffer for this variable with | |
1845 | ||
1846 | : M-x customize-variable RET org-capture-templates RET | |
1847 | ||
1848 | and convince yourself that everything is OK. Then save the | |
1849 | customization. | |
1850 | ||
1851 | 2. Bind the command =org-capture= to a key, similar to what you did | |
1852 | with org-remember: | |
1853 | ||
1854 | : (define-key global-map "\C-cc" 'org-capture) | |
1855 | ||
1856 | If your fingers prefer =C-c r=, you can also use this key once | |
1857 | you have decided to move over completely to the new | |
1858 | implementation. During a test time, there is nothing wrong | |
1859 | with using both system in parallel. | |
1860 | ||
1861 | ** New libraries | |
1862 | ||
1863 | *** New Org libraries | |
1864 | **** org-eshell.el (Konrad Hinsen) | |
1865 | ||
1866 | Implement links to eshell buffers. | |
1867 | ||
1868 | **** org-special-blocks (Carsten Dominik) | |
1869 | ||
1870 | This package generalizes the #+begin_foo and #+end_foo tokens. | |
1871 | ||
1872 | To use, put the following in your init file: | |
1873 | ||
1874 | #+BEGIN_EXAMPLE | |
2a12997c BG |
1875 | (require 'org-special-blocks) |
1876 | #+END_EXAMPLE | |
1877 | ||
8223b1d2 BG |
1878 | The tokens #+begin_center, #+begin_verse, etc. existed |
1879 | previously. This package generalizes them (at least for the | |
1880 | LaTeX and html exporters). When a #+begin_foo token is | |
1881 | encountered by the LaTeX exporter, it is expanded | |
1882 | into \begin{foo}. The text inside the environment is not | |
1883 | protected, as text inside environments generally is. | |
1884 | When #+begin_foo is encountered by the html exporter, a div with | |
1885 | class foo is inserted into the HTML file. It is up to the user | |
1886 | to add this class to his or her stylesheet if this div is to mean | |
1887 | anything. | |
2a12997c | 1888 | |
8223b1d2 | 1889 | **** org-taskjuggler.el (Christian Egli) |
2a12997c | 1890 | |
8223b1d2 BG |
1891 | Christian Egli's /org-taskjuggler.el/ module is now part of Org. |
1892 | He also wrote a [[http://orgmode.org/worg/org-tutorials/org-taskjuggler.php][tutorial]] for it. | |
2a12997c | 1893 | |
8223b1d2 | 1894 | **** org-ctags.el (Paul Sexton) |
2a12997c | 1895 | |
8223b1d2 BG |
1896 | Targets like =<<my target>>= can now be found by Emacs' etag |
1897 | functionality, and Org-mode links can be used to to link to | |
1898 | etags, also in non-Org-mode files. For details, see the file | |
1899 | /org-ctags.el/. | |
2a12997c | 1900 | |
8223b1d2 BG |
1901 | This feature uses a new hook =org-open-link-functions= which will |
1902 | call function to do something special with text links. | |
2a12997c | 1903 | |
8223b1d2 | 1904 | Thanks to Paul Sexton for this contribution. |
2a12997c | 1905 | |
8223b1d2 | 1906 | **** org-docview.el (Jan Bรถcker) |
2a12997c | 1907 | |
8223b1d2 BG |
1908 | This new module allows links to various file types using docview, where |
1909 | Emacs displays images of document pages. Docview link types can point | |
1910 | to a specific page in a document, for example to page 131 of the | |
1911 | Org-mode manual: | |
2a12997c | 1912 | |
8223b1d2 | 1913 | : [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]] |
2a12997c | 1914 | |
8223b1d2 | 1915 | Thanks to Jan Bรถcker for this contribution. |
2a12997c | 1916 | |
8223b1d2 | 1917 | *** New Babel libraries |
2a12997c BG |
1918 | |
1919 | - ob-picolisp.el (Thorsten Jolitz) | |
1920 | - ob-fortran.el (Sergey Litvinov) | |
1921 | - ob-shen.el (Eric Schulte) | |
1922 | - ob-maxima.el (Eric S Fraga) | |
1923 | - ob-java.el (Eric Schulte) | |
1924 | - ob-lilypond.el (Martyn Jago) | |
1925 | - ob-awk.el (Eric Schulte) | |
1926 | ||
8223b1d2 | 1927 | ** Other new features and various enhancements |
2a12997c | 1928 | |
8223b1d2 | 1929 | *** Hyperlinks |
2a12997c | 1930 | |
8223b1d2 | 1931 | **** Org-Bibtex -- major improvements |
2a12997c | 1932 | |
8223b1d2 BG |
1933 | Provides support for managing bibtex bibliographical references |
1934 | data in headline properties. Each headline corresponds to a | |
1935 | single reference and the relevant bibliographic meta-data is | |
1936 | stored in headline properties, leaving the body of the headline | |
1937 | free to hold notes and comments. Org-bibtex is aware of all | |
1938 | standard bibtex reference types and fields. | |
2a12997c | 1939 | |
8223b1d2 | 1940 | The key new functions are |
2a12997c | 1941 | |
8223b1d2 BG |
1942 | - org-bibtex-check :: queries the user to flesh out all required |
1943 | (and with prefix argument optional) bibtex fields available | |
1944 | for the specific reference =type= of the current headline. | |
2a12997c | 1945 | |
8223b1d2 BG |
1946 | - org-bibtex-create :: Create a new entry at the given level, |
1947 | using org-bibtex-check to flesh out the relevant fields. | |
2a12997c | 1948 | |
8223b1d2 BG |
1949 | - org-bibtex-yank :: Yank a bibtex entry on the kill ring as a |
1950 | formatted Org-mode headline into the current buffer | |
2a12997c | 1951 | |
8223b1d2 BG |
1952 | - org-bibtex-export-to-kill-ring :: Export the current headline |
1953 | to the kill ring as a formatted bibtex entry. | |
2a12997c | 1954 | |
8223b1d2 | 1955 | **** org-gnus.el now allows link creation from messages |
2a12997c | 1956 | |
735135f9 | 1957 | You can now create links from messages. This is particularly |
8223b1d2 BG |
1958 | useful when the user wants to stored messages that he sends, for |
1959 | later check. Thanks to Ulf Stegemann for the patch. | |
2a12997c | 1960 | |
8223b1d2 | 1961 | **** Modified link escaping |
2a12997c | 1962 | |
8223b1d2 | 1963 | David Maus worked on `org-link-escape'. See [[http://article.gmane.org/gmane.emacs.orgmode/37888][his message]]: |
2a12997c | 1964 | |
8223b1d2 BG |
1965 | : Percent escaping is used in Org mode to escape certain characters |
1966 | : in links that would either break the parser (e.g. square brackets | |
1967 | : in link target oder description) or are not allowed to appear in | |
1968 | : a particular link type (e.g. non-ascii characters in a http: | |
1969 | : link). | |
1970 | : | |
1971 | : With this change in place Org will apply percent escaping and | |
1972 | : unescaping more consistently especially for non-ascii characters. | |
1973 | : Additionally some of the outstanding bugs or glitches concerning | |
1974 | : percent escaped links are solved. | |
2a12997c | 1975 | |
8223b1d2 | 1976 | Thanks a lot to David for this work. |
2a12997c | 1977 | |
8223b1d2 | 1978 | **** Make =org-store-link= point to directory in a dired buffer |
2a12997c | 1979 | |
8223b1d2 BG |
1980 | When, in a dired buffer, the cursor is not in a line listing a |
1981 | file, `org-store-link' will store a link to the directory. | |
2a12997c | 1982 | |
8223b1d2 | 1983 | Patch by Stephen Eglen. |
2a12997c | 1984 | |
8223b1d2 | 1985 | **** Allow regexps in =org-file-apps= to capture link parameters |
2a12997c | 1986 | |
8223b1d2 BG |
1987 | The way extension regexps in =org-file-apps= are handled has |
1988 | changed. Instead of matching against the file name, the regexps | |
1989 | are now matched against the whole link, and you can use grouping | |
1990 | to extract link parameters which you can then use in a command | |
1991 | string to be executed. | |
2a12997c | 1992 | |
8223b1d2 BG |
1993 | For example, to allow linking to PDF files using the syntax |
1994 | =file:/doc.pdf::<page number>=, you can add the following entry | |
1995 | to org-file-apps: | |
2a12997c | 1996 | |
8223b1d2 BG |
1997 | #+begin_example |
1998 | Extension: \.pdf::\([0-9]+\)\' | |
1999 | Command: evince "%s" -p %1 | |
2000 | #+end_example | |
2a12997c | 2001 | |
8223b1d2 | 2002 | Thanks to Jan Bรถcker for a patch to this effect. |
2a12997c | 2003 | |
8223b1d2 | 2004 | *** Dates and time |
2a12997c | 2005 | |
8223b1d2 | 2006 | **** Allow relative time when scheduling/adding a deadline |
2a12997c | 2007 | |
8223b1d2 BG |
2008 | You can now use relative duration strings like "-2d" or "++3w" |
2009 | when calling =org-schedule= or =org-deadline=: it will schedule | |
2010 | (or set the deadline for) the item respectively two days before | |
2011 | today and three weeks after the current timestamp, if any. | |
2a12997c | 2012 | |
8223b1d2 BG |
2013 | You can use this programmatically: =(org-schedule nil "+2d")= |
2014 | will work on the current entry. | |
2a12997c | 2015 | |
8223b1d2 BG |
2016 | You can also use this while (bulk-)rescheduling and |
2017 | (bulk-)resetting the deadline of (several) items from the agenda. | |
2a12997c | 2018 | |
8223b1d2 | 2019 | Thanks to Memnon Anon for a heads up about this! |
2a12997c | 2020 | |
8223b1d2 | 2021 | **** American-style dates are now understood by =org-read-date= |
2a12997c | 2022 | |
8223b1d2 | 2023 | So when you are prompted for a date, you can now answer like this |
2a12997c | 2024 | |
8223b1d2 BG |
2025 | #+begin_example |
2026 | 2/5/3 --> 2003-02-05 | |
2027 | 2/5 --> <CURRENT-YEAR>-02-05 | |
2028 | #+end_example | |
2a12997c | 2029 | |
8223b1d2 | 2030 | *** Agenda |
2a12997c | 2031 | |
8223b1d2 | 2032 | **** =org-agenda-custom-commands= has a default value |
2a12997c | 2033 | |
8223b1d2 BG |
2034 | This option used to be `nil' by default. This now has a default |
2035 | value, displaying an agenda and all TODOs. See the docstring for | |
2036 | details. Thanks to Carsten for this. | |
2a12997c | 2037 | |
8223b1d2 | 2038 | **** Improved filtering through =org-agenda-to-appt= |
2a12997c | 2039 | |
8223b1d2 BG |
2040 | The new function allows the user to refine the scope of entries |
2041 | to pass to =org-agenda-get-day-entries= and allows to filter out | |
2042 | entries using a function. | |
2a12997c | 2043 | |
8223b1d2 BG |
2044 | Thanks to Peter Mรผnster for raising a related issue and to |
2045 | Tassilo Horn for this idea. Also thanks to Peter Mรผnster for | |
2046 | [[git:68ffb7a7][fixing a small bug]] in the final implementation. | |
2a12997c | 2047 | |
8223b1d2 | 2048 | **** Allow ap/pm times in agenda time grid |
2a12997c | 2049 | |
8223b1d2 BG |
2050 | Times in the agenda can now be displayed in am/pm format. See |
2051 | the new variable =org-agenda-timegrid-use-ampm=. Thanks to | |
2052 | C. A. Webber for a patch to this effect. | |
2a12997c | 2053 | |
8223b1d2 | 2054 | **** Agenda: Added a bulk "scattering" command |
2a12997c | 2055 | |
8223b1d2 BG |
2056 | =B S= in the agenda buffer will cause tasks to be rescheduled a |
2057 | random number of days into the future, with 7 as the default. | |
2058 | This is useful if you've got a ton of tasks scheduled for today, | |
2059 | you realize you'll never deal with them all, and you just want | |
2060 | them to be distributed across the next N days. When called with | |
2061 | a prefix arg, rescheduling will avoid weekend days. | |
2a12997c | 2062 | |
8223b1d2 | 2063 | Thanks to John Wiegley for this. |
2a12997c | 2064 | |
8223b1d2 | 2065 | *** Exporting |
2a12997c | 2066 | |
8223b1d2 | 2067 | **** Simplification of org-export-html-preamble/postamble |
2a12997c | 2068 | |
8223b1d2 BG |
2069 | When set to `t', export the preamble/postamble as usual, honoring |
2070 | the =org-export-email/author/creator-info= variables. | |
2a12997c | 2071 | |
8223b1d2 BG |
2072 | When set to a formatting string, insert this string. See the |
2073 | docstring of these variable for details about available | |
2074 | %-sequences. | |
2a12997c | 2075 | |
8223b1d2 BG |
2076 | You can set =:html-preamble= in publishing project in the same |
2077 | way: `t' means to honor =:email/creator/author-info=, and a | |
2078 | formatting string will insert a string. | |
2a12997c | 2079 | |
8223b1d2 | 2080 | **** New exporters to Latin-1 and UTF-8 |
2a12997c | 2081 | |
8223b1d2 BG |
2082 | While Ulf Stegemann was going through the entities list to |
2083 | improve the LaTeX export, he had the great idea to provide | |
2084 | representations for many of the entities in Latin-1, and for all | |
2085 | of them in UTF-8. This means that we can now export files rich | |
2086 | in special symbols to Latin-1 and to UTF-8 files. These new | |
2087 | exporters can be reached with the commands =C-c C-e n= and =C-c | |
2088 | C-e u=, respectively. | |
2a12997c | 2089 | |
8223b1d2 BG |
2090 | When there is no representation for a given symbol in the |
2091 | targeted coding system, you can choose to keep the TeX-macro-like | |
2092 | representation, or to get an "explanatory" representation. For | |
2093 | example, =\simeq= could be represented as "[approx. equal to]". | |
2094 | Please use the variable =org-entities-ascii-explanatory= to state | |
2095 | your preference. | |
2a12997c | 2096 | |
8223b1d2 | 2097 | **** HTML export: Add class to outline containers using property |
2a12997c | 2098 | |
8223b1d2 BG |
2099 | The =HTML_CONTAINER_CLASS= property can now be used to add a |
2100 | class name to the outline container of a node in HTML export. | |
2a12997c | 2101 | |
8223b1d2 | 2102 | **** Throw an error when creating an image from a LaTeX snippet fails |
2a12997c | 2103 | |
8223b1d2 BG |
2104 | This behavior can be configured with the new option variable |
2105 | =org-format-latex-signal-error=. | |
2a12997c | 2106 | |
8223b1d2 | 2107 | **** Support for creating BEAMER presentations from Org-mode documents |
2a12997c | 2108 | |
8223b1d2 BG |
2109 | Org-mode documents or subtrees can now be converted directly in |
2110 | to BEAMER presentation. Turning a tree into a simple | |
2111 | presentations is straight forward, and there is also quite some | |
2112 | support to make richer presentations as well. See the [[http://orgmode.org/manual/Beamer-class-export.html#Beamer-class-export][BEAMER | |
2113 | section]] in the manual for more details. | |
2a12997c | 2114 | |
8223b1d2 BG |
2115 | Thanks to everyone who has contributed to the discussion about |
2116 | BEAMER support and how it should work. This was a great example | |
2117 | for how this community can achieve a much better result than any | |
2118 | individual could. | |
2a12997c | 2119 | |
8223b1d2 | 2120 | *** Refiling |
2a12997c | 2121 | |
8223b1d2 | 2122 | **** Refile targets can now be cached |
2a12997c | 2123 | |
8223b1d2 BG |
2124 | You can turn on caching of refile targets by setting the variable |
2125 | =org-refile-use-cache=. This should speed up refiling if you | |
2126 | have many eligible targets in many files. If you need to update | |
2127 | the cache because Org misses a newly created entry or still | |
2128 | offers a deleted one, press =C-0 C-c C-w=. | |
2a12997c | 2129 | |
8223b1d2 | 2130 | **** New logging support for refiling |
2a12997c | 2131 | |
8223b1d2 BG |
2132 | Whenever you refile an item, a time stamp and even a note can be |
2133 | added to this entry. For details, see the new option | |
2134 | =org-log-refile=. | |
2a12997c | 2135 | |
8223b1d2 | 2136 | Thanks to Charles Cave for this idea. |
2a12997c | 2137 | |
8223b1d2 | 2138 | *** Completion |
2a12997c | 2139 | |
735135f9 | 2140 | **** In-buffer completion is now done using John Wiegley's pcomplete.el |
2a12997c | 2141 | |
8223b1d2 | 2142 | Thanks to John Wiegley for much of this code. |
2a12997c | 2143 | |
8223b1d2 | 2144 | *** Tables |
2a12997c | 2145 | |
8223b1d2 | 2146 | **** New command =org-table-transpose-table-at-point= |
2a12997c | 2147 | |
8223b1d2 BG |
2148 | See the docstring. This hack from Juan Pechiar is now part of |
2149 | Org's core. Thanks to Juan! | |
2a12997c | 2150 | |
8223b1d2 | 2151 | **** Display field's coordinates when editing it with =C-c `= |
2a12997c | 2152 | |
8223b1d2 BG |
2153 | When editing a field with =C-c `=, the field's coordinate will |
2154 | the displayed in the buffer. | |
2a12997c | 2155 | |
8223b1d2 | 2156 | Thanks to Michael Brand for a patch to this effect. |
2a12997c | 2157 | |
8223b1d2 | 2158 | **** Spreadsheet computation of durations and time values |
2a12997c | 2159 | |
8223b1d2 BG |
2160 | If you want to compute time values use the =T= flag, either in |
2161 | Calc formulas or Elisp formulas: | |
2a12997c | 2162 | |
8223b1d2 BG |
2163 | | Task 1 | Task 2 | Total | |
2164 | |--------+--------+---------| | |
2165 | | 35:00 | 35:00 | 1:10:00 | | |
2166 | #+TBLFM: @2$3=$1+$2;T | |
2a12997c | 2167 | |
8223b1d2 BG |
2168 | Values must be of the form =[HH:]MM:SS=, where hours are |
2169 | optional. | |
2a12997c | 2170 | |
8223b1d2 BG |
2171 | Thanks to Martin Halder, Eric Schulte and Carsten for code and |
2172 | feedback on this. | |
2a12997c | 2173 | |
8223b1d2 | 2174 | **** Implement formulas applying to field ranges |
2a12997c | 2175 | |
8223b1d2 | 2176 | Carsten implemented this field-ranges formulas. |
2a12997c | 2177 | |
8223b1d2 BG |
2178 | : A frequently requested feature for tables has been to be able to define |
2179 | : row formulas in a way similar to column formulas. The patch below allows | |
2180 | : things like | |
2181 | : | |
2182 | : @3= | |
2183 | : @2$2..@5$7= | |
2184 | : @I$2..@II$4= | |
2185 | : | |
2186 | : as the left hand side for table formulas in order to write a formula that | |
2187 | : is valid for an entire column or for a rectangular section in a | |
2188 | : table. | |
2a12997c | 2189 | |
8223b1d2 | 2190 | Thanks a lot to Carsten for this. |
2a12997c | 2191 | |
8223b1d2 | 2192 | **** Sending radio tables from org buffers is now allowed |
2a12997c | 2193 | |
8223b1d2 BG |
2194 | Org radio tables can no also be sent inside Org buffers. Also, |
2195 | there is a new hook which get called after a table has been sent. | |
2a12997c | 2196 | |
8223b1d2 | 2197 | Thanks to Seweryn Kokot. |
2a12997c | 2198 | |
8223b1d2 | 2199 | *** Lists |
2a12997c | 2200 | |
8223b1d2 | 2201 | **** Improved handling of lists |
2a12997c | 2202 | |
8223b1d2 | 2203 | Nicolas Goaziou extended and improved the way Org handles lists. |
2a12997c | 2204 | |
8223b1d2 BG |
2205 | 1. Indentation of text determines again end of items in |
2206 | lists. So, some text less indented than the previous item | |
2207 | doesn't close the whole list anymore, only all items more | |
2208 | indented than it. | |
2a12997c | 2209 | |
8223b1d2 BG |
2210 | 2. Alphabetical bullets are implemented, through the use of the |
2211 | variable `org-alphabetical-lists'. This also adds alphabetical | |
2212 | counters like [@c] or [@W]. | |
2a12997c | 2213 | |
8223b1d2 BG |
2214 | 3. Lists can now safely contain drawers, inline tasks, or various |
2215 | blocks, themselves containing lists. Two variables are | |
2216 | controlling this: `org-list-forbidden-blocks', and | |
2217 | `org-list-export-context'. | |
2a12997c | 2218 | |
8223b1d2 BG |
2219 | 4. Improve `newline-and-indent' (C-j): used in an item, it will |
2220 | keep text from moving at column 0. This allows to split text | |
2221 | and make paragraphs and still not break the list. | |
2a12997c | 2222 | |
8223b1d2 BG |
2223 | 5. Improve `org-toggle-item' (C-c -): used on a region with |
2224 | standard text, it will change the region into one item. With a | |
2225 | prefix argument, it will fallback to the previous behavior and | |
2226 | make every line in region an item. It permits to easily | |
2227 | integrate paragraphs inside a list. | |
2a12997c | 2228 | |
8223b1d2 BG |
2229 | 6. `fill-paragraph' (M-q) now understands lists. It can freely be |
2230 | used inside items, or on text just after a list, even with no | |
2231 | blank line around, without breaking list structure. | |
2a12997c | 2232 | |
8223b1d2 | 2233 | Thanks a lot to Nicolas for all this! |
2a12997c | 2234 | |
8223b1d2 | 2235 | *** Inline display of linked images |
2a12997c | 2236 | |
8223b1d2 BG |
2237 | Images can now be displayed inline. The key C-c C-x C-v does |
2238 | toggle the display of such images. Note that only image links | |
2239 | that have no description part will be inlined. | |
2a12997c | 2240 | |
8223b1d2 | 2241 | *** Implement offsets for ordered lists |
2a12997c | 2242 | |
8223b1d2 BG |
2243 | If you want to start an ordered plain list with a number different |
2244 | from 1, you can now do it like this: | |
2a12997c | 2245 | |
8223b1d2 | 2246 | : 1. [@start:12] will star a lit a number 12 |
2a12997c | 2247 | |
8223b1d2 | 2248 | *** Babel: code block body expansion for table and preview |
2a12997c | 2249 | |
8223b1d2 BG |
2250 | In org-babel, code is "expanded" prior to evaluation. I.e. the |
2251 | code that is actually evaluated comprises the code block contents, | |
2252 | augmented with the extra code which assigns the referenced data to | |
2253 | variables. It is now possible to preview expanded contents, and | |
2254 | also to expand code during during tangling. This expansion takes | |
2255 | into account all header arguments, and variables. | |
2a12997c | 2256 | |
8223b1d2 BG |
2257 | A new keybinding `C-c M-b p' bound to `org-babel-expand-src-block' |
2258 | can be used from inside of a source code block to preview its | |
2259 | expanded contents (which can be very useful for debugging). | |
2260 | tangling | |
2a12997c | 2261 | |
8223b1d2 BG |
2262 | The expanded body can now be tangled, this includes variable |
2263 | values which may be the results of other source-code blocks, or | |
2264 | stored in headline properties or tables. One possible use for this | |
2265 | is to allow those using org-babel for their emacs initialization | |
2266 | to store values (e.g. usernames, passwords, etc...) in headline | |
2267 | properties or in tables. | |
2a12997c | 2268 | |
8223b1d2 BG |
2269 | Org-babel now supports three new header arguments, and new default |
2270 | behavior for handling horizontal lines in tables (hlines), column | |
2271 | names, and rownames across all languages. | |
2a12997c | 2272 | |
8223b1d2 | 2273 | *** Editing Convenience and Appearance |
2a12997c | 2274 | |
8223b1d2 | 2275 | **** New command =org-copy-visible= (=C-c C-x v=) |
2a12997c | 2276 | |
8223b1d2 BG |
2277 | This command will copy the visible text in the region into the |
2278 | kill ring. Thanks to Florian Beck for this function and to | |
2279 | Carsten for adding it to org.el and documenting it! | |
2a12997c | 2280 | |
8223b1d2 | 2281 | **** Make it possible to protect hidden subtrees from being killed by =C-k= |
2a12997c | 2282 | |
8223b1d2 BG |
2283 | See the new variable =org-ctrl-k-protect-subtree=. This was a |
2284 | request by Scott Otterson. | |
2a12997c | 2285 | |
8223b1d2 | 2286 | **** Implement pretty display of entities, sub-, and superscripts. |
2a12997c | 2287 | |
8223b1d2 BG |
2288 | The command =C-c C-x \= toggles the display of Org's special |
2289 | entities like =\alpha= as pretty unicode characters. Also, sub | |
2290 | and superscripts are displayed in a pretty way (raised/lower | |
2291 | display, in a smaller font). If you want to exclude sub- and | |
2292 | superscripts, see the variable | |
2293 | =org-pretty-entities-include-sub-superscripts=. | |
2a12997c | 2294 | |
8223b1d2 | 2295 | Thanks to Eric Schulte and Ulf Stegeman for making this possible. |
2a12997c | 2296 | |
8223b1d2 | 2297 | **** New faces for title, date, author and email address lines |
2a12997c | 2298 | |
8223b1d2 BG |
2299 | The keywords in these lines are now dimmed out, and the title is |
2300 | displayed in a larger font, and a special font is also used for | |
2301 | author, date, and email information. This is implemented by the | |
2302 | following new faces: | |
2a12997c | 2303 | |
8223b1d2 BG |
2304 | =org-document-title= |
2305 | =org-document-info= | |
2306 | =org-document-info-keyword= | |
2a12997c | 2307 | |
8223b1d2 BG |
2308 | In addition, the variable =org-hidden-keywords= can be used to |
2309 | make the corresponding keywords disappear. | |
2a12997c | 2310 | |
8223b1d2 | 2311 | Thanks to Dan Davison for this feature. |
2a12997c | 2312 | |
8223b1d2 | 2313 | **** Simpler way to specify faces for tags and todo keywords |
2a12997c | 2314 | |
8223b1d2 BG |
2315 | The variables =org-todo-keyword-faces=, =org-tag-faces=, and |
2316 | =org-priority-faces= now accept simple color names as | |
2317 | specifications. The colors will be used as either foreground or | |
2318 | background color for the corresponding keyword. See also the | |
2319 | variable =org-faces-easy-properties=, which governs which face | |
2320 | property is affected by this setting. | |
2a12997c | 2321 | |
8223b1d2 BG |
2322 | This is really a great simplification for setting keyword faces. |
2323 | The change is based on an idea and patch by Ryan Thompson. | |
2a12997c | 2324 | |
8223b1d2 | 2325 | **** <N> in tables now means fixed width, not maximum width |
2a12997c | 2326 | |
8223b1d2 | 2327 | Requested by Michael Brand. |
2a12997c | 2328 | |
8223b1d2 | 2329 | **** Better level cycling function |
2a12997c | 2330 | |
8223b1d2 BG |
2331 | =TAB= in an empty headline cycles the level of that headline |
2332 | through likely states. Ryan Thompson implemented an improved | |
2333 | version of this function, which does not depend upon when exactly | |
2334 | this command is used. Thanks to Ryan for this improvement. | |
2a12997c | 2335 | |
8223b1d2 | 2336 | **** Adaptive filling |
2a12997c | 2337 | |
8223b1d2 BG |
2338 | For paragraph text, =org-adaptive-fill-function= did not handle |
2339 | the base case of regular text which needed to be filled. This is | |
2340 | now fixed. Among other things, it allows email-style ">" | |
2341 | comments to be filled correctly. | |
2a12997c | 2342 | |
8223b1d2 | 2343 | Thanks to Dan Hackney for this patch. |
2a12997c | 2344 | |
8223b1d2 | 2345 | **** `org-reveal' (=C-c C-r=) also decrypts encrypted entries (org-crypt.el) |
2a12997c | 2346 | |
8223b1d2 | 2347 | Thanks to Richard Riley for triggering this change. |
2a12997c | 2348 | |
8223b1d2 | 2349 | **** Better automatic letter selection for TODO keywords |
2a12997c | 2350 | |
8223b1d2 BG |
2351 | When all first letters of keywords have been used, Org now |
2352 | assigns more meaningful characters based on the keywords. | |
2a12997c | 2353 | |
8223b1d2 | 2354 | Thanks to Mikael Fornius for this patch. |
2a12997c | 2355 | |
8223b1d2 | 2356 | *** Clocking |
2a12997c | 2357 | |
8223b1d2 | 2358 | **** Clock: Allow synchronous update of timestamps in CLOCK log |
2a12997c | 2359 | |
8223b1d2 BG |
2360 | Using =S-M-<up/down>= on CLOCK log timestamps will |
2361 | increase/decrease the two timestamps on this line so that | |
2362 | duration will keep the same. Note that duration can still be | |
2363 | slightly modified in case a timestamp needs some rounding. | |
2a12997c | 2364 | |
8223b1d2 | 2365 | Thanks to Rainer Stengele for this idea. |
2a12997c | 2366 | |
8223b1d2 | 2367 | **** Localized clock tables |
2a12997c | 2368 | |
8223b1d2 BG |
2369 | Clock tables now support a new new =:lang= parameter, allowing |
2370 | the user to customize the localization of the table headers. See | |
2371 | the variable =org-clock-clocktable-language-setup= which controls | |
2372 | available translated strings. | |
2a12997c | 2373 | |
8223b1d2 | 2374 | **** Show clock overruns in mode line |
2a12997c | 2375 | |
8223b1d2 BG |
2376 | When clocking an item with a planned effort, overrunning the |
2377 | planned time is now made visible in the mode line, for example | |
2378 | using the new face =org-mode-line-clock-overrun=, or by adding an | |
2379 | extra string given by =org-task-overrun-text=. | |
2a12997c | 2380 | |
8223b1d2 | 2381 | Thanks to Richard Riley for a patch to this effect. |
2a12997c | 2382 | |
8223b1d2 | 2383 | **** Clock reports can now include the running, incomplete clock |
2a12997c | 2384 | |
8223b1d2 BG |
2385 | If you have a clock running, and the entry being clocked falls |
2386 | into the scope when creating a clock table, the time so far spent | |
2387 | can be added to the total. This behavior depends on the setting | |
2388 | of =org-clock-report-include-clocking-task=. The default is | |
2389 | =nil=. | |
2a12997c | 2390 | |
8223b1d2 | 2391 | Thanks to Bernt Hansen for this useful addition. |
2a12997c | 2392 | |
8223b1d2 | 2393 | *** Misc |
2a12997c | 2394 | |
8223b1d2 | 2395 | **** Improvements with inline tasks and indentation |
2a12997c | 2396 | |
8223b1d2 BG |
2397 | There is now a configurable way on how to export inline tasks. |
2398 | See the new variable =org-inlinetask-export-templates=. | |
2a12997c | 2399 | |
8223b1d2 | 2400 | Thanks to Nicolas Goaziou for coding these changes. |
2a12997c | 2401 | |
8223b1d2 | 2402 | **** A property value of "nil" now means to unset a property |
2a12997c | 2403 | |
8223b1d2 BG |
2404 | This can be useful in particular with property inheritance, if |
2405 | some upper level has the property, and some grandchild of it | |
2406 | would like to have the default settings (i.e. not overruled by a | |
2407 | property) back. | |
2a12997c | 2408 | |
8223b1d2 BG |
2409 | Thanks to Robert Goldman and Bernt Hansen for suggesting this |
2410 | change. | |
2a12997c | 2411 | |
8223b1d2 | 2412 | **** New helper functions in org-table.el |
2a12997c | 2413 | |
8223b1d2 BG |
2414 | There are new functions to access and write to a specific table field. |
2415 | This is for hackers, and maybe for the org-babel people. | |
2a12997c | 2416 | |
8223b1d2 BG |
2417 | #+begin_example |
2418 | org-table-get | |
2419 | org-table-put | |
2420 | org-table-current-line | |
2421 | org-table-goto-line | |
2422 | #+end_example | |
2a12997c | 2423 | |
8223b1d2 | 2424 | **** Archiving: Allow to reverse order in target node |
2a12997c | 2425 | |
8223b1d2 BG |
2426 | The new option =org-archive-reversed-order= allows to have |
2427 | archived entries inserted in a last-on-top fashion in the target | |
2428 | node. | |
2a12997c | 2429 | |
8223b1d2 | 2430 | This was requested by Tom. |
2a12997c | 2431 | |
8223b1d2 | 2432 | **** Org-reveal: Double prefix arg shows the entire subtree of the parent |
2a12997c | 2433 | |
8223b1d2 BG |
2434 | This can help to get out of an inconsistent state produced for |
2435 | example by viewing from the agenda. | |
2a12997c | 2436 | |
8223b1d2 | 2437 | This was a request by Matt Lundin. |
f2c3a9eb | 2438 | |
2a12997c BG |
2439 | * License |
2440 | ||
8223b1d2 | 2441 | This file is part of GNU Emacs. |
2a12997c | 2442 | |
8223b1d2 BG |
2443 | GNU Emacs is free software: you can redistribute it and/or modify |
2444 | it under the terms of the GNU General Public License as published by | |
2445 | the Free Software Foundation, either version 3 of the License, or | |
2446 | (at your option) any later version. | |
2a12997c | 2447 | |
8223b1d2 BG |
2448 | GNU Emacs is distributed in the hope that it will be useful, |
2449 | but WITHOUT ANY WARRANTY; without even the implied warranty of | |
2450 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | |
2451 | GNU General Public License for more details. | |
2a12997c | 2452 | |
8223b1d2 BG |
2453 | You should have received a copy of the GNU General Public License |
2454 | along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |