State of the Porters' Handbook

[Michael Gmelin]

On Mon, 28 Oct 2013 10:29:49 +0100
Dominic Fandrey <kamikaze at bsdforen.de> wrote:

> On 28/10/2013 09:58, John Marino wrote:
> > 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
> 
> That's a handfull. What about installers that hard-code directories
> during install?
> 
> > You don't have a choice with supporting stage -- new ports without
> > stage aren't accepted.  So that's why you have to bother.  :)
> 
> That doesn't sound acceptable, considering the feature isn't even
> mentioned in the Porters' Handbook.
> 

I agree, making something mandatory that's not in the handbook at all
is bad. At the bare minimum the feature should be mentioned in there,
even if it's just a stub referring to the Wiki. 

-- 
Michael Gmelin