| Date: | Sun, 28 Dec 2003 14:36:03 -0600 |
| From: | Andy Lester <andy [...] petdance.com> |
| To: | bug-marc-record [...] rt.cpan.org |
| Subject: | Increase POD coverage |
The MARC-Record distribution has quite a few undocumented subroutines.
If they're for internal use only, then we should prepend them with
underscores. Otherwise, they should be documented.
$ perl ~/Pod-Coverage-0.12/examples/pod_cover.pl
Pod coverage analysis v1.00 (C) by Tels 2001.
Sun Dec 28 14:34:18 2003 Starting analysis:
MARC::Batch has a doc coverage of 100%.
MARC::Field has a doc coverage of 86.66%.
Uncovered routines are:
is_control_tag
warnings
MARC::File::MicroLIF has a doc coverage of 33.33%.
Uncovered routines are:
decode
in
MARC::File has a doc coverage of 62.5%.
Uncovered routines are:
close
decode
write
MARC::File::USMARC has a doc coverage of 100%.
MARC::Lint has a doc coverage of 66.66%.
Uncovered routines are:
check_245
warn
MARC::Record has a doc coverage of 60.86%.
Uncovered routines are:
append_fields
delete_field
insert_fields_after
insert_fields_before
insert_fields_ordered
insert_grouped_field
new_from_usmarc
set_leader_lengths
subfield
Summary:
sub routines total : 66
sub routines covered : 48
sub routines uncovered: 18
total coverage : 72.72%
--
Andy Lester => andy@petdance.com => www.petdance.com => AIM:petdance