CPAN::Mini::ProjectDocs - mini CPAN documentation browser

see the mcd command for a full example.

This module and associated script mcd let you search and display documentation for the modules in you CPAN mini. The documentation is displayed in your browser (text mode browsers supported)

You most probably want to run the mcd script, use the --help option for help.

Given a CPAN mini location and a cache location, computes a list containing the paths used by CPAN::Mini::ProjectDocs.

Arguments

$cpan_mini - Location of the CPAN::MINI repository

$mcd_cache - Location of the cache maintained by CPAN::Mini::ProjectDocs

Returns - A list containing the paths used by CPAN::Mini::ProjectDocs

Exceptions - None

Generates the HTML documentation for $distribution. The generation is performed only if the documentation does not exist in the cache.

Arguments

$cpan_mini - Location of the CPAN::MINI repository

$mcd_cache - Location of the cache maintained by CPAN::Mini::ProjectDocs

$distribution - Location of the distribution containing the module to display

$html_index - Boolean - generate a pure HTML index for text based browser

Returns - $html_documentation_location

Exceptions - problems with the distribution extraction, write errors on the file system, ...

Generate a pure HTML index for text based browsers.

Arguments

$path - path to the POD::ProjDocs generated index file

$file - POD::ProjDocs generated index file

Returns - The location of the pure HTML index

Exceptions - None

Finds the distribution containing the module.

  my $distribution = get_module_distribution($cpan_mini, $mcd_cache, $module) ;

Arguments

$cpan_mini - Location of the CPAN::MINI repository

$mcd_cache - Location of the cache maintained by CPAN::Mini::ProjectDocs

$module - Name of the module to display

Returns - The location of the distribution containing the module to display

Exceptions - read error if the cache is not already generated

Checks the state of the CPAN::Mini::ProjectDocs cache and regenerates it if necessary.

Arguments

$cpan_mini - Location of the CPAN::MINI repository

$mcd_cache - Location of the cache maintained by CPAN::Mini::ProjectDocs

Returns - Nothing

Exceptions - None

Generates the CPAN::Mini::ProjectDocs cache.

Arguments

$cpan_mini - Location of the CPAN::MINI repository

$mcd_cache - Location of the cache maintained by CPAN::Mini::ProjectDocs

Returns - Nothing

Exceptions - File sytem related errors if any

Matches $module to all the modules in the CPAN mini repository and displays the match results.

Arguments

$cpan_mini - Location of the CPAN::MINI repository

$mcd_cache - Location of the cache maintained by CPAN::Mini::ProjectDocs

$module - Name of the module to match

Returns - Nothing

Exceptions

Returns the MD5 of the $file argument.

Arguments

$file - The location of the file to compute an MD5 for

Returns - A string containing the file md5

Exceptions - fails if the file can't be open

None so far.

	Nadim ibn hamouda el Khemir
	CPAN ID: NH
	mailto: nadim@cpan.org

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

You can find documentation for this module with the perldoc command.

    perldoc CPAN::Mini::ProjectDocs

You can also look for information at:

* AnnoCPAN: Annotated CPAN documentation

http://annocpan.org/dist/CPAN-Mini-ProjectDocs

* RT: CPAN's request tracker

Please report any bugs or feature requests to L <bug-cpan-mini-projectdocs@rt.cpan.org>.

We will be notified, and then you'll automatically be notified of progress on your bug as we make changes.

* Search CPAN

http://search.cpan.org/dist/CPAN-Mini-ProjectDocs

CPAN::Mini::Webserver, elinks