From owner-freebsd-ports@FreeBSD.ORG Mon Oct 28 15:11:54 2013 Return-Path: Delivered-To: ports@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTP id 8A4D517A; Mon, 28 Oct 2013 15:11:54 +0000 (UTC) (envelope-from baptiste.daroussin@gmail.com) Received: from mail-we0-x22c.google.com (mail-we0-x22c.google.com [IPv6:2a00:1450:400c:c03::22c]) (using TLSv1 with cipher ECDHE-RSA-RC4-SHA (128/128 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id E7178262B; Mon, 28 Oct 2013 15:11:53 +0000 (UTC) Received: by mail-we0-f172.google.com with SMTP id q58so6779230wes.31 for ; Mon, 28 Oct 2013 08:11:52 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=sender:date:from:to:cc:subject:message-id:references:mime-version :content-type:content-disposition:in-reply-to:user-agent; bh=eNfCp1jY7hqRLJErQFfW67ae5dYdWPyYNJGorCSfGsg=; b=JzXvZNESUq1odqmXdBHEH8Benzv1qWO3Wqq6fh6m1JD641YxBeka3D6UDCUyAur/vI IEN9gZsER4JfF/S+3B3dwnpxU3mwW1ZMgQSvPvT1JsyKg3ilHqTGbhoq4ajQIQS6XLyb RQFkWacI9CcYlvzWM2BlPoHLBYsJun0lJX+zZ4ZQsi1Ua/zdH2AzzkBW8Gp+m3jGvSpt zg1rJYY8Y8Y77974Olx6SIvY0KWT9b54LLGnZEqeLGid+ZuwdfXXlyt4OnaDHOEgRdyl 2Lklj3p4UObfiqFZuqt/a2+hR6sHXI1E/AeRjoMdKeSkcXXchKR+2SDnmF7X/6WgvEYS U3Tw== X-Received: by 10.194.83.6 with SMTP id m6mr799048wjy.83.1382973112354; Mon, 28 Oct 2013 08:11:52 -0700 (PDT) Received: from ithaqua.etoilebsd.net (ithaqua.etoilebsd.net. [37.59.37.188]) by mx.google.com with ESMTPSA id nc17sm11358589wic.1.2013.10.28.08.11.49 for (version=TLSv1 cipher=RC4-SHA bits=128/128); Mon, 28 Oct 2013 08:11:51 -0700 (PDT) Sender: Baptiste Daroussin Date: Mon, 28 Oct 2013 16:11:45 +0100 From: Baptiste Daroussin To: Michael Gmelin Subject: Re: State of the Porters' Handbook Message-ID: <20131028151145.GF74512@ithaqua.etoilebsd.net> 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> MIME-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="OzxllxdKGCiKxUZM" Content-Disposition: inline In-Reply-To: <20131028160458.5f7add4c@bsd64.grem.de> User-Agent: Mutt/1.5.21 (2010-09-15) Cc: ports@freebsd.org, Dominic Fandrey , marino@freebsd.org, lukasz@wasikowski.net 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: Mon, 28 Oct 2013 15:11:54 -0000 --OzxllxdKGCiKxUZM Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable On Mon, Oct 28, 2013 at 04:04:58PM +0100, Michael Gmelin wrote: > On Mon, 28 Oct 2013 15:56:46 +0100 > Baptiste Daroussin wrote: >=20 > > On Mon, Oct 28, 2013 at 11:40:50AM +0100, Dominic Fandrey wrote: > > > On 28/10/2013 11:26, John Marino wrote: > > > > On 10/28/2013 11:16, Dominic Fandrey wrote: > > > >> On 28/10/2013 11:03, John Marino wrote: > > > >>> If there are files in those directories, they'll be on the > > > >>> plist and stage handles them. I'd have to look up how to > > > >>> create empty directories properly. > > > >> > > > >> Stage replaceses strings in installed files? > > > >=20 > > > > No, the port does that kind of thing in the stage directory. > > > > After everything is installed there in the stage directory, they > > > > are packaged or installed into the $PREFIX > > > >=20 > > > >> I can see the benefits for less error prone package building. > > > >> But right now it's just additional work coming my way. > > > >=20 > > > > You really need to get a better grasp of the concept. There are > > > > several emails from bapt that may help. For new ports it's not > > > > "additional" work and for existing ports, yes there is a > > > > conversion but the benefits are worth it. > > > >=20 > > > >>> 2. Stage is not going away. There is not another option. > > > >>> 3. You've been given a source of documentation. It's not in the > > > >>> handbook, but it does exist in some form. What more do you > > > >>> need to progress? > > > >> > > > >> There is a procedure. Stuff belongs into the handbook. Stick to > > > >> it. > > > >=20 > > > > Fine, but it's a huge topic that somebody has to write and > > > > validate. You're willing to criticize (justified) but unwilling > > > > to help rectify the problem. > > >=20 > > > Well, bsd.stage.mk isn't well commented either. I think right now > > > only the person who implemented it could write reasonable > > > documentation. > > >=20 > > > > If you only want to complain, I think you've made your > > > > point (a point that everyone is already aware of). > > > >=20 > > > > FYI, I have no dog in the hunt other than I believe stage is a > > > > welcome update to ports. > > >=20 > > > 1. Implementation > > > 2. Testing > > > 3. Documentation > > > 4. Mandatory > > >=20 > > > We're in stage 2 and it's already mandatory. I'm not against > > > staging, I'm against making things prematurely mandatory. > >=20 > > With that kind of reasoning we get the ports tree we have now. > > Meaning a pile of inconsistent, inefficient things, and things like > > UNIQUENAME not being UNIQUE etc. > >=20 > > the stage work is a 3 years work almost, that has been half > > abandonned, a lot of time. > >=20 > > Documentation on how to convert has been done on the wiki before > > making staging mandatory and completed since. > >=20 > > Documentation for the handbook is another beast because the whole > > handbook as to be touched and reviewed, and I ask a couple of time to > > people to help me documenting on the handbook. > >=20 > > I don't buy the opinion that the handbook is totally outdated, all > > the features I added but stage are in the handbook including shebang > > fix ! so perhaps that can be improved but that is there. > >=20 > > Before committing the stage support I made sure that all previous > > things has been documented. > >=20 > > and sorry but my priority is to have the ports tree back into a sane > > state where we have consistency and sane packages, do documentation > > has much as I can and I try to avoid having too much latency for > > documentation. > >=20 > > Bapt >=20 > I agree for the most part, the only suggestion I'd make is to reference > undocumented features in the Porter's Handbook and link to their Wiki > pages - that should be a matter of minutes and would make sure that > people starting from the handbook get the complete picture. > It's really hard for newcomers not following ports@ to find this bit of > information otherwise, especially since the Wiki is not that well > organized (staging is not even on the Wiki's frontpage). E.g. >=20 > Section X: Staging > Staging is mandatory for new ports, it's not documented in here yet, > but details can be found in the FreeBSD wiki (link to staging support > page). >=20 I do buy this argument :) and I'll see want I can do for that in the next c= ouple of days. regards, Bapt --OzxllxdKGCiKxUZM Content-Type: application/pgp-signature -----BEGIN PGP SIGNATURE----- Version: GnuPG v2.0.19 (FreeBSD) iEYEARECAAYFAlJufrEACgkQ8kTtMUmk6EwRjwCfZT51uMAWI0V/e2YGAWC9wNLZ kGoAn09ygP4L9bNbmwWfb5mDSN9XRPQK =EGN3 -----END PGP SIGNATURE----- --OzxllxdKGCiKxUZM--