Release 7.8.03

Merge branch 'master' into maint

documentation of *org-babel-use-quick-and-dirty-noweb-expansion*

* doc/org.texi (Noweb reference syntax): Adding documentation of
  the *org-babel-use-quick-and-dirty-noweb-expansion* variable.

Add a note about :noweb-ref.

Thanks to Tomas Grigera for a preliminary patch.

More small fixes on `C-u C-c C-c' and checkboxes.

* org.el (org-ctrl-c-ctrl-c): Preserve symmetry when adding
and removing checkboxes with `C-u C-c C-c' on the first item
of a list.  Also, don't reinitialize checkboxes that are
already ticked.

Thanks to Nicolas Goaziou for these fixes.

Revert "Fix problem with `org-ctrl-c-ctrl-c' on the checkbox of the first item."

This reverts commit 4789bb5a79f004346c37e3a84d12f90ada24d277.

Be a bit more flexible when matching time values in timestamps.

* org.el (org-ts-regexp0, org-ts-regexp1): Also match a time
value with only one digit for the hours.

Thanks to François Pinard for mentioning this.

Document the new behavior of `C-u C-c C-c' on checkboxes.

* org.texi (Checkboxes): Document the new behavior of `C-u C-c
C-c' on checkboxes.

Fix problem with `org-ctrl-c-ctrl-c' on the checkbox of the first item.

* org.el (org-ctrl-c-ctrl-c): Don't make `C-c C-c' special
when ticking the checkbox of the first item.

org-list: Change behaviour of C-c C-c at a list item with an argument

* lisp/org-list.el (org-list-write-struct): Add an optional argument
  for structure changes happening outside the function.
* lisp/org.el (org-ctrl-c-ctrl-c): Now, C-u C-c C-c on the first item
  of a sub-list should toggle check-box presence of every item in the
  same sub-list.  Also fix check-box insertion on a single item.

Make Org work with bbdb 3.0

* lisp/org-bbdb.el (org-bbdb-old): New variable.
(org-bbdb-store-link):
(org-bbdb-open): Check for `org-bbdb-old'.
(org-bbdb-open-old):
(org-bbdb-open-new): New functions.

Patch by Ivan Kanis

org-agenda.el: Small code cleanup.

* org-agenda.el (org-batch-agenda, org-batch-agenda-csv):
Remove deleted function `org-encode-for-stdout'.

org.el (org-show-context): Complete docstring.

* org.el (org-show-context): Complete docstring.

Thanks to Michael Heerdegen for mentioning this.

org-agenda.el: Use `read-char-exclusive' instead of `read-char'.

* org-agenda.el (org-agenda-filter-by-tag): Use
`read-char-exclusive' instead of `read-char'.

Fix bug in mapper function

* lisp/org.el (org-scan-tags): Make sure org-map-continue-from is nil
at each match

Fix clock regexps

* lisp/org-clock.el (org-clock-in):
(org-clock-find-position): Remove erraneous space in regexp

Patch by Joe Vornehm Jr.

TINYCHANGE

Fix tiny typos.

Those have been fixed by Paul Eggert in Emacs first.

Fix typos.

Fixes already done in Emacs by Paul Eggert.

Resolve :noweb-ref when set at the property level during noweb expansion

* lisp/ob.el (org-babel-expand-noweb-references): Rather than using a
  pure regexp solution to resolve noweb references, actually check the
  information of every code block in the buffer.  This will cause a
  slowdown in noweb reference expansion, but is necessary for correct
  behavior.

org.el (org-map-continue-from): Fix typo in docstring.

* org.el (org-map-continue-from): Fix typo in docstring.

OrgOdtContentTemplate.xml: table-cells are now top aligned by default

* etc/styles/OrgOdtContentTemplate.xml (OrgTblCell): Modify
style:vertical-align attribute to top.
(OrgTblCell*): Inherit from OrgTblCell.
(Custom*TableCell): Force style:vertical-align to top.

See http://lists.gnu.org/archive/html/emacs-orgmode/2011-12/msg00780.html

org-drill.el: fix a few wrong :type spec.

* org-drill.el (org-drill-leech-method, org-drill-scope)
(org-drill-spaced-repetition-algorithm): Fix wrong :type spec.

Thanks to Joost Kremers for spotting this.

org.el: Also match cumulating properties like ":prop+:".

* org.el (org-property-re): Also match cumulating properties
like ":prop+:".

Thanks to Christoph LANGE for spotting this.

org-mouse.el: Remove useless commented functions.

org.texi: Split the table to fix the display of items.

* org.texi (Plain lists): Split the table to fix the display
of items.

Thanks to Elias Assarsson for spotting this, and to Takaaki
ISHIKAWA for providing a preliminary patch.

Use CD@LaTeX{} instead of CDLa@TeX.

Normalize the use of @LaTeX{} in the Org compact guide.

org.texi: Normalize the use of @LaTeX{} in the manual.

Thanks to Elias Assarsson for mentioning this problem.

org-odt.el: Declare vars and functions from htmlfontify

org-odt.el (org-odt-styles-dir): It is etc/org/ under vanilla Emacs

* org-odt.el (org-odt-styles-dir): Assume that the styles
files are located under `data-directory' of Emacs distribution
as etc/org/OrgOdtStyles.xml and
etc/org/OrgOdtContentTemplate.xml.  Also update docstring.
(org-export-odt-schema-dir): Update docstring.

org-odt.el: Honor author. timestamp and email options in preamble

* org-odt.el (org-odt-format-preamble): Honor following user
options: author, timestamp and email.  See

http://lists.gnu.org/archive/html/emacs-orgmode/2011-12/msg00539.html

org-exp-blocks.el: Fix regexp for matching the end of a block.

* org-exp-blocks.el (org-export-blocks-preprocess): Fix regexp
for matching the end of a block.

Thanks to Robert Lupton the Good for reporting this and to Nick
Dokos for digging the issue further.

org.texi (Plain lists): Fix misplaced explantion.

* org.texi (Plain lists): Fix misplaced explantion.

Thanks to Takaaki ISHIKAWA for spotting this and for
a patch to this effect.

Escape link path only if path contains space or non-ascii character

* org.el (org-open-at-point): Escape link path for http:, https:,
ftp:, news:, and doi: links only if the path contains space or
non-ascii character.

This should take care of mistakenly double-escaped links as reported
by Jeff Horn in <http://article.gmane.org/gmane.emacs.orgmode/48731>.

We are just guessing here and push the responsibility for proper
escaping to the target application.

* org.texi (Plain lists, Agenda files): Add index entries.

Manual: Consistently use 'Org mode'

* doc/org.texi: Use 'Org mode' instead of alternatives like
'Org-mode' or 'org-mode', as suggested in Phil's notes
('doc/Documentation_Standards.org').

Ignore headlines without a true headline

* org.el (org-refile-get-targets): Ignore headlines without a true
headline.

This fixes a bug reported by Nathan Neff in
<http://article.gmane.org/gmane.emacs.orgmode/50035>.

Headlines with just a keyword are ignored as possible refile target.

move `org-babel-lob-one-liner-regexp' into ob.el to fix autoloading error

* lisp/ob.el (org-babel-map-call-lines): Moved this file from
  ob-lob.el into ob.el to ease dependency pains.

Use theindex.inc and theindex.org as described in the manual.

* org-publish.el (org-publish-index-generate-theindex): Use
theindex.inc for storing index entries, and theindex.org for
including theindex.inc.

Commit f0d7ac removed the theindex.inc and directly included
index entries in theindex.org.  This is not as flexible as using
theindex.org as a page you want to manually edit, which can then
include theindex.inc with proper content.

Thanks to Stefan Vollmar for insisting about this issue.

Create proper file target for index entries in subdirectories.

* org-publish.el (org-publish-index-generate-theindex): Create
proper file target for index entries in subdirectories.

org-protocol.el: Fix spelling mistake.

* org-protocol.el (org-protocol-check-filename-for-protocol):
Fix spelling mistake.

Thanks to Paul Eggert for fixing this in Emacs first.

org-odt.el: Fix permissions

org-odt.el: Include author and date in the title

* lisp/org-odt.el (org-export-odt-default-org-styles-alist):
Add styles for title and subtitle.
(org-odt-format-toc): New.
(org-odt-format-preamble): New.  Users can redefine this to
customize what goes before the document body.  Currently it
outputs title, author and email, date and toc.
(org-odt-begin-document-body): Use `org-odt-format-preamble'.
(org-odt-format-date): Renamed from
`org-odt-iso-date-from-org-timestamp'.  Also added an
additional param for format string.
(org-odt-begin-annotation, org-odt-update-meta-file): Use
`org-odt-format-date'.

* etc/styles/OrgOdtStyles.xml (Title, OrgTitle, Subtitle)
(OrgSubtitle): New styles for formatting title.

org.texi: Fix small typo.

Thanks to Paul Eggert for fixing this in Emacs first.

* doc/org.texi (Agenda commands): Document org-clock-report-include-clocking-task

Add reference to this variable when describing the agenda clock report.

Merge branch 'master' of orgmode.org:org-mode

Code cleanup up: rename org-on-*-p to org-at-*-p.

Rename `org-on-heading-p' and `org-on-target-p' to
`org-at-heading-p' and `org-at-target-p' to be more
consistent with the org-at-*-p family.

Also define two aliases.

org.el: New function `org-at-drawer-p'.

* org.el (org-at-drawer-p): New function.
(org-end-of-line): Use it.

This function make the behavior of C-e in folded drawers consistent
with C-e in folded subtrees: in this case, point moves to the last
invisible characters of the line, not to the last character.

documentation of *org-babel-use-quick-and-dirty-noweb-expansion*

* doc/org.texi (Noweb reference syntax): Adding documentation of
  the *org-babel-use-quick-and-dirty-noweb-expansion* variable.

Merge branch 'master' of orgmode.org:org-mode

optional "quick and dirty" :noweb reference expansion

* lisp/ob.el (*org-babel-use-quick-and-dirty-noweb-expansion*):
  Controls the method in which noweb references are expanded.
  (org-babel-expand-noweb-references): Bring back the option for
  regexp-based noweb expansion.

Add a note about :noweb-ref.

Thanks to Tomas Grigera for a preliminary patch.

More small fixes on `C-u C-c C-c' and checkboxes.

* org.el (org-ctrl-c-ctrl-c): Preserve symmetry when adding
and removing checkboxes with `C-u C-c C-c' on the first item
of a list.  Also, don't reinitialize checkboxes that are
already ticked.

Thanks to Nicolas Goaziou for these fixes.

Revert "Fix problem with `org-ctrl-c-ctrl-c' on the checkbox of the first item."

This reverts commit 4789bb5a79f004346c37e3a84d12f90ada24d277.

Be a bit more flexible when matching time values in timestamps.

* org.el (org-ts-regexp0, org-ts-regexp1): Also match a time
value with only one digit for the hours.

Thanks to François Pinard for mentioning this.

Document the new behavior of `C-u C-c C-c' on checkboxes.

* org.texi (Checkboxes): Document the new behavior of `C-u C-c
C-c' on checkboxes.

Fix problem with `org-ctrl-c-ctrl-c' on the checkbox of the first item.

* org.el (org-ctrl-c-ctrl-c): Don't make `C-c C-c' special
when ticking the checkbox of the first item.

org-list: Change behaviour of C-c C-c at a list item with an argument

* lisp/org-list.el (org-list-write-struct): Add an optional argument
  for structure changes happening outside the function.
* lisp/org.el (org-ctrl-c-ctrl-c): Now, C-u C-c C-c on the first item
  of a sub-list should toggle check-box presence of every item in the
  same sub-list.  Also fix check-box insertion on a single item.

Merge branch 'filter-by-cat'

Implement category filtering.

* org-agenda.el (org-agenda-filter-preset): New alias.
(org-agenda-filter-by-category): New command.
(org-agenda-mode-map): Add the new command.
(org-agenda-custom-commands-local-options): Add category
filter preset.
(org-agenda-mark-filtered-text): Mark both tag and filter
overlays.
(org-agenda-category-filter-preset): New variable.
(org-finalize-agenda, org-agenda-redo)
(org-agenda-filter-make-matcher, org-agenda-filter-apply):
Handle both category and tag filters.
(org-agenda-filter-show-all-tag): Rename from
`org-agenda-filter-by-tag-show-all'.
(org-agenda-filter-show-all-cat): New function.
(org-agenda-set-mode-name): Show the category filter in the
modeline.

* org-faces.el (org-agenda-filter-category): New face.

* org.texi (Agenda commands): Update documentation about the
new category filtering feature.

This feature has been requested by several people -- thanks
to all of them for mentioning this possibility.

Make Org work with bbdb 3.0

* lisp/org-bbdb.el (org-bbdb-old): New variable.
(org-bbdb-store-link):
(org-bbdb-open): Check for `org-bbdb-old'.
(org-bbdb-open-old):
(org-bbdb-open-new): New functions.

Patch by Ivan Kanis

Merge branch 'master' of orgmode.org:org-mode

Revert "Honour existing restrictions when regenerating the agenda"

This reverts commit 9b250f8e091535466a37dcdcb9a3199ea0be9d41.

Revert "Honour existing restrictions when clocking in from the agenda"

This reverts commit fc1f01c54e5f9018374c15f11cf7b25c37996dd6.

Revert "Honour existing restrictions when visiting tasks from the agenda"

This reverts commit 31d003ad28a747e63935b45396d2995933514c5b.

org-agenda.el: Small code cleanup.

* org-agenda.el (org-batch-agenda, org-batch-agenda-csv):
Remove deleted function `org-encode-for-stdout'.

org.el: New command `org-check-dates-range'.

* org.el (org-check-dates-range): New command.
(org-sparse-tree): Use it.

Thanks to Marc-Oliver Ihm for discussions and code
about similar features.

Rename `org-write-agenda' to `org-agenda-write'.

* org-agenda.el (org-agenda-write): Rename from
`org-write-agenda'.
(org-agenda-mode-map, org-agenda-menu)
(org-batch-store-agenda-views): Use new name
`org-agenda-write'.

org.el: Honor 'start-level for `org-loop-over-headlines-in-active-region'.

* org.el (org-loop-over-headlines-in-active-region): Fix
docstring.
(org-todo, org-deadline, org-schedule): Honor the 'start-level
value of `org-loop-over-headlines-in-active-region'.

Fix bug about looping over archiving commands.

* org-archive.el (org-archive-subtree)
(org-archive-to-archive-sibling, org-toggle-archive-tag):
Bugfix: use 'region-start-level.

org.el (org-show-context): Complete docstring.

* org.el (org-show-context): Complete docstring.

Thanks to Michael Heerdegen for mentioning this.

org-agenda.el: Use `read-char-exclusive' instead of `read-char'.

* org-agenda.el (org-agenda-filter-by-tag): Use
`read-char-exclusive' instead of `read-char'.

Merge branch 'master' of orgmode.org:org-mode

Merge branch '5-org-todo-loop'

Merge branch '3-org-archive-loop'

Merge branch '2-org-agenda-write-buffer-name'

Merge branch '1-export-date-timestamp-format'

Fix bug in mapper function

* lisp/org.el (org-scan-tags): Make sure org-map-continue-from is nil
at each match

Honour existing restrictions when visiting tasks from the agenda

* lisp/org-agenda.el (org-agenda-switch-to): Widen org buffer only if point is
  outside the current restriction

Widen org buffer when visiting from agenda only if point is outside
current restriction.

Visiting a task with RET or TAB in the agenda should not affect the
org-mode buffer restriction unless the target task is not currently
visible due to the restriction.

Honour existing restrictions when clocking in from the agenda

* lisp/org-agenda.el (org-agenda-clock-in): Save restriction when clocking in from the agenda

Narrowed org buffers are now retained when clocking in from the agenda.
We only widen the buffer when the task to clock in is outside the existing
restriction.

Honour existing restrictions when regenerating the agenda

* lisp/org.el: Honour existing restrictions when regenerating the agenda

Narrowed org buffers are now retained when regenerating the agenda
with org-agenda-redo

Fix clock regexps

* lisp/org-clock.el (org-clock-in):
(org-clock-find-position): Remove erraneous space in regexp

Patch by Joe Vornehm Jr.

TINYCHANGE

Fix tiny typos.

Those have been fixed by Paul Eggert in Emacs first.

Fix typos.

Fixes already done in Emacs by Paul Eggert.

org-odt.el: Trivial change

org-odt.el: Re-arrange code

Initialize`org-export-odt-schema-dir' *before* initializing
`org-odt-styles-dir'.  This re-arrangement prevents the warning message that
notifies the user of missing OpenDocument schema files not lurk around in
the echo area like a sore-thumb.

Fix packaging of ODT exporter (org-7.8.02) in Gentoo

* org-odt.el (org-odt-lib-dir): Add docstring.
(org-odt-data-dir): New variable.  Use this variable to
control the locations from which the ODT exporter picks the
OpenDocument styles and schema files from.  Set this variable
explicitly only if the in-built heuristics for locating the
above files fails.
(org-odt-styles-dir-list, org-odt-schema-dir-list): New
variables.  Pay specific attention to (eval-when-compile ...)
form through which Makefile's $(datadir) - contained in
`org-odt-data-dir' - gets compiled in as a "hard coded"
constant.
(org-odt-styles-dir, org-export-odt-schema-dir): Add messages
to aid debugging.

* Makefile (etcdir): Remove this.
(stylesdir): Rename to datadir.
(datadir): Was stylesdir.
(STYLESFILES): Rename to DATAFILES.
(DATAFILES): Was STYLESFILES.  Offer a menu of files that is
available.  Package maintainers can use this list and their
own discretion to cherry-pick what they are willing to install
in their distribution.
(CP): Add recursive flag so that directories listed in
DATAFILES can be copied enbloc.
(install-lisp): Use conditional flag BATCH_EXTRA
(BATCH_EXTRA): "Target-specific variable value" that plumbs
the value of $(datadir) in to org-odt.el via
`org-odt-data-dir'.  See ChangeLog entries for
`org-odt-styles-dir-list' and `org-odt-schema-dir-list'.
(BATCH): Add BATCH_EXTRA.
(lisp/org-odt.elc): Force re-generation of this target every
time so that $(datadir) gets plumbed in to org-odt.el through
`org-odt-data-dir'.
(org-odt-data-dir): "FORCE" target.  Also a variable defined
in org-odt.el.
(install-etc): Rename this target to install-data.
(install-data): Was install-etc.

Fix for the following report:
http://lists.gnu.org/archive/html/emacs-orgmode/2011-12/msg00799.html

Ulrich Mueller <ulm@gentoo.org> writes:
  In Gentoo we have an issue with the location of the
  OpenDocument style files, reported to us in bug 396269 [1].

  When org-mode is installed as a separate Gentoo package, its
  lisp files are installed in
  /usr/share/emacs/site-lisp/org-mode/.  According to our
  policy, non-lisp files would go to
  /usr/share/emacs/etc/org-mode/. We would pass this as the
  "etcdir" parameter to "make install", so the odt style files
  would be installed in stylesdir =
  /usr/share/emacs/etc/org-mode/styles/.

  Now org-odt.el currently defines org-odt-styles-dir in a
  defconst, and it searches only in ../etc/styles/,
  ./etc/styles/, and ./etc/org/ relative to lispdir. Obviously
  it cannot find the files in the Gentoo location.

  [1] <https://bugs.gentoo.org/show_bug.cgi?id=396269>

Handle 'start-level value of `org-loop-over-headlines-in-active-region' for archiving commands.

* org-archive.el (org-archive-subtree)
(org-archive-to-archive-sibling, org-toggle-archive-tag)
(org-archive-set-tag): Handle the 'start-level value for
`org-loop-over-headlines-in-active-region'.

New allowed value 'start-level for `org-loop-over-headlines-in-active-region'.

* org.el (org-scan-tags): New parameter `start-level' to
scan only through headlines of that level.
(org-map-entries): New allowed value `region-start-level' for
the `scope' parameter, to allow scanning through headlines of
the same level than the first headline in the region.
(org-loop-over-headlines-in-active-region): New allowed value
'start-level.

This change gives more flexibility when looping over the active
region for commands like `org-schedule', `org-deadline', etc.
By setting `org-loop-over-headlines-in-active-region' to
̀start-level', those command will act upon headlines that are
of the same level than the first one in the region.

Allow to loop over active region for more archive commands.

* org-archive.el (org-archive-subtree)
(org-archive-to-archive-sibling, org-archive-set-tag)
(org-toggle-archive-tag): Allow to loop over the active region
by using `org-loop-over-headlines-in-active-region'.

Let `org-todo' loop over the active region.

* org.el (org-todo): Allow to loop over the active region by
using `org-loop-over-headlines-in-active-region'.

Resolve :noweb-ref when set at the property level during noweb expansion

* lisp/ob.el (org-babel-expand-noweb-references): Rather than using a
  pure regexp solution to resolve noweb references, actually check the
  information of every code block in the buffer.  This will cause a
  slowdown in noweb reference expansion, but is necessary for correct
  behavior.

contrib/lisp/org-element.el: Fix docstrings

org.el (org-map-continue-from): Fix typo in docstring.

* org.el (org-map-continue-from): Fix typo in docstring.

OrgOdtContentTemplate.xml: table-cells are now top aligned by default

* etc/styles/OrgOdtContentTemplate.xml (OrgTblCell): Modify
style:vertical-align attribute to top.
(OrgTblCell*): Inherit from OrgTblCell.
(Custom*TableCell): Force style:vertical-align to top.

See http://lists.gnu.org/archive/html/emacs-orgmode/2011-12/msg00780.html

New variable `org-agenda-write-buffer-name'.

* org-agenda.el (org-agenda-write-buffer-name): New variable.
(org-write-agenda): Use it.

Setting this variable through `org-agenda-exporter-settings' can
be useful -- thanks to Konstantin Ziegler for mentioning this need.

New option `org-export-date-timestamp-format'.

* org-exp.el (org-export-date-timestamp-format): New option to
define the way a timestamp in #+DATE will be exported.
(org-infile-export-plist): Use the new option.

Thanks to Torsten Wagner for this idea.

org-drill.el: fix a few wrong :type spec.

* org-drill.el (org-drill-leech-method, org-drill-scope)
(org-drill-spaced-repetition-algorithm): Fix wrong :type spec.

Thanks to Joost Kremers for spotting this.

org-element.el: Added "This file is not part of GNU Emacs".

org.el: Also match cumulating properties like ":prop+:".

* org.el (org-property-re): Also match cumulating properties
like ":prop+:".

Thanks to Christoph LANGE for spotting this.