Date: Wed, 30 Oct 2013 19:11:18 +0100 From: Gabor Pali <pgj@FreeBSD.org> To: Eitan Adler <lists@eitanadler.com> Cc: Dominic Fandrey <kamikaze@bsdforen.de>, Baptiste Daroussin <bapt@freebsd.org>, Michael Gmelin <freebsd@grem.de>, marino@freebsd.org, "0Idaho0 ." <lukasz@wasikowski.net>, FreeBSD Ports <ports@freebsd.org> Subject: Re: State of the Porters' Handbook Message-ID: <CAHnG2Cz8eZ7zxpA83oL6PXmx%2BKM%2BLfsz0aPt2-_CyoS55nnbHg@mail.gmail.com> In-Reply-To: <CAF6rxg=z%2BT3022cKUQs5THvq2w0K9DzAuxi%2B57AR6cXhVopzUA@mail.gmail.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%2BhD%2BcoQ@mail.gmail.com> <CAF6rxg=z%2BT3022cKUQs5THvq2w0K9DzAuxi%2B57AR6cXhVopzUA@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
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. > Further, I'd put the pkg cases first as the pkg_ tools are deprecated. I do not think that matters much. > + <application>poudriere</application>. 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. > + <para>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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?CAHnG2Cz8eZ7zxpA83oL6PXmx%2BKM%2BLfsz0aPt2-_CyoS55nnbHg>