[elpa] externals/org 2da9253e7d 1/3: doc/org-manual.org: Clarify context of evaluation code block references

[ELPA Syncer]

branch: externals/org
commit 2da9253e7d48eec7e81d725f63983ecd7be7e1a3
Author: Ihor Radchenko <yantar92@posteo.net>
Commit: Ihor Radchenko <yantar92@posteo.net>

    doc/org-manual.org: Clarify context of evaluation code block references
    
    * doc/org-manual.org (Noweb Reference Syntax):
    (Passing arguments): Explain that referenced code block evaluation
    happens with point at the referenced block.
---
 doc/org-manual.org | 8 +++++---
 1 file changed, 5 insertions(+), 3 deletions(-)

diff --git a/doc/org-manual.org b/doc/org-manual.org
index eb77558daa..9e31725c08 100644
--- a/doc/org-manual.org
+++ b/doc/org-manual.org
@@ -17999,6 +17999,7 @@ a colon, for example: =:var 
table=other-file.org:example-table=.
 
   A code block name, as assigned by =NAME= keyword, followed by
   parentheses and optional arguments passed within the parentheses.
+  The block is evaluated with point at its location.
 
   #+begin_example
   ,#+NAME: double
@@ -19425,9 +19426,10 @@ By default a newline separates each noweb reference 
concatenation.  To
 use a different separator, edit the =noweb-sep= header argument.
 
 Alternatively, Org can include the results of evaluation of a single
-code block rather than its body.  Evaluation occurs when parentheses,
-possibly including arguments, are appended to the code block name, as
-shown below.
+code block rather than its body [[fn::The reference is evaluated with
+point at the referenced block, using its header arguments (including
+inherited)].  Evaluation occurs when parentheses, possibly including
+arguments, are appended to the code block name, as shown below.
 
 : <<NAME(optional arguments)>>