Author image Clotho Advanced Media
and 1 contributors


AnnoCPAN::Perldoc::SyncDB - Download the AnnoCPAN database


Copyright Clotho Advanced Media Inc.

This software is released by Clotho Advanced Media, Inc. under the same terms as Perl itself. That means that it is dual-licensed under the Artistic license and the GPL, and that you can redistribute it and/or modify it under the terms of either or both of those licenses. See the "LICENSE" file, or visit

The definitive source of Clotho Advanced Media software is

All of our software is also available under commercial license. If the Artisic license or the GPL does not meet the needs of your project, please contact us at or visit the above URL.

We release open source software to help the world. We hope that you will enjoy this software, and we also hope and that you will hire us. As authors of this software, we are best able to help you integrate it into your project and to assist you with any problems.


    use AnnoCPAN::Perldoc::SyncDB;
       dest => "$ENV{HOME}/.annopod.db",
       verbose => 1,


This module provides a simple interface to mirror the content to a local machine. In conjunction with the AnnoCPAN::Perldoc module, this allows one to get all the benefits of the AnnoCPAN website in one's local perldoc command.

Recommended usage: 1) Install this module and AnnoCPAN::Perldoc, 2) set up a weekly process to run the syncannopod command included in this distribution, 3) Put the following in your shell configuration: alias perldoc annopod.



Returns the default URL for the annopod.db file. If there is an argument, it sets the default URL to that value before returning.


Mirrors the annopod.db file from the net. The behavior can be altered via hash-like options:

dest => filename

Specifies the filename where the downloaded file should be stored.

Defaults to the same location used by AnnoCPAN::Perldoc, or if that fails $HOME/.annopod.db ($HOME\annopod.db on Windows).

src => url

Specifies the net resource that should be mirrored.

Defaults to the baseurl property of this module.

timeout => seconds

Specifies the LWP::UserAgent timeout. Defaults to 30 seconds.

compress => flag

Specifies which version of the database to download. The options are bz2, gz, the empty string (i.e. no compression) or undef, which means autodetection. The autodetect mode checks if you have Compress::Bzip2 or Compress::Zlib installed before picking the best of the other flag values.

Defaults to undef (that is, autodetect mode).

verbose => boolean

Defaults to a false value. If set to true, this method prints status messages to the output filehandle.




Clotho Advanced Media Inc.,

Primary developer: Chris Dolan