File Coverage

blib/lib/DCLPod/Html.pm
Criterion Covered Total %
statement 64 822 7.7
branch 0 518 0.0
condition 0 138 0.0
subroutine 11 56 19.6
pod 0 46 0.0
total 75 1580 4.7


line stmt bran cond sub pod time code
1             package DCLPod::Html;
2 1     1   8867 use strict;
  1         4  
  1         64  
3             require Exporter;
4              
5 1     1   7 use vars qw($VERSION @ISA @EXPORT @EXPORT_OK);
  1         3  
  1         143  
6             $VERSION = 0.001;
7             # based upon Pod::Html $VERSION = 1.0501;
8             @ISA = qw(Exporter);
9             @EXPORT = qw(dcl2html htmlify);
10             @EXPORT_OK = qw(anchorify);
11              
12 1     1   7 use Carp;
  1         7  
  1         70  
13 1     1   5 use Config;
  1         4  
  1         47  
14 1     1   9 use Cwd;
  1         2  
  1         94  
15 1     1   5 use File::Spec;
  1         2  
  1         28  
16 1     1   10 use File::Spec::Unix;
  1         2  
  1         27  
17 1     1   1410 use Getopt::Long;
  1         16871  
  1         7  
18              
19 1     1   941 use locale; # make \w work right in non-ASCII lands
  1         216  
  1         4  
20              
21             =head1 NAME
22              
23             DCLPod::Html - module to convert pod files to HTML
24              
25             =head1 SYNOPSIS
26              
27             use DCLPod::Html;
28             dcl2html([options]);
29              
30             =head1 DESCRIPTION
31              
32             Converts files from pod format (see L) to HTML format. It
33             can automatically generate indexes and cross-references, and it keeps
34             a cache of things it knows how to cross-reference.
35              
36             =head1 ARGUMENTS
37              
38             DCLPod::Html takes the following arguments:
39              
40             =over 4
41              
42             =item backlink
43              
44             --backlink="Back to Top"
45              
46             Adds "Back to Top" links in front of every C heading (except for
47             the first). By default, no backlinks are generated.
48              
49             =item cachedir
50              
51             --cachedir=name
52              
53             Creates the item and directory caches in the given directory.
54              
55             =item css
56              
57             --css=stylesheet
58              
59             Specify the URL of a cascading style sheet. Also disables all HTML/CSS
60             C