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