added comments to indicate required shell variables