The Guide - again

[Bryan Blackburn]

On Tue, Mar 10, 2009 at 12:16:44AM -0500, Ryan Schmidt said:
>> Many of those tickets say "the guide should ..." and give not a lot of
>> helpful information.  Not all.  Ryan's doc tickets are particularly
>> helpful I should say.  But as an example of ones that will linger:
>> http://trac.macports.org/ticket/15784   Since the creator didn't give 
>> any
>> directly usable information, it will be awhile before that gets acted 
>> on.
>
> The creator of the ticket may not know how to document the option. They 
> may have just seen it in a portfile or portgroup or somewhere and wondered 
> what it was, and noted it was not described in the guide. So it's right 
> for them to ask for it to be documented.
>
> For tickets that say the guide should document something, without saying 
> how it should be documented, maybe a message should be sent to  
> macports-dev asking if anyone knows what the option does. For example in 
> the case of 15784, I don't know what "perl5.use_module_build" is / does. 
> Hopefully someone with more experience with the perl modules does.

It changes how the perl5 port group does a build, specifically, by using
perl's Module::Build instead of the usual Makefile.PL-style building.  After
the usual perl5.setup stuff, if you then add perl5.use_module_build, it
should then do what's right to build the module with Module::Build
(including depending on p5-module-build).

Bryan