From mwlucas@bewilderbeast.blackhelicopters.org  Fri Jul 19 16:28:17 2013
Return-Path: <mwlucas@bewilderbeast.blackhelicopters.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
	by hub.freebsd.org (Postfix) with ESMTP id 6C977F1
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 19 Jul 2013 16:28:17 +0000 (UTC)
	(envelope-from mwlucas@bewilderbeast.blackhelicopters.org)
Received: from bewilderbeast.blackhelicopters.org (mwlucas-2-pt.tunnel.tserv9.chi1.ipv6.he.net [IPv6:2001:470:1f10:b9c::2])
	by mx1.freebsd.org (Postfix) with ESMTP id 1AE682D2
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 19 Jul 2013 16:28:16 +0000 (UTC)
Received: from bewilderbeast.blackhelicopters.org (localhost [127.0.0.1])
	by bewilderbeast.blackhelicopters.org (8.14.5/8.14.5) with ESMTP id r6JGSFMI006808
	for <FreeBSD-gnats-submit@freebsd.org>; Fri, 19 Jul 2013 12:28:16 -0400 (EDT)
	(envelope-from mwlucas@bewilderbeast.blackhelicopters.org)
Received: (from mwlucas@localhost)
	by bewilderbeast.blackhelicopters.org (8.14.5/8.14.5/Submit) id r6JGSFLh006807;
	Fri, 19 Jul 2013 12:28:15 -0400 (EDT)
	(envelope-from mwlucas)
Message-Id: <201307191628.r6JGSFLh006807@bewilderbeast.blackhelicopters.org>
Date: Fri, 19 Jul 2013 12:28:15 -0400 (EDT)
From: Michael W Lucas <mwlucas@bewilderbeast.blackhelicopters.org>
Reply-To: Michael W Lucas <mwlucas@bewilderbeast.blackhelicopters.org>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: add detail to pkgng part of the handbook
X-Send-Pr-Version: 3.114
X-GNATS-Notify:

>Number:         180658
>Category:       docs
>Synopsis:       [handbook] add detail to pkgng part of the handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 19 16:30:00 UTC 2013
>Closed-Date:    Mon Oct 07 06:34:50 UTC 2013
>Last-Modified:  Mon Oct 07 06:34:50 UTC 2013
>Originator:     Michael W Lucas
>Release:        FreeBSD 10.0-CURRENT amd64
>Organization:
FreeBSD Committer Alumni
>Environment:
System: FreeBSD bewilderbeast.blackhelicopters.org 10.0-CURRENT FreeBSD 10.0-CURRENT #15: Thu Nov 8 14:02:45 EST 2012 mwlucas@bewilderbeast.blackhelicopters.org:/usr/obj/usr/src/sys/GENERIC amd64

Based on:

http://www.freebsd.org/doc/handbook/pkgng-intro.html

>Description:

The pkgng setup for 9.1 tells users to use the pkg command to convert
to pkgng. The pkg command is not suitable for scripting or automated
installs, as it requires human intervention. You can still use pkg_add
-r pkg to perform the conversion, however.

>How-To-Repeat:

Try to write an Ansible playbook to convert from pkg_add to pkgng
while using pkg.

>Fix:

I don't have a current docs hacking environment set up, but I figured
if I wrote some text and sent it in an active committer would happily
take it. At least, that's what we did back in FreeBSD's Bronze
Age. ;-)

I would recommend some text like this.

FreeBSD 9.1 and later includes a utility for interactive
"bootstrapping" of pkgng.  This bootstrap utility downloads and
installs pkgng. To bootstrap the system, run:

# /usr/sbin/pkg

For non-interactive pkgng installs use the pkgng package, as used in
older FreeBSD versions.








>Release-Note:
>Audit-Trail:

From: Benedict Reuschling <bcr@FreeBSD.org>
To: bug-followup@FreeBSD.org, mwlucas@bewilderbeast.blackhelicopters.org
Cc:  
Subject: Re: docs/180658: [handbook] add detail to pkgng part of the handbook
Date: Sun, 06 Oct 2013 17:42:41 +0200

 -----BEGIN PGP SIGNED MESSAGE-----
 Hash: SHA1
 
 Hi Michael,
 
 Dru Lavigne recently updated the pkgng part of the handbook with the
 instructions you are referring to. Can you check to see whether that
 will solve the PR?
 
 Thanks & best regards
 
 Benedict Reuschling
 FreeBSD Documentation Committer
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.8 (Darwin)
 Comment: GPGTools - http://gpgtools.org
 Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/
 
 iEYEARECAAYFAlJRhPEACgkQTSZQLkqBk0ihqgCeMhIHT9Mc6PWA93MN8hXWCZvP
 IZAAn0xc3b9wTIu+nASp/hPefSoxyEC+
 =SWkD
 -----END PGP SIGNATURE-----

From: "Michael W. Lucas" <mwlucas@michaelwlucas.com>
To: Benedict Reuschling <bcr@FreeBSD.org>
Cc: bug-followup@FreeBSD.org
Subject: Re: docs/180658: [handbook] add detail to pkgng part of the handbook
Date: Sun, 6 Oct 2013 19:57:42 -0400

 Looks good to me, go ahead & close. Thanks!
 
 On Sun, Oct 06, 2013 at 05:42:41PM +0200, Benedict Reuschling wrote:
 > -----BEGIN PGP SIGNED MESSAGE-----
 > Hash: SHA1
 > 
 > Hi Michael,
 > 
 > Dru Lavigne recently updated the pkgng part of the handbook with the
 > instructions you are referring to. Can you check to see whether that
 > will solve the PR?
 > 
 > Thanks & best regards
 > 
 > Benedict Reuschling
 > FreeBSD Documentation Committer
 > -----BEGIN PGP SIGNATURE-----
 > Version: GnuPG v1.4.8 (Darwin)
 > Comment: GPGTools - http://gpgtools.org
 > Comment: Using GnuPG with Thunderbird - http://www.enigmail.net/
 > 
 > iEYEARECAAYFAlJRhPEACgkQTSZQLkqBk0ihqgCeMhIHT9Mc6PWA93MN8hXWCZvP
 > IZAAn0xc3b9wTIu+nASp/hPefSoxyEC+
 > =SWkD
 > -----END PGP SIGNATURE-----
 
 -- 
 Michael W. Lucas  -  mwlucas@michaelwlucas.com, Twitter @mwlauthor 
 http://www.MichaelWLucas.com/, http://blather.MichaelWLucas.com/
 Absolute OpenBSD 2/e - http://www.nostarch.com/openbsd2e
 coupon code "ILUVMICHAEL" gets you 30% off & helps me.
State-Changed-From-To: open->closed  
State-Changed-By: bcr 
State-Changed-When: Mon Oct 7 06:34:07 UTC 2013 
State-Changed-Why:  
The issue was fixed by an update to the pkgng chapter of the handbook. 
Thanks for filing the PR. closed! 

http://www.freebsd.org/cgi/query-pr.cgi?pr=180658 
>Unformatted:
