From owner-freebsd-doc@FreeBSD.ORG Fri Nov 16 19:34:13 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 D04156A7; Fri, 16 Nov 2012 19:34:13 +0000 (UTC) (envelope-from gjb@FreeBSD.org) Received: from onyx.glenbarber.us (onyx.glenbarber.us [IPv6:2607:fc50:1000:c200::face]) by mx1.freebsd.org (Postfix) with ESMTP id 93C7D8FC08; Fri, 16 Nov 2012 19:34:13 +0000 (UTC) Received: from glenbarber.us (75-146-225-65-Philadelphia.hfc.comcastbusiness.net [75.146.225.65]) (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits)) (No client certificate requested) (Authenticated sender: gjb) by onyx.glenbarber.us (Postfix) with ESMTPSA id B859023F6D8; Fri, 16 Nov 2012 14:34:11 -0500 (EST) Date: Fri, 16 Nov 2012 14:34:09 -0500 From: Glen Barber To: Warren Block Subject: Re: Request for Review: pkgng documentation for the Handbook Message-ID: <20121116193409.GG1335@glenbarber.us> References: <20121116165810.GC1335@glenbarber.us> <20121116174813.GF1335@glenbarber.us> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha256; protocol="application/pgp-signature"; boundary="e5bfZ/T2xnjpUIbw" Content-Disposition: inline In-Reply-To: X-Operating-System: FreeBSD 10.0-CURRENT amd64 User-Agent: Mutt/1.5.21 (2010-09-15) 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 19:34:14 -0000 --e5bfZ/T2xnjpUIbw Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Fri, Nov 16, 2012 at 11:42:03AM -0700, Warren Block wrote: > >> "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. >=20 > Doh. My thinking is that having the link would help the reader see what= =20 > the old package tools did to compare with the new. It also would look=20 > different from the rendering of . In other words, show the=20 > commands the reader will use with , and the old pkg_ commands=20 > as man page refs. >=20 Ah, I see what you mean. I'll make some tweaks for this. > >> "Configuring the pkgng Environment" is kind of confusing, and could be > >> simplified. Is it necessary to mention the environment variable at al= l? > >> > >> The pkgng package management system uses a package repository for m= ost > >> 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. >=20 > It would be better without the environment variable, just end the=20 > sentence before "or". Personally, I feel PACKAGESITE should be mentioned as an environment variable, because pkg_* users that expect that to work should know that it does. Glen --e5bfZ/T2xnjpUIbw Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.19 (FreeBSD) iQEcBAEBCAAGBQJQppUxAAoJEFJPDDeguUajYSAIAJKl7TbB5n5nDJwllgigtv2p PB5pxKHm909hkQVl3vKbV/BW1XaZmqMBwYJPvXH7DEFkrcE87Zgq9csBMrs+OkPy JzOSH0Lw9b4qBaaL0dvxc/E+WpCtpkjs10raXSeRTj53VWDd5+YUgO3o3CZDgz7A a9mWYmsOburhvAYYy5inmFmpot7j1xnFKi+BiTlgnBZhGD7sIGiso+y2LYFigh5d LCJVas32HnxoixCtJN55KVllTQIpfJHpb5fO4oO7VIhdjgJSYr1NKHjtivDHK61a GaJd3pF97J8Ie1/lt2x8k8yVm4xZp6KUNQ7nSlvjbiPp7Nzu+lt1uLXvrcmnih4= =LYvg -----END PGP SIGNATURE----- --e5bfZ/T2xnjpUIbw--