From owner-freebsd-doc@FreeBSD.ORG Fri Jul 19 16:30:01 2013 Return-Path: Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by hub.freebsd.org (Postfix) with ESMTP id C2C08235 for ; Fri, 19 Jul 2013 16:30:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:1900:2254:206c::16:87]) by mx1.freebsd.org (Postfix) with ESMTP id E3B4B304 for ; Fri, 19 Jul 2013 16:30:00 +0000 (UTC) Received: from freefall.freebsd.org (localhost [127.0.0.1]) by freefall.freebsd.org (8.14.7/8.14.7) with ESMTP id r6JGU03V065319 for ; Fri, 19 Jul 2013 16:30:00 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.7/8.14.7/Submit) id r6JGU0ri065318; Fri, 19 Jul 2013 16:30:00 GMT (envelope-from gnats) Resent-Date: Fri, 19 Jul 2013 16:30:00 GMT Resent-Message-Id: <201307191630.r6JGU0ri065318@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Michael W Lucas Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) by hub.freebsd.org (Postfix) with ESMTP id 6C977F1 for ; 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 ; 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 ; 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 To: FreeBSD-gnats-submit@freebsd.org X-Send-Pr-Version: 3.114 Subject: docs/180658: add detail to pkgng part of the handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list Reply-To: Michael W Lucas List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 19 Jul 2013 16:30:01 -0000 >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@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: