Path: csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!gegeweb.org!de-l.enfer-du-nord.net!feeder2.enfer-du-nord.net!feeder.news-service.com!news2.euro.net!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path: <rosuav@gmail.com>
X-Original-To: python-list@python.org
Delivered-To: python-list@mail.python.org
X-Spam-Status: OK 0.031
X-Spam-Evidence: '*H*': 0.94; '*S*': 0.00; 'python': 0.08; 'imho.': 0.09; 'received:209.85.160.174': 0.09; 'received:mail- gy0-f174.google.com': 0.09; 'api': 0.09; 'am,': 0.12; 'docs.': 0.16; 'from:addr:rosuav': 0.16; 'from:name:chris angelico': 0.16; 'wrote:': 0.16; 'language': 0.17; 'functions,': 0.18; 'header:In- Reply-To:1': 0.22; 'sep': 0.23; '(in': 0.26; 'function': 0.27; 'sat,': 0.28; 'message-id:@mail.gmail.com': 0.29; 'fairly': 0.30; "it'd": 0.30; 'to:addr:python-list': 0.33; 'calling': 0.33; 'received:209.85.160': 0.35; 'languages': 0.37; 'but': 0.37; 'could': 0.38; 'steven': 0.38; 'received:google.com': 0.38; 'received:209.85': 0.38; 'subject:: ': 0.39; 'to:addr:python.org': 0.39; "it's": 0.40; 'link': 0.63; 'man': 0.65; 'chain': 0.66; 'high': 0.67; 'online': 0.71; 'concerns': 0.80; '11:25': 0.84; 'limitations.': 0.84
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type:content-transfer-encoding; bh=xoPGra/CLflDg5hI2JLY5433417YY+mWEcs9PZZ1IGI=; b=HwegWTgt3jJhjKNePQf91gdkellX8zc6MyN2XbZKziX6ipqD6JxQEyzkBkYdEwfcCj mT8nPoMqb0gi5YHSABiQDbugpKEGkVbw2qfQAVR/B6Gigd/MIA8bx9YMPL0W89oMCYoF 1uSORNmRksc2pjsFEv8S/DGSFcA2eidwEWqUw=
MIME-Version: 1.0
In-Reply-To: <4e6abc95$0$29995$c3e8da3$5496439d@news.astraweb.com>
References: <4e6a0382$0$29982$c3e8da3$5496439d@news.astraweb.com> <mailman.917.1315607348.27778.python-list@python.org> <4e6abc95$0$29995$c3e8da3$5496439d@news.astraweb.com>
Date: Sat, 10 Sep 2011 11:37:53 +1000
Subject: Re: killing a script
From: Chris Angelico <rosuav@gmail.com>
To: python-list@python.org
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: quoted-printable
X-BeenThere: python-list@python.org
X-Mailman-Version: 2.1.12
Precedence: list
List-Id: General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe: <http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive: <http://mail.python.org/pipermail/python-list>
List-Post: <mailto:python-list@python.org>
List-Help: <mailto:python-list-request@python.org?subject=help>
List-Subscribe: <http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups: comp.lang.python
Message-ID: <mailman.923.1315618676.27778.python-list@python.org>
Lines: 21
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1315618676 news.xs4all.nl 2490 [2001:888:2000:d::a6]:45882
X-Complaints-To: abuse@xs4all.nl
Xref: x330-a1.tempe.blueboxinc.net comp.lang.python:13046

On Sat, Sep 10, 2011 at 11:25 AM, Steven D'Aprano
<steve+comp.lang.python@pearwood.info> wrote:
>> =A0 This is implemented by calling the Standard C function system(), and
>> =A0 has the same limitations.
>>
>> and sure enough, "man 3 system" says:
>
> I don't consider having to look up documentation for a function in a
> completely different language (in this case, C) as "documented behaviour =
of
> os.system".
>

The Python docs chain to the C docs. It'd be nice to have a link
somewhere, but that's platform-dependent - the online docs could link
to an online man page, but local docs can't, etc. It's fairly normal
for high level languages to expose a lot of C API functions, with all
the concerns and features given. Not a lot of point bloating the
Python docs with every little detail, imho.

ChrisA