Release 6.25a

Agenda: New hook for cleaning up the fancy diary buffer

Tags scan: Also find the first line in a buffer

Remember: Take annotation and initial from plist, if defined.

The annotation and initial contents for a remember template are
normally taken from the variables `annotation' and `initial', which
are bound by remember.  We now also check the property list for such
values, so that the link generating routine can force the right values
in there.

Feeds: Documentation fixes.

Remember: fix bugs with new mac-message code.

Release 6.25

Bugfix: Add file name only once to refile targets

With the setting

   (setq org-refile-use-outline-path 'file)

the file names ended up twice, like

    "xxx.org/level 1/level 2 (xxx.org)"

Now the second occurrence is omitted.

Docs: Document the "j" key in the agenda

Fix customization types: integer instead of number, where appropriate

Cleanup of the list of changes

Minor change

Minor change.

First shot at the list of changes for 6.25

Add documentation for org-protocol.el to the manual

org-exp-bibtex.el: Allow multiple citation keys per \cite macro

LaTeX supports \cite{key1,key2,...}.  Now org-exp-bibtex.el does as
well.

Inline tasks: Better docs

org-protocol.el:  Make the compiler happy

Inline Tasks: Fix bugs and installation problems

Agenda filter: Filter for entries with no effort defined

During secondary agenda filtering, pressing "?" now will install a
filter that selects entries which do not have an effort defined.

This new model was necessary because we needed to stop interpreting
entries with no effort defines as 0 effort.  This was inconsistent,
because for normal agenda sorting, the treatment of these entries
depends on the variable `org-sort-agenda-noeffort-is-high'.  Now this
variable is also respected during filtering.

HTML export:  Allow modification of table attributes.

The #+ATTR_HTML line can now be used to set attributes for the
following table.

Documentation:  Some fixes in the reference card

Adding new file org-protocol.el

Fix key bindings in org-mouse for XEmacs

Bugfix

Docbook export:  Process footnotes like normal text.

Patch by Baoqiu Cui.

Minor fix.

Bugfix: Swapping the last two subtrees in a file.

Rustom Mody writes:

>  The last two lines of my org file are
>
>  *** Vishnu Sahasranam
>  *** Ram Navami
>
>  without a newline at the end
>
>  Trying to reorder these two lines I do a M-S-down on second last
>  line I get
>
>  *** Ram Navami*** Vishnu Sahasranam

org-mtags.el: Fix copyright year.

Inline tasks:  New module org-inlinetask.el

This module implements inline tasks in Org-mode.  Inline tasks are
tasks that have all the properties of normal outline nodes, including
the ability to store meta data like scheduling dates, TODO state, tags
and properties.  However, these nodes are treated specially by the
visibility cycling and export commands.

intermediate

Emphasis:  Allow braces in pre and post match, important for LaTeX footnotes.

Footnotes: Fix bug with sorting inline footnotes.

Documentation:  Moving section about command line agenda extraction

This section is now in the Hacking appendix.

DocBook export: Installed the new DocBook exporter by Baoqiu Cui

org-feed.el: Make drawer name configurable

The name of the feed status drawer can now be configured, and each
feed can use a different name.  This will allow to point several feeds
at the same inbox heading.

Citations: Use RefTeX to insert citations

RefTeX can now be used to create a citation in Org-mode buffers.
Setup the buffer with #+BIBLIOGRAPHY: bibbase style

and create citations with `C-c C-x ['.

Agenda: Introduce user-defined sorting operators.

The new variable `org-agenda-cmp-user-defined' can contain a function
to test how two entries should be compared during sorting.
user-defined-up and user-defined-down can then be part of any sorting
strategy.

Dependencies:  Fix bug in blocker hook

The blocker hook did block entries if an older sibling had TODO children.

Fix typos

org-mac-message.el: Better links to multiple selected messages

Org-feed.el: improve documentation

org-feed.el:  More improvements.

This now keep a memory of what the items in the feed looked like using
a sha1 hash.  Therefore we now have the capability to trigger on item
*change* rather than addition.

Better backup files for remember.

Bugfix: org-ido-switchb

Chris Leyon writes:

>  For some semi-short time, org-ido-switchb has been broken, complaining
>  about wrong type arguments.  The attached one-line patch corrects
>  this.

Patch by Chris fixes this problem.

Links: Use buffer name as link description in w3-mode buffers

Remember: Keep changes to `auto-save-visited-file-name' buffer-local

org-feed.el: re-written

Fix typo in manual

Agenda: Make sure diary items are searched for a time.

The new variable `org-agenda-search-headline-for-time' also turned off
time searching for diary items as an unwanted side-effect.  This
commit makes sure that diary entries are always parsed for a time.

Fix structure problems in manual

Agenda: Fix bugs with FILETAGS

Harri Kiiskinen writes:

>  It seems that org-use-tag-inheritance set to regexp, the use of
>  #+FILETAGS: and org-todo-list do not work together. It seems, that a
>  regexp in org-use-tag-inheritance matching a tag set in #+FILETAGS
>  causes this error:
>
>  Debugger entered--Lisp error: (wrong-type-argument stringp nil)
>   string-match("^ +" nil)
>  [...]
>  when org-use-tag-inheritance is set to regexp "te"
>  with this file:
>
>  --------
>  #+STARTUP:
>  #+FILETAGS: tea
>  * TODO testing         :test:
>  ** TODO too        :data:
>  -----
>
>  When the regexp is "tes", so that the FILETAG does not match,
>  org-todo-list produces a correct list.

This is indeed a bug.  The all to `org-get-tags-at' does change the
match data if there is a match for the inheritance regexp.  This
problem is now avoided by first extracting (match-string 1), and then
getting the tags.

Studying this bug also exposed another one, namely that file tags are
not marked as inherited tags.  This is now fixed, immediately when
the #+FILETAGS line is parsed.

preparatory work

Org-feed.el:  Make node creation template-based.

Fixing typos

org-feed.el: Documentation

Org-feed.el: Improvements

org-publish: Improve documentation strings of hooks

New file lisp/org-feed.el

HTML export: Allow "- ___" to explicitly terminate a list

If a list contains "- ___" as an item, this terminates the list,
ignoring this item.

Remember: Remove backup file name after successful storage

Clock: Clock out when done also in indirect buffers

Chris Randle writes:

>  I have one giant Org-mode file for everything. I frequently use
>  `C-c C-x b' to take the current node and show it in a new frame
>  with narrow subtree so that I can concentrate on just that region
>  of my file. Rather like hoist in GrandView, if anyone remembers
>  that.
>
>  My Org Manual (6.24b) says "The indirect buffer...will contain
>  the entire buffer, but will be narrowed to the current
>  tree. Editing the indirect buffer will also change the original
>  buffer, but without affecting visibility in that buffer.
>
>  I've noticed that, when working in the new frame, changing the
>  TODO state of any item within the frame to DONE (when it is the
>  currently clocked in item) does not stop the clock. Going back to
>  my main frame and doing the same thing there on the same item
>  does stop the clock.
>
>  I haven't altered `org-clock-out-when-done', and Emacs reports
>  its value as t.

This was caused by the fact that markers seem to point to the
base buffer always, so we need to check if the current buffer's
base buffer is equal to the marker buffer.

Bugfix: Add explamation mark to post-emphasis characters

Reported by Baoqiu Cui.

Read-date: New hook

The new hook `org-read-date-minibuffer-setup-hook'.

org-mac-message.el: New functions to access flagged mail

Chritopher Suckling writes:

>  All,
>
>  For various reasons (mainly Spotlight and an excess of HTML mail
>  send by employers), I've migrated back to Mail.app after some
>  time in Mutt (and how I miss the speed and threading).
>
>  I habitually flag mails that need attention at a later date, and
>  rather than use both org-mode and Mail.app to keep track of what
>  needs doing, I've written a couple of hybrid elisp AppleScript
>  functions to suck links to my flagged email into org-mode.
>

org-mac-message.el now contains these new functions.

Remember: Allow backup files for remember buffers

When setting the variable `org-remember-back-directory', each
remember buffer created will now get its own unique file name in that
directory.  So if you, by accident, overwrite a remember buffer or
remove it before storing it, there will be a backup.

Fix typos

Mouse: Create better TODO menu

The TODO keyword made with org-mouse.el now calls org-todo to change
the keyword, so that the logging and note-taking works properly.

Documentation: Better info about S-cursor keys

Tables: Make M-a and M-e go to beginning and end of table field

This commit overloads the sentence commands M-a and M-e so that they
will work on table fields in tables.

Column view: Force truncate-lines while column view is active

Column view: Exclude archived trees, for speed.

New face for items switched in agenda to DONE.

Items are listed in the agenda sometimes in bright colors, to draw
attention to important tasks or deadlines.  When such an item is
switched to DONE, the state change is reflected by the new TODO
keyword, but the line itself might still be bright.  Org de-emphasizes
the line by changing the face of the line.  It used to change it to
the face `org-done', but now we use a new, independent face
`org-agenda-done'.

Agenda: No longer indent matching sublevels by dots.

When a tags/property match does match an entry and its sublevels, the
sublevels used to be indented by dots, to indicate that the matches
likely result from tag inheritance.  This is now no longer the
default, but you can get it back with

   (setq org-tags-match-list-sublevels 'indented)

LaTeX export: Apply macros also in header

LaTeX export: Fix bug in export of checkboxes with checked status

Patch by Baoqiu Cui

Bugfix: Fix indentation problems

David Maus writes:

>  When I start to clock a headline (C-c C-x C-i) that does not have a
>  LOGBOOK drawer orgmode inserts one but removes the indentation of the
>  first line below the headline:
>
>  Example:
>
>  * TODO Do something
>   Do this, do that etc.
>
>  after C-c C-x C-i becomes
>
>  * TODO Do something
>   :LOGBOOK:
>   CLOCK: [2009-03-20 Fr 19:03]--[2009-03-20 Fr 19:03] =>  0:00
>   :END:
>  Do this, do that etc.

Fixed with this commit, a patch written by Peter Jones.

LaTeX export: Better handling of levels below the headline boundary

Outline levels below the headline boundary are now treated better, as
proper list.  The variable `org-export-latex-low-levels' can now also
be `itemize' or `enumerate', to get the corresponding list structure.
The new default is `itemize', to make it parallel with the behavior in
HTML.

Checkboxes:  New face

Checkboxes not have their own face.  This can be used to make them
look different.  Default is still just bold.

Export: Fix bug when exporting to temporary buffer

When exporting to a temporary buffer, images to replace LaTeX
fragments cannot be produced, because there is no useful location
where they can be put.  Therefore, these images are not produced in
this case.

Refile: Don't error for self-refile when only going to a place

Refiling checks if an entry is refiled to itself.  Of course, this
check is irrelevant when using refile to jump to a location.

Stuck projects: Search subtree of un-stuck projects

This commit implements an important change:  When, during a
stuck-project search, a project tree is identified as not stuck, so
far the search would continue after the end of the project tree.  From
now on, the search continues in the subtree, so that stuck subprojects
can still be identified.

Export:  Improve centering, verse, and blockquote export

In verse environments, line breaks are now enforced both in LaTeX and
in HTML.  Centering is now implemented using a div rather than a
paragraph, so that there may be several paragraphs in the centering
environment.  Blockquotes now also may have several paragraphs.

Add icon file

Add vector versions of the unicorn logo

Bugfix: Make mouse click on tags do a tags search.

This used to work, but the tags search part was no longer reached
because of a bug in the sequence of checking regular expressions.

Centering:  Implement markup for centered text.

LaTeX Export: Fix vertical lines in tables

Export: Improve documentation about htmlize-output-style.

Alan E Davis writes:

>  Feature Request: that the pdf saved automatically from agenda be
>  immediately displayed
>  The saving of a pdf is a really nice feature.  I had hacked
>  org-agenda, I think, to automatically do this.  However, it would
>  be nicer if immediate display were optional.  I don't know
>  whether \C-u makes sense as a prefix to saving a file with \C-x
>  \C-w.  Perhaps not.

Why not, C-c C-x C-w is a fine idea for this.  It should now work.

Minor fix

Docstrings: Fix typos.

Sparse tree: New tree for times after a certain date.

Keys are `C-c / a', this command is for symmetry with `C-c / b'.

Notes: Remove empty drawer if note is aborted.

When a note is taken, the new drawer is created before the note is
taken.  Now the drawer is removed again if the note gets aborted and
if the drawer is empty.

Bugfix: Adding stars with C-c *

When calling C-c * before the first headline, the results where wrong.
Fixed now.

Date prompt: Use own history

The date prompt now has its own history.

ASCII export:  Improve export of description lists

The list bullet is now removed, and the double colon is replaced by a
single colon.

Fix bug in `org-toggle-fixed-width-section'.

Fixed-width sections start with a column followed by a space.
This function now toggle fixed-width sections accordingly to
the manual.

Incorporate changes from downstream Emacs

Fix typo.