From owner-freebsd-ports@FreeBSD.ORG  Mon Oct 28 08:58:34 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 CE381A42
 for <ports@freebsd.org>; Mon, 28 Oct 2013 08:58:34 +0000 (UTC)
 (envelope-from freebsd.contact@marino.st)
Received: from shepard.synsport.net (mail.synsport.com [208.69.230.148])
 (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by mx1.freebsd.org (Postfix) with ESMTPS id A620E2C55
 for <ports@freebsd.org>; Mon, 28 Oct 2013 08:58:34 +0000 (UTC)
Received: from [192.168.1.35] (157.Red-79-159-31.staticIP.rima-tde.net
 [79.159.31.157])
 (using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
 (No client certificate requested)
 by shepard.synsport.net (Postfix) with ESMTP id E65B8438EB;
 Mon, 28 Oct 2013 03:58:22 -0500 (CDT)
Message-ID: <526E272D.3040607@marino.st>
Date: Mon, 28 Oct 2013 09:58:21 +0100
From: John Marino <freebsd.contact@marino.st>
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64;
 rv:17.0) Gecko/20130509 Thunderbird/17.0.6
MIME-Version: 1.0
To: Dominic Fandrey <kamikaze@bsdforen.de>
Subject: Re: State of the Porters' Handbook
References: <526E234F.3090005@bsdforen.de> <526E2492.9080107@wasikowski.net>
 <526E2600.9010409@bsdforen.de>
In-Reply-To: <526E2600.9010409@bsdforen.de>
X-Enigmail-Version: 1.6
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
Cc: ports@freebsd.org,
 =?UTF-8?B?xYF1a2FzeiBXxIVzaWtvd3NraQ==?= <lukasz@wasikowski.net>
X-BeenThere: freebsd-ports@freebsd.org
X-Mailman-Version: 2.1.14
Precedence: list
Reply-To: marino@freebsd.org
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: Mon, 28 Oct 2013 08:58:34 -0000

On 10/28/2013 09:53, Dominic Fandrey wrote:
> On 28/10/2013 09:47, Łukasz Wąsikowski wrote:
>> W dniu 2013-10-28 09:41, Dominic Fandrey pisze:
>>
>>> Neither staging nor license management are described in the Porters'
>>> Handbook.
>>>
>>> Why again should we bother to support it?
>>>
>>> What happened to "the feature that is not documented doesn't exist"?
>>
>> Lack of good documentation is real problem for me to convert ports to
>> staging. Porter's Handbook is seriously lagging behind recent changes -
>> staging, license management, shabang fixes, etc.
> 
> If it was up for a vote, I'd vote for a feature stop until the PH
> is back in a decent condition.
> 
> Kudos to the people who documented the new options framework.
> 

For all intents and purposes - licensing "feature" doesn't exist.  The
same issues you are raising have been raised before.  Apparently the
full licensing infrastructure is still lacking so it's in some kind of
limbo.

However, converting to stagedir is reasonably documented here:
https://wiki.freebsd.org/ports/StageDir

You don't have a choice with supporting stage -- new ports without stage
aren't accepted.  So that's why you have to bother.  :)

John