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.


_______________________________________________
macports-dev mailing list
[email protected]
http://lists.macosforge.org/mailman/listinfo.cgi/macports-dev

Reply via email to