Text preceding noweb references is duplicated

Text preceding noweb references is duplicated

[8dcc]

Hello,

Using the following Org file:

    Paragraph zero...
    #+begin_src scheme :tangle org-output.scm :noweb yes
    (list <<my-list-item>>)
    #+end_src
    Paragraph one...
    #+begin_src scheme :tangle no :noweb-ref my-list-item
    (+ 1 2)
    #+end_src
    Paragraph two...
    #+begin_src scheme :tangle no :noweb-ref my-list-item
    (+ 3 4)
    #+end_src
    Paragraph three...
    #+begin_src scheme :tangle no :noweb-ref my-list-item
    (+ 5 6)
    #+end_src

After calling `org-babel-tangle', the contents of 'org-output.scm' are:

    (list (+ 1 2)
    (list (+ 3 4)
    (list (+ 5 6))

Notice how all lines start with '(list', while only the last line
contains the closing parentheses.

However, if I use the following noweb[1] file:

    Paragraph zero...
    <<file.scm>>=
    (list <<my list item>>)
    @
    Paragraph one...
    <<my list item>>=
    (+ 1 2)
    @
    Paragraph two...
    <<my list item>>=
    (+ 3 4)
    @
    Paragraph three...
    <<my list item>>=
    (+ 5 6)

Which was created using the linked one-page guide[2], I get the
following (expected) output:

    (list (+ 1 2)
          (+ 3 4)
          (+ 5 6))

This noweb output was generated using the following command, from
version 2.12:

    notangle -Rfile.scm my-noweb-file.nw > noweb-output.scm

Although the current Org behavior can be useful in some situations, I
would like to know if it's intentional before using it, and, in that
case, if it's documented anywhere in the manual.

Thanks in advance.

[1] https://www.cs.tufts.edu/~nr/noweb/
[2] http://literateprogramming.com/nowebpg1.pdf

Re: Text preceding noweb references is duplicated

[Ihor Radchenko]

8dcc <8dcc.git@gmail.com> writes:

>     Paragraph zero...
>     #+begin_src scheme :tangle org-output.scm :noweb yes
>     (list <<my-list-item>>)
>...
> After calling `org-babel-tangle', the contents of 'org-output.scm' are:
>
>     (list (+ 1 2)
>     (list (+ 3 4)
>     (list (+ 5 6))
>
> Notice how all lines start with '(list', while only the last line
> contains the closing parentheses.
> ...
> Although the current Org behavior can be useful in some situations, I
> would like to know if it's intentional before using it, and, in that
> case, if it's documented anywhere in the manual.

Yes, it is intentional.
See https://orgmode.org/manual/Noweb-Reference-Syntax.html
Search for "prefix".
Also, see :noweb-prefix header argument.

-- 
Ihor Radchenko // yantar92,
Org mode maintainer,
Learn more about Org mode at <https://orgmode.org/>.
Support Org development at <https://liberapay.com/org-mode>,
or support my work at <https://liberapay.com/yantar92>