From owner-freebsd-doc@FreeBSD.ORG  Mon Apr 22 11:30:00 2013
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@smarthost.ysv.freebsd.org
Received: from mx1.freebsd.org (mx1.FreeBSD.org [8.8.178.115])
 by hub.freebsd.org (Postfix) with ESMTP id C7A133D7
 for <freebsd-doc@smarthost.ysv.freebsd.org>;
 Mon, 22 Apr 2013 11:30:00 +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 9594D1354
 for <freebsd-doc@smarthost.ysv.freebsd.org>;
 Mon, 22 Apr 2013 11:30:00 +0000 (UTC)
Received: from freefall.freebsd.org (localhost [127.0.0.1])
 by freefall.freebsd.org (8.14.6/8.14.6) with ESMTP id r3MBU0ot097146
 for <freebsd-doc@freefall.freebsd.org>; Mon, 22 Apr 2013 11:30:00 GMT
 (envelope-from gnats@freefall.freebsd.org)
Received: (from gnats@localhost)
 by freefall.freebsd.org (8.14.6/8.14.6/Submit) id r3MBU0fW097145;
 Mon, 22 Apr 2013 11:30:00 GMT (envelope-from gnats)
Resent-Date: Mon, 22 Apr 2013 11:30:00 GMT
Resent-Message-Id: <201304221130.r3MBU0fW097145@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,
 Kimmo Paasiala <kpaasial@gmail.com>
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 by hub.freebsd.org (Postfix) with ESMTP id F217D314
 for <freebsd-gnats-submit@FreeBSD.org>; Mon, 22 Apr 2013 11:22:48 +0000 (UTC)
 (envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
 by mx1.freebsd.org (Postfix) with ESMTP id E310912FD
 for <freebsd-gnats-submit@FreeBSD.org>; Mon, 22 Apr 2013 11:22:48 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
 by red.freebsd.org (8.14.5/8.14.5) with ESMTP id r3MBMm9G013814
 for <freebsd-gnats-submit@FreeBSD.org>; Mon, 22 Apr 2013 11:22:48 GMT
 (envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
 by red.freebsd.org (8.14.5/8.14.5/Submit) id r3MBMm4L013813;
 Mon, 22 Apr 2013 11:22:48 GMT (envelope-from nobody)
Message-Id: <201304221122.r3MBMm4L013813@red.freebsd.org>
Date: Mon, 22 Apr 2013 11:22:48 GMT
From: Kimmo Paasiala <kpaasial@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
X-Send-Pr-Version: www-3.1
Subject: docs/178049: Handbook: PKGNG information misleading
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
 <mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 22 Apr 2013 11:30:00 -0000


>Number:         178049
>Category:       docs
>Synopsis:       Handbook: PKGNG information misleading
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Apr 22 11:30:00 UTC 2013
>Closed-Date:
>Last-Modified:
>Originator:     Kimmo Paasiala
>Release:        FreeBSD 9
>Organization:
>Environment:
>Description:
The sentence at the beginning of "Using pkgng for Binary Package Management" section leads one to believe that PKGNG tools are not used when building ports(7) the usual way with WITH_PKGNG set.

"While ports-mgmt/portmaster and ports-mgmt/portupgrade can install third-party software from both binary packages and the Ports Collection, pkgng installs only binary packages."

This could be rewritten to:

"While ports-mgmt/portmaster and ports-mgmt/portupgrade can install third-party software from both binary packages and the Ports Collection, pkgng only deals with installing and registering of binary packages into the system. Software installed from the Ports Collection are registered into the system as pkgng packages that can be updated by using binary packages or the Ports Collection".
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
>Unformatted: