help: document that [subpaths] may rewrite relative paths
The subpaths substitution logic first attempts to match the absolute
repository path, then the relative subrepository path if that failed.
#require docutils gettext $ $TESTDIR/check-gendoc it checking for parse errors