[வியாழன் நவம்பர் 21, 2024] Visuwesh wrote: > In the attached file "test.org", I want to capture new headings above > "Projects" always. To achieve this, I used a file+function target to > move the point above "Projects" like below > > [...] > > However, when evaluating this sexp, the heading "test" is always > appended to the end of file contrary to what the docstring says: > > (file+function "path/to/file" function-finding-location) > A function to find the right location in the file > > This is because of the 'else' clause in the cond form in > org-capture-place-entry: > > [...] > > Should this be here? Am I misunderstanding the documentation? After > all, it is too terse (the same text is in the Info manual too). The > documentation for the 'entry' type does not mention this quirk either: > > entry an Org node, with a headline. Will be filed > as the child of the target entry or as a > top-level entry. Its default template is: > "* %?\n%a" > > The documentation for :prepend does mention that entries will be > inserted at the end if it is nil but I would think that using a function > would rule this out. > > Changing the type to 'plain' from 'entry' works as expected though.
I just thought of a situation where this behaviour would be desired: a template could use FUNCTION-FINDING-LOCATION to ask the user to choose a heading (from a list, using org-ql, etc.) to capture the entry to go _under_ it. Here, the function would simply move the point to be on the heading. [ I am actually in the process of writing such a capture template. ] So perhaps an indicator to tell org-capture that I want to insert the heading exactly _at_point_ is required instead?