tests/docs/pod-t

   1 #!/usr/bin/perl
   2 #
   3 # Check all POD documents in the tree, except for any embedded Perl module
   4 # distribution, for POD formatting errors.
   5 #
   6 # The canonical version of this file is maintained in the rra-c-util package,
   7 # which can be found at <http://www.eyrie.org/~eagle/software/rra-c-util/>.
   8 #
   9 # Written by Russ Allbery <eagle@eyrie.org>
  10 # Copyright 2012, 2013, 2014
  11 #     The Board of Trustees of the Leland Stanford Junior University
  12 #
  13 # Permission is hereby granted, free of charge, to any person obtaining a
  14 # copy of this software and associated documentation files (the "Software"),
  15 # to deal in the Software without restriction, including without limitation
  16 # the rights to use, copy, modify, merge, publish, distribute, sublicense,
  17 # and/or sell copies of the Software, and to permit persons to whom the
  18 # Software is furnished to do so, subject to the following conditions:
  19 #
  20 # The above copyright notice and this permission notice shall be included in
  21 # all copies or substantial portions of the Software.
  22 #
  23 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  24 # IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  25 # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  26 # THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  27 # LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
  28 # FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
  29 # DEALINGS IN THE SOFTWARE.
  30
  31 use 5.006;
  32 use strict;
  33 use warnings;
  34
  35 use lib "$ENV{SOURCE}/tap/perl";
  36
  37 use Test::More;
  38 use Test::RRA qw(skip_unless_automated use_prereq);
  39 use Test::RRA::Automake qw(automake_setup perl_dirs);
  40
  41 # Skip this test for normal user installs, since we normally pre-generate all
  42 # of the documentation and the end user doesn't care.
  43 skip_unless_automated('POD syntax tests');
  44
  45 # Load prerequisite modules.
  46 use_prereq('Test::Pod');
  47
  48 # Set up Automake testing.
  49 automake_setup();
  50
  51 # Run the tests.
  52 all_pod_files_ok(perl_dirs());