emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
* Re: [Patch] Document org-capture-templates entry type default strings
@ 2020-05-04 16:18 No Wayman
  2020-05-04 17:07 ` No Wayman
  0 siblings, 1 reply; 16+ messages in thread
From: No Wayman @ 2020-05-04 16:18 UTC (permalink / raw)
  To: emacs-orgmode


Any interest in this patch?


^ permalink raw reply	[flat|nested] 16+ messages in thread
* [Patch] Document org-capture-templates entry type default strings
@ 2020-03-31 21:46 No Wayman
  2020-05-24 13:28 ` Bastien
  0 siblings, 1 reply; 16+ messages in thread
From: No Wayman @ 2020-03-31 21:46 UTC (permalink / raw)
  To: emacs-orgmode


I've included the default entry type strings for each entry type 
in org-capture-tempalte's
docstring. Made a couple clarifying edits as well. IMO this is 
better than having the user hunt for the defaults in the source or 
experimenting by creating each type of template:


diff --git a/lisp/org-capture.el b/lisp/org-capture.el
index d292defd6..ac4d633cb 100644
--- a/lisp/org-capture.el
+++ b/lisp/org-capture.el
@@ -159,14 +159,20 @@ description  A short string describing the 
template, will be shown during
 type         The type of entry.  Valid types are:
                entry       an Org node, with a headline.  Will be 
                filed
                            as the child of the target entry or as 
                            a
-                           top-level entry.
+                           top-level entry. Its default template 
is:
+                             \"* %?\n %a\"
                item        a plain list item, will be placed in 
                the
-                           first plain list at the target
-                           location.
+                           first plain list at the target 
location.
+                           Its default template is:
+                             \"- %?\"
                checkitem   a checkbox item.  This differs from 
                the
                            plain list item only in so far as it 
                            uses a
-                           different default template.
+                           different default template. Its 
default
+                           template is:
+                             \"- [ ] %?\"
                table-line  a new line in the first table at 
                target location.
+                           Its default template is:
+                             \"| %? |\"
                plain       text to be inserted as it is.

 target       Specification of where the captured item should be 
 placed.
@@ -214,9 +220,10 @@ target       Specification of where the 
captured item should be placed.
                 Most general way: write your own function which 
                 both visits
                 the file and moves point to the right location

-template     The template for creating the capture item.  If you 
 leave this
-             empty, an appropriate default template will be used. 
              See below
-             for more details.  Instead of a string, this may 
              also be one of
+template     The template for creating the capture item.
+             If it is an empty string or nil, a default template 
based on
+             the entry type will be used (see the \"type\" 
section above).
+             Instead of a string, this may also be one of:

                  (file \"/path/to/template-file\")
                  (function function-returning-the-template)


===File 
/mnt/data/programming/repos/org-mode/0001-Document-entry-type-default-template-strings.patch===
From 1b91f8ad184d191e1ee09e79e150d7f51c0c3b18 Mon Sep 17 00:00:00 
2001
From: Nicholas Vollmer <iarchivedmywholelife@gmail.com>
Subject: [PATCH] Document entry type default template strings

---
 lisp/org-capture.el | 21 ++++++++++++++-------
 1 file changed, 14 insertions(+), 7 deletions(-)

diff --git a/lisp/org-capture.el b/lisp/org-capture.el
index d292defd6..ac4d633cb 100644
--- a/lisp/org-capture.el
+++ b/lisp/org-capture.el
@@ -159,14 +159,20 @@ description  A short string describing the 
template, will be shown during
 type         The type of entry.  Valid types are:
                entry       an Org node, with a headline.  Will be 
                filed
                            as the child of the target entry or as 
                            a
-                           top-level entry.
+                           top-level entry. Its default template 
is:
+                             \"* %?\n %a\"
                item        a plain list item, will be placed in 
                the
-                           first plain list at the target
-                           location.
+                           first plain list at the target 
location.
+                           Its default template is:
+                             \"- %?\"
                checkitem   a checkbox item.  This differs from 
                the
                            plain list item only in so far as it 
                            uses a
-                           different default template.
+                           different default template. Its 
default
+                           template is:
+                             \"- [ ] %?\"
                table-line  a new line in the first table at 
                target location.
+                           Its default template is:
+                             \"| %? |\"
                plain       text to be inserted as it is.

 target       Specification of where the captured item should be 
 placed.
@@ -214,9 +220,10 @@ target       Specification of where the 
captured item should be placed.
                 Most general way: write your own function which 
                 both visits
                 the file and moves point to the right location

-template     The template for creating the capture item.  If you 
 leave this
-             empty, an appropriate default template will be used. 
              See below
-             for more details.  Instead of a string, this may 
              also be one of
+template     The template for creating the capture item.
+             If it is an empty string or nil, a default template 
based on
+             the entry type will be used (see the \"type\" 
section above).
+             Instead of a string, this may also be one of:

                  (file \"/path/to/template-file\")
                  (function function-returning-the-template)
--
2.26.0

============================================================

^ permalink raw reply related	[flat|nested] 16+ messages in thread

end of thread, other threads:[~2020-09-04  9:38 UTC | newest]

Thread overview: 16+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2020-05-04 16:18 [Patch] Document org-capture-templates entry type default strings No Wayman
2020-05-04 17:07 ` No Wayman
2020-05-04 18:08   ` Nicolas Goaziou
2020-05-05  0:34     ` Kyle Meyer
2020-05-05  0:48       ` No Wayman
2020-05-05  0:59         ` Kyle Meyer
2020-05-21  7:52         ` Bastien
2020-05-21 19:35           ` No Wayman
2020-05-22 15:37             ` Bastien
2020-06-04  5:21               ` No Wayman
2020-06-04  5:57                 ` Bastien
2020-07-31 20:33     ` No Wayman
2020-09-04  9:35       ` Bastien
  -- strict thread matches above, loose matches on Subject: below --
2020-03-31 21:46 No Wayman
2020-05-24 13:28 ` Bastien
2020-05-24 16:30   ` Kyle Meyer

Code repositories for project(s) associated with this public inbox

	https://git.savannah.gnu.org/cgit/emacs/org-mode.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).