Update external programs documentation

run now seems to return nothing rather than bool. 

added a way to read the output of the command.