treefmt: improve how doc-comments render in the manual
1. Use internal links for other manual sections
2. Fix definition-list syntax
Currently, `:doc` doesn't support rendering clickable links anyway, so
we don't loose much by having relative links.
authored by Matt Sturgeon and committed by Valentin Gagarin 6e5c68be 4c638c27