diff options
| author | Joakim Verona | 2012-10-16 17:14:35 +0200 |
|---|---|---|
| committer | Joakim Verona | 2012-10-16 17:14:35 +0200 |
| commit | 017a270078be5ae39301e3205afad80d23facbbc (patch) | |
| tree | 5c85d8c3890f3a0cead231e87823b621a8f28e16 /etc | |
| parent | 5fcc7035c884b4419a1619551222b5f28ad9906f (diff) | |
| parent | 2b794d6940aa7dc58e297b3649b7799190d71f64 (diff) | |
| download | emacs-017a270078be5ae39301e3205afad80d23facbbc.tar.gz emacs-017a270078be5ae39301e3205afad80d23facbbc.zip | |
upstream
Diffstat (limited to 'etc')
| -rw-r--r-- | etc/ChangeLog | 44 | ||||
| -rw-r--r-- | etc/NEWS | 121 | ||||
| -rw-r--r-- | etc/ORG-NEWS | 1966 | ||||
| -rw-r--r-- | etc/images/icons/README | 7 | ||||
| -rw-r--r-- | etc/images/icons/hicolor/16x16/apps/emacs22.png | bin | 705 -> 0 bytes | |||
| -rw-r--r-- | etc/images/icons/hicolor/24x24/apps/emacs22.png | bin | 988 -> 0 bytes | |||
| -rw-r--r-- | etc/images/icons/hicolor/32x32/apps/emacs22.png | bin | 2404 -> 0 bytes | |||
| -rw-r--r-- | etc/images/icons/hicolor/48x48/apps/emacs22.png | bin | 3431 -> 0 bytes | |||
| -rw-r--r-- | etc/org/OrgOdtContentTemplate.xml | 1 | ||||
| -rw-r--r-- | etc/org/OrgOdtStyles.xml | 5 | ||||
| -rw-r--r-- | etc/refcards/orgcard.pdf | bin | 118438 -> 118438 bytes | |||
| -rw-r--r-- | etc/refcards/orgcard.tex | 2 | ||||
| -rw-r--r-- | etc/srecode/c.srt | 164 | ||||
| -rw-r--r-- | etc/srecode/cpp.srt | 123 | ||||
| -rw-r--r-- | etc/srecode/ede-autoconf.srt | 54 | ||||
| -rw-r--r-- | etc/srecode/ede-make.srt | 32 | ||||
| -rw-r--r-- | etc/srecode/el.srt | 2 |
17 files changed, 1605 insertions, 916 deletions
diff --git a/etc/ChangeLog b/etc/ChangeLog index 6f2b178fcd7..c163683ea39 100644 --- a/etc/ChangeLog +++ b/etc/ChangeLog | |||
| @@ -1,3 +1,47 @@ | |||
| 1 | 2012-10-01 Eric Ludlam <zappo@gnu.org> | ||
| 2 | |||
| 3 | * srecode/cc.srt, srecode/ede-autoconf.srt: New files. | ||
| 4 | |||
| 5 | * srecode/cpp.srt: Move parts to c.srt. | ||
| 6 | |||
| 7 | * srecode/ede-make.srt: Extra templates for Arduino Makefiles. | ||
| 8 | |||
| 9 | 2012-10-01 Ralf Mattes <rm@mh-freiburg.de> (tiny change) | ||
| 10 | |||
| 11 | * srecode/el.srt (variable-option): Add missing quote. | ||
| 12 | |||
| 13 | 2012-10-01 Chong Yidong <cyd@gnu.org> | ||
| 14 | |||
| 15 | * images/icons/hicolor/32x32/apps/emacs22.png: | ||
| 16 | * images/icons/hicolor/16x16/apps/emacs22.png: | ||
| 17 | * images/icons/hicolor/48x48/apps/emacs22.png: | ||
| 18 | * images/icons/hicolor/24x24/apps/emacs22.png: Remove old icons | ||
| 19 | (Bug#12536). | ||
| 20 | |||
| 21 | 2012-10-01 Paul Eggert <eggert@cs.ucla.edu> | ||
| 22 | |||
| 23 | Revert the FOLLOW-SYMLINKS change for file-attributes. | ||
| 24 | * NEWS: Undo last change. | ||
| 25 | |||
| 26 | 2012-09-30 Bastien Guerry <bzg@gnu.org> | ||
| 27 | |||
| 28 | * refcards/orgcard.tex: Update version number. | ||
| 29 | |||
| 30 | 2012-09-30 Jambunathan K <kjambunathan@gmail.com> | ||
| 31 | |||
| 32 | * org/OrgOdtContentTemplate.xml: | ||
| 33 | * org/OrgOdtStyles.xml: Add Listing-related entries. | ||
| 34 | |||
| 35 | 2012-09-30 Paul Eggert <eggert@cs.ucla.edu> | ||
| 36 | |||
| 37 | file-attributes has a new optional arg FOLLOW-SYMLINKS. | ||
| 38 | * NEWS: Document the change. | ||
| 39 | |||
| 40 | 2012-09-30 Jan Djärv <jan.h.d@swipnet.se> | ||
| 41 | |||
| 42 | * NEWS: The NS port supports fullscreen. | ||
| 43 | Mention that the file dialog is used on NS. | ||
| 44 | |||
| 1 | 2012-09-17 Glenn Morris <rgm@gnu.org> | 45 | 2012-09-17 Glenn Morris <rgm@gnu.org> |
| 2 | 46 | ||
| 3 | * refcards/emacsver.tex: New file. | 47 | * refcards/emacsver.tex: New file. |
| @@ -76,6 +76,7 @@ You can explicitly require a specific version by passing | |||
| 76 | 76 | ||
| 77 | * Startup Changes in Emacs 24.3 | 77 | * Startup Changes in Emacs 24.3 |
| 78 | 78 | ||
| 79 | +++ | ||
| 79 | ** Emacs no longer searches for `leim-list.el' files beneath the standard | 80 | ** Emacs no longer searches for `leim-list.el' files beneath the standard |
| 80 | lisp/ directory. There should not be any there anyway. If you have | 81 | lisp/ directory. There should not be any there anyway. If you have |
| 81 | been adding them there, put them somewhere else, eg site-lisp. | 82 | been adding them there, put them somewhere else, eg site-lisp. |
| @@ -89,10 +90,12 @@ been adding them there, put them somewhere else, eg site-lisp. | |||
| 89 | ** minibuffer-electric-default-mode can rewrite (default ...) to [...]. | 90 | ** minibuffer-electric-default-mode can rewrite (default ...) to [...]. |
| 90 | Just set minibuffer-eldef-shorten-default to t before enabling the mode. | 91 | Just set minibuffer-eldef-shorten-default to t before enabling the mode. |
| 91 | 92 | ||
| 93 | +++ | ||
| 92 | ** Most y-or-n prompts now allow you to scroll the selected window. | 94 | ** Most y-or-n prompts now allow you to scroll the selected window. |
| 93 | Typing C-v or M-v at a y-or-n prompt scrolls forward or backward | 95 | Typing C-v or M-v at a y-or-n prompt scrolls forward or backward |
| 94 | respectively, without exiting from the prompt. | 96 | respectively, without exiting from the prompt. |
| 95 | 97 | ||
| 98 | --- | ||
| 96 | ** In minibuffer filename prompts, `C-M-f' and `C-M-b' now move to the | 99 | ** In minibuffer filename prompts, `C-M-f' and `C-M-b' now move to the |
| 97 | next and previous path separator, respectively. | 100 | next and previous path separator, respectively. |
| 98 | 101 | ||
| @@ -107,12 +110,14 @@ invokes `set-buffer-file-coding-system'. | |||
| 107 | 110 | ||
| 108 | ** Help changes | 111 | ** Help changes |
| 109 | 112 | ||
| 113 | +++ | ||
| 110 | *** `C-h f' (describe-function) can now perform autoloading. | 114 | *** `C-h f' (describe-function) can now perform autoloading. |
| 111 | When this command is called for an autoloaded function whose docstring | 115 | When this command is called for an autoloaded function whose docstring |
| 112 | contains a key substitution construct, that function's library is | 116 | contains a key substitution construct, that function's library is |
| 113 | automatically loaded, so that the documentation can be shown | 117 | automatically loaded, so that the documentation can be shown |
| 114 | correctly. To disable this, set `help-enable-auto-load' to nil. | 118 | correctly. To disable this, set `help-enable-auto-load' to nil. |
| 115 | 119 | ||
| 120 | --- | ||
| 116 | *** `C-h f' now reports previously-autoloaded functions as "autoloaded", | 121 | *** `C-h f' now reports previously-autoloaded functions as "autoloaded", |
| 117 | even after their associated libraries have been loaded (and the | 122 | even after their associated libraries have been loaded (and the |
| 118 | autoloads have been redefined as functions). | 123 | autoloads have been redefined as functions). |
| @@ -136,11 +141,11 @@ treated as images. | |||
| 136 | :background image spec property. | 141 | :background image spec property. |
| 137 | 142 | ||
| 138 | ** Server and client changes | 143 | ** Server and client changes |
| 139 | 144 | +++ | |
| 140 | *** emacsclient now obeys string values for `initial-buffer-choice', | 145 | *** emacsclient now obeys string values for `initial-buffer-choice', |
| 141 | if it is told to open a new frame without specifying any file to visit | 146 | if it is told to open a new frame without specifying any file to visit |
| 142 | or expression to evaluate. | 147 | or expression to evaluate. |
| 143 | 148 | --- | |
| 144 | *** New option `server-auth-key' specifies a shared server key. | 149 | *** New option `server-auth-key' specifies a shared server key. |
| 145 | 150 | ||
| 146 | ** In the Package Menu, newly-available packages are listed as "new", | 151 | ** In the Package Menu, newly-available packages are listed as "new", |
| @@ -155,6 +160,9 @@ On encountering a fatal error, Emacs now outputs a textual description | |||
| 155 | of the fatal signal, and a short backtrace on platforms like glibc | 160 | of the fatal signal, and a short backtrace on platforms like glibc |
| 156 | that support backtraces. | 161 | that support backtraces. |
| 157 | 162 | ||
| 163 | ** `message-log-max' now defaults to 1000, not 100. | ||
| 164 | |||
| 165 | --- | ||
| 158 | ** If your Emacs was built from a bzr checkout, the new variable | 166 | ** If your Emacs was built from a bzr checkout, the new variable |
| 159 | `emacs-bzr-version' contains information about the bzr revision used. | 167 | `emacs-bzr-version' contains information about the bzr revision used. |
| 160 | 168 | ||
| @@ -181,33 +189,34 @@ The PCL-CVS commands are still available via the keyboard. | |||
| 181 | --- | 189 | --- |
| 182 | *** New input method `vietnamese-vni'. | 190 | *** New input method `vietnamese-vni'. |
| 183 | 191 | ||
| 192 | ** NextStep/OSX port changes. | ||
| 193 | --- | ||
| 194 | *** Fullscreen and frame parameter fullscreen is supported. | ||
| 195 | --- | ||
| 196 | *** A file dialog is used when open/saved is done from the menu/toolbar. | ||
| 184 | 197 | ||
| 185 | * Editing Changes in Emacs 24.3 | 198 | * Editing Changes in Emacs 24.3 |
| 186 | 199 | ||
| 200 | ** Navigation command changes | ||
| 187 | +++ | 201 | +++ |
| 188 | ** `C-x 8 RET' is now bound to `insert-char', which is now a command. | 202 | *** New binding `M-g c' for `goto-char'. |
| 189 | `ucs-insert' is now an obsolete alias for `insert-char'. | 203 | +++ |
| 190 | 204 | *** New binding `M-g TAB' for `move-to-column'. | |
| 191 | --- | 205 | +++ |
| 192 | ** The `z' key no longer has a binding in most special modes. | 206 | *** `M-g TAB' (`move-to-column') prompts for a column number if called |
| 193 | It used to be bound to `kill-this-buffer', but `z' is too easy to | 207 | interactively with no prefix arg. Previously, it moved to column 1. |
| 194 | accidentally type. | ||
| 195 | |||
| 196 | ** New option `delete-trailing-lines' specifies whether | ||
| 197 | M-x delete-trailing-whitespace should delete trailing lines at the end | ||
| 198 | of the buffer. It defaults to t. | ||
| 199 | 208 | ||
| 200 | ** Search and Replace changes | 209 | ** Search and Replace changes |
| 201 | 210 | +++ | |
| 202 | *** Non-regexp Isearch now performs "lax" space matching. | 211 | *** Non-regexp Isearch now performs "lax" space matching. |
| 203 | Each sequence of spaces in the supplied search string may match any | 212 | Each sequence of spaces in the supplied search string may match any |
| 204 | sequence of one or more whitespace characters, as specified by the | 213 | sequence of one or more whitespace characters, as specified by the |
| 205 | variable `search-whitespace-regexp'. (This variable is also used by a | 214 | variable `search-whitespace-regexp'. (This variable is also used by a |
| 206 | similar existing feature for regexp Isearch). | 215 | similar existing feature for regexp Isearch). |
| 207 | 216 | +++ | |
| 208 | *** New Isearch command `M-s SPC' toggles lax space matching. | 217 | *** New Isearch command `M-s SPC' toggles lax space matching. |
| 209 | This applies to both ordinary and regexp Isearch. | 218 | This applies to both ordinary and regexp Isearch. |
| 210 | 219 | +++ | |
| 211 | *** New option `replace-lax-whitespace'. | 220 | *** New option `replace-lax-whitespace'. |
| 212 | If non-nil, `query-replace' uses flexible whitespace matching too. | 221 | If non-nil, `query-replace' uses flexible whitespace matching too. |
| 213 | The default is nil. | 222 | The default is nil. |
| @@ -216,6 +225,20 @@ The default is nil. | |||
| 216 | and `M-s _' in Isearch toggles symbol search mode. | 225 | and `M-s _' in Isearch toggles symbol search mode. |
| 217 | `M-s c' in Isearch toggles search case-sensitivity. | 226 | `M-s c' in Isearch toggles search case-sensitivity. |
| 218 | 227 | ||
| 228 | +++ | ||
| 229 | ** `C-x 8 RET' is now bound to `insert-char', which is now a command. | ||
| 230 | `ucs-insert' is now an obsolete alias for `insert-char'. | ||
| 231 | |||
| 232 | --- | ||
| 233 | ** The `z' key no longer has a binding in most special modes. | ||
| 234 | It used to be bound to `kill-this-buffer', but `z' is too easy to | ||
| 235 | accidentally type. | ||
| 236 | |||
| 237 | +++ | ||
| 238 | ** New option `delete-trailing-lines' specifies whether | ||
| 239 | M-x delete-trailing-whitespace should delete trailing lines at the end | ||
| 240 | of the buffer. It defaults to t. | ||
| 241 | |||
| 219 | ** Register changes | 242 | ** Register changes |
| 220 | +++ | 243 | +++ |
| 221 | *** `C-x r +' is now overloaded to invoke `append-to-register. | 244 | *** `C-x r +' is now overloaded to invoke `append-to-register. |
| @@ -224,13 +247,10 @@ and `M-s _' in Isearch toggles symbol search mode. | |||
| 224 | the text to put between collected texts for use with M-x | 247 | the text to put between collected texts for use with M-x |
| 225 | append-to-register and M-x prepend-to-register. | 248 | append-to-register and M-x prepend-to-register. |
| 226 | 249 | ||
| 250 | +++ | ||
| 227 | ** `C-u M-=' now counts lines/words/characters in the entire buffer. | 251 | ** `C-u M-=' now counts lines/words/characters in the entire buffer. |
| 228 | 252 | ||
| 229 | ** New binding `M-g c' for `goto-char'. | 253 | +++ |
| 230 | |||
| 231 | ** M-x move-to-column, if called interactively with no prefix arg, now | ||
| 232 | prompts for a column number. | ||
| 233 | |||
| 234 | ** New command `C-x r M-w' (copy-rectangle-as-kill). | 254 | ** New command `C-x r M-w' (copy-rectangle-as-kill). |
| 235 | It copies the region-rectangle as the last rectangle kill. | 255 | It copies the region-rectangle as the last rectangle kill. |
| 236 | 256 | ||
| @@ -242,17 +262,17 @@ just removing them, as done by `yank-excluded-properties'. | |||
| 242 | * Changes in Specialized Modes and Packages in Emacs 24.3 | 262 | * Changes in Specialized Modes and Packages in Emacs 24.3 |
| 243 | 263 | ||
| 244 | ** Apropos | 264 | ** Apropos |
| 245 | 265 | --- | |
| 246 | *** The faces used by Apropos are now directly customizable. | 266 | *** The faces used by Apropos are now directly customizable. |
| 247 | These faces are named `apropos-symbol', `apropos-keybinding', and so on; | 267 | These faces are named `apropos-symbol', `apropos-keybinding', and so on; |
| 248 | see the `apropos' Custom group for details. | 268 | see the `apropos' Custom group for details. |
| 249 | 269 | --- | |
| 250 | **** The old options whose values specified faces to use were removed | 270 | *** The old options whose values specified faces to use were removed |
| 251 | (i.e. `apropos-symbol-face', `apropos-keybinding-face', etc.). | 271 | (i.e. `apropos-symbol-face', `apropos-keybinding-face', etc.). |
| 252 | 272 | ||
| 253 | ** Buffer Menu | 273 | ** Buffer Menu |
| 254 | This package has been rewritten to use Tabulated List mode. | 274 | This package has been rewritten to use Tabulated List mode. |
| 255 | 275 | --- | |
| 256 | *** Option `Buffer-menu-buffer+size-width' is now obsolete. | 276 | *** Option `Buffer-menu-buffer+size-width' is now obsolete. |
| 257 | Use `Buffer-menu-name-width' and `Buffer-menu-size-width' instead. | 277 | Use `Buffer-menu-name-width' and `Buffer-menu-size-width' instead. |
| 258 | 278 | ||
| @@ -568,27 +588,30 @@ in case that is not properly encoded. | |||
| 568 | 588 | ||
| 569 | ** which-function-mode now applies to all applicable major modes by default. | 589 | ** which-function-mode now applies to all applicable major modes by default. |
| 570 | 590 | ||
| 591 | --- | ||
| 592 | ** winner-mode-hook now runs when the mode is disabled, as well as when it is | ||
| 593 | enabled. | ||
| 571 | 594 | ||
| 572 | ** FIXME something happened to ses.el, 2012-04-17. | 595 | ** FIXME something happened to ses.el, 2012-04-17. |
| 573 | 596 | ||
| 574 | 597 | ||
| 575 | ** Obsolete packages: | 598 | ** Obsolete packages: |
| 576 | 599 | +++ | |
| 577 | *** assoc.el | 600 | *** assoc.el |
| 578 | In most cases, assoc+member+push+delq work just as well. | 601 | In most cases, assoc+member+push+delq work just as well. |
| 579 | And in any case it's just a terrible package: ugly semantics, terrible | 602 | And in any case it's just a terrible package: ugly semantics, terrible |
| 580 | inefficiency, and not namespace-clean. | 603 | inefficiency, and not namespace-clean. |
| 581 | 604 | --- | |
| 582 | *** bruce.el | 605 | *** bruce.el |
| 583 | 606 | --- | |
| 584 | *** ledit.el | 607 | *** ledit.el |
| 585 | 608 | --- | |
| 586 | *** mailpost.el | 609 | *** mailpost.el |
| 587 | 610 | +++ | |
| 588 | *** mouse-sel.el | 611 | *** mouse-sel.el |
| 589 | 612 | --- | |
| 590 | *** patcomp.el | 613 | *** patcomp.el |
| 591 | 614 | +++ | |
| 592 | *** cust-print.el | 615 | *** cust-print.el |
| 593 | 616 | ||
| 594 | 617 | ||
| @@ -596,11 +619,15 @@ inefficiency, and not namespace-clean. | |||
| 596 | 619 | ||
| 597 | * Incompatible Lisp Changes in Emacs 24.3 | 620 | * Incompatible Lisp Changes in Emacs 24.3 |
| 598 | 621 | ||
| 622 | ** set-buffer-multibyte now signals an error in narrowed buffers. | ||
| 623 | |||
| 624 | +++ | ||
| 599 | ** (random) by default now returns a different random sequence in | 625 | ** (random) by default now returns a different random sequence in |
| 600 | every Emacs run. Use (random S), where S is a string, to set the | 626 | every Emacs run. Use (random S), where S is a string, to set the |
| 601 | random seed to a value based on S, in order to get a repeatable | 627 | random seed to a value based on S, in order to get a repeatable |
| 602 | sequence in later calls. | 628 | sequence in later calls. |
| 603 | 629 | ||
| 630 | --- | ||
| 604 | ** The function `x-select-font' can return a font spec, instead of a | 631 | ** The function `x-select-font' can return a font spec, instead of a |
| 605 | font name as a string. Whether it returns a font spec or a font name | 632 | font name as a string. Whether it returns a font spec or a font name |
| 606 | depends on the graphical library. | 633 | depends on the graphical library. |
| @@ -621,6 +648,7 @@ and are now undefined. For backwards compatibility, defun and | |||
| 621 | defmacro currently return the name of the newly defined function/macro | 648 | defmacro currently return the name of the newly defined function/macro |
| 622 | but this should not be relied upon. | 649 | but this should not be relied upon. |
| 623 | 650 | ||
| 651 | --- | ||
| 624 | ** `face-spec-set' no longer sets frame-specific attributes when the | 652 | ** `face-spec-set' no longer sets frame-specific attributes when the |
| 625 | third argument is a frame (that usage was obsolete since Emacs 22.2). | 653 | third argument is a frame (that usage was obsolete since Emacs 22.2). |
| 626 | 654 | ||
| @@ -658,7 +686,7 @@ are deprecated and will be removed eventually. | |||
| 658 | **** inactivate-current-input-method-function -> | 686 | **** inactivate-current-input-method-function -> |
| 659 | deactivate-current-input-method-function | 687 | deactivate-current-input-method-function |
| 660 | 688 | ||
| 661 | ** Some obsolete functions and variables were removed: | 689 | ** Some obsolete functions, variables, and faces were removed: |
| 662 | 690 | ||
| 663 | *** `facemenu-unlisted-faces' | 691 | *** `facemenu-unlisted-faces' |
| 664 | *** `rmail-decode-mime-charset' | 692 | *** `rmail-decode-mime-charset' |
| @@ -677,6 +705,7 @@ are deprecated and will be removed eventually. | |||
| 677 | *** `vc-ignore-vc-files' (use `vc-handled-backends' instead) | 705 | *** `vc-ignore-vc-files' (use `vc-handled-backends' instead) |
| 678 | *** `vc-master-templates' (use `vc-handled-backends' instead) | 706 | *** `vc-master-templates' (use `vc-handled-backends' instead) |
| 679 | *** `vc-checkout-carefully' | 707 | *** `vc-checkout-carefully' |
| 708 | *** `modeline' | ||
| 680 | 709 | ||
| 681 | 710 | ||
| 682 | * Lisp changes in Emacs 24.3 | 711 | * Lisp changes in Emacs 24.3 |
| @@ -731,14 +760,11 @@ now accept a third argument to avoid choosing the selected window. | |||
| 731 | 760 | ||
| 732 | *** New macro `with-temp-buffer-window'. | 761 | *** New macro `with-temp-buffer-window'. |
| 733 | 762 | ||
| 734 | *** New options `temp-buffer-resize-frames' and | ||
| 735 | `temp-buffer-resize-regexps'. | ||
| 736 | |||
| 737 | *** `temp-buffer-resize-mode' no longer resizes windows that have been | 763 | *** `temp-buffer-resize-mode' no longer resizes windows that have been |
| 738 | reused. | 764 | reused. |
| 739 | 765 | ||
| 740 | *** New function `fit-frame-to-buffer' and new option | 766 | *** New function `fit-frame-to-buffer' and new options |
| 741 | `fit-frame-to-buffer-bottom-margin'. | 767 | `fit-frame-to-buffer' and `fit-frame-to-buffer-bottom-margin'. |
| 742 | 768 | ||
| 743 | *** New display action functions `display-buffer-below-selected', | 769 | *** New display action functions `display-buffer-below-selected', |
| 744 | `display-buffer-at-bottom' and `display-buffer-in-previous-window'. | 770 | `display-buffer-at-bottom' and `display-buffer-in-previous-window'. |
| @@ -753,6 +779,9 @@ non-nil, specifies frame parameters to give any newly-created frame. | |||
| 753 | *** New display action alist entry `previous-window', if non-nil, | 779 | *** New display action alist entry `previous-window', if non-nil, |
| 754 | specifies window to reuse in `display-buffer-in-previous-window'. | 780 | specifies window to reuse in `display-buffer-in-previous-window'. |
| 755 | 781 | ||
| 782 | *** New display action alist entries `window-height' and `window-width' | ||
| 783 | to specify size of new window created by `display-buffer'. | ||
| 784 | |||
| 756 | *** The following variables are obsolete, as they can be replaced by | 785 | *** The following variables are obsolete, as they can be replaced by |
| 757 | appropriate entries in the `display-buffer-alist' function introduced | 786 | appropriate entries in the `display-buffer-alist' function introduced |
| 758 | in Emacs 24.1: | 787 | in Emacs 24.1: |
| @@ -765,23 +794,24 @@ in Emacs 24.1: | |||
| 765 | **** `display-buffer-function' | 794 | **** `display-buffer-function' |
| 766 | 795 | ||
| 767 | ** Time | 796 | ** Time |
| 768 | 797 | --- | |
| 769 | *** `current-time-string' no longer requires that its argument's year | 798 | *** `current-time-string' no longer requires that its argument's year |
| 770 | must be in the range 1000..9999. It now works with any year supported | 799 | must be in the range 1000..9999. It now works with any year supported |
| 771 | by the underlying C implementation. | 800 | by the underlying C implementation. |
| 772 | 801 | --- | |
| 773 | *** `current-time' now returns extended-format time stamps | 802 | *** `current-time' now returns extended-format time stamps |
| 774 | (HIGH LOW USEC PSEC), where the new PSEC slot specifies picoseconds. | 803 | (HIGH LOW USEC PSEC), where the new PSEC slot specifies picoseconds. |
| 775 | PSEC is typically a multiple of 1000 on current machines. Other | 804 | PSEC is typically a multiple of 1000 on current machines. Other |
| 776 | functions that use this format, such as file-attributes and | 805 | functions that use this format, such as file-attributes and |
| 777 | format-time-string, have been changed accordingly. Old-format time | 806 | format-time-string, have been changed accordingly. Old-format time |
| 778 | stamps are still accepted. | 807 | stamps are still accepted. |
| 779 | 808 | --- | |
| 780 | *** The format of timers in timer-list and timer-idle-list is now | 809 | *** The format of timers in timer-list and timer-idle-list is now |
| 781 | [TRIGGERED-P HI-SECS LO-SECS USECS REPEAT-DELAY FUNCTION ARGS IDLE-DELAY PSECS]. | 810 | [TRIGGERED-P HI-SECS LO-SECS USECS REPEAT-DELAY FUNCTION ARGS IDLE-DELAY PSECS]. |
| 782 | The PSECS slot is new, and uses picosecond resolution. It can be | 811 | The PSECS slot is new, and uses picosecond resolution. It can be |
| 783 | accessed via the new timer--psecs accessor. | 812 | accessed via the new timer--psecs accessor. |
| 784 | 813 | ||
| 814 | +++ | ||
| 785 | ** Floating point functions now always return special values like NaN, | 815 | ** Floating point functions now always return special values like NaN, |
| 786 | instead of signaling errors, if given invalid args, e.g. (log -1.0). | 816 | instead of signaling errors, if given invalid args, e.g. (log -1.0). |
| 787 | Previously, they returned NaNs on some platforms but signaled errors | 817 | Previously, they returned NaNs on some platforms but signaled errors |
| @@ -793,24 +823,29 @@ This can significantly speed up execution of non-byte-compiled code, | |||
| 793 | but can also bump into harmless and previously unnoticed cyclic | 823 | but can also bump into harmless and previously unnoticed cyclic |
| 794 | dependencies. These should not be fatal: they will simply cause the | 824 | dependencies. These should not be fatal: they will simply cause the |
| 795 | macro-calls to be left for later expansion (as before), but will also | 825 | macro-calls to be left for later expansion (as before), but will also |
| 796 | result in a warning describing the cycle. | 826 | result in a warning ("Eager macro-expansion skipped due to cycle") |
| 827 | describing the cycle. | ||
| 797 | 828 | ||
| 798 | ** Misc new functions: | 829 | ** Misc new functions: |
| 799 | 830 | ||
| 800 | *** `autoloadp' | 831 | *** `autoloadp' |
| 801 | *** `autoload-do-load'. | 832 | *** `autoload-do-load'. |
| 833 | +++ | ||
| 802 | *** `buffer-narrowed-p' tests if the buffer is narrowed. | 834 | *** `buffer-narrowed-p' tests if the buffer is narrowed. |
| 803 | *** `file-name-base' returns a file name sans directory and extension. | 835 | *** `file-name-base' returns a file name sans directory and extension. |
| 804 | *** `function-get' fetches a function property, following aliases. | 836 | *** `function-get' fetches a function property, following aliases. |
| 837 | +++ | ||
| 805 | *** `posnp' tests if an object is a `posn'. | 838 | *** `posnp' tests if an object is a `posn'. |
| 806 | *** `set-temporary-overlay-map' sets up a temporary overlay map. | 839 | *** `set-temporary-overlay-map' sets up a temporary overlay map. |
| 840 | +++ | ||
| 807 | *** `system-users' returns the user names on the system. | 841 | *** `system-users' returns the user names on the system. |
| 842 | +++ | ||
| 808 | *** `system-groups' returns the group names on the system. | 843 | *** `system-groups' returns the group names on the system. |
| 809 | *** `tty-top-frame' returns the topmost frame of a text terminal. | 844 | *** `tty-top-frame' returns the topmost frame of a text terminal. |
| 810 | 845 | ||
| 811 | ** New macros `setq-local' and `defvar-local'. | 846 | ** New macros `setq-local' and `defvar-local'. |
| 812 | 847 | ||
| 813 | ** New fringe bitmap exclamation-mark. | 848 | ** New fringe bitmap `exclamation-mark'. |
| 814 | 849 | ||
| 815 | ** Face underlining can now use a wave. | 850 | ** Face underlining can now use a wave. |
| 816 | See the "Face Attributes" section of the Elisp manual. | 851 | See the "Face Attributes" section of the Elisp manual. |
diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS index a5b88d3f451..35aab7a0eef 100644 --- a/etc/ORG-NEWS +++ b/etc/ORG-NEWS | |||
| @@ -5,267 +5,894 @@ See the end of the file for license conditions. | |||
| 5 | 5 | ||
| 6 | Please send Org bug reports to emacs-orgmode@gnu.org. | 6 | Please send Org bug reports to emacs-orgmode@gnu.org. |
| 7 | 7 | ||
| 8 | * Incompatible changes | 8 | * Version 7.9.2 |
| 9 | |||
| 10 | ** New keys for TODO sparse trees | ||
| 11 | :PROPERTIES: | ||
| 12 | :OrgVersion: 7.01 | ||
| 13 | :END: | ||
| 14 | |||
| 15 | The key =C-c C-v= is now reserved for Org Babel action. TODO sparse | ||
| 16 | trees can still be made with =C-c / t= (all not-done states) and =C-c / | ||
| 17 | T= (specific states). | ||
| 18 | |||
| 19 | ** The Agenda =org-agenda-ndays= is now obsolete | ||
| 20 | :PROPERTIES: | ||
| 21 | :OrgVersion: 7.4 | ||
| 22 | :END: | ||
| 23 | |||
| 24 | The variable =org-agenda-ndays= is obsolete - please use | ||
| 25 | =org-agenda-span= instead. | ||
| 26 | |||
| 27 | Thanks to Julien Danjou for this. | ||
| 28 | |||
| 29 | ** Changes to the intended use of =org-export-latex-classes= | ||
| 30 | :PROPERTIES: | ||
| 31 | :OrgVersion: 6.35 | ||
| 32 | :END: | ||
| 33 | |||
| 34 | So far this variable has been used to specify the complete header of the | ||
| 35 | LaTeX document, including all the =\usepackage= calls necessary for the | ||
| 36 | document. This setup makes it difficult to maintain the list of | ||
| 37 | packages that Org itself would like to call, for example for the special | ||
| 38 | symbol support it needs. | ||
| 39 | |||
| 40 | First of all, you can *opt out of this change* in the following way: You | ||
| 41 | can say: /I want to have full control over headers, and I will take | ||
| 42 | responsibility to include the packages Org needs/. If that is what you | ||
| 43 | want, add this to your configuration and skip the rest of this section | ||
| 44 | (except maybe for the description of the =[EXTRA]= place holder): | ||
| 45 | |||
| 46 | #+begin_src emacs-lisp | ||
| 47 | (setq org-export-latex-default-packages-alist nil | ||
| 48 | org-export-latex-packages-alist nil) | ||
| 49 | #+end_src | ||
| 50 | |||
| 51 | /Continue to read here if you want to go along with the modified setup./ | ||
| 52 | |||
| 53 | There are now two variables that should be used to list the LaTeX | ||
| 54 | packages that need to be included in all classes. The header definition | ||
| 55 | in =org-export-latex-classes= should then not contain the corresponding | ||
| 56 | =\usepackage= calls (see below). | ||
| 57 | |||
| 58 | The two new variables are: | ||
| 59 | |||
| 60 | 1. =org-export-latex-default-packages-alist= :: This is the variable | ||
| 61 | where Org-mode itself puts the packages it needs. Normally you | ||
| 62 | should not change this variable. The only reason to change it | ||
| 63 | anyway is when one of these packages causes a conflict with another | ||
| 64 | package you want to use. Then you can remove that packages and | ||
| 65 | hope that you are not using Org-mode functionality that needs it. | ||
| 66 | |||
| 67 | 2. =org-export-latex-packages-alist= :: This is the variable where you | ||
| 68 | can put the packages that you'd like to use across all classes. | ||
| 69 | |||
| 70 | The sequence how these customizations will show up in the LaTeX | ||
| 71 | document are: | ||
| 72 | |||
| 73 | 1. Header from =org-export-latex-classes= | ||
| 74 | 2. =org-export-latex-default-packages-alist= | ||
| 75 | 3. =org-export-latex-packages-alist= | ||
| 76 | 4. Buffer-specific things set with =#+LaTeX_HEADER:= | ||
| 77 | |||
| 78 | If you want more control about which segment is placed where, or if you | ||
| 79 | want, for a specific class, have full control over the header and | ||
| 80 | exclude some of the automatic building blocks, you can put the following | ||
| 81 | macro-like place holders into the header: | ||
| 82 | |||
| 83 | #+begin_example | ||
| 84 | [DEFAULT-PACKAGES] \usepackage statements for default packages | ||
| 85 | [NO-DEFAULT-PACKAGES] do not include any of the default packages | ||
| 86 | [PACKAGES] \usepackage statements for packages | ||
| 87 | [NO-PACKAGES] do not include the packages | ||
| 88 | [EXTRA] the stuff from #+LaTeX_HEADER | ||
| 89 | [NO-EXTRA] do not include #+LaTeX_HEADER stuff | ||
| 90 | #+end_example | ||
| 91 | |||
| 92 | If you have currently customized =org-export-latex-classes=, you should | ||
| 93 | revise that customization and remove any package calls that are covered | ||
| 94 | by =org-export-latex-default-packages-alist=. This applies to the | ||
| 95 | following packages: | ||
| 96 | |||
| 97 | - inputenc | ||
| 98 | - fontenc | ||
| 99 | - fixltx2e | ||
| 100 | - graphicx | ||
| 101 | - longtable | ||
| 102 | - float | ||
| 103 | - wrapfig | ||
| 104 | - soul | ||
| 105 | - t1enc | ||
| 106 | - textcomp | ||
| 107 | - marvosym | ||
| 108 | - wasysym | ||
| 109 | - latexsym | ||
| 110 | - amssymb | ||
| 111 | - hyperref | ||
| 112 | |||
| 113 | If one of these packages creates a conflict with another package you are | ||
| 114 | using, you can remove it from =org-export-latex-default-packages-alist=. | ||
| 115 | But then you risk that some of the advertised export features of Org | ||
| 116 | will not work properly. | ||
| 117 | |||
| 118 | You can also consider moving packages that you use in all classes to | ||
| 119 | =org-export-latex-packages-alist=. If necessary, put the place holders | ||
| 120 | so that the packages get loaded in the right sequence. As said above, | ||
| 121 | for backward compatibility, if you omit the place holders, all the | ||
| 122 | variables will dump their content at the end of the header. | ||
| 123 | |||
| 124 | ** The constant =org-html-entities= is obsolete | ||
| 125 | :PROPERTIES: | ||
| 126 | :OrgVersion: 6.35 | ||
| 127 | :END: | ||
| 128 | |||
| 129 | Its content is now part of the new constant =org-entities=, which is | ||
| 130 | defined in the file org-entities.el. =org-html-entities= was an internal | ||
| 131 | variable, but it is possible that some users did write code using it. | ||
| 132 | |||
| 133 | ** `org-bbdb-anniversary-format-alist' has changed | ||
| 134 | :PROPERTIES: | ||
| 135 | :OrgVersion: 7.5 | ||
| 136 | :END: | ||
| 137 | |||
| 138 | Please check the docstring and update your settings accordingly. | ||
| 139 | |||
| 140 | ** Deleted =org-mode-p= | ||
| 141 | :PROPERTIES: | ||
| 142 | :OrgVersion: 7.8 | ||
| 143 | :END: | ||
| 144 | |||
| 145 | This function has been deleted: please update your code. | ||
| 146 | |||
| 147 | * Important new features | ||
| 148 | |||
| 149 | ** New Org to ODT exporter | ||
| 150 | :PROPERTIES: | ||
| 151 | :OrgVersion: 7.8 | ||
| 152 | :END: | ||
| 153 | |||
| 154 | Jambunathan's Org to ODT exporter is now part of Org. | ||
| 155 | |||
| 156 | To use it, it `C-c C-e o' in an Org file. See the documentation for more | ||
| 157 | information on how to customize it. | ||
| 158 | |||
| 159 | ** org-capture.el is now the default capture system | ||
| 160 | :PROPERTIES: | ||
| 161 | :OrgVersion: 7.01 | ||
| 162 | :END: | ||
| 163 | |||
| 164 | This replaces the earlier system org-remember. The manual only describes | ||
| 165 | org-capture, but for people who prefer to continue to use org-remember, | ||
| 166 | we keep a static copy of the former manual section [[http://orgmode.org/org-remember.pdf][chapter about | ||
| 167 | remember]]. | ||
| 168 | |||
| 169 | The new system has a technically cleaner implementation and more | ||
| 170 | possibilities for capturing different types of data. See [[http://thread.gmane.org/gmane.emacs.orgmode/26441/focus%3D26441][Carsten's | ||
| 171 | announcement]] for more details. | ||
| 172 | |||
| 173 | To switch over to the new system: | ||
| 174 | |||
| 175 | 1. Run | ||
| 176 | |||
| 177 | : M-x org-capture-import-remember-templates RET | ||
| 178 | |||
| 179 | to get a translated version of your remember templates into the | ||
| 180 | new variable =org-capture-templates=. This will "mostly" work, | ||
| 181 | but maybe not for all cases. At least it will give you a good | ||
| 182 | place to modify your templates. After running this command, | ||
| 183 | enter the customize buffer for this variable with | ||
| 184 | |||
| 185 | : M-x customize-variable RET org-capture-templates RET | ||
| 186 | 9 | ||
| 187 | and convince yourself that everything is OK. Then save the | 10 | ** New ELPA repository for Org packages |
| 188 | customization. | ||
| 189 | 11 | ||
| 190 | 2. Bind the command =org-capture= to a key, similar to what you did | 12 | You can now add the Org ELPA repository like this: |
| 191 | with org-remember: | ||
| 192 | 13 | ||
| 193 | : (define-key global-map "\C-cc" 'org-capture) | 14 | #+BEGIN_SRC emacs-lisp |
| 15 | (add-to-list 'package-archives '("org" . "http://orgmode.org/elpa/") t) | ||
| 16 | #+END_SRC | ||
| 194 | 17 | ||
| 195 | If your fingers prefer =C-c r=, you can also use this key once | 18 | It contains both the =org-*.tar= package (the core Org distribution, also |
| 196 | you have decided to move over completely to the new | 19 | available through http://elpa.gnu.org) and the =org-plus*.tar= package (the |
| 197 | implementation. During a test time, there is nothing wrong | 20 | extended Org distribution, with non-GNU packages from the =contrib/= |
| 198 | with using both system in parallel. | 21 | directory.) |
| 199 | 22 | ||
| 200 | * New libraries | 23 | See http://orgmode.org/elpa/ |
| 201 | 24 | ||
| 202 | ** New Org libraries | 25 | ** Overview of the new keybindings |
| 203 | *** org-eshell.el (Konrad Hinsen) | ||
| 204 | :PROPERTIES: | ||
| 205 | :OrgVersion: 7.8 | ||
| 206 | :END: | ||
| 207 | 26 | ||
| 208 | Implement links to eshell buffers. | 27 | | Keybinding | Speedy | Command | |
| 28 | |-----------------+--------+-----------------------------| | ||
| 29 | | =C-c C-x C-z= | | [[doc::org-clock-resolve][org-clock-resolve]] | | ||
| 30 | | =C-c C-x C-q= | | [[doc::org-clock-cancel][org-clock-cancel]] | | ||
| 31 | | =C-c C-x C-x= | | [[doc::org-clock-in-last][org-clock-in-last]] | | ||
| 32 | | =M-h= | | [[doc::org-mark-element][org-mark-element]] | | ||
| 33 | | =*= | | [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]] | | ||
| 34 | | =C-c C-M-l= | | [[doc::org-insert-all-links][org-insert-all-links]] | | ||
| 35 | | =C-c C-x C-M-v= | | [[doc::org-redisplay-inline-images][org-redisplay-inline-images]] | | ||
| 36 | | =C-c C-x E= | =E= | [[doc::org-inc-effort][org-inc-effort]] | | ||
| 37 | | | =#= | [[doc::org-toggle-comment][org-toggle-comment]] | | ||
| 38 | | | =:= | [[doc::org-columns][org-columns]] | | ||
| 39 | | | =W= | Set =APPT_WARNTIME= | | ||
| 40 | | =k= | | [[doc::org-agenda-capture][org-agenda-capture]] | | ||
| 41 | | C-c , | , | [[doc::org-priority][org-priority]] | | ||
| 209 | 42 | ||
| 210 | *** org-special-blocks (Carsten Dominik) | 43 | ** New package and Babel langage |
| 211 | :PROPERTIES: | ||
| 212 | :OrgVersion: 7.8 | ||
| 213 | :END: | ||
| 214 | 44 | ||
| 215 | This package generalizes the #+begin_foo and #+end_foo tokens. | 45 | *** =org-eshell.el= by Konrad Hinsen is now in Org |
| 216 | 46 | ||
| 217 | To use, put the following in your init file: | 47 | =org-eshell.el= allows you to create links from [[http://www.gnu.org/software/emacs/manual/html_node/eshell/index.html][Eshell]]. |
| 218 | 48 | ||
| 219 | #+BEGIN_EXAMPLE | 49 | *** Support for execution of Scala code blocks (see ob-scala.el) |
| 50 | *** Support for execution of IO code blocks (see ob-io.el) | ||
| 51 | |||
| 52 | ** Incompatible changes | ||
| 53 | |||
| 54 | - If your code relies on =org-write-agenda=, please use | ||
| 55 | [[doc::org-agenda-write][org-agenda-write]] from now on. | ||
| 56 | |||
| 57 | - If your code relies on =org-make-link=, please use =concat= | ||
| 58 | instead. | ||
| 59 | |||
| 60 | - =org-link-to-org-use-id= has been renamed to | ||
| 61 | =org-id-link-to-org-use-id= and its default value is nil. The | ||
| 62 | previous default was =create-if-interactive-and-no-custom-id=. | ||
| 63 | |||
| 64 | ** New features and user-visible changes | ||
| 65 | |||
| 66 | *** Org Element | ||
| 67 | |||
| 68 | =org-element.el= is a toolbox for parsing and analysing "elements" | ||
| 69 | in an Org-mode buffer. This has been written by Nicolas Goaziou | ||
| 70 | and has been tested for quite some time. It is now part of Org's | ||
| 71 | core and many core functions rely on this package. | ||
| 72 | |||
| 73 | Two functions might be particularily handy for users: | ||
| 74 | =org-element-at-point= and =org-element-context=. | ||
| 75 | |||
| 76 | See the docstrings for more details. | ||
| 77 | |||
| 78 | Below is a list of editing and navigating commands that now rely | ||
| 79 | on =org-element.el=. | ||
| 80 | |||
| 81 | **** [[doc::org-fill-paragraph][org-fill-paragraph]] has been completely rewritten | ||
| 82 | |||
| 83 | The filling mechanisms now rely on org-element, trying to do the | ||
| 84 | right thing on each element in various contexts. E.g. filling in | ||
| 85 | a list item will preserve indentation; filling in message-mode | ||
| 86 | will fall back on the relevant filling functions; etc. | ||
| 87 | |||
| 88 | **** [[doc::org-metaup][org-metaup]] and [[doc::org-metadown][org-metadown]] will drag the element backward/forward | ||
| 89 | |||
| 90 | If you want to get the old behavior (i.e. moving a line up and | ||
| 91 | down), you can first select the line as an active region, then | ||
| 92 | =org-metaup= or =org-metadown= to move the region backward or | ||
| 93 | forward. This also works with regions bigger than just one line. | ||
| 94 | |||
| 95 | **** [[doc::org-up-element][org-up-element]] and [[doc::org-down-element][org-down-element]] (respectively =C-c C-^= and =C-c C-_=) | ||
| 96 | |||
| 97 | This will move the point up/down in the hierarchy of elements. | ||
| 98 | |||
| 99 | **** [[doc::org-backward-element][org-backward-element]] and [[doc::org-forward-element][org-forward-element]] (respectively =M-{= and =M-}=) | ||
| 100 | |||
| 101 | This will move the point backward/forward in the hierarchy of | ||
| 102 | elements. | ||
| 103 | |||
| 104 | **** [[doc::org-narrow-to-element][org-narrow-to-element]] will narrow to the element at point | ||
| 105 | **** [[doc::org-mark-element][org-mark-element]] will mark the element at point | ||
| 106 | |||
| 107 | This command is bound to =M-h= and will mark the element at | ||
| 108 | point. If the point is at a paragraph, it will mark the | ||
| 109 | paragraph. If the point is at a list item, it will mark the list | ||
| 110 | item. Etc. | ||
| 111 | |||
| 112 | Note that if point is at the beginning of a list, it will mark | ||
| 113 | the whole list. | ||
| 114 | |||
| 115 | To mark a subtree, you can either use =M-h= on the headline | ||
| 116 | (since there is no ambiguity about the element you're at) or | ||
| 117 | [[doc::org-mark-subtree][org-mark-subtree]] (=C-c @=) anywhere in the subtree. | ||
| 118 | |||
| 119 | Invoking [[doc::org-mark-element][org-mark-element]] repeatedly will try to mark the next | ||
| 120 | element on top of the previous one(s). E.g. hitting =M-h= twice | ||
| 121 | on a headline will mark the current subtree and the next one on | ||
| 122 | the same level. | ||
| 123 | |||
| 124 | *** Org Agenda | ||
| 125 | |||
| 126 | **** New option [[doc::org-agenda-sticky][org-agenda-sticky]] | ||
| 127 | |||
| 128 | There is a new option =org-agenda-sticky= which enables "sticky" | ||
| 129 | agendas. Sticky agendas remain opened in the background so that | ||
| 130 | you don't need to regenerate them each time you hit the | ||
| 131 | corresponding keystroke. This is a big time saver. | ||
| 132 | |||
| 133 | When [[doc::org-agenda-sticky][org-agenda-sticky]] is =non-nil=, the agenda buffer will be | ||
| 134 | named using the agenda key and its description. In sticky | ||
| 135 | agendas, the =q= key will just bury the agenda buffers and | ||
| 136 | further agenda commands will show existing buffer instead of | ||
| 137 | generating new ones. | ||
| 138 | |||
| 139 | If [[doc::org-agenda-sticky][org-agenda-sticky]] is set to =nil=, =q= will kill the single | ||
| 140 | agenda buffer. | ||
| 141 | |||
| 142 | **** New option [[doc::org-agenda-custom-commands-contexts][org-agenda-custom-commands-contexts]] | ||
| 143 | |||
| 144 | Setting this option allows you to define specific context where | ||
| 145 | agenda commands should be available from. For example, when set | ||
| 146 | to this value | ||
| 147 | |||
| 148 | #+BEGIN_SRC emacs-lisp | ||
| 149 | (setq org-agenda-custom-commands-contexts | ||
| 150 | '(("p" (in-file . "\\.txt")))) | ||
| 151 | #+END_SRC | ||
| 152 | |||
| 153 | then the =p= agenda command will only be available from buffers | ||
| 154 | visiting *.txt files. See the docstring and the manual for more | ||
| 155 | details on how to use this. | ||
| 156 | |||
| 157 | **** Changes in bulk actions | ||
| 158 | |||
| 159 | The set of commands starting with =k ...= as been deleted and the | ||
| 160 | features have been merged into the "bulk action" feature. | ||
| 161 | |||
| 162 | After you marked some entries in the agenda, if you call =B s=, | ||
| 163 | the agenda entries will be rescheduled using the date at point if | ||
| 164 | on a date header. If you are on an entry with a timestamp, you | ||
| 165 | will be prompted for a date to reschedule your marked entries to, | ||
| 166 | using the timestamp at point as the default prompt. | ||
| 167 | |||
| 168 | You can now use =k= to capture the marked entry and use the date | ||
| 169 | at point as an overriding date for the capture template. | ||
| 170 | |||
| 171 | To bind this behavior to =M-x org-capture RET= (or its | ||
| 172 | keybinding), set the new option [[doc::org-capture-use-agenda-date][org-capture-use-agenda-date]] to | ||
| 173 | =t=. | ||
| 174 | |||
| 175 | **** =N= and =P= in the agenda will move to the next/previous item | ||
| 176 | |||
| 177 | **** New command [[doc::org-agenda-bulk-mark-all][org-agenda-bulk-mark-all]] to mark all items | ||
| 178 | |||
| 179 | This new command is bound to =*= in agenda mode. | ||
| 180 | |||
| 181 | There is also a new option [[doc::org-agenda-bulk-mark-char][org-agenda-bulk-mark-char]] to set the | ||
| 182 | character to use as a mark for bulk actions. | ||
| 183 | |||
| 184 | **** New option [[doc::org-agenda-persistent-marks][org-agenda-persistent-marks]] | ||
| 185 | |||
| 186 | When set to =non-nil=, marks will remain visible after a bulk | ||
| 187 | action. You can temporarily toggle this by pressing =p= when | ||
| 188 | invoking [[doc::org-agenda-bulk-action][org-agenda-bulk-action]]. Marks are deleted if your | ||
| 189 | rebuild the agenda buffer or move to another date/span (e.g. with | ||
| 190 | =f= or =w=). | ||
| 191 | |||
| 192 | **** New option [[doc::org-agenda-skip-timestamp-if-deadline-is-shown][org-agenda-skip-timestamp-if-deadline-is-shown]] | ||
| 193 | |||
| 194 | =Non-nil= means skip timestamp line if same entry shows because | ||
| 195 | of deadline. | ||
| 196 | |||
| 197 | In the agenda of today, an entry can show up multiple times | ||
| 198 | because it has both a plain timestamp and has a nearby deadline. | ||
| 199 | When this variable is t, then only the deadline is shown and the | ||
| 200 | fact that the entry has a timestamp for or including today is not | ||
| 201 | shown. When this variable is =nil=, the entry will be shown | ||
| 202 | several times. | ||
| 203 | |||
| 204 | **** New =todo-unblocked= and =nottodo-unblocked= skip conditions | ||
| 205 | |||
| 206 | See the [[http://orgmode.org/w/?p%3Dorg-mode.git%3Ba%3Dcommit%3Bh%3Df426da][git commit]] for more explanations. | ||
| 207 | |||
| 208 | **** Allow category filtering in the agenda | ||
| 209 | |||
| 210 | You can now filter the agenda by category. Pressing "<" will | ||
| 211 | filter by the category of the item on the current line, and | ||
| 212 | pressing "<" again will remove the filter. You can combine tag | ||
| 213 | filters and category filters. | ||
| 214 | |||
| 215 | You can use =org-agenda-category-filter= in your custom agenda | ||
| 216 | views and =org-agenda-category-filter-preset= in your main | ||
| 217 | configuration. | ||
| 218 | |||
| 219 | See also the new command [[doc::org-agenda-filter-by-top-category][org-agenda-filter-by-top-category]]: | ||
| 220 | hitting =^= will filter by "Top" category: only show entries that | ||
| 221 | are of the same category than the Top category of the entry at | ||
| 222 | point. | ||
| 223 | |||
| 224 | *** Org Links | ||
| 225 | |||
| 226 | **** Inserting links | ||
| 227 | |||
| 228 | When inserting links through [[doc::org-insert-link][org-insert-link]], the description is | ||
| 229 | now displayed first, followed by the literal link, as the | ||
| 230 | description is often more useful when you look for the link you | ||
| 231 | want to insert. | ||
| 232 | |||
| 233 | Completion now complete both literal links and description. If | ||
| 234 | you complete a description, the literal link and its description | ||
| 235 | will be inserted directly, whereas when you complete the literal | ||
| 236 | link, you will be prompted for a description (as with Org 7.8.) | ||
| 237 | |||
| 238 | In the completion buffer, links to the current buffer are now | ||
| 239 | highlighted. | ||
| 240 | |||
| 241 | **** New templates =%h= and =%(sexp)= for abbreviated links | ||
| 242 | |||
| 243 | On top of =%s= template, which is replaced by the link tag in | ||
| 244 | abbreviated links, you can now use =%h= (which does the same than =%s= | ||
| 245 | but does not hexify the tag) and =%(sexp)= (which can run a function | ||
| 246 | that takes the tag as its own argument.) | ||
| 247 | |||
| 248 | **** New link type =help= | ||
| 249 | |||
| 250 | You can now create links from =help= buffers. | ||
| 251 | |||
| 252 | For example, if you request help for the command [[doc::org-agenda][org-agenda]] with | ||
| 253 | =C-h f org-agenda RET=, creating a link from this buffer will let | ||
| 254 | you go back to the same buffer. | ||
| 255 | |||
| 256 | **** New command [[doc::org-insert-all-links][org-insert-all-links]] | ||
| 257 | |||
| 258 | This will insert all links as list items. With a universal | ||
| 259 | prefix argument, links will not be deleted from the variable | ||
| 260 | =org-stored-links=. | ||
| 261 | |||
| 262 | This new command is bound to =C-c C-M-l=. | ||
| 263 | |||
| 264 | **** New option [[doc::org-url-hexify-p][org-url-hexify-p]] | ||
| 265 | |||
| 266 | When set to =nil=, the =URL= part of a link will not be hexified. | ||
| 267 | |||
| 268 | **** Org can now open multiple shell links | ||
| 269 | |||
| 270 | **** New option [[doc::org-doi-server-url][org-doi-server-url]] to specify an alternate DOI server | ||
| 271 | |||
| 272 | **** RET now follows time stamps links | ||
| 273 | |||
| 274 | *** Org Editing | ||
| 275 | |||
| 276 | **** [[doc::org-todo][org-todo]] and =org-archive-*= can now loop in the active region | ||
| 277 | |||
| 278 | When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, using | ||
| 279 | [[doc::org-todo][org-todo]] or =org-archive-*= commands in the active region will | ||
| 280 | loop over headlines. This is handy if you want to set the TODO | ||
| 281 | keyword for several items, or archive them quickly. | ||
| 282 | |||
| 283 | **** You can now set tags for headlines in a region | ||
| 284 | |||
| 285 | If [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is =non-nil=, then | ||
| 286 | selecting the region and hitting =C-c C-q= will set the tags for | ||
| 287 | all headlines in the region. | ||
| 288 | |||
| 289 | **** New command [[doc::org-insert-drawer][org-insert-drawer]] to insert a drawer interactively | ||
| 290 | |||
| 291 | **** Comments start with "^[ \t]*# " anywhere on a line | ||
| 292 | |||
| 293 | Note that the space after the hashtag is mandatory. Comments | ||
| 294 | with "^#+" are not supported anymore. | ||
| 295 | |||
| 296 | **** New speed key =#= to toggle the COMMENT cookie on a headline | ||
| 297 | |||
| 298 | **** =indent-region-function= is now set to [[doc::org-indent-region][org-indent-region]] | ||
| 299 | |||
| 300 | =C-M-\= should now produce useful results. | ||
| 301 | |||
| 302 | You can unindent the buffer with [[doc::org-unindent-buffer][org-unindent-buffer]]. | ||
| 303 | |||
| 304 | **** New option [[doc::org-allow-promoting-top-level-subtree][org-allow-promoting-top-level-subtree]] | ||
| 305 | |||
| 306 | When =non-nil=, =S-M-<left>= will promote level-1 subtrees | ||
| 307 | containing other subtrees. The level-1 headline will be | ||
| 308 | commented out. You can revert to the previous state with =M-x | ||
| 309 | undo RET=. | ||
| 310 | |||
| 311 | *** Org Clock | ||
| 312 | |||
| 313 | **** New keybinding =C-c C-x C-z= for [[doc::org-clock-resolve][org-clock-resolve]] | ||
| 314 | |||
| 315 | **** New keybinding =C-c C-x C-q= for [[doc::org-clock-cancel][org-clock-cancel]] | ||
| 316 | |||
| 317 | **** New command [[doc::org-clock-in-last][org-clock-in-last]] to clock in the last clocked item | ||
| 318 | |||
| 319 | This command is bound to =C-c C-x C-x= and will clock in the last | ||
| 320 | clocked entry, if any. | ||
| 321 | |||
| 322 | **** =C-u M-x= [[doc::org-clock-out][org-clock-out]] =RET= now prompts for a state to switch to | ||
| 323 | |||
| 324 | **** =S-M-<up/down>= on a clock timestamps adjusts the previous/next clock | ||
| 325 | |||
| 326 | **** New option [[doc::org-clock-continuously][org-clock-continuously]] | ||
| 327 | |||
| 328 | When set to =nil=, clocking in a task will first try to find the | ||
| 329 | last clocked out task and restart from when that task was clocked | ||
| 330 | out. | ||
| 331 | |||
| 332 | You can temporarily activate continuous clocking with =C-u C-u | ||
| 333 | C-u M-x= [[doc::org-clock-in][org-clock-in]] =RET= (three universal prefix arguments) | ||
| 334 | and =C-u C-u M-x= [[org-clock-in-last][org-clock-in-last]] =RET= (two universal prefix | ||
| 335 | arguments). | ||
| 336 | |||
| 337 | |||
| 338 | **** New option [[doc::org-clock-frame-title-format][org-clock-frame-title-format]] | ||
| 339 | |||
| 340 | This option sets the value of =frame-title-format= when clocking | ||
| 341 | in. | ||
| 342 | |||
| 343 | **** New options for controlling the clockreport display | ||
| 344 | |||
| 345 | [[doc::org-clock-file-time-cell-format][org-clock-file-time-cell-format]]: Format string for the file time | ||
| 346 | cells in clockreport. | ||
| 347 | |||
| 348 | [[doc::org-clock-total-time-cell-format][org-clock-total-time-cell-format]]: Format string for the total | ||
| 349 | time cells in clockreport. | ||
| 350 | |||
| 351 | |||
| 352 | **** New options for controlling the clock/timer display | ||
| 353 | |||
| 354 | [[doc::org-clock-clocked-in-display][org-clock-clocked-in-display]]: control whether the current clock | ||
| 355 | is displayed in the mode line and/or frame title. | ||
| 356 | |||
| 357 | [[doc::org-timer-display][org-timer-display]]: control whether the current timer is displayed | ||
| 358 | in the mode line and/or frame title. | ||
| 359 | |||
| 360 | This allows the clock and timer to be displayed in the frame | ||
| 361 | title instead of, or as well as, the mode line. This is useful | ||
| 362 | for people with limited space in the mode line but with ample | ||
| 363 | space in the frame title. | ||
| 364 | |||
| 365 | *** Org Appearance | ||
| 366 | |||
| 367 | **** New option [[doc::org-custom-properties][org-custom-properties]] | ||
| 368 | |||
| 369 | The visibility of properties listed in this options can be turn | ||
| 370 | on/off with [[doc::org-toggle-custom-properties-visibility][org-toggle-custom-properties-visibility]]. This might | ||
| 371 | be useful for properties used by third-part tools or that you | ||
| 372 | don't want to see temporarily. | ||
| 373 | |||
| 374 | **** New command [[doc::org-redisplay-inline-images][org-redisplay-inline-images]] | ||
| 375 | |||
| 376 | This will redisplay all images. It is bound to =C-c C-x C-M-v=. | ||
| 377 | |||
| 378 | **** New entities in =org-entities.el= | ||
| 379 | |||
| 380 | There are these new entities: | ||
| 381 | |||
| 382 | : ("tilde" "\\~{}" nil "˜" "~" "~" "~") | ||
| 383 | : ("slash" "/" nil "/" "/" "/" "/") | ||
| 384 | : ("plus" "+" nil "+" "+" "+" "+") | ||
| 385 | : ("under" "\\_" nil "_" "_" "_" "_") | ||
| 386 | : ("equal" "=" nil "=" "=" "=" "=") | ||
| 387 | : ("asciicirc" "\\textasciicircum{}" nil "^" "^" "^" "^") | ||
| 388 | |||
| 389 | **** New face =org-list-dt= for definition terms | ||
| 390 | **** New face =org-date-selected= for the selected calendar day | ||
| 391 | **** New face value for =org-document-title= | ||
| 392 | |||
| 393 | The face is back to a normal height. | ||
| 394 | |||
| 395 | *** Org Columns | ||
| 396 | |||
| 397 | **** New speed command =:= to activate the column view | ||
| 398 | **** New special property =CLOCKSUM_T= to display today's clocked time | ||
| 399 | |||
| 400 | You can use =CLOCKSUM_T= the same way you use =CLOCKSUM=. It | ||
| 401 | will display the time spent on tasks for today only. | ||
| 402 | |||
| 403 | **** Use the =:COLUMNS:= property in columnview dynamic blocks | ||
| 404 | |||
| 405 | If the =:COLUMNS:= is set in a subtree, the columnview dynamic | ||
| 406 | block will use its value as the column format. | ||
| 407 | |||
| 408 | **** Consider inline tasks when computing a sum | ||
| 409 | |||
| 410 | *** Org Dates and Time Stamps | ||
| 411 | |||
| 412 | **** Enhanced [[doc::org-sparse-tree][org-sparse-tree]] | ||
| 413 | |||
| 414 | =C-c /= can now check for time ranges. | ||
| 415 | |||
| 416 | When checking for dates with =C-c /= it is useful to change the | ||
| 417 | type of dates that you are interested in. You can now do this | ||
| 418 | interactively with =c= after =C-c /= and/or by setting | ||
| 419 | [[doc::org-sparse-tree-default-date-type][org-sparse-tree-default-date-type]] to the default value you want. | ||
| 420 | |||
| 421 | **** Support for hourly repeat cookies | ||
| 422 | |||
| 423 | You can now use | ||
| 424 | |||
| 425 | : SCHEDULED: <2012-08-20 lun. 08:00 +1h> | ||
| 426 | |||
| 427 | if you want to add an hourly repeater to an entry. | ||
| 428 | |||
| 429 | **** =C-u C-u C-c .= inserts a time-stamp with no prompt | ||
| 430 | |||
| 431 | **** When (setq [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] 'time), accept days in the prompt | ||
| 432 | |||
| 433 | "8am Wed" and "Wed 8am" are now acceptable values when entering a | ||
| 434 | date from the prompt. If [[doc::org-read-date-prefer-future][org-read-date-prefer-future]] is set to | ||
| 435 | =time=, this will produce the expected prompt indication. | ||
| 436 | |||
| 437 | **** New option [[doc::org-datetree-add-timestamp][org-datetree-add-timestamp]] | ||
| 438 | |||
| 439 | When set to =non-nil=, datetree entries will also have a | ||
| 440 | timestamp. This is useful if you want to see these entries in a | ||
| 441 | sparse tree with =C-c /=. | ||
| 442 | |||
| 443 | *** Org Capture | ||
| 444 | |||
| 445 | **** New command [[doc::org-capture-string][org-capture-string]] | ||
| 446 | |||
| 447 | M-x [[doc::org-capture-string][org-capture-string]] RET will prompt for a string and a capture | ||
| 448 | template. The string will be used as an annotation for the | ||
| 449 | template. This is useful when capturing in batch mode as it lets | ||
| 450 | you define the content of the template without being in Emacs. | ||
| 451 | |||
| 452 | **** New option [[doc::org-capture-templates-contexts][org-capture-templates-contexts]] | ||
| 453 | |||
| 454 | Setting this option allows you to define specific context where | ||
| 455 | capture templates should be available from. For example, when | ||
| 456 | set to this value | ||
| 457 | |||
| 458 | #+BEGIN_SRC emacs-lisp | ||
| 459 | (setq org-capture-templates-contexts | ||
| 460 | '(("c" (in-mode . "message-mode")))) | ||
| 461 | #+END_SRC | ||
| 462 | |||
| 463 | then the =c= capture template will only be available from | ||
| 464 | =message-mode= buffers. See the docstring and the manual for | ||
| 465 | more details on how to use this. | ||
| 466 | |||
| 467 | **** New =%l= template to insert the literal link | ||
| 468 | **** New option [[doc::org-capture-bookmark][org-capture-bookmark]] | ||
| 469 | |||
| 470 | Org used to automatically add a bookmark with capture a note. | ||
| 471 | You can now turn this on by setting [[doc::org-capture-bookmark][org-capture-bookmark]] to | ||
| 472 | =nil=. | ||
| 473 | |||
| 474 | **** Expand =%<num>= escape sequences into text entered for <num>'th =%^{PROMPT}= escape | ||
| 475 | |||
| 476 | See the manual for more explanations. | ||
| 477 | |||
| 478 | **** More control over empty lines | ||
| 479 | |||
| 480 | You can use =:empty-lines-before= and =:empty-lines-after= to | ||
| 481 | control the insertion of empty lines. Check the manual for more | ||
| 482 | explanations. | ||
| 483 | |||
| 484 | **** New hook [[doc::org-capture-prepare-finalize-hook][org-capture-prepare-finalize-hook]] | ||
| 485 | |||
| 486 | This new hook runs before the finalization process starts. | ||
| 487 | |||
| 488 | *** Org Export | ||
| 489 | |||
| 490 | **** New functions =orgtbl-to-table.el= and =orgtbl-to-unicode= | ||
| 491 | |||
| 492 | =orgtbl-to-table.el= convert the table to a =table.el= table, and | ||
| 493 | =orgtbl-to-unicode= will use =ascii-art-to-unicode.el= (when | ||
| 494 | available) to print beautiful tables. | ||
| 495 | |||
| 496 | **** [[doc::org-table-export][org-table-export]] now a bit clever about the target format | ||
| 497 | |||
| 498 | When you specify a file name like =table.csv=, [[doc::org-table-export][org-table-export]] | ||
| 499 | will now suggest =orgtbl-to-csv= the default method for exporting | ||
| 500 | the table. | ||
| 501 | |||
| 502 | **** New option [[doc::org-export-date-timestamp-format][org-export-date-timestamp-format]] | ||
| 503 | |||
| 504 | The option allows to set a time string format for Org timestamps | ||
| 505 | in the #+DATE option. | ||
| 506 | |||
| 507 | **** LaTeX: New options for exporting table rules :tstart, :hline and :tend | ||
| 508 | |||
| 509 | See [[doc::org-export-latex-tables-hline][org-export-latex-tables-hline]] and [[doc::org-export-latex-tables-tend][org-export-latex-tables-tend]]. | ||
| 510 | |||
| 511 | **** LaTeX: You can now set =:hfmt= from =#+ATTR_LaTeX= | ||
| 512 | **** Beamer: Add support and keybinding for the =exampleblock= environment | ||
| 513 | |||
| 514 | Add support for these languages in [[doc::org-export-language-setup][org-export-language-setup]]. | ||
| 515 | More languages are always welcome. | ||
| 516 | |||
| 517 | **** Beamer: New option [[doc::org-beamer-inherited-properties][org-beamer-inherited-properties]] | ||
| 518 | |||
| 519 | This option allows Beamer export to inherit some properties. | ||
| 520 | Thanks to Carsten for implementing this. | ||
| 521 | |||
| 522 | **** ODT: Add support for ODT export in org-bbdb.el | ||
| 523 | **** ODT: Add support for indented tables (see [[http://orgmode.org/w/?p%3Dorg-mode.git%3Ba%3Dcommit%3Bh%3De9fd33][this commit]] for details) | ||
| 524 | **** ODT: Improve the conversion from ODT to other formats | ||
| 525 | **** ASCII: Swap the level-1/level-2 characters to underline the headlines | ||
| 526 | **** Support for Chinese, simplified Chinese, Russian, Ukrainian and Japanese | ||
| 527 | **** HTML: New option [[doc::org-export-html-date-format-string][org-export-html-date-format-string]] | ||
| 528 | |||
| 529 | Format string to format the date and time in HTML export. Thanks | ||
| 530 | to Sébastien Vauban for this patch. | ||
| 531 | |||
| 532 | *** Org Babel | ||
| 533 | |||
| 534 | **** New =:results drawer= parameter | ||
| 535 | |||
| 536 | =:results drawer= replaces =:results wrap=, which is deprecated but still | ||
| 537 | supported. | ||
| 538 | |||
| 539 | **** =:results org= now put results in a =#+BEGIN_SRC org= block | ||
| 540 | |||
| 541 | =:results org= used to put results in a =#+BEGIN_ORG= block but it now puts | ||
| 542 | results in a =#+BEGIN_SRC org= block, wich comma-escaped lines. | ||
| 543 | |||
| 544 | =#+BEGIN_ORG= blocks are obsolete. | ||
| 545 | |||
| 546 | **** Exporting =#+BEGIN_SRC org= blocks exports the code | ||
| 547 | |||
| 548 | It used to exports the results of the code. | ||
| 549 | |||
| 550 | *** Miscellaneous | ||
| 551 | |||
| 552 | **** New menu entry for [[doc::org-refile][org-refile]] | ||
| 553 | **** Allow capturing to encrypted entries | ||
| 554 | |||
| 555 | If you capture to an encrypted entry, it will be decrpyted before | ||
| 556 | inserting the template then re-encrypted after finalizing the capture. | ||
| 557 | |||
| 558 | **** Inactive timestamps are now handled in tables | ||
| 559 | |||
| 560 | Calc can do computation on active time-stamps like <2012-09-29 sat.>. | ||
| 561 | Inactive time-stamps in a table's cell are now internally deactivated so | ||
| 562 | that Calc formulas can operate on them. | ||
| 563 | |||
| 564 | **** [[doc::org-table-number-regexp][org-table-number-regexp]] can now accept comma as decimal mark | ||
| 565 | **** Org allows a new property =APPT_WARNTIME= | ||
| 566 | |||
| 567 | You can set it with the =W= speedy key or set it manually. When | ||
| 568 | set, exporting to iCalendar and [[doc::org-agenda-to-appt][org-agenda-to-appt]] will use the | ||
| 569 | value of this property as the number of minutes for the warning | ||
| 570 | alarm. | ||
| 571 | |||
| 572 | **** New command [[doc::org-inc-effort][org-inc-effort]] | ||
| 573 | |||
| 574 | This will increment the effort value. | ||
| 575 | |||
| 576 | It is bound to =C-c C-x E= and to =E= as a speedy command. | ||
| 577 | |||
| 578 | **** Attach: Add support for creating symbolic links | ||
| 579 | |||
| 580 | =org-attach-method= now supports a new method =lns=, allowing to | ||
| 581 | attach symbolic links. | ||
| 582 | |||
| 583 | **** Archive: you can now archive to a datetree | ||
| 584 | |||
| 585 | **** New option [[doc::org-inlinetask-show-first-star][org-inlinetask-show-first-star]] | ||
| 586 | |||
| 587 | =Non-nil= means display the first star of an inline task as | ||
| 588 | additional marker. When =nil=, the first star is not shown. | ||
| 589 | |||
| 590 | **** New option [[doc::org-latex-preview-ltxpng-directory][org-latex-preview-ltxpng-directory]] | ||
| 591 | |||
| 592 | This lets you define the path for the =ltxpng/= directory. | ||
| 593 | |||
| 594 | **** You can now use imagemagick instead of dvipng to preview LaTeX fragments | ||
| 595 | **** You can now turn off [[doc::orgstruct++-mode][orgstruct++-mode]] safely | ||
| 596 | **** =C-u C-c C-c= on list items to add check boxes | ||
| 597 | |||
| 598 | =C-u C-c C-c= will add an empty check box on a list item. | ||
| 599 | |||
| 600 | When hit from the top of the list, it will add check boxes for | ||
| 601 | all top level list items. | ||
| 602 | |||
| 603 | **** =org-list-ending-method= and =org-list-end-regexp= are now obsolete | ||
| 604 | |||
| 605 | Fall back on using =org-list-end-re= only, which see. | ||
| 606 | |||
| 607 | **** org-feed.el now expands =%(sexp)= templates | ||
| 608 | **** New option [[doc::org-protocol-data-separator][org-protocol-data-separator]] | ||
| 609 | |||
| 610 | **** New option [[doc::org-ditaa-jar-option][org-ditaa-jar-option]] to specify the ditaa jar file | ||
| 611 | |||
| 612 | **** New possible value for [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] | ||
| 613 | |||
| 614 | When [[doc::org-loop-over-headlines-in-active-region][org-loop-over-headlines-in-active-region]] is set to | ||
| 615 | =start-level=, the command will loop over the active region but | ||
| 616 | will only act upon entries that are of the same level than the | ||
| 617 | first headline in the region. | ||
| 618 | |||
| 619 | **** New option [[doc::org-habit-show-all-today][org-habit-show-all-today]] | ||
| 620 | |||
| 621 | When set to =t=, show all (even unscheduled) habits on today's | ||
| 622 | agenda. | ||
| 623 | |||
| 624 | ** Important bug fixes | ||
| 625 | |||
| 626 | *** M-TAB on options keywords perform completion correctly again | ||
| 627 | |||
| 628 | If you hit =M-TAB= on keywords like =#+TITLE=, Org will try to | ||
| 629 | perform completion with meaningful values. | ||
| 630 | |||
| 631 | *** Add licenses to javascript embedded and external code snippets | ||
| 632 | |||
| 633 | Embedded javascript code produced when exporting an Org file to | ||
| 634 | HTML is now licensed under GPLv3 (or later), and the copyright is | ||
| 635 | owned by the Free Software Foundation, Inc. | ||
| 636 | |||
| 637 | The javascript code for embedding MathJax in the browser mentions | ||
| 638 | the MathJax copyright and the Apache 2.0 license. | ||
| 639 | |||
| 640 | The javascript code for embedding =org-injo.js= in the browser | ||
| 641 | mentions the copyright of Sebastian Rose and the GPLv3 (or later) | ||
| 642 | license. | ||
| 643 | |||
| 644 | =org-export-html-scripts= is now a variable, so that you can adapt | ||
| 645 | the code and the license to your needs. | ||
| 646 | |||
| 647 | See http://www.gnu.org/philosophy/javascript-trap.html for | ||
| 648 | explanations on why these changes were necessary. | ||
| 649 | |||
| 650 | * Version 7.8.11 | ||
| 651 | |||
| 652 | ** Incompatible changes | ||
| 653 | |||
| 654 | *** Emacs 21 support has been dropped | ||
| 655 | |||
| 656 | Do not use Org mode 7.xx with Emacs 21, use [[http://orgmode.org/org-6.36c.zip][version 6.36c]] instead. | ||
| 657 | |||
| 658 | *** XEmacs support requires the XEmacs development version | ||
| 659 | |||
| 660 | To use Org mode 7.xx with XEmacs, you need to run the developer | ||
| 661 | version of XEmacs. We were about to drop XEmacs support entirely, | ||
| 662 | but Michael Sperber stepped in and made changes to XEmacs that | ||
| 663 | made it easier to keep the support. Thanks to Michael for this | ||
| 664 | last-minute save. | ||
| 665 | |||
| 666 | *** New keys for TODO sparse trees | ||
| 667 | |||
| 668 | The key =C-c C-v= is now reserved for Org Babel action. TODO | ||
| 669 | sparse trees can still be made with =C-c / t= (all not-done | ||
| 670 | states) and =C-c / T= (specific states). | ||
| 671 | |||
| 672 | *** The Agenda =org-agenda-ndays= is now obsolete | ||
| 673 | |||
| 674 | The variable =org-agenda-ndays= is obsolete - please use | ||
| 675 | =org-agenda-span= instead. | ||
| 676 | |||
| 677 | Thanks to Julien Danjou for this. | ||
| 678 | |||
| 679 | *** Changes to the intended use of =org-export-latex-classes= | ||
| 680 | |||
| 681 | So far this variable has been used to specify the complete header | ||
| 682 | of the LaTeX document, including all the =\usepackage= calls | ||
| 683 | necessary for the document. This setup makes it difficult to | ||
| 684 | maintain the list of packages that Org itself would like to call, | ||
| 685 | for example for the special symbol support it needs. | ||
| 686 | |||
| 687 | First of all, you can *opt out of this change* in the following | ||
| 688 | way: You can say: /I want to have full control over headers, and I | ||
| 689 | will take responsibility to include the packages Org needs/. If | ||
| 690 | that is what you want, add this to your configuration and skip the | ||
| 691 | rest of this section (except maybe for the description of the | ||
| 692 | =[EXTRA]= place holder): | ||
| 693 | |||
| 694 | #+begin_src emacs-lisp | ||
| 695 | (setq org-export-latex-default-packages-alist nil | ||
| 696 | org-export-latex-packages-alist nil) | ||
| 697 | #+end_src | ||
| 698 | |||
| 699 | /Continue to read here if you want to go along with the modified | ||
| 700 | setup./ | ||
| 701 | |||
| 702 | There are now two variables that should be used to list the LaTeX | ||
| 703 | packages that need to be included in all classes. The header | ||
| 704 | definition in =org-export-latex-classes= should then not contain | ||
| 705 | the corresponding =\usepackage= calls (see below). | ||
| 706 | |||
| 707 | The two new variables are: | ||
| 708 | |||
| 709 | 1. =org-export-latex-default-packages-alist= :: This is the | ||
| 710 | variable where Org-mode itself puts the packages it needs. | ||
| 711 | Normally you should not change this variable. The only | ||
| 712 | reason to change it anyway is when one of these packages | ||
| 713 | causes a conflict with another package you want to use. Then | ||
| 714 | you can remove that packages and hope that you are not using | ||
| 715 | Org-mode functionality that needs it. | ||
| 716 | |||
| 717 | 2. =org-export-latex-packages-alist= :: This is the variable where | ||
| 718 | you can put the packages that you'd like to use across all | ||
| 719 | classes. | ||
| 720 | |||
| 721 | The sequence how these customizations will show up in the LaTeX | ||
| 722 | document are: | ||
| 723 | |||
| 724 | 1. Header from =org-export-latex-classes= | ||
| 725 | 2. =org-export-latex-default-packages-alist= | ||
| 726 | 3. =org-export-latex-packages-alist= | ||
| 727 | 4. Buffer-specific things set with =#+LaTeX_HEADER:= | ||
| 728 | |||
| 729 | If you want more control about which segment is placed where, or | ||
| 730 | if you want, for a specific class, have full control over the | ||
| 731 | header and exclude some of the automatic building blocks, you can | ||
| 732 | put the following macro-like place holders into the header: | ||
| 733 | |||
| 734 | #+begin_example | ||
| 735 | [DEFAULT-PACKAGES] \usepackage statements for default packages | ||
| 736 | [NO-DEFAULT-PACKAGES] do not include any of the default packages | ||
| 737 | [PACKAGES] \usepackage statements for packages | ||
| 738 | [NO-PACKAGES] do not include the packages | ||
| 739 | [EXTRA] the stuff from #+LaTeX_HEADER | ||
| 740 | [NO-EXTRA] do not include #+LaTeX_HEADER stuff | ||
| 741 | #+end_example | ||
| 742 | |||
| 743 | If you have currently customized =org-export-latex-classes=, you | ||
| 744 | should revise that customization and remove any package calls that | ||
| 745 | are covered by =org-export-latex-default-packages-alist=. This | ||
| 746 | applies to the following packages: | ||
| 747 | |||
| 748 | - inputenc | ||
| 749 | - fontenc | ||
| 750 | - fixltx2e | ||
| 751 | - graphicx | ||
| 752 | - longtable | ||
| 753 | - float | ||
| 754 | - wrapfig | ||
| 755 | - soul | ||
| 756 | - t1enc | ||
| 757 | - textcomp | ||
| 758 | - marvosym | ||
| 759 | - wasysym | ||
| 760 | - latexsym | ||
| 761 | - amssymb | ||
| 762 | - hyperref | ||
| 763 | |||
| 764 | If one of these packages creates a conflict with another package | ||
| 765 | you are using, you can remove it from | ||
| 766 | =org-export-latex-default-packages-alist=. But then you risk that | ||
| 767 | some of the advertised export features of Org will not work | ||
| 768 | properly. | ||
| 769 | |||
| 770 | You can also consider moving packages that you use in all classes | ||
| 771 | to =org-export-latex-packages-alist=. If necessary, put the place | ||
| 772 | holders so that the packages get loaded in the right sequence. As | ||
| 773 | said above, for backward compatibility, if you omit the place | ||
| 774 | holders, all the variables will dump their content at the end of | ||
| 775 | the header. | ||
| 776 | |||
| 777 | *** The constant =org-html-entities= is obsolete | ||
| 778 | |||
| 779 | Its content is now part of the new constant =org-entities=, which | ||
| 780 | is defined in the file org-entities.el. =org-html-entities= was | ||
| 781 | an internal variable, but it is possible that some users did write | ||
| 782 | code using it. | ||
| 783 | |||
| 784 | *** =org-bbdb-anniversary-format-alist= has changed | ||
| 785 | |||
| 786 | Please check the docstring and update your settings accordingly. | ||
| 787 | |||
| 788 | *** Deleted =org-mode-p= | ||
| 789 | |||
| 790 | This function has been deleted: please update your code. | ||
| 791 | |||
| 792 | ** Important new features | ||
| 793 | |||
| 794 | *** New Org to ODT exporter | ||
| 795 | |||
| 796 | Jambunathan's Org to ODT exporter is now part of Org. | ||
| 797 | |||
| 798 | To use it, it `C-c C-e o' in an Org file. See the documentation | ||
| 799 | for more information on how to customize it. | ||
| 800 | |||
| 801 | *** org-capture.el is now the default capture system | ||
| 802 | |||
| 803 | This replaces the earlier system org-remember. The manual only | ||
| 804 | describes org-capture, but for people who prefer to continue to | ||
| 805 | use org-remember, we keep a static copy of the former manual | ||
| 806 | section [[http://orgmode.org/org-remember.pdf][chapter about remember]]. | ||
| 807 | |||
| 808 | The new system has a technically cleaner implementation and more | ||
| 809 | possibilities for capturing different types of data. See | ||
| 810 | [[http://thread.gmane.org/gmane.emacs.orgmode/26441/focus%3D26441][Carsten's announcement]] for more details. | ||
| 811 | |||
| 812 | To switch over to the new system: | ||
| 813 | |||
| 814 | 1. Run | ||
| 815 | |||
| 816 | : M-x org-capture-import-remember-templates RET | ||
| 817 | |||
| 818 | to get a translated version of your remember templates into the | ||
| 819 | new variable =org-capture-templates=. This will "mostly" work, | ||
| 820 | but maybe not for all cases. At least it will give you a good | ||
| 821 | place to modify your templates. After running this command, | ||
| 822 | enter the customize buffer for this variable with | ||
| 823 | |||
| 824 | : M-x customize-variable RET org-capture-templates RET | ||
| 825 | |||
| 826 | and convince yourself that everything is OK. Then save the | ||
| 827 | customization. | ||
| 828 | |||
| 829 | 2. Bind the command =org-capture= to a key, similar to what you did | ||
| 830 | with org-remember: | ||
| 831 | |||
| 832 | : (define-key global-map "\C-cc" 'org-capture) | ||
| 833 | |||
| 834 | If your fingers prefer =C-c r=, you can also use this key once | ||
| 835 | you have decided to move over completely to the new | ||
| 836 | implementation. During a test time, there is nothing wrong | ||
| 837 | with using both system in parallel. | ||
| 838 | |||
| 839 | ** New libraries | ||
| 840 | |||
| 841 | *** New Org libraries | ||
| 842 | **** org-eshell.el (Konrad Hinsen) | ||
| 843 | |||
| 844 | Implement links to eshell buffers. | ||
| 845 | |||
| 846 | **** org-special-blocks (Carsten Dominik) | ||
| 847 | |||
| 848 | This package generalizes the #+begin_foo and #+end_foo tokens. | ||
| 849 | |||
| 850 | To use, put the following in your init file: | ||
| 851 | |||
| 852 | #+BEGIN_EXAMPLE | ||
| 220 | (require 'org-special-blocks) | 853 | (require 'org-special-blocks) |
| 221 | #+END_EXAMPLE | 854 | #+END_EXAMPLE |
| 222 | 855 | ||
| 223 | The tokens #+begin_center, #+begin_verse, etc. existed previously. This | 856 | The tokens #+begin_center, #+begin_verse, etc. existed |
| 224 | package generalizes them (at least for the LaTeX and html exporters). When | 857 | previously. This package generalizes them (at least for the |
| 225 | a #+begin_foo token is encountered by the LaTeX exporter, it is expanded | 858 | LaTeX and html exporters). When a #+begin_foo token is |
| 226 | into \begin{foo}. The text inside the environment is not protected, as | 859 | encountered by the LaTeX exporter, it is expanded |
| 227 | text inside environments generally is. When #+begin_foo is encountered by | 860 | into \begin{foo}. The text inside the environment is not |
| 228 | the html exporter, a div with class foo is inserted into the HTML file. It | 861 | protected, as text inside environments generally is. |
| 229 | is up to the user to add this class to his or her stylesheet if this div is | 862 | When #+begin_foo is encountered by the html exporter, a div with |
| 230 | to mean anything. | 863 | class foo is inserted into the HTML file. It is up to the user |
| 864 | to add this class to his or her stylesheet if this div is to mean | ||
| 865 | anything. | ||
| 231 | 866 | ||
| 232 | *** org-taskjuggler.el (Christian Egli) | 867 | **** org-taskjuggler.el (Christian Egli) |
| 233 | :PROPERTIES: | ||
| 234 | :OrgVersion: 7.01 | ||
| 235 | :END: | ||
| 236 | 868 | ||
| 237 | Christian Egli's /org-taskjuggler.el/ module is now part of Org. He | 869 | Christian Egli's /org-taskjuggler.el/ module is now part of Org. |
| 238 | also wrote a [[http://orgmode.org/worg/org-tutorials/org-taskjuggler.php][tutorial]] for it. | 870 | He also wrote a [[http://orgmode.org/worg/org-tutorials/org-taskjuggler.php][tutorial]] for it. |
| 239 | 871 | ||
| 240 | *** org-ctags.el (Paul Sexton) | 872 | **** org-ctags.el (Paul Sexton) |
| 241 | :PROPERTIES: | ||
| 242 | :OrgVersion: 6.34 | ||
| 243 | :END: | ||
| 244 | 873 | ||
| 245 | Targets like =<<my target>>= can now be found by Emacs' etag | 874 | Targets like =<<my target>>= can now be found by Emacs' etag |
| 246 | functionality, and Org-mode links can be used to to link to etags, also | 875 | functionality, and Org-mode links can be used to to link to |
| 247 | in non-Org-mode files. For details, see the file /org-ctags.el/. | 876 | etags, also in non-Org-mode files. For details, see the file |
| 877 | /org-ctags.el/. | ||
| 248 | 878 | ||
| 249 | This feature uses a new hook =org-open-link-functions= which will call | 879 | This feature uses a new hook =org-open-link-functions= which will |
| 250 | function to do something special with text links. | 880 | call function to do something special with text links. |
| 251 | 881 | ||
| 252 | Thanks to Paul Sexton for this contribution. | 882 | Thanks to Paul Sexton for this contribution. |
| 253 | 883 | ||
| 254 | *** org-docview.el (Jan Böcker) | 884 | **** org-docview.el (Jan Böcker) |
| 255 | :PROPERTIES: | ||
| 256 | :OrgVersion: 6.34 | ||
| 257 | :END: | ||
| 258 | 885 | ||
| 259 | This new module allows links to various file types using docview, where | 886 | This new module allows links to various file types using docview, where |
| 260 | Emacs displays images of document pages. Docview link types can point | 887 | Emacs displays images of document pages. Docview link types can point |
| 261 | to a specific page in a document, for example to page 131 of the | 888 | to a specific page in a document, for example to page 131 of the |
| 262 | Org-mode manual: | 889 | Org-mode manual: |
| 263 | 890 | ||
| 264 | : [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]] | 891 | : [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]] |
| 265 | 892 | ||
| 266 | Thanks to Jan Böcker for this contribution. | 893 | Thanks to Jan Böcker for this contribution. |
| 267 | 894 | ||
| 268 | ** New Babel libraries | 895 | *** New Babel libraries |
| 269 | 896 | ||
| 270 | - ob-picolisp.el (Thorsten Jolitz) | 897 | - ob-picolisp.el (Thorsten Jolitz) |
| 271 | - ob-fortran.el (Sergey Litvinov) | 898 | - ob-fortran.el (Sergey Litvinov) |
| @@ -275,674 +902,531 @@ to mean anything. | |||
| 275 | - ob-lilypond.el (Martyn Jago) | 902 | - ob-lilypond.el (Martyn Jago) |
| 276 | - ob-awk.el (Eric Schulte) | 903 | - ob-awk.el (Eric Schulte) |
| 277 | 904 | ||
| 278 | * Other new features and various enhancements | 905 | ** Other new features and various enhancements |
| 279 | 906 | ||
| 280 | ** Hyperlinks | 907 | *** Hyperlinks |
| 281 | 908 | ||
| 282 | *** Org-Bibtex -- major improvements | 909 | **** Org-Bibtex -- major improvements |
| 283 | :PROPERTIES: | ||
| 284 | :OrgVersion: 7.6 | ||
| 285 | :END: | ||
| 286 | 910 | ||
| 287 | Provides support for managing bibtex bibliographical references | 911 | Provides support for managing bibtex bibliographical references |
| 288 | data in headline properties. Each headline corresponds to a | 912 | data in headline properties. Each headline corresponds to a |
| 289 | single reference and the relevant bibliographic meta-data is | 913 | single reference and the relevant bibliographic meta-data is |
| 290 | stored in headline properties, leaving the body of the headline | 914 | stored in headline properties, leaving the body of the headline |
| 291 | free to hold notes and comments. Org-bibtex is aware of all | 915 | free to hold notes and comments. Org-bibtex is aware of all |
| 292 | standard bibtex reference types and fields. | 916 | standard bibtex reference types and fields. |
| 293 | 917 | ||
| 294 | The key new functions are | 918 | The key new functions are |
| 295 | 919 | ||
| 296 | - org-bibtex-check :: queries the user to flesh out all required | 920 | - org-bibtex-check :: queries the user to flesh out all required |
| 297 | (and with prefix argument optional) bibtex fields available | 921 | (and with prefix argument optional) bibtex fields available |
| 298 | for the specific reference =type= of the current headline. | 922 | for the specific reference =type= of the current headline. |
| 299 | 923 | ||
| 300 | - org-bibtex-create :: Create a new entry at the given level, | 924 | - org-bibtex-create :: Create a new entry at the given level, |
| 301 | using org-bibtex-check to flesh out the relevant fields. | 925 | using org-bibtex-check to flesh out the relevant fields. |
| 302 | 926 | ||
| 303 | - org-bibtex-yank :: Yank a bibtex entry on the kill ring as a | 927 | - org-bibtex-yank :: Yank a bibtex entry on the kill ring as a |
| 304 | formatted Org-mode headline into the current buffer | 928 | formatted Org-mode headline into the current buffer |
| 305 | 929 | ||
| 306 | - org-bibtex-export-to-kill-ring :: Export the current headline | 930 | - org-bibtex-export-to-kill-ring :: Export the current headline |
| 307 | to the kill ring as a formatted bibtex entry. | 931 | to the kill ring as a formatted bibtex entry. |
| 308 | 932 | ||
| 933 | **** org-gnus.el now allows link creation from messages | ||
| 309 | 934 | ||
| 935 | You can now create links from messages. This is particularily | ||
| 936 | useful when the user wants to stored messages that he sends, for | ||
| 937 | later check. Thanks to Ulf Stegemann for the patch. | ||
| 310 | 938 | ||
| 311 | *** org-gnus.el now allows link creation from messages | 939 | **** Modified link escaping |
| 312 | :PROPERTIES: | ||
| 313 | :OrgVersion: 7.5 | ||
| 314 | :END: | ||
| 315 | 940 | ||
| 316 | You can now create links from messages. This is particularly | 941 | David Maus worked on `org-link-escape'. See [[http://article.gmane.org/gmane.emacs.orgmode/37888][his message]]: |
| 317 | useful when the user wants to stored messages that he sends, for | ||
| 318 | later check. Thanks to Ulf Stegemann for the patch. | ||
| 319 | 942 | ||
| 943 | : Percent escaping is used in Org mode to escape certain characters | ||
| 944 | : in links that would either break the parser (e.g. square brackets | ||
| 945 | : in link target oder description) or are not allowed to appear in | ||
| 946 | : a particular link type (e.g. non-ascii characters in a http: | ||
| 947 | : link). | ||
| 948 | : | ||
| 949 | : With this change in place Org will apply percent escaping and | ||
| 950 | : unescaping more consistently especially for non-ascii characters. | ||
| 951 | : Additionally some of the outstanding bugs or glitches concerning | ||
| 952 | : percent escaped links are solved. | ||
| 320 | 953 | ||
| 954 | Thanks a lot to David for this work. | ||
| 321 | 955 | ||
| 322 | *** Modified link escaping | 956 | **** Make =org-store-link= point to directory in a dired buffer |
| 323 | :PROPERTIES: | ||
| 324 | :OrgVersion: 7.5 | ||
| 325 | :END: | ||
| 326 | 957 | ||
| 327 | David Maus worked on `org-link-escape'. See [[http://article.gmane.org/gmane.emacs.orgmode/37888][his message]]: | 958 | When, in a dired buffer, the cursor is not in a line listing a |
| 959 | file, `org-store-link' will store a link to the directory. | ||
| 328 | 960 | ||
| 329 | : Percent escaping is used in Org mode to escape certain characters | 961 | Patch by Stephen Eglen. |
| 330 | : in links that would either break the parser (e.g. square brackets | ||
| 331 | : in link target or description) or are not allowed to appear in | ||
| 332 | : a particular link type (e.g. non-ascii characters in a http: | ||
| 333 | : link). | ||
| 334 | : | ||
| 335 | : With this change in place Org will apply percent escaping and | ||
| 336 | : unescaping more consistently especially for non-ascii characters. | ||
| 337 | : Additionally some of the outstanding bugs or glitches concerning | ||
| 338 | : percent escaped links are solved. | ||
| 339 | 962 | ||
| 340 | Thanks a lot to David for this work. | 963 | **** Allow regexps in =org-file-apps= to capture link parameters |
| 341 | 964 | ||
| 965 | The way extension regexps in =org-file-apps= are handled has | ||
| 966 | changed. Instead of matching against the file name, the regexps | ||
| 967 | are now matched against the whole link, and you can use grouping | ||
| 968 | to extract link parameters which you can then use in a command | ||
| 969 | string to be executed. | ||
| 342 | 970 | ||
| 971 | For example, to allow linking to PDF files using the syntax | ||
| 972 | =file:/doc.pdf::<page number>=, you can add the following entry | ||
| 973 | to org-file-apps: | ||
| 343 | 974 | ||
| 344 | *** Make =org-store-link= point to directory in a dired buffer | 975 | #+begin_example |
| 345 | :PROPERTIES: | 976 | Extension: \.pdf::\([0-9]+\)\' |
| 346 | :OrgVersion: 6.35 | 977 | Command: evince "%s" -p %1 |
| 347 | :END: | 978 | #+end_example |
| 348 | 979 | ||
| 349 | When, in a dired buffer, the cursor is not in a line listing a | 980 | Thanks to Jan Böcker for a patch to this effect. |
| 350 | file, `org-store-link' will store a link to the directory. | ||
| 351 | 981 | ||
| 352 | Patch by Stephen Eglen. | 982 | *** Dates and time |
| 353 | 983 | ||
| 984 | **** Allow relative time when scheduling/adding a deadline | ||
| 354 | 985 | ||
| 986 | You can now use relative duration strings like "-2d" or "++3w" | ||
| 987 | when calling =org-schedule= or =org-deadline=: it will schedule | ||
| 988 | (or set the deadline for) the item respectively two days before | ||
| 989 | today and three weeks after the current timestamp, if any. | ||
| 355 | 990 | ||
| 356 | *** Allow regexps in =org-file-apps= to capture link parameters | 991 | You can use this programmatically: =(org-schedule nil "+2d")= |
| 357 | :PROPERTIES: | 992 | will work on the current entry. |
| 358 | :OrgVersion: 6.35 | ||
| 359 | :END: | ||
| 360 | 993 | ||
| 361 | The way extension regexps in =org-file-apps= are handled has | 994 | You can also use this while (bulk-)rescheduling and |
| 362 | changed. Instead of matching against the file name, the regexps | 995 | (bulk-)resetting the deadline of (several) items from the agenda. |
| 363 | are now matched against the whole link, and you can use grouping | ||
| 364 | to extract link parameters which you can then use in a command | ||
| 365 | string to be executed. | ||
| 366 | 996 | ||
| 367 | For example, to allow linking to PDF files using the syntax | 997 | Thanks to Memnon Anon for a heads up about this! |
| 368 | =file:/doc.pdf::<page number>=, you can add the following entry to | ||
| 369 | org-file-apps: | ||
| 370 | 998 | ||
| 371 | #+begin_example | 999 | **** American-style dates are now understood by =org-read-date= |
| 372 | Extension: \.pdf::\([0-9]+\)\' | ||
| 373 | Command: evince "%s" -p %1 | ||
| 374 | #+end_example | ||
| 375 | 1000 | ||
| 376 | Thanks to Jan Böcker for a patch to this effect. | 1001 | So when you are prompted for a date, you can now answer like this |
| 377 | 1002 | ||
| 378 | ** Dates and time | 1003 | #+begin_example |
| 1004 | 2/5/3 --> 2003-02-05 | ||
| 1005 | 2/5 --> <CURRENT-YEAR>-02-05 | ||
| 1006 | #+end_example | ||
| 379 | 1007 | ||
| 380 | *** Allow relative time when scheduling/adding a deadline | 1008 | *** Agenda |
| 381 | :PROPERTIES: | ||
| 382 | :OrgVersion: 7.7 | ||
| 383 | :END: | ||
| 384 | 1009 | ||
| 385 | You can now use relative duration strings like "-2d" or "++3w" | 1010 | **** =org-agenda-custom-commands= has a default value |
| 386 | when calling =org-schedule= or =org-deadline=: it will schedule | ||
| 387 | (or set the deadline for) the item respectively two days before | ||
| 388 | today and three weeks after the current timestamp, if any. | ||
| 389 | 1011 | ||
| 390 | You can use this programmatically: =(org-schedule nil "+2d")= | 1012 | This option used to be `nil' by default. This now has a default |
| 391 | will work on the current entry. | 1013 | value, displaying an agenda and all TODOs. See the docstring for |
| 1014 | details. Thanks to Carsten for this. | ||
| 392 | 1015 | ||
| 393 | You can also use this while (bulk-)rescheduling and | 1016 | **** Improved filtering through =org-agenda-to-appt= |
| 394 | (bulk-)resetting the deadline of (several) items from the agenda. | ||
| 395 | 1017 | ||
| 396 | Thanks to Memnon Anon for a heads up about this! | 1018 | The new function allows the user to refine the scope of entries |
| 1019 | to pass to =org-agenda-get-day-entries= and allows to filter out | ||
| 1020 | entries using a function. | ||
| 397 | 1021 | ||
| 1022 | Thanks to Peter Münster for raising a related issue and to | ||
| 1023 | Tassilo Horn for this idea. Also thanks to Peter Münster for | ||
| 1024 | [[git:68ffb7a7][fixing a small bug]] in the final implementation. | ||
| 398 | 1025 | ||
| 1026 | **** Allow ap/pm times in agenda time grid | ||
| 399 | 1027 | ||
| 1028 | Times in the agenda can now be displayed in am/pm format. See | ||
| 1029 | the new variable =org-agenda-timegrid-use-ampm=. Thanks to | ||
| 1030 | C. A. Webber for a patch to this effect. | ||
| 400 | 1031 | ||
| 401 | *** American-style dates are now understood by =org-read-date= | 1032 | **** Agenda: Added a bulk "scattering" command |
| 402 | :PROPERTIES: | ||
| 403 | :OrgVersion: 6.35 | ||
| 404 | :END: | ||
| 405 | 1033 | ||
| 406 | So when you are prompted for a date, you can now answer like this | 1034 | =B S= in the agenda buffer will cause tasks to be rescheduled a |
| 1035 | random number of days into the future, with 7 as the default. | ||
| 1036 | This is useful if you've got a ton of tasks scheduled for today, | ||
| 1037 | you realize you'll never deal with them all, and you just want | ||
| 1038 | them to be distributed across the next N days. When called with | ||
| 1039 | a prefix arg, rescheduling will avoid weekend days. | ||
| 407 | 1040 | ||
| 408 | #+begin_example | 1041 | Thanks to John Wiegley for this. |
| 409 | 2/5/3 --> 2003-02-05 | ||
| 410 | 2/5 --> <CURRENT-YEAR>-02-05 | ||
| 411 | #+end_example | ||
| 412 | 1042 | ||
| 413 | ** Agenda | 1043 | *** Exporting |
| 414 | 1044 | ||
| 415 | *** =org-agenda-custom-commands= has a default value | 1045 | **** Simplification of org-export-html-preamble/postamble |
| 416 | :PROPERTIES: | ||
| 417 | :OrgVersion: 7.8 | ||
| 418 | :END: | ||
| 419 | 1046 | ||
| 420 | This option used to be `nil' by default. This now has a default | 1047 | When set to `t', export the preamble/postamble as usual, honoring |
| 421 | value, displaying an agenda and all TODOs. See the docstring for | 1048 | the =org-export-email/author/creator-info= variables. |
| 422 | details. Thanks to Carsten for this. | ||
| 423 | 1049 | ||
| 1050 | When set to a formatting string, insert this string. See the | ||
| 1051 | docstring of these variable for details about available | ||
| 1052 | %-sequences. | ||
| 424 | 1053 | ||
| 425 | *** Improved filtering through =org-agenda-to-appt= | 1054 | You can set =:html-preamble= in publishing project in the same |
| 426 | :PROPERTIES: | 1055 | way: `t' means to honor =:email/creator/author-info=, and a |
| 427 | :OrgVersion: 7.8 | 1056 | formatting string will insert a string. |
| 428 | :END: | ||
| 429 | 1057 | ||
| 430 | The new function allows the user to refine the scope of entries | 1058 | **** New exporters to Latin-1 and UTF-8 |
| 431 | to pass to =org-agenda-get-day-entries= and allows to filter out | ||
| 432 | entries using a function. | ||
| 433 | 1059 | ||
| 434 | Thanks to Peter Münster for raising a related issue and to | 1060 | While Ulf Stegemann was going through the entities list to |
| 435 | Tassilo Horn for this idea. Also thanks to Peter Münster for | 1061 | improve the LaTeX export, he had the great idea to provide |
| 436 | [[git:68ffb7a7][fixing a small bug]] in the final implementation. | 1062 | representations for many of the entities in Latin-1, and for all |
| 1063 | of them in UTF-8. This means that we can now export files rich | ||
| 1064 | in special symbols to Latin-1 and to UTF-8 files. These new | ||
| 1065 | exporters can be reached with the commands =C-c C-e n= and =C-c | ||
| 1066 | C-e u=, respectively. | ||
| 437 | 1067 | ||
| 1068 | When there is no representation for a given symbol in the | ||
| 1069 | targeted coding system, you can choose to keep the TeX-macro-like | ||
| 1070 | representation, or to get an "explanatory" representation. For | ||
| 1071 | example, =\simeq= could be represented as "[approx. equal to]". | ||
| 1072 | Please use the variable =org-entities-ascii-explanatory= to state | ||
| 1073 | your preference. | ||
| 438 | 1074 | ||
| 1075 | **** HTML export: Add class to outline containers using property | ||
| 439 | 1076 | ||
| 440 | *** Allow ap/pm times in agenda time grid | 1077 | The =HTML_CONTAINER_CLASS= property can now be used to add a |
| 441 | :PROPERTIES: | 1078 | class name to the outline container of a node in HTML export. |
| 442 | :OrgVersion: 7.4 | ||
| 443 | :END: | ||
| 444 | 1079 | ||
| 445 | Times in the agenda can now be displayed in am/pm format. See the new | 1080 | **** Throw an error when creating an image from a LaTeX snippet fails |
| 446 | variable =org-agenda-timegrid-use-ampm=. Thanks to C. A. Webber for | ||
| 447 | a patch to this effect. | ||
| 448 | 1081 | ||
| 1082 | This behavior can be configured with the new option variable | ||
| 1083 | =org-format-latex-signal-error=. | ||
| 449 | 1084 | ||
| 1085 | **** Support for creating BEAMER presentations from Org-mode documents | ||
| 450 | 1086 | ||
| 451 | *** Agenda: Added a bulk "scattering" command | 1087 | Org-mode documents or subtrees can now be converted directly in |
| 452 | :PROPERTIES: | 1088 | to BEAMER presentation. Turning a tree into a simple |
| 453 | :OrgVersion: 7.4 | 1089 | presentations is straight forward, and there is also quite some |
| 454 | :END: | 1090 | support to make richer presentations as well. See the [[http://orgmode.org/manual/Beamer-class-export.html#Beamer-class-export][BEAMER |
| 1091 | section]] in the manual for more details. | ||
| 455 | 1092 | ||
| 456 | =B S= in the agenda buffer will cause tasks to be rescheduled a random | 1093 | Thanks to everyone who has contributed to the discussion about |
| 457 | number of days into the future, with 7 as the default. This is useful | 1094 | BEAMER support and how it should work. This was a great example |
| 458 | if you've got a ton of tasks scheduled for today, you realize you'll | 1095 | for how this community can achieve a much better result than any |
| 459 | never deal with them all, and you just want them to be distributed | 1096 | individual could. |
| 460 | across the next N days. When called with a prefix arg, rescheduling | ||
| 461 | will avoid weekend days. | ||
| 462 | 1097 | ||
| 463 | Thanks to John Wiegley for this. | 1098 | *** Refiling |
| 464 | 1099 | ||
| 465 | ** Exporting | 1100 | **** Refile targets can now be cached |
| 466 | 1101 | ||
| 467 | *** Simplification of org-export-html-preamble/postamble | 1102 | You can turn on caching of refile targets by setting the variable |
| 468 | :PROPERTIES: | 1103 | =org-refile-use-cache=. This should speed up refiling if you |
| 469 | :OrgVersion: 7.5 | 1104 | have many eligible targets in many files. If you need to update |
| 470 | :END: | 1105 | the cache because Org misses a newly created entry or still |
| 1106 | offers a deleted one, press =C-0 C-c C-w=. | ||
| 471 | 1107 | ||
| 472 | When set to `t', export the preamble/postamble as usual, honoring the | 1108 | **** New logging support for refiling |
| 473 | =org-export-email/author/creator-info= variables. | ||
| 474 | 1109 | ||
| 475 | When set to a formatting string, insert this string. See the docstring | 1110 | Whenever you refile an item, a time stamp and even a note can be |
| 476 | of these variable for details about available %-sequences. | 1111 | added to this entry. For details, see the new option |
| 1112 | =org-log-refile=. | ||
| 477 | 1113 | ||
| 478 | You can set =:html-preamble= in publishing project in the same way: `t' | 1114 | Thanks to Charles Cave for this idea. |
| 479 | means to honor =:email/creator/author-info=, and a formatting string | ||
| 480 | will insert a string. | ||
| 481 | 1115 | ||
| 482 | *** New exporters to Latin-1 and UTF-8 | 1116 | *** Completion |
| 483 | :PROPERTIES: | ||
| 484 | :OrgVersion: 6.35 | ||
| 485 | :END: | ||
| 486 | 1117 | ||
| 487 | While Ulf Stegemann was going through the entities list to improve the | 1118 | **** In-buffer completion is now done using John Wiegleys pcomplete.el |
| 488 | LaTeX export, he had the great idea to provide representations for many | ||
| 489 | of the entities in Latin-1, and for all of them in UTF-8. This means | ||
| 490 | that we can now export files rich in special symbols to Latin-1 and to | ||
| 491 | UTF-8 files. These new exporters can be reached with the commands =C-c | ||
| 492 | C-e n= and =C-c C-e u=, respectively. | ||
| 493 | 1119 | ||
| 494 | When there is no representation for a given symbol in the targeted | 1120 | Thanks to John Wiegley for much of this code. |
| 495 | coding system, you can choose to keep the TeX-macro-like | ||
| 496 | representation, or to get an "explanatory" representation. For | ||
| 497 | example, =\simeq= could be represented as "[approx. equal to]". Please | ||
| 498 | use the variable =org-entities-ascii-explanatory= to state your | ||
| 499 | preference. | ||
| 500 | 1121 | ||
| 501 | *** HTML export: Add class to outline containers using property | 1122 | *** Tables |
| 502 | :PROPERTIES: | ||
| 503 | :OrgVersion: 6.35 | ||
| 504 | :END: | ||
| 505 | 1123 | ||
| 506 | The =HTML_CONTAINER_CLASS= property can now be used to add a class name | 1124 | **** New command =org-table-transpose-table-at-point= |
| 507 | to the outline container of a node in HTML export. | ||
| 508 | 1125 | ||
| 509 | *** Throw an error when creating an image from a LaTeX snippet fails | 1126 | See the docstring. This hack from Juan Pechiar is now part of |
| 510 | :PROPERTIES: | 1127 | Org's core. Thanks to Juan! |
| 511 | :OrgVersion: 6.35 | ||
| 512 | :END: | ||
| 513 | 1128 | ||
| 514 | This behavior can be configured with the new option variable | 1129 | **** Display field's coordinates when editing it with =C-c `= |
| 515 | =org-format-latex-signal-error=. | ||
| 516 | 1130 | ||
| 517 | *** Support for creating BEAMER presentations from Org-mode documents | 1131 | When editing a field with =C-c `=, the field's coordinate will |
| 518 | :PROPERTIES: | 1132 | the displayed in the buffer. |
| 519 | :OrgVersion: 6.34 | ||
| 520 | :END: | ||
| 521 | 1133 | ||
| 522 | Org-mode documents or subtrees can now be converted directly in to | 1134 | Thanks to Michael Brand for a patch to this effect. |
| 523 | BEAMER presentation. Turning a tree into a simple presentations is | ||
| 524 | straight forward, and there is also quite some support to make richer | ||
| 525 | presentations as well. See the [[http://orgmode.org/manual/Beamer-class-export.html#Beamer-class-export][BEAMER section]] in the manual for more | ||
| 526 | details. | ||
| 527 | 1135 | ||
| 528 | Thanks to everyone who has contributed to the discussion about BEAMER | 1136 | **** Spreadsheet computation of durations and time values |
| 529 | support and how it should work. This was a great example for how this | ||
| 530 | community can achieve a much better result than any individual could. | ||
| 531 | 1137 | ||
| 532 | ** Refiling | 1138 | If you want to compute time values use the =T= flag, either in |
| 1139 | Calc formulas or Elisp formulas: | ||
| 533 | 1140 | ||
| 534 | *** Refile targets can now be cached | 1141 | | Task 1 | Task 2 | Total | |
| 535 | :PROPERTIES: | 1142 | |--------+--------+---------| |
| 536 | :OrgVersion: 7.01 | 1143 | | 35:00 | 35:00 | 1:10:00 | |
| 537 | :END: | 1144 | #+TBLFM: @2$3=$1+$2;T |
| 538 | 1145 | ||
| 539 | You can turn on caching of refile targets by setting the variable | 1146 | Values must be of the form =[HH:]MM:SS=, where hours are |
| 540 | =org-refile-use-cache=. This should speed up refiling if you have many | 1147 | optional. |
| 541 | eligible targets in many files. If you need to update the cache | ||
| 542 | because Org misses a newly created entry or still offers a deleted one, | ||
| 543 | press =C-0 C-c C-w=. | ||
| 544 | 1148 | ||
| 545 | *** New logging support for refiling | 1149 | Thanks to Martin Halder, Eric Schulte and Carsten for code and |
| 546 | :PROPERTIES: | 1150 | feedback on this. |
| 547 | :OrgVersion: 6.35 | ||
| 548 | :END: | ||
| 549 | 1151 | ||
| 550 | Whenever you refile an item, a time stamp and even a note can be added | 1152 | **** Implement formulas applying to field ranges |
| 551 | to this entry. For details, see the new option =org-log-refile=. | ||
| 552 | 1153 | ||
| 553 | Thanks to Charles Cave for this idea. | 1154 | Carsten implemented this field-ranges formulas. |
| 554 | 1155 | ||
| 555 | ** Completion | 1156 | : A frequently requested feature for tables has been to be able to define |
| 1157 | : row formulas in a way similar to column formulas. The patch below allows | ||
| 1158 | : things like | ||
| 1159 | : | ||
| 1160 | : @3= | ||
| 1161 | : @2$2..@5$7= | ||
| 1162 | : @I$2..@II$4= | ||
| 1163 | : | ||
| 1164 | : as the left hand side for table formulas in order to write a formula that | ||
| 1165 | : is valid for an entire column or for a rectangular section in a | ||
| 1166 | : table. | ||
| 556 | 1167 | ||
| 557 | *** In-buffer completion is now done using John Wiegley's pcomplete.el | 1168 | Thanks a lot to Carsten for this. |
| 558 | :PROPERTIES: | ||
| 559 | :OrgVersion: 7.4 | ||
| 560 | :END: | ||
| 561 | 1169 | ||
| 562 | Thanks to John Wiegley for much of this code. | 1170 | **** Sending radio tables from org buffers is now allowed |
| 563 | 1171 | ||
| 564 | ** Tables | 1172 | Org radio tables can no also be sent inside Org buffers. Also, |
| 1173 | there is a new hook which get called after a table has been sent. | ||
| 565 | 1174 | ||
| 566 | *** New command =org-table-transpose-table-at-point= | 1175 | Thanks to Seweryn Kokot. |
| 567 | :PROPERTIES: | ||
| 568 | :OrgVersion: 7.8 | ||
| 569 | :END: | ||
| 570 | 1176 | ||
| 571 | See the docstring. This hack from Juan Pechiar is now part of Org's | 1177 | *** Lists |
| 572 | core. Thanks to Juan! | ||
| 573 | 1178 | ||
| 574 | *** Display field's coordinates when editing it with =C-c `= | 1179 | **** Improved handling of lists |
| 575 | :PROPERTIES: | ||
| 576 | :OrgVersion: 7.7 | ||
| 577 | :END: | ||
| 578 | 1180 | ||
| 579 | When editing a field with =C-c `=, the field's coordinate will the | 1181 | Nicolas Goaziou extended and improved the way Org handles lists. |
| 580 | displayed in the buffer. | ||
| 581 | 1182 | ||
| 582 | Thanks to Michael Brand for a patch to this effect. | 1183 | 1. Indentation of text determines again end of items in |
| 1184 | lists. So, some text less indented than the previous item | ||
| 1185 | doesn't close the whole list anymore, only all items more | ||
| 1186 | indented than it. | ||
| 583 | 1187 | ||
| 584 | *** Spreadsheet computation of durations and time values | 1188 | 2. Alphabetical bullets are implemented, through the use of the |
| 585 | :PROPERTIES: | 1189 | variable `org-alphabetical-lists'. This also adds alphabetical |
| 586 | :OrgVersion: 7.6 | 1190 | counters like [@c] or [@W]. |
| 587 | :END: | ||
| 588 | 1191 | ||
| 589 | If you want to compute time values use the =T= flag, either in Calc | 1192 | 3. Lists can now safely contain drawers, inline tasks, or various |
| 590 | formulas or Elisp formulas: | 1193 | blocks, themselves containing lists. Two variables are |
| 1194 | controlling this: `org-list-forbidden-blocks', and | ||
| 1195 | `org-list-export-context'. | ||
| 591 | 1196 | ||
| 592 | | Task 1 | Task 2 | Total | | 1197 | 4. Improve `newline-and-indent' (C-j): used in an item, it will |
| 593 | |--------+--------+---------| | 1198 | keep text from moving at column 0. This allows to split text |
| 594 | | 35:00 | 35:00 | 1:10:00 | | 1199 | and make paragraphs and still not break the list. |
| 595 | #+TBLFM: @2$3=$1+$2;T | ||
| 596 | 1200 | ||
| 597 | Values must be of the form =[HH:]MM:SS=, where hours are optional. | 1201 | 5. Improve `org-toggle-item' (C-c -): used on a region with |
| 1202 | standard text, it will change the region into one item. With a | ||
| 1203 | prefix argument, it will fallback to the previous behavior and | ||
| 1204 | make every line in region an item. It permits to easily | ||
| 1205 | integrate paragraphs inside a list. | ||
| 598 | 1206 | ||
| 599 | Thanks to Martin Halder, Eric Schulte and Carsten for code and feedback | 1207 | 6. `fill-paragraph' (M-q) now understands lists. It can freely be |
| 600 | on this. | 1208 | used inside items, or on text just after a list, even with no |
| 1209 | blank line around, without breaking list structure. | ||
| 601 | 1210 | ||
| 602 | *** Implement formulas applying to field ranges | 1211 | Thanks a lot to Nicolas for all this! |
| 603 | :PROPERTIES: | ||
| 604 | :OrgVersion: 7.5 | ||
| 605 | :END: | ||
| 606 | 1212 | ||
| 607 | Carsten implemented this field-ranges formulas. | 1213 | *** Inline display of linked images |
| 608 | 1214 | ||
| 609 | : A frequently requested feature for tables has been to be able to define | 1215 | Images can now be displayed inline. The key C-c C-x C-v does |
| 610 | : row formulas in a way similar to column formulas. The patch below allows | 1216 | toggle the display of such images. Note that only image links |
| 611 | : things like | 1217 | that have no description part will be inlined. |
| 612 | : | ||
| 613 | : @3= | ||
| 614 | : @2$2..@5$7= | ||
| 615 | : @I$2..@II$4= | ||
| 616 | : | ||
| 617 | : as the left hand side for table formulas in order to write a formula that | ||
| 618 | : is valid for an entire column or for a rectangular section in a | ||
| 619 | : table. | ||
| 620 | 1218 | ||
| 621 | Thanks a lot to Carsten for this. | 1219 | *** Implement offsets for ordered lists |
| 622 | 1220 | ||
| 623 | *** Sending radio tables from org buffers is now allowed | 1221 | If you want to start an ordered plain list with a number different |
| 624 | :PROPERTIES: | 1222 | from 1, you can now do it like this: |
| 625 | :OrgVersion: 7.4 | ||
| 626 | :END: | ||
| 627 | 1223 | ||
| 628 | Org radio tables can no also be sent inside Org buffers. Also, there | 1224 | : 1. [@start:12] will star a lit a number 12 |
| 629 | is a new hook which get called after a table has been sent. | ||
| 630 | 1225 | ||
| 631 | Thanks to Seweryn Kokot. | 1226 | *** Babel: code block body expansion for table and preview |
| 632 | 1227 | ||
| 633 | ** Lists | 1228 | In org-babel, code is "expanded" prior to evaluation. I.e. the |
| 1229 | code that is actually evaluated comprises the code block contents, | ||
| 1230 | augmented with the extra code which assigns the referenced data to | ||
| 1231 | variables. It is now possible to preview expanded contents, and | ||
| 1232 | also to expand code during during tangling. This expansion takes | ||
| 1233 | into account all header arguments, and variables. | ||
| 634 | 1234 | ||
| 635 | *** Improved handling of lists | 1235 | A new keybinding `C-c M-b p' bound to `org-babel-expand-src-block' |
| 636 | :PROPERTIES: | 1236 | can be used from inside of a source code block to preview its |
| 637 | :OrgVersion: 7.5 | 1237 | expanded contents (which can be very useful for debugging). |
| 638 | :END: | 1238 | tangling |
| 639 | 1239 | ||
| 640 | Nicolas Goaziou extended and improved the way Org handles lists. | 1240 | The expanded body can now be tangled, this includes variable |
| 1241 | values which may be the results of other source-code blocks, or | ||
| 1242 | stored in headline properties or tables. One possible use for this | ||
| 1243 | is to allow those using org-babel for their emacs initialization | ||
| 1244 | to store values (e.g. usernames, passwords, etc...) in headline | ||
| 1245 | properties or in tables. | ||
| 641 | 1246 | ||
| 642 | 1. Indentation of text determines again end of items in lists. So, some | 1247 | Org-babel now supports three new header arguments, and new default |
| 643 | text less indented than the previous item doesn't close the whole | 1248 | behavior for handling horizontal lines in tables (hlines), column |
| 644 | list anymore, only all items more indented than it. | 1249 | names, and rownames across all languages. |
| 645 | 1250 | ||
| 646 | 2. Alphabetical bullets are implemented, through the use of the | 1251 | *** Editing Convenience and Appearance |
| 647 | variable `org-alphabetical-lists'. This also adds alphabetical | ||
| 648 | counters like [@c] or [@W]. | ||
| 649 | 1252 | ||
| 650 | 3. Lists can now safely contain drawers, inline tasks, or various | 1253 | **** New command =org-copy-visible= (=C-c C-x v=) |
| 651 | blocks, themselves containing lists. Two variables are controlling | ||
| 652 | this: `org-list-forbidden-blocks', and `org-list-export-context'. | ||
| 653 | 1254 | ||
| 654 | 4. Improve `newline-and-indent' (C-j): used in an item, it will keep | 1255 | This command will copy the visible text in the region into the |
| 655 | text from moving at column 0. This allows to split text and make | 1256 | kill ring. Thanks to Florian Beck for this function and to |
| 656 | paragraphs and still not break the list. | 1257 | Carsten for adding it to org.el and documenting it! |
| 657 | 1258 | ||
| 658 | 5. Improve `org-toggle-item' (C-c -): used on a region with standard | 1259 | **** Make it possible to protect hidden subtrees from being killed by =C-k= |
| 659 | text, it will change the region into one item. With a prefix | ||
| 660 | argument, it will fallback to the previous behavior and make every | ||
| 661 | line in region an item. It permits to easily integrate paragraphs | ||
| 662 | inside a list. | ||
| 663 | 1260 | ||
| 664 | 6. `fill-paragraph' (M-q) now understands lists. It can freely be used | 1261 | See the new variable =org-ctrl-k-protect-subtree=. This was a |
| 665 | inside items, or on text just after a list, even with no blank line | 1262 | request by Scott Otterson. |
| 666 | around, without breaking list structure. | ||
| 667 | 1263 | ||
| 668 | Thanks a lot to Nicolas for all this! | 1264 | **** Implement pretty display of entities, sub-, and superscripts. |
| 669 | 1265 | ||
| 670 | ** Inline display of linked images | 1266 | The command =C-c C-x \= toggles the display of Org's special |
| 671 | :PROPERTIES: | 1267 | entities like =\alpha= as pretty unicode characters. Also, sub |
| 672 | :OrgVersion: 6.36 | 1268 | and superscripts are displayed in a pretty way (raised/lower |
| 673 | :END: | 1269 | display, in a smaller font). If you want to exclude sub- and |
| 674 | 1270 | superscripts, see the variable | |
| 675 | Images can now be displayed inline. The key C-c C-x C-v does toggle the | 1271 | =org-pretty-entities-include-sub-superscripts=. |
| 676 | display of such images. Note that only image links that have no | ||
| 677 | description part will be inlined. | ||
| 678 | 1272 | ||
| 679 | ** Implement offsets for ordered lists | 1273 | Thanks to Eric Schulte and Ulf Stegeman for making this possible. |
| 680 | :PROPERTIES: | ||
| 681 | :OrgVersion: 6.36 | ||
| 682 | :END: | ||
| 683 | |||
| 684 | If you want to start an ordered plain list with a number different from | ||
| 685 | 1, you can now do it like this: | ||
| 686 | |||
| 687 | : 1. [@start:12] will star a lit a number 12 | ||
| 688 | 1274 | ||
| 689 | ** Babel: code block body expansion for table and preview | 1275 | **** New faces for title, date, author and email address lines |
| 690 | :PROPERTIES: | ||
| 691 | :OrgVersion: 6.36 | ||
| 692 | :END: | ||
| 693 | |||
| 694 | In org-babel, code is "expanded" prior to evaluation. I.e. the code that | ||
| 695 | is actually evaluated comprises the code block contents, augmented with | ||
| 696 | the extra code which assigns the referenced data to variables. It is now | ||
| 697 | possible to preview expanded contents, and also to expand code during | ||
| 698 | during tangling. This expansion takes into account all header arguments, | ||
| 699 | and variables. | ||
| 700 | |||
| 701 | A new key-binding `C-c M-b p' bound to `org-babel-expand-src-block' can | ||
| 702 | be used from inside of a source code block to preview its expanded | ||
| 703 | contents (which can be very useful for debugging). tangling | ||
| 704 | |||
| 705 | The expanded body can now be tangled, this includes variable values | ||
| 706 | which may be the results of other source-code blocks, or stored in | ||
| 707 | headline properties or tables. One possible use for this is to allow | ||
| 708 | those using org-babel for their emacs initialization to store values | ||
| 709 | (e.g. usernames, passwords, etc...) in headline properties or in tables. | ||
| 710 | |||
| 711 | Org-babel now supports three new header arguments, and new default | ||
| 712 | behavior for handling horizontal lines in tables (hlines), column names, | ||
| 713 | and rownames across all languages. | ||
| 714 | |||
| 715 | ** Editing Convenience and Appearance | ||
| 716 | 1276 | ||
| 717 | *** New command =org-copy-visible= (=C-c C-x v=) | 1277 | The keywords in these lines are now dimmed out, and the title is |
| 718 | :PROPERTIES: | 1278 | displayed in a larger font, and a special font is also used for |
| 719 | :OrgVersion: 7.7 | 1279 | author, date, and email information. This is implemented by the |
| 720 | :END: | 1280 | following new faces: |
| 721 | 1281 | ||
| 722 | This command will copy the visible text in the region into the kill | 1282 | =org-document-title= |
| 723 | ring. Thanks to Florian Beck for this function and to Carsten for | 1283 | =org-document-info= |
| 724 | adding it to org.el and documenting it! | 1284 | =org-document-info-keyword= |
| 725 | 1285 | ||
| 726 | *** Make it possible to protect hidden subtrees from being killed by =C-k= | 1286 | In addition, the variable =org-hidden-keywords= can be used to |
| 727 | :PROPERTIES: | 1287 | make the corresponding keywords disappear. |
| 728 | :OrgVersion: 7.01 | ||
| 729 | :END: | ||
| 730 | 1288 | ||
| 731 | See the new variable =org-ctrl-k-protect-subtree=. This was a request | 1289 | Thanks to Dan Davison for this feature. |
| 732 | by Scott Otterson. | ||
| 733 | 1290 | ||
| 734 | *** Implement pretty display of entities, sub-, and superscripts. | 1291 | **** Simpler way to specify faces for tags and todo keywords |
| 735 | :PROPERTIES: | ||
| 736 | :OrgVersion: 7.01 | ||
| 737 | :END: | ||
| 738 | 1292 | ||
| 739 | The command =C-c C-x \= toggles the display of Org's special entities | 1293 | The variables =org-todo-keyword-faces=, =org-tag-faces=, and |
| 740 | like =\alpha= as pretty unicode characters. Also, sub and superscripts | 1294 | =org-priority-faces= now accept simple color names as |
| 741 | are displayed in a pretty way (raised/lower display, in a smaller | 1295 | specifications. The colors will be used as either foreground or |
| 742 | font). If you want to exclude sub- and superscripts, see the variable | 1296 | background color for the corresponding keyword. See also the |
| 743 | =org-pretty-entities-include-sub-superscripts=. | 1297 | variable =org-faces-easy-properties=, which governs which face |
| 744 | 1298 | property is affected by this setting. | |
| 745 | Thanks to Eric Schulte and Ulf Stegeman for making this possible. | ||
| 746 | |||
| 747 | *** New faces for title, date, author and email address lines | ||
| 748 | :PROPERTIES: | ||
| 749 | :OrgVersion: 6.35 | ||
| 750 | :END: | ||
| 751 | |||
| 752 | The keywords in these lines are now dimmed out, and the title is | ||
| 753 | displayed in a larger font, and a special font is also used for author, | ||
| 754 | date, and email information. This is implemented by the following new | ||
| 755 | faces: | ||
| 756 | |||
| 757 | =org-document-title= | ||
| 758 | =org-document-info= | ||
| 759 | =org-document-info-keyword= | ||
| 760 | |||
| 761 | In addition, the variable =org-hidden-keywords= can be used to make the | ||
| 762 | corresponding keywords disappear. | ||
| 763 | 1299 | ||
| 764 | Thanks to Dan Davison for this feature. | 1300 | This is really a great simplification for setting keyword faces. |
| 765 | 1301 | The change is based on an idea and patch by Ryan Thompson. | |
| 766 | *** Simpler way to specify faces for tags and todo keywords | ||
| 767 | :PROPERTIES: | ||
| 768 | :OrgVersion: 6.35 | ||
| 769 | :END: | ||
| 770 | |||
| 771 | The variables =org-todo-keyword-faces=, =org-tag-faces=, and | ||
| 772 | =org-priority-faces= now accept simple color names as specifications. | ||
| 773 | The colors will be used as either foreground or background color for | ||
| 774 | the corresponding keyword. See also the variable | ||
| 775 | =org-faces-easy-properties=, which governs which face property is | ||
| 776 | affected by this setting. | ||
| 777 | 1302 | ||
| 778 | This is really a great simplification for setting keyword faces. The | 1303 | **** <N> in tables now means fixed width, not maximum width |
| 779 | change is based on an idea and patch by Ryan Thompson. | ||
| 780 | |||
| 781 | *** <N> in tables now means fixed width, not maximum width | ||
| 782 | :PROPERTIES: | ||
| 783 | :OrgVersion: 6.35 | ||
| 784 | :END: | ||
| 785 | 1304 | ||
| 786 | Requested by Michael Brand. | 1305 | Requested by Michael Brand. |
| 787 | 1306 | ||
| 788 | *** Better level cycling function | 1307 | **** Better level cycling function |
| 789 | :PROPERTIES: | ||
| 790 | :OrgVersion: 6.35 | ||
| 791 | :END: | ||
| 792 | 1308 | ||
| 793 | =TAB= in an empty headline cycles the level of that headline through | 1309 | =TAB= in an empty headline cycles the level of that headline |
| 794 | likely states. Ryan Thompson implemented an improved version of this | 1310 | through likely states. Ryan Thompson implemented an improved |
| 795 | function, which does not depend upon when exactly this command is used. | 1311 | version of this function, which does not depend upon when exactly |
| 796 | Thanks to Ryan for this improvement. | 1312 | this command is used. Thanks to Ryan for this improvement. |
| 797 | 1313 | ||
| 798 | *** Adaptive filling | 1314 | **** Adaptive filling |
| 799 | :PROPERTIES: | ||
| 800 | :OrgVersion: 6.35 | ||
| 801 | :END: | ||
| 802 | 1315 | ||
| 803 | For paragraph text, =org-adaptive-fill-function= did not handle the | 1316 | For paragraph text, =org-adaptive-fill-function= did not handle |
| 804 | base case of regular text which needed to be filled. This is now | 1317 | the base case of regular text which needed to be filled. This is |
| 805 | fixed. Among other things, it allows email-style ">" comments to be | 1318 | now fixed. Among other things, it allows email-style ">" |
| 806 | filled correctly. | 1319 | comments to be filled correctly. |
| 807 | 1320 | ||
| 808 | Thanks to Dan Hackney for this patch. | 1321 | Thanks to Dan Hackney for this patch. |
| 809 | 1322 | ||
| 810 | *** `org-reveal' (=C-c C-r=) also decrypts encrypted entries (org-crypt.el) | 1323 | **** `org-reveal' (=C-c C-r=) also decrypts encrypted entries (org-crypt.el) |
| 811 | :PROPERTIES: | ||
| 812 | :OrgVersion: 6.35 | ||
| 813 | :END: | ||
| 814 | 1324 | ||
| 815 | Thanks to Richard Riley for triggering this change. | 1325 | Thanks to Richard Riley for triggering this change. |
| 816 | 1326 | ||
| 817 | *** Better automatic letter selection for TODO keywords | 1327 | **** Better automatic letter selection for TODO keywords |
| 818 | :PROPERTIES: | ||
| 819 | :OrgVersion: 6.35 | ||
| 820 | :END: | ||
| 821 | 1328 | ||
| 822 | When all first letters of keywords have been used, Org now assigns more | 1329 | When all first letters of keywords have been used, Org now |
| 823 | meaningful characters based on the keywords. | 1330 | assigns more meaningful characters based on the keywords. |
| 824 | 1331 | ||
| 825 | Thanks to Mikael Fornius for this patch. | 1332 | Thanks to Mikael Fornius for this patch. |
| 826 | 1333 | ||
| 827 | ** Clocking | 1334 | *** Clocking |
| 828 | 1335 | ||
| 829 | *** Clock: Allow synchronous update of timestamps in CLOCK log | 1336 | **** Clock: Allow synchronous update of timestamps in CLOCK log |
| 830 | :PROPERTIES: | ||
| 831 | :OrgVersion: 7.7 | ||
| 832 | :END: | ||
| 833 | 1337 | ||
| 834 | Using =S-M-<up/down>= on CLOCK log timestamps will increase/decrease | 1338 | Using =S-M-<up/down>= on CLOCK log timestamps will |
| 835 | the two timestamps on this line so that duration will keep the same. | 1339 | increase/decrease the two timestamps on this line so that |
| 836 | Note that duration can still be slightly modified in case a timestamp | 1340 | duration will keep the same. Note that duration can still be |
| 837 | needs some rounding. | 1341 | slightly modified in case a timestamp needs some rounding. |
| 838 | 1342 | ||
| 839 | Thanks to Rainer Stengele for this idea. | 1343 | Thanks to Rainer Stengele for this idea. |
| 840 | 1344 | ||
| 841 | *** Localized clock tables | 1345 | **** Localized clock tables |
| 842 | :PROPERTIES: | ||
| 843 | :OrgVersion: 7.5 | ||
| 844 | :END: | ||
| 845 | 1346 | ||
| 846 | Clock tables now support a new new =:lang= parameter, allowing the user | 1347 | Clock tables now support a new new =:lang= parameter, allowing |
| 847 | to customize the localization of the table headers. See the variable | 1348 | the user to customize the localization of the table headers. See |
| 848 | =org-clock-clocktable-language-setup= which controls available | 1349 | the variable =org-clock-clocktable-language-setup= which controls |
| 849 | translated strings. | 1350 | available translated strings. |
| 850 | 1351 | ||
| 851 | *** Show clock overruns in mode line | 1352 | **** Show clock overruns in mode line |
| 852 | :PROPERTIES: | ||
| 853 | :OrgVersion: 6.35 | ||
| 854 | :END: | ||
| 855 | 1353 | ||
| 856 | When clocking an item with a planned effort, overrunning the planned | 1354 | When clocking an item with a planned effort, overrunning the |
| 857 | time is now made visible in the mode line, for example using the new | 1355 | planned time is now made visible in the mode line, for example |
| 858 | face =org-mode-line-clock-overrun=, or by adding an extra string given | 1356 | using the new face =org-mode-line-clock-overrun=, or by adding an |
| 859 | by =org-task-overrun-text=. | 1357 | extra string given by =org-task-overrun-text=. |
| 860 | 1358 | ||
| 861 | Thanks to Richard Riley for a patch to this effect. | 1359 | Thanks to Richard Riley for a patch to this effect. |
| 862 | 1360 | ||
| 863 | *** Clock reports can now include the running, incomplete clock | 1361 | **** Clock reports can now include the running, incomplete clock |
| 864 | :PROPERTIES: | ||
| 865 | :OrgVersion: 6.35 | ||
| 866 | :END: | ||
| 867 | 1362 | ||
| 868 | If you have a clock running, and the entry being clocked falls into the | 1363 | If you have a clock running, and the entry being clocked falls |
| 869 | scope when creating a clock table, the time so far spent can be added | 1364 | into the scope when creating a clock table, the time so far spent |
| 870 | to the total. This behavior depends on the setting of | 1365 | can be added to the total. This behavior depends on the setting |
| 871 | =org-clock-report-include-clocking-task=. The default is =nil=. | 1366 | of =org-clock-report-include-clocking-task=. The default is |
| 1367 | =nil=. | ||
| 872 | 1368 | ||
| 873 | Thanks to Bernt Hansen for this useful addition. | 1369 | Thanks to Bernt Hansen for this useful addition. |
| 874 | 1370 | ||
| 875 | ** Misc | 1371 | *** Misc |
| 876 | 1372 | ||
| 877 | *** Improvements with inline tasks and indentation | 1373 | **** Improvements with inline tasks and indentation |
| 878 | :PROPERTIES: | ||
| 879 | :OrgVersion: 7.4 | ||
| 880 | :END: | ||
| 881 | 1374 | ||
| 882 | There is now a configurable way on how to export inline tasks. See the | 1375 | There is now a configurable way on how to export inline tasks. |
| 883 | new variable =org-inlinetask-export-templates=. | 1376 | See the new variable =org-inlinetask-export-templates=. |
| 884 | 1377 | ||
| 885 | Thanks to Nicolas Goaziou for coding these changes. | 1378 | Thanks to Nicolas Goaziou for coding these changes. |
| 886 | 1379 | ||
| 887 | *** A property value of "nil" now means to unset a property | 1380 | **** A property value of "nil" now means to unset a property |
| 888 | :PROPERTIES: | ||
| 889 | :OrgVersion: 7.01 | ||
| 890 | :END: | ||
| 891 | 1381 | ||
| 892 | This can be useful in particular with property inheritance, if some | 1382 | This can be useful in particular with property inheritance, if |
| 893 | upper level has the property, and some grandchild of it would like to | 1383 | some upper level has the property, and some grandchild of it |
| 894 | have the default settings (i.e. not overruled by a property) back. | 1384 | would like to have the default settings (i.e. not overruled by a |
| 1385 | property) back. | ||
| 895 | 1386 | ||
| 896 | Thanks to Robert Goldman and Bernt Hansen for suggesting this change. | 1387 | Thanks to Robert Goldman and Bernt Hansen for suggesting this |
| 1388 | change. | ||
| 897 | 1389 | ||
| 898 | *** New helper functions in org-table.el | 1390 | **** New helper functions in org-table.el |
| 899 | :PROPERTIES: | ||
| 900 | :OrgVersion: 6.35 | ||
| 901 | :END: | ||
| 902 | 1391 | ||
| 903 | There are new functions to access and write to a specific table field. | 1392 | There are new functions to access and write to a specific table field. |
| 904 | This is for hackers, and maybe for the org-babel people. | 1393 | This is for hackers, and maybe for the org-babel people. |
| 905 | 1394 | ||
| 906 | #+begin_example | 1395 | #+begin_example |
| 907 | org-table-get | 1396 | org-table-get |
| 908 | org-table-put | 1397 | org-table-put |
| 909 | org-table-current-line | 1398 | org-table-current-line |
| 910 | org-table-goto-line | 1399 | org-table-goto-line |
| 911 | #+end_example | 1400 | #+end_example |
| 912 | 1401 | ||
| 913 | *** Archiving: Allow to reverse order in target node | 1402 | **** Archiving: Allow to reverse order in target node |
| 914 | :PROPERTIES: | ||
| 915 | :OrgVersion: 6.35 | ||
| 916 | :END: | ||
| 917 | 1403 | ||
| 918 | The new option =org-archive-reversed-order= allows to have archived | 1404 | The new option =org-archive-reversed-order= allows to have |
| 919 | entries inserted in a last-on-top fashion in the target node. | 1405 | archived entries inserted in a last-on-top fashion in the target |
| 1406 | node. | ||
| 920 | 1407 | ||
| 921 | This was requested by Tom. | 1408 | This was requested by Tom. |
| 922 | 1409 | ||
| 923 | *** Org-reveal: Double prefix arg shows the entire subtree of the parent | 1410 | **** Org-reveal: Double prefix arg shows the entire subtree of the parent |
| 924 | :PROPERTIES: | ||
| 925 | :OrgVersion: 6.35 | ||
| 926 | :END: | ||
| 927 | 1411 | ||
| 928 | This can help to get out of an inconsistent state produced for example | 1412 | This can help to get out of an inconsistent state produced for |
| 929 | by viewing from the agenda. | 1413 | example by viewing from the agenda. |
| 930 | 1414 | ||
| 931 | This was a request by Matt Lundin. | 1415 | This was a request by Matt Lundin. |
| 932 | 1416 | ||
| 933 | * License | 1417 | * License |
| 934 | 1418 | ||
| 935 | This file is part of GNU Emacs. | 1419 | This file is part of GNU Emacs. |
| 936 | 1420 | ||
| 937 | GNU Emacs is free software: you can redistribute it and/or modify | 1421 | GNU Emacs is free software: you can redistribute it and/or modify |
| 938 | it under the terms of the GNU General Public License as published by | 1422 | it under the terms of the GNU General Public License as published by |
| 939 | the Free Software Foundation, either version 3 of the License, or | 1423 | the Free Software Foundation, either version 3 of the License, or |
| 940 | (at your option) any later version. | 1424 | (at your option) any later version. |
| 941 | 1425 | ||
| 942 | GNU Emacs is distributed in the hope that it will be useful, | 1426 | GNU Emacs is distributed in the hope that it will be useful, |
| 943 | but WITHOUT ANY WARRANTY; without even the implied warranty of | 1427 | but WITHOUT ANY WARRANTY; without even the implied warranty of |
| 944 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | 1428 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| 945 | GNU General Public License for more details. | 1429 | GNU General Public License for more details. |
| 946 | 1430 | ||
| 947 | You should have received a copy of the GNU General Public License | 1431 | You should have received a copy of the GNU General Public License |
| 948 | along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. | 1432 | along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. |
diff --git a/etc/images/icons/README b/etc/images/icons/README index 664c52906ac..d71641684cd 100644 --- a/etc/images/icons/README +++ b/etc/images/icons/README | |||
| @@ -9,13 +9,6 @@ Copyright (C) 2007-2012 Free Software Foundation, Inc. | |||
| 9 | License: GNU General Public License version 3 or later (see COPYING) | 9 | License: GNU General Public License version 3 or later (see COPYING) |
| 10 | 10 | ||
| 11 | 11 | ||
| 12 | Files: hicolor/16x16/apps/emacs22.png hicolor/24x24/apps/emacs22.png | ||
| 13 | hicolor/32x32/apps/emacs22.png hicolor/48x48/apps/emacs22.png | ||
| 14 | |||
| 15 | Author: Andrew Zhilin <andrew_zhilin@yahoo.com> | ||
| 16 | Copyright (C) 2005-2012 Free Software Foundation, Inc. | ||
| 17 | License: GNU General Public License version 3 or later (see COPYING) | ||
| 18 | |||
| 19 | Files: allout-widgets-dark-bg/closed.png | 12 | Files: allout-widgets-dark-bg/closed.png |
| 20 | allout-widgets-dark-bg/closed.xpm | 13 | allout-widgets-dark-bg/closed.xpm |
| 21 | allout-widgets-dark-bg/empty.png | 14 | allout-widgets-dark-bg/empty.png |
diff --git a/etc/images/icons/hicolor/16x16/apps/emacs22.png b/etc/images/icons/hicolor/16x16/apps/emacs22.png deleted file mode 100644 index b419b01b4ee..00000000000 --- a/etc/images/icons/hicolor/16x16/apps/emacs22.png +++ /dev/null | |||
| Binary files differ | |||
diff --git a/etc/images/icons/hicolor/24x24/apps/emacs22.png b/etc/images/icons/hicolor/24x24/apps/emacs22.png deleted file mode 100644 index 790ec7e2bff..00000000000 --- a/etc/images/icons/hicolor/24x24/apps/emacs22.png +++ /dev/null | |||
| Binary files differ | |||
diff --git a/etc/images/icons/hicolor/32x32/apps/emacs22.png b/etc/images/icons/hicolor/32x32/apps/emacs22.png deleted file mode 100644 index 31fbb47c0d2..00000000000 --- a/etc/images/icons/hicolor/32x32/apps/emacs22.png +++ /dev/null | |||
| Binary files differ | |||
diff --git a/etc/images/icons/hicolor/48x48/apps/emacs22.png b/etc/images/icons/hicolor/48x48/apps/emacs22.png deleted file mode 100644 index f0df0fb6594..00000000000 --- a/etc/images/icons/hicolor/48x48/apps/emacs22.png +++ /dev/null | |||
| Binary files differ | |||
diff --git a/etc/org/OrgOdtContentTemplate.xml b/etc/org/OrgOdtContentTemplate.xml index cd7ff0e1564..55e1b787066 100644 --- a/etc/org/OrgOdtContentTemplate.xml +++ b/etc/org/OrgOdtContentTemplate.xml | |||
| @@ -256,6 +256,7 @@ | |||
| 256 | <text:sequence-decl text:display-outline-level="0" text:name="Drawing"/> | 256 | <text:sequence-decl text:display-outline-level="0" text:name="Drawing"/> |
| 257 | <text:sequence-decl text:display-outline-level="0" text:name="Equation"/> | 257 | <text:sequence-decl text:display-outline-level="0" text:name="Equation"/> |
| 258 | <text:sequence-decl text:display-outline-level="0" text:name="Figure"/> | 258 | <text:sequence-decl text:display-outline-level="0" text:name="Figure"/> |
| 259 | <text:sequence-decl text:display-outline-level="0" text:name="Listing"/> | ||
| 259 | </text:sequence-decls> | 260 | </text:sequence-decls> |
| 260 | </office:text> | 261 | </office:text> |
| 261 | </office:body> | 262 | </office:body> |
diff --git a/etc/org/OrgOdtStyles.xml b/etc/org/OrgOdtStyles.xml index 84125c96d8a..5dfcfa83890 100644 --- a/etc/org/OrgOdtStyles.xml +++ b/etc/org/OrgOdtStyles.xml | |||
| @@ -319,6 +319,11 @@ | |||
| 319 | <style:style style:name="Table" style:family="paragraph" style:parent-style-name="Caption" style:class="extra"> | 319 | <style:style style:name="Table" style:family="paragraph" style:parent-style-name="Caption" style:class="extra"> |
| 320 | <style:paragraph-properties fo:text-align="center" style:justify-single-word="false"/> | 320 | <style:paragraph-properties fo:text-align="center" style:justify-single-word="false"/> |
| 321 | </style:style> | 321 | </style:style> |
| 322 | <style:style style:name="Listing" style:family="paragraph" style:parent-style-name="Caption" style:class="extra"> | ||
| 323 | <style:paragraph-properties fo:margin-left="0cm" fo:margin-right="0cm" fo:text-indent="0cm" style:auto-text-indent="false" fo:keep-with-next="always"> | ||
| 324 | <style:tab-stops/> | ||
| 325 | </style:paragraph-properties> | ||
| 326 | </style:style> | ||
| 322 | <style:style style:name="Horizontal_20_Line" style:display-name="Horizontal Line" style:family="paragraph" style:parent-style-name="Standard" style:next-style-name="Text_20_body" style:class="html"> | 327 | <style:style style:name="Horizontal_20_Line" style:display-name="Horizontal Line" style:family="paragraph" style:parent-style-name="Standard" style:next-style-name="Text_20_body" style:class="html"> |
| 323 | <style:paragraph-properties fo:margin-top="0cm" fo:margin-bottom="0.499cm" style:border-line-width-bottom="0.002cm 0.035cm 0.002cm" fo:padding="0cm" fo:border-left="none" fo:border-right="none" fo:border-top="none" fo:border-bottom="0.039cm double #808080" text:number-lines="false" text:line-number="0" style:join-border="false"/> | 328 | <style:paragraph-properties fo:margin-top="0cm" fo:margin-bottom="0.499cm" style:border-line-width-bottom="0.002cm 0.035cm 0.002cm" fo:padding="0cm" fo:border-left="none" fo:border-right="none" fo:border-top="none" fo:border-bottom="0.039cm double #808080" text:number-lines="false" text:line-number="0" style:join-border="false"/> |
| 324 | <style:text-properties fo:font-size="6pt" style:font-size-asian="6pt" style:font-size-complex="6pt"/> | 329 | <style:text-properties fo:font-size="6pt" style:font-size-asian="6pt" style:font-size-complex="6pt"/> |
diff --git a/etc/refcards/orgcard.pdf b/etc/refcards/orgcard.pdf index 2b474bf4e93..2f004418443 100644 --- a/etc/refcards/orgcard.pdf +++ b/etc/refcards/orgcard.pdf | |||
| Binary files differ | |||
diff --git a/etc/refcards/orgcard.tex b/etc/refcards/orgcard.tex index 60e81f36d3e..45b8ef04732 100644 --- a/etc/refcards/orgcard.tex +++ b/etc/refcards/orgcard.tex | |||
| @@ -1,5 +1,5 @@ | |||
| 1 | % Reference Card for Org Mode | 1 | % Reference Card for Org Mode |
| 2 | \def\orgversionnumber{7.8.11} | 2 | \def\orgversionnumber{7.9.2} |
| 3 | \def\versionyear{2012} % latest update | 3 | \def\versionyear{2012} % latest update |
| 4 | \input emacsver.tex | 4 | \input emacsver.tex |
| 5 | 5 | ||
diff --git a/etc/srecode/c.srt b/etc/srecode/c.srt new file mode 100644 index 00000000000..14d51ed02e6 --- /dev/null +++ b/etc/srecode/c.srt | |||
| @@ -0,0 +1,164 @@ | |||
| 1 | ;;; c.srt --- SRecode templates for c-mode | ||
| 2 | |||
| 3 | ;; Copyright (C) 2007, 2008, 2009, 2010, 2012 Free Software Foundation, Inc. | ||
| 4 | |||
| 5 | ;; Author: Eric M. Ludlam <eric@siege-engine.com> | ||
| 6 | |||
| 7 | ;; This file is part of GNU Emacs. | ||
| 8 | |||
| 9 | ;; GNU Emacs is free software: you can redistribute it and/or modify | ||
| 10 | ;; it under the terms of the GNU General Public License as published by | ||
| 11 | ;; the Free Software Foundation, either version 3 of the License, or | ||
| 12 | ;; (at your option) any later version. | ||
| 13 | |||
| 14 | ;; GNU Emacs is distributed in the hope that it will be useful, | ||
| 15 | ;; but WITHOUT ANY WARRANTY; without even the implied warranty of | ||
| 16 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the | ||
| 17 | ;; GNU General Public License for more details. | ||
| 18 | |||
| 19 | ;; You should have received a copy of the GNU General Public License | ||
| 20 | ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>. | ||
| 21 | |||
| 22 | set mode "c-mode" | ||
| 23 | |||
| 24 | set comment_start "/**" | ||
| 25 | set comment_end " */" | ||
| 26 | set comment_prefix " *" | ||
| 27 | |||
| 28 | ;; OVERRIDE THIS in your user or project template file to whatever | ||
| 29 | ;; you use for your project. | ||
| 30 | set HEADEREXT ".h" | ||
| 31 | |||
| 32 | context file | ||
| 33 | |||
| 34 | template empty :time :user :file :c | ||
| 35 | ---- | ||
| 36 | {{>:filecomment}} | ||
| 37 | |||
| 38 | {{#NOTHEADER}} | ||
| 39 | |||
| 40 | {{^}} | ||
| 41 | {{/NOTHEADER}} | ||
| 42 | {{#HEADER}} | ||
| 43 | {{>:header_guard}} | ||
| 44 | {{/HEADER}} | ||
| 45 | ---- | ||
| 46 | |||
| 47 | template header_guard :file :blank | ||
| 48 | ---- | ||
| 49 | #ifndef {{FILENAME_SYMBOL}} | ||
| 50 | #define {{FILENAME_SYMBOL}} 1 | ||
| 51 | |||
| 52 | {{^}} | ||
| 53 | |||
| 54 | #endif // {{FILENAME_SYMBOL}} | ||
| 55 | ---- | ||
| 56 | |||
| 57 | context misc | ||
| 58 | |||
| 59 | template arglist | ||
| 60 | "Insert an argument list for a function. | ||
| 61 | @todo - Support smart CR in a buffer for not too long lines." | ||
| 62 | ---- | ||
| 63 | ({{#ARGS}}{{TYPE}} {{NAME}}{{#NOTLAST}},{{/NOTLAST}}{{/ARGS}}) | ||
| 64 | ---- | ||
| 65 | |||
| 66 | context declaration | ||
| 67 | |||
| 68 | prompt TYPE "Return Type: " | ||
| 69 | |||
| 70 | template function :indent :blank | ||
| 71 | "Insert a function declaration." | ||
| 72 | ---- | ||
| 73 | {{?TYPE}} {{?NAME}}{{>:misc:arglist}} | ||
| 74 | {{#INITIALIZERS}}{{>B:initializers}}{{/INITIALIZERS}} | ||
| 75 | { | ||
| 76 | {{^}} | ||
| 77 | } | ||
| 78 | ---- | ||
| 79 | bind "f" | ||
| 80 | |||
| 81 | template function-prototype :indent :blank | ||
| 82 | "Insert a function declaration." | ||
| 83 | ---- | ||
| 84 | {{?TYPE}} {{?NAME}}{{>:misc:arglist}}; | ||
| 85 | ---- | ||
| 86 | |||
| 87 | |||
| 88 | prompt TYPE "Data Type: " | ||
| 89 | |||
| 90 | template variable :indent :blank | ||
| 91 | "Insert a variable declaration." | ||
| 92 | ---- | ||
| 93 | {{?TYPE}} {{?NAME}}{{#HAVEDEFAULT}} = {{DEFAULT}}{{/HAVEDEFAULT}}; | ||
| 94 | ---- | ||
| 95 | bind "v" | ||
| 96 | |||
| 97 | template variable-prototype :indent :blank | ||
| 98 | "Insert a variable declaration." | ||
| 99 | ---- | ||
| 100 | {{?TYPE}} {{?NAME}}; | ||
| 101 | ---- | ||
| 102 | bind "v" | ||
| 103 | |||
| 104 | |||
| 105 | template include :blank | ||
| 106 | "An include statement." | ||
| 107 | ---- | ||
| 108 | #include "{{?NAME}}" | ||
| 109 | ---- | ||
| 110 | bind "i" | ||
| 111 | |||
| 112 | template system-include :blank | ||
| 113 | "An include statement." | ||
| 114 | ---- | ||
| 115 | #include <{{?NAME}}> | ||
| 116 | ---- | ||
| 117 | bind "i" | ||
| 118 | |||
| 119 | template label :blank :indent | ||
| 120 | ---- | ||
| 121 | {{?NAME}}: | ||
| 122 | ---- | ||
| 123 | |||
| 124 | context declaration | ||
| 125 | |||
| 126 | template comment-function :indent :blank | ||
| 127 | "Used to put a nice comment in front of a function. | ||
| 128 | Override this with your own preference to avoid using doxygen" | ||
| 129 | ---- | ||
| 130 | {{>A:declaration:doxygen-function}} | ||
| 131 | ---- | ||
| 132 | |||
| 133 | ;;; DOXYGEN FEATURES | ||
| 134 | ;; | ||
| 135 | ;; | ||
| 136 | context declaration | ||
| 137 | |||
| 138 | template doxygen-function :indent :blank | ||
| 139 | ---- | ||
| 140 | /** | ||
| 141 | * @name {{NAME}} - {{DOC}}{{^}}{{#ARGS}} | ||
| 142 | * @param {{NAME}} - {{DOC}}{{/ARGS}} | ||
| 143 | * @return {{TYPE}} | ||
| 144 | */ | ||
| 145 | ---- | ||
| 146 | |||
| 147 | template doxygen-variable-same-line | ||
| 148 | ---- | ||
| 149 | /**< {{DOC}}{{^}} */ | ||
| 150 | ---- | ||
| 151 | |||
| 152 | template doxygen-section-comment :blank :indent | ||
| 153 | "Insert a comment that separates sections of an Emacs Lisp file." | ||
| 154 | ---- | ||
| 155 | |||
| 156 | /** {{?TITLE}} | ||
| 157 | * | ||
| 158 | * {{^}} | ||
| 159 | */ | ||
| 160 | |||
| 161 | ---- | ||
| 162 | |||
| 163 | |||
| 164 | ;; end | ||
diff --git a/etc/srecode/cpp.srt b/etc/srecode/cpp.srt index 16cfc535761..f73dcd2a1ca 100644 --- a/etc/srecode/cpp.srt +++ b/etc/srecode/cpp.srt | |||
| @@ -25,82 +25,8 @@ set comment_start "/**" | |||
| 25 | set comment_end " */" | 25 | set comment_end " */" |
| 26 | set comment_prefix " *" | 26 | set comment_prefix " *" |
| 27 | 27 | ||
| 28 | ;; OVERRIDE THIS in your user or project template file to whatever | ||
| 29 | ;; you use for your project. | ||
| 30 | set HEADEREXT ".h" | ||
| 31 | |||
| 32 | context file | ||
| 33 | |||
| 34 | template empty :time :user :file :cpp | ||
| 35 | ---- | ||
| 36 | {{>:filecomment}} | ||
| 37 | |||
| 38 | {{#NOTHEADER}} | ||
| 39 | |||
| 40 | {{^}} | ||
| 41 | {{/NOTHEADER}} | ||
| 42 | {{#HEADER}} | ||
| 43 | {{>:header_guard}} | ||
| 44 | {{/HEADER}} | ||
| 45 | ---- | ||
| 46 | |||
| 47 | template header_guard :file :blank | ||
| 48 | ---- | ||
| 49 | #ifndef {{FILENAME_SYMBOL}} | ||
| 50 | #define {{FILENAME_SYMBOL}} 1 | ||
| 51 | |||
| 52 | {{^}} | ||
| 53 | |||
| 54 | #endif // {{FILENAME_SYMBOL}} | ||
| 55 | ---- | ||
| 56 | |||
| 57 | context misc | ||
| 58 | |||
| 59 | template arglist | ||
| 60 | "Insert an argument list for a function. | ||
| 61 | @todo - Support smart CR in a buffer for not too long lines." | ||
| 62 | ---- | ||
| 63 | ({{#ARGS}}{{TYPE}} {{NAME}}{{#NOTLAST}},{{/NOTLAST}}{{/ARGS}}) | ||
| 64 | ---- | ||
| 65 | |||
| 66 | context declaration | 28 | context declaration |
| 67 | 29 | ||
| 68 | prompt TYPE "Return Type: " | ||
| 69 | |||
| 70 | template function :indent :blank | ||
| 71 | "Insert a function declaration." | ||
| 72 | ---- | ||
| 73 | {{?TYPE}} {{?NAME}}{{>:misc:arglist}} | ||
| 74 | {{#INITIALIZERS}}{{>B:initializers}}{{/INITIALIZERS}} | ||
| 75 | { | ||
| 76 | {{^}} | ||
| 77 | } | ||
| 78 | ---- | ||
| 79 | bind "f" | ||
| 80 | |||
| 81 | template function-prototype :indent :blank | ||
| 82 | "Insert a function declaration." | ||
| 83 | ---- | ||
| 84 | {{?TYPE}} {{?NAME}}{{>:misc:arglist}}; | ||
| 85 | ---- | ||
| 86 | |||
| 87 | |||
| 88 | prompt TYPE "Data Type: " | ||
| 89 | |||
| 90 | template variable :indent :blank | ||
| 91 | "Insert a variable declaration." | ||
| 92 | ---- | ||
| 93 | {{?TYPE}} {{?NAME}}{{#HAVEDEFAULT}} = {{DEFAULT}}{{/HAVEDEFAULT}}; | ||
| 94 | ---- | ||
| 95 | bind "v" | ||
| 96 | |||
| 97 | template variable-prototype :indent :blank | ||
| 98 | "Insert a variable declaration." | ||
| 99 | ---- | ||
| 100 | {{?TYPE}} {{?NAME}}; | ||
| 101 | ---- | ||
| 102 | bind "v" | ||
| 103 | |||
| 104 | template class :indent :blank | 30 | template class :indent :blank |
| 105 | "Insert a C++ class. For use by user insertion. | 31 | "Insert a C++ class. For use by user insertion. |
| 106 | Override this template to change contents of a class. | 32 | Override this template to change contents of a class. |
| @@ -146,18 +72,6 @@ template method :indent :blank | |||
| 146 | } | 72 | } |
| 147 | ---- | 73 | ---- |
| 148 | 74 | ||
| 149 | template include :blank | ||
| 150 | "An include statement." | ||
| 151 | ---- | ||
| 152 | #include "{{?NAME}}" | ||
| 153 | ---- | ||
| 154 | bind "i" | ||
| 155 | |||
| 156 | template label :blank :indent | ||
| 157 | ---- | ||
| 158 | {{?NAME}}: | ||
| 159 | ---- | ||
| 160 | |||
| 161 | context classdecl | 75 | context classdecl |
| 162 | 76 | ||
| 163 | template constructor-tag :indent :blank | 77 | template constructor-tag :indent :blank |
| @@ -196,15 +110,6 @@ Override this with your own preference to avoid using doxygen." | |||
| 196 | {{>A:classdecl:doxygen-function-group-end}} | 110 | {{>A:classdecl:doxygen-function-group-end}} |
| 197 | ---- | 111 | ---- |
| 198 | 112 | ||
| 199 | context declaration | ||
| 200 | |||
| 201 | template comment-function :indent :blank | ||
| 202 | "Used to put a nice comment in front of a function. | ||
| 203 | Override this with your own preference to avoid using doxygen" | ||
| 204 | ---- | ||
| 205 | {{>A:declaration:doxygen-function}} | ||
| 206 | ---- | ||
| 207 | |||
| 208 | ;;; DOXYGEN FEATURES | 113 | ;;; DOXYGEN FEATURES |
| 209 | ;; | 114 | ;; |
| 210 | ;; | 115 | ;; |
| @@ -229,32 +134,4 @@ template doxygen-function-group-end :indent :blank | |||
| 229 | 134 | ||
| 230 | ---- | 135 | ---- |
| 231 | 136 | ||
| 232 | context declaration | ||
| 233 | |||
| 234 | template doxygen-function :indent :blank | ||
| 235 | ---- | ||
| 236 | /** | ||
| 237 | * @name {{NAME}} - {{DOC}}{{^}}{{#ARGS}} | ||
| 238 | * @param {{NAME}} - {{DOC}}{{/ARGS}} | ||
| 239 | * @return {{TYPE}} | ||
| 240 | */ | ||
| 241 | ---- | ||
| 242 | |||
| 243 | template doxygen-variable-same-line | ||
| 244 | ---- | ||
| 245 | /**< {{DOC}}{{^}} */ | ||
| 246 | ---- | ||
| 247 | |||
| 248 | template doxygen-section-comment :blank :indent | ||
| 249 | "Insert a comment that separates sections of an Emacs Lisp file." | ||
| 250 | ---- | ||
| 251 | |||
| 252 | /** {{?TITLE}} | ||
| 253 | * | ||
| 254 | * {{^}} | ||
| 255 | */ | ||
| 256 | |||
| 257 | ---- | ||
| 258 | |||
| 259 | |||
| 260 | ;; end | 137 | ;; end |
diff --git a/etc/srecode/ede-autoconf.srt b/etc/srecode/ede-autoconf.srt new file mode 100644 index 00000000000..daefd532dff --- /dev/null +++ b/etc/srecode/ede-autoconf.srt | |||
| @@ -0,0 +1,54 @@ | |||
| 1 | ;; ede/templates/autoconf.srt --- Templates for autoconf used by EDE. | ||
| 2 | ;; | ||
| 3 | ;; Copyright (C) 2010 Eric M. Ludlam | ||
| 4 | ;; | ||
| 5 | ;; Author: Eric M. Ludlam <eric@siege-engine.com> | ||
| 6 | ;; | ||
| 7 | ;; This program is free software; you can redistribute it and/or | ||
| 8 | ;; modify it under the terms of the GNU General Public License as | ||
| 9 | ;; published by the Free Software Foundation; either version 2, or (at | ||
| 10 | ;; your option) any later version. | ||
| 11 | |||
| 12 | ;; This program is distributed in the hope that it will be useful, but | ||
| 13 | ;; WITHOUT ANY WARRANTY; without even the implied warranty of | ||
| 14 | ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | ||
| 15 | ;; General Public License for more details. | ||
| 16 | |||
| 17 | ;; You should have received a copy of the GNU General Public License | ||
| 18 | ;; along with this program; see the file COPYING. If not, write to | ||
| 19 | ;; the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, | ||
| 20 | ;; Boston, MA 02110-1301, USA. | ||
| 21 | |||
| 22 | set mode "autoconf-mode" | ||
| 23 | set escape_start "{{" | ||
| 24 | set escape_end "}}" | ||
| 25 | set comment_start "#" | ||
| 26 | set comment_prefix "#" | ||
| 27 | set application "ede" | ||
| 28 | |||
| 29 | context file | ||
| 30 | |||
| 31 | template ede-empty | ||
| 32 | "Start a new EDE generated configure.in/ac file." | ||
| 33 | ---- | ||
| 34 | {{comment_prefix}} Automatically Generated/Maintained {{FILE}} by EDE. | ||
| 35 | {{comment_prefix}} | ||
| 36 | {{comment_prefix}} YOU MAY MODIFY THIS FILE | ||
| 37 | {{comment_prefix}} Hand made changes in some sections will be preserved | ||
| 38 | {{comment_prefix}} by EDE when this file is updated. | ||
| 39 | {{comment_prefix}} | ||
| 40 | {{comment_prefix}} EDE is the Emacs Development Environment. | ||
| 41 | {{comment_prefix}} http://cedet.sourceforge.net/ede.shtml | ||
| 42 | {{comment_prefix}} | ||
| 43 | {{comment_prefix}} Process this file with autoconf to produce a configure script | ||
| 44 | |||
| 45 | AC_INIT({{TEST_FILE}}) | ||
| 46 | AM_INIT_AUTOMAKE([{{PROGRAM}}], 0) | ||
| 47 | AM_CONFIG_HEADER(config.h) | ||
| 48 | |||
| 49 | {{comment_prefix}} End the configure script. | ||
| 50 | AC_OUTPUT(Makefile, [date > stamp-h] ) | ||
| 51 | ---- | ||
| 52 | |||
| 53 | |||
| 54 | ;; end | ||
diff --git a/etc/srecode/ede-make.srt b/etc/srecode/ede-make.srt index 97725f4ff56..0b024cd30e4 100644 --- a/etc/srecode/ede-make.srt +++ b/etc/srecode/ede-make.srt | |||
| @@ -46,4 +46,36 @@ template ede-vars | |||
| 46 | {{NAME}}={{#VALUE}} {{VAL}}{{/VALUE}}{{/VARIABLE}} | 46 | {{NAME}}={{#VALUE}} {{VAL}}{{/VALUE}}{{/VARIABLE}} |
| 47 | ---- | 47 | ---- |
| 48 | 48 | ||
| 49 | ;; Some extra templates for Arduino based Makefiles. | ||
| 50 | ;; Perhaps split this out someday in the future. | ||
| 51 | context arduino | ||
| 52 | |||
| 53 | template ede-empty :file | ||
| 54 | ---- | ||
| 55 | # Automatically Generated {{FILE}} by EDE. | ||
| 56 | # For use with Make for an Arduino project. | ||
| 57 | # | ||
| 58 | # DO NOT MODIFY THIS FILE OR YOUR CHANGES MAY BE LOST. | ||
| 59 | # EDE is the Emacs Development Environment. | ||
| 60 | # http://cedet.sourceforge.net/ede.shtml | ||
| 61 | |||
| 62 | ARDUINO_DIR = {{ARDUINO_HOME}} | ||
| 63 | |||
| 64 | TARGET = {{TARGET}} | ||
| 65 | ARDUINO_LIBS = {{ARDUINO_LIBS}} | ||
| 66 | |||
| 67 | MCU = {{MCU}} | ||
| 68 | F_CPU = {{F_CPU}} | ||
| 69 | ARDUINO_PORT = {{PORT}} | ||
| 70 | BOARD_TAG = {{BOARD}} | ||
| 71 | |||
| 72 | AVRDUDE_ARD_BAUDRATE = {{AVRDUDE_ARD_BAUDRATE}} | ||
| 73 | AVRDUDE_ARD_PROGRAMMER = {{AVRDUDE_ARD_PROGRAMMER}} | ||
| 74 | |||
| 75 | include {{ARDUINO_MK}} | ||
| 76 | |||
| 77 | # End of Makefile | ||
| 78 | ---- | ||
| 79 | |||
| 80 | |||
| 49 | ;; end | 81 | ;; end |
diff --git a/etc/srecode/el.srt b/etc/srecode/el.srt index cc5af736f15..34a8983b29f 100644 --- a/etc/srecode/el.srt +++ b/etc/srecode/el.srt | |||
| @@ -197,7 +197,7 @@ template variable-option :el :el-custom :indent :blank | |||
| 197 | ---- | 197 | ---- |
| 198 | (defcustom $?NAME$ $^$ | 198 | (defcustom $?NAME$ $^$ |
| 199 | "*$DOC$" | 199 | "*$DOC$" |
| 200 | :group $GROUP$ | 200 | :group '$GROUP$ |
| 201 | :type $?CUSTOMTYPE$) | 201 | :type $?CUSTOMTYPE$) |
| 202 | ---- | 202 | ---- |
| 203 | bind "o" | 203 | bind "o" |