Re: [Orgmode] [babel] `org-babel-tangle-w-comments' controls comment insertion in tangled code

[Erik Iverson]

Eric Schulte wrote:
> Hi,
>
> The insertion of automatically generated comments in tangled source code
> is now controlled by the new `org-babel-tangle-w-comments' variable.
> Setting this variable to non-nil will allow org-babel to insert comments
> for those languages with comment support.

Can you briefly elaborate on what this means?  I'm used to seeing, when 
I tangle an R file, something like:

## 
[[file:~/private/R-org-babel/test.org::*cube%20lets%20go%20to%20the][block-2]]

cube <- function(x) {
  # a test comment
  x * x * x * x
}
## block-2 ends here

So, you mean that all three of the comments would no longer appear by 
default?  Or you mean that only my inline function comment would not 
appear?

One more idea I had was that it might be interesting to be able to 
maintain properties for headlines that indicate the headline/body should 
be included as a comment in a specific source file.  The reason I say 
this is that even if I write my code in org-mode, and in effect comment 
the code using org-mode constructs like headlines and free text, someone 
who just wants the tangled file might want to see comments, for example, 
function headers or something like that.

Any thoughts on that?