and I can't make any sense of the docs.

I learn best by example. The MANIFEST link on the IPC::Run CPAN page shows several scripts in its 'eg' directory, as well as the tests in the 't' directory. Perhaps those will help de-mystify the module.