Add note to docs about lack of shell processing in JSON form

While in there I tried to make the use of "shell form" vs "exec form" a little more consistent.

Closes #5509

Signed-off-by: Doug Davis <dug@us.ibm.com>