docs/180658: add detail to pkgng part of the handbook

[Michael W Lucas]

>Number:         180658
>Category:       docs
>Synopsis:       add detail to pkgng part of the handbook
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 19 16:30:00 UTC 2013
>Closed-Date:
>Last-Modified:
>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 at 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:
>Unformatted: