fix some missing links in comments and some undocumented parameters