1# distribution XML-Compile-Cache 2 3 * My extended documentation: <http://perl.overmeer.net/CPAN/> 4 * Development via GitHub: <https://github.com/markov2/perl5-XML-Compile-Cache> 5 * Download from CPAN: <ftp://ftp.cpan.org/pub/CPAN/authors/id/M/MA/MARKOV/> 6 * Indexed from CPAN: <http://search.cpan.org/~markov/XML-Compile-Cache/> 7 and <https://metacpan.org/release/XML-Compile-Cache> 8 9The XML-Compile suite is a large set of modules for various XML related 10standards. This optional component is very useful: it manages compiled 11handlers and helps you define prefixes. 12 13## Development → Release 14 15Important to know, is that I use an extension on POD to write the manuals. 16The "raw" unprocessed version is visible on GitHub. It will run without 17problems, but does not contain manual-pages. 18 19Releases to CPAN are different: "raw" documentation gets removed from 20the code and translated into real POD and clean HTML. This reformatting 21is implemented with the OODoc distribution (A name I chose before OpenOffice 22existed, sorry for the confusion) 23 24Clone from github for the "raw" version. For instance, when you want 25to contribute a new feature. 26 27On github, you can find the processed version for each release. But the 28better source is CPAN; to get it installed simply run: 29 30```sh 31 cpan -i XML::Compile::Cache 32``` 33 34## Contributing 35 36When you want to contribute to this module, you do not need to provide 37a perfect patch... actually: it is nearly impossible to create a patch 38which I will merge without modification. Usually, I need to adapt the 39style of code and documentation to my own strict rules. 40 41When you submit an extension, please contribute a set with 42 431. code 44 452. code documentation 46 473. regression tests in t/ 48 49**Please note:** 50When you contribute in any way, you agree to transfer the copyrights to 51Mark Overmeer (you will get the honors in the code and/or ChangeLog). 52You also automatically agree that your contribution is released under 53the same license as this project: licensed as perl itself. 54 55## Copyright and License 56 57This project is free software; you can redistribute it and/or modify it 58under the same terms as Perl itself. 59See <http://dev.perl.org/licenses/> 60