Date: Fri, 16 Nov 2012 14:34:09 -0500 From: Glen Barber <gjb@FreeBSD.org> To: Warren Block <wblock@wonkity.com> Cc: freebsd-doc@FreeBSD.org Subject: Re: Request for Review: pkgng documentation for the Handbook Message-ID: <20121116193409.GG1335@glenbarber.us> In-Reply-To: <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> <alpine.BSF.2.00.1211161133410.76158@wonkity.com>
next in thread | previous in thread | raw e-mail | index | archive | help
--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 <command>. In other words, show the=20 > commands the reader will use with <command>, 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--
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20121116193409.GG1335>