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: