From owner-freebsd-ports@FreeBSD.ORG Wed Oct 30 18:11:20 2013 Return-Path: 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 392C3906; Wed, 30 Oct 2013 18:11:20 +0000 (UTC) (envelope-from pali.gabor@gmail.com) Received: from mail-oa0-x22a.google.com (mail-oa0-x22a.google.com [IPv6:2607:f8b0:4003:c02::22a]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id DA0332772; Wed, 30 Oct 2013 18:11:19 +0000 (UTC) Received: by mail-oa0-f42.google.com with SMTP id k14so1886291oag.1 for ; Wed, 30 Oct 2013 11:11:19 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:sender:in-reply-to:references:date:message-id:subject :from:to:cc:content-type; bh=8g8+9fGx3hPLIRzocp70QKBkbm3TDMrmcxq5w1wB6p0=; b=KZdJRxqRUOMZj2kOJUxPXA32QCiJiFwILYRuBtxF+yVrlZUSnLR8BtLusZPqlXOYLS xnAaeB9pXg9DmQ5mVy28k0AYWmKFAxGEYfqOpZO/XrjojRRfIN+Hjx/acqByloFgTLJa 2SuYGoijLb+U8m/IcnB4/4kTVB0l/J0NSkBgWTp2pt0UArZ0+rrCmiPr4UBr7btEYDOk 4fMqqu584ES9eVyBKzPUpLcau6UgJEvyhwJRH11hWo8y6opfRL2+LEpHzq7MbMnPcwi7 xgLrqi7Up1rzLaqjqOVZOujJqdZPvyG3aDELHZPJj07EJZPhmUfTiaWH4nMvlg8vTVn3 31Fg== MIME-Version: 1.0 X-Received: by 10.182.92.231 with SMTP id cp7mr998554obb.82.1383156678971; Wed, 30 Oct 2013 11:11:18 -0700 (PDT) Sender: pali.gabor@gmail.com Received: by 10.182.22.44 with HTTP; Wed, 30 Oct 2013 11:11:18 -0700 (PDT) In-Reply-To: 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> Date: Wed, 30 Oct 2013 19:11:18 +0100 X-Google-Sender-Auth: 5nu-RNBa3TAMi15bmpDoZ5LrCUA Message-ID: Subject: Re: State of the Porters' Handbook From: Gabor Pali To: Eitan Adler Content-Type: text/plain; charset=ISO-8859-1 Cc: Dominic Fandrey , Baptiste Daroussin , Michael Gmelin , marino@freebsd.org, "0Idaho0 ." , FreeBSD Ports X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.14 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 30 Oct 2013 18:11:20 -0000 On Wed, Oct 30, 2013 at 3:32 PM, Eitan Adler 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. > Further, I'd put the pkg cases first as the pkg_ tools are deprecated. I do not think that matters much. > + poudriere. These maintain > > Thanks for adding this. Note this is not complete. I believe poudriere would finally deserve an own section in the documentation, somewhere after Tinderbox. > + For ports that install kernel modules, the > > This should be in a different section specifically about kernel modules. This is related to staging, that is why it is there. I did not find any section on kernel modules, for what it is worth, the expression "kernel module" occurs only twice in the whole book -- hence I did not feel myself motivated to start a new section on kernel modules; at least, not for now. > + staging) but it is broken (Mailman up to 2.1.16, for instance). > > I would not mention specific ports here. Examples get old quick. I do not think this situation will change any time soon. > This looks good overall and thanks for working on it. Thanks for the feedback.