* [PATCH] org-manual: Dynamic Blocks: Fix explanation of :content
@ 2019-10-14 23:29 Sebastian Miele
2019-11-16 23:04 ` Kyle Meyer
0 siblings, 1 reply; 2+ messages in thread
From: Sebastian Miele @ 2019-10-14 23:29 UTC (permalink / raw)
To: emacs-orgmode
* doc/org-manual.org (Dynamic Blocks): Correct the information given
on :content in the plist passed to the writer function.
---
doc/org-manual.org | 9 ++++-----
1 file changed, 4 insertions(+), 5 deletions(-)
diff --git a/doc/org-manual.org b/doc/org-manual.org
index 59591894d..79257b7e0 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -20089,13 +20089,12 @@ These commands update dynamic blocks:
Before updating a dynamic block, Org removes content between the
=BEGIN= and =END= markers. Org then reads the parameters on the
-=BEGIN= line for passing to the writer function. If the function
-expects to access the removed content, then Org expects an extra
-parameter, =:content=, on the =BEGIN= line.
+=BEGIN= line for passing to the writer function as a plist. The
+previous content of the dynamic block becomes erased from the buffer
+and appended to the plist under ~:content~.
The syntax for naming a writer function with a dynamic block labelled
-=myblock= is: ~org-dblock-write:myblock~. Parameters come from the
-=BEGIN= line.
+=myblock= is: ~org-dblock-write:myblock~.
The following is an example of a dynamic block and a block writer function
that updates the time when the function was last run:
--
2.23.0
^ permalink raw reply related [flat|nested] 2+ messages in thread
* Re: [PATCH] org-manual: Dynamic Blocks: Fix explanation of :content
2019-10-14 23:29 [PATCH] org-manual: Dynamic Blocks: Fix explanation of :content Sebastian Miele
@ 2019-11-16 23:04 ` Kyle Meyer
0 siblings, 0 replies; 2+ messages in thread
From: Kyle Meyer @ 2019-11-16 23:04 UTC (permalink / raw)
To: sebastian.miele, emacs-orgmode
Sebastian Miele <sebastian.miele@gmail.com> writes:
> * doc/org-manual.org (Dynamic Blocks): Correct the information given
> on :content in the plist passed to the writer function.
Looks correct to me. Applied in 634880a2e. Thanks.
^ permalink raw reply [flat|nested] 2+ messages in thread
end of thread, other threads:[~2019-11-16 23:05 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2019-10-14 23:29 [PATCH] org-manual: Dynamic Blocks: Fix explanation of :content Sebastian Miele
2019-11-16 23:04 ` 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).