Commit graph

844 commits

Author SHA1 Message Date
Eric Schulte 3429a496a3 merged with master 2010-06-22 11:55:19 -07:00
Carsten Dominik 36b6471858 Merge branch 'improve-todo-match-documentation' 2010-06-22 14:47:45 +02:00
Carsten Dominik 2e73ce2177 Clarify that TODO matches only match not-DONE states by default
Bernt Hansen writes:

> I was talking to Jeff Stern about tags todo matching offlist and we
> think the documentation for tags-todo matching can probably be improved.
>
> The description of C-c a M at
> http://orgmode.org/manual/Matching-tags-and-properties.html
> states
>
> C-c a M
>
>    Like C-c a m, but only select headlines that are also TODO items and
>    force checking subitems (see variable
>    org-tags-match-list-sublevels). To exclude scheduled/deadline items,
>    see the variable org-agenda-tags-todo-honor-ignore-options. Matching
>    specific TODO keywords together with a tags match is also possible,
>    see Tag searches.
>
> When I read this I think TODO items is any todo keyword but this isn't
> the case.  It is only non-done TODO state keywords.  This makes
> tags-todo matching not work for finding tasks to archive (normally
> DONE | CANCELLED keywords in my setup)
>
> Should we explicitly state that 'headlines that are also TODO items'
> does not match DONE state keywords?  Or alternatively should TODO items
> and DONE items be separate (and explicitly defined) in the documentation
> -- like org-todo-keywords and org-done-keywords?
>
> I still think 'TODO keyword' matches any todo keyword defined in
> org-todo-keywords and maybe I need to be re-educated :)

Bernt is right, and this patch tries to clarify the issue.
2010-06-22 14:47:37 +02:00
Carsten Dominik 1d52e54efd New capture system org-capture
* lisp/org-agenda.el (org-agenda-action): Make `c' key call org-capture.
* lisp/org-capture.el: New file.
* lisp/org-compat.el (org-get-x-clipboard): Function moved here from
remember.el.
* lisp/org-mks.el: New file
* lisp/org.el (org-set-regexps-and-options): Allow statistic cookies as
part of complex headlines.
(org-find-olp): New argument THIS-BUFFER.  When set, assume that the
OLP does not contain a file name.
2010-06-22 14:19:18 +02:00
Eric Schulte cab1e23d61 babel-doc: adding c++ and sqlite as supported languages, and removing table comment 2010-06-17 18:15:35 -07:00
Eric Schulte 9c7bad1fab babel-doc: adding buffer-wide header argument documentation 2010-06-17 18:15:35 -07:00
Eric Schulte 7b19b0e547 delete trailing whitespace 2010-06-17 18:15:35 -07:00
Tom Dye b5efd50fb5 Last chance clean-up of org.texi 2010-06-17 18:15:35 -07:00
Eric Schulte 0f633df264 babel-doc: now compiling again 2010-06-17 18:15:34 -07:00
Tom Dye 3afe60dcde babel-doc: Changed description of function that asks before switching buffers 2010-06-17 18:15:34 -07:00
Tom Dye cbd9bba834 First pass through babel documentation (on airplane) 2010-06-17 18:15:34 -07:00
Eric Schulte 7dba834dbe minor bug fix 2010-06-17 18:15:34 -07:00
Tom Dye b548c3e794 Minor editorial changes to babel documentation (Seattle Airport) 2010-06-17 18:15:33 -07:00
Tom Dye 5fa1dcccad babel-doc: edits 2010-06-17 18:15:31 -07:00
Eric Schulte 97928ae08e babel-doc: tiny doc tweak 2010-06-17 18:15:31 -07:00
Eric Schulte 3bb8bdb7e5 babel-doc: changed header-argument order 2010-06-17 18:15:31 -07:00
Eric Schulte bb834903dd babel-doc: adding no-expand header argument 2010-06-17 18:15:31 -07:00
Eric Schulte bb6f835d12 babel-doc: tweak 2010-06-17 18:15:31 -07:00
Eric Schulte 16fa9b6c99 babel-doc: adding information on hlines colnames and rownames header args 2010-06-17 18:15:31 -07:00
Eric Schulte b89ce3712e babel-doc: host of minor aesthetic changes to babel documentation
also stripped out superfluous function documentation.
2010-06-17 18:15:31 -07:00
Eric Schulte 8d2e2caa37 babel-doc: a completed first pass through and it's looking pretty good 2010-06-17 18:15:31 -07:00
Eric Schulte 653694fff7 babel-doc: exhausting formulation of babel documentation into texinfo 2010-06-17 18:15:31 -07:00
Eric Schulte 33cc42ef53 babel-doc: stripped some @code{} wrappers and everything is now compiling 2010-06-17 18:15:30 -07:00
Eric Schulte 2760c8e798 babel-doc: working on Header Arguments -- not quite compiling 2010-06-17 18:15:30 -07:00
Eric Schulte d7b2397184 pushing through first half or so of babel documentation, compiling 2010-06-17 18:15:30 -07:00
Tom Dye 9e8b6c0831 Changed old C-c M-b prefixes to C-c C-v 2010-06-17 18:15:30 -07:00
Dan Davison 3ac08f1b4e Edits, mainly to header args section 2010-06-17 18:15:30 -07:00
Dan Davison f5e8f5e878 Work on initial sections. 2010-06-17 18:15:30 -07:00
Dan Davison 77fd62ec3b Add entry to main menu 2010-06-17 18:15:30 -07:00
Dan Davison 27dcffe592 Minor edits 2010-06-17 18:15:30 -07:00
Dan Davison f2b1a0fd7c Use angle bracket tags to refer to structural elements of code block 2010-06-17 18:15:30 -07:00
Dan Davison 1e5cd51736 Delete separate file for new chapter 2010-06-17 18:15:30 -07:00
Dan Davison e25035855f Move new chapter into main org.texi file
It is currently impractical to work with it as an @included file,
because the automatic node pointer updates do not work by default.
2010-06-17 18:15:30 -07:00
Dan Davison 10010aa326 Create texinfo node structures for new chapter 2010-06-17 18:15:30 -07:00
Dan Davison 98957ed300 Edits to initial sections 2010-06-17 18:15:29 -07:00
Dan Davison 36767ff4b6 Working on syntax section 2010-06-17 18:15:29 -07:00
Dan Davison a8616afcac Add material to introduction of source code chapter 2010-06-17 18:15:29 -07:00
Dan Davison 787e2746a5 Convert level 4 headings to subsubheadings.
Also some promotion of some of the most deeply nested headings.
2010-06-17 18:15:29 -07:00
Dan Davison 59193e2e2c Add an example block that was missed 2010-06-17 18:15:29 -07:00
Dan Davison 50716ee1e7 Convert level 3 headings to @subsubsections 2010-06-17 18:15:29 -07:00
Dan Davison a465cff872 Wrap verbatim examples in @example ... @end example
Note that there are some cases where the #+begin_src itself is part of
the example, and others where only the body of the source block is the
example.
2010-06-17 18:15:29 -07:00
Dan Davison 12e9b0a567 Quote some @ symbols and clean up.
make info and make pdf work now.
2010-06-17 18:15:29 -07:00
Dan Davison df2252b87f Initialise new source code chapter with reference.org from Worg
source-code-chapter.texi is just reference.org with level 1 headings
replaced with @section, and level 2 headings replaced with
@subsection, and with a top level @chapter node. This file is included
in org.texi with an @include line for now.
2010-06-17 18:15:29 -07:00
Bastien Guerry 76d212e8fd Fix an error in documentation of date/time prompt section.
Thanks to Puneeth Chaganti <punchagan@gmail.com> for this patch.
2010-06-16 21:34:04 +02:00
Bastien Guerry 476d24320c org.texi: Fix tiny typo. 2010-06-16 16:04:11 +02:00
Eric Schulte d3b7952159 Fix typo in documentation
thanks to Puneeth Chaganti for the patch
2010-06-12 10:46:12 -07:00
Christian Egli 964f8dab5b Add documentation for TaskJuggler export 2010-06-08 09:20:34 +02:00
Carsten Dominik fd1d2992f6 Make it possible to protect hidden subtrees to be killed by `C-k'
* lisp/org.el (org-ctrl-k-protect-subtree): New option.
(org-kill-line): Protect hidden subtrees if the user wants it.
* doc/org.texi (Headlines): Mention the special behavior of C-k
in headlines.

Scott Otterson writes:

> For what must be the dozenth time, I've just accidentally deleted a
> large tree by typing C-k while in a headline.
>
> This is really easy to do because emacs users have "C-k deletes to the
> end of the line" worn deeply into their neural pathways -- it's so
> automatic for me that the keystroke is close to subconscious.  A
> mistaken C-k is especially hard to detect because org-mode displays
> the result exactly like what your subconscious expects, that is, a
> collapsed headline is deleted to the end -- and the tree underneath is
> wiped out with no noticeable warning.
>
> Feature request: add an option preventing tree deletion with C-k
> without user confirmation.  Actually, I'd like an option to prevent it
> period.
>
> If this option is already in there, then you're encouraged to tell me
> to RTFM.  But then also please tell me where it is, because I can't
> find it.

Carsten replies

> This is now possible due to the variable
> `org-ctrl-k-protect-subtree'.  But I predict that you are going to set
> it to nil again soon :D
2010-06-03 00:18:44 +02:00
Carsten Dominik 70d24c5d03 Implement pretty display of sub- and superscripts.
* doc/org.texi (Subscripts and superscripts): Document that `C-c C-x \'
will also format sub and superscripts.
* doc/orgcard.tex: Document that `C-c C-x \'
will also format sub and superscripts.
* lisp/org.el (org-use-sub-superscripts):
(org-pretty-entities-include-sub-superscripts): Move here from
org-exp.el.
(org-set-regexps-and-options): Parse subscript option and set
`org-use-sub-superscripts' as a local variable.
(org-match-sexp-depth):
(org-create-multibrace-regexp):
(org-match-substring-regexp):
(org-match-substring-with-braces-regexp): Moved here from org-exp.el
(org-set-font-lock-defaults): Call `org-raise-scripts'.
(org-remove-font-lock-display-properties): New function.
(org-unfontify-region): Call
`org-remove-font-lock-display-properties'.
(org-script-display): New constant.
(org-raise-scripts): New function.

When turning on entity display with `C-c C-x \', sub- and superscripts
will also be displayed in a smaller font, and raised/lowered.
2010-06-03 00:06:19 +02:00
Carsten Dominik 5f168ad614 Minor documentation fix 2010-06-01 06:01:10 +02:00