From mboxrd@z Thu Jan 1 00:00:00 1970 From: =?utf-8?Q?Fran=C3=A7ois_Pinard?= Subject: Re: Seeking advice for conditional code Date: Thu, 31 Jan 2013 21:25:58 -0500 Message-ID: <86a9rou5vt.fsf@iro.umontreal.ca> References: <86lib96zzl.fsf@iro.umontreal.ca> <86halx3w0f.fsf@somewhere.org> <868v796m3u.fsf@iro.umontreal.ca> <86d2wl3qsj.fsf@somewhere.org> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([208.118.235.92]:44282) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U16KH-0001b8-PB for emacs-orgmode@gnu.org; Thu, 31 Jan 2013 21:26:02 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1U16KG-0004Pi-Rw for emacs-orgmode@gnu.org; Thu, 31 Jan 2013 21:26:01 -0500 Received: from 206-248-137-202.dsl.teksavvy.com ([206.248.137.202]:50160 helo=mercure.bureau.ubity.com) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1U16KG-0004PB-Mh for emacs-orgmode@gnu.org; Thu, 31 Jan 2013 21:26:00 -0500 In-Reply-To: <86d2wl3qsj.fsf@somewhere.org> (Sebastien Vauban's message of "Thu, 31 Jan 2013 23:56:28 +0100") 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: emacs-orgmode@gnu.org "Sebastien Vauban" > For curiosity, why aren't you considering tangling? Quick half of a reply, I'll revise the rest of your message later. That would be far too much of a change for the habits of the team, or at least, this is how I perceive the equilibrium between developers. Moreover, some of us are not even Emacs users. When writing a program, the feeling still has to be that we write a program, rather than a document describing the program, and from which the program could be extracted. Python is rather descriptive as a language, and while comments are useful, they might be less needed than in other languages. This is debatable, of course :-). The documentation is meant for users, and it was strongly suggested that we try to keep the documentation within the program as much as possible, as a way to ease keeping the documentation and the program in good sync. Some of us really enjoy Org mode, and this is how came the idea of this compromise of writing Python doc-strings using Org. Fran=C3=A7ois