distribution Math-Polygon
- My extended documentation: http://perl.overmeer.net/CPAN/
- Development via GitHub: https://github.com/markov2/perl5-Math-Polygon
- Download from CPAN: ftp://ftp.cpan.org/pub/CPAN/authors/id/M/MA/MARKOV/
- Indexed from CPAN: http://search.cpan.org/~markov/Math-Polygon/ and https://metacpan.org/release/Math-Polygon
This module supports simple manipulation of 2D polygons, via two interfaces:
-
Object Oriented via Math::Polygon
This is the preferred interface: the simplest when you understand OO. The polygon coordinates (ARRAY of points) are wrapped into an abstract objects.
-
Function interface via Math::Polygon::Calc and friends
When you prefer to use plain functions and juggle with ARRAYs of ARRAYs of coordinates.
Development → Release
Important to know, is that I use an extension on POD to write the manuals. The "raw" unprocessed version is visible on GitHub. It will run without problems, but does not contain manual-pages.
Releases to CPAN are different: "raw" documentation gets removed from the code and translated into real POD and clean HTML. This reformatting is implemented with the OODoc distribution (A name I chose before OpenOffice existed, sorry for the confusion)
Clone from github for the "raw" version. For instance, when you want to contribute a new feature.
On github, you can find the processed version for each release. But the better source is CPAN; to get it installed simply run:
cpan -i Math::PolygonContributing
When you want to contribute to this module, you do not need to provide a perfect patch... actually: it is nearly impossible to create a patch which I will merge without modification. Usually, I need to adapt the style of code and documentation to my own strict rules.
When you submit an extension, please contribute a set with
-
code
-
code documentation
-
regression tests in t/
Please note: When you contribute in any way, you agree to transfer the copyrights to Mark Overmeer (you will get the honors in the code and/or ChangeLog). You also automatically agree that your contribution is released under the same license as this project: licensed as perl itself.
Copyright and License
This project is free software; you can redistribute it and/or modify it under the same terms as Perl itself. See http://dev.perl.org/licenses/