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