From mboxrd@z Thu Jan 1 00:00:00 1970 From: Erik Iverson Subject: Re: [babel] `org-babel-tangle-w-comments' controls comment insertion in tangled code Date: Fri, 28 May 2010 10:43:35 -0500 Message-ID: <4BFFE4A7.9070300@ccbr.umn.edu> References: <87sk5c8497.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Return-path: Received: from [140.186.70.92] (port=57701 helo=eggs.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1OI1it-00039h-Gw for emacs-orgmode@gnu.org; Fri, 28 May 2010 11:43:48 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.69) (envelope-from ) id 1OI1is-0006bI-6T for emacs-orgmode@gnu.org; Fri, 28 May 2010 11:43:47 -0400 Received: from walleye.ccbr.umn.edu ([128.101.116.11]:1133) by eggs.gnu.org with esmtp (Exim 4.69) (envelope-from ) id 1OI1ir-0006Zx-VS for emacs-orgmode@gnu.org; Fri, 28 May 2010 11:43:46 -0400 In-Reply-To: <87sk5c8497.fsf@gmail.com> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Eric Schulte Cc: Org Mode 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?