Date: Sun, 21 Sep 2014 14:18:08 -0700 From: Craig Rodrigues <rodrigc@freebsd.org> To: Bryan Drewery <bdrewery@freebsd.org> Cc: =?UTF-8?B?VsOhY2xhdiBIb8WhZWs=?= <vaclavhosek@volny.cz>, pkg <pkg@freebsd.org> Subject: Re: Registering installation for dialog4ports-0.1.5_2, *** [fake-pkg] Error code 74 Message-ID: <CAG=rPVfcXdffP7c0i6eir--KhWXfMXNhFFpHArs3KYSGjhibwg@mail.gmail.com> In-Reply-To: <541B4876.4060709@FreeBSD.org> References: <54194AA9.8070604@volny.cz> <541B3EBC.6000303@FreeBSD.org> <CAG=rPVd4JbOTpHQtEO18qGD%2BaFAzZh497Q7YD3i85qpepX=dRg@mail.gmail.com> <541B4876.4060709@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Thu, Sep 18, 2014 at 2:02 PM, Bryan Drewery <bdrewery@freebsd.org> wrote:
> On 9/18/2014 3:58 PM, Craig Rodrigues wrote:
> >
> >
> > On Thu, Sep 18, 2014 at 1:21 PM, Bryan Drewery <bdrewery@freebsd.org
> > <mailto:bdrewery@freebsd.org>> wrote:
> >
> >
> > Run 'pkg bootstrap -f' or upgrade from ports-mgmt/pkg.
> >
> >
> > In pkg 1.3.7, "man pkg" documents 'pkg bootstrap', but "pkg help" does
> not.
> > Should it?
> >
> > --
> > Craig
>
> IMHO pkg help needs 50% of the output removed. It is too long.
>
There are two separate issues here.
(1) pkg help is missing documentation about bootstrap
-> "man pkg" documents bootstrap, but "pkg help" does not. This
is a bug.
(2) pkg help output is too long
-> You can't escape the fact that pkg is growing and has a lot of
features.
Consistently documenting them is important.
-> Maybe pkg can follow the example of git.
If you type "git help", it only lists a subset of the 'most
popular' commands.
"git help -a" lists all the commands
--
Craig
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAG=rPVfcXdffP7c0i6eir--KhWXfMXNhFFpHArs3KYSGjhibwg>