Re: [O] would take more than an org-mode strip-down.

2011-09-28 Thread Jude DaShiell
They tried that MacDonalds approach on web pages all over the Government 
and beyond and guess what, they found not even sighted people could 
figure what to click or why.  The Federal Government wasn't even looking 
at this problem to help sighted people either, it's now addressing this 
problem because of Section 508 requirements of the Americans With 
Disabilities Act.  But as my supervisor says, whenever web pages get 
more accessible around here, it makes it easier for everybody.  What I 
write was reported on TV I think on C.N.N. technology column and a 
researcher from M.I.T. also described it.  I have no memory of vision at 
all and for what I tried to do with org-mode I found very accessible and 
I wouldn't have it any other way.  Windows was made by people with 
A.D.H.D. for people with A.D.H.D., and apparently org-mode was not.  
What I would support is not a stripping down of org-mode or its 
documentation but rather an A.D.H.D. link that will take A.D.H.D. people 
onto a separate stripped down path which they get to create by 
themselves in their own fashion.  Text works every time and skimming 
works sometimes.  I'm sorry if this message hit a nerve but work I will 
be doing for the next several years helping to locate all of the messes 
A.D.H.D. has made for the Federal community so they can be straightened 
out and put under revision control for the future will be using all of 
my work time and I don't want to find out org-mod got trashed by the 
A.D.H.D. philosophy in the meantime.

eOn Tue, 27 Sep 2011, James Levine wrote:

 Greetings,
 
 As an expert end-user but outside the computer science field, I?ve felt there 
 to be a high cost of entry for working in org-mode. I like the idea very 
 much, as I am trying to strip down to an Autofocus system  and take a more 
 intuitive, frictionless approach. Because I?m not following the play-by-play 
 on the gnu boards, I thought I?d zoom out and tell you what a consumer 
 experience is like:
 
 1) It?s not that there isn?t enough documentation, it?s that there?s too much 
 of it.
   Imagine that setting up a wordpress database is probably too much for 
 the average person. You go to wordpress.org (and at this point you?d already 
 need to read the fine print or you?d probably point to wordpress.com) and the 
 button simply tells you to download ?here?. Now what?
 
   In other words, if you want to expand popularity among end-users, not 
 coders, there needs to be a middle ground: the visual step-by-step needs to 
 be uncluttered by additional description.  Org-mode is further obscured by 
 the fact that other services, a text editor and such need to be pointed to as 
 well in the ?getting started process. I need to know why I?m being forwarded 
 to an external web page or why I need to read on between each download link, 
 or how to keep track of each link if each one is taking me to a separate 
 page. You wouldn?t want someone telling you the history of every landmark 
 that you passed if they were giving you driving instructions, would you? The 
 verbose approach doesn?t actually help retention, it floods it. The gnu 
 support community, like this email, is very heavily text-based.
 
 2) Some things are just better with a gui.
   I?m referring specifically to the more popularized use of tags or 
 ?keywords.? Most all the file management clients fail at this somewhere. You 
 are requiring people to be literate, as in secondary school spelling-NOT 
 culture, not just in a single instance of clarity, but in a manner that can 
 be consistently repeated, while you?re catering to an audience that probably 
 has a higher than average proportion of dyslexics, autistics, and college 
 drop-outs in its midst. 
 
 Furthermore, tagging conventions are easy to break, and most End-Users won?t 
 know to instill them to begin with. ?Have I been using the plural of my 
 common and collective nouns? What about that time I hashtagged a task to 
 myself in my email and I put the tag in the Subject heading? Did I spell it 
 the same way my tags were set up back on my desktop?? It?s too easy to orphan 
 tags, spell them wrong, flip a p with a q. Without a pull up, 
 cash-register-like cheat sheet that lets you touch the tags that you already 
 made, one will leave a trail of junk mark-up. Not to mention, free tagging 
 does not endorse a constrained vocabulary as it would, say, if you were 
 trying to figure out what kind of lettuce someone was buying and you worked 
 the register. I?m also inclined to believe that crossing something out with 
 my finger, or putting a check in a checkbox is more intuitive and less prone 
 to error than managing [x]?s in a document.
 
 3) the 2nd problem ties in with this. Without a constrained tagging 
 vocabulary and other conventions, an org-mode task system is not that easy to 
 subscribe to when trying to encourage a team to get on board. The list is not 
 inherently intuitive to all end-users. What is logic to one 

Re: [O] would take more than an org-mode strip-down.

2011-09-28 Thread Eric S Fraga
James Levine levineja...@me.com writes:

 Greetings,

Hello James,

I am not going to try to answer all of your points comprehensively but I
will chime in with some of my own views, as a very satisfied end user
albeit also a computer scientist (of sorts ;-).

 As an expert end-user but outside the computer science field, I’ve
 felt there to be a high cost of entry for working in org-mode. I like
 the idea very much, as I am trying to strip down to an Autofocus
 system and take a more intuitive, frictionless approach. Because I’m
 not following the play-by-play on the gnu boards, I thought I’d zoom
 out and tell you what a consumer experience is like:

 1) It’s not that there isn’t enough documentation, it’s that there’s too much 
 of it.
   Imagine that setting up a wordpress database is probably too
 much for the average person. You go to wordpress.org (and at this
 point you’d already need to read the fine print or you’d probably
 point to wordpress.com) and the button simply tells you to download
 “here”. Now what?

This has been discussed on this list at least once before.  There are
links to all kinds of introductory material on the web site for org.  I
would suggest you have a look at these and let us know what you think.

Although there is indeed a lot of documentation, I would rather have it
this way than the opposite.  Most systems seem to love having just
skimpy documentation, relying on the fact that x% of the users will not
need more.  I want more.

In any case, you don't need to read all the documentation to start using
org.  cf. tutorials mentioned above.  The documentation is there for
when you want to start doing *more*.

   In other words, if you want to expand popularity among
 end-users, not coders, there needs to be a middle ground: the visual
 step-by-step needs to be uncluttered by additional
 description.  Org-mode is further obscured by the fact that other
 services, a text editor and such need to be pointed to as well in the

yes, well, but org is in Emacs and that's what many of us like.  Not all
which is why there are tools in development for emulating org in vi, for
instance.  But unlike the other tools you mention, org is not a
standalone system.

 retention, it floods it. The gnu support community, like this email,
 is very heavily text-based.

yes, and that's its greatest feature, in the minds of many.  I don't
want graphical interfaces etc for a number of reasons.  This is
obviously a personal view!

 2) Some things are just better with a gui.

Very few, IMO.  :)
More seriously, for those of us that suffer (or have suffered) from RSI,
GUIs are an abomination.

   I’m referring specifically to the more popularized use of tags
 or “keywords.” Most all the file management clients fail at this
 somewhere. You are requiring people to be literate, as in secondary
 school spelling-NOT culture, not just in a single instance of clarity,
 but in a manner that can be consistently repeated, while you’re
 catering to an audience that probably has a higher than average
 proportion of dyslexics, autistics, and college drop-outs in its
 midst.

 Furthermore, tagging conventions are easy to break, and most End-Users
 won’t know to instill them to begin with. “Have I been using the
 plural of my common and collective nouns? What about that time I
 hashtagged a task to myself in my email and I put the tag in the
 Subject heading? Did I spell it the same way my tags were set up back
 on my desktop?” It’s too easy to orphan tags, spell them wrong, flip a
 p with a q. Without a pull up, cash-register-like cheat sheet that
 lets you touch the tags that you already made, one will leave a trail
 of junk mark-up. Not to mention, free tagging does not endorse a
 constrained vocabulary as it would, say, if you were trying to figure
 out what kind of lettuce someone was buying and you worked the
 register. I’m also inclined to believe that crossing something out
 with my finger, or putting a check in a checkbox is more intuitive and
 less prone to error than managing [x]”s in a document.

But org does support tag completion: hit TAB when you are prompted for a
tag and you'll see what I mean.  What is missing?

 3) the 2nd problem ties in with this. Without a constrained tagging
 vocabulary and other conventions, an org-mode task system is not that
 easy to subscribe to when trying to encourage a team to get on
 board. The list is not inherently intuitive to all end-users. What is
 logic to one person is not logic to the next. (This may come as a
 surprise to many coders).

As soon as you constrain one aspect of the system, you constrain the
system's use.  You can not identify all possible uses when doing the
design of the initial constrained system.  As soon as you introduce
flexibility, this is the price you pay!

 4) The master org-mode file will get lost in the shuffle. My litmus
 test for a good file management system is “if I’m sick or thankfully
 on a beach that day, can everyone else 

[O] org footnote bug?

2011-09-28 Thread henry atting
With org from cvs (Org-mode version 7.7
(release_7.7.326.g32cf8.dirty)) footnotes don't work properly when
inserted in non org files. The first footnote appears above the
footnote tag, all the others underneath:

text [1] ... more text [2]

[1] footnote 

___

[2] footnote

This does not happen with the stable version

henry

-- 
http://literaturlatenight.de




[O] Latex Export: Place Caption Below Table

2011-09-28 Thread Jakob Lombacher
Hi,

if I export a document to latex, the caption of a table is always on the top.

How can I place it at the bottom? Is there a parameter to config it?

Thanks

Jakob

Examaple

#+LABEL: tbl:asdf
#+CAPTION: ?
| | |

leads to:
---

\begin{table}[htb]
\caption{?} \label{tbl:datenstrukturen}
.
\end{table}

I need:
--

\begin{table}[htb]
.
\caption{?} \label{tbl:datenstrukturen}
\end{table}



Re: [O] org footnote bug?

2011-09-28 Thread Nicolas Goaziou
Hello,

henry atting nsmp...@online.de writes:

 With org from cvs (Org-mode version 7.7
 (release_7.7.326.g32cf8.dirty)) footnotes don't work properly when
 inserted in non org files. The first footnote appears above the
 footnote tag, all the others underneath:

 text [1] ... more text [2]

 [1] footnote 

 ___

 [2] footnote

I currently don't see that behaviour. Could you try to post
a step-by-step recipe to reproduce the problem? Also, what's your value
for `org-footnote-tag-for-non-org-mode-files'?

Regards,

-- 
Nicolas Goaziou



Re: [O] org footnote bug?

2011-09-28 Thread henry atting
Nicolas Goaziou n.goaz...@gmail.com writes:

 Hello,

Hi Nicolas,

 henry atting nsmp...@online.de writes:

 With org from cvs (Org-mode version 7.7
 (release_7.7.326.g32cf8.dirty)) footnotes don't work properly when
 inserted in non org files. The first footnote appears above the
 footnote tag, all the others underneath:

 text [1] ... more text [2]

 [1] footnote 

 ___

 [2] footnote

 I currently don't see that behaviour. Could you try to post
 a step-by-step recipe to reproduce the problem? Also, what's your value
 for `org-footnote-tag-for-non-org-mode-files'?

Tag for non orgmode files is:

(setq org-footnote-tag-for-non-org-mode-files ___)

Well, I open a file, type some text and then add a footnote with
org-footnote-action which is bound to C-cf:

-
Some Text, then adding a footnote [1] then adding a second footnote [2] and
after a while a third footnote [3]

[1] this footnote appears above the footnote tag

___

[2] this footnote appears beneath the footnote tag

[3] from now on all footnotes appear beneath the footnote tag
--

This is reproducible apparently with every file type except org files
or when writing mail within gnus

As a workaround I currently use org-footnote.el from the stable
release which works flawlessly.

Regards,
henry

-- 
http://literaturlatenight.de



Re: [O] would take more than an org-mode strip-down.

2011-09-28 Thread Jambunathan K
James

 1) It’s not that there isn’t enough documentation, it’s that there’s
 too much of it

I hope you appreciate the amount of effort that has gone in to writing
such a big manual. You may not have a need for it. This doesn't mean
that it is not worthwhile.

At the minimum, we should respect other's labour particularly when you
yourself [1] and many people are enjoying the fruits of it.

Since you have some thoughts on how the manual should look like would
you mind circulating a draft copy of the modified, improved manual?
That's an open offer and a challenge as well.

Remember Emacs/Orgmode is a Free Software and you have all the freedom
in the world to influence how it evolves and specifically make sure that
it evolves to suit your needs.

Being a Free Software, the distinction between the consumer (aka user)
and the contributor (aka developer) just blurs. Understanding this
distinction requires a paradigm shift in the way you think.

Footnotes:
[1] It is not clear from your message whether you yourself are an
Orgmode user.

Jambunathan K.



Re: [O] would take more than an org-mode strip-down.

2011-09-28 Thread Jambunathan K

James

 Greetings,

 As an expert end-user but outside the computer science field, I’ve
 felt there to be a high cost of entry for working in org-mode. 

This is another perfectly practical way to address the problem that you
are contending to with.

https://lists.gnu.org/archive/html/emacs-orgmode/2011-04/msg00173.html

Jambunathan K.




Re: [O] would take more than an org-mode strip-down.

2011-09-28 Thread James Levine
I’ll go on leap of faith that the email I’ve been provided actually contributes 
to the same thread I emailed to earlier. Please everyone: thank you for looking 
out. This is clearly a thoughtful and supportive community. You can not deny, 
however, that even the design of this forum is but one example of how the Emacs 
community maintains its exclusivity. Own up to it. If there’s no problem, then 
don’t fix it. But for those who are following the statements on comparing 
org-mode to commercial substitutes like Taskpaper and see this as an outcome of 
people making less-informed choices, I hope I can keep your attention. Once I 
know which way to point my eyes, I promise I will fall in line. Please take a 
step back folks, there’s an implied objective that I’m making which I’ll state 
more explicitly:

In order for org-mode to be attractive as an alternative to popular self-help 
like GTD, Covey and the market of task managers both digital and paper that 
exist, this community would need to take all this extensive documentation and 
package it. Do not confuse content with transparency. People don’t even read 
this much before electing their President. Should open-source software not 
concern itself with good bullet points? Does this imply that I’m not 
appreciative of the work?  There’s an opportunity cost with finding the time 
for even this thread, which I’m hoping we can agree should not be a barrier of 
entry for those who are simply interested in trying org-mode. As it stands, 
however, just trying org-mode takes lots of reading if just to install 
correctly. That’s all I’m saying. 

Text is but one way that people learn. If you’re documenting sofware, it leans 
towards rational, logical, and linear thinking. Some people require a 
full-picture model first seeing things from many angles. Other’s prefer trial 
and error, and others, still, enjoy hypotheticals. People can adopt different 
strategies along the way. But to insist on only one method of learning and 
sharing, while being concerned that you’re not meeting a larger audience is 
tantamount to calling the rest of the class stupid, or simply a manner of 
dishonesty with one’s own motivations.

Maybe what would be helpful is some bridge instruction: “Graduating from 
Taskpaper: so you’re ready to try org-mode. What to expect:” I do find that if 
I have an orientation point, even if it wasn’t the best decision in the first 
place, I have a better reference as to the changes I would envision and what 
the value of future options would be.

cheers

James
On Sep 28, 2011, at 10:18 AM, Jambunathan K wrote:

James

 Greetings,
 
 As an expert end-user but outside the computer science field, I’ve
 felt there to be a high cost of entry for working in org-mode. 

This is another perfectly practical way to address the problem that you
are contending to with.

https://lists.gnu.org/archive/html/emacs-orgmode/2011-04/msg00173.html

Jambunathan K.





Re: [O] would take more than an org-mode strip-down.

2011-09-28 Thread James Levine
Tis true. Just like Wordpress and other terrific open resources: just because 
you implement them doesn’t mean you’re the type to do the tinkering. People 
make a living off building websites (I daresay, you could make a career of 
fixing the screw-ups of people embarking in WP who think that means they’re 
supposed to do everything themselves), so what’s the ethical ambiguity in 
earning a living from setting up management systems for people and 
institutions, even if you’re using open-source material? Just wish I was savvy 
enough to be on par with the current implementers.
J

On Sep 28, 2011, at 10:18 AM, Jambunathan K wrote:


James

 Greetings,
 
 As an expert end-user but outside the computer science field, I’ve
 felt there to be a high cost of entry for working in org-mode. 

This is another perfectly practical way to address the problem that you
are contending to with.

https://lists.gnu.org/archive/html/emacs-orgmode/2011-04/msg00173.html

Jambunathan K.





Re: [O] would take more than an org-mode strip-down.

2011-09-28 Thread Jude DaShiell
There is no exclusivity connected to emacs or anything else on gnu.  More 
like extreme inclusivity.  If there was even a little exclusivity on gnu 
or within linux, I wouldn't be able to install it on a laptop by myself 
without any vision!  However no version of windows can be installed on a 
laptop or tower by anyone with no vision by themselves to this date and 
that exclusivity will remain with Windows 8 and probably beyond Windows 8 
as well. On Wed, 28 Sep 2011, James Levine wrote:

 I?ll go on leap of faith that the email I?ve been provided actually 
 contributes to the same thread I emailed to earlier. Please everyone: thank 
 you for looking out. This is clearly a thoughtful and supportive community. 
 You can not deny, however, that even the design of this forum is but one 
 example of how the Emacs community maintains its exclusivity. Own up to it. 
 If there?s no problem, then don?t fix it. But for those who are following the 
 statements on comparing org-mode to commercial substitutes like Taskpaper and 
 see this as an outcome of people making less-informed choices, I hope I can 
 keep your attention. Once I know which way to point my eyes, I promise I will 
 fall in line. Please take a step back folks, there?s an implied objective 
 that I?m making which I?ll state more explicitly:
 
 In order for org-mode to be attractive as an alternative to popular self-help 
 like GTD, Covey and the market of task managers both digital and paper that 
 exist, this community would need to take all this extensive documentation and 
 package it. Do not confuse content with transparency. People don?t even read 
 this much before electing their President. Should open-source software not 
 concern itself with good bullet points? Does this imply that I?m not 
 appreciative of the work?  There?s an opportunity cost with finding the time 
 for even this thread, which I?m hoping we can agree should not be a barrier 
 of entry for those who are simply interested in trying org-mode. As it 
 stands, however, just trying org-mode takes lots of reading if just to 
 install correctly. That?s all I?m saying. 
 
 Text is but one way that people learn. If you?re documenting sofware, it 
 leans towards rational, logical, and linear thinking. Some people require a 
 full-picture model first seeing things from many angles. Other?s prefer trial 
 and error, and others, still, enjoy hypotheticals. People can adopt different 
 strategies along the way. But to insist on only one method of learning and 
 sharing, while being concerned that you?re not meeting a larger audience is 
 tantamount to calling the rest of the class stupid, or simply a manner of 
 dishonesty with one?s own motivations.
 
 Maybe what would be helpful is some bridge instruction: ?Graduating from 
 Taskpaper: so you?re ready to try org-mode. What to expect:? I do find that 
 if I have an orientation point, even if it wasn?t the best decision in the 
 first place, I have a better reference as to the changes I would envision and 
 what the value of future options would be.
 
 cheers
 
 James
 On Sep 28, 2011, at 10:18 AM, Jambunathan K wrote:
 
 James
 
  Greetings,
  
  As an expert end-user but outside the computer science field, I?ve
  felt there to be a high cost of entry for working in org-mode. 
 
 This is another perfectly practical way to address the problem that you
 are contending to with.
 
 https://lists.gnu.org/archive/html/emacs-orgmode/2011-04/msg00173.html
 
 Jambunathan K.
 
 
 
 

Jude jdash...@shellworld.net
I love the Pope, I love seeing him in his Pope-Mobile, his three feet
of bullet proof plexi-glass. That's faith in action folks! You know he's
got God on his side.
~ Bill Hicks



Re: [O] would take more than an org-mode strip-down.

2011-09-28 Thread Russell Adams
On Wed, Sep 28, 2011 at 10:47:31AM -0400, James Levine wrote:
 I?ll go on leap of faith that the email I?ve been provided actually 
 contributes to the same thread I emailed to earlier. Please everyone: thank 
 you for looking out. This is clearly a thoughtful and supportive community. 
 You can not deny, however, that even the design of this forum is but one 
 example of how the Emacs community maintains its exclusivity. Own up to it. 
 If there?s no problem, then don?t fix it. But for those who are following the 
 statements on comparing org-mode to commercial substitutes like Taskpaper and 
 see this as an outcome of people making less-informed choices, I hope I can 
 keep your attention. Once I know which way to point my eyes, I promise I will 
 fall in line. Please take a step back folks, there?s an implied objective 
 that I?m making which I?ll state more explicitly:

 In order for org-mode to be attractive as an alternative to popular self-help 
 like GTD, Covey and the market of task managers both digital and paper that 
 exist, this community would need to take all this extensive documentation and 
 package it. Do not confuse content with transparency. People don?t even read 
 this much before electing their President. Should open-source software not 
 concern itself with good bullet points? Does this imply that I?m not 
 appreciative of the work?  There?s an opportunity cost with finding the time 
 for even this thread, which I?m hoping we can agree should not be a barrier 
 of entry for those who are simply interested in trying org-mode. As it 
 stands, however, just trying org-mode takes lots of reading if just to 
 install correctly. That?s all I?m saying.

Or you can watch a single 30 minute video:

http://vimeo.com/16533939

May be tooting my own horn, but I understand what you're saying. Org
isn't prepackaged nor does it come with documentation saying here's
how you use me to accomplish X. Everyone tends to find their own
style of using the tools Org provides to manage information.

Good luck!


 Text is but one way that people learn. If you?re documenting sofware, it 
 leans towards rational, logical, and linear thinking. Some people require a 
 full-picture model first seeing things from many angles. Other?s prefer trial 
 and error, and others, still, enjoy hypotheticals. People can adopt different 
 strategies along the way. But to insist on only one method of learning and 
 sharing, while being concerned that you?re not meeting a larger audience is 
 tantamount to calling the rest of the class stupid, or simply a manner of 
 dishonesty with one?s own motivations.

 Maybe what would be helpful is some bridge instruction: ?Graduating from 
 Taskpaper: so you?re ready to try org-mode. What to expect:? I do find that 
 if I have an orientation point, even if it wasn?t the best decision in the 
 first place, I have a better reference as to the changes I would envision and 
 what the value of future options would be.

 cheers

 James
 On Sep 28, 2011, at 10:18 AM, Jambunathan K wrote:

 James

  Greetings,
 
  As an expert end-user but outside the computer science field, I?ve
  felt there to be a high cost of entry for working in org-mode.

 This is another perfectly practical way to address the problem that you
 are contending to with.

 https://lists.gnu.org/archive/html/emacs-orgmode/2011-04/msg00173.html

 Jambunathan K.





--
Russell Adamsrlad...@adamsinfoserv.com

PGP Key ID: 0x1160DCB3   http://www.adamsinfoserv.com/

Fingerprint:1723 D8CA 4280 1EC9 557F  66E8 1154 E018 1160 DCB3



Re: [O] bug: org-mouse broken

2011-09-28 Thread Nicolas Goaziou
Hello,

Michael Brand michael.ch.br...@gmail.com writes:

 Only now I stumbled upon an issue with org-shiftleft and
 org-shiftright which I use rarely. On a heading without any todo
 keyword and with
 (setq org-todo-keywords '((sequence 1 2 3 | -3 -2 -1)))
 - C-left changes to -2 instead of -1
 - C-right states the buffer modified but leaves the heading still
   without any todo keyword instead of 1

This should be fixed. Patch follows.

Thanks again,

-- 
Nicolas Goaziou
From 7ff0dba146bfb6b8b21d0150ffb33ccb1aa21a68 Mon Sep 17 00:00:00 2001
From: Nicolas Goaziou n.goaz...@gmail.com
Date: Thu, 25 Aug 2011 01:58:29 +0200
Subject: [PATCH] Provide more consistent regexps for headlines

* lisp/org-agenda.el (org-search-view): Simplify regexp.
(org-agenda-get-todos): Use new format string.
* lisp/org-archive.el (org-archive-all-done): Simplify regexp.
* lisp/org-ascii.el (org-export-as-ascii): More accurate regexp.
* lisp/org-colview-xemacs.el (org-columns-capture-view): Use new
  format string and new string.
* lisp/org-colview.el (org-columns-capture-view): Use new format
  string and new string.
* lisp/org-docbook.el (org-export-as-docbook): More accurate
  regexp.  Also use new regexp to match generic headlines.
* lisp/org-exp.el (org-export-protect-quoted-subtrees): More accurate
  regexp.  Also use new regexp to match generic headlines.
* lisp/org-html.el (org-export-as-html): More accurate regexp.  Also
  use new regexp to match generic headlines.
* lisp/org-mouse.el (org-mouse-match-todo-keyword): Removed unused
  and now erroneous function.
* lisp/org.el (org-heading-regexp, org-heading-keyword-regexp-format):
  New variables.
(org-set-regexps-and-options): Create regexps according to the
following rule: use spaces only to separate elements from an headline,
while allowing mixed tabs and spaces for any indentation job.
(org-nl-done-regexp, org-looking-at-done-regexp): Removed variables.
(org-set-font-lock-defaults): Fontify again headlines with a keyword
and no other text.  Use new format strings.
(org-get-heading, org-toggle-comment, org-prepare-agenda-buffers,
org-toggle-fixed-width-section): Use new format string.
(org-todo): More accurate regexps.
(org-point-at-end-of-empty-headline): Simplify regexp.
(org-insert-heading): Headline can sometimes be nil.

This patch attempts to reduce the number of hard-coded headlines, by
providing two format strings and one generic string to cover most of
the cases of headline construction.
---
 lisp/org-agenda.el |   35 +
 lisp/org-archive.el|2 +-
 lisp/org-ascii.el  |4 +-
 lisp/org-colview-xemacs.el |5 +-
 lisp/org-colview.el|5 +-
 lisp/org-docbook.el|7 +-
 lisp/org-exp.el|6 +-
 lisp/org-html.el   |7 +-
 lisp/org-mouse.el  |7 --
 lisp/org.el|  189 +---
 10 files changed, 147 insertions(+), 120 deletions(-)

diff --git a/lisp/org-agenda.el b/lisp/org-agenda.el
index b1fa5f5..28c5d44 100644
--- a/lisp/org-agenda.el
+++ b/lisp/org-agenda.el
@@ -3868,7 +3868,7 @@ in `org-agenda-text-search-extra-files'.
 (if (not regexps+)
 	(setq regexp org-outline-regexp-bol)
   (setq regexp (pop regexps+))
-  (if hdl-only (setq regexp (concat ^ org-outline-regexp .*?
+  (if hdl-only (setq regexp (concat org-outline-regexp-bol  .*?
 	regexp
 (setq files (org-agenda-files nil 'ifmode))
 (when (eq (car org-agenda-text-search-extra-files) 'agenda-archives)
@@ -4574,18 +4574,21 @@ the documentation of `org-diary'.
 		  'help-echo
 		  (format mouse-2 or RET jump to org file %s
 			  (abbreviate-file-name buffer-file-name
-	 (regexp (concat ^\\*+[ \t]+\\(
-			 (if org-select-this-todo-keyword
-			 (if (equal org-select-this-todo-keyword *)
- org-todo-regexp
-			   (concat (
-   (mapconcat 'identity
-		  (org-split-string
-		   org-select-this-todo-keyword |) \\|)
- \\)\\))
-			   org-not-done-regexp)
-			 [^\n\r]*\\)))
-	 marker priority category category-pos tags todo-state ee txt beg end)
+	 (regexp (format org-heading-keyword-regexp-format
+			 (cond
+			  ((and org-select-this-todo-keyword
+(equal org-select-this-todo-keyword *))
+			   org-todo-regexp)
+			  (org-select-this-todo-keyword
+			   (concat \\(
+   (mapconcat 'identity
+	  (org-split-string
+	   org-select-this-todo-keyword
+	   |)
+	  \\|) \\)))
+			  (t org-not-done-regexp
+	 marker priority category tags todo-state
+	 ee txt beg end)
 (goto-char (point-min))
 (while (re-search-forward regexp nil t)
   (catch :skip
@@ -4597,11 +4600,11 @@ the documentation of `org-diary'.
 	(goto-char (1+ beg))
 	(or org-agenda-todo-list-sublevels (org-end-of-subtree 'invisible))
 	(throw :skip nil)))
-	(goto-char (match-beginning 1))
+	(goto-char (match-beginning 2))
 	(setq marker (org-agenda-new-marker 

Re: [O] bug: org-mouse broken

2011-09-28 Thread Michael Brand
Hi Nicolas

On Wed, Sep 28, 2011 at 17:53, Nicolas Goaziou n.goaz...@gmail.com wrote:
 Hello,

 Michael Brand michael.ch.br...@gmail.com writes:

 Only now I stumbled upon an issue with org-shiftleft and
 org-shiftright which I use rarely. On a heading without any todo
 keyword and with
 (setq org-todo-keywords '((sequence 1 2 3 | -3 -2 -1)))
 - C-left changes to -2 instead of -1
 - C-right states the buffer modified but leaves the heading still
   without any todo keyword instead of 1

 This should be fixed. Patch follows.

 Thanks again,

I can confirm that the issue is resolved. Thank you.

Michael



Re: [O] Latex Export: Place Caption Below Table

2011-09-28 Thread Eric S Fraga
Jakob Lombacher kont...@lombacher.net writes:

 Hi,

 if I export a document to latex, the caption of a table is always on the top.

 How can I place it at the bottom? Is there a parameter to config it?

No, the placement is (currently) fixed to come before the tabular (or
alternative) environment.  Line 1970 or thereabouts in
org-latex.el.  Should be straightforward to modify although it is a
quite common convention to have the caption above the table...

-- 
: Eric S Fraga (GnuPG: 0xC89193D8FFFCF67D) in Emacs 24.0.50.1
: using Org-mode version 7.7 (release_7.7.329.g15c3)



Re: [O] org footnote bug?

2011-09-28 Thread Nicolas Goaziou
henry atting nsmp...@online.de writes:

 Tag for non orgmode files is:

 (setq org-footnote-tag-for-non-org-mode-files ___)

 Well, I open a file, type some text and then add a footnote with
 org-footnote-action which is bound to C-cf:

 -
 Some Text, then adding a footnote [1] then adding a second footnote [2] and
 after a while a third footnote [3]

 [1] this footnote appears above the footnote tag

 ___

 [2] this footnote appears beneath the footnote tag

 [3] from now on all footnotes appear beneath the footnote tag
 --

 This is reproducible apparently with every file type except org files
 or when writing mail within gnus

This should be fixed now in master. Thank you for reporting this.

Regards,

-- 
Nicolas Goaziou



[O] Search from Agenda w/lock active

2011-09-28 Thread Nathan Neff
I frequently use org-agenda-set-restriction-lock to concentrate
on one of my org-files during work.

I have a custom agenda-search command that I would like to
use while at work.  However, when I try to run the searches, the
restriction-lock
prevails over the org-agenda-files that are defined in my custom agenda command.

For example, I have an agenda buffer restriction on foo.org so that
I only see stuff from foo.org in my agenda TODO searches and SCHEDULED
searches.

But, I would like to run this search periodically through the day:

 (n Notesmine search search 
((org-agenda-files (njn/notesmine-org-files

The problem is that the search will only search foo.org, unless I
remove the buffer restriction lock on foo.org before doing the search.

I see three ways to go about fixing this:

1) I can define special agenda views to only view foo.org
2) I can try to modify the Notesmine search to unlock the restriction lock
before doing the search, and restore it after doing the search
3) I can set org-agenda-files to foo.org throughout my work day.

Does anyone have advice on which one of the 3 solutions or a solution
that I missed?

I'm leaning towards #3, and I'm thinking that the restriction-lock
feature is really just for
on-the-fly agenda searches as opposed to being turned on all day long
for a particular file/buffer.

Thanks,
--Nate



Re: [O] Latex Export: Place Caption Below Table

2011-09-28 Thread Thomas S. Dye
Eric S Fraga e.fr...@ucl.ac.uk writes:

 Jakob Lombacher kont...@lombacher.net writes:

 Hi,

 if I export a document to latex, the caption of a table is always on the top.

 How can I place it at the bottom? Is there a parameter to config it?

 No, the placement is (currently) fixed to come before the tabular (or
 alternative) environment.  Line 1970 or thereabouts in
 org-latex.el.  Should be straightforward to modify although it is a
 quite common convention to have the caption above the table...

Hi Eric,

Are you able to propose a patch?  This came up in my work recently with
a journal that puts captions below a table (and ends them with a
period!).  

All the best,
Tom
-- 
Thomas S. Dye
http://www.tsdye.com



Re: [O] Latex Export: Place Caption Below Table

2011-09-28 Thread Nick Dokos
Thomas S. Dye t...@tsdye.com wrote:

 Eric S Fraga e.fr...@ucl.ac.uk writes:
 
  Jakob Lombacher kont...@lombacher.net writes:
 
  Hi,
 
  if I export a document to latex, the caption of a table is always on the 
  top.
 
  How can I place it at the bottom? Is there a parameter to config it?
 
  No, the placement is (currently) fixed to come before the tabular (or
  alternative) environment.  Line 1970 or thereabouts in
  org-latex.el.  Should be straightforward to modify although it is a
  quite common convention to have the caption above the table...
 
 Hi Eric,
 
 Are you able to propose a patch?  This came up in my work recently with
 a journal that puts captions below a table (and ends them with a
 period!).  
 

It's just a matter of emitting the \caption after the contents of the
table, rather than before:

,
| \begin{table}[htb]
| \begin{center}
| \begin{tabular}{rr}
| ...
| \end{tabular}
| \end{center}
| \caption{Squares}
| \end{table}
`

instead of

,
| \begin{table}[htb]
| \caption{Squares}
| \begin{center}
| \begin{tabular}{rr}
| ...
| \end{tabular}
| \end{center}
| \end{table}
`


The following patch (deliberately hidden as a binary octet-stream to keep it
out of patchwork) will do that - but IMO, it would be better to have yet another
user-settable option to control the placement.

Nick



caption-below-table.patch
Description: caption below table patch


Re: [O] would take more than an org-mode strip-down.

2011-09-28 Thread Rasmus
Hi James,

Thanks for your mails.


 You can not deny, however, that even the design of this
 forum is but one example of how the Emacs community maintains its
 exclusivity. Own up to it. 

It's a mailing list ≠ forum :) Anyway news is not fashionable, but sites
like Gmane makes it quite available.  The problem is not news but that
people generally does not know news.


 But for those who are following the statements on comparing org-mode
 to commercial substitutes like Taskpaper 

It's only a substitute if you so desire.

 In order for org-mode to be attractive as an alternative to popular
 self-help like GTD, Covey and the market of task managers both digital
 and paper that exist, this community would need to take all this
 extensive documentation and package it. 

I simply can grasp this.  The manual is provided in several flavors; if
anything the manual is lacking in some areas, but in general it's great.
Several tutorials, specifically on GTD exists on Worg (our `wiki').


 Do not confuse content with transparency.

Do not confuse a learning curve with transparency.  Algebra, philosophy
and economics also take time.


 Should open-source software not concern itself with good
 bullet points?

Emacs and therefore Org is free software.


  Does this imply that I’m not appreciative of the work?

Course not, please keep voicing your opinion and let me voice mine :) 


 There’s an opportunity cost with finding the time for even this
 thread, which I’m hoping we can agree should not be a barrier of entry
 for those who are simply interested in trying org-mode. As it stands,
 however, just trying org-mode takes lots of reading if just to install
 correctly. That’s all I’m saying.

By now several packages of Emacs for beginners exists.  On mac there is
the Aquamacs, on Windows I think there is something called ErgoMacs or
something like that.  Plus there are various Emacs Starter Kits.


 Text is but one way that people learn. If you’re documenting sofware,
 it leans towards rational, logical, and linear thinking. 

This method has proven evolutionary stable so far, has it not?


 Some people require a full-picture model first seeing things from many
 angles. Other’s prefer trial and error, and others, still, enjoy
 hypotheticals. 

All of these seems compatible to a linear presentation.  All text is
linear but you may elect a certain order of texts suiting your needs.


 People can adopt different strategies along the way. But to insist on
 only one method of learning and sharing, while being concerned that
 you’re not meeting a larger audience is tantamount to calling the rest
 of the class stupid, or simply a manner of dishonesty with one’s own
 motivations.

This is the greatness of a freedom of ideas.  People may opt in on their
favorite approach, no?


 Maybe what would be helpful is some bridge instruction: “Graduating
 from Taskpaper: so you’re ready to try org-mode. What to expect:” I do
 find that if I have an orientation point, even if it wasn’t the best
 decision in the first place, I have a better reference as to the
 changes I would envision and what the value of future options would
 be.

You are talking about specific to general `solutions'.  As many have
pointed out this will necessarily lead to a restricted set of
possibilities.  It further assumes that there is an `appropriate' or
`encouraged' way of utilizing Org.  Aside from a few hard-coded¹ symbols
this is very much not the case.  I use Org for writing first and task
management second.  Other use it for management first. 

That being said Worg is open.  If you feel a particular tutorial
(usually specific to specific documents) is missing feel free to add it,
/or/ describe what is lacking.  For instance theoretical as well as
practical toughs on GTD is widely discussed on Worg.


 what’s the ethical ambiguity in earning a living from setting up
 management systems for people and institutions, even if you’re using
 open-source material? 

There is no ethical ambiguity.  It would be selling a service.  This is
encouraged.  The ethical issues is concerned with not providing people
with the opportunity to `remix' and re-share to use a slightly different
terminology (see freedom 0-3 of free software definition).

–Rasmus


Footnotes: 
¹  Is that still the case or was everything such a `*' changed to
variables?

-- 
Sent from my Emacs



[O] [babel] adding a language - problems

2011-09-28 Thread Thorsten
Hi list, 
I'm on my way to add a new (intrpreted) lisp dialect to org-babel, but
encounter a few difficulties. Here is my little testprogramm:

-
#+tblname: tbl1
| 1 | 2 | 3 |
|---+---+---|
| 4 | 5 | 6 |
| 7 | 8 | 9 |


# external evaluation (no session)
#+srcname: pico-calc
#+begin_src picolisp :var tab=tbl1 :results value :hlines no 
  (+ (caar tab) (caar (cdr tab)))
#+end_src

# org-babel-error output:
[/tmp/babel-22634XBd/picolisp-script-22634K-K:1] !? (display (prog (let
(tab '((1 2 3) (4 5 6) (7 8 9))) (+ (caar tab) (caar (cdr tab))
display -- Undefined


#  with session
#+srcname: pico-calc
#+begin_src picolisp :var tab=tbl1 :results value :hlines no :session p1
  (+ (caar tab) (caar (cdr tab)))
#+end_src

#+results: pico-calc
[finishes with no output]

# session buffer:
(prog (let (tab '((1 2 3) (4 5 6) (7 8 9))) 
(+ (caar tab) (caar (cdr tab )
org-babel-picolisp-eoe
- 5
: - org-babel-picolisp-eoe

---

I do not know where undefined 'display' comes from in the error message
- seems to be a org-babel internal thing. What can I do about that,
where do I have to look?

The session evaluation works already, but there is a problem with the
eoe string. If I don't use it, Emacs hangs forever - waiting for the
session to return? If I use it, the right value is calculated, but not
returned - because the eoe string is evaluated after the source-body?

Thanks for any tips
Thorsten




Re: [O] [babel] adding a language - problems

2011-09-28 Thread Thorsten
Thorsten quintf...@googlemail.com writes:

 Hi list, 
 I'm on my way to add a new (intrpreted) lisp dialect to org-babel, but
 encounter a few difficulties. Here is my little testprogramm:

 -
 #+tblname: tbl1
 | 1 | 2 | 3 |
 |---+---+---|
 | 4 | 5 | 6 |
 | 7 | 8 | 9 |


 # external evaluation (no session)
 #+srcname: pico-calc
 #+begin_src picolisp :var tab=tbl1 :results value :hlines no 
   (+ (caar tab) (caar (cdr tab)))
 #+end_src

 # org-babel-error output:
 [/tmp/babel-22634XBd/picolisp-script-22634K-K:1] !? (display (prog (let
 (tab '((1 2 3) (4 5 6) (7 8 9))) (+ (caar tab) (caar (cdr tab))
 display -- Undefined


 #  with session
 #+srcname: pico-calc
 #+begin_src picolisp :var tab=tbl1 :results value :hlines no :session p1
   (+ (caar tab) (caar (cdr tab)))
 #+end_src

 #+results: pico-calc
 [finishes with no output]

 # session buffer:
 (prog (let (tab '((1 2 3) (4 5 6) (7 8 9))) 
 (+ (caar tab) (caar (cdr tab )
 org-babel-picolisp-eoe
 - 5
 : - org-babel-picolisp-eoe

 ---

 I do not know where undefined 'display' comes from in the error message
 - seems to be a org-babel internal thing. What can I do about that,
 where do I have to look?

 The session evaluation works already, but there is a problem with the
 eoe string. If I don't use it, Emacs hangs forever - waiting for the
 session to return? If I use it, the right value is calculated, but not
 returned - because the eoe string is evaluated after the source-body?

 Thanks for any tips
 Thorsten


Sorry, I encountered the undefined 'display' in source code I copied
from ob-scheme, I deleted it, and then external evaluation succeeded -
but again without output. 
So I seem to be quite close, evaluation work and the right value is
calculated - but not returned yet. 

cheers
Thorsten 




[O] Bug: Abbrev-mode expanded during export [7.7 (release_7.7.330.g774f)]

2011-09-28 Thread Bernt Hansen
Hi Eric,

I've recently switched from yasnippets to abbrev-mode + skeletons and
run into an unexpected situation during export.

I have the following level 2 task:

,
| *** NEXT Report bug about abbrev expansions during export
| [2011-09-28 Wed 07:55]
| 
| Define src edit mode for plantuml
`

I also have an abbrev-mode and skeleton expansion for 'plantuml' defined
as follows:

,
| (define-skeleton skel-org-block-plantuml
|   Insert a org plantuml block, querying for filename.
|   File (no extension): 
|   #+begin_src plantuml :file  str .png\n
|   _ - \n
|   #+end_src\n)
| 
| (define-abbrev org-mode-abbrev-table plantuml 
|   'skel-org-block-plantuml)
`

When I select this subtree for export with C-c @ and then C-c C-e b
I get prompted for the filename for expansion of 'plantuml'.

For some reason the combination of 'src' and 'plantuml' triggers this
abbrev mode expansion during export but I don't understand why.

This line is actually part of a commit for my 'Update org-mode doc' task
with a git short-log entry of

,
| d9bba26 Define src edit mode for plantuml
`

I don't think export should be trying to expand the plantuml in this
subtree.

Do you have any idea what is going on here?

Regards,
Bernt

Emacs  : GNU Emacs 23.2.1 (i486-pc-linux-gnu, GTK+ Version 2.20.0)
 of 2010-12-11 on raven, modified by Debian
Package: Org-mode version 7.7 (release_7.7.330.g774f)



[O] Bug: org-refile-targets doesn't say whether it's AND or OR [7.7 (release_7.7.351.gb8b5)]

2011-09-28 Thread Dave Abrahams


Remember to cover the basics, that is, what you expected to happen and
what in fact did happen.  You don't know how to make a good report?  See

 http://orgmode.org/manual/Feedback.html#Feedback

Your bug report will be posted to the Org-mode mailing list.


The documentation doesn't specify whether the cons cells are ANDed or
ORed together when selecting refile targets.

Emacs  : GNU Emacs 23.3.1 (x86_64-apple-darwin10.8.0, Carbon Version 1.6.0 
AppKit 1038.36)
 of 2011-09-12 on pluto.luannocracy.com
Package: Org-mode version 7.7 (release_7.7.351.gb8b5)
-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com




Re: [O] Bug: org-refile-targets doesn't say whether it's AND or OR [7.7 (release_7.7.351.gb8b5)]

2011-09-28 Thread Nick Dokos
Dave Abrahams d...@boostpro.com wrote:

 
 
 Remember to cover the basics, that is, what you expected to happen and
 what in fact did happen.  You don't know how to make a good report?  See
 
  http://orgmode.org/manual/Feedback.html#Feedback
 
 Your bug report will be posted to the Org-mode mailing list.
 
 
 The documentation doesn't specify whether the cons cells are ANDed or
 ORed together when selecting refile targets.
 

I'm not really sure what you mean, so let me tell you how I understand
this variable and then come back to the question of what you would like
to see.

AFAIK, the variable is used to construct a set of possible targets: you
select the items to refile and then you select *one* item from this
set. There is completion: as you type, the set is cut down to whatever
subset matches your current input - org does not let you finish until
the refiling target has been specified uniquely.

Each element of the org-refile-targets list generates a set of posssible
targets. The whole set is the union of these partial sets. Since ORs map
to unions and ANDs to intersections, I guess one could say that they are
ORed together, but personally I find it confusing to think of it in
these terms.

Assuming that this is correct, does it help? And if it is correct and it
does help, what would you change in the docs to incorporate this
information? And how? 

Nick








[O] Bug: `org-show-context' doc string [7.5]

2011-09-28 Thread Michael Heerdegen

Remember to cover the basics, that is, what you expected to happen and
what in fact did happen.  You don't know how to make a good report?  See

 http://orgmode.org/manual/Feedback.html#Feedback

Your bug report will be posted to the Org-mode mailing list.


Hi,

in my version of org-mode, the doc string of `org-show-context' forgets
to mention `org-show-entry-below', a variable that also influences the
behavior of this function.


Emacs  : GNU Emacs 23.3.1 (i486-pc-linux-gnu, X toolkit, Xaw3d scroll bars)
 of 2011-09-09 on spike.0x539.de, modified by Debian
Package: Org-mode version 7.5



Re: [O] Bug: org-refile-targets doesn't say whether it's AND or OR [7.7 (release_7.7.351.gb8b5)]

2011-09-28 Thread Dave Abrahams

on Wed Sep 28 2011, Nick Dokos nicholas.dokos-AT-hp.com wrote:

 Dave Abrahams d...@boostpro.com wrote:

 
 
 Remember to cover the basics, that is, what you expected to happen and
 what in fact did happen.  You don't know how to make a good report?  See
 
  http://orgmode.org/manual/Feedback.html#Feedback
 
 Your bug report will be posted to the Org-mode mailing list.
 
 
 The documentation doesn't specify whether the cons cells are ANDed or
 ORed together when selecting refile targets.
 

 I'm not really sure what you mean, so let me tell you how I understand
 this variable and then come back to the question of what you would like
 to see.

 AFAIK, the variable is used to construct a set of possible targets: you
 select the items to refile and then you select *one* item from this
 set. There is completion: as you type, the set is cut down to whatever
 subset matches your current input - org does not let you finish until
 the refiling target has been specified uniquely.

 Each element of the org-refile-targets list generates a set of posssible
 targets. The whole set is the union of these partial sets. Since ORs map
 to unions and ANDs to intersections, I guess one could say that they are
 ORed together, but personally I find it confusing to think of it in
 these terms.

Then think of it / describe it in terms of set unions.  ORing predicates
creates a set union.

 Assuming that this is correct, does it help? 

Yes.

 And if it is correct and it does help, what would you change in the
 docs to incorporate this information? And how?

I would change the doc for org-refile-targets to say that the resulting
list of targets is the union of all the targets matched by each cons
cell.  I think you could take that pretty much verbatim.

-- 
Dave Abrahams
BoostPro Computing
http://www.boostpro.com



[O] using Cygwin Gnuplot with org-babel-gnuplot

2011-09-28 Thread Alexander Vorobiev
Hi,

It is mentioned in
http://orgmode.org/worg/org-contrib/babel/languages/ob-doc-gnuplot.html#sec-2_1
that there were some problems with gnuplot on Windows machines. I came
up with a small fix which makes it possible to use Cygwin version of
gnuplot with org-mode. The change is in the org-babel-execute:gnuplot
function where I added passing of optional argument to
org-babel-process-file-name:

before:
(org-babel-process-file-name script-file

after:
(org-babel-process-file-name script-file t

The argument forces the function not to add backslash prior to :
character which prevented gnuplot from finding the script for
execution. I hope somebody will find the fix useful. Unfortunately I
don't know if the fix breaks anything on Unix/Linux/Mac.

Thanks
Alex Vorobiev



Re: [O] Bug: org-refile-targets doesn't say whether it's AND or OR [7.7 (release_7.7.351.gb8b5)]

2011-09-28 Thread Nick Dokos
Dave Abrahams d...@boostpro.com wrote:

 I would change the doc for org-refile-targets to say that the resulting
 list of targets is the union of all the targets matched by each cons
 cell.  I think you could take that pretty much verbatim.
 

How's this?

Nick

---
From f853b04fb474493b3b7b8857794c9f120c5f7822 Mon Sep 17 00:00:00 2001
From: Nick Dokos n...@dokosmarshall.org
Date: Wed, 28 Sep 2011 23:49:13 -0400
Subject: [PATCH] Amplify the doc for org-refile-targets

* lisp/org.el: (org-refile-targets) Elaborated the documentation of
   the variable as suggested by Dave Abrahams.

TINYCHANGE
---
 lisp/org.el |6 +-
 1 files changed, 5 insertions(+), 1 deletions(-)

diff --git a/lisp/org.el b/lisp/org.el
index 945d759..68c6912 100644
--- a/lisp/org.el
+++ b/lisp/org.el
@@ -1864,7 +1864,7 @@ (defcustom org-log-refile nil
 
 (defcustom org-refile-targets nil
   Targets for refiling entries with \\[org-refile].
-This is list of cons cells.  Each cell contains:
+This is a list of cons cells.  Each cell contains:
 - a specification of the files to be considered, either a list of files,
   or a symbol whose function or variable value will be used to retrieve
   a file name or a list of file names.  If you use `org-agenda-files' for
@@ -1886,6 +1886,10 @@ (defcustom org-refile-targets nil
 Note that, when `org-odd-levels-only' is set, level corresponds to
 order in hierarchy, not to the number of stars.
 
+Each element of this list generates a set of possible targets.
+The union of these sets is presented (with completion) to
+the user by `org-refile'.
+
 You can set the variable `org-refile-target-verify-function' to a function
 to verify each headline found by the simple criteria above.
 
-- 
1.7.5.1.169.g505a1