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

+6 -7
+6 -7
pkgs/by-name/tr/treefmt/lib.nix
··· 15 15 16 16 # Inputs 17 17 18 - : A treefmt module. See [options reference]. 19 - 20 - [options reference]: https://nixos.org/manual/nixpkgs/unstable#sec-treefmt-options-reference 18 + `module` 19 + : A treefmt module. See [options reference](#sec-treefmt-options-reference). 21 20 */ 22 21 evalConfig = 23 22 module: ··· 49 48 50 49 # Inputs 51 50 52 - : A treefmt module. See [options reference]. 53 - 54 - [options reference]: https://nixos.org/manual/nixpkgs/unstable#sec-treefmt-options-reference 51 + `module` 52 + : A treefmt module. See [options reference](#sec-treefmt-options-reference). 55 53 */ 56 54 withConfig = 57 55 module: ··· 75 73 # Inputs 76 74 77 75 `settings` 78 - : A settings module, used to build a treefmt config file 76 + : A settings module, used to build a treefmt config file. 77 + See [`settings` option reference](#opt-treefmt-settings). 79 78 */ 80 79 buildConfig = 81 80 module: