Re: [Orgmode] Re: [babel] Painless integration of source blocks with language

[Eric Schulte]

Sébastien Vauban <address@hidden> writes:

> Hi Eric,
>
> "Eric Schulte" wrote:
>> I've just pushed up a new header argument combination ":comments noweb"
>> which will wrap all embedded noweb sections in link comments, as
>> demonstrated in the following example.  Hopefully this should be
>> sufficient for a complete mapping from a pure code file back to the
>> original org-mode file.
>
> If I understand correctly, this is some sort of enhancement to the ":comments
> yes" option.
>
> If yes, is there a reason to have both values, with subtle differences?
> Shouldn't we port the behavior of ":comments noweb" to the ":comments yes"
> value?
>

Yes, the reason to retain both variants is that in the case of short
noweb references embedded in a single line, e.g.

#+source: first
#+begin_src ruby
  5
#+end_src

#+begin_src ruby :noweb yes
  <<first>> + 6
#+end_src

the yes option would be preferable, as the insertion of comments around
the noweb reference would result in adding line breaks around the
reference and possibly breaking new-line sensitive code.

Cheers -- Eric

>
> Best regards,
>   Seb