Skip site navigation (1)Skip section navigation (2)
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>