Path: csiph.com!fu-berlin.de!uni-berlin.de!not-for-mail
From: Ethan Furman <ethan@stoneleaf.us>
Newsgroups: comp.lang.python
Subject: Re: What should Python apps do when asked to show help?
Date: Fri, 29 Apr 2016 19:09:13 -0700
Lines: 47
Message-ID: <mailman.243.1461982076.32212.python-list@python.org>
References: <57223b76$0$22140$c3e8da3$5496439d@news.astraweb.com> <877ffhgnyf.fsf@nightsong.com> <0d5b5562-7a08-41de-8b84-a13f0792e767@googlegroups.com> <57232b34$0$1595$c3e8da3$5496439d@news.astraweb.com> <72444f12-784b-47b4-a80c-0ae53cf3b5a3@googlegroups.com> <57240856$0$1590$c3e8da3$5496439d@news.astraweb.com> <572413C9.2070405@stoneleaf.us>
Mime-Version: 1.0
Content-Type: text/plain; charset=windows-1252; format=flowed
Content-Transfer-Encoding: 7bit
X-Trace: news.uni-berlin.de h2MulybGKJP0pQ7KduFSQg1gMqzkXV1hvc+tOsUkT1tQ==
Return-Path: <ethan@stoneleaf.us>
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; 'advice.': 0.09; 'from:addr:ethan': 0.09; 'from:addr:stoneleaf.us': 0.09; 'from:name:ethan furman': 0.09; 'git': 0.09; 'message-id:@stoneleaf.us': 0.09; 'output': 0.13; '-- help': 0.16; '2016': 0.16; 'bad;': 0.16; 'received:io': 0.16; 'received:psf.io': 0.16; 'subject:show': 0.16; 'subject:when': 0.16; 'wrote:': 0.16; 'linux,': 0.18; 'shell': 0.18; 'variable': 0.18; 'preferred': 0.20; 'code,': 0.23; 'fit': 0.23; 'seems': 0.23; "python's": 0.23; 'unix': 0.24; 'header:In-Reply-To:1': 0.24; "i've": 0.25; 'header:User-Agent:1': 0.26; 'point.': 0.27; 'fri,': 0.27; 'not.': 0.27; 'tired': 0.27; 'figured': 0.29; 'prints': 0.29; '~ethan~': 0.29; 'environment': 0.29; "i'm": 0.30; 'that.': 0.30; 'work.': 0.30; 'source': 0.33; "d'aprano": 0.33; 'steven': 0.33; 'advice': 0.35; 'but': 0.36; 'should': 0.36; 'to:addr:python-list': 0.36; 'subject:?': 0.36; 'pm,': 0.36; 'subject:: ': 0.37; 'setting': 0.37; 'itself': 0.38; 'to:addr:python.org': 0.40; 'your': 0.60; 'behavior': 0.61; 'no.': 0.62; 'charset:windows-1252': 0.62; 'feeling': 0.72; 'actually,': 0.84; 'cripple': 0.84; 'presumably': 0.84; 'standard:': 0.91
User-Agent: Mozilla/5.0 (X11; Linux i686; rv:31.0) Gecko/20100101 Thunderbird/31.2.0
In-Reply-To: <57240856$0$1590$c3e8da3$5496439d@news.astraweb.com>
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: <572413C9.2070405@stoneleaf.us>
X-Mailman-Original-References: <57223b76$0$22140$c3e8da3$5496439d@news.astraweb.com> <877ffhgnyf.fsf@nightsong.com> <0d5b5562-7a08-41de-8b84-a13f0792e767@googlegroups.com> <57232b34$0$1595$c3e8da3$5496439d@news.astraweb.com> <72444f12-784b-47b4-a80c-0ae53cf3b5a3@googlegroups.com> <57240856$0$1590$c3e8da3$5496439d@news.astraweb.com>
Xref: csiph.com comp.lang.python:107886

On 04/29/2016 06:20 PM, Steven D'Aprano wrote:
> On Fri, 29 Apr 2016 07:53 pm, Rustom Mody wrote:


>> JFTR I find git behavior annoying -- as it seems do others
>
> `git --help` behaves as the Unix standard: it prints help output to stdout.
> Is that the annoying behaviour?

No.

> `git help <command>` and `git <command> --help` call `man`. Is that the
> annoying behaviour?

Yes.

> Then presumably `man` is also annoying,

No.

> and the advise I was given to just  use man pages is bad advice.

The advice to call man from --help is bad; the advice to have a man page 
for use with man is not.

>> With python's help I find it annoying and Ive not figured out how to not
>> get paging
>
> o_O
>
> Okay, now I'm feeling as if you had said "I find it annoying to be fit and
> healthy, I've not found a way to feel sufficiently sick, tired and
> out-of-shape all the time."

And exactly what is healthy and fit about calling "help(something)" and 
then having that help disappear?  I find that *extremely* annoying.

> But I see your point. The pydoc documentation itself is lacking. But from
> reading the source code, I see that if you set the PAGER environment
> variable to your preferred pager, it will use that. So setting it to "cat"
> should work. I've just tested this under Linux, and it works for me:

So I have to cripple my shell to get pydoc help to work nicely?  Neat! 
Actually, not so much.  :(

--
~Ethan~