pod fixes

[robkinyon]

What does the X<> do?

[Tux]

On Fri, 20 Sep 2013 04:24:47 -0700, Rob Kinyon notifications@github.com wrote:

What does the X<> do?

Add to the index, so that links like L work again

$ man perlpod "X" -- an index entry This is ignored by most formatters, but some may use it for building indexes. It always renders as empty-string. Example: "X"

Before patch:

DBM-Deep-2.0009-7ui2Fb 504 > podchecker lib/DBM/Deep.pod * WARNING: (section) in 'db_version()' deprecated at line 53 in file lib/DBM/Deep.pod * WARNING: alternative text '' contains non-escaped | or / at line 53 in file lib/DBM/Deep.pod * WARNING: (section) in 'DBM::Deep::Cookbook(3)' deprecated at line 1284 in file lib/DBM/Deep.pod * WARNING: (section) in 'perltie(1)' deprecated at line 1286 in file lib/DBM/Deep.pod * WARNING: (section) in 'Tie::Hash(3)' deprecated at line 1286 in file lib/DBM/Deep.pod * WARNING: (section) in 'Fcntl(3)' deprecated at line 1286 in file lib/DBM/Deep.pod * WARNING: (section) in 'flock(2)' deprecated at line 1286 in file lib/DBM/Deep.pod * WARNING: (section) in 'lockf(3)' deprecated at line 1286 in file lib/DBM/Deep.pod * WARNING: (section) in 'nfs(5)' deprecated at line 1287 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'OPTIONS' at line 183 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'OPTIONS' at line 197 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'OPTIONS' at line 228 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'export' at line 374 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'TIE CONSTRUCTION' at line 385 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'LARGE ARRAYS' at line 645 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'perldoc -f splice' at line 662 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'LARGE ARRAYS' at line 664 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'DB OVER NFS' at line 704 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'bug-DBM-Deep@rt.cpan.org' at line 1046 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'DBM-Deep@googlegroups.com' at line 1250 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'rkinyon@cpan.org' at line 1257 in file lib/DBM/Deep.pod * ERROR: unresolved internal link 'jhuckaby@cpan.org' at line 1259 in file lib/DBM/Deep.pod lib/DBM/Deep.pod has 13 pod syntax errors.

After patch

DBM-Deep-git 507 > podchecker lib/DBM/Deep.pod * WARNING: (section) in 'DBM::Deep::Cookbook(3)' deprecated at line 1315 in file lib/DBM/Deep.pod * WARNING: (section) in 'perltie(1)' deprecated at line 1317 in file lib/DBM/Deep.pod * WARNING: (section) in 'Tie::Hash(3)' deprecated at line 1317 in file lib/DBM/Deep.pod * WARNING: (section) in 'Fcntl(3)' deprecated at line 1317 in file lib/DBM/Deep.pod * WARNING: (section) in 'flock(2)' deprecated at line 1317 in file lib/DBM/Deep.pod * WARNING: (section) in 'lockf(3)' deprecated at line 1317 in file lib/DBM/Deep.pod *\ WARNING: (section) in 'nfs(5)' deprecated at line 1318 in file lib/DBM/Deep.pod lib/DBM/Deep.pod pod syntax OK.

FWIW, I started to dig into DBM-Deep for two reasons:

1. It fails installing on more recent perl (due to pod fail)
2. It gives me a DBI warning, which is just a warning, but it annoys me

t/02_hash.t ..................... 87/? DBI::db=HASH(0x185db48)->disconnect invalidates 1 active statement handle (either destroy statement handles or call finish on them before disconnecting) at /pro/3gl/CPAN/DBM-Deep-git/blib/lib/DBM/Deep/Storage/DBI.pm line 67.

H.Merijn Brand http://tux.nl Perl Monger http://amsterdam.pm.org/ using perl5.00307 .. 5.19 porting perl5 on HP-UX, AIX, and openSUSE http://mirrors.develooper.com/hpux/ http://www.test-smoke.org/ http://qa.perl.org http://www.goldmark.org/jeff/stupid-disclaimers/

[robkinyon]

Released as 2.0011