diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md new file mode 100644 index 0000000..8d65f9d --- /dev/null +++ b/CONTRIBUTING.md @@ -0,0 +1,29 @@ +# Contributing to XML::Parser + +Thank you for considering contributing to XML::Parser. + +## How to Contribute + +1. Fork the repository on GitHub: https://github.com/cpan-authors/XML-Parser +2. Create a topic branch from `main` +3. Make your changes and add tests where appropriate +4. Run the test suite: `perl Makefile.PL && make && make test` +5. Submit a pull request + +## Bug Reports + +Please file bug reports on the GitHub issue tracker: +https://github.com/cpan-authors/XML-Parser/issues + +Include the version of XML::Parser, Perl, and your operating system. + +## Coding Guidelines + +- Follow the existing code style +- Add tests for new functionality or bug fixes +- Keep changes focused — one concern per pull request + +## License + +By contributing, you agree that your contributions will be licensed under +the same terms as Perl itself. diff --git a/Makefile.PL b/Makefile.PL index 831b23b..1344fe9 100644 --- a/Makefile.PL +++ b/Makefile.PL @@ -160,6 +160,8 @@ sub MY::postamble { return join "\n", @ret; } +my $dist_version = MM->parse_version('Parser.pm'); + WriteMakefile1( ABSTRACT_FROM => 'Parser.pm', AUTHOR => 'Clark Cooper (coopercc@netheaven.com)', @@ -167,6 +169,31 @@ WriteMakefile1( MIN_PERL_VERSION => '5.008', META_MERGE => { 'meta-spec' => { version => 2 }, + provides => { + 'XML::Parser' => { + file => 'Parser.pm', + version => $dist_version, + }, + 'XML::Parser::Expat' => { + file => 'Expat/Expat.pm', + version => $dist_version, + }, + 'XML::Parser::Style::Debug' => { + file => 'Parser/Style/Debug.pm', + }, + 'XML::Parser::Style::Objects' => { + file => 'Parser/Style/Objects.pm', + }, + 'XML::Parser::Style::Stream' => { + file => 'Parser/Style/Stream.pm', + }, + 'XML::Parser::Style::Subs' => { + file => 'Parser/Style/Subs.pm', + }, + 'XML::Parser::Style::Tree' => { + file => 'Parser/Style/Tree.pm', + }, + }, resources => { bugtracker => { web => 'https://github.com/cpan-authors/XML-Parser/issues', diff --git a/Parser.pm b/Parser.pm index 3106f36..91a782b 100644 --- a/Parser.pm +++ b/Parser.pm @@ -1010,6 +1010,13 @@ For full details on each option, see L. BillionLaughsAttackProtectionActivationThreshold => 1024, ); +=head1 LICENSE + +This library is free software; you can redistribute it and/or modify it +under the same terms as Perl itself. + +See L for more information. + =head1 AUTHORS Larry Wall > wrote version 1.0. diff --git a/README.md b/README.md index 444020f..12136c1 100644 --- a/README.md +++ b/README.md @@ -640,6 +640,13 @@ For full details on each option, see ["new" in XML::Parser::Expat](https://metac BillionLaughsAttackProtectionActivationThreshold => 1024, ); +# LICENSE + +This library is free software; you can redistribute it and/or modify it +under the same terms as Perl itself. + +See [https://dev.perl.org/licenses/](https://dev.perl.org/licenses/) for more information. + # AUTHORS Larry Wall <`larry@wall.org`> wrote version 1.0. diff --git a/SECURITY.md b/SECURITY.md new file mode 100644 index 0000000..1362e23 --- /dev/null +++ b/SECURITY.md @@ -0,0 +1,25 @@ +# Security Policy + +## Reporting a Vulnerability + +If you discover a security vulnerability in XML::Parser, please report it +responsibly. + +**Contact:** Todd Rinaldo + +You may also open a [GitHub security advisory](https://github.com/cpan-authors/XML-Parser/security/advisories/new) +for private disclosure. + +Please include: + +- A description of the vulnerability +- Steps to reproduce the issue +- Any relevant version information + +We aim to acknowledge reports within 48 hours and provide a fix or +mitigation plan within a reasonable timeframe. + +## Supported Versions + +Security fixes are applied to the latest stable release. Users are +encouraged to keep their installations up to date.