document some non-obvious behavior of run and FROM
Merge pull request #14 from spoonium/dev/rafal/clnt-3070

document some non-obvious behavior of run and FROM