set `forin` option to `true`

Also includes documentation updates.