From mboxrd@z Thu Jan 1 00:00:00 1970 From: Daniele Pizzolli Subject: Re: Division of Org documentation: Org manual and Worg Date: Wed, 18 May 2016 10:10:02 +0200 Message-ID: <874m9vzzzzu6qt@me.localhost.invalid> References: <2016-05-08T10-21-00@devnull.Karl-Voit.at> <2016-05-17T16-45-38@devnull.Karl-Voit.at> <2016-05-18T09-06-50@devnull.Karl-Voit.at> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:57355) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2wYa-0007Ob-BY for emacs-orgmode@gnu.org; Wed, 18 May 2016 04:10:17 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b2wYT-0007DK-Gk for emacs-orgmode@gnu.org; Wed, 18 May 2016 04:10:15 -0400 Received: from relay3-d.mail.gandi.net ([217.70.183.195]:43541) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b2wYT-0007Ce-A9 for emacs-orgmode@gnu.org; Wed, 18 May 2016 04:10:09 -0400 Received: from mfilter34-d.gandi.net (mfilter34-d.gandi.net [217.70.178.165]) by relay3-d.mail.gandi.net (Postfix) with ESMTP id C2291A80D8 for ; Wed, 18 May 2016 10:10:06 +0200 (CEST) Received: from relay3-d.mail.gandi.net ([IPv6:::ffff:217.70.183.195]) by mfilter34-d.gandi.net (mfilter34-d.gandi.net [::ffff:10.0.15.180]) (amavisd-new, port 10024) with ESMTP id DMgCph_s-X0m for ; Wed, 18 May 2016 10:10:04 +0200 (CEST) Received: from localhost.invalid (outusers6.fbk.eu [217.77.82.229]) (Authenticated sender: me@toel.it) by relay3-d.mail.gandi.net (Postfix) with ESMTPSA id 44BDAA80DF for ; Wed, 18 May 2016 10:10:03 +0200 (CEST) In-Reply-To: <2016-05-18T09-06-50@devnull.Karl-Voit.at> (Karl Voit's message of "Wed, 18 May 2016 09:10:01 +0200") 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" To: emacs-orgmode@gnu.org On Wed, May 18 2016, Karl Voit wrote: > Good morning William, > > * William Henney wrote: >> >> On Tue, May 17, 2016 at 9:54 AM, Karl Voit wrote: >> >>> * William Henney wrote: >>> > >>> > #+BEGIN_SRC python :python /Users/will/anaconda/envs/py27/bin/python >>> >>> Is this undocumented? http://orgmode.org/org.html does not contain >>> the string ":python:" and >>> http://orgmode.org/org.html#Language_002dspecific-header-arguments >>> also does not mention this parameter. >>> >> It is documented at >> http://orgmode.org/worg/org-contrib/babel/languages/ob-doc-python.html >> >> You are right that it would be better if the language-specific babel >> documentation were better integrated in the general org info file. But I >> suppose nobody has been sufficiently motivated to do it yet > > That brings me to an additional question I was asking myself a > couple of times: things like this, IMHO basic features, are > sometimes mentioned in Worg but not in the Org manual. Is there a > =C2=ABrule=C2=BB that I can follow so that I know where to look? > > So far, I had to do full text search on both domains to find certain > keywords... Hello, Me too, and this is really a problem when you try do unusual stuff. I will share some problems and workaround for python in a new thread. It would be nice to add them to the documentation, but I have not yet figured out what is the appropriate way to send the patch! Best, Daniele