NAME

       Publican::Builder::DocBook5 - A module to Convert XML to various output formats

SYNOPSIS

           use Publican::Builder::DocBook5;
           my $builder = Publican::Builder::DocBook5->new();
           $builder->clean_ids();

DESCRIPTION

       Manipulate DocBook 4 XML and convert to other formats.

INTERFACE

   new
       Create a new Publican::Builder::DocBook5 object.

   setup_xml
       Create the proper directory structure for the XML, including copying in Brand files.

   clean_ids
       Travers over the source XML and update the id's to match the standard format.

       Updates all existing PO files with the new xref links.

   validate_xml
       Ensure the XML validates against the DTD.

       To debug the XML catalogs

       export XML_DEBUG_CATALOG=1

       test...

       unset XML_DEBUG_CATALOG

   get_author_list
       Return the author list for the supplied language.

       ## BUGBUG this should be moved to the DocBook sub classes

DIAGNOSTICS

       "unknown args %s"
           All subs with named parameters will return this error when unexpected named arguments
           are provided.

       "%s is a required argument"
           Any sub with a mandatory parameter will return this error if the parameter is undef.

CONFIGURATION AND ENVIRONMENT

       Publican requires no configuration files or environment variables.

DEPENDENCIES

       Carp version Publican Publican::XmlClean Publican::Translate File::Path File::pushd
       File::Find XML::LibXML Cwd Archive::Tar DateTime DateTime::Format::DateParse
       Syntax::Highlight::Engine::Kate HTML::TreeBuilder HTML::FormatText Term::ANSIColor POSIX

INCOMPATIBILITIES

       None reported.

BUGS AND LIMITATIONS

       No bugs have been reported.

       Please report any bugs or feature requests to "publican-list@redhat.com", or through the
       web interface at
       <https://bugzilla.redhat.com/bugzilla/enter_bug.cgi?product=Publican&component=publican>.

AUTHOR

       Jeff Fearn  "<jfearn@redhat.com>"