From owner-freebsd-doc@FreeBSD.ORG  Fri Nov 16 18:42:04 2012
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
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 3154FCC2;
 Fri, 16 Nov 2012 18:42:04 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 by mx1.freebsd.org (Postfix) with ESMTP id DA0B78FC08;
 Fri, 16 Nov 2012 18:42:03 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.5/8.14.5) with ESMTP id qAGIg3sA077069;
 Fri, 16 Nov 2012 11:42:03 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.5/8.14.5/Submit) with ESMTP id qAGIg3r4077066;
 Fri, 16 Nov 2012 11:42:03 -0700 (MST)
 (envelope-from wblock@wonkity.com)
Date: Fri, 16 Nov 2012 11:42:03 -0700 (MST)
From: Warren Block <wblock@wonkity.com>
To: Glen Barber <gjb@FreeBSD.org>
Subject: Re: Request for Review: pkgng documentation for the Handbook
In-Reply-To: <20121116174813.GF1335@glenbarber.us>
Message-ID: <alpine.BSF.2.00.1211161133410.76158@wonkity.com>
References: <20121116165810.GC1335@glenbarber.us>
 <alpine.BSF.2.00.1211161012590.76158@wonkity.com>
 <20121116174813.GF1335@glenbarber.us>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.2.7
 (wonkity.com [127.0.0.1]); Fri, 16 Nov 2012 11:42:03 -0700 (MST)
Cc: freebsd-doc@FreeBSD.org
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Fri, 16 Nov 2012 18:42:04 -0000

On Fri, 16 Nov 2012, Glen Barber wrote:

>> "Getting Started with pkgng"
>> Markup on bootstrap should be <quote> tags.
>>
>
> Hmm.  I didn't think <quote> tags actually worked.

They didn't for a while.  I'm not sure about now, but thought that was 
fixed.

>> "Existing FreeBSD installations require conversion of the pkg_install
>> package database"
>> pkg_install should be a man page ref.
>
> There actually is no pkg_install manual page.

Doh.  My thinking is that having the link would help the reader see what 
the old package tools did to compare with the new.  It also would look 
different from the rendering of <command>.  In other words, show the 
commands the reader will use with <command>, and the old pkg_ commands 
as man page refs.

>> "Configuring the pkgng Environment" is kind of confusing, and could be
>> simplified.  Is it necessary to mention the environment variable at all?
>>
>>    The pkgng package management system uses a package repository for most
>>    operations.  The default package repository location is
>>    defined in /usr/local/etc/pkg.conf or the PACKAGESITE environment
>>    variable which overrides the configuration file.
>>
>
> Looks good to me.  Thanks.

It would be better without the environment variable, just end the 
sentence before "or".