Adding some clarification about the use of --out=json and the output.
Merge pull request #6600 from TheRealBill/develop

Adding some clarification about the use of --out=json and the output.