Parrot::Docs::File - Docs-Related File
use Parrot::Docs::File; my $file = Parrot::Docs::File->new('MANIFEST');
Parrot::IO::File subclass adds a few documentation-related methods to do with POD and file type.
It's used by the documentation tools in tools/docs.
This is a class method that converts a file suffix to a description of the type of files which have this suffix.
This is a class method that converts a file name to a description of the type of files which have this name.
This first tries to find a type for the file's suffix, failing that it looks at the file's name. If it fails for both it returns 'Undefined'.
Returns whether the file is of the specified type.
Pod::Simple::Checker on the contents of the file. Executable files, and *.dump files are assumed not to contain POD and therefore not checked.
Note that the results are cached and the POD will only be rechecked if the file has been modified since it was checked.
Tells you whether there is any POD formatted documentation in the file. Executable files are assumed not to contain POD.
Tells you the number of POD errors in the file.
Gives you a description of any POD errors in the file.
Returns whether the file is suitable for inclusion in a documentation link.
If a file contains plain text rather than POD it may be directly linked to.
Returns the title of the file.
Returns a short description of the file extracted from the
NAME section of the POD documentation, if it exists. If an
ABSTRACT is found then that is preferred.