From owner-freebsd-doc@FreeBSD.ORG  Wed Oct  8 22:07:23 2014
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.freebsd.org (mx1.freebsd.org
 [IPv6:2001:1900:2254:206a::19:1])
 (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTPS id 737DA9A1
 for <freebsd-doc@FreeBSD.org>; Wed,  8 Oct 2014 22:07:23 +0000 (UTC)
Received: from gabriella.abattoir.com
 (70-36-157-19.dsl.static.fusionbroadband.com [70.36.157.19])
 (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
 (Client CN "gabriella.abattoir.com",
 Issuer "gabriella.abattoir.com" (not verified))
 by mx1.freebsd.org (Postfix) with ESMTPS id 4E33D605
 for <freebsd-doc@FreeBSD.org>; Wed,  8 Oct 2014 22:07:22 +0000 (UTC)
Received: from [10.9.4.251] (goldmine [10.9.4.251]) (authenticated bits=0)
 by gabriella.abattoir.com (8.14.9/8.14.9) with ESMTP id s98M7HkW093106
 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES128-SHA bits=128 verify=NO)
 for <freebsd-doc@FreeBSD.org>; Wed, 8 Oct 2014 15:07:17 -0700 (PDT)
 (envelope-from john@vinopal.com)
Message-ID: <5435B59A.1050204@vinopal.com>
Date: Wed, 08 Oct 2014 15:07:22 -0700
From: John Vinopal <john@vinopal.com>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64;
 rv:31.0) Gecko/20100101 Thunderbird/31.1.2
MIME-Version: 1.0
To: freebsd-doc@FreeBSD.org
Subject: 5.4.1. Getting Started with pkg
Content-Type: text/plain; charset=utf-8; format=flowed
Content-Transfer-Encoding: 7bit
X-Spam-Status: No, score=-1.0 required=5.0 tests=ALL_TRUSTED=-1
 gabriella.abattoir.com 1356;
 Body=1 Fuz1=1 Fuz2=1  <dns:vinopal.com?type=MX> [10 gabriella.abattoir.com.]
 <dns:vinopal.com> [69.163.200.170] autolearn=unavailable autolearn_force=no
 version=3.4.0
X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on
 gabriella.abattoir.com
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.18-1
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: Wed, 08 Oct 2014 22:07:23 -0000

Hi there,

I have a suggest improvement to the handbook.
https://www.freebsd.org/doc/handbook/pkgng-intro.html

Section "5.4.1. Getting Started with pkg" should discuss an issue with 
pkg2ng, namely that packages converted in this manner do not have 
correct meta-data regarding their "automatic" or "directly-installed" 
status.  Here is a suggested paragraph that will illuminate the issue 
for people upgrading via pkg2ng.

After <span class="application">pkg2ng</span> has finished, converted 
packages are marked as "non-automatic". Non-automatic packages are those 
directly installed, while "automatic" packages are installed as a 
dependency.  The older package system did not record this meta-data.  In 
order to use tools such as <code class="command">pkg autoremove</code>, 
you must manually set the "automatic" state for dependencies.  For 
example, <code class="command">pkg set -A 1 perl-5.14</code>.  See 
pkg(8) for more information.

Thanks for your hard work!

-john