# NAME Genealogy::ChroniclingAmerica - Find URLs for a given person on the Library of Congress Newspaper Records # VERSION Version 0.03 # SYNOPSIS use HTTP::Cache::Transparent; # be nice use Genealogy::ChroniclingAmerica; HTTP::Cache::Transparent::init({ BasePath => '/tmp/cache' }); my $loc = Genealogy::ChroniclingAmerica->new({ firstname => 'John', lastname => 'Smith', state => 'Indiana', date_of_death => 1862 }); while(my $url = $loc->get_next_entry()) { print "$url\n"; } # SUBROUTINES/METHODS ## new Creates a Genealogy::ChroniclingAmerica object. It takes three mandatory arguments state, firstname and lastname. State must be the full name, not an abbreviation. There are four optional arguments: middlename, date\_of\_birth, date\_of\_death, ua and host: host is the domain of the site to search, the default is chroniclingamerica.loc.gov. ua is a pointer to an object that understands get and env\_proxy messages, such as [LWP::UserAgent::Throttled](https://metacpan.org/pod/LWP%3A%3AUserAgent%3A%3AThrottled). ## get\_next\_entry Returns the next match as a URL. # AUTHOR Nigel Horne, `` # BUGS If a middle name is given and no match is found, it should search again without the middle name. Please report any bugs or feature requests to `bug-genealogy-chroniclingamerica at rt.cpan.org`, or through the web interface at [http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Genealogy-ChroniclingAmerica](http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Genealogy-ChroniclingAmerica). I will be notified, and then you'll automatically be notified of progress on your bug as I make changes. # SEE ALSO [https://github.com/nigelhorne/gedcom](https://github.com/nigelhorne/gedcom) [https://chroniclingamerica.loc.gov](https://chroniclingamerica.loc.gov) # SUPPORT You can find documentation for this module with the perldoc command. perldoc Genealogy::ChroniclingAmerica You can also look for information at: - RT: CPAN's request tracker [http://rt.cpan.org/NoAuth/Bugs.html?Dist=Genealogy-ChroniclingAmerica](http://rt.cpan.org/NoAuth/Bugs.html?Dist=Genealogy-ChroniclingAmerica) - CPAN Ratings [http://cpanratings.perl.org/d/Genealogy-ChroniclingAmerica](http://cpanratings.perl.org/d/Genealogy-ChroniclingAmerica) - Search CPAN [https://metacpan.org/release/Genealogy-ChroniclingAmerica](https://metacpan.org/release/Genealogy-ChroniclingAmerica) # LICENSE AND COPYRIGHT Copyright 2018,2019 Nigel Horne. This program is released under the following licence: GPL2