aboutsummaryrefslogtreecommitdiffstats
path: root/etc
diff options
context:
space:
mode:
Diffstat (limited to 'etc')
-rw-r--r--etc/ChangeLog43
-rw-r--r--etc/NEWS13
-rw-r--r--etc/ORG-NEWS1966
-rw-r--r--etc/images/icons/README7
-rw-r--r--etc/images/icons/hicolor/16x16/apps/emacs22.pngbin705 -> 0 bytes
-rw-r--r--etc/images/icons/hicolor/24x24/apps/emacs22.pngbin988 -> 0 bytes
-rw-r--r--etc/images/icons/hicolor/32x32/apps/emacs22.pngbin2404 -> 0 bytes
-rw-r--r--etc/images/icons/hicolor/48x48/apps/emacs22.pngbin3431 -> 0 bytes
-rw-r--r--etc/org/OrgOdtContentTemplate.xml1
-rw-r--r--etc/org/OrgOdtStyles.xml5
-rw-r--r--etc/refcards/orgcard.pdfbin118438 -> 118438 bytes
-rw-r--r--etc/refcards/orgcard.tex2
-rw-r--r--etc/srecode/c.srt164
-rw-r--r--etc/srecode/cpp.srt123
-rw-r--r--etc/srecode/ede-autoconf.srt54
-rw-r--r--etc/srecode/ede-make.srt32
-rw-r--r--etc/srecode/el.srt2
-rw-r--r--etc/tutorials/TUTORIAL.pt_BR2
-rw-r--r--etc/tutorials/TUTORIAL.ru2
19 files changed, 1539 insertions, 877 deletions
diff --git a/etc/ChangeLog b/etc/ChangeLog
index 099d7ca044f..ad6c6395e49 100644
--- a/etc/ChangeLog
+++ b/etc/ChangeLog
@@ -1,3 +1,46 @@
12012-10-05 Douglas Lewan <d_lewan2000@yahoo.com> (tiny change)
2
3 * tutorials/TUTORIAL.pt_BR: Fix typo. (Bug#12557)
4
52012-10-01 Eric Ludlam <zappo@gnu.org>
6
7 * srecode/cc.srt, srecode/ede-autoconf.srt: New files.
8
9 * srecode/cpp.srt: Move parts to c.srt.
10
11 * srecode/ede-make.srt: Extra templates for Arduino Makefiles.
12
132012-10-01 Ralf Mattes <rm@mh-freiburg.de> (tiny change)
14
15 * srecode/el.srt (variable-option): Add missing quote.
16
172012-10-01 Chong Yidong <cyd@gnu.org>
18
19 * images/icons/hicolor/32x32/apps/emacs22.png:
20 * images/icons/hicolor/16x16/apps/emacs22.png:
21 * images/icons/hicolor/48x48/apps/emacs22.png:
22 * images/icons/hicolor/24x24/apps/emacs22.png: Remove old icons
23 (Bug#12536).
24
252012-10-01 Paul Eggert <eggert@cs.ucla.edu>
26
27 Revert the FOLLOW-SYMLINKS change for file-attributes.
28 * NEWS: Undo last change.
29
302012-09-30 Bastien Guerry <bzg@gnu.org>
31
32 * refcards/orgcard.tex: Update version number.
33
342012-09-30 Jambunathan K <kjambunathan@gmail.com>
35
36 * org/OrgOdtContentTemplate.xml:
37 * org/OrgOdtStyles.xml: Add Listing-related entries.
38
392012-09-30 Paul Eggert <eggert@cs.ucla.edu>
40
41 file-attributes has a new optional arg FOLLOW-SYMLINKS.
42 * NEWS: Document the change.
43
12012-09-30 Jan Djärv <jan.h.d@swipnet.se> 442012-09-30 Jan Djärv <jan.h.d@swipnet.se>
2 45
3 * NEWS: The NS port supports fullscreen. 46 * NEWS: The NS port supports fullscreen.
diff --git a/etc/NEWS b/etc/NEWS
index 2791a25e051..be75b665c1d 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -160,6 +160,8 @@ On encountering a fatal error, Emacs now outputs a textual description
160of the fatal signal, and a short backtrace on platforms like glibc 160of the fatal signal, and a short backtrace on platforms like glibc
161that support backtraces. 161that support backtraces.
162 162
163** `message-log-max' now defaults to 1000, not 100.
164
163--- 165---
164** 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
165`emacs-bzr-version' contains information about the bzr revision used. 167`emacs-bzr-version' contains information about the bzr revision used.
@@ -617,6 +619,8 @@ inefficiency, and not namespace-clean.
617 619
618* Incompatible Lisp Changes in Emacs 24.3 620* Incompatible Lisp Changes in Emacs 24.3
619 621
622** set-buffer-multibyte now signals an error in narrowed buffers.
623
620+++ 624+++
621** (random) by default now returns a different random sequence in 625** (random) by default now returns a different random sequence in
622every Emacs run. Use (random S), where S is a string, to set the 626every Emacs run. Use (random S), where S is a string, to set the
@@ -682,7 +686,7 @@ are deprecated and will be removed eventually.
682**** inactivate-current-input-method-function -> 686**** inactivate-current-input-method-function ->
683 deactivate-current-input-method-function 687 deactivate-current-input-method-function
684 688
685** Some obsolete functions and variables were removed: 689** Some obsolete functions, variables, and faces were removed:
686 690
687*** `facemenu-unlisted-faces' 691*** `facemenu-unlisted-faces'
688*** `rmail-decode-mime-charset' 692*** `rmail-decode-mime-charset'
@@ -701,6 +705,7 @@ are deprecated and will be removed eventually.
701*** `vc-ignore-vc-files' (use `vc-handled-backends' instead) 705*** `vc-ignore-vc-files' (use `vc-handled-backends' instead)
702*** `vc-master-templates' (use `vc-handled-backends' instead) 706*** `vc-master-templates' (use `vc-handled-backends' instead)
703*** `vc-checkout-carefully' 707*** `vc-checkout-carefully'
708*** `modeline'
704 709
705 710
706* Lisp changes in Emacs 24.3 711* Lisp changes in Emacs 24.3
@@ -787,6 +792,7 @@ in Emacs 24.1:
787**** `special-display-buffer-names' 792**** `special-display-buffer-names'
788**** `special-display-function' 793**** `special-display-function'
789**** `display-buffer-function' 794**** `display-buffer-function'
795**** `dired-shrink-to-fit'
790 796
791** Time 797** Time
792--- 798---
@@ -818,7 +824,8 @@ This can significantly speed up execution of non-byte-compiled code,
818but can also bump into harmless and previously unnoticed cyclic 824but can also bump into harmless and previously unnoticed cyclic
819dependencies. These should not be fatal: they will simply cause the 825dependencies. These should not be fatal: they will simply cause the
820macro-calls to be left for later expansion (as before), but will also 826macro-calls to be left for later expansion (as before), but will also
821result in a warning describing the cycle. 827result in a warning ("Eager macro-expansion skipped due to cycle")
828describing the cycle.
822 829
823** Misc new functions: 830** Misc new functions:
824 831
@@ -850,6 +857,8 @@ See the "Face Attributes" section of the Elisp manual.
850*** `buffer-has-markers-at' 857*** `buffer-has-markers-at'
851*** `macro-declaration-function' (use `macro-declarations-alist'). 858*** `macro-declaration-function' (use `macro-declarations-alist').
852*** `window-system-version' 859*** `window-system-version'
860*** `dired-pop-to-buffer' (use `dired-mark-pop-up')
861*** `query-replace-interactive'
853 862
854 863
855* Changes in Emacs 24.3 on non-free operating systems 864* Changes in Emacs 24.3 on non-free operating systems
diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS
index a5b88d3f451..c6851948368 100644
--- a/etc/ORG-NEWS
+++ b/etc/ORG-NEWS
@@ -5,267 +5,894 @@ See the end of the file for license conditions.
5 5
6Please send Org bug reports to emacs-orgmode@gnu.org. 6Please 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 12You 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 18It contains both the =org-*.tar= package (the core Org distribution, also
196 you have decided to move over completely to the new 19available through http://elpa.gnu.org) and the =org-plus*.tar= package (the
197 implementation. During a test time, there is nothing wrong 20extended Org distribution, with non-GNU packages from the =contrib/=
198 with using both system in parallel. 21directory.)
199 22
200* New libraries 23See 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
215This package generalizes the #+begin_foo and #+end_foo tokens. 45*** =org-eshell.el= by Konrad Hinsen is now in Org
216 46
217To 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 analyzing "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 particularly 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 "&tilde;" "~" "~" "~")
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
537supported.
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
542results in a =#+BEGIN_SRC org= block, with comma-escaped lines.
543
544=#+BEGIN_ORG= blocks are obsolete.
545
546**** Exporting =#+BEGIN_SRC org= blocks exports the code
547
548It 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
555If you capture to an encrypted entry, it will be decrypted before
556inserting the template then re-encrypted after finalizing the capture.
557
558**** Inactive timestamps are now handled in tables
559
560Calc can do computation on active time-stamps like <2012-09-29 sat.>.
561Inactive time-stamps in a table's cell are now internally deactivated so
562that 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
223The tokens #+begin_center, #+begin_verse, etc. existed previously. This 856 The tokens #+begin_center, #+begin_verse, etc. existed
224package generalizes them (at least for the LaTeX and html exporters). When 857 previously. This package generalizes them (at least for the
225a #+begin_foo token is encountered by the LaTeX exporter, it is expanded 858 LaTeX and html exporters). When a #+begin_foo token is
226into \begin{foo}. The text inside the environment is not protected, as 859 encountered by the LaTeX exporter, it is expanded
227text inside environments generally is. When #+begin_foo is encountered by 860 into \begin{foo}. The text inside the environment is not
228the html exporter, a div with class foo is inserted into the HTML file. It 861 protected, as text inside environments generally is.
229is 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
230to 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 particularly
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 Wiegley's 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
935This file is part of GNU Emacs. 1419 This file is part of GNU Emacs.
936 1420
937GNU Emacs is free software: you can redistribute it and/or modify 1421 GNU Emacs is free software: you can redistribute it and/or modify
938it 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
939the 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
942GNU Emacs is distributed in the hope that it will be useful, 1426 GNU Emacs is distributed in the hope that it will be useful,
943but WITHOUT ANY WARRANTY; without even the implied warranty of 1427 but WITHOUT ANY WARRANTY; without even the implied warranty of
944MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 1428 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
945GNU General Public License for more details. 1429 GNU General Public License for more details.
946 1430
947You should have received a copy of the GNU General Public License 1431 You should have received a copy of the GNU General Public License
948along 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.
9License: GNU General Public License version 3 or later (see COPYING) 9License: GNU General Public License version 3 or later (see COPYING)
10 10
11 11
12Files: hicolor/16x16/apps/emacs22.png hicolor/24x24/apps/emacs22.png
13 hicolor/32x32/apps/emacs22.png hicolor/48x48/apps/emacs22.png
14
15Author: Andrew Zhilin <andrew_zhilin@yahoo.com>
16Copyright (C) 2005-2012 Free Software Foundation, Inc.
17License: GNU General Public License version 3 or later (see COPYING)
18
19Files: allout-widgets-dark-bg/closed.png 12Files: 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
22set mode "c-mode"
23
24set comment_start "/**"
25set comment_end " */"
26set comment_prefix " *"
27
28;; OVERRIDE THIS in your user or project template file to whatever
29;; you use for your project.
30set HEADEREXT ".h"
31
32context file
33
34template empty :time :user :file :c
35----
36{{>:filecomment}}
37
38{{#NOTHEADER}}
39
40{{^}}
41{{/NOTHEADER}}
42{{#HEADER}}
43{{>:header_guard}}
44{{/HEADER}}
45----
46
47template header_guard :file :blank
48----
49#ifndef {{FILENAME_SYMBOL}}
50#define {{FILENAME_SYMBOL}} 1
51
52{{^}}
53
54#endif // {{FILENAME_SYMBOL}}
55----
56
57context misc
58
59template 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
66context declaration
67
68prompt TYPE "Return Type: "
69
70template function :indent :blank
71"Insert a function declaration."
72----
73{{?TYPE}} {{?NAME}}{{>:misc:arglist}}
74{{#INITIALIZERS}}{{>B:initializers}}{{/INITIALIZERS}}
75{
76{{^}}
77}
78----
79bind "f"
80
81template function-prototype :indent :blank
82"Insert a function declaration."
83----
84{{?TYPE}} {{?NAME}}{{>:misc:arglist}};
85----
86
87
88prompt TYPE "Data Type: "
89
90template variable :indent :blank
91"Insert a variable declaration."
92----
93{{?TYPE}} {{?NAME}}{{#HAVEDEFAULT}} = {{DEFAULT}}{{/HAVEDEFAULT}};
94----
95bind "v"
96
97template variable-prototype :indent :blank
98"Insert a variable declaration."
99----
100{{?TYPE}} {{?NAME}};
101----
102bind "v"
103
104
105template include :blank
106"An include statement."
107----
108#include "{{?NAME}}"
109----
110bind "i"
111
112template system-include :blank
113"An include statement."
114----
115#include <{{?NAME}}>
116----
117bind "i"
118
119template label :blank :indent
120----
121 {{?NAME}}:
122----
123
124context declaration
125
126template comment-function :indent :blank
127"Used to put a nice comment in front of a function.
128Override this with your own preference to avoid using doxygen"
129----
130{{>A:declaration:doxygen-function}}
131----
132
133;;; DOXYGEN FEATURES
134;;
135;;
136context declaration
137
138template doxygen-function :indent :blank
139----
140/**
141 * @name {{NAME}} - {{DOC}}{{^}}{{#ARGS}}
142 * @param {{NAME}} - {{DOC}}{{/ARGS}}
143 * @return {{TYPE}}
144 */
145----
146
147template doxygen-variable-same-line
148----
149/**< {{DOC}}{{^}} */
150----
151
152template 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 "/**"
25set comment_end " */" 25set comment_end " */"
26set comment_prefix " *" 26set comment_prefix " *"
27 27
28;; OVERRIDE THIS in your user or project template file to whatever
29;; you use for your project.
30set HEADEREXT ".h"
31
32context file
33
34template empty :time :user :file :cpp
35----
36{{>:filecomment}}
37
38{{#NOTHEADER}}
39
40{{^}}
41{{/NOTHEADER}}
42{{#HEADER}}
43{{>:header_guard}}
44{{/HEADER}}
45----
46
47template header_guard :file :blank
48----
49#ifndef {{FILENAME_SYMBOL}}
50#define {{FILENAME_SYMBOL}} 1
51
52{{^}}
53
54#endif // {{FILENAME_SYMBOL}}
55----
56
57context misc
58
59template 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
66context declaration 28context declaration
67 29
68prompt TYPE "Return Type: "
69
70template function :indent :blank
71"Insert a function declaration."
72----
73{{?TYPE}} {{?NAME}}{{>:misc:arglist}}
74{{#INITIALIZERS}}{{>B:initializers}}{{/INITIALIZERS}}
75{
76{{^}}
77}
78----
79bind "f"
80
81template function-prototype :indent :blank
82"Insert a function declaration."
83----
84{{?TYPE}} {{?NAME}}{{>:misc:arglist}};
85----
86
87
88prompt TYPE "Data Type: "
89
90template variable :indent :blank
91"Insert a variable declaration."
92----
93{{?TYPE}} {{?NAME}}{{#HAVEDEFAULT}} = {{DEFAULT}}{{/HAVEDEFAULT}};
94----
95bind "v"
96
97template variable-prototype :indent :blank
98"Insert a variable declaration."
99----
100{{?TYPE}} {{?NAME}};
101----
102bind "v"
103
104template class :indent :blank 30template class :indent :blank
105"Insert a C++ class. For use by user insertion. 31"Insert a C++ class. For use by user insertion.
106Override this template to change contents of a class. 32Override this template to change contents of a class.
@@ -146,18 +72,6 @@ template method :indent :blank
146} 72}
147---- 73----
148 74
149template include :blank
150"An include statement."
151----
152#include "{{?NAME}}"
153----
154bind "i"
155
156template label :blank :indent
157----
158 {{?NAME}}:
159----
160
161context classdecl 75context classdecl
162 76
163template constructor-tag :indent :blank 77template 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
199context declaration
200
201template comment-function :indent :blank
202"Used to put a nice comment in front of a function.
203Override 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
232context declaration
233
234template doxygen-function :indent :blank
235----
236/**
237 * @name {{NAME}} - {{DOC}}{{^}}{{#ARGS}}
238 * @param {{NAME}} - {{DOC}}{{/ARGS}}
239 * @return {{TYPE}}
240 */
241----
242
243template doxygen-variable-same-line
244----
245/**< {{DOC}}{{^}} */
246----
247
248template 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
22set mode "autoconf-mode"
23set escape_start "{{"
24set escape_end "}}"
25set comment_start "#"
26set comment_prefix "#"
27set application "ede"
28
29context file
30
31template 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
45AC_INIT({{TEST_FILE}})
46AM_INIT_AUTOMAKE([{{PROGRAM}}], 0)
47AM_CONFIG_HEADER(config.h)
48
49{{comment_prefix}} End the configure script.
50AC_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.
51context arduino
52
53template 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
62ARDUINO_DIR = {{ARDUINO_HOME}}
63
64TARGET = {{TARGET}}
65ARDUINO_LIBS = {{ARDUINO_LIBS}}
66
67MCU = {{MCU}}
68F_CPU = {{F_CPU}}
69ARDUINO_PORT = {{PORT}}
70BOARD_TAG = {{BOARD}}
71
72AVRDUDE_ARD_BAUDRATE = {{AVRDUDE_ARD_BAUDRATE}}
73AVRDUDE_ARD_PROGRAMMER = {{AVRDUDE_ARD_PROGRAMMER}}
74
75include {{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----
203bind "o" 203bind "o"
diff --git a/etc/tutorials/TUTORIAL.pt_BR b/etc/tutorials/TUTORIAL.pt_BR
index 139789b1d2a..f28f86b3105 100644
--- a/etc/tutorials/TUTORIAL.pt_BR
+++ b/etc/tutorials/TUTORIAL.pt_BR
@@ -46,7 +46,7 @@ META, EDIT ou ALT).
46Os comandos a seguir so teis para visualizar telas inteiras 46Os comandos a seguir so teis para visualizar telas inteiras
47 47
48 C-v Move para tela inteira posterior 48 C-v Move para tela inteira posterior
49 M-x Move para tela inteira anterior 49 M-v Move para tela inteira anterior
50 C-l Limpa a tela e re-mostr todo o texto, movendo o texto ao 50 C-l Limpa a tela e re-mostr todo o texto, movendo o texto ao
51 redor do cursor para o centro da tela. (Isso 51 redor do cursor para o centro da tela. (Isso
52 control-L, no control-1.) 52 control-L, no control-1.)
diff --git a/etc/tutorials/TUTORIAL.ru b/etc/tutorials/TUTORIAL.ru
index 0d7405eb1e6..13c79b99f1f 100644
--- a/etc/tutorials/TUTORIAL.ru
+++ b/etc/tutorials/TUTORIAL.ru
@@ -406,7 +406,7 @@ C-k удалит две строки, а также завершающие их
406текста). Вы можете восстановить убитый текст в месте удаления или в любой 406текста). Вы можете восстановить убитый текст в месте удаления или в любой
407другой точке редактируемого текста или даже в другом файле. Вы можете 407другой точке редактируемого текста или даже в другом файле. Вы можете
408восстановить текст несколько раз и получить несколько копий данного текста. 408восстановить текст несколько раз и получить несколько копий данного текста.
409Некоторые редактора называют операции "убить" и "восстановить" а 409Некоторые редакторы называют операции "убить" и "восстановить" ч:
410"вырезать" (cutting) и "вставить" (pasting) (ознакомьтесь с глоссарием 410"вырезать" (cutting) и "вставить" (pasting) (ознакомьтесь с глоссарием
411(Glossary) в руководстве по Emacs). 411(Glossary) в руководстве по Emacs).
412 412