Path: csiph.com!fu-berlin.de!uni-berlin.de!not-for-mail
From: Random832 <random832@fastmail.com>
Newsgroups: comp.lang.python
Subject: Re: What should Python apps do when asked to show help?
Date: Thu, 28 Apr 2016 15:51:25 -0400
Lines: 12
Message-ID: <mailman.212.1461873088.32212.python-list@python.org>
References: <57223b76$0$22140$c3e8da3$5496439d@news.astraweb.com> <nfthhs$klf$1@ger.gmane.org> <1461865210.3218352.592571425.2069E4EB@webmail.messagingengine.com> <nftjuh$t2b$1@ger.gmane.org> <mailman.207.1461867295.32212.python-list@python.org> <87a8kdshyh.fsf@elektro.pacujo.net> <nftot6$4ii$2@ger.gmane.org> <1461873085.3251720.592695601.44633E5E@webmail.messagingengine.com>
Mime-Version: 1.0
Content-Type: text/plain
Content-Transfer-Encoding: 7bit
X-Trace: news.uni-berlin.de 6Q6BTClBdNcipN7t2Cnr4QMxYw+FtxxzR0e/3bAbCRrA==
Return-Path: <random832@fastmail.com>
X-Original-To: python-list@python.org
Delivered-To: python-list@mail.python.org
X-Spam-Status: OK 0.002
X-Spam-Evidence: '*H*': 1.00; '*S*': 0.00; 'subject:Python': 0.05; 'subject:help': 0.07; 'implies': 0.09; 'received:internal': 0.09; 'output': 0.13; 'thu,': 0.15; '"see': 0.16; '"to': 0.16; '(given': 0.16; 'message-id:@webmail.messagingengine.com': 0.16; 'received:10.202': 0.16; 'received:10.202.2': 0.16; 'received:66.111': 0.16; 'received:66.111.4': 0.16; 'received:io': 0.16; 'received:messagingengine.com': 0.16; 'received:psf.io': 0.16; 'subject:show': 0.16; 'subject:when': 0.16; 'wrote:': 0.16; 'header:In-Reply-To:1': 0.24; "doesn't": 0.26; '(which': 0.26; 'option': 0.31; 'run': 0.33; 'point': 0.33; 'that,': 0.34; 'instead': 0.36; 'to:addr:python-list': 0.36; 'subject:?': 0.36; 'subject:: ': 0.37; 'received:10': 0.37; 'two': 0.37; 'display': 0.37; 'received:66': 0.38; 'to:addr:python.org': 0.40; 'some': 0.40; 'header:Message-Id:1': 0.61; 'default': 0.61; 'choose': 0.68; 'compose': 0.84; 'edwards': 0.91
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d=fastmail.com; h= content-transfer-encoding:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-sasl-enc :x-sasl-enc; s=mesmtp; bh=8h7YCqVNt6dDGe8GowsVxI16PmY=; b=zFHqIe pLIWGJLA50ZOuPO50HH07Vt1ZUyhfbesheJphL9thW0qemMNX9A0AzABG/FEX0uX RjXHLV/lwBNviz91LQqMiahQK1WzzBKuyTxAMGlbQRpI6CMJk0KMkB1LSn/JQ43b oOiFOGQE+Rxz9lVviW/Oa2VWo7eWjPnmsW28A=
DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d= messagingengine.com; h=content-transfer-encoding:content-type :date:from:in-reply-to:message-id:mime-version:references :subject:to:x-sasl-enc:x-sasl-enc; s=smtpout; bh=8h7YCqVNt6dDGe8 GowsVxI16PmY=; b=HY4BBm+xgCLlgdwrvcQr25Uo6AuEwpKe4G6iELJks5SPFZe aX4GgBaHjQvpEsDWc3nakWGzPp08DL8vX4ANALhzdIyIY9v7Dip0SxLwEQBjd55S 8mKEhRC5UyUWRi4TMq+UpI7X78a8u71A8hgK0TSLWsMBvKVY6sUemVg99cvU=
X-Sasl-Enc: oOaYVkzpzXO6rpQ1XrPBpuFwxhwig6S6DhALW8i70xh0 1461873085
X-Mailer: MessagingEngine.com Webmail Interface - ajax-f1265324
In-Reply-To: <nftot6$4ii$2@ger.gmane.org>
X-BeenThere: python-list@python.org
X-Mailman-Version: 2.1.22
Precedence: list
List-Id: General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe: <https://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: <https://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
X-Mailman-Original-Message-ID: <1461873085.3251720.592695601.44633E5E@webmail.messagingengine.com>
X-Mailman-Original-References: <57223b76$0$22140$c3e8da3$5496439d@news.astraweb.com> <nfthhs$klf$1@ger.gmane.org> <1461865210.3218352.592571425.2069E4EB@webmail.messagingengine.com> <nftjuh$t2b$1@ger.gmane.org> <mailman.207.1461867295.32212.python-list@python.org> <87a8kdshyh.fsf@elektro.pacujo.net> <nftot6$4ii$2@ger.gmane.org>
Xref: csiph.com comp.lang.python:107827

On Thu, Apr 28, 2016, at 15:39, Grant Edwards wrote:
> That's fine.  If you want two or three forms of documentation then you
> prepare two or three forms of documentation.
> 
> Adding an option to run the default 'help' output through a pager or
> display it in a web browser doesn't somehow force you "to compose two
> forms of documentation" unless you want two forms of documentation.

The point is that having "help" output at all (beyond either a cursory
"see the manpage") implies two forms of documentation (given you already
have a manpage), and some people choose not to do that, instead
launching directly into the manpage (which implies using a pager)