Noweb references and padlines

Noweb references and padlines

[Linus Arver]

Hello,

Org supports adding blank lines between concatenated source code blocks
with the "padline" header argument [1]. However this does not work for
Noweb references.

For example, a blank line is inserted between "foo" and "bar" and again
between "bar" and "baz" for tangling-padline.txt below:

    #+begin_src txt :tangle tangling-padline.txt
    foo
    #+end_src

    #+begin_src txt :tangle tangling-padline.txt
    bar
    #+end_src

    #+begin_src txt :tangle tangling-padline.txt
    baz
    #+end_src

So tangling-padline.txt looks like

--8<---------------cut here---------------start------------->8---
foo

bar

baz
--8<---------------cut here---------------end--------------->8---

Which is great. But the same blank lines are not inserted for the
following case using "Noweb chunk" as a Noweb reference:

    #+begin_src txt :tangle tangling-padline-noweb.txt
    <<Noweb chunk>>
    #+end_src

    #+header: :noweb-ref Noweb chunk
    #+begin_src txt
    foo
    #+end_src

    #+header: :noweb-ref Noweb chunk
    #+begin_src txt
    bar
    #+end_src

    #+header: :noweb-ref Noweb chunk
    #+begin_src txt
    baz
    #+end_src

And now tangling-padline-noweb.txt looks like

--8<---------------cut here---------------start------------->8---
foo
bar
baz
--8<---------------cut here---------------end--------------->8---

Is this discrepancy intentional? If not, I guess you could consider this
email as a bug report. I'm not sure how to implement a workaround using
Org tangle hooks [1]; if it is possible to have a workaround please do
let me know!

Software versions:

  - GNU Emacs 29.4 (build 1, aarch64-apple-darwin23.5.0, NS
appkit-2487.60 Version 14.5 (Build 23F79))
  - Org mode version 9.7.11 (9.7.11-??-6a5d0ed34 @
/Users/l/syscfg/emacs/doom-upstream/.local/straight/build-29.4/org/)

I am not subscribed to this list so please CC me on replies, thanks.

[1] https://orgmode.org/manual/Extracting-Source-Code.html

Re: Noweb references and padlines

[Ihor Radchenko]

Linus Arver <linus@ucla.edu> writes:

> Org supports adding blank lines between concatenated source code blocks
> with the "padline" header argument [1]. However this does not work for
> Noweb references.
> ...
> Which is great. But the same blank lines are not inserted for the
> following case using "Noweb chunk" as a Noweb reference:

Check out :noweb-sep header arg.

-- 
Ihor Radchenko // yantar92,
Org mode contributor,
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>

Re: Noweb references and padlines

[Linus Arver]

Ihor Radchenko <yantar92@posteo.net> writes:

> Linus Arver <linus@ucla.edu> writes:
>
>> Org supports adding blank lines between concatenated source code blocks
>> with the "padline" header argument [1]. However this does not work for
>> Noweb references.
>> ...
>> Which is great. But the same blank lines are not inserted for the
>> following case using "Noweb chunk" as a Noweb reference:
>
> Check out :noweb-sep header arg.

Ah, this appears to do the trick! I did

--8<---------------cut here---------------start------------->8---
#+property: header-args+ :noweb-sep "\n\n"
--8<---------------cut here---------------end--------------->8---

at the top of my Org file to get the behavior I wanted. Thanks.