fix and rephrase some sentences
$di may not be readily available
Merge pull request #338 from maxgalbu/patch-2

PHQL docs fixes for code and text