Mailing List Archive

New pod2html
Enclosed is a modified pod2html such that it will recursively traverse the
directories spec'd on the command line and will dump the html for ALL files
found within the tree. It skips any file that would result in an empty html
document. If -destination is used to specify a destination directory, it
will write the resulting html into a tree structure identical to the
original tree of documents.

bugs:

- it works as well as the original pod2html

- it doesn't avoid producing directories with no files in them (when
-destination is specified)

- it doesn't automatically generate an index.html with nice formatting and
such (though it creates %docHash with references to lists of all the html in
each directory).

- It skips the 'auto' directory; no real reason other than i though it
unlikely that a pod would appear in there... just an assumption.

try:

r-pod2html -help

for usage information.

[.I hacqued it up so I could let it loose on my /usr/local/lib/site/perl5
directory without generating a bunch of empty html].

Improve, destroy, distribute, or laugh at it at will,
b.bum

[.to those on perl5-porters-- i hope to occasionally offset my bone-headed
questions (though, they are USUALLY founded in well thought out confusion)
with useful scripts]

begin 755 r-pod2html
M(R$O=7-R+VQO8V%L+V)I;B]P97)L"F5V86P@)V5X96,@<&5R;"`M4R`D,"`D
M>S$K(B1`(GTG"@EI9B`D<G5N;FEN9U]U;F1E<E]S;VUE7W-H96QL.PHC"B,@
M<BUP;V0R:'1M;"`M(&-O;G9E<G0@<&]D(&9O<FUA="!T;R!H=&UL"@HD9FEL
M95]N86UE"3T@)W(M<&]D,FAT;6PG.PHD9FEL95]M;&ES=`D]("<\8F)U;4!F
M<FED87DN8V]M/B<["B1F:6QE7V-O<'ER:6=H=`D]("=.;VYE+B<["B1F:6QE
M7V%U=&AO<@D]("=-86YY+B<["D!F:6QE7V-O;G1R:6)U=&]R<R`](`H@("`@
M*"=":6QL($)U;6=A<FYE<B`\8F)U;4!F<FED87DN8V]M/B<I.PHD9FEL95]R
M96QE87-E"3T@)S`N,"<["@HJ4E,@/2`J+SL**D524DY/(#T@*B$["@IU<V4@
M0V%R<#L*=7-E($=E=&]P=#HZ3&]N9SL*"B1O<'1?:&5L<`D@/2!U;F1E9CL@
M(R`M:&5L<#L@<VAO=R!U<V%G90HD;W!T7V1E8G5G"2`]('5N9&5F.R`C("UD
M96)U9SL@96YA8FQE('9E<F)O<VET>0HD;W!T7V1E<W1I;F%T:6]N(#T@=6YD
M968[(",@+61I<F5C=&]R>2!I;G1O('=H:6-H('1O(&1U<&QI8V%T92!T<F5E
M(&]F(&AT;6P*)&]P=%]S:&]W"2`]('5N9&5F.R`C("US:&]W.R!J=7-T('-H
M;W<@9FEL97,@=&\@8F4@<')O8V5S<V5D"B1O<'1?=F5R<VEO;B`@("`@/2!U
M;F1E9CL@(R`M=F5R<VEO;CL@<VAO=R!V97)S:6]N"@HF=7-A9V4*"75N;&5S
M<R`F1V5T3W!T:6]N<R@G:&5L<"<L"@D)"2`@("=D96)U9R$G+`H)"0D@("`G
M9&5S=&EN871I;VX]<R<L"@D)"2`@("=S:&]W(2<L"@D)"2`@("=V97)S:6]N
M)RD["@HF=7-A9V4*("!I9B`D;W!T7VAE;'`["@HF<VAO=U]V97)S:6]N"B`@
M:68@)&]P=%]V97)S:6]N.PH*)&=E;G-Y;2`](#`["@HC(&QO;VL@:6X@=&AE
M<V4@<&]D<R!F;W(@=&AI;F=S(&YO="!F;W5N9"!W:71H:6X@=&AE(&-U<G)E
M;G0@<&]D"D!I;F-L=7-I;VYS(#T@<7=;"B`@("`@<&5R;&9U;F,@<&5R;'9A
M<B!P97)L<G5N('!E<FQO<"`*73L*"B1O<'1?9&5S=&EN871I;VX@/2`B+B(*
M("!U;FQE<W,@)&]P=%]D97-T:6YA=&EO;CL*"B,@<'5S:"!R96UA:6YI;F<@
M87)G<R!A<R!D:7)E8W1O<FEE<PIP=7-H*$!D:7)E8W1O<FEE<RP@0$%21U8I
M('Q\('!U<V@H0&1I<F5C=&]R:65S+"`B+B(I.PH@(`HD03U[?3L*"B,@5&AE
M(&)E9VEN;FEN9R!O9B!T:&4@=7)L(&9O<B!T:&4@86YC:&]R<R!T;R!T:&4@
M;W1H97(@<V5C=&EO;G,N"B,@161I="`D='EP92!T;R!S=6ET+B`@270G<R!C
M;VYF:6=U<F5D(&9O<B!R96QA=&EV92!U<FPG<R!N;W<N"B1T>7!E/2<\02!(
M4D5&/2(G.PD)"@IS=6(@<V-A;E]D:7)E8W1O<GD@>PH@(&UY("@D9&ER*2`]
M($!?.PH@(&UY("@D9FEL92D["B`@;7D@*$!F:6QE<RD["B`@;7D@*$!R971U
M<FY&:6QE<RD["@H@('!R:6YT(")38V%N;FEN9R![)&1I<GU<;B(*("`@(&EF
M("1O<'1?9&5B=6<["B`@"B`@;W!E;F1I<BA$25(L("1D:7(I(&]R(&1I92`B
M0V%N)W0@;W!E;F1I<B`D9&ER.B`D15)23D\B(#L*("!`9FEL97,@/2!R96%D
M9&ER*$1)4BD["B`@8VQO<V5D:7(H1$E2*3L*("!F;W)E86-H("1F:6QE("A`
M9FEL97,I('L*("`@(&YE>'0*("`@("`@:68@)&9I;&4@/7X@;2%>7"XA('Q\
M("1F:6QE(#U^(&TA875T;R0A.PH@("`@<'5S:"A`<F5T=7)N1FEL97,L"@D@
M+60@(B1D:7(O)&9I;&4B(#\@)G-C86Y?9&ER96-T;W)Y*"(D9&ER+R1F:6QE
M(BD@.B`B)&1I<B\D9FEL92(I.PH@('T*("!`<F5T=7)N1FEL97,["GT*"D!0
M;V1S(#T@;6%P("AS8V%N7V1I<F5C=&]R>2@D7RDL($!D:7)E8W1O<FEE<RD[
M"@II9B`H)&]P=%]S:&]W*2!["B`@<')I;G0@:F]I;B@B7&XB+"!`4&]D<RD@
M+B`B7&XB.PH@(&5X:70["GT*"D!0;V1S(&]R(&1I92`B97AP96-T960@<&]D
M<R(["@HC(&QO;W`@='=I8V4@=&AR;W5G:"!T:&4@<&]D<RP@9FER<W0@=&\@
M;&5A<FX@=&AE(&QI;FMS+"!T:&5N('1O('!R;V1U8V4@:'1M;`IF;W(@)&-O
M=6YT("@P+#$I>PH@("`@*'!R:6YT(")38V%N;FEN9R!P;V1S+BXN7&XB*2!U
M;FQE<W,@)&-O=6YT.PH@("`@9F]R96%C:"`D<&]D9F@@*"!`4&]D<R`I('L*
M"2@D<&]D(#T@)'!O9&9H*2`]?B!S+UPN<&]D)"\O.PH)1&5B=6<H(F9I;&5S
M(BP@(F]P96YI;F<@,B`D<&]D9F@B("D["@DD4E,@/2`B7&X](CL*"6]P96XH
M)'!O9&9H+"(\(BXD<&]D9F@I("!\?"!D:64@(F-A;B=T(&]P96X@)'!O9&9H
M.B`D15)23D\B.PH)0&%L;#T\)'!O9&9H/CL*"6-L;W-E*"1P;V1F:"D["@DD
M4E,@/2`B7&XB.PH))&%L;%LP73U^<R]>/2\O.PH)9F]R*$!A;&PI>W,O/20O
M+SM]"@DD4&]D;F%M97-[)'!O9'T@/2`Q.PH))&EN7VQI<W0],#L*"21H=&UL
M/2(D;W!T7V1E<W1I;F%T:6]N+R(N)'!O9"XB+FAT;6PB.PH):68H)&-O=6YT
M("8F('-C86QA<B@E>R1!+3Y[)'!O9'TM/GLG2&5A9&5R<R=]?2DI>PH)("`D
M:'1M;"`]?B`@;2$H+BHI+RA;7B]=*RDD(3L*"2`@)&1I<B`]("0Q.PH)("`D
M:'1M;$9I;&4@/2`D,CL*"2`@*'!R:6YT(")#<F5A=&EN9R`D:'1M;"!F<F]M
M("1P;V1F:%QN(BD@:68@)&-O=6YT.PH)("!U;FQE<W,H+60@)#$I>PH)("`@
M("1C;60@/2`B;6MD:7)S("1D:7(B.PH)("`@('!R:6YT("@B)&-M9"XN+EQN
M(BD*"2`@("`@(&EF("1O<'1?9&5B=6<["@D@("`@<WES=&5M*")M:V1I<G,@
M)&1I<B(I.PH)("!]"@D@("1D;V-(87-H+3Y[)&1I<GT@/2!;70H)("`@('5N
M;&5S<R`D9&]C2&%S:"T^>R1D:7)].PH)("!P=7-H*$![)&1O8TAA<VA[)&1I
M<GU]+"`D:'1M;$9I;&4I.PH)("!O<&5N*$A434PL(CXD:'1M;"(I('Q\(&1I
M92`B8V%N)W0@8W)E871E("1H=&UL.B`D15)23D\B.PH)("`@('!R:6YT($A4
M34P@/#PG2%1-3%]?14]1)RP@/#PB2%1-3%]?14]142(["@D@("`@/"$M+2!<
M)%)#4V9I;&5<)%PD4F5V:7-I;VY<)%PD1&%T95PD("TM/@H)("`@(#PA+2T@
M7"1,;V=<)"`M+3X*"2`@("`\2%1-3#X*2%1-3%]?14]1"@D@("`@/%1)5$Q%
M/EQ5)'!O9%Q%/"]4251,13X*2%1-3%]?14]140H)?0H*"69O<B@D:3TP.R1I
M/#TD(V%L;#LD:2LK*7L*"@D@("`@)&%L;%LD:5T@/7X@+UXH7'<K*5QS*B@N
M*BE<;C\H6UY<,%TJ*20O(#L*"2`@("`H)&-M9"P@)'1I=&QE+"`D<F5S="D@
M/2`H)#$L)#(L)#,I.PH)("`@(&EF("@D8VUD(&5Q(")I=&5M(BD@>PH)"6EF
M*"1C;W5N="`I>PH)"2`@("`H)&1E<'1H*2!O<B!D;U]L:7-T*")O=F5R(BPD
M86QL6R1I72Q<)&EN7VQI<W0L7"1D97!T:"D["@D)("`@(&1O7VET96TH)'1I
M=&QE+"1R97-T+"1I;E]L:7-T*3L*"0E]"@D)96QS97L*"0D@("`@(R!S8V%N
M(&ET96T*"0D@("`@<V-A;E]T:&EN9R@B:71E;2(L)'1I=&QE+"1P;V0I.PH)
M"7T*"2`@("!]"@D@("`@96QS:68@*"1C;60@/7X@+UYH96%D*%LQ,ETI+RE[
M"@D))&YU;3TD,3L*"0EI9B@D8V]U;G0I>PH)"2`@("!D;U]H9'(H)&YU;2PD
M=&ET;&4L)')E<W0L)&1E<'1H*3L*"0E]"@D)96QS97L*"0D@("`@(R!H96%D
M97(@<V-A;@H)"2`@("!S8V%N7W1H:6YG*"1C;60L)'1I=&QE+"1P;V0I.R`C
M('-K:7`@:&5A9#$*"0E]"@D@("`@?0H)("`@(&5L<VEF("@D8VUD(#U^("]>
M;W9E<B\I('L*"0DD8V]U;G0@86YD("1D97!T:"!A;F0@9&]?;&ES="@B;W9E
M<B(L)&%L;%LD:2LQ72Q<)&EN7VQI<W0L7"1D97!T:"D["@D@("`@?0H)("`@
M(&5L<VEF("@D8VUD(#U^("]>8F%C:R\I('L*"0EI9B@D8V]U;G0I>PH)"2`@
M("`H)&1E<'1H*2!O<B!N97AT.R`C(&IU<W0@<VMI<"!I=`H)"2`@("!D;U]L
M:7-T*")B86-K(BPD86QL6R1I*S%=+%PD:6Y?;&ES="Q<)&1E<'1H*3L*"0D@
M("`@9&]?<F5S="@B)'1I=&QE+B1R97-T(BD["@D)?0H)("`@('T*"2`@("!E
M;'-I9B`H)&-M9"`]?B`O7F-U="\I('L*"0EN97AT.PH)("`@('T*"2`@("!E
M;'-I9B@D;W!T7V1E8G5G*7L*"0DH=V%R;B`B=6YR96-O9VYI>F5D(&AE861E
M<CH@)&-M9"(I(&EF("1O<'1?9&5B=6<["@D@("`@?0H)?0H@("`@("`@(",@
M8VQO<V4@;W!E;B!L:7-T<R!W:71H;W5T("<]8F%C:R<@<W1M=',*"6EF*"1C
M;W5N="E["@D@("`@=VAI;&4H)&1E<'1H*7L*"0D@9&]?;&ES="@B8F%C:R(L
M)&%L;%LD:2LQ72Q<)&EN7VQI<W0L7"1D97!T:"D["@D@("`@?0H)("`@('!R
M:6YT($A434P@(EQN/"](5$U,/EQN(CL*"7T*("`@('T*?0H*<W5B(&1O7VQI
M<W1["B`@("!M>2@D=VAI8V@L)&YE>'1?;VYE+"1L:7-T7W1Y<&4L)&1E<'1H
M*3U`7SL*("`@(&UY*"1K97DI.PH@("`@:68H)'=H:6-H(&5Q(")O=F5R(BE[
M"@DH)&YE>'1?;VYE(#U^("]>:71E;5QS*R@N*BDO("D@;W(@*'=A<FX@(D)A
M9"!L:7-T+"`D,5QN(BD@:68@)&]P=%]D96)U9SL*"21K97D])#$["@EI9B@D
M:V5Y(#U^("]>,5PN/R\I>PH))"1L:7-T7W1Y<&4@/2`B3TPB.PH)?0H)96QS
M:68H)&ME>2`]?B`O7"I<<RHD+RE["@DD)&QI<W1?='EP93TB54PB.PH)?0H)
M96QS:68H)&ME>2`]?B`O7"H_7',J7'<O*7L*"20D;&ES=%]T>7!E/2)$3"([
M"@E]"@EE;'-E>PH)*'=A<FX@(G5N:VYO=VX@;&ES="!T>7!E(&9O<B!I=&5M
M("1K97DB*2!I9B`D;W!T7V1E8G5G.PH)?0H)<')I;G0@2%1-3"!Q<7M<;GT[
M"@EP<FEN="!(5$U,('%Q>SPD)&QI<W1?='EP93Y].PH))"1D97!T:"LK.PH@
M("`@?0H@("`@96QS:68H)'=H:6-H(&5Q(")B86-K(BE["@EP<FEN="!(5$U,
M('%Q>UQN/"\D)&QI<W1?='EP93Y<;GT["@DD)&1E<'1H+2T["B`@("!]"GT*
M"G-U8B!D;U]H9')["B`@("!M>2@D;G5M+"1T:71L92PD<F5S="PD9&5P=&@I
M/4!?.PH@("`@*"1N=6T@/3T@,2D@86YD('!R:6YT($A434P@<7%[/'`^/&AR
M/EQN?3L*("`@('!R;V-E<W-?=&AI;F<H7"1T:71L92PB3D%-12(I.PH@("`@
M<')I;G0@2%1-3"!Q<7M<;CQ()&YU;3X@?3L*("`@('!R:6YT($A434P@)'1I
M=&QE.R`*("`@('!R:6YT($A434P@<7%[/"]()&YU;3Y<;GT["B`@("!D;U]R
M97-T*"1R97-T*3L*?0H*<W5B(&1O7VET96U["B`@("!M>2@D=&ET;&4L)')E
M<W0L)&QI<W1?='EP92D]0%\["B`@("!P<F]C97-S7W1H:6YG*%PD=&ET;&4L
M(DY!344B*3L*("`@(&EF*"1L:7-T7W1Y<&4@97$@(D1,(BE["@EP<FEN="!(
M5$U,('%Q>UQN/$14/CQ35%)/3D<^7&Y].PH)<')I;G0@2%1-3"`D=&ET;&4[
M(`H)<')I;G0@2%1-3"!Q<7M<;CPO4U123TY'/CPO1%0^7&Y].PH)<')I;G0@
M2%1-3"!Q<7L\1$0^7&Y].PH@("`@?0H@("`@96QS97L*"7!R:6YT($A434P@
M<7%[7&X\3$D^?3L*"2@D;&ES=%]T>7!E(&YE(")/3"(I("8F("AP<FEN="!(
M5$U,("1T:71L92PB7&XB*3L*("`@('T*("`@(&1O7W)E<W0H)')E<W0I.PH@
M("`@<')I;G0@2%1-3"`H)&QI<W1?='EP92!E<2`B1$PB("D_('%Q>SPO1$0^
M?2`Z('%Q>SPO3$D^?3L*?0H*<W5B(&1O7W)E<W1["B`@("!M>2@D<F5S="D]
M0%\["B`@("!M>2A`;&EN97,L)'`L)'$L)&QI;F4L+$!P87)A<RPD:6YP<F4I
M.PH@("`@0'!A<F%S/7-P;&ET*"]<;EQN*R\L)')E<W0I.PH@("`@9F]R*"1P
M/3`[)'`\/20C<&%R87,[)'`K*RE["@E`;&EN97,]<W!L:70H+UQN+RPD<&%R
M87-;)'!=*3L*"6EF*"1L:6YE<ULP72`]?B`O7EQS*UQW*EQT+BHO*7L@(",@
M;&ES=&EN9R!O<B!U;F]R9&5R960@;&ES=`H)("`@('!R:6YT($A434P@<7%[
M/%5,/GT["@D@("`@9F]R96%C:"`D;&EN92`H0&QI;F5S*7L@"@D)*"1L:6YE
M(#U^("]>7',K*%QW*BE<="@N*BDO*2`F)B`H*"1K97DL)')E;2D@/2`H)#$L
M)#(I*3L*"0EP<FEN="!(5$U,(&1E9FEN960H)%!O9&YA;65S>R1K97E]*2`_
M"@D)("`@("(\3$D^)'1Y<&4D:V5Y+FAT;6Q<(CXD:V5Y/%PO03Y<="1R96T\
M+TQ)/EQN(B`Z(`H)"0DB/$Q)/B1L:6YE/"],23Y<;B(["@D@("`@?0H)("`@
M('!R:6YT($A434P@<7%[/"]53#Y<;GT["@E]"@EE;'-I9B@D;&EN97-;,%T@
M/7X@+UY<<R\I>R`@("`@("`C('!R969O<FUA='1E9"!C;V1E"@D@("`@:68H
M)'!A<F%S6R1P72`]?B\^/GP\/"\I>PH)"7!R:6YT($A434P@<7%[7&X\4%)%
M/EQN?3L*"0DD:6YP<F4],3L*"2`@("!]"@D@("`@96QS97L*"0EP<FEN="!(
M5$U,('%Q>UQN/%A-4#Y<;GT["@D))&EN<')E/3`["@D@("`@?0II;FYE<CH*
M"2`@("!W:&EL92AD969I;F5D*"1P87)A<ULD<%TI*7L*"2`@("`@("`@0&QI
M;F5S/7-P;&ET*"]<;B\L)'!A<F%S6R1P72D["@D)9F]R96%C:"`D<2`H0&QI
M;F5S*7L*"0D@("`@:68H)'!A<F%S6R1P73U^+SX^?#P\+RE["@D)"6EF*"1I
M;G!R92E["@D)"2`@("!P<F]C97-S7W1H:6YG*%PD<2PB2%1-3"(I.PH)"0E]
M"@D)"65L<V4@>PH)"0D@("`@<')I;G0@2%1-3"!Q<7M<;CPO6$U0/EQN?3L*
M"0D)("`@('!R:6YT($A434P@<7%[/%!213Y<;GT["@D)"2`@("`D:6YP<F4]
M,3L*"0D)("`@('!R;V-E<W-?=&AI;F<H7"1Q+")(5$U,(BD["@D)"7T*"0D@
M("`@?0H)"2`@("!W:&EL92@D<2`]?B`@<R]<="LO)R`G>"`H;&5N9W1H*"0F
M*2`J(#@@+2!L96YG=&@H)&`I("4@."DO92E["@D)"3$["@D)("`@('T*"0D@
M("`@<')I;G0@2%1-3"`@)'$L(EQN(CL*"0E]"@D);&%S="!I9B`D<&%R87-;
M)'`K,5T@(7X@+UY<<R\["@D))'`K*SL*"2`@("!]"@D@("`@<')I;G0@2%1-
M3"`H)&EN<')E/3TQ*2`_("AQ<7M<;CPO4%)%/EQN?2D@.B`H<7%[7&X\+UA-
M4#Y<;GTI.PH)?0H)96QS97L@("`@("`@("`@("`@("`@("`@("`@("`@("`@
M(",@;W1H97(@=&5X=`H)("`@($!L:6YE<SUS<&QI="@O7&XO+"1P87)A<ULD
M<%TI.PH)("`@(&9O<F5A8V@@)&QI;F4@*$!L:6YE<RE["B`@("`@("`@("`@
M("`@("!P<F]C97-S7W1H:6YG*%PD;&EN92PB2%1-3"(I.PH)"7!R:6YT($A4
M34P@<7%[)&QI;F5<;GT["@D@("`@?0H)?0H)<')I;G0@2%1-3"!Q<7L\<#Y]
M.PH@("`@?0I]"@IS=6(@<')O8V5S<U]T:&EN9WL*("`@(&UY*"1T:&EN9RPD
M:'1Y<&4I/4!?.PH@("`@<')E7V5S8V%P97,H)'1H:6YG*3L*("`@(&9I;F1?
M<F5F<R@D=&AI;F<L)&AT>7!E*3L*("`@('!O<W1?97-C87!E<R@D=&AI;F<I
M.PI]"@IS=6(@<V-A;E]T:&EN9WL*("`@(&UY*"1C;60L)'1I=&QE+"1P;V0I
M/4!?.PH@("`@)%\])'1I=&QE.PH@("`@<R]<;B0O+SL*("`@(',O13PH+BH_
M*3XO)B0Q.R]G.PH@("`@(R!R96UO=F4@86YY(&9O<FUA='1I;F<@:6YF;W)M
M871I;VX@9F]R('1H92!H96%D97)S"B`@("!S+UM31D-"25T\*"XJ/RD^+R0Q
M+V<[("`@("`@("`@"B`@("`C('1H92`B9&]N)W0@9F]R;6%T(&UE(B!T:&EN
M9PH@("`@<R]:/#XO+V<["B`@("!I9B`H)&-M9"!E<2`B:71E;2(I('L*"B`@
M("`@("`@:68@*"]>7"HO*2`)>R`@<F5T=7)N('T@"2,@<VMI<"!B=6QL971S
M"B`@("`@("`@:68@*"]>7&0K7"XO*2`)>R`@<F5T=7)N('T@"2,@<VMI<"!N
M=6UB97)S"B`@("`@("`@<R\H+5MA+7I=*2XJ+R0Q+VD["@ET<FEM*"1?*3L*
M("`@("`@("!R971U<FX@:68@9&5F:6YE9"`D02T^>R1P;V1]+3Y[(DET96US
M(GTM/GLD7WT["B`@("`@("`@)$$M/GLD<&]D?2T^>R))=&5M<R)]+3Y[)%]]
M(#T@9V5N<WEM*"1P;V0L("1?*3L*("`@("`@("`D02T^>R1P;V1]+3Y[(DET
M96US(GTM/GLH<W!L:70H)R`G+"1?*2E;,%U]/21!+3Y[)'!O9'TM/GLB271E
M;7,B?2T^>R1??3L*("`@("`@("!$96)U9R@B:71E;7,B+"`B:71E;2`D7R(I
M.PH@("`@("`@(&EF("@A+UXM7'<D+R`F)B`O*%LE7"1<0%QW72LI+R`F)B`D
M,2!N92`D7R`*("`@(`D@("`@)B8@(61E9FEN960H)$$M/GLD<&]D?2T^>R))
M=&5M<R)]+3Y[)%]]*2`F)B`H)%\@;F4@)#$I*2`*("`@("`@("!["B`@("`)
M("`@("1!+3Y[)'!O9'TM/GLB271E;7,B?2T^>R0Q?2`]("1!+3Y[)'!O9'TM
M/GLB271E;7,B?2T^>R1??3L*("`@(`D@("`@1&5B=6<H(FET96US(BP@(FET
M96T@)#$@4D5&(%1/("1?(BD["B`@("`@("`@?2`*("`@("`@("!I9B`H(&U[
M7BAT<GQY?'-\;7QQ6W%W>%TI+RXJ6UXO77T@*2!["B`@("`)("`@(&UY("1P
M9B`]("0Q("X@)R\O)SL*("`@(`D@("`@)'!F("X]("(O(B!I9B`D,2!E<2`B
M='(B('Q\("0Q(&5Q(")Y(B!\?"`D,2!E<2`B<R(["B`@("`)("`@(&EF("@D
M<&8@;F4@)%\I('L*("`@(`D@("`@("`@("1!+3Y[)'!O9'TM/GLB271E;7,B
M?2T^>R1P9GT@/2`D02T^>R1P;V1]+3Y[(DET96US(GTM/GLD7WT["B`@("`)
M("`@("`@("!$96)U9R@B:71E;7,B+"`B:71E;2`D<&8@4D5&(%1/("1?(BD[
M"B`@("`)("`@('T*"7T*("`@('T*("`@(&5L<VEF("@D8VUD(#U^("]>:&5A
M9%LQ,ETO*7L@("`@("`@("`@("`@("`@"B`@("`@("`@<F5T=7)N(&EF(&1E
M9FEN960H)$AE861E<G-[)%]]*3L*("`@("`@("`D02T^>R1P;V1]+3Y[(DAE
M861E<G,B?2T^>R1??2`](&=E;G-Y;2@D<&]D+"`D7RD["B`@("`@("`@1&5B
M=6<H(FAE861E<G,B+"`B:&5A9&5R("1?(BD["B`@("!](`H@("`@96QS92![
M"B`@("`@("`@*'=A<FX@(G5N<F5C;V=N:7IE9"!H96%D97(Z("1C;60B*2!I
M9B`D;W!T7V1E8G5G.PH@("`@?2`*?0H*"G-U8B!P:6-R969S('L@"B`@("!M
M>2@D8VAA<BP@)&)I9VME>2P@)&QI;&ME>2PD:'1Y<&4I(#T@0%\["B`@("!M
M>2@D:V5Y+"1R968L)'!O9&YA;64I.PH@("`@9F]R("1P;V1N86UE("@D<&]D
M+$!I;F-L=7-I;VYS*7L*"69O<B`D<F5F("@@(DET96US(BP@(DAE861E<G,B
M("D@>PH)("`@(&EF("AD969I;F5D("1!+3Y[)'!O9&YA;65]+3Y[)')E9GTM
M/GLD8FEG:V5Y?2D@>PH)"21V86QU92`]("1!+3Y[)'!O9&YA;65]+3Y[)')E
M9GTM/GLD:V5Y/21B:6=K97E].PH)"41E8G5G*")S=6)S(BP@(F)I9VME>2!I
M<R`D8FEG:V5Y+"!V86QU92!I<R`D=F%L=65<;B(I.PH)("`@('T@"@D@("`@
M96QS:68@*&1E9FEN960@)$$M/GLD<&]D;F%M97TM/GLD<F5F?2T^>R1L:6QK
M97E]*2!["@D))'9A;'5E(#T@)$$M/GLD<&]D;F%M97TM/GLD<F5F?2T^>R1K
M97D])&QI;&ME>7T["@D)<F5T=7)N("(B(&EF("1L:6QK97D@97$@)R<["@D)
M1&5B=6<H(G-U8G,B+"`B;&EL:V5Y(&ES("1L:6QK97DL('9A;'5E(&ES("1V
M86QU95QN(BD["@D@("`@?2`*"7T@"@EI9B`H;&5N9W1H*"1K97DI*2!["B`@
M("`@("`@("`@("@D<&]D,BPD;G5M*2`]('-P;&ET*"]?+RPD=F%L=64L,BD[
M"@D@("`@:68H)&AT>7!E(&5Q(").04U%(BE[("`*"0ER971U<FX@(EQN/$$@
M3D%-13U<(B(N)'9A;'5E+B)<(CY<;B1B:6=K97D\+T$^7&XB"@D@("`@?0H)
M("`@(&5L<V5["@D)<F5T=7)N(")<;B1T>7!E)'!O9#(N:'1M;%PC(BXD=F%L
M=64N(EPB/B1B:6=K97D\7"]!/EQN(CL*"2`@("!]"@E](`H@("`@?0H@("`@
M:68@*"1C:&%R(#U^("];249=+RD@>PH)<F5T=7)N("(\14T^)&)I9VME>3PO
M14T^(CL*("`@('T@96QS:68H)&-H87(@/7X@+T,O*2!["@ER971U<FX@(CQ#
M3T1%/B1B:6=K97D\+T-/1$4^(CL*("`@('T@96QS92!["@ER971U<FX@(CQ3
M5%)/3D<^)&)I9VME>3PO4U123TY'/B(["B`@("!]"GT@"@IS=6(@9FEN9%]R
M969S('L@"B`@("!M>2@D=&AI;F<L)&AT>7!E*3U`7SL*("`@(&UY*"1O<FEG
M*2`]("0D=&AI;F<["B`@("`C($Q2148Z(&$@;6%N<&%G92@S9BD@=V4@9&]N
M)W0@:VYO=R!A8F]U=`H@("`@)"1T:&EN9SU^<SI,/"A;82UZ02U:75M>7'-<
M+UTK*2A<*%M>7"E=*UPI*3XZ=&AE($D\)#$^)#(@;6%N<&%G93IG.PH@("`@
M)"1T:&EN9SU^<R],/"A;7CY=*BD^+VQR969S*"0Q+"1H='EP92DO9V4["B`@
M("`D)'1H:6YG/7YS+RA;0TE"1ETI/"A<5RH_*"T_7'<J*2XJ/RD^+W!I8W)E
M9G,H)#$L("0R+"`D,RP@)&AT>7!E*2]G93L*("`@("0D=&AI;F<]?G,O*"A<
M=RLI7"A<*2DO<&EC<F5F<R@B22(L("0Q+"`D,BPD:'1Y<&4I+V=E.PH@("`@
M)"1T:&EN9SU^<R\H6UPD7$`E72@_(29;9VQ=="DH6UQW.ETK?%Q77&(I*2]V
M87)R969S*"0Q+"1H='EP92DO9V4["B`@("`H*"0D=&AI;F<@97$@)&]R:6<I
M("8F("@D:'1Y<&4@97$@(DY!344B*2D@)B8@"@DH)"1T:&EN9SUP:6-R969S
M*"))(BP@)"1T:&EN9RP@(B(L("1H='EP92DI.PI]"@IS=6(@;')E9G,@>PH@
M("`@;7DH)'!A9V4L("1I=&5M*2`]('-P;&ET*&TC+R,L("1?6S!=+"`R*3L*
M("`@(&UY*"1H='EP92D])%];,5T["B`@("!M>2@D<&]D;F%M92D["B`@("!M
M>2@D<V5C=&EO;BD@/2`D<&%G92`]?B`O7"@H+BHI7"DO.PH@("`@;7D@)'-E
M;&9R968["B`@("!I9B`H)'!A9V4@/7X@+UY;02U:72\@)B8@)&ET96TI('L*
M"21S96QF<F5F*RL["@DD:71E;2`]("(D<&%G92\D:71E;2(["@DD<&%G92`]
M("1P;V0["B`@("!]("!E;'-I9B`H(21I=&5M("8F("1P86=E(#U^("];7F$M
M>EPM72\@)B8@)'!A9V4@(7X@+UY<)"XD+RD@>PH))'-E;&9R968K*SL*"21I
M=&5M(#T@)'!A9V4["@DD<&%G92`]("1P;V0["B`@("!](`H@("`@)&ET96T@
M/7X@<R]<*%PI)"\O.PH@("`@:68@*"$D:71E;2D@>PH@("`@"6EF("@A9&5F
M:6YE9"`D<V5C=&EO;B`F)B!D969I;F5D("10;V1N86UE<WLD<&%G97TI('L*
M"2`@("!R971U<FX@(EQN)'1Y<&4D<&%G92YH=&UL7"(^7&YT:&4@/$5-/B1P
M86=E/"]%33X@;6%N<&%G93Q<+T$^7&XB.PH)?2!E;'-E('L*"2`@("`H=V%R
M;B`B0FEZ87)R92!E;G1R>2`D<&%G92\D:71E;2(I(&EF("1O<'1?9&5B=6<[
M"@D@("`@<F5T=7)N(")T:&4@/$5-/B1?6S!=/"]%33X@(&UA;G!A9V5<;B([
M"@E](`H@("`@?2`*"B`@("!I9B`H)&ET96T@/7X@<R\B*"XJ*2(O)#$O('Q\
M("@D:71E;2`]?B`O6UY<=UPO7"U=+R`F)B`D:71E;2`A?B`O7EPD+B0O*2D@
M>PH))'1E>'0@/2`B/$5-/B1I=&5M/"]%33XB.PH))')E9B`](")(96%D97)S
M(CL*("`@('T@96QS92!["@DD=&5X="`]("(\14T^)&ET96T\+T5-/B(["@DD
M<F5F(#T@(DET96US(CL*("`@('T@"B`@("!F;W(@)'!O9&YA;64@*"1P;V0L
M($!I;F-L=7-I;VYS*7L*"75N9&5F("1V86QU93L*"6EF("@D<F5F(&5Q("))
M=&5M<R(I('L*"2`@("!I9B`H9&5F:6YE9"@D=F%L=64@/2`D02T^>R1P;V1N
M86UE?2T^>R1R969]+3Y[)&ET96U]*2D@>PH)"2@D<&]D,BPD;G5M*2`]('-P
M;&ET*"]?+RPD=F%L=64L,BD["@D)<F5T=7)N("@H)'!O9"!E<2`D<&]D,BD@
M)B8@*"1H='EP92!E<2`B3D%-12(I*0H)("`@(`D_(")<;CQ!($Y!344]7"(B
M+B1V86QU92XB7"(^7&XD=&5X=#PO03Y<;B(*"2`@("`).B`B7&XD='EP921P
M;V0R+FAT;6Q<(R(N)'9A;'5E+B)<(CXD=&5X=#Q<+T$^7&XB.PH@("`@("`@
M("`@("!]"B`@("`@("`@?2`*"65L<VEF*"1R968@97$@(DAE861E<G,B*2![
M"@D@("`@:68@*&1E9FEN960H)'9A;'5E(#T@)$$M/GLD<&]D;F%M97TM/GLD
M<F5F?2T^>R1I=&5M?2DI('L*"0DH)'!O9#(L)&YU;2D@/2!S<&QI="@O7R\L
M)'9A;'5E+#(I.PH)"7)E='5R;B`H*"1P;V0@97$@)'!O9#(I("8F("@D:'1Y
M<&4@97$@(DY!344B*2D@"@D@("`@"3\@(EQN/$$@3D%-13U<(B(N)'9A;'5E
M+B)<(CY<;B1T97AT/"]!/EQN(@H)("`@(`DZ(")<;B1T>7!E)'!O9#(N:'1M
M;%PC(BXD=F%L=64N(EPB/B1T97AT/%PO03Y<;B(["B`@("`@("`@("`@('T*
M"7T*("`@('T*("`@("AW87)N(").;R`D<F5F(')E9F5R96YC92!F;W(@)&ET
M96T@*$!?*2(I(&EF("1O<'1?9&5B=6<["B`@("!R971U<FX@)'1E>'0["GT@
M"@IS=6(@=F%R<F5F<R!["B`@("!M>2`H)'9A<BPD:'1Y<&4I(#T@0%\["B`@
M("!F;W(@)'!O9&YA;64@*"1P;V0L0&EN8VQU<VEO;G,I>PH):68@*"1V86QU
M92`]("1!+3Y[)'!O9&YA;65]+3Y[(DET96US(GTM/GLD=F%R?2D@>PH)("`@
M("@D<&]D,BPD;G5M*2`]('-P;&ET*"]?+RPD=F%L=64L,BD["@D@("`@1&5B
M=6<H(G9A<G,B+"`B=V%Y(&-O;VP@+2T@=F%R(')E9B!O;B`D=F%R(BD["@D@
M("`@<F5T=7)N("@H)'!O9"!E<2`D<&]D,BD@)B8@*"1H='EP92!E<2`B3D%-
M12(I*2`@(R!)3DA%4DE4("1?+"`D<&]D"@D)/R`B7&X\02!.04U%/5PB(BXD
M=F%L=64N(EPB/EQN)'9A<CPO03Y<;B(*"0DZ(")<;B1T>7!E)'!O9#(N:'1M
M;%PC(BXD=F%L=64N(EPB/B1V87(\7"]!/EQN(CL*"7T*("`@('T*("`@($1E
M8G5G*"`B=F%R<R(L(")B=6UM97(L("1V87(@;F]T(&$@=F%R(BD["B`@("!R
M971U<FX@(CQ35%)/3D<^)'9A<CPO4U123TY'/B(["GT@"@IS=6(@9V5N<WEM
M('L*("`@(&UY("@D<&]D;F%M92P@)&ME>2D@/2!`7SL*("`@("1K97D@/7X@
M<R]<<RXJ+R\["B`@("`H)&ME>2`](&QC*"1K97DI*2`]?B!T<B]A+7HO7R]C
M<SL*("`@(&UY("1N86UE(#T@(B1[<&]D;F%M97U?)'MK97E]7S`B.PH@("`@
M)&YA;64@/7X@<R]?7R]?+V<["B`@("!W:&EL92`H)'-A=W-Y;7LD;F%M97TK
M*RD@>PH@("`@("`@("1N86UE(#U^(',O7S\H7&0K*20O)U\G("X@*"0Q("L@
M,2DO93L*("`@('T*("`@(')E='5R;B`D;F%M93L*?2`*"G-U8B!P<F5?97-C
M87!E<R!["B`@("!M>2@D=&AI;F<I/4!?.PH@("`@)"1T:&EN9SU^<R\F+VYO
M<F5M87`H(B9A;7`[(BDO9V4["B`@("`D)'1H:6YG/7YS+SP\+VYO<F5M87`H
M(B9L=#LF;'0[(BDO96<["B`@("`D)'1H:6YG/7YS+R@_.EM>15-)0DQ#1ETI
M/"]N;W)E;6%P*"(F;'0[(BDO96<["B`@("`D)'1H:6YG/7YS+T4\*%M>7"]=
M6UX\/ETJ*3XO7"8D,5P[+V<[("`@("`@("`@("`@("`C(&5M8F5D9&5D('-P
M96-I86P*?0H*<W5B(&YO<F5M87`@>PH@("`@;7D@)&AI9&4@/2`D7ULP73L*
M("`@("1H:61E(#U^('1R+UPP,#`M7#$W-R]<,C`P+5PS-S<O.PH@("`@)&AI
M9&4["GT@"@IS=6(@<&]S=%]E<V-A<&5S('L*("`@(&UY*"1T:&EN9RD]0%\[
M"B`@("`D)'1H:6YG/7YS+UM>1TU=/CXO7"9G=%P[7"9G=%P[+V<["B`@("`D
M)'1H:6YG/7YS+RA;7B)-1T%%72D^+R0Q7"9G=%P[+V<[(",@(@H@("`@)"1T
M:&EN9SU^='(O7#(P,"U<,S<W+UPP,#`M7#$W-R\["GT*"G-U8B!$96)U9R![
M"B`@("!M>2`D;&5V96P@/2!S:&EF=#L*("`@('!R:6YT(%-41$524B!`7RPB
M7&XB(&EF("1O<'1?9&5B=6=[)&QE=F5L?3L*?2`*"G-U8B!D=6UP=&%B;&4@
M('L*("`@(&UY("1T(#T@<VAI9G0["B`@("!P<FEN="!35$1%4E(@(E1!0DQ%
M($1535`@)'1<;B(["B`@("!F;W)E86-H("1K("AS;W)T(&ME>7,@)21T*2![
M"@EP<FEN=&8@4U1$15)2("(E+3(P<R`\)7,^7&XB+"`D="T^>R1K?2P@)&L[
M"B`@("!](`I](`IS=6(@=')I;2!["B`@("!F;W(@*$!?*2!["B`@("`@("`@
M<R]>7',K+R\["B`@("`@("`@<R]<<UQN/R0O+SL*("`@('T*?0H*<W5B('5S
M86=E('L*("`@("1E<G)O<E]F;70@/2!S:&EF=#L*("`@(`H@("`@<V5L96-T
M*%-41$524BD["B`@("`*("`@('!R:6YT9B`B)&9I;&5?;F%M93H@)&5R<F]R
M7V9M=%QN(BP@0%\*"6EF("1E<G)O<E]F;70["@H@("`@<')I;G0@/#Q?14Y$
M3T954T%'15\["B1F:6QE7VYA;64@6RUV97)S:6]N72!;+6AE;'!=(%LM9&5B
M=6==(%LM9&5S=&EN871I;VX@/#QD:7)E8W1O<GD^/ET@6RUS:&]W72`*("!;
M<&]D+61I<B!;<&]D+61I<B!;+BXN75U="B`@=7-A9V4Z"B`@("`M:&5L<"`@
M("`@("`@('-H;W<@:&5L<"!A;F0@97AI=`H@("`@+79E<G-I;VX@("`@("!S
M:&]W('9E<G-I;VX@86YD(&-O;G1A8W0@:6YF;R!A;F0@97AI=`H@("`@+61E
M<W1I;F%T:6]N("!W<FET92!H=&UL(&EN=&\@9&ER96-T;W)Y('-P96-I9FEE
M9"!B>2!A<F<*("`@("US:&]W("`@("`@("`@<VAO=R!F:6QE<R!T;R!B92!P
M<F]C97-S960@86YD(&5X:70*("`@("UD96)U9R`@("`@("`@<W!E=R!D96)U
M9V=I;F<@;65S<V%G97,*7T5.1$]&55-!1T5?"B`@("!E>&ET*#$I.PI]"@HC
M"B,@4VAO=R!V97)S:6]N(&%N9"!C;W!Y<FEG:'0@:6YF;W)M871I;VX*(PIS
M=6(@<VAO=U]V97)S:6]N"GL*("`@('!R:6YT(")4:&ES(&ES("1F:6QE7VYA
M;64@4F5L96%S92`D9FEL95]R96QE87-E7&XB.PH@("`@<')I;G0@(E=R:71T
M96X@8GD@)&9I;&5?875T:&]R7&XB.PH@("`@<')I;G0@(D-O<'ER:6=H="`D
M9FEL95]C;W!Y<FEG:'1<;B(["B`@("!P<FEN="`B4&QE87-E('-E;F0@8G5G
M<R!A;F0@<W5G9V5S=&EO;G,@=&\Z("1F:6QE7VUL:7-T7&XB.PH@("`@<')I
M;G0@(D-O;G1R:6)U=&EO;G,@8GDZ7&Y<="(["B`@("!P<FEN="!J;VEN*")<
M;EQT(BP@0&9I;&5?8V]N=')I8G5T;W)S*2P@(EQN(@H):68@<V-A;&%R*$!F
B:6QE7V-O;G1R:6)U=&]R<RD["B`@("!E>&ET*#`I.PI]"F8@
`
end
Re: New pod2html [ In reply to ]
First you need to use the latest version, at:

ftp://ftp.metronet.com/perl/perl5/manual/pod2html

Also, to keep thing's from getting too messy, I'd
appreciate it if patches would come to me first, please.

I'm not sure how close Larry is to a release, but
until I get a better look at this new feature, I'd
much rather have the current version at metronet
included. I'll try to find some time this weekend to
look at this stuff again.

Bill
Re: New pod2html [ In reply to ]
>bugs:
>
>- it works as well as the original pod2html

I find it most unnerving that this statement falls under the heading of "bugs".

:-)

Randy
--
^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^v^
Randy J. Ray -- U S WEST Technologies IAD/CSS/DPDS Phone: (303)607-5268
Denver, CO rjray@lookout.ecte.uswc.uswest.com

I don't suffer from insanity. I enjoy every minute of it.