mirror of
https://github.com/fish-shell/fish-shell.git
synced 2025-02-21 18:41:35 +08:00

This fixes the indentation problem for the SYNOPSIS section by not inserting the :: literal block. Format it the same way Sphinx does their own manpages for commands. Use more semantic markup, like :command:, so that commands are highlighted in the man pages. Split by sentence to give `man` a chance to ascertain lines. Long-term, it should be possible to teach Sphinx to turn :command:s into references and get us automatic links to articles for matching cmds/*.