Karthik Chikmagalur <karthikchikmaga...@gmail.com> writes: > 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---
I am not sure about `org-capture'. AFAIU, only `org-capture-import-remember-templates' is affected. And that function is basically obsolete - its only purpose is helping people to convert config after ancient breaking change. Maybe we can simply rename the variable to `org-refile-reverse-order' or something along those lines. > Additionally, should this variable affect the order of notes stored via > `org-add-note'? Currently, `org-add-note' ordering is controlled by `org-log-states-order-reversed'. I am afraid that changing the current status quo may create confusion. We might introduce a new variable `org-log-note-order-reversed' just for interactive notes. WDYT? -- Ihor Radchenko // yantar92, Org mode maintainer, Learn more about Org mode at <https://orgmode.org/>. Support Org development at <https://liberapay.com/org-mode>, or support my work at <https://liberapay.com/yantar92>
