ASSP out of date

[Bryan Blackburn]

On Tue, Nov 11, 2008 at 03:43:26PM -0800, Scott Haneda said:
[...]
>
> Ahh nice, thanks.  I am not entirely sure, you guys can be the gauge of 
> this, but I feel my questions are not that out of the ordinary for a new 
> port maker.  I do look at the docs before I ask here, either I am a bad 
> searcher in the docs, or the data is missing.  Google tends to mostly 
> point the the tracker, so that is of little use.
>
> If I wanted to start adding stuff like this to the docs, would you agree 
> it is beneficial, or am I asking questions most people understand?  If you 
> do think it is beneficial, what is the best procedure for making changes 
> and additions to the docs?

Personally, I'd love to hear your summary of how the guide didn't cover
things you ran into.  Many of us who know enough to be able to write
sections in there may not always remember what bits were missing when first
learning (I wrote my first Portfile 5-6 years ago, so I definitely don't
remember what the learning curve was like, not to mention Portfiles look a
bit different now).

Obviously there are sections in the guide that are just TODO but there are
probably other sections that don't exist yet that may have helped in your
case (though as I mentioned earlier in this thread, assp definitely isn't
the best first-time Portfile choice).  For example, a quick scan shows that
the details of what to put into a Portfile are there, but I didn't see
anything about steps for actually testing one (eg, running just through
destroot initially, as a user who can't write to ${prefix}, and so on).

>
> A good example is fs-traverse, which I think is just awesome, and in  
> looking over other ports, trying to learn, there are clear cases where it 
> would be a better choice to use than some of the for each loops people are 
> doing in tcl.  I do not think fs-traverse is even mentioned on the docs.

I see it is in the portfile man page, but not in the guide.  There's been
mention of the two (guide, man pages) being merged into one source, but
until then, the fs-traverse info should probably be copied over to the
guide.

Bryan


[...]
>
> Thanks.
> --
> Scott
>