Test::Pod::Spelling::CommonMistakes - Checks POD for common spelling mistakes
#!/usr/bin/perl use strict; use warnings; use Test::More; eval "use Test::Pod::Spelling::CommonMistakes"; if ( $@ ) { plan skip_all => 'Test::Pod::Spelling::CommonMistakes required for testing POD'; } else { all_pod_files_ok(); }
This module checks your POD for common spelling errors. This differs than Test::Spelling because it doesn't use your system spellchecker and instead uses Pod::Spell::CommonMistakes for the heavy lifting. Using it is the same as any standard Test::* module, as seen here.
This function is what you will usually run. It automatically finds any POD in your distribution and runs checks on them.
Accepts an optional argument: an array of files to check. By default it checks all POD files it can find in the distribution. Every file it finds is passed to the pod_file_ok function.
pod_file_ok
pod_file_ok() will okay the test if there is spelling errors present in the POD. Furthermore, if the POD was malformed as reported by Pod::Simple, the test will fail and not attempt to check spelling.
pod_file_ok()
When it fails, pod_file_ok() will show any misspelled words and their suggested spelling as diagnostics.
The optional second argument $name is the name of the test. If it is omitted, pod_file_ok() chooses a default test name "Spelling test for $file".
Automatically exports the two subs.
Pod::Spell::CommonMistakes
You can find documentation for this module with the perldoc command.
perldoc Test::Pod::Spelling::CommonMistakes
Search CPAN
http://search.cpan.org/dist/Test-Pod-Spelling-CommonMistakes
AnnoCPAN: Annotated CPAN documentation
http://annocpan.org/dist/Test-Pod-Spelling-CommonMistakes
CPAN Ratings
http://cpanratings.perl.org/d/Test-Pod-Spelling-CommonMistakes
CPAN Forum
http://cpanforum.com/dist/Test-Pod-Spelling-CommonMistakes
RT: CPAN's Request Tracker
http://rt.cpan.org/NoAuth/Bugs.html?Dist=Test-Pod-Spelling-CommonMistakes
CPANTS Kwalitee
http://cpants.perl.org/dist/overview/Test-Pod-Spelling-CommonMistakes
CPAN Testers Results
http://cpantesters.org/distro/T/Test-Pod-Spelling-CommonMistakes.html
CPAN Testers Matrix
http://matrix.cpantesters.org/?dist=Test-Pod-Spelling-CommonMistakes
Git Source Code Repository
http://github.com/apocalypse/perl-test-pod-spelling-commonmistakes
Please report any bugs or feature requests to bug-test-pod-spelling-commonmistakes at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Test-Pod-Spelling-CommonMistakes. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.
bug-test-pod-spelling-commonmistakes at rt.cpan.org
Apocalypse <apocal@cpan.org>
Copyright 2010 by Apocalypse
This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.
The full text of the license can be found in the LICENSE file included with this module.
To install Test::Pod::Spelling::CommonMistakes, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Test::Pod::Spelling::CommonMistakes
CPAN shell
perl -MCPAN -e shell install Test::Pod::Spelling::CommonMistakes
For more information on module installation, please visit the detailed CPAN module installation guide.