phpdoc fixes

Perhaps better to just use `bool` here and default to `false`?