It's not clear from the documentation of `org-reverse-note-order' what
"note" means:

--8<---------------cut here---------------start------------->8---
Non-nil means store new notes at the beginning of a file or entry.
When nil, new notes will be filed to the end of a file or entry.
This can also be a list with cons cells of regular expressions that
are matched against file names, and values.
--8<---------------cut here---------------end--------------->8---

At first glance, it looks like it applies only to `org-add-note'.  I had
to look at the code to see that it applies to `org-refile' and
(possibly) to org-capture as well, but not to `org-add-note' itself!

I think this documentation can be improved.  Can we append something
like this at the end?

--8<---------------cut here---------------start------------->8---
This affects the default placement of new notes at the destination when
running `org-refile' and `org-capture'.  See also the command
`org-refile-reverse'.
--8<---------------cut here---------------end--------------->8---

Additionally, should this variable affect the order of notes stored via
`org-add-note'?

Karthik

Reply via email to