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 &rarr; 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