Update doc/manual/running-external-programs.rst

run now seems to return nothing rather than bool. 

added a way to read the output of the command. 
Merge pull request #1882 from aviks/patch-1

Update external programs documentation