From owner-freebsd-pkg@FreeBSD.ORG  Sun Sep 21 21:18:10 2014
Return-Path: <owner-freebsd-pkg@FreeBSD.ORG>
Delivered-To: pkg@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id B3C5A222;
 Sun, 21 Sep 2014 21:18:10 +0000 (UTC)
Received: from mail-la0-x229.google.com (mail-la0-x229.google.com
 [IPv6:2a00:1450:4010:c03::229])
 (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits))
 (Client CN "smtp.gmail.com",
 Issuer "Google Internet Authority G2" (verified OK))
 by mx1.freebsd.org (Postfix) with ESMTPS id 0F76BA87;
 Sun, 21 Sep 2014 21:18:09 +0000 (UTC)
Received: by mail-la0-f41.google.com with SMTP id s18so5691266lam.0
 for <multiple recipients>; Sun, 21 Sep 2014 14:18:08 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113;
 h=mime-version:sender:in-reply-to:references:date:message-id:subject
 :from:to:cc:content-type;
 bh=qIoxNp/O2tX4KQaaoF59Cz4jEyXMrFy6phkpp6ITMlw=;
 b=nss4d5NkquPLtHnaXIEWJOkvNUlqz01AgBmNA5nPNoJvVU03RN6gwxjVUqnyHBJfPk
 4hbjvIPyzf1LLj5PLzf4PArmE109yZExDZRFz8LzHyShMm2+xNRwu50vpkds6q7OIRaN
 akh9JfBiLMuI756b0Fn0F7ro9DSUAVHFarUGiHrpEySYGuckIoa7pFupfgNtJGXolykR
 00CNV7EKm71NX1o6kbGasJPJbL70XGpnnJsF8c+IjZHjZ0Br50J5Amo2YsfNLRQ4qgob
 12Dpba0ikOICTRpEW9w5TEqhffrPIdap3T2TwIwYfwVuJerM+M6NZTB510lOTWegLHzz
 FJTA==
MIME-Version: 1.0
X-Received: by 10.152.116.44 with SMTP id jt12mr19964540lab.7.1411334288102;
 Sun, 21 Sep 2014 14:18:08 -0700 (PDT)
Sender: crodr001@gmail.com
Received: by 10.112.197.107 with HTTP; Sun, 21 Sep 2014 14:18:08 -0700 (PDT)
In-Reply-To: <541B4876.4060709@FreeBSD.org>
References: <54194AA9.8070604@volny.cz> <541B3EBC.6000303@FreeBSD.org>
 <CAG=rPVd4JbOTpHQtEO18qGD+aFAzZh497Q7YD3i85qpepX=dRg@mail.gmail.com>
 <541B4876.4060709@FreeBSD.org>
Date: Sun, 21 Sep 2014 14:18:08 -0700
X-Google-Sender-Auth: L1ITnnYBJRS-CT4RWj-ImItWCMA
Message-ID: <CAG=rPVfcXdffP7c0i6eir--KhWXfMXNhFFpHArs3KYSGjhibwg@mail.gmail.com>
Subject: Re: Registering installation for dialog4ports-0.1.5_2, *** [fake-pkg]
 Error code 74
From: Craig Rodrigues <rodrigc@freebsd.org>
To: Bryan Drewery <bdrewery@freebsd.org>
Content-Type: text/plain; charset=ISO-8859-1
X-Content-Filtered-By: Mailman/MimeDel 2.1.18-1
Cc: =?UTF-8?B?VsOhY2xhdiBIb8WhZWs=?= <vaclavhosek@volny.cz>,
 pkg <pkg@freebsd.org>
X-BeenThere: freebsd-pkg@freebsd.org
X-Mailman-Version: 2.1.18-1
Precedence: list
List-Id: Binary package management and package tools discussion
 <freebsd-pkg.freebsd.org>
List-Unsubscribe: <https://lists.freebsd.org/mailman/options/freebsd-pkg>,
 <mailto:freebsd-pkg-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-pkg/>
List-Post: <mailto:freebsd-pkg@freebsd.org>
List-Help: <mailto:freebsd-pkg-request@freebsd.org?subject=help>
List-Subscribe: <https://lists.freebsd.org/mailman/listinfo/freebsd-pkg>,
 <mailto:freebsd-pkg-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Sun, 21 Sep 2014 21:18:10 -0000

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