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>
index | next in thread | previous in thread | raw e-mail
[-- Attachment #1 --] 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. > > 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. > 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 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". 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 [-- Attachment #2 --] -----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-----help
Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20121116193409.GG1335>