CSAF 0.22 release

Changes

@@ -1,4 +1,4 @@
-Revision history for Perl extension CSAF.
+Revision history for CSAF.
 
-1.00 2024-xx-xx
-    - First release of CSAF
+0.22 2024-04-23
+    - First public release of CSAF

lib/App/CSAF/Downloader.pm

@@ -90,3 +90,67 @@ sub run {
 }
 
 1;
+
+__END__
+
+=encoding utf-8
+
+=head1 NAME
+
+App::CSAF::Downloader - Downloader Command Line Interface
+
+=head1 SYNOPSIS
+
+    use App::CSAF::Downloader qw(run);
+
+    run(\@ARGV);
+
+=head1 DESCRIPTION
+
+L<App::CSAF::Downloader> is a "Command Line Interface" helper module for C<csaf-downloader(1)> command.
+
+=head2 METHODS
+
+=over
+
+=item App::CSAF::Downloader->run(@args)
+
+=back
+
+Execute the command
+
+=head1 SUPPORT
+
+=head2 Bugs / Feature Requests
+
+Please report any bugs or feature requests through the issue tracker
+at L<https://github.com/giterlizzi/perl-CSAF/issues>.
+You will be notified automatically of any progress on your issue.
+
+=head2 Source Code
+
+This is open source software.  The code repository is available for
+public review and contribution under the terms of the license.
+
+L<https://github.com/giterlizzi/perl-CSAF>
+
+    git clone https://github.com/giterlizzi/perl-CSAF.git
+
+
+=head1 AUTHOR
+
+=over 4
+
+=item * Giuseppe Di Terlizzi <[email protected]>
+
+=back
+
+
+=head1 LICENSE AND COPYRIGHT
+
+This software is copyright (c) 2023-2024 by Giuseppe Di Terlizzi.
+
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.
+
+=cut

lib/App/CSAF/ROLIE.pm

@@ -105,3 +105,67 @@ sub run {
 }
 
 1;
+
+__END__
+
+=encoding utf-8
+
+=head1 NAME
+
+App::CSAF::ROLIE - ROLIE Command Line Interface
+
+=head1 SYNOPSIS
+
+    use App::CSAF::ROLIE qw(run);
+
+    run(\@ARGV);
+
+=head1 DESCRIPTION
+
+L<App::CSAF::ROLIE> is a "Command Line Interface" helper module for C<csaf-rolie(1)> command.
+
+=head2 METHODS
+
+=over
+
+=item App::CSAF::ROLIE->run(@args)
+
+=back
+
+Execute the command
+
+=head1 SUPPORT
+
+=head2 Bugs / Feature Requests
+
+Please report any bugs or feature requests through the issue tracker
+at L<https://github.com/giterlizzi/perl-CSAF/issues>.
+You will be notified automatically of any progress on your issue.
+
+=head2 Source Code
+
+This is open source software.  The code repository is available for
+public review and contribution under the terms of the license.
+
+L<https://github.com/giterlizzi/perl-CSAF>
+
+    git clone https://github.com/giterlizzi/perl-CSAF.git
+
+
+=head1 AUTHOR
+
+=over 4
+
+=item * Giuseppe Di Terlizzi <[email protected]>
+
+=back
+
+
+=head1 LICENSE AND COPYRIGHT
+
+This software is copyright (c) 2023-2024 by Giuseppe Di Terlizzi.
+
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.
+
+=cut

lib/App/CSAF/Validator.pm

@@ -72,3 +72,67 @@ sub run {
 }
 
 1;
+
+__END__
+
+=encoding utf-8
+
+=head1 NAME
+
+App::CSAF::Validator - Validator Command Line Interface
+
+=head1 SYNOPSIS
+
+    use App::CSAF::Validator qw(run);
+
+    run(\@ARGV);
+
+=head1 DESCRIPTION
+
+L<App::CSAF::Validator> is a "Command Line Interface" helper module for C<csaf-validator(1)> command.
+
+=head2 METHODS
+
+=over
+
+=item App::CSAF::Validator->run(@args)
+
+=back
+
+Execute the command
+
+=head1 SUPPORT
+
+=head2 Bugs / Feature Requests
+
+Please report any bugs or feature requests through the issue tracker
+at L<https://github.com/giterlizzi/perl-CSAF/issues>.
+You will be notified automatically of any progress on your issue.
+
+=head2 Source Code
+
+This is open source software.  The code repository is available for
+public review and contribution under the terms of the license.
+
+L<https://github.com/giterlizzi/perl-CSAF>
+
+    git clone https://github.com/giterlizzi/perl-CSAF.git
+
+
+=head1 AUTHOR
+
+=over 4
+
+=item * Giuseppe Di Terlizzi <[email protected]>
+
+=back
+
+
+=head1 LICENSE AND COPYRIGHT
+
+This software is copyright (c) 2023-2024 by Giuseppe Di Terlizzi.
+
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.
+
+=cut

lib/CSAF.pm

@@ -17,7 +17,7 @@ use overload '""' => \&to_string, fallback => 1;
 
 use Moo;
 
-our $VERSION = '0.21';
+our $VERSION = '0.22';
 
 our $CACHE = {};
 
@@ -65,6 +65,8 @@ sub TO_JSON   { shift->builder->TO_JSON }
 
 __END__
 
+=encoding utf-8
+
 =head1 NAME
 
 CSAF - Common Security Advisory Framework
@@ -121,6 +123,8 @@ L<https://docs.oasis-open.org/csaf/csaf/v2.0/os/csaf-v2.0-os.html>
 
 =head2 CSAF PROPERTIES
 
+These properties are inherited from L<CSAF::Document>.
+
 =over
 
 =item document

lib/CSAF/Base.pm

@@ -39,6 +39,8 @@ sub clone {
 
 __END__
 
+=encoding utf-8
+
 =head1 NAME
 
 CSAF::Base - CSAF base class

lib/CSAF/Builder.pm

@@ -40,3 +40,73 @@ sub build {
 sub TO_JSON { shift->build }
 
 1;
+
+
+__END__
+
+=encoding utf-8
+
+=head1 NAME
+
+CSAF::Builder - Build the CSAF document
+
+=head1 SYNOPSIS
+
+    use CSAF::Builder;
+    my $builder = CSAF::Builder->new( csaf => $csaf );
+
+    my $html = $renderer->render;
+
+
+=head1 DESCRIPTION
+
+L<CSAF::Builder> build and validate the CSAF document and prepare it for publishing.
+
+=head2 METHODS
+
+L<CSAF::Builder> inherits all methods from L<CSAF::Base> and implements the following new ones.
+
+=over
+
+=item $builder->build ( [$skip_validation = 0] )
+
+Build the CSAF document.
+
+=back
+
+
+=head1 SUPPORT
+
+=head2 Bugs / Feature Requests
+
+Please report any bugs or feature requests through the issue tracker
+at L<https://github.com/giterlizzi/perl-CSAF/issues>.
+You will be notified automatically of any progress on your issue.
+
+=head2 Source Code
+
+This is open source software.  The code repository is available for
+public review and contribution under the terms of the license.
+
+L<https://github.com/giterlizzi/perl-CSAF>
+
+    git clone https://github.com/giterlizzi/perl-CSAF.git
+
+
+=head1 AUTHOR
+
+=over 4
+
+=item * Giuseppe Di Terlizzi <[email protected]>
+
+=back
+
+
+=head1 LICENSE AND COPYRIGHT
+
+This software is copyright (c) 2023-2024 by Giuseppe Di Terlizzi.
+
+This is free software; you can redistribute it and/or modify it under
+the same terms as the Perl 5 programming language system itself.
+
+=cut