From owner-freebsd-ports@FreeBSD.ORG  Wed Oct 30 19:51:58 2013
Return-Path: <owner-freebsd-ports@FreeBSD.ORG>
Delivered-To: ports@freebsd.org
Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by hub.freebsd.org (Postfix) with ESMTP id 5ACA43E0;
 Wed, 30 Oct 2013 19:51:58 +0000 (UTC)
 (envelope-from wblock@wonkity.com)
Received: from wonkity.com (wonkity.com [67.158.26.137])
 (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by mx1.freebsd.org (Postfix) with ESMTPS id 07F112EB8;
 Wed, 30 Oct 2013 19:51:57 +0000 (UTC)
Received: from wonkity.com (localhost [127.0.0.1])
 by wonkity.com (8.14.7/8.14.7) with ESMTP id r9UJptYl082746;
 Wed, 30 Oct 2013 13:51:55 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Received: from localhost (wblock@localhost)
 by wonkity.com (8.14.7/8.14.7/Submit) with ESMTP id r9UJpssh082743;
 Wed, 30 Oct 2013 13:51:54 -0600 (MDT)
 (envelope-from wblock@wonkity.com)
Date: Wed, 30 Oct 2013 13:51:54 -0600 (MDT)
From: Warren Block <wblock@wonkity.com>
To: Gabor Pali <pgj@FreeBSD.org>
Subject: Re: State of the Porters' Handbook
In-Reply-To: <CAHnG2Cz8eZ7zxpA83oL6PXmx+KM+Lfsz0aPt2-_CyoS55nnbHg@mail.gmail.com>
Message-ID: <alpine.BSF.2.00.1310301344190.82649@wonkity.com>
References: <526E272D.3040607@marino.st> <526E2E8D.3020109@bsdforen.de>
 <526E2FB8.5060906@marino.st> <526E3454.60501@bsdforen.de>
 <526E3685.4070306@marino.st> <526E3986.7050304@bsdforen.de>
 <526E3BC2.6030004@marino.st> <526E3F32.2040704@bsdforen.de>
 <20131028145645.GE74512@ithaqua.etoilebsd.net>
 <20131028160458.5f7add4c@bsd64.grem.de>
 <20131028151145.GF74512@ithaqua.etoilebsd.net>
 <CAHnG2CzjbqAWJr5dBACvYG3a=vxGas_fD=eoHH8egHZ+hD+coQ@mail.gmail.com>
 <CAF6rxg=z+T3022cKUQs5THvq2w0K9DzAuxi+57AR6cXhVopzUA@mail.gmail.com>
 <CAHnG2Cz8eZ7zxpA83oL6PXmx+KM+Lfsz0aPt2-_CyoS55nnbHg@mail.gmail.com>
User-Agent: Alpine 2.00 (BSF 1167 2008-08-23)
MIME-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII; format=flowed
X-Greylist: Sender IP whitelisted, not delayed by milter-greylist-4.4.3
 (wonkity.com [127.0.0.1]); Wed, 30 Oct 2013 13:51:55 -0600 (MDT)
Cc: FreeBSD Ports <ports@freebsd.org>, Eitan Adler <lists@eitanadler.com>
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
List-Id: Porting software to FreeBSD <freebsd-ports.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/options/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-ports>
List-Post: <mailto:freebsd-ports@freebsd.org>
List-Help: <mailto:freebsd-ports-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-ports>,
 <mailto:freebsd-ports-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Wed, 30 Oct 2013 19:51:58 -0000

On Wed, 30 Oct 2013, Gabor Pali wrote:

> On Wed, Oct 30, 2013 at 3:32 PM, Eitan Adler <lists@eitanadler.com> wrote:
>> We generally don't refer to pkgng in the docs: please use "pkg".
>
> Well, I saw pkg written as "pkgng" in some other section (5.2.2.2.
> "PORTEPOCH") of the Porter's Handbook.  Actually, I prefer to write it
> as pkg(8), but I am not sure if there has been a DocBook entity
> defined for it.

Just checked, and presently there is no man page entity for it.  Using a 
man page entity might be questionable anyway: there is no man page for 
pkg on FreeBSD 9 and earlier unless ports-mgmt/pkg has been installed. 
(I'm not going to mention /usr/sbin/pkg, which should not have been 
given the same name because now we can't tell which "pkg" is being 
discussed.  See how I didn't mention it there?)

>> Further, I'd put the pkg cases first as the pkg_ tools are deprecated.
>
> I do not think that matters much.

Agreed.  Actually, until pkg_* is deprecated for 9.x and earlier, it is 
by far the most common.