Under Windows95/NT, the
perldoc batch file that comes with the Win32 or Active State
distributions of Perl does not "page" properly at
times! (Most notably when using the -f switch !) The text "flys
off the screen" before you ever have a chance to read it!
Win NT users have the luxury of a scroll back function in their DOS windows. And if that's not enough, they can usually use a pipe to save the output to a text file. So, most of what is presented here applies only to Windows 95/98.
Apparently it's very difficult, if not impossible, to solve this problem using just the perldoc batch file (Windows95's DOS kernel -- COMMAND.COM -- has been called "brain dead" by a Perl expert who worked on the "port" to Win32 ).
I spent a lot of time writing a combination perl script and batch file to solve the problem. But since then, I've found a free editor which also captures DOS-window screen outputs. If you've never heard of PFE (Programmer's File Editor), read my review and download the program! You might still like to examine my own solution:
My first solution: A Perl script and another DOS batch file which runs the original perldoc batch file from the perl script! (Yes, a round about way to go, but it does have the extra benefit of producing a text file copy of the output screen which you can read/edit/save as desired.)
Download both the script and batch file (with PGP signatures) in this single .ZIP file: PGP signed pdoc.bat and pdoc.pl in a single 3 KB .zip file.
Or, copy both the script and batch files from these text pages: