Re: "pp -h" produces gross output

On 19 Sep 2004 at 1:26, Glenn Linderman wrote:

> windows 2000 SP4, perl 5.8.4 ActiveState build 810
> 
> So why did I encounter this for PAR, first?  Probably because most 
> modules have all their documentation in the HTML form, but I couldn't 
> find such for pp.  So I tried "pp -h", and there was the problem.

If you install from ppm, you get HTML docs, but if you install any other way 
you 
generally don't. The pp doc is just pod and you have pod2html.bat.

    pod2html pp > pp.html

If you make a little script:

    # update HTML TOC after non-ppm installation
    use ActivePerl::DocTools;
    ActivePerl::DocTools::WriteTOC();

you can copy the pp.html to someplace in the ActivePerl HTML tree and run that 
to add 
it to the HTML index.

Those steps are what ppm does for you. 

BTW, if you use my "gpp", you'll get the tooltips and a help window with the pp 
doc in 
it. Wait for PAR 0.86 for a gpp bug fix.

Alan Stewart