From owner-freebsd-ports@FreeBSD.ORG Wed Oct 30 14:32:50 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 73FCD8A7 for ; Wed, 30 Oct 2013 14:32:50 +0000 (UTC) (envelope-from lists@eitanadler.com) Received: from mail-qe0-x235.google.com (mail-qe0-x235.google.com [IPv6:2607:f8b0:400d:c02::235]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 2B31E2644 for ; Wed, 30 Oct 2013 14:32:50 +0000 (UTC) Received: by mail-qe0-f53.google.com with SMTP id cy11so850245qeb.40 for ; Wed, 30 Oct 2013 07:32:49 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=eitanadler.com; s=0xdeadbeef; h=mime-version:in-reply-to:references:from:date:message-id:subject:to :cc:content-type; bh=JBCpPEc8RTYIAkeSXbhNyMUW3leoHdx3JetNc4uhpgs=; b=f6QGLFhoIb0NLdl49X0cUrnYTr1cinQjzj1QZB8YPkPOTh+dNFSKNKhh5k3XoeTN2c rJvWoxDVkFDs0aYXDoXr3i7ahxGoFg1xt2yop9Oc2Xd18adl9mnzZj7KdDihRFXTnMen n4zaKqyTNIGiRcTKzKdJvGc2WFMPkjxlc6e0g= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20130820; h=x-gm-message-state:mime-version:in-reply-to:references:from:date :message-id:subject:to:cc:content-type; bh=JBCpPEc8RTYIAkeSXbhNyMUW3leoHdx3JetNc4uhpgs=; b=S7TvGkrMeKfg3EMX0larf1dy2ufoUqnVNIp7yNp9326hruwvXabvZ4a9kYorOZ7TZq RCB0ZrlZuzGc8G3ajcslWDn8MZ58sF13zIgFs1slN/Ny+LlV3Hz3gjFauNAdR89fjAdc 80I66wTLLLeY8JkhjPg2ZGqVjYM/aa+/er9O7jcJYmfGLe44Xx1CmIbmefjNdu+aQuNN O3KHmPAsE1c6sR7PGduQu9qlkvVeljRmiBZw7U344LtXBk0Td/vpAXfI21jIUgNAgQSY TDLMkalswbU+uuceB9klyG/pf7CzLtoyCmz/XZTdhB2SsOT9BbWB/CV0W7NuWXBdhuyL 6dhg== X-Gm-Message-State: ALoCoQl5zPK4bE+jgwcn5LFcaRiO5bPHVzgPpQ6HK0/BjKhT4AXJDPcIDB6hxYmhCk1DXAH+Q4aT X-Received: by 10.229.13.69 with SMTP id b5mr7160916qca.13.1383143569402; Wed, 30 Oct 2013 07:32:49 -0700 (PDT) MIME-Version: 1.0 Received: by 10.96.63.101 with HTTP; Wed, 30 Oct 2013 07:32:19 -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> From: Eitan Adler Date: Wed, 30 Oct 2013 10:32:19 -0400 Message-ID: Subject: Re: State of the Porters' Handbook To: Gabor Pali Content-Type: text/plain; charset=UTF-8 Cc: Dominic Fandrey , Baptiste Daroussin , Michael Gmelin , marino@freebsd.org, lukasz@wasikowski.net, 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 14:32:50 -0000 On Tue, Oct 29, 2013 at 5:02 PM, Gabor Pali wrote: > On Mon, Oct 28, 2013 at 4:11 PM, Baptiste Daroussin wrote: >> I do buy this argument :) and I'll see want I can do for that in the next couple >> of days. > > Please find a patch [1] (and see [2] for the HTML preview) for the > porters-handbook document to address this problem. Note that some of > the contents have been already updated by Eitan Adler, this is just a > continuation of the work. > > [1] http://people.freebsd.org/~pgj/patches/2013/10/29/porters-handbook.staging.diff > [2] http://people.freebsd.org/~pgj/patches/2013/10/29/porters-handbook-staging/ Hi, nice work. Very quick review: - make reinstall - + pkg_add package-name - - make package + Or, in case of pkgng: + + pkg add package-name We generally don't refer to pkgng in the docs: please use "pkg". Further, I'd put the pkg cases first as the pkg_ tools are deprecated. + poudriere. These maintain Thanks for adding this. + For ports that install kernel modules, the This should be in a different section specifically about kernel modules. + staging) but it is broken (Mailman up to 2.1.16, for instance). I would not mention specific ports here. Examples get old quick. This looks good overall and thanks for working on it. -- Eitan Adler