waitpid for the man process to exit

[afresh1]

Without waiting on the forked process, we may check the status of the wrong $?.

Fix from millert@openbsd

This happens at least on OpenBSD and I've heard on FreeBSD using mandoc.

http://mandoc.bsd.lv/

$ cd Pod-Perldoc
$ PERL5LIB=lib ./perldoc -oMan Digest
Error from pipe to /usr/bin/mandoc!

 at lib/Pod/Perldoc.pm line 1517.
Falling back to Pod because there was a problem!

 at lib/Pod/Perldoc.pm line 1517.
Error while formatting with Pod::Perldoc::ToMan:
 Can't read-open Pod::Perldoc::ToMan=HASH(0x43a208de958): No such file or directory
Aborting
 at lib/Pod/Perldoc/ToMan.pm line 407.


 at ./perldoc line 6.
Got a 0-length file from /usr/libdata/perl5/Digest.pm via Pod::Perldoc::ToMan!?

 at ./perldoc line 6.

[briandfoy]

I've just taken over the maintenance of Pod::Perldoc, so I'll look into this. I know it's years old, and it might take me a bit to catch up.

[briandfoy]

It turns out that this use of waitpid can hang on Windows, but I fixed that in #52.

[karenetheridge]

Wow, nice timing. I just updated to macos 14.1.2 and encountered the error described in https://www.mail-archive.com/[email protected]/msg51445.html, which brought me here.

(For anyone else reading, the environment variable changes described there did work for me -- export PERLDOC=-oTerm PERLDOC_PAGER='less -R'.)