1=pod 2 3=encoding utf8 4 5=head1 The Geo::GeoNames module 6 7This is the I<README> for the L<Geo::GeoNames> Perl module. You're probably 8looking at this because you don't know where else to find what you're 9looking for. Read this once and you might never have to read one again 10for any Perl module. 11 12=head2 Documentation 13 14To read about L<Geo::GeoNames>, look at the embedded documentation 15in the module itself. Inside the distribution, you can format it 16with L<perldoc|https://perldoc.perl.orgperldoc.html>: 17 18 % perldoc lib/Geo/GeoNames.pm 19 20If you have already installed the module, you can specify the module 21name instead of the file location: 22 23 % perldoc Geo::GeoNames 24 25You can read the documentation and inspect the meta data at 26L<MetaCPAN|https://metacpan.org/pod/Geo::GeoNames>. 27 28The standard module documentation has example uses in the SYNOPSIS 29section, but you can also look in the I<examples/> directory (if it's 30there), or look at the test files in I<t/>. 31 32=head2 Installation 33 34You can install this module with a CPAN client, which will resolve 35and install the dependencies: 36 37 % cpan Geo::GeoNames 38 % cpanm Geo::GeoNames 39 40You can also install directly from the distribution directory, which 41will also install the dependencies: 42 43 % cpan . 44 % cpanm . 45 46You could install just this module manually: 47 48 % perl Makefile.PL 49 % make 50 % make test 51 % make install 52 53You probably don't want to do that unless you're fiddling with the 54module and only want to run the tests without installing anything. 55 56=head2 Source location 57 58The meta data, such as the source repository and bug tracker, is in 59I<Makefile.PL> or the I<META.*> files it creates. You can find that on 60those CPAN web interfaces, but you can also look at files directly in 61the source repository: 62 63=over 4 64 65=item * L<https://github.com/briandfoy/geo-geonames> 66 67=back 68 69If you find a problem, file a ticket in the L<issue 70tracker|https://github.com/briandfoy/geo-geonames/issues>: 71 72=over 4 73 74=item * L<https://github.com/briandfoy/geo-geonames/issues> 75 76=back 77 78=head2 Getting help 79 80Although I'm happy to hear from module users in private email, 81that's the best way for me to forget to do something. 82 83Besides the issue trackers, you can find help at 84L<Perlmonks|http://www.perlmonks.org> or 85L<Stackoverflow|http://www.stackoverflow.com>, both of which have many 86competent Perlers who can answer your question, almost in real time. 87They might not know the particulars of this module, but they can help 88you diagnose your problem. 89 90You might like to read L<brian's Guide to Solving Any Perl 91Problem|http://archive.oreilly.com/pub/a/perl/excerpts/9780596527242/brians-guide.html>. 92 93=head2 Copyright and License 94 95You should have received a I<LICENSE> file, but the license is also noted 96in the module files. About the only thing you can't do is pretend that 97you wrote code that you didn't. 98 99=head2 Good luck! 100 101Enjoy, 102 103brian d foy, bdfoy@cpan.org 104 105=cut 106