NAME

       Text::BibTeX::Validate - validator for BibTeX format

SYNOPSIS

           use Text::BibTeX;
           use Text::BibTeX::Validate qw( validate_BibTeX );

           my $bibfile = Text::BibTeX::File->new( 'bibliography.bib' );
           while( my $entry = Text::BibTeX::Entry->new( $bibfile ) ) {
               for my $warning (validate_BibTeX( $entry )) {
                   print STDERR "$warning\n";
               }
           }

DESCRIPTION

       Text::BibTeX::Validate checks the standard fields of BibTeX entries for their compliance
       with their format. In particular, value of "email" is checked against RFC 822 mandated
       email address syntax, value of "doi" is checked to start with 10. and contain at least one
       "/" and so on.  Some nonstandard fields as "isbn", "issn" and "url" are also checked.
       Failures of checks are returned as instances of Text::BibTeX::Validate::Warning.

METHODS

   validate_BibTeX( $what )
       Takes plain Perl hash reference containing BibTeX fields and their values, as well as
       Text::BibTeX::Entry instances and returns an array of validation messages as instances of
       Text::BibTeX::Validate::Warning.

   clean_BibTeX( $what )
       Takes the same input as "validate_BibTeX" and attempts to reconcile trivial issues like
       dropping the resolver URL part of DOIs (see "shorten_DOI" method) and converting month
       numbers into three-letter abbreviations.

   shorten_DOI( $doi )
       Remove the resolver URL part, as well as "doi:" prefixes, from DOIs.

AUTHORS

       Andrius Merkys, <merkys@cpan.org>