From mboxrd@z Thu Jan 1 00:00:00 1970 From: Michael Hannon Subject: Re: Babel vs. Doxygen? Date: Thu, 29 Mar 2012 08:50:29 -0700 (PDT) Message-ID: <1333036229.29253.YahooMailNeo@web161901.mail.bf1.yahoo.com> References: <1332985539.87406.YahooMailNeo@web161901.mail.bf1.yahoo.com> <80hax7bzpk.fsf@somewhere.org> Reply-To: Michael Hannon Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([208.118.235.92]:46177) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SDHcT-0002sC-OL for emacs-orgmode@gnu.org; Thu, 29 Mar 2012 11:50:43 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SDHcN-0003RL-Ed for emacs-orgmode@gnu.org; Thu, 29 Mar 2012 11:50:37 -0400 Received: from nm27-vm0.bullet.mail.bf1.yahoo.com ([98.139.213.139]:23865) by eggs.gnu.org with smtp (Exim 4.71) (envelope-from ) id 1SDHcN-0003RB-74 for emacs-orgmode@gnu.org; Thu, 29 Mar 2012 11:50:31 -0400 In-Reply-To: <80hax7bzpk.fsf@somewhere.org> List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Sebastien Vauban , "emacs-orgmode@gnu.org" On Thursday, March 29, 2012 at 1:04 AM Sebastien Vauban wrote:=0A=0A> Micha= el Hannon wrote:=0A>> Greetings.=A0 I just ran across an article about Doxy= gen [1], and I'm=0A>> trying to=0A>=0A> Forgotten footnote?=0A=0AHi, Seb.= =A0 Yep, the footnote appears in my draft message but not in the final=0Ame= ssage.=A0 Don't know what happened.=A0 I'm sure this isn't a mystery to any= body,=0Abut here's the reference:=0A=0A=A0=A0=A0 [1] http://www.doxygen.org= /=0A=0A>> understand if there's any intersection between Doxygen/Roxygen an= d Org mode=0A>> Babel, both of which seem to have literate programming as a= goal.=A0 Any=0A>> thoughts about this?=A0 Thanks.=0A>=0A> It just is compl= etely different: with Babel, you put code blocks inside=0A> documentation t= o be read by a human.=0A>=0A> With Doxygen and the like, you put special co= mments (for generating doc)=0A> inside your code. That's the opposite!=0A>= =0A> You could view it as more or less equal, but it's not. LP allows you t= o make=0A> a documentation, and spread code blocks in any order inside it, = in the order=0A> which make more sense for the user to understand your stra= tegy, method, etc.=0A>=0A> LP allows you also to write a block of code once= , and reuse it (even with=0A> parameters) in multiple places, avoiding copy= /pasted code for languages=0A> where such a thing is sometimes difficult to= avoid (SQL, Makefile, etc.), or=0A> where avoiding it would make the code = even much more complex.=0A>=0A> These two last arguments are simply not app= licable for Doxygen.=0A=0AThanks, this all makes good sense to me.=A0 I gue= ss I was basically wondering if=0Apeople were routinely using some combinat= ion of Doxygen and Org mode -- maybe=0Aincluding Doxygen markup inside the = Org file, then running doxygen on the=0Atangled output or ...=A0 This is ev= idently not a common/useful way of working.=0A=0A-- Mike