Re: [O] [PATCH] org-manual: Dynamic Blocks: Fix explanation of :content

2019-11-16 Thread Kyle Meyer
Sebastian Miele  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.



[O] [PATCH] org-manual: Dynamic Blocks: Fix explanation of :content

2019-10-14 Thread Sebastian Miele
* 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