issue1606: Add warnings to the subprocess documentation about common pitfalls