Re: New help section 'Global Options'?
From: Julian Foad <julianfoad_at_btopenworld.com>
Date: Mon, 7 Jul 2014 11:30:15 +0100
Ben Reser wrote:
As it is, without the pager, I find it poor. The help section describing global options is long and irrelevant to a large proportion of use cases. I don't feel terribly strongly about it for my own sake -- I always use a terminal with a fairly large number of visible lines and a large scroll-back capacity -- but I think it's poor form to display all this minority-interest text right in front of every user's face every time.
Notice that half of this text is about authentication, and is displayed even for the commands that can't do authentication such as 'svn add'!
I think Subversion would be better if changed the way we show it.
> Once we have the automatic pager it'll be inconvenient to flip from one help
The point is we think people don't often need or want to flip from the help on 'svn add' to the help on supplying a password or any of the other global options. Or even from 'svn commit'. Anyway, we don't have the automatic pager, and when we do, it isn't going to be mandatory, is it? The help output in pager mode can list the global options in full if we want.
> There's also been some discussion about making the man pages be generated from
Yup, but we don't have that either, and that doesn't detract from this suggestion either, as the man page for a subcommand doesn't have to be generated as a straight dump of the corresponding help output: it could have all the global options explained in full if we want.
This is an archived mail posted to the Subversion Dev mailing list.