Commit Graph

1448 Commits

Author SHA1 Message Date
Jason Dunsmore 3e6ac9dfe2 org.texi: Clarify documentation regarding TODO state change logging. 2011-11-09 14:06:09 -06:00
Carsten Dominik 278d5afa2f Allow time stampes without day name
* lisp/org-clock.el (org-clock-in):
(org-clock-find-position): Make space after date optional.
* lisp/org.el (org-set-regexps-and-options):
(org-ts-regexp):
(org-ts-regexp-both):
(org-ts-regexp1):
(org-ctrl-c-ctrl-c): Make `C-c C-c' on date fix the time stamp

* doc/org.texi (Creating timestamps): Document the effect of `C-c C-c'
on a timestamp.
2011-11-09 18:55:27 +01:00
Bastien Guerry 5f1bd9f9b7 org.texi: Add @cindex for "appointment".
* org.texi (Timestamps, Weekly/daily agenda)
(Weekly/daily agenda): Add @cindex for "appointment".
2011-10-29 12:53:52 +02:00
Eric Schulte 47e27c28b6 adding two new links to the template for inserting empty code blocks
* doc/org.texi (Literal examples): A new link to the template for
  inserting empty code blocks.
  (Structure of code blocks): A new link to the template for inserting
  empty code blocks.
2011-10-24 19:42:58 -06:00
Rafael Laboissiere 7f85ab17b6 Accurate description of info hyperlink format
Hyperlinks in the form "info:file#node" work with plain spaces in the
"node" part and do not need to have spaces encoded as %20.  This is
the case for me, who is using the Debian emacs-snapshot package,
version 20110926-1.

TINYCHANGE
2011-10-22 11:15:51 +02:00
Rafael Laboissiere cba42a44b2 Add footnote on how the hyperlink text is searched in Org files
* org.texi (External links): Add footnote on how the behavior of the
text search in Org files are controled by the variable
org-link-search-must-match-exact-headline.

This change is necessary in order to avoid misleading the user as
regards of the behavior of the search, in particular because the
default value of org-link-search-must-match-exact-headline is
'query-to-create.

TINYCHANGE
2011-10-22 11:15:47 +02:00
Carsten Dominik 0c8b9711a3 Agenda: Add missing option, document time stamp movement to future
* lisp/org-agenda.el (org-agenda-move-date-from-past-immediately-to-today):
New option.
(org-agenda-date-later): Improve the logical structure.

* doc/org.texi (Agenda commands): Document that S-right on a line
representing a past date will immediately shift that date to today.
2011-10-22 08:39:54 +02:00
Eric Schulte 94873e2767 Update documentation to reflect removal of #+PROPERTIES
* doc/org.texi (Buffer-wide header arguments): Update documentation to
  reflect removal of #+PROPERTIES.
2011-10-20 15:30:07 -06:00
Eric Schulte 04a978fde5 removing #+BABEL: lines in favor of general #+PROPERTIES: lines
* lisp/ob.el (org-babel-params-from-buffer): Removing #+BABEL: lines
  in favor of general #+PROPERTIES: lines.

* doc/org.texi (Buffer-wide header arguments): Removing documentation
  of the defunct #+BABEL: structure.
2011-10-20 13:42:31 -06:00
Carsten Dominik 8ffd320c69 Doc: Document that trees tagged with ARCHIVE still contribute to clocktable
* doc/org.texi (The clock table): Mention that ACHIVED trees contribute
to the clock table.
2011-10-16 13:12:26 +02:00
Eric Schulte 4a7dd1e087 binding new code block header argument helper function to C-c C-v h 2011-10-08 16:38:32 -06:00
Carsten Dominik eed6b353d2 Manual: Better yasnippet config info
* doc/org.texi (Conflicts): Better yasnippet config info

Patch by Sylvain Rousseau.
TINYCHANGE
2011-10-08 18:32:16 +02:00
Achim Gratz ccc99317de backport copyright and license headers from Emacs trunk 2011-08-24 22:32:38 +02:00
Bastien Guerry f893659b27 org.texi: Document the restriction about field and column names. 2011-08-23 16:34:35 +02:00
Bastien Guerry 98ae074c8a org.texi: Explicitely mention the default values for select/exclude tags.
* org.texi (Selective export): Explicitely mention the default
values for `org-export-select-tags', `org-export-exclude-tags'.

TINYCHANGE
2011-08-23 16:17:56 +02:00
Tom Dye 5303994d9a * doc/org.texi: Added a line to specify that header arguments are lowercase. 2011-08-21 12:32:01 -06:00
Tom Dye ec18abdddd * doc/org.texi: :var requires default value when declared 2011-08-19 10:44:53 -06:00
Bastien Guerry 95d0c42c5a Use correct name for the function `yas/next-field'.
org.texi (Conflicts): Use correct name for the function
`yas/next-field'.

Thanks to Bianca Lutz for pointing this.
2011-08-17 15:22:23 +02:00
Bastien Guerry 13bf859c97 org.texi: Add a note about the `org-link-frame-setup' option.
* org.texi (Handling links): Add a note about the
`org-link-frame-setup' option.

Thanks to Reiner Steib for pointing at this.
2011-08-17 15:10:07 +02:00
Bastien Guerry 3e4e91322d Remove arch-tag at the bottom of documentation files. 2011-08-15 20:04:55 +02:00
Julian Gehring a8de7b7fc8 orgcard: correct reference to manual 2011-08-14 18:31:06 +02:00
David Maus fd5828ab77 Fix command line syntax for agenda batch commands
* org.texi (Exporting Agenda Views, Extracting agenda information):
Fix command line syntax, quote symbol parameter values.
2011-08-10 09:43:57 +02:00
David Maus a6f13963d7 Fix command line syntax of `org-batch-store-agenda-view'
* org.texi (Exporting Agenda Views): Fix command line syntax.

You cannot use 'emacs -f org-batch-store-agenda-view' because it is
implemented as macro, not function.
2011-08-10 09:43:57 +02:00
Eric Schulte 41bf22f4dc Revert "new interactive function for removing code block results"
This reverts commit 72817926d7.
2011-08-01 15:45:58 -06:00
Eric Schulte 72817926d7 new interactive function for removing code block results
* lisp/ob-keys.el (org-babel-key-bindings): Bound to C-c C-v k.

* lisp/ob.el (org-babel-map-regexp): New generic mapping macro.
  (org-babel-map-inline-src-blocks): Rewritten to use new macro.
  (org-babel-kill-results): Remove some or all results in the current
  file.

* lisp/ob-lob.el (org-babel-map-call-lines): Map over all lob call
  lines in the current file.

* doc/orgcard.tex: Document new keybinding.
2011-07-29 10:31:56 -06:00
Eric Schulte c88c76b551 doc: flesh out description of ":eval" header argument
Thanks to Stephen Eglen for this patch
2011-07-28 17:00:13 -06:00
emacs 7340cee33a Update website to show 7.7 as current release 2011-07-28 10:33:35 +00:00
Bastien Guerry c7a53afc47 org.texi: mention 'region as a possible scope for `org-map-entries'.
* org.texi (Using the mapping API): mention 'region as a
possible scope for `org-map-entries'.
2011-07-28 10:51:57 +02:00
Bastien Guerry 70fab165e1 org-table: new defcustom `org-table-duration-custom-format'.
This allows to display the output of duration computations
as a fraction of days, hours, minutes or seconds.

Thanks to Daniel E. Doherty for bringing up this need.

* org-table.el (org-table-duration-custom-format): New
defcustom to select output format of durations computations.
(org-table-time-seconds-to-string): Use the new variable.
(org-table-eval-formula): Allow `t' as a flag, on top of `T'.
`t' will use the custom output format defined in
`org-table-duration-custom-format.
2011-07-27 13:14:37 +02:00
Carsten Dominik 30dccb04bf Add key and documentation for `org-copy-visible'.
* lisp/org.el (org-org-menu): Add `org-copy-visible' to the menu.
* doc/org.texi (Visibility cycling): Document `org-copy-visible'.
* doc/orgcard.tex: Document `org-copy-visible'.
2011-07-26 12:09:50 +02:00
Bastien Guerry c222e8f134 org-capture: Fix order of template sequences.
* org-capture.el (org-capture-templates): docstring fix.
* org.texi (Template expansion): order template sequences in
the proper order.

Thanks to Philipp Möller for this fix.
2011-07-25 23:08:45 +02:00
Eric Schulte b1724e02fb adding a function for inspecting code block information e.g., header arguments
* lisp/ob.el (org-babel-view-src-block-info): New function to inspect code blocks.
* lisp/ob-keys.el (org-babel-key-bindings): Key bindings for org-babel-view-src-block-info.
* doc/orgcard.tex: Documentation of new Babel function.
2011-07-25 10:50:56 -06:00
Bastien Guerry 829e226536 org-table: fix another bug in duration computation.
* org-table.el (org-table-eval-formula): Fix bug when a
formula "range" is just one cell.
(org-table-time-string-to-seconds): don't check whether
we manipulate a string.
2011-07-25 00:55:04 +02:00
Bastien Guerry ef670abc49 org.texi: small update on durations computation. 2011-07-24 18:44:23 +02:00
Bastien Guerry 88eada52a6 org: allow relative time in `org-add-planning-info'.
(org-deadline, org-schedule): Improve docstrings.
(org-add-planning-info): Allow relative time like "-2d" or
"++2w" for the TIME argument.

The user can now call `org-schedule' and `org-deadline'
and use "+1d" to say that the task must be scheduled one
day later than today, or "++1d" to say that the task must
be scheduled one day later than the current SCHEDULED date,
if any.

This also works in agenda: you can select several entries
and reschedule them to +2d.

Thanks to Memnon Anon for insisting an finding a solution
for this!
2011-07-24 18:08:24 +02:00
Bastien Guerry fe0c013965 org.texi: minor typo. 2011-07-19 20:21:34 +02:00
Bastien Guerry 4670e95458 Merge branch 'master' of orgmode.org:org-mode 2011-07-19 18:34:02 +02:00
Bastien Guerry 3482284bbd Make sure :html-pre/postamble can insert the output of a custom function.
This function must have no argument and must output a string to be inserted
in the HTML export.

Thanks to Sander Boer for pointing at this.
2011-07-19 18:33:53 +02:00
Nicolas Goaziou ac023b418b Fix documentation typo 2011-07-19 14:58:33 +02:00
Nicolas Goaziou 90d72bcfc0 Added documentation for the extended %F capture template element 2011-07-19 08:56:10 +02:00
Eric Schulte 06bf0eb7fe ob-java: minimal support for evaluation of java code blocks 2011-07-18 10:08:04 -06:00
Bastien Guerry 14ba8ebc28 doc/org.texi: Fix tiny typo. 2011-07-13 12:22:37 +02:00
Bastien Guerry 22fa9bf222 org.texi (Special agenda views): Fix double quoting (bug#3509).
Patch by Lars Magne Ingebrigtsen taken from emacs latest bzr repo.
2011-07-12 16:56:11 +02:00
Nicolas Goaziou ddff0a8f8c Document circular motions and sub-lists offset 2011-07-12 09:12:48 +02:00
Bastien Guerry 35323baee5 doc/org.texi: Fix tiny typo. 2011-07-12 00:19:15 +02:00
Achim Gratz ce3431c4b0 remove Makefile target install-info-debian, modify install-info to be compatible
* Makefile: remove target install-info-debian and modify target
  install-info so that it is compatible with the older dpkg version
  of install-info that resides in /usr/sbin and may be picked up
  when root is installing info files

Initial reporting by Jude DaShiell, suggestions for changing Makefile
by Nick Dokos.  The solution implemented re-arranges the arguments to
install-info to be compatible with both the dpkg and GNU version of
the program.  On Debian, /usr/bin/install-info is actually a wrapper
that calls /usr/bin/ginstall-info and issues the following warning
when called as root:

This is not dpkg install-info anymore, but GNU install-info
See the man page for ginstall-info for command line arguments

This warning can be safely ignored since we actually prefer that GNU
install-info is called even though we've arranged the arguments to
be compatible with dpkg install-info.

Tested on openSuSE Tumbleweed, Win7/Pro (both MSys and Cygwin) and by
Jude DaShiell on Debian Squeeze and Slackware.

TINYCHANGE
2011-07-12 00:18:44 +02:00
Eric Schulte 6911f0eb27 doc: expand discussion of the :eval header argument
* doc/org.texi (eval): Expand discussion of the :eval header argument.
2011-07-11 11:47:24 -06:00
Bastien Guerry daaf43e2ff doc/org.texi: document `org-clock-timestamps-up'. 2011-07-10 11:04:41 +02:00
Bastien Guerry e6f45face6 Rename org-export-convert-* to org-lparse-convert-*
The org-export-* prefix is confusing here, as these functions
seem to be part of org-exp.el.  Let's name them by the library
they are in (and rely on) for now -- maybe this will change
when we move the ODT exporter to the core.
2011-07-08 12:39:05 +02:00
Bastien Guerry aea3efde8f doc/org.texi: be a bit less formal in ODT's "Additional documentation" 2011-07-08 12:20:01 +02:00
Bastien Guerry f305a6f81a org.texi: Add Lilypond and Awk as supported languages.
* install/git/org-mode/doc/org.texi (Languages): Add Lilypond and
Awk as supported languages.

Thanks to Torsten Anders for spotting this.
2011-07-07 22:00:30 +02:00
Bastien Guerry 468e38de90 org.texi: minor fix: use english version for DATE.
Thanks to Giovanni Ridolfi for spotting this!
2011-07-07 13:44:56 +02:00
Bastien Guerry 9c05a7c781 Bump to version 7.6 2011-07-06 21:06:03 +02:00
Bastien Guerry 0fba25a37f Bump to version 7.6 2011-07-06 21:05:28 +02:00
Bastien Guerry 43c08a1fbd org.texi: avoid export problem with double dashes.
Thanks to Sébastien Delafond for reporting this.
This closes Debian bug #632158 - http://bugs.debian.org/632158
2011-07-05 12:28:09 +02:00
Nicolas Goaziou dfd1257eb3 Add missing white spaces also in Org guide 2011-07-04 18:42:29 +02:00
Nicolas Goaziou 89b94b2459 Add some white spaces missing in documentation 2011-07-04 18:36:45 +02:00
Suvayu Ali 71d871f96e Improve "Images in LaTeX export" documentation
* Mention use of keywords like multicolumn and float
* Remove previous mention of hack with placement option
  as per comments on the mailing list. The hack is
  better suited for Worg.
2011-07-04 15:03:06 +02:00
Jambunathan K 75fcdda72c doc/org.texi: Add a new node for OpenDocumentText exporter
--

>From 1177aa67678e2c9b0fd1d65cd0d87436fd63a08e Mon Sep 17 00:00:00 2001
From: Jambunathan K <kjambunathan@gmail.com>
Date: Sat, 2 Jul 2011 22:40:18 +0530
Subject: [PATCH 2/2] doc/org.texi: Add a new node for OpenDocumentText exporter
2011-07-03 12:36:21 +02:00
Bastien Guerry ac52b4af77 org.texi: Add a subsection about computing durations. 2011-07-02 13:36:13 +02:00
Nicolas Goaziou 23bb8d0347 Slight modifications to footnotes documentation 2011-07-01 10:45:44 +02:00
Eric Schulte 554021ad7f doc: Explicit about the ability to tangle to other directories.
* doc/org.texi (tangle): Be explicit about the ability to tangle to
  other directories.
2011-06-28 13:27:33 -07:00
Bastien Guerry 3765304c85 doc/org.texi: footnote: don't put timestamps in headlines.
This was suggested by Simon Guest.
2011-06-28 15:30:50 +02:00
Bastien Guerry 5fb7c161da org.texi: complete org-crypt config example
Complete org-crypt config example with a hackish workaround
to disabling auto-save locally in a buffer:

# -*- buffer-auto-save-file-name: nil; -*-

Thanks to Bill Day for suggesting this.
2011-06-27 18:54:31 +02:00
Bastien Guerry bff1445d49 doc/org.texi: mention (setq auto-save-default nil) in org-crypt.el section. 2011-06-27 18:48:49 +02:00
Achim Gratz d37223562d Introduce CLOCK_INTO_DRAWER property like the existing LOG_INTO_DRAWER
* lisp/org.el (defcustom org-log-into-drawer): correct typo
* lisp/org-clock.el: new function org-clock-into-drawer to change
  the location of clock events based on properties CLOCK_INTO_DRAWER
  or, as fallback, LOG_INTO_DRAWER, like it is already possible for
  state change logs.
* lisp/org-clock.el (org-clock-jump-to-current-clock): add statement
  to let clause to bind org-clock-into-drawer to result of function
  eval
* lisp/org-clock.el (org-clock-find-position): add statement
  to let clause to bind org-clock-into-drawer to result of function
  eval, change let to let* since the binding is used later in the
  same clause
* doc/org.texi: document that both CLOCK_INTO_DRAWER and
  LOG_INTO_DRAWER can be used to override the contents of variable
  org-clock-into-drawer (or if unset, org-log-into-drawer)
* doc/org.texi: @xref->@pxref
2011-06-27 12:12:23 +02:00
Bastien Guerry 164214668e Delete suspicious + sign.
Thanks to Nick Dokos for spotting this.
2011-06-27 09:31:27 +02:00
Bastien Guerry f4a7e1b398 org.texi: Fix double-spaces at the end of sentences.
Thanks to Julian Gehring for these corrections!
2011-06-25 11:53:21 +02:00
Eric Schulte 00c62aa65f doc: documenting the new option for inline call lines
* doc/org.texi (Evaluating code blocks): Documenting the new option
  for inline call lines.
2011-06-24 15:22:42 -07:00
Eric S Fraga 301395c6ef Minor doc fix. 2011-06-24 12:26:07 +02:00
Bastien Guerry f6cc26705f More documentation stylistic fixes.
Thanks to Julian Gehring for these corrections.
2011-06-24 12:18:57 +02:00
Bastien Guerry 90bdc89e86 org.texi: minor documentation fixes.
Thanks to Julian Gehring for this patch!
2011-06-24 12:07:26 +02:00
Carsten Dominik e734ed2c08 Use org- instead of diary- documentation of in sexp calls 2011-06-22 08:57:37 +02:00
Eric Schulte d315f253d4 doc: more explicit about the mechanism through which interactive evaluation of code is performed
Thanks to Herbert Sitz for stressing the importance of this point.

* doc/org.texi (Results of evaluation): More explicit about the
  mechanism through which interactive evaluation of code is performed.
2011-06-21 11:05:02 -07:00
Carsten Dominik ed02a6f8d1 Merge branch 'master' of orgmode.org:org-mode 2011-06-17 05:55:42 +02:00
Carsten Dominik b2ab82f969 Mention dependency on calendar-date-style 2011-06-17 05:55:27 +02:00
Eric Schulte 71c5f252ba documentation of new noweb-ref header argument
* doc/org.texi (noweb-ref): New header argument documentation.
2011-06-15 21:48:32 -07:00
Eric Schulte f5709fc0e5 Revert "documentation of `org-babel-tangle-named-block-combination'"
This reverts commit c4737ae48b.
2011-06-15 20:14:42 -07:00
Carsten Dominik e78ed7bbde Add subsubsection for :padline 2011-06-15 08:52:18 +02:00
Eric Schulte c4737ae48b documentation of `org-babel-tangle-named-block-combination'
* doc/org.texi (Extracting source code): Documentation of the new
  org-babel-tangle-named-block-combination variable.
2011-06-10 13:08:41 -06:00
Eric Schulte 1b3b4c9239 doc: explicitly state that the behavior of multiple blocks of the same name is undefined
* doc/org.texi (Structure of code blocks): explicitly state that the
  behavior of multiple blocks of the same name is undefined
2011-06-10 13:04:20 -06:00
Christian Egli e6f90729a0 Taskjuggler: support the new effort durations
* lisp/org-taskjuggler.el (org-taskjuggler-clean-effort): handle any
effort that is accepted by `org-duration-string-to-minutes´.
* doc/org.texi (TaskJuggler export): Modified the example to reflect
the new effort durations.

The Effort property previously had no unit attached. With release 7.5
of orgmode you can now attach units to it such as 4h, 2d or 2m. This
patch enhances the exporter to accept the same effort specifications.

Note: This change is NOT BACKWARDS COMPATIBLE. Where the exporter
previously assumed a plain number was meant to be days, it now assumes
it to mean minutes. You will have to change existing effort
specifications from e.g. '2' to '2d'. A simple M-x
query-replace-regexp should do.
2011-06-08 17:03:23 +02:00
David Maus 3433861e62 Escape curly brackets in texinfo LaTeX example block
* org.texi (Images in LaTeX export): Escape curly brackets in LaTeX
example.
2011-06-02 09:10:05 +02:00
Carsten Dominik 7c6323ef09 Add param :properties to list properties in clocktable
* doc/org.texi (The clock table): Document the :properties and :inherit-props
arguments for the clocktable.
* lisp/org-clock.el (org-clocktable-write-default): Implement adding property
columns to the clock table.

Patch by Niels Giesen.
2011-05-31 14:20:14 +02:00
Carsten Dominik 95555a4eaa Document specifying placement options for tables
* doc/org.texi (Tables in LaTeX export): Document specifying placement
options for tables.

Patch by Suvayu Ali.
2011-05-31 13:52:47 +02:00
Carsten Dominik 35baef01b0 Add documentation for org-crypt.el
Patch by Ian Barton.
2011-05-31 13:40:00 +02:00
Eric Schulte 5d1674f330 improved documentation of header arguments in #+call lines
* doc/org.texi (Evaluating code blocks): More specific documentation
  about the different types of header arguments.
2011-05-27 10:34:58 -06:00
Michael Brand cf0c163ea6 Small documentation fix
TINYCHANGE
2011-05-24 05:14:22 +02:00
Eric Schulte 7d12d45778 ob: new function to check header arguments for errors C-c C-v c
* doc/orgcard.tex: Adding line for org-babel-check-src-block.
* lisp/ob-keys.el (org-babel-key-bindings): Adding key sequence for
  org-babel-check-src-block.
* lisp/ob.el (org-babel-expand-src-block): Fit within 80 cols.
  (org-babel-edit-distance): Returns the edit distance of two strings.
  (org-babel-check-src-block): Check a code block for errors.
2011-05-13 10:54:44 -06:00
Carsten Dominik d6aba4db77 Fix braces bug in manual. 2011-05-11 12:33:41 +02:00
Manuel Giraud d90f1c29b4 Document Sitemap sans extension
* doc/org.texi (Sitemap): Document `:sitemap-sans-extension' property.
2011-05-11 10:18:59 +02:00
Carsten Dominik bffdfeb7fc Implement a minor mode for the editor following the cursor through the table
* doc/org.texi (Built-in table editor): Document the table field follow mode.
* lisp/org-table.el (org-table-exit-follow-field-mode-when-leaving-table):
New option.
(org-table-check-inside-data-field): New optional argument `noerror'.
When set, the function will only return nil instead of throwing an
error.
(org-table-edit-field): Interpret double prefix argument, and improve
the properties of the editing window.
(org-table-follow-field-mode): New minor mode.
(org-table-follow-fields-with-editor): New function.

The main purpose of this functionality is to make working with table
with long fields simpler, by always showing the full content of the
current field.  This functionality is based on the following
mailing list thread

http://thread.gmane.org/gmane.emacs.orgmode/41584

and contains ideas by Jonny, Juan Pechiar, and Michael Brand.
2011-05-11 10:11:45 +02:00
Thomas S. Dye cd05598dcd Optional \caption argument for LaTeX export
Aloha all,

The attached patch initializes the existing variable shortn, adds it to
two caption situations in addition to the one already coded, and adds
some description to the manual.

With this patch, #+CAPTION: [Short caption]{Long caption.} in the
Org-mode source exports to \caption[Short caption]{Long caption.} in the
LaTeX export, which is, I think, as it should be.

Many thanks to Nick Dokos who made me understand why earlier patches
hadn't shown up on the patchwork server (wrong mime type, evil mail
client).  This one sent with gnus and fingers crossed.

All the best,
Tom

>From 9dc65f7e598dd171ebce9448cd39c4062f7cafff Mon Sep 17 00:00:00 2001
From: Tom Dye <tsd@tsdye.com>
Date: Sun, 8 May 2011 06:56:25 -1000
Subject: [PATCH] optional caption arguments in LaTeX export
2011-05-08 22:15:45 +02:00
Carsten Dominik eb2a890f10 Minor fix in manual 2011-05-06 17:34:51 +02:00
Tom Dye b45bef8ffa Refer to language specific Babel header arguments 2011-05-05 14:53:20 -06:00
Carsten Dominik e98237927f Document the capture property :table-line-pos 2011-05-05 09:58:31 +02:00
Robert P. Goldman 62c12cc50f Add an easy template for index (i)
* lisp/org.el (org-structure-template-alist):  Add an easy template
for index (i), and move include file to I from i.
* doc/org.texi (Easy Templates): Document new template.

Notes about this patch:
1.  It breaks some old user-visible behavior, since <i changes meaning.
    Per Nick's posting, we expect that if index is used, it will be used
    more commonly than include file.  However, since this is a custom,
    behavior could be changed.  Indeed, we could put index on capital
    I with a suggestion that users who are indexing should swap in their
    customizations.
2.  I modified the docstring for org-structure-template-alist, which did
    not explain the function of the "?" in the string.  Someone should
    check and verify I didn't get this wrong.
3.  There doesn't seem to be a Muse tag equivalent for #+index, so I
    just made the Muse equivalent of #+index be #+index.  I don't know
    org-mtags enough to know if this is appropriate.
2011-05-04 09:49:31 +02:00
Robert P. Goldman a8b6fa0bf3 Add a cross-reference from "Literal Examples" to "Easy Templates."
* doc/org.texi (Literal examples): Add a cross-reference
from "Literal Examples" to "Easy Templates."

Easy templates are especially useful for entering the begin and end pairs
that arise in supplying literal examples.
2011-05-02 11:17:45 +02:00
Carsten Dominik 7bab535b79 Add a link to documentation
* doc/org.texi (The clock table): Add link to match syntax.
2011-05-02 09:10:50 +02:00
Carsten Dominik 02441ed433 Implement clock consistency check functionality for agenda
* lisp/org-agenda.el (org-agenda-clock-consistency-checks): New option.
(org-agenda-list): Handle display change to clock check.
(org-agenda-get-progress): Show only clock entries if we are doing the
consistency check.
(org-agenda-show-clocking-issues): New function.
(org-agenda-check-clock-gap): New function.
(org-agenda-view-mode-dispatch): Offer consistency check.
(org-agenda-log-mode): Handle switch to clock only display.
(org-agenda-set-mode-name): Show lighter for Clockcheck.
* lisp/org.el (org-hh:mm-string-to-minutes): Accept an integer argument
and return it unchanged.
* doc/org.texi (Agenda commands): Document clock consistency checks.
* doc/orgcard.tex: Document key for clock consistency check.
2011-04-24 17:17:25 +02:00
Robert P. Goldman a285debf5c Fixed shell script example in "Emacs Lisp evaluation of variables."
The variable names in the header arguments and in the sh code didn't line
up.  Made them agree.
2011-04-22 08:06:26 -06:00
Bastien Guerry 6f2113b85c doc/org.texi: Fix typo.
Thanks to Xiao-Yong Jin for pointing this out.
2011-04-19 11:23:55 +02:00
Carsten Dominik 89de03cb8e Document the use of \vert in table fields
* doc/org.texi (Built-in table editor): Document that \vert represents
a vertical bar in a table field.
2011-04-17 16:41:40 +02:00
Carsten Dominik b99ab9250b Fix typo 2011-04-14 05:50:55 +02:00
Carsten Dominik b58db4e438 Add missing brace 2011-04-14 04:50:25 +02:00
Carsten Dominik e20166eb29 Fix the bulk scatter command to always schedule
* lisp/org-agenda.el (org-agenda-bulk-action): Allow bulk scatter
in all possible agenda views.  Use `org-agenda-schedule' instead of
`org-agenda-date-later'.

The bulk scatter command so far shifted the date that was causing an
entry to appear in the agenda.  However, the true intend was to
reschedule onto dates in the near future.  This patch fixes this
issue.  A side effect is that you can now bulk scatter tasks that to
not yet have a date, for example also tasks picked from the TODO
list.
2011-04-14 00:10:56 +02:00
Bastien Guerry 97ae094960 Merge branch 'master' of orgmode.org:org-mode 2011-04-09 09:24:41 +02:00
Eric Schulte 9fc5577646 doc: link from markup->literate-examples to working-with-source-code
* doc/org.texi (Literal examples): Link from "Markup" > "Literate
  Examples" to "Working with Source Code"
2011-04-08 15:54:54 -06:00
Puneeth Chaganti c717044a7c * doc/org.texi (Agenda commands): Doc for function option to bulk action. 2011-04-08 19:21:33 +02:00
Bastien Guerry a92aaf4db0 doc/org.texi: minor update.
Document `org-agenda-append-agenda' and `org-agenda-bulk-mark-regexp'.
2011-04-08 18:32:20 +02:00
Carsten Dominik 8a831e8f6c Introduce a new org-capture escape for arbitrarily defined time strings
* lisp/org-capture.el (org-capture-fill-template): Resolve new %<...>
template escape.
(org-capture-templates): Document new %<...> template escape.
* doc/org.texi (Template expansion): Document new %<...> template escape.
2011-04-06 08:49:12 +02:00
Nicolas Goaziou 346ef1f65f small documentation fix on checkboxes 2011-04-02 17:27:32 +02:00
Carsten Dominik 57c379bb26 Clean up the new options to remove tasks on export 2011-03-30 05:27:43 +02:00
Carsten Dominik b4e2ef4cb9 Allow to exclude tasks from being exported
* doc/org.texi (Selective export): Document exclusion of any tasks from
export.
* lisp/org-exp.el (org-export-with-tasks): New option.
(org-export-plist-vars): Add :tasks property.
2011-03-30 00:48:29 +02:00
Carsten Dominik 6d40eb3809 Implement export without DONE tasks
* doc/org.texi (Selective export): Document how to exclude DONE tasks
from export.
(Publishing options): Document the properties to be used to turn off
export of DONE tasks.
* lisp/org-ascii.el (org-export-as-ascii):
* lisp/org-docbook.el (org-export-as-docbook):
* lisp/org-html.el (org-export-as-html):
* lisp/org-latex.el (org-export-as-latex): Pass the :done-tasks property
to the export preprocessor.
* lisp/org-exp.el (org-export-with-done-tasks): New option.
(org-export-plist-vars): Add entry for :done-tasks.
(org-export-preprocess-string): Call `org-export-remove-done-tasks'.
(org-export-remove-done-tasks): New function.
2011-03-29 17:29:24 +02:00
Carsten Dominik 3dd4745752 Tables: Make @< and $< point to row/column 1 in a stable way 2011-03-17 06:50:39 +01:00
Carsten Dominik f4387417c4 Improve handling of years with limitations on representable dates
* lisp/org.el (org-read-date-force-compatible-dates): New option.
(org-read-date, org-read-date-analyze): Check representable date range.
* doc/org.texi (The date/time prompt): Document date range protection.

New variable `org-read-date-force-compatible-dates' to control
handling of dates.
2011-03-15 20:01:33 +01:00
Eric Schulte d0a4ed53f1 ob: new header argument `padline' controls newline padding around tangled code
* lisp/ob-tangle.el (org-babel-spec-to-string): Check value of padline
  on tangling, no longer use the now-removed variable
  `org-babel-tangle-pad-newline'.
* lisp/ob.el (org-babel-header-arg-names): Add padline to the list of
  header argument names.
  (org-babel-default-header-args): Set the default value of padline to
  "yes".
  (org-babel-merge-params): Cleaned up the merge logic, added padline.
* doc/org.texi (padline): Documentation of the new padline header
  argument.
2011-03-15 11:16:09 -06:00
Bastien Guerry fa37f767c9 doc/org.texi: Update on HTML preamble and postamble. 2011-03-15 16:18:23 +01:00
emacs 11a10bdfe7 Update website to show 7.5 as current release 2011-03-07 14:27:39 +00:00
Bastien Guerry 54c638523d org-capture.el: Rename :no-clock-out to :clock-keep.
(org-capture-templates): Rename :no-clock-out to :clock-keep.
(org-capture): Use :clock-keep instead of :no-clock-out.

Thanks to Bernt Hansen for the suggestion.
2011-03-07 15:21:13 +01:00
Bastien Guerry b969081ebd org-capture.el: new :no-clock-out template option.
* org-capture.el (org-capture-templates): New option
:no-clock-out.
(org-capture): Use the new option.

* org.texi (Template elements): document the new template
option :no-clock-out.
2011-03-07 11:43:58 +01:00
Nicolas Goaziou a93f576033 Documentation fixes 2011-03-06 20:19:15 +01:00
Bastien Guerry 145d1bf7e5 org.texi: use "x" as a key for the org-capture example.
"\C-cc" is already the recommended key for org-capture.
2011-03-06 18:23:18 +01:00
Bastien Guerry 6238e18a71 org.texi: fix typo about defining an org-capture key. 2011-03-06 18:22:13 +01:00
Bastien Guerry 030960559e org-capture.el: remove (currentfile) as a file specification in templates.
You can already use a function like (buffer-file-name) to get the currently
visited file.  So (currentfile) is not necessary.
2011-03-06 17:31:56 +01:00
Nick Dokos 18c1bcf645 typo in org.texi
Nick
2011-03-05 01:46:06 +01:00
Bastien Guerry 5953798522 Clean handling :html-pre/postamble options wrt author/email/creator-info.
* org-html.el (org-export-html-preamble)
(org-export-html-postamble): now default to `nil'.
(org-export-as-html): when :html-pre/postamble is nil, fall
back on the default pre/postamble, which depends on the
:author-info, :email-info, :creator-info options.

* org-exp.el (org-export-plist-vars): reorder the alist.

* org.texi (Export options): better document :html-preamble
and :html-postamble: setting these options will override any
:author-info, :email-info and :creator-info options for the
HTML export.
2011-03-04 16:32:10 +01:00
Carsten Dominik 236cdb292a Document the change of the default value `org-table-use-standard-references' 2011-03-03 22:16:35 +01:00
Carsten Dominik 5631a309ab Use @> and $> for referring to last row and column 2011-03-03 22:16:35 +01:00
Bastien Guerry c431fef47a doc/org.texi: tell where Org put SCHEDULED and DEADLINE.
Org puts this information on the line right after the headline.
If the user adds information between this line and the headline,
especially timestamps, then Org might be confused.  Ask the user
not to put information there.
2011-03-03 12:21:25 +01:00
Carsten Dominik 8237c9ae6d Implement table formulas that apply to field ranges, fix minor issues
* lisp/org-table.el (org-table-fedit-finish): Read more general LHS of formulas.
(org-table-formula-handle-@L): New function to hanle @L references.
(org-table-current-ncol): New variable.
(org-table-line-to-dline): New function.
(org-table-get-stored-formulas): Accept range formulas as matches.
(org-table-get-specials): Compute and store the number of columns.
(org-table-get-range): New optional argument CORNERS-ONLY, to retrieve
only the region marked by the range, not the content.
(org-table-recalculate): Call `org-table-expand-lhs-ranges' to expand
range targets.  Also check for duplicate access to fields.
(org-table-expand-lhs-ranges): New funktion.
(org-table-get-remote-range): Bind `org-table-current-ncol' to protect
the caller's value.
(org-table-edit-formulas): Support highlighting of range targets.
(org-table-field-info): Handle renge formulas.

* doc/org.texi (Field and range formulas): Renamed from "Field formulas".
Document the use of range operators as targets.
(References): Document the new @L reference.
2011-03-02 18:32:19 +01:00
Eric Schulte c6fd3f1a8b doc: adding "[" to list of characters triggering elisp evaluation
* doc/org.texi (var): Adding "[" to list of characters triggering
  elisp evaluation.
2011-03-02 07:50:57 -07:00
Eric Schulte 41550be424 doc: documentation of Emacs Lisp evaluation during variable assignment
* doc/org.texi (var): Documentation of Emacs Lisp evaluation during
  variable assignment.
2011-03-01 09:57:54 -07:00
Eric Schulte 280d5826c3 doc: add references from :colnames and :rownames to indexing into variables
* doc/org.texi (colnames): Reference indexing into variables, and note
  that colnames are *not* removed before indexing occurs.
  (rownames): Reference indexing into variables, and note that
  rownames are *not* removed before indexing occurs.
2011-02-27 21:01:59 -07:00
Eric Schulte b02ada7cd0 doc: clarification of indexing into tabular variables
* doc/org.texi (var): Clarification of indexing into tabular
  variables.
2011-02-27 17:23:12 -07:00
Eric Schulte 1d1654896e doc: documentation of the `:results wrap' header argument
* doc/org.texi (results): Documentation of the `:results wrap' header
  argument.
2011-02-27 12:58:54 -07:00
Bastien Guerry 67a7ba3ea3 doc/org.texi: Note about a limitation of the LaTeX exporter.
* org.texi (LaTeX and PDF export): add a note about a
limitation of the LaTeX export: the org file has to be
properly structured.
2011-02-26 17:35:24 +01:00
Carsten Dominik c654620d73 Allow file names in capture templates to be functions, forms, or variables
* lisp/org-capture.el (org-capture-expand-file): New function.
(org-capture-target-buffer):
(org-capture-set-target-location): Use `org-capture-expand-file'.

* doc/org.texi (Template elements): Document that files can be given
as function, form, or variable.
2011-02-22 10:10:22 +01:00
Nicolas Goaziou 9ec8510687 org.texi: minor corrections 2011-02-19 01:16:59 +01:00
Nicolas Goaziou af6037a695 Documentation changes for lists 2011-02-18 12:45:11 +01:00
Manuel Giraud 5f7654c6cf org-publish: sitemap doc
Hi,

Some documentation for new sitemap options.

>From 3a846a674a33a5f2a0a2404b88331942e2012779 Mon Sep 17 00:00:00 2001
From: Manuel Giraud <manuel.giraud@univ-nantes.fr>
Date: Mon, 14 Feb 2011 11:34:04 +0100
Subject: [PATCH] org.texi: documentation of sitemap's entry options
2011-02-14 21:56:18 +01:00
Bastien Guerry 9b23f082ea lisp/org-clock.el: allow to set the language through a new :lang parameter.
* org-clock.el (org-clock-clocktable-language-setup): New
custom variable.
(org-clocktable-defaults): Set the default language.
(org-clocktable-write-default): Use the new variable.
2011-02-13 13:57:06 +01:00
Bastien Guerry 0f40214ec1 org.texi: fix wrong reference to logredeadline and the likes. 2011-02-12 23:26:13 +01:00
Bastien 08650cbb5c Allow (currentfile) for capture templates.
* org-capture.el (org-capture-templates): document currentfile
for capture template.
(org-capture-templates): Allow to use currentfile for capture
templates.
(org-capture-set-target-location): Handle currentfile as a way
to setting the capture buffer.

* org.texi (Template elements): document currentfile for
capture templates.
2011-02-12 19:07:52 +01:00
Bastien Guerry af72eecf3a org.texi: update the info links syntax. 2011-02-11 13:40:52 +01:00
Bastien Guerry da8dc7bba7 Rewrite the handling of HTML preamble/postamble.
* org-html.el (org-export-html-auto-preamble)
(org-export-html-auto-postamble): Remove.
(org-export-html-preamble, org-export-html-postamble): Turn
into custom variables.  Update the docstrings.
(org-export-html-preamble-format)
(org-export-html-postamble-format): New custom variables.
(org-export-as-html): Use org-export-html-postamble-format and
org-export-html-preamble-format.
(org-export-html-title-format): delete.

* org-exp.el (org-export-plist-vars): Remove
:auto-preamble and :auto-postamble.  Rename :preamble and
:postamble to :html-preamble and :html-postamble.

* org-publish.el (org-publish-project-alist): Remove
:auto-preamble and :auto-postamble.  Rename :preamble and
:postamble to :html-preamble and :html-postamble.

* org.texi (Publishing options): replace :preamble and
:auto-preamble by :html-preamble (same for postamble.)
2011-02-11 01:27:15 +01:00
Valentin Wüstholz 39d5acd33c org-latex.el: match horizontal rules with HTML regexp
Also a slight update of the manual about horizontal rules.
2011-02-10 17:03:31 +01:00
Bastien Guerry eba3bee3db Mention org-agenda-tags-column. 2011-02-10 16:56:37 +01:00
Bastien Guerry 064423e9c7 org.texi: fix typo. 2011-02-09 17:27:22 +01:00
Manuel Giraud 334cf2038d Adds sort options when publishing the sitemap
This patch adds sort options to the sitemap.  In addition to
alphabetical order, one can choose chronological or anti-chronological
ordering of sitemap entries.  To retrieve file date, it tries to parse
the "#+date" keyword and if not present defaults to file modification
time.
2011-02-08 17:51:17 +01:00
Christoph Groth 2214788528 org-bbdb: allow anniversaries with unknown years
Anniversaries in BBDB can be now also specified in the format MM-DD
next to YYYY-MM-DD.
2011-02-08 16:57:53 +01:00
Bastien Guerry 712031900f doc/org.texi: Fix tiny bug. 2011-02-03 00:06:01 +01:00
Bastien Guerry 6849e48308 Fix minor typo about org-attach-open keybinding.
Thanks to Julian Gehring for spotting this.
2011-02-02 23:14:57 +01:00
Bastien Guerry b3c3746d92 New function org-narrow-to-block.
* org.el (org-narrow-to-block): New function to narrow to block.
Bound this function to `C-x n b'.
* org.texi (Dynamic blocks, Structure editing): Mention
the function `org-narrow-to-block'.

This is inspired by a request by Leonidas Tsampros.
2011-02-02 11:47:41 +01:00
Osamu Okano a017fca37f Various docstrings typo fixes by Osamu OKANO. 2011-02-01 13:05:13 +01:00
Brian Gough 8083344c86 add index entries 2011-02-01 12:37:43 +01:00
Brian Gough 93f7595f31 explain how to check the default version of Org 2011-02-01 12:35:59 +01:00
Brian Gough 653459d774 typo/grammar fix for .done CSS explanation 2011-02-01 12:34:35 +01:00
Brian Gough 63a1395be9 use code font for example footnote labels 2011-02-01 12:33:21 +01:00
Brian Gough f10558cc4f put emacs functions in code font 2011-02-01 12:32:02 +01:00
Brian Gough 5f51fe1cb1 make "time stamps" consistent with timestamps 2011-02-01 12:28:39 +01:00
Brian Gough 53125463be tangling is not a widely-known term, describe it as literate programming 2011-02-01 12:26:21 +01:00
Bastien Guerry df23e58b48 Rename org-complete.el to org-pcomplete.el to avoid file-name clash.
On Jan 26, 2011, at 10:34 AM, Eli Zaretskii wrote:

> The file org-complete.el, added about a month ago, causes a file-name
> clash with org-compat.el after 8+3 truncation.  This causes trouble
> when unpacking Emacs tarballs on DOS filesystems.

Also rename org-complete-* functions in org-pcomplete.el and remove a
wrong reference to org-complete in doc/org.texi.

We still use org-complete-* namespace for the custom group and the
custom variables.
2011-01-31 18:40:05 +01:00
Bastien Guerry 4688a2a962 org.texi: minor rephrasing.
Patch http://patchwork.newartisans.com/patch/459/ by Brian Gough was
marked as "accepted" on patchwork but did not appear in org.texi.  I
fixed this manually.
2011-01-27 11:02:31 +01:00
Brian Gough dc60db96c9 use @result{} instead of --> (looks nicer) 2011-01-26 18:33:07 +01:00
Carsten Dominik 1cb39b23f9 Merge branch 'master' of orgmode.org:org-mode 2011-01-26 10:58:38 +01:00
Eric Schulte 65ac69c016 doc: updating list of code block supported languages
* doc/org.texi (Languages): Updating list of code block supported
  languages.
2011-01-25 15:22:19 -07:00
Carsten Dominik 0faba848bd Fix documentation bug: CATEGORY is special property, but allowed in drawer
* doc/org.texi (Special properties): CATEGORY is a special property,
but it may also used in the drawer.
2011-01-24 09:37:52 +01:00
Carsten Dominik e879e284d4 Mention MobileOrg for Android in the guide 2011-01-21 11:55:01 +01:00
Carsten Dominik b7cfc159a3 Fix spacing after e.g. and i.e. in the guide 2011-01-21 10:14:28 +01:00
Carsten Dominik c466a9a759 Fix spacing after i.e. and e.g. 2011-01-21 10:11:56 +01:00
Eric Schulte 71650a1d1d doc: adding documentation of the :mkdirp tangling header argument
* doc/org.texi (mkdirp): Documentation of the :mkdirp header argument
2011-01-19 20:35:39 -07:00
Julien Danjou dc55710b60 Add command to reset agenda time span
* org-agenda.el (org-agenda-reset-view): New function.
(org-agenda-view-mode-dispatch): Bind space to org-agenda-reset-view.

Signed-off-by: Julien Danjou <julien@danjou.info>

* doc/org.texi (Agenda commands): Document `v SPC'.

* doc/orgcard.tex: Document v SPC
2011-01-18 11:14:20 +01:00
Carsten Dominik 1abfaf4917 Remove some unneeded lines in org.texi 2011-01-18 10:50:46 +01:00
Bastien Guerry 135085b2c2 doc/org.texi: slight rewriting on using #+INCLUDE with lines ranges 2011-01-18 01:25:15 +01:00
Puneeth Chaganti 7b399fe128 How do I include text between a range of line numbers with #INCLUDE
Hi Carsten,

On Sat, Jan 8, 2011 at 11:35 PM, Carsten Dominik
<carsten.dominik@gmail.com> wrote:
> Hi Puneeth,
>
> can cou please augment the patch with a propert ChangeLog-like entry, and
> with documentation for the manual, and then resubmit?

Here is a patch with a ChangeLog entry and documentation for the
manual. Please tell me if it looks OK. Also, I hope using
git-format-patch is the right way to send this page. If not, what is
the right way?

Thanks,
Puneeth

>From 4a9be5b1a7a19c5d092ed14a86d29ad83122e9a8 Mon Sep 17 00:00:00 2001
From: Puneeth Chaganti <punchagan@gmail.com>
Date: Sun, 9 Jan 2011 00:48:51 +0530
Subject: [PATCH] Include only specified range of line numbers of a file

* doc/org.texi (Include files): Document :lines.
* lisp/org-exp.el (org-export-handle-include-files): Support :lines
property.
(org-get-file-contents): New argument lines to include specify a range
of lines to include.

On Fri, Jan 7, 2011 at 1:29 PM, Puneeth <punchagan@gmail.com> wrote:
> On Fri, Jan 7, 2011 at 10:03 AM, Venkatesh Choppella
> <venkatesh.choppella@iiit.ac.in> wrote:
>> I would like to include a part of a file (between a given range of
>> line numbers) instead of the whole file.  Is there a way to do that
>> in org-mode?
>
> It isn't possible to include files using line numbers, as of now.
> Here's a quick patch that would add this feature.  I have tested it
> with small files and works fine. Can somebody tell me if it looks
> good?
>
> :lines "5-10"  will include the lines from 5 to 10, 10 excluded.
> :lines "-10"  will include the lines from 1 to 10, 10 excluded.
> :lines "5-"  will include the lines from 1 to the end of the file.
>
> HTH,
> Puneeth
2011-01-18 01:02:04 +01:00
Vincent Belaïche ce131e286c Doors links
> Date: Fri, 14 Jan 2011 23:18:21 +0100
> From: mail@christianmoe.com
> To: emacs-orgmode@gnu.org
> Subject: Re: [Orgmode] Doors links
>
> Hi,
>
> Try these:
>
> [[info:org:Link abbreviations]]
>
> [[info:org:Adding%20hyperlink%20types][info:org:Adding hyperlink types]]
>
> Yours,
> Christian
>
[...]

Thanks, I will try that ! I think that the trick deserves a forward link
in the documentation. I made a patch to the doc, attached.

   Vincent.
2011-01-17 19:23:03 +01:00
Eric Schulte 821082b5b0 doc: documentation of the ":comments noweb" code block header argument
* doc/org.texi (comments): Documentation of the ":comments noweb" code
  block header argument.
2011-01-16 08:24:19 -07:00
Bastien Guerry 8be17c8c62 org.texi: more small typos. 2011-01-15 19:36:34 +01:00
Bastien Guerry 3e476a3ba2 org.texi: fix small typo. 2011-01-15 19:35:53 +01:00
Carsten Dominik c747c7f7fb Merge branch 'global-skipping-condition' 2011-01-15 12:43:20 +01:00
Eric Schulte 6b5953818b doc: fixes to "yasnippet" sub-section in Conflicts
* doc/org.texi (Conflicts): Changed "yasnippets" to "yasnippet" and
  added extra whitespace around functions to be consistent with the
  rest of the section.
2011-01-14 06:30:36 -07:00
Carsten Dominik a2ec41c79a Implement a global skipping condition
* lisp/org-agenda.el (org-agenda-skip-function-global): New option.
(org-agenda-skip-eval): New function.
(org-agenda-skip): Use `org-agenda-skip-eval' and also check for the
global skipping condition.

This was a request by John Wiegley
2011-01-14 11:28:41 +01:00
Eric Schulte ca0e61d784 doc: improved documentation of optional #+call: line header arguments
* doc/org.texi (Evaluating code blocks):  Expanded discussion of
  #+call: line syntax.
  (Header arguments in function calls):  Expanded discussion of #+call:
  line syntax.
2011-01-11 17:51:45 -07:00
Eric Schulte b092d31d68 doc: passing variables to #+call: lines
* doc/org.texi (Evaluating code blocks): More explicit about how to
  pass variables to #+call lines.
2011-01-11 17:32:51 -07:00
Eric Schulte 9318030ba3 doc: link to 14.8.2 from 14.9 -- Thanks to Leo Alekseyev for suggesting
* doc/org.texi (Results of evaluation): Link to the :results header
  argument list from the "Results of evaluation" section.
2011-01-11 10:34:19 -07:00
Eric Schulte 59773dbef8 doc: additional information about resolving org-mode/yasnippet conflicts
Thanks to Jeff Horn for compiling this patch.

* doc/org.texi (Conflicts): Adding additional information about
  resolving org/yasnippet conflicts
2011-01-11 10:18:48 -07:00
Carsten Dominik bd11460542 Make file and path accessible in capture templates
* lisp/org-capture.el (org-capture-templates): Add %f and %F escapes
(org-capture): Add more information to capture property list
(org-capture-fill-template): Handle %f and %F escapes
2011-01-07 15:28:57 +01:00
David Maus 252d244466 Document style-include-scripts publishing project property
* doc/org.texi (Publishing options): Document style-include-scripts
publishing project property.
2011-01-06 20:52:54 +01:00
Carsten Dominik dd23461349 Implement next-error and previous-error functionality for sparse trees
* lisp/org.el (org-occur-next-match): New function.
(org-mode): Set the variable `next-error-function'.
(org-highlight-new-match): Add an `org-type' property to the overlays.
* doc/org.texi (Sparse trees): Document the next-error / previous-error
functionality.

After a sparse tree construction, `M-g n' and `M-g p' will now jump to
the location of matches.
2011-01-06 12:36:22 +01:00
Tom Dye c3cd82d577 Improved documentation of code block caches
* doc/org.texi (cache): Improved documentation of code block caches.
2011-01-05 09:17:44 -07:00
Tom Dye c867ce2c02 Documentation of multi-line header arguments.
* doc/org.texi (Code block specific header arguments): Documentation
  of multi-line header arguments.
2011-01-05 09:09:29 -07:00
Bastien Guerry de39bf05be org.texi: use message-mode instead of mail-mode in examples.
Message-mode is the default mode for composing emails in Emacs
since 2009-07-14.  See Stefan's message in Emacs lisp/ChangeLog:

2009-07-14  Stefan Monnier  <monnier@iro.umontreal.ca>

* simple.el (mail-user-agent): Default to the upwardly-UI-compatible
  and more featureful message-mode.
2011-01-04 17:48:35 +01:00
Bastien Guerry c66d94fe18 org.texi: mention the ability to add several tags thru C-c C-q TAB.
C-c C-q TAB now accepts several tags when separated by a comma.
2011-01-04 15:17:50 +01:00
Bastien Guerry aa157b5cb8 org.texi: Remove wrong quotes in lisp example.
This was spotted by Steve Hafner.
2011-01-03 19:44:07 +01:00
Bastien Guerry dfe713d08a org.texi: update links to http://orgmode.org (php->html). 2011-01-03 19:33:28 +01:00
Dan Davison a33a4003a1 Manual: edits to Working With Source Code chapter
- Clarify that switches and header arguments are optional
- Document `org-src-fontify-natively'
2010-12-24 11:40:08 +00:00
Eric Schulte ece347e32c org-babel-confirm-evaluate: better doc and code when using function as
Thanks to Vladimir Alexiev for submitting this patch

* lisp/ob.el (org-babel-confirm-evaluate): Fix for the case when
  org-confirm-babel-evaluate is a function (used to always ask no matter
  what the function returns).
* doc/org.texi (Code evaluation security): Add example for using a
  function.
2010-12-21 09:37:19 -07:00
Eric Schulte 00dd6c3cb2 documentation of the :sep header argument for code blocks 2010-12-21 14:19:25 +00:00
Eric Schulte 44392f1a41 documentation of the :file header argument for code blocks 2010-12-21 14:19:25 +00:00
Carsten Dominik 2d47a109b2 Modify activation section in manual 2010-12-20 15:38:40 +01:00
Carsten Dominik af33cb709a Fix bug with capture to datetree
* lisp/org-capture.el (org-capture-set-target-location): Use `current-time'.
2010-12-20 15:14:00 +01:00
Eric Schulte 5f1850af40 documentation of new attr_latex options for tables
* doc/org.texi (Tables in LaTeX export): Documentation of new
  attr_latex options for tables.
2010-12-17 14:00:51 -07:00
Carsten Dominik 3324942408 Link to book edition of manual, and update news 2010-12-17 16:08:38 +01:00
John Wiegley 14350cac34 Added FILE meta-property 2010-12-14 02:02:40 -05:00
Carsten Dominik 7666ba421f Version number back to 7.4 2010-12-10 18:49:40 +01:00
Carsten Dominik 76a25715c9 Bump version number to 7.5 2010-12-10 18:43:10 +01:00
Carsten Dominik 9df61b6c3e Fix typos 2010-12-10 11:12:56 +01:00
Carsten Dominik 77e51ec5b8 Improve wording
Patch by Brian Gough
2010-12-10 11:07:27 +01:00
Carsten Dominik 972b0a581e Use @LaTeX macro 2010-12-09 22:44:14 +01:00
Carsten Dominik 9e87fc670a Fix plain text that looks better with markup 2010-12-09 22:31:11 +01:00
Carsten Dominik 1cf808c744 Fix commas that should be full stops, semicolons or emdashes 2010-12-09 22:27:19 +01:00
Carsten Dominik d9db1c114d Use kbd font 2010-12-09 22:11:16 +01:00
Carsten Dominik 35817ab9ba Fix missing word in math formatting section 2010-12-09 22:09:08 +01:00
Carsten Dominik 6e49bb7c67 Use emdashes 2010-12-09 22:07:06 +01:00
Carsten Dominik b1f01f926c Proofreading credits for Brian Gough and Niels Giesen 2010-12-06 15:12:58 +01:00
Carsten Dominik 6388a8cd57 Cleanup the refcard 2010-12-06 10:54:30 +01:00
Carsten Dominik 71d9592fbc Some more minor fixes for the refcard 2010-12-06 10:51:04 +01:00
Carsten Dominik 6535babc34 Minor fixes to refcard 2010-12-06 09:54:30 +01:00
Carsten Dominik 970b2f7b88 Allow to jump to capture template after finalizing
* lisp/org-capture.el (org-capture-finalize): New prefix argument
STAY-WITH-CAPTURE.
(org-capture-refile): Improve docstring.
* doc/org.texi (Using capture): Document using prefix arguments for
finalizing capture.
2010-12-06 09:32:24 +01:00
Carsten Dominik cf766fb781 Document the prefix commands for capture
* doc/org.texi (Using capture): Document the prefix commands for capture.
2010-12-06 09:16:37 +01:00
Carsten Dominik 0d77381472 Document prefix argument for the bulk scatter command
* doc/org.texi (Agenda commands): Document prefix argument for the bulk
scatter command.
2010-12-06 09:09:10 +01:00
John Wiegley df4b79e051 Fixed a typo in the doc/org.texi manual 2010-12-06 00:25:13 -05:00
Carsten Dominik 13637b018f Brian's UTF-8 changes 2010-12-05 12:34:08 +01:00
Carsten Dominik dea921c8a7 Merge branch 't/patch425' into brian 2010-12-04 19:12:46 +01:00
Carsten Dominik 1cb57f37fd Merge branch 't/patch423' into brian 2010-12-04 19:12:35 +01:00
Carsten Dominik 3c98036f2a Merge branch 't/patch422' into brian 2010-12-04 19:12:34 +01:00
Carsten Dominik 8b0c323608 Merge branch 't/patch421' into brian 2010-12-04 19:12:30 +01:00
Brian Gough 2f9e1e48b8 correct grammar 2010-12-04 19:11:41 +01:00
Brian Gough 5e38e053f5 make Nth consistent 2010-12-04 19:10:12 +01:00
Brian Gough 57dd2fd7a9 mismatched quotes 2010-12-04 19:09:50 +01:00
Brian Gough 09ec91b1db more typos 2010-12-04 19:09:20 +01:00
Brian Gough 3420bb04d5 correct doc typos
Hi

Here is a patch for some proofreading corrections for the Org manual.
This is just an sample to check if it is in suitable format.  We have
a lot more corrections to come.

Because there are more than 20 lines affected I'm assuming we will
need to do copyright assignments.  If not I can send all the patches
now.  Alternatively would you prefer us to wait until the assignment
is done?

I haven't included a changelog entry since these are just for typos
etc and don't make any major changes to the meaning of the text.

Credit to my colleague Barry Gidden for the proofreading, he did the
real work on this.
2010-12-04 19:08:47 +01:00
Carsten Dominik 6578203623 Document John's modifications to bulk commands 2010-12-04 00:37:48 +01:00
Julien Danjou 0d0edd6d21 org-agenda: rework ndays and span handling
* org-agenda.el (org-agenda-custom-commands-local-options):
Allow org-agenda-span to be a symbol.
(org-agenda-ndays): Make obsolete.
(org-agenda-span): New variable superseding org-agenda-ndays.
(org-agenda-menu): Use org-agenda-current-span.
(org-agenda-current-span): New local variable storing current
span.
(org-agenda-list): Take a span instead of ndays as argument.
This function is now responsible for computing the ndays based
on span.
(org-agenda-ndays-to-span): Return span only if number of days
really matches.
(org-agenda-span-to-ndays): New function.
(org-agenda-manipulate-query): Use org-agenda-compute-starting-span.
(org-agenda-goto-today): Use org-agenda-compute-starting-span.
(org-agenda-later): Do not give compute a new span, use the
current one.
(org-agenda-day-view, org-agenda-week-view)
(org-agenda-month-view, org-agenda-year-view): Stop touching
org-agenda-ndays.
(org-agenda-change-time-span): Only compute starting-span.
(org-agenda-compute-starting-span): New function derived from
the old org-agenda-compute-time-span.
(org-agenda-set-mode-name): Compute mode based on
org-agenda-current-span.
(org-agenda-span-name): New function.

* org-mouse.el: Replace Replace org-agenda-ndays by
org-agenda-current-span.

* org.texi, orgguide.texi: Replace org-agenda-ndays by
org-agenda-span. Add a paragraph about org-agenda-span and say that
org-agenda-ndays is now deprecated.

This patch is pretty huge, so I'll give a bit of context about it.

I'm weird, but I used org-agenda-ndays set to 14. Unfortunately, this
settings was interpreted as a month view. Pressing 'f' key to see later,
would show me the next month, which was not at all what I wanted.

On the same idea, day view or week view would change my org-agenda-ndays
settings, which I think is not a good idea. Changing user setting is *bad*.
:-)

So I rewrote the things this way:
- Rename org-agenda-span to org-agenda-current-span
 Which has the same meaning has before, except it can be numeric.
- Rename org-agenda-ndays to org-agenda-span
 I think the name is better choosen. You can set it to a symbol instead of
 only a numeric value. That means you can set it to 'month and it will show
 you the number of days of the current month in your agenda. Better than
 30. But you can still set it to 30, or 31, or whatever you want.
- Do not change org-agenda-span. Never.
- Use org-agenda-current-span for navigation.
 That means if you press 'f', it will shows you really the next
 org-agenda-current-span ndays, and not something based on "I think you
 want a weekly view".
2010-12-03 13:07:31 +01:00
Carsten Dominik 12b153ed8b Implement clocktables for quarters
* lisp/org-clock.el (org-day-of-week): New function.
(org-quarter-to-date): New function.
(org-clock-special-range): Implement quarters.

Patch by Erwin Vrolijk
2010-11-29 11:27:47 +01:00
Julien Danjou 9de7ad3593 Add org-agenda-todo-ignore-timestamp
* lisp/org-agenda.el: Add org-agenda-todo-ignore-timestamp.
(org-agenda-check-for-timestamp-as-reason-to-ignore-todo-item):
Honor org-agenda-todo-ignore-timestamp.
* doc/org.texi: Mention org-agenda-todo-ignore-timestamp.

Signed-off-by: Julien Danjou <julien@danjou.info>
2010-11-29 10:25:22 +01:00
Carsten Dominik 6e98e5dd0f Add some more acknowledgements 2010-11-26 19:08:30 +01:00
Carsten Dominik 2613f27f8e More acknowledgements 2010-11-26 08:14:21 +01:00
Carsten Dominik 80a6674178 BEAMER export: Allow overlay options for column environments
* lisp/org-beamer.el (org-beamer-sectioning): Allow overlay arguments for
the column as well.
* doc/org.texi (Beamer class export): Document that also overlay arguments
can be passed to the column environment.

Eric Fraga writes:

> I am trying to create a beamer slide which has two columns.  The second
> column should only appear after a while (the 6th uncovering operation).
> In latex, I would do:
>
> : \begin{column}<6->{0.4\textwidth}
>
> say.  In org, I would expect to be able to get this latex code generated
> by the following:
>
> --8<---------------cut here---------------start------------->8---
> ***** column heading			      :BMCOL:B_block:
>      :PROPERTIES:
>      :BEAMER_col: 0.4
>      :BEAMER_envargs: c<6->
>      :BEAMER_extra:
>      :BEAMER_env: block
>      :END:
> --8<---------------cut here---------------end--------------->8---
>
> according to the info documentation (Beamer class export).
>
> However, this does not work: the "c<6->" is placed verbatim in
> the \begin{block} that comes after the \begin{column}.  Furthermore, if
> I ask for the heading to be ignored (instead of defining a block), the
> envargs are lost completely!
2010-11-26 08:02:58 +01:00
Carsten Dominik 341e9ce1d7 Date tree capture with prompt for date
* doc/org.texi (Template elements): Document the new entry type.

* lisp/org-capture.el (org-capture-templates): Add new option to customize
type and docstring.
(org-capture-set-target-location): Interpret the file+datetree+prompt
entry.
2010-11-25 17:00:57 +01:00
Carsten Dominik cc01ef59f2 Minor fixes for the manual 2010-11-24 12:16:43 +01:00
Puneeth Chaganti 29e2b27b5a Document the :recursive option for org-publish
Hi,

Here's a patch to document the recursive option for org-publish. It's
a documentation TODO on Worg.
2010-11-22 21:38:56 +01:00
Eric Schulte 88947588bc lists are now a data type recognized by code blocks
* lisp/ob-ref.el (org-babel-ref-resolve): Recognize `list' as a unique
  type of data
  (org-babel-ref-at-ref-p): Recognize `list' as a unique type of data

* lisp/ob.el (org-babel-read-result): Recognize `list' as a unique
  type of data
  (org-babel-read-list): A function to read a textual Org-mode list
  into an emacs-lisp list.
  (org-babel-insert-result): Recognizes the "list" result param to
  insert data as an Org-mode list.
  (org-babel-result-end): Find the end of an Org-mode list.
  (org-babel-merge-params): Add "list" as a result param.

* doc/org.texi (results): Documentation of the new "list" results
  header argument.
2010-11-17 16:47:55 -07:00
Carsten Dominik cae52eb288 Merge branch 'master' of git+ssh://repo.or.cz/srv/git/org-mode 2010-11-17 08:58:52 +01:00
Carsten Dominik e2567e9e93 Add link to MathJax site 2010-11-17 08:58:49 +01:00
Carsten Dominik 9b8118c48c Fix typo 2010-11-16 17:28:13 +01:00
Carsten Dominik 5dd4d30be5 Merge branch 'master' of git+ssh://repo.or.cz/srv/git/org-mode 2010-11-16 08:55:39 +01:00
Carsten Dominik a05f317553 Minor documentation updates 2010-11-16 08:55:32 +01:00