Added introduction to variables to the manual

Simple explanation about variables
Fixed typo
Changed examples comments

Formated the comments to match the rest of the manual
Corrected returned value
Merge pull request #6875 from brk00/patch-6

Added introduction to variables to the manual