[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/denote 282b3a9810 4/6: denote-org-dblock: update docume
From: |
ELPA Syncer |
Subject: |
[elpa] externals/denote 282b3a9810 4/6: denote-org-dblock: update documentation on use |
Date: |
Sat, 12 Nov 2022 23:59:41 -0500 (EST) |
branch: externals/denote
commit 282b3a9810de59667dcfe2eb88383c5a7ee1f498
Author: Elias Storms <elias.storms@gmail.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>
denote-org-dblock: update documentation on use
Rephrased the comments explaining how to use the Org Dynamic blocks
feature.
---
denote-org-dblock.el | 25 ++++++++++++++-----------
1 file changed, 14 insertions(+), 11 deletions(-)
diff --git a/denote-org-dblock.el b/denote-org-dblock.el
index 0028c54d41..f36acae266 100644
--- a/denote-org-dblock.el
+++ b/denote-org-dblock.el
@@ -59,24 +59,27 @@
;; contents of the block with links to notes matching the search
;; ':regexp'. See also the denote manual on 'denote-link-add-links'.
;;
-;; To only include "missing links" (i.e., links to notes that the
-;; current buffer doesn't already link to), add ':missing-only t' to
-;; the block's header.
+;; Inserting a block can be done via the Org-mode entry point
+;; 'org-dynamic-block-insert-dblock' and selecting 'denote-links' from
+;; the list, or directly by calling 'denote-org-dblock-insert-links'.
;;
-;; With ':block-name "string"', include a name in the Dynamic block,
-;; formated as '#+NAME: string'. This enables users to use the Dynamic
-;; block as inputs for further computation, e.g. in Org source blocks.
;;
-;; In summary, Org Dynamic blocks of the denote-links type can have
-;; three arguments:
+;; Org Dynamic blocks of the denote-links type can have three
+;; arguments:
;; 1. :regexp "string" -- the search input (required)
;; 2. :missing-only t -- to only include missing links
;; 3. :block-name "n" -- to include a name for later processing
;;
-;; Inserting a block can be done via the Org-mode entry point
-;; 'org-dynamic-block-insert-dblock' and selecting 'denote-links' from
-;; the list, or directly by calling 'denote-org-dblock-insert-links'.
+;; By default ':missing-only t' is included as a parameter in the
+;; block's header, so that only "missing links" are included (i.e.,
+;; links to notes that the current buffer doesn't already link to).
+;; Remove this parameter or set to 'nil' to include all matching
+;; notes.
;;
+;; With ':block-name "string"' include a '#+NAME: string' line in the
+;; Dynamic block. This allows use of the Dynomic block output as input
+;; for further computation, e.g. in Org source blocks.
+
;;;###autoload
(defun denote-org-dblock-insert-links (regexp)
"Create Org dynamic block to insert Denote links matching REGEXP."
- [elpa] externals/denote updated (b89b566dff -> 09f8e3deee), ELPA Syncer, 2022/11/12
- [elpa] externals/denote ab626b36b9 3/6: denote-org-dblock: use read-regexp, ELPA Syncer, 2022/11/12
- [elpa] externals/denote 09f8e3deee 6/6: denote-org-dblock: add correct 'provide' form, ELPA Syncer, 2022/11/12
- [elpa] externals/denote 24ab18b705 1/6: Transform denote-org.el into denote-org-dblock.el, ELPA Syncer, 2022/11/12
- [elpa] externals/denote 282b3a9810 4/6: denote-org-dblock: update documentation on use,
ELPA Syncer <=
- [elpa] externals/denote 5c4263aeec 5/6: denote-org-dblock: tweak comments to placate the compiler, ELPA Syncer, 2022/11/12
- [elpa] externals/denote 6a57086f01 2/6: denote-org-dblock: rename write functions, ELPA Syncer, 2022/11/12