From owner-freebsd-doc@FreeBSD.ORG Fri Nov 16 17:07:52 2012 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id C6C32FB8 for ; Fri, 16 Nov 2012 17:07:52 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-la0-f54.google.com (mail-la0-f54.google.com [209.85.215.54]) by mx1.freebsd.org (Postfix) with ESMTP id 32CB28FC0C for ; Fri, 16 Nov 2012 17:07:51 +0000 (UTC) Received: by mail-la0-f54.google.com with SMTP id j13so2837179lah.13 for ; Fri, 16 Nov 2012 09:07:50 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=WUmkEbfjD4HFYm4EyASGDHXGM/kV3q3vlU4l1I6EIcs=; b=WBMgl9LjKQ4lOVbFCWY6zk1XdNEv34BLSaInea9o6ZTEtBAnU51n5tcVFK3Pynn+CP E0obb6NdQm72I1QCI9D7wlyBeRWmOjl3tyE62sam7ijTi6GjGC+iFfocfDka3Y66+/UW GHJMqbCbSY7C2VvPmvgevO/M5GqBcU+FAz51Y= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20120113; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type:x-gm-message-state; bh=WUmkEbfjD4HFYm4EyASGDHXGM/kV3q3vlU4l1I6EIcs=; b=V2cvskj0mKZfrPoczCit0e6up26PdWv8+EOg7gj16k8ih2j/WcQG9GtT7j9yLkRJhS 3UHFrkG+M9VQkqz3DOiMIjsjhQnCEXSK7N0duphz/oRHBr0QVazmlHDNFvej6NOO7jKj h9FNHQJHkiZ25U8JlWy+jo/2kL4xTZBx+laof/2JaZTx5ssRvM9WAwoHgbnYsPiaZAKQ jSrwurzJmBTH5CrcMFHUSkifi67VTXoMhtfhSk+a2w1ggwqfEzNXSpLdtddyiIUpGf00 Jyf/LjkQhZOUXUqZ+XNg/Pudj3KVeHzaTHBRK2E1XlOJW+Av4ezdtEqXs5B9gTMnlo5p ZOTg== Received: by 10.152.104.148 with SMTP id ge20mr4729133lab.51.1353085670189; Fri, 16 Nov 2012 09:07:50 -0800 (PST) MIME-Version: 1.0 Received: by 10.112.25.166 with HTTP; Fri, 16 Nov 2012 09:07:19 -0800 (PST) In-Reply-To: <20121116165810.GC1335@glenbarber.us> References: <20121116165810.GC1335@glenbarber.us> From: Eitan Adler Date: Fri, 16 Nov 2012 12:07:19 -0500 Message-ID: Subject: Re: Request for Review: pkgng documentation for the Handbook To: Glen Barber Content-Type: text/plain; charset=UTF-8 X-Gm-Message-State: ALoCoQkEo9iAxTSIreczd3fwQYBcxtJiZi2HDho0YIVnPVM4f2v5ziwFch6jURagysrA1mr+nXQv Cc: freebsd-doc@freebsd.org X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 16 Nov 2012 17:07:52 -0000 On 16 November 2012 11:58, Glen Barber wrote: > Hi, > > I would like to get feedback on recent commits to the projects/pkgng/ > branch, which adds documentation for pkgng to the Handbook. > > There are a few sections on my todo list, but I feel what is there now > covers the basics for FreeBSD users. > > The diff is attached, and rendered output is here: > > http://people.freebsd.org/~gjb/pkgng/data/doc/en/books/handbook/pkgng-intro.html > > I would like to merge this into head/ when 9.1-RELEASE is announced. a few comments. 5.5.1 - please make it clear that this step is not revertible once pkg has been used to manipulate the database. 5.5.3.4 - is "pkg audit -F" required to update the audit database as well or it only needed the first time? 5.5.4.4 - thanks for calling attention to the difference between portmaster and pkg in the order of arguments -- Eitan Adler