~ericmoritz/+junk/emacs.d

« back to all changes in this revision

Viewing changes to src/org-6.34c/Changes.org

  • Committer: Eric Moritz
  • Date: 2010-03-08 17:33:56 UTC
  • Revision ID: eric@eric-moritzs-macbook-pro.local-20100308173356-lfvzvmyp2kzm7l5y
Added a src folder to hold versions of packages that I use

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
#   -*- mode: org; fill-column: 65 -*-
 
2
 
 
3
#+begin_html
 
4
<a href="/"><img src="http://orgmode.org/img/org-mode-unicorn.png" class="logo-link" /></a>
 
5
#+end_html
 
6
 
 
7
#+STARTUP: indent hidestars
 
8
 
 
9
* Version 6.34
 
10
 :PROPERTIES:
 
11
 :VISIBILITY: content
 
12
 :CUSTOM_ID: v6.34
 
13
 :END:
 
14
 
 
15
** Incompatible changes
 
16
 
 
17
*** Tags in org-agenda-auto-exclude-function must be lower case.
 
18
 
 
19
When defining an =org-agenda-auto-exclude-function=, you need to
 
20
be aware that tag that is being passed into the function is
 
21
always lower case - even if it was defined in upper case
 
22
originally.
 
23
 
 
24
** Details
 
25
 
 
26
*** Support for creating BEAMER presentations from Org-mode documents
 
27
 
 
28
Org-mode documents or subtrees can now be converted directly in
 
29
to BEAMER presentation.  Turning a tree into a simple
 
30
presentations is straight forward, and there is also quite some
 
31
support to make richer presentations as well.  See the [[http://orgmode.org/manual/Beamer-class-export.html#Beamer-class-export][BEAMER
 
32
section]] in the manual for more details.
 
33
 
 
34
Thanks to everyone who has contributed to the discussion about
 
35
BEAMER support and how it should work.  This was a great example
 
36
for how this community can achieve a much better result than any
 
37
individual could.
 
38
 
 
39
*** Hyperlinks
 
40
 
 
41
**** Add Paul Sexton's org-ctags.el
 
42
 
 
43
Targets like =<<my target>>= can now be found by Emacs' etag
 
44
functionality, and Org-mode links can be used to to link to
 
45
etags, also in non-Org-mode files.  For details, see the file
 
46
/org-ctags.el/.
 
47
 
 
48
This feature uses a new hook =org-open-link-functions= which will
 
49
call function to do something special with text links.
 
50
 
 
51
Thanks to Paul Sexton for this contribution.
 
52
 
 
53
**** Add Jan Böker's org-docview.el
 
54
 
 
55
This new module allows links to various file types using docview,
 
56
where Emacs displays images of document pages.  Docview link
 
57
types can point to a specific page in a document, for example to
 
58
page 131 of the Org-mode manual:
 
59
 
 
60
: [[docview:~/.elisp/org/doc/org.pdf::131][Org-Mode Manual]]
 
61
 
 
62
Thanks to Jan Böker for this contribution.
 
63
    
 
64
**** New link types that force special ways of opening the file
 
65
    
 
66
- =file+sys:/path/to/file=  will use the system to open the file,
 
67
  like double-clicking would.
 
68
- file+emacs:/path/to/file will force opening the linked file
 
69
  with Emacs.
 
70
 
 
71
This was a request by John Wiegley.
 
72
 
 
73
**** Open all links in a node
 
74
 
 
75
When using =C-c C-o= on a headline to get a list of links in the
 
76
entry, pressing =RET= will open *all* links.  This allows
 
77
something like projects to be defined, with a number of files
 
78
that have to be opened by different applications.
 
79
 
 
80
This was a request by John Wiegley.
 
81
 
 
82
*** Agenda Views
 
83
 
 
84
**** Improve the logic of the search view.
 
85
 
 
86
The logic of search views is changed a bit.  See the docstring of
 
87
the function =or-search-view=.
 
88
 
 
89
These changes resulted from a discussion with Matt Lundin.
 
90
 
 
91
**** New face for entries from the Emacs diary
 
92
 
 
93
Entries that enter the Agenda through the Emacs diary now get the
 
94
face =org-agenda-diary=.
 
95
 
 
96
This was a request by Thierry Volpiatto.
 
97
 
 
98
**** New function `org-diary-class' to schedule classes with skipped weeks.
 
99
 
 
100
This was a request by Daniel Martins.
 
101
 
 
102
**** Empty matcher means prompt in agenda custom commands
 
103
    
 
104
When an agenda custom command has an empty string as MATCH
 
105
element, so far this would lead to a meaningless search using an
 
106
empty matcher.  Now an empty (or white) string will be
 
107
interpreted just like a nil matcher, i.e. the user will be
 
108
prompted for the match.
 
109
 
 
110
**** Agenda: Selectively remove some tags from agenda display
 
111
 
 
112
If you use tags very extensively, you might want to exclude some
 
113
from being displayed in the agenda, in order to keep the display
 
114
compact.  See the new option =org-agenda-hide-tags-regexp= for
 
115
details.
 
116
    
 
117
This was largely a patch by Martin Pohlack.
 
118
 
 
119
*** Export
 
120
 
 
121
**** Direct export of only the current subtree
 
122
 
 
123
Pressing =1= after =C-c C-e= and before the key that selects the
 
124
export backend, only the current subtree will be exported,
 
125
exactly as it you had selected it first with =C-c @=.  So for
 
126
example, =C-c C-e 1 b= will export the current subtree to HTML
 
127
and open the result in the browser.
 
128
 
 
129
**** Direct export of enclosing node
 
130
 
 
131
Pressing =SPC= after =C-c C-e= and before the key that selects
 
132
the export backend, the enclosing subree that is set up for
 
133
subtree export will be exported, exactly as it you had selected
 
134
it first with =C-c @=.  So for example, =C-c C-e SPC d= will find
 
135
the enclosing node with a LaTeX_CLASS property or an
 
136
EXPORT_FILE_NAME property and export that.
 
137
 
 
138
**** Caching export images
 
139
 
 
140
Images that are created for example using LaTeX or ditaa for
 
141
inclusion into exported files are now cached.  This works by
 
142
adding a hash to the image name, that reflects the source code
 
143
and all relevant settings.  So as long as the hash does not
 
144
change, the image does not have to be made again.  His can lead
 
145
to a substantial reduction in export/publishing times.
 
146
 
 
147
Thanks to Eric Schulte for a patch to this effect.
 
148
 
 
149
**** Preserving line breaks for export no longer works
 
150
    
 
151
ASCII export always preserves them - no other export format
 
152
does.  We had attempted to use =\obeylines= for this in LaTeX,
 
153
but that does create too many problems.
 
154
 
 
155
**** New symbols =\EUR= and =\checkmark=
 
156
 
 
157
=\EUR= symbols from Marvosym package, and =\checkmark= are now
 
158
supported symbols in Org-mode, i.e. they will be exported
 
159
properly to the various backends.
 
160
 
 
161
**** Allow LaTeX_CLASS_OPTIONS to set options, also from a property
 
162
 
 
163
You can set the options to the =\documentclass= command on a
 
164
per-file basis, using
 
165
 
 
166
: #+LaTeX_CLASS_OPTIONS: [11pt]
 
167
 
 
168
or on a per-tree basis using the corresponding property.  The
 
169
defined string will replace the default options entirely.
 
170
 
 
171
**** The encoding of LaTeX files is now handled property
 
172
 
 
173
Org now makes sure that the encoding used by the file created
 
174
through the export mechanism is reflected correctly in the
 
175
 
 
176
: \usepackage[CODINGSYSTEM]{inputenc}
 
177
 
 
178
command.  So as long as the =org-export-latex-classes= definition
 
179
contains an =\usepackage[utf8]{inputenc}= statement, that
 
180
statement will be modified so that the correct option is used.
 
181
 
 
182
If you wan to use special encodings, for example =utf8x= instead
 
183
of =utf8=, see the variable =org-export-latex-inputenc-alist=.
 
184
 
 
185
This was a request by Francesco Pizzolante.
 
186
 
 
187
*** Property API enhancements
 
188
    
 
189
**** Make a new special property BLOCKED, indicating if entry is blocked
 
190
 
 
191
A new special property BLOCKED returns "t" when the entry is
 
192
blocked from switching the TODO state to a DONE state.
 
193
 
 
194
This was a request by John Wiegley.
 
195
 
 
196
**** New hooks for external support for allowed property values
 
197
 
 
198
It is now possible to hook into Org in order to provide the
 
199
allowed values for any property with a lisp function.  See the
 
200
docstring of the variable =org-property-allowed-value-functions=
 
201
 
 
202
**** Allow unrestricted completion on properties
 
203
 
 
204
When listing the allowed values for a property, for example with
 
205
a =:name_ALL:= property, completion on these values enforces that
 
206
one of the values will be chosen.  Now, if you add ":ETC" to the
 
207
list of allowed values, it will be interpreted as a switch, and
 
208
the completion will be non-restrictive, so you can also choose to
 
209
type a new value.
 
210
 
 
211
*** Changes to Org-babel
 
212
 
 
213
- The documentation for Org-babel has been drastically improved
 
214
  and is available on Worg at
 
215
  http://orgmode.org/worg/org-contrib/babel/
 
216
- Source-code block names are now exported to HTML and LaTeX
 
217
- Org-babel functions are now bound to keys behind a common key
 
218
  prefix (see
 
219
  http://orgmode.org/worg/org-contrib/babel/reference.php#sec-5)
 
220
- Results are now foldable with TAB
 
221
- Header argument values can now be lisp forms
 
222
- Readable aliases for #+srcname: and #+resname:
 
223
- Sha1 hash based caching of results in buffer
 
224
- Can now index into variable values
 
225
- org-babel-clojure now supports multiple named sessions
 
226
 
 
227
*** Miscellaneous changes
 
228
 
 
229
**** Make =C-c r C= customize remember templates
 
230
 
 
231
=C-c r C= is now a shortcut for
 
232
 
 
233
:  M-x customize-variable RET org-remember-templates RET
 
234
 
 
235
This was a proposal by Adam Spiers.
 
236
 
 
237
**** Use John Gruber's regular expression for URL's
 
238
 
 
239
We now use a better regexp to spot plain links in text.  This
 
240
regexp is adopted from [[http://daringfireball.net/2009/11/liberal_regex_for_matching_urls][John Gruber's blogpost]].
 
241
 
 
242
Thanks to William Henney for the pointer.
 
243
 
 
244
**** Implement tag completion of all tags in all agenda files
 
245
    
 
246
The new option =org-complete-tags-always-offer-all-agenda-tags=
 
247
makes Org complete all tags from all agenda files if non-nil.
 
248
Usually, setting it locally to t in org-remember buffers is the
 
249
most useful application of this new feature.
 
250
 
 
251
Thanks to Tassilo Horn for a patch to this effect.
 
252
 
 
253
* Version 6.33
 
254
 :PROPERTIES:
 
255
 :CUSTOM_ID: v6.33
 
256
 :END:
 
257
 
 
258
** Incompatible changes
 
259
 
 
260
*** Reorganize key bindings for archiving
 
261
    
 
262
The following keys now do archiving
 
263
 
 
264
- C-c C-x C-a :: archive using the command specified in
 
265
     =org-archive-default-command=.  This variable is by default
 
266
     set to =org-archive-subtree=, which means arching to the
 
267
     archive file.
 
268
    
 
269
The three specific archiving commands are available through
 
270
 
 
271
- C-c C-x C-s ::    archive to archive file
 
272
- C-c C-x a ::     toggle the archive tag
 
273
- C-c C-x A ::   move to archive sibling
 
274
 
 
275
These bindings work the same in an Org file, and in the agenda.
 
276
 
 
277
In addition:
 
278
    
 
279
- In the agenda you can also use =a= to call the default archiving
 
280
  command, but you need to confirm the command with =y= so that this
 
281
  cannot easily happen by accident.
 
282
  
 
283
- For backward compatibility, =C-c $= in an org-mode file, and
 
284
  =$= in the agenda buffer continue to archive to archive file.
 
285
 
 
286
 
 
287
** Details
 
288
 
 
289
*** Level indentation cycling new empty entries and plain list items
 
290
:PROPERTIES:
 
291
:ID: 1CBF16C9-031C-4A03-A5EE-09B6AAB6209C
 
292
:END:
 
293
 
 
294
To speed up data entry, TAB now behaves special in an empty
 
295
headline, i.e. if the current line only contains the headline
 
296
starter stars, maybe a TOD keyword, but no further content.  This
 
297
is usually the situation just after creating a new headline with
 
298
=M-RET= or =M-S-RET=.
 
299
 
 
300
Then, TAB will first make the current entry a child of the
 
301
entry above, then a parent, then a grand parent etc until it
 
302
reaches top level.  Yet another TAB and you will be back at the
 
303
initial level at which the headline was created.
 
304
 
 
305
New plain list items behave in just the same way.
 
306
 
 
307
Sounds strange?  Try it, it is insanely fast when entering data.
 
308
If you still don't like it, turn it off by customizing
 
309
=org-cycle-level-after-item/entry-creation=.
 
310
 
 
311
Thanks to [[http://thread.gmane.org/gmane.emacs.orgmode/18236][Samuel Wales]] and [[http://thread.gmane.org/gmane.emacs.orgmode/18447/focus%3D19015][John Wiegley]] for ideas that
 
312
contributed to this new feature.
 
313
 
 
314
*** Speed commands at the start of a headline
 
315
 
 
316
If you set the variable =org-use-speed-commands=, the cursor
 
317
position at the beginning of a headline (i.e. before the first
 
318
star) becomes special.  Single keys execute special commands in
 
319
this place, for example outline navigation with =f=, =b=, =n=,
 
320
and =p=, equivalent to the corresponding =C-c C-f=, =C-c C-b=,
 
321
=C-c C-n=, and =C-c C-f= commands.  The full list of commands can
 
322
be seen by pressing =?= at the special location.  More commands
 
323
can be added and existing ones modified by configuring the
 
324
variable =org-speed-commands-user=.
 
325
 
 
326
This was a request by John Wiegley, based on similar speed
 
327
navigation in /allout.el/.
 
328
 
 
329
*** Logging changes in scheduling and deadline time stamps
 
330
 
 
331
Setting the variables =org-log-reschedule= and
 
332
=org-log-redeadline= to either =time= or =note= will arrange for
 
333
recording a logbook entry whenever a scheduling date or deadline
 
334
is changed.
 
335
 
 
336
This was a request by Rick Moynihan.
 
337
 
 
338
*** File remember notes into a date tree
 
339
 
 
340
Remember notes can now be filed to a location in a date tree.  A
 
341
date tree is an outline tree with years as top levels, months as
 
342
level 2 headings, and days as level three headings.  These are
 
343
great for journals and for recording appointments and other loose
 
344
dates because it will be easy to find all entries referencing a
 
345
particular date, and it will be easy to archive all such entry
 
346
from last year, for example.
 
347
 
 
348
To select date tree filing, set the HEADLINE part of the remember
 
349
template to the symbol =date-tree=.  The date tree will be build
 
350
in the file on top level.  However, if the file contains an entry
 
351
with a non-nil =DATE_TREE= property, then the tree will be build
 
352
under that headline.
 
353
 
 
354
*** New commands to create entries from agenda and calendar
 
355
 
 
356
If you make the variable =org-agenda-diary-file= point to an
 
357
org-mode file, the =i= key in both the agenda buffer and in the
 
358
Emacs calendar will be made to insert entries into that Org file.
 
359
The dates at the cursor and the mark are being used when making
 
360
entries for specific dates or blocks.  In the new file,
 
361
anniversaries will be collected under a special headline, and
 
362
day/block entries will be filed into a date tree (see previous
 
363
section).
 
364
 
 
365
This was a request by Stephen Eglen.
 
366
 
 
367
*** A new freemind exporter has been integrated with Org-mode
 
368
 
 
369
org-freemind.el has a number of entry points (for details, see
 
370
the source code), but you can also use Org's =C-c C-e m= to
 
371
export a file or a selected subtree.
 
372
 
 
373
Thanks to Lennart Borgman for this contribution.  An earlier
 
374
version of this file was part of the nxhtml package, under the
 
375
name /freemind.el/.
 
376
 
 
377
*** Drawers are now exported properly
 
378
 
 
379
Drawers are now exported when the configuration requires it,
 
380
i.e. if the variable `org-export-with-drawers' is t or a list
 
381
containing the drawers to export.
 
382
 
 
383
*** Min/Max/Mean age operators in Column View.
 
384
    
 
385
This lets you see how much time has passed since the specified
 
386
timestamp property each entry. The three operators (=@min=,
 
387
=@max=, =@mean=) show either the age of the youngest or oldest
 
388
entry or the average age of the children.
 
389
 
 
390
Thanks to James TD Smith for a patch to this effect.
 
391
    
 
392
*** Allow source code block indentation to be preserved
 
393
    
 
394
If =org-src-preserve-indentation= is non-nil, or if a block has a
 
395
=-i= switch, then the behavior of org-exp-blocks is altered as
 
396
follows:
 
397
 
 
398
1. Indentation is not removed before passing the block contents
 
399
   to the block-transforming plugin.
 
400
   
 
401
2. The result returned by the plugin is not re-indented.
 
402
 
 
403
3. Editing the source code block with =C-c '= preserves it's
 
404
   indentation.
 
405
 
 
406
Thanks to Dan Davison for this feature.
 
407
 
 
408
*** Frame/window control when switching to source code edit buffer.
 
409
    
 
410
When switching to a source code editing buffer with =C-c '=, you
 
411
can now control the frame / window setup using the new variable
 
412
=org-src-window-setup=.
 
413
 
 
414
Thanks to Dan Davison for this feature.
 
415
 
 
416
*** Refile an entry to the current clock
 
417
 
 
418
You can now quickly refile an entry to become a child of the
 
419
entry currently being clocked.  The keys for doing this are
 
420
=C-2 C-c C-w=.
 
421
 
 
422
This was a request by Bernt Hansen.
 
423
 
 
424
*** Make =C-c C-o= open the attachment directory is there are no links
 
425
 
 
426
If there is no link in an entry, =C-c C-o= will now open the
 
427
attachment directory instead.
 
428
 
 
429
This was a request/patch by John Wiegley.
 
430
 
 
431
*** org-mac-iCal.el: work with calendar "groups"
 
432
    
 
433
Some calendar systems (Google, Zimbra) handle subscriptions to
 
434
multiple calendars (or to an account) by grouping them under a
 
435
single caldav directory in the calendar tree.  org-mac-iCal used
 
436
to assumes there is only one ics file created per caldav
 
437
directory, so while it *creates* all of the needed merged ics
 
438
files, it only copies one of them to ~/Library/Calendar before
 
439
importing the contents into the diary.
 
440
 
 
441
Thanks to Doug Hellmann for a patch to fix this.
 
442
 
 
443
*** New module /org-learn.el/ in the contrib directory
 
444
 
 
445
The file implements the learning algorithm described at
 
446
http://supermemo.com/english/ol/sm5.htm, which is a system for reading
 
447
material according to "spaced repetition".  See
 
448
http://en.wikipedia.org/wiki/Spaced_repetition for more details.
 
449
 
 
450
Thanks to John Wiegley for this contribution.
 
451
 
 
452
*** New contributed package /org-git-link.el/
 
453
 
 
454
/org-git-link.el/ defines two new link types. The =git= link type
 
455
is meant to be used in the typical scenario and mimics the =file=
 
456
link syntax as closely as possible.  The =gitbare= link type
 
457
exists mostly for debugging reasons, but also allows e.g.
 
458
linking to files in a bare git repository for the experts.
 
459
 
 
460
Thanks to Raimar Finken for this contribution.
 
461
 
 
462
*** /org-annotation-helper.el/ and /org-browser-url.e./ have been removed
 
463
Please switch to /org-protocol.el/, into which contains the same
 
464
functionality in a more general framework.
 
465
*** The contributed /org-export-freemind/ package has been removed.
 
466
Org now contains a new freemind exporter, /org-freemind.el/.
 
467
 
 
468
** Org-babel Changes
 
469
- Clojure is supported [Thanks to Joel Boehland]
 
470
- Perl is supported
 
471
- Ruby and Python now respond to the :file header argument
 
472
- Added :results_switches header argument for passing switches
 
473
  through to raw src blocks
 
474
- Preserve indentation in source blocks on export and tangle
 
475
- Possible to evaluate noweb reference on tangling or code block
 
476
  evaluation
 
477
- Allowing multiple noweb references on a single line
 
478
- Cleaned up the passing of parameter values from Org-babel to
 
479
  language specific functions
 
480
 
 
481
* Version 6.32
 
482
 :PROPERTIES:
 
483
 :CUSTOM_ID: v6.32
 
484
 :END:
 
485
 
 
486
** Rewrite of org-mobile.org, for MobileOrg 1.0 (build 20)
 
487
 
 
488
MobileOrg is currently under review at the iPhone App Store.  You
 
489
will need Org-mode version 6.32 to interact with it.
 
490
 
 
491
** Added support for habit consistency tracking
 
492
    
 
493
/org-habit.el/ contains new code to track habits.  Please
 
494
configure the variable org-modules to activate it.  When active,
 
495
habits (a special TODO entry) will be displayed in the agenda
 
496
together with a "consistency graph".  Habit tracking is described
 
497
in a new [[http://orgmode.org/manual/Tracking-your-habits.html][manual section]].
 
498
 
 
499
Thanks to John Wiegley for this contribution.
 
500
    
 
501
** New context-aware tag auto-exclusion 
 
502
 
 
503
After writing a function relating to location and context
 
504
information, you will be able to press =/ RET= in the agenda to
 
505
exclude tasks that cannot be done in the current context. 
 
506
For details, see the information about filtering in the manual.
 
507
 
 
508
Thanks to John Wiegley for a patch to this effect.
 
509
 
 
510
** New clock resolving tools
 
511
 
 
512
When clocking into a new task while no clock is running, Org now
 
513
checks for orphaned CLOCK lines and offers to repair these before
 
514
starting the clock.  You can also configure this feature to check
 
515
for idle time and prompt you to subtract that time from the
 
516
running timer.
 
517
    
 
518
See the new [[http://orgmode.org/manual/Resolving-idle-time.html][manual section]] for more details.
 
519
    
 
520
Thanks to John Wiegley for a patch to this effect.
 
521
 
 
522
** Mutually exclusive tag groups can now have a name in the tags interface
 
523
 
 
524
The customize interface allows to optionally add a string to the
 
525
beginning or end of such a group.
 
526
    
 
527
Thanks to James TD Smith for a patch to this effect.
 
528
 
 
529
** Agenda Search view: Search for substrings
 
530
    
 
531
The default in search view (/C-c a s/)is now that the search
 
532
expression is searched for as a /substring/, i.e. the different
 
533
words must occur in direct sequence, and it may be only part of
 
534
a word.  If you want to look for a number of separate keywords
 
535
with Boolean logic, all words must be preceded by =+= or =-=.
 
536
 
 
537
This was, more-or-less, requested by John Wiegley.
 
538
 
 
539
** Make space and backspace scroll the show window in the agenda
 
540
 
 
541
Pressing SPC again after using it to show an agenda item in
 
542
another window will make the entire subtree visible, and show
 
543
scroll it.  Backspace and DEL will scroll back.
 
544
 
 
545
This was a request by Eric Fraga.
 
546
    
 
547
** File tags are now offered for completion during a tag prompts
 
548
 
 
549
Requested by Matt Lundin.
 
550
 
 
551
** Make `- SPC' an agenda filter that selects entries without any tags
 
552
    
 
553
Request by John Wiegley.
 
554
 
 
555
** Better way to edit multi-line macro definitions
 
556
 
 
557
The editing tool key =C-c '= now also edits =#+MACRO=
 
558
definitions, including multiline macros.
 
559
 
 
560
** Restructured Manual
 
561
 
 
562
The manual has been slightly reorganized.  The archiving stuff,
 
563
which was - somewhat obscurely - hidden in the /Document
 
564
Structure/ chapter, has been moved into the new chapter
 
565
/Capture-Refile-Archive/.  Also, there is a new chapter /Markup/
 
566
which contains both the markup rules (moved there from the Export
 
567
chapter) and the documentation for embedded LaTeX.
 
568
 
 
569
** Improved figure placement in LaTeX and HTML export
 
570
    
 
571
Text can now be wrapped around figures.  See the manual for
 
572
details.
 
573
 
 
574
** Allow date to be shifted into the future if time given is earlier than now
 
575
    
 
576
By setting
 
577
 
 
578
:     (setq org-read-date-prefer-future 'time)
 
579
 
 
580
you indicate to Org that, if you only give a time at the
 
581
date/time prompt, and if this time is earlier then the current
 
582
time, then the date of tomorrow will be assumed to be valid for
 
583
this event.  A similar mechanism was already in place for dates,
 
584
but now you can make it work for times as well.
 
585
 
 
586
** Collected changes in org-babel
 
587
- Source blocks can now reference source-blocks in other files
 
588
  using =filepath:srcname= syntax.
 
589
- Inline code blocks like =src_python{2+2}= are now exported
 
590
- Remote source block calls using the =#+lob: srcname(arg=val)=
 
591
  syntax can now be exported.
 
592
- When =:file= is supplied with an =R= block, graphics are
 
593
  automatically sent to file and linked from the org buffer, thus
 
594
  appearing on export.  The image format is obtained from the
 
595
  filename extension.  Possible values are =.png, .jpg, .jpeg,
 
596
  .tiff, .bmp, .pdf, .ps, .postscript=, defaulting to =png=.
 
597
- Results can be returned as parseable code using =:results code=,
 
598
  and as pretty-printed code using =:results pp= (emacs-lisp,
 
599
  python, ruby).  Thanks to Benny Andresen for the idea and patch
 
600
  for emacs-lisp.
 
601
- When =:file filename= is supplied, =:exports file= is unnecessary
 
602
- Header args are taken from org-file-properties in addition to
 
603
  properties active in the subtree.
 
604
- =:noweb= header argument now expands noweb references before
 
605
  source-block evaluation.
 
606
- Tangling honours the new org variable
 
607
  org-src-preserve-indentation, so that correct code is output for
 
608
  a language like python that depends on indentation.
 
609
 
 
610
** Changes in org-exp-blocks.el
 
611
- Interblocks export has been simplified.
 
612
- Support for R code (=begin_R= blocks and inline =\R{}=) has been
 
613
  removed.  Please use org-babel instead.
 
614
 
 
615
* Version 6.31
 
616
 :PROPERTIES:
 
617
 :CUSTOM_ID: v6.31
 
618
 :END:
 
619
 
 
620
** Org-babel is now part of the Org distribution
 
621
 
 
622
Org-babel provides the ability to execute source code in many
 
623
different languages within org-mode documents.  The results of
 
624
code execution -- text, tables and graphics -- can be integrated
 
625
into Org-mode documents and can be automatically updated during
 
626
publishing.  Since Org-babel allows execution of arbitrary code,
 
627
the range of tasks that can be addressed from within an Org mode
 
628
file becomes very large.  Examples of ways in which Org-babel
 
629
might be used include
 
630
 
 
631
- Documenting a task that involves some programming so that it is
 
632
  automatically repeatable
 
633
- Creating dynamic (executable) reports that respond to changes
 
634
  in the underlying data (Reproducible Research)
 
635
- Exportation of code contained in an Org-mode document into
 
636
  regular source code files (Literate Programming)
 
637
 
 
638
Additionally, Org-babel provides a programming environment within
 
639
Org files, in which data can be transmitted between parameterised
 
640
source code blocks in different languages, as well as between
 
641
source code blocks and Org-mode tables.
 
642
 
 
643
A simple API is defined so that users can add support for new
 
644
"languages" (broadly construed).  Languages currently supported
 
645
are:
 
646
 
 
647
- asymptote
 
648
- css
 
649
- ditaa
 
650
- dot
 
651
- emacs-lisp
 
652
- gnuplot
 
653
- haskell
 
654
- ocaml
 
655
- python
 
656
- R
 
657
- ruby
 
658
- sass
 
659
- sh
 
660
- sql
 
661
 
 
662
Org-babel was designed and implemented Eric Schulte with continued
 
663
significant help on both accounts from Dan Davison.
 
664
 
 
665
** MobileOrg support
 
666
 
 
667
Richard Morelands iPhone/iPod Touch program [[http://mobileorg.ncogni.to/][MobileOrg]] can view
 
668
Org files, mark entries as DONE, flag entries for later
 
669
attention, and capture new entries on the road.  Org-mode has now
 
670
support to produce a staging area where MobileOrg can download
 
671
its files, and to integrate changes done on the phone in a half
 
672
automatic, half interactive way.  See the new appendix B in the
 
673
manual for more information.
 
674
 
 
675
 
 
676
** Indented lines starting with "#+ " are treated as comments
 
677
 
 
678
To allow comments in plain lists without breaking the list
 
679
structure, you can now have indented comment lines that start
 
680
with "#+ ".
 
681
 
 
682
** New STARTUP keyword `showeverything'
 
683
    
 
684
This will make even drawer contents visible upon startup.
 
685
Requested by Jeff Kowalczyk.
 
686
 
 
687
** New contributed package org-invoice.el
 
688
 
 
689
This package collects clocking information for billing
 
690
customers.
 
691
 
 
692
Thanks to Peter Jones for this contribution.
 
693
 
 
694
** Encrypting subtrees
 
695
 
 
696
/org-crypt.el/ by John Wiegley and Peter Jones allows encryption
 
697
of individual subtrees in Org-mode outlines.  Thanks to John and
 
698
Peter for this contribution.
 
699
 
 
700
** Agenda: Support for including a link in the category string
 
701
    
 
702
The category (as specified by an #+CATEGORY line or CATEGORY
 
703
property can contain a bracket link.  While this sort-of worked
 
704
in the past, it now is officially supported and should cause no
 
705
problems in agenda display or update.  The link can be followed
 
706
by clicking on it, or with =C-c C-o 0=.
 
707
 
 
708
This was a request by Peter Westlake.
 
709
 
 
710
* Version 6.30
 
711
 :PROPERTIES:
 
712
 :CUSTOM_ID: v6.30
 
713
 :END:
 
714
 
 
715
** Inconsistent changes
 
716
 
 
717
*** Agenda now uses =f= and =b= to move through time
 
718
 
 
719
Up to now, the Org-mode agenda used the cursor keys =left= and
 
720
=right= to switch the agenda view forward an backward through
 
721
time.  However, many people found this confusing, and others
 
722
wanted to be able to do cursor motion in the agenda, for example
 
723
to select text.  Therefore, after an extensive discussion on
 
724
=emacs-orgmode@gnu.org=, it was decided to use the =b= and 
 
725
=f= keys instead, and to let the cursor keys do cursor motion
 
726
again.
 
727
 
 
728
*** Agenda follow mode is now on the =F= key
 
729
 
 
730
This was necessary to free up the =f= key, see above.
 
731
 
 
732
** Details
 
733
 
 
734
*** Maintenance
 
735
 
 
736
**** New command to submit a bug report
 
737
 
 
738
There is now a special command =M-x org-submit-bug-report=.  This
 
739
command will create a mail buffer with lots of useful details.
 
740
In particular, it contains complete version information for Emacs
 
741
and Org-mode.  It will also (if you agree to it) contain all
 
742
non-standard settings of org-mode and outline-mode related
 
743
variables.  Even if you do not sent your emails from within
 
744
Emacs, please still use this command to generate the information
 
745
and then copy it into your mail program.
 
746
 
 
747
The command will not generate and include a =*Backtrace*= buffer,
 
748
please do this yourself if you have hit an error.  For more
 
749
information, see the [[http://orgmode.org/manual/Feedback.html#Feedback][feedback section]] of the manual.
 
750
 
 
751
**** New contributed package org-track.el
 
752
 
 
753
This package allows to keep up-to-date with current Org
 
754
development, using only Emacs on-board means.  So if you don't
 
755
want or cannot use =git=, but still want to run the latest and
 
756
hottest Org-mode, this is for you.
 
757
 
 
758
Thanks to Sebastian Rose for this contribution.
 
759
 
 
760
*** Agenda
 
761
 
 
762
**** Agenda now uses =f= and =b= to move through time
 
763
 
 
764
Up to now, the Org-mode agenda used the cursor keys =left= and
 
765
=right= to switch the agenda view forward an backward through
 
766
time.  However, many people found this confusing, and others
 
767
wanted to be able to do cursor motion in the agenda, for example
 
768
to select text.  Therefore, after an extensive discussion on
 
769
=emacs-orgmode@gnu.org=, it was decided to use the =b= and 
 
770
=f= keys instead, and to let the cursor keys do cursor motion
 
771
again.
 
772
 
 
773
**** Agenda follow mode is now on the =F= key
 
774
 
 
775
This was necessary to free up the =f= key, see above.
 
776
 
 
777
**** The agenda can be put into a dedicated frame
 
778
 
 
779
When the variable =org-agenda-window-setup= has the value
 
780
=other-frame=, then the new frame created to show the agenda
 
781
will now have the window marked as /dedicated/.  As a
 
782
consequence, exiting the agenda while the agenda is the only
 
783
window on the frame will kill that frame.
 
784
 
 
785
This was a request by Henry Atting.
 
786
 
 
787
**** New mode to show some entry body text in the agenda
 
788
 
 
789
There is now a new agenda sub-mode called
 
790
=org-agenda-entry-text-mode=.  It is toggled with the =E= key.
 
791
When active, all entries in the agenda will be accompanied by a
 
792
few lines from the outline entry.  The amount of text can be
 
793
customized with the variable =org-agenda-entry-text-maxlines=.
 
794
 
 
795
This was a request by Anthony Fairchild, Manish, and others.
 
796
 
 
797
**** Improve following links from the agenda
 
798
    
 
799
=C-c C-o= in the agenda will now offer all links in the headline
 
800
and text of an entry.  If there is only a single link, it will be
 
801
followed immediately.
 
802
 
 
803
**** Avoid some duplicate entries
 
804
 
 
805
There is a new variable that can be used to avoid some duplicate
 
806
agenda entries: =org-agenda-skip-scheduled-if-deadline-is-shown=
 
807
If that is set, it avoids that an entry shows up in the agenda for
 
808
today for both a scheduling and a deadline entry.  See the
 
809
docstring of the variables for more details.
 
810
 
 
811
This partially addresses a request by Samuel Wales. 
 
812
 
 
813
**** Mark the running clock in the agenda.
 
814
 
 
815
If the entry currently being clocked is present in the agenda, it
 
816
will be highlighted with the face =org-agenda-clocking=.
 
817
 
 
818
This was a request by Rainer Stengele.
 
819
 
 
820
 
 
821
*** Export
 
822
 
 
823
**** Allow LaTeX export to use the listings package
 
824
 
 
825
The LaTeX =listings= package can now be used for formatting
 
826
fontified source code in many programming languages.  For more
 
827
information, see
 
828
http://thread.gmane.org/gmane.emacs.orgmode/16269 and
 
829
http://orgmode.org/worg/org-faq.php#fontified_source_code_w_latex
 
830
 
 
831
Thanks to Eric Schulte for this patch.
 
832
 
 
833
**** Remove table rows that only contain width and alignment markers
 
834
    
 
835
The width and alignment in table columns can be set with a cookie
 
836
like "<10>" or "<r>" or "<r10>".  In order to keep Org from
 
837
exporting such lines, the first column of a line should contain
 
838
only "/".  However, for convenience, there is now a special case:
 
839
If the entire row contains only such markers, the line will
 
840
automatically be discarded during export, even is the first
 
841
column is not "/".
 
842
 
 
843
**** Allow Macro calls to span several lines.
 
844
 
 
845
Macro calls may now span several lines, to write several
 
846
arguments in a cleaner way.  The result of a macro call can also
 
847
span several lines, by inserting the string "\n" (backslash
 
848
followed by n) into the value in the macro definition.
 
849
 
 
850
These were requests by Stefan Vollmar.
 
851
 
 
852
*** Misc
 
853
 
 
854
**** Quick access to all links in an entry
 
855
 
 
856
If =C-c C-o= is called while the cursor is in a headline, but not
 
857
directly on a link, then all links in the entry will be offered
 
858
in a small menu.  If there is only a single link, it will be
 
859
followed without a prompt.
 
860
 
 
861
**** Visibility Cycling: Allow to show all empty lines after a headline
 
862
    
 
863
=org-cycle-separator-lines= can now be set to a negative value,
 
864
to indicate that, if the number of empty lines before a visible
 
865
entry is greater than the specified number, then *all* empty
 
866
lines should be shown.
 
867
 
 
868
This was a request by "PT" whatever this means.
 
869
 
 
870
**** Allow language names to replace some strange major mode names
 
871
 
 
872
Sometimes a language uses a major mode which can't be guessed
 
873
from it's name.  There is now a new variable =org-src-lang-modes=
 
874
which can be used to map language names to major modes when this
 
875
is the case.  This is used when editing a source-code 
 
876
block, or when exporting fontified source-code with htmlize.
 
877
 
 
878
Thanks to Eric Schulte for a patch to this effect.
 
879
 
 
880
**** iswitchb support for many completion prompts
 
881
    
 
882
This is enabled using =org-completion-use-iswitchb=, and follows
 
883
the same model of usage as for ido users.
 
884
 
 
885
Thanks to John Wiegley for a patch to this effect.
 
886
 
 
887
**** New commands to set the effort property of an entry
 
888
 
 
889
There is now a special command, =C-c C-x e= to set the =Effort=
 
890
property of an entry.  From the agenda you can even use =e=.
 
891
If you have set up allowed values for the =Effort= property, then
 
892
using a prefix argument will directly select the nth allowed
 
893
value.  For example, in the agenda, =5 e= will select the 5th
 
894
allowed value.
 
895
 
 
896
This was a request by Michael Gilbert
 
897
 
 
898
**** Edit src works now better with killing buffer
 
899
 
 
900
Thanks to Dan Davison for a patch to this effect
 
901
 
 
902
 
 
903
* Older changes
 
904
 
 
905
  For older Changes, see [[file:Changes_old.org]]
 
906
 
 
907
 
 
908
 
 
909
* COMMENT Setup
 
910
 
 
911
#+STARTUP: showstars
 
912
 
 
913
#+TITLE: Org-mode list of user-visible changes
 
914
#+AUTHOR:  Carsten Dominik
 
915
#+EMAIL:  carsten at orgmode dot org
 
916
#+OPTIONS: H:3 num:nil toc:nil \n:nil @:t ::t |:t ^:{} *:t TeX:t LaTeX:nil f:nil
 
917
#+INFOJS_OPT: view:info toc:1 path:org-info.js tdepth:2 ftoc:t
 
918
#+LINK_UP: index.html
 
919
#+LINK_HOME: http://orgmode.org