From nobody@FreeBSD.org  Mon Apr 22 11:22:48 2013
Return-Path: <nobody@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 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
Subject: Handbook: PKGNG information misleading
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         178049
>Category:       docs
>Synopsis:       [handbook] PKGNG information misleading
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    crees
>State:          feedback
>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:  Fri May 31 17:04:55 UTC 2013
>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:
Responsible-Changed-From-To: freebsd-doc->crees 
Responsible-Changed-By: crees 
Responsible-Changed-When: Fri May 31 16:15:47 UTC 2013 
Responsible-Changed-Why:  
I'll take it. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=178049 
State-Changed-From-To: open->feedback 
State-Changed-By: crees 
State-Changed-When: Fri May 31 17:04:55 UTC 2013 
State-Changed-Why:  
How about the following patch? 
http://www.bayofrum.net/~crees/patches/doc-handbook-ports-pkgng-portmaster.diff 
"If the ports tree is used directly instead of pre-built packages, pkgng 
is not a replacement for tools such as ports-mgmt/portmaster or 
ports-mgmt/portupgrade. These tools work together with pkgng to update 
packages that are installed via ports." 

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