org-mode/doc
Tim Visher bea9fca183
org-capture.el: Allow `(here)' as a template target
* lisp/org-capture.el (org-capture-set-target-location): Allow
`(here)' as a template target in addition to `here'.
(org-capture-templates): Update the docstring, describing the new
target.
* doc/org-manual.org (Template elements): Add `(here)' target
documentation
* etc/ORG-NEWS (Capture templates now support ~(here)~ as a target):
Document the new feature.

Templates had no user accessible way to target the current location
directly from a capture template. Attempting to directly utilize the
behavior accessible through a 0 prefix arg exposed the inconsistent
treatment of the `:target` property in
`org-capture`. `org-capture-set-target-location` understood that it
could be both a symbol and a list, while `org-capture` itself required
it to be a list through its use of `car`.

This change opts to make `org-capture-set-target-location` more
liberal in what it accepts rather than making `org-capture` agree that
targets can be lists. This is because the manual implies, especially
in the `(clock)' entry, that targets are expected to be lists even if
they are meant as specific points.

TINYCHANGE
2023-06-22 13:14:12 +03:00
..
.aspell.org.conf Fix typos 2019-11-16 17:17:36 -05:00
.nosearch Add .nosearch file to the doc/ subdirectory. 2008-12-17 17:25:31 +01:00
Documentation_Standards.org org-manual: Inline single-sentence footnotes 2022-10-04 10:18:26 +08:00
Makefile doc/Makefile: Limit memory consumption when generating docs 2022-06-17 13:18:39 +08:00
dir Add org-guide.org to the build process 2019-03-19 02:25:18 +01:00
doc-setup.org Backport commit cae528457 from Emacs 2023-01-01 12:44:47 -05:00
fdl.org Prefer HTTPS to HTTP in most links 2021-03-21 15:21:22 -04:00
htmlxref.cnf Prefer HTTPS to HTTP for links to gnu.org 2021-03-21 14:29:13 -04:00
org-guide.org org-manual, org-guide: Improve timestamp documentation 2023-06-18 13:23:36 +03:00
org-manual.org org-capture.el: Allow `(here)' as a template target 2023-06-22 13:14:12 +03:00
orgcard.tex orgcard.tex: Fix `org-force-cycle-archived' binding 2023-03-05 13:07:52 +01:00
pdflayout.sty Prefer HTTPS to HTTP for links to gnu.org 2021-03-21 14:29:13 -04:00
texinfo.tex Prefer HTTPS to HTTP in most links 2021-03-21 15:21:22 -04:00