fish-shell/doc_src
Aaron Gyes 42239d4dd8 fish.rst: do better
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/*.
2021-11-04 13:16:13 -07:00
..
cmds fish.rst: do better 2021-11-04 13:16:13 -07:00
python_docs_theme run fish.png through imageoptim 2021-10-16 14:33:12 -07:00
commands.rst docs: Hand-write a list of short descriptions in commands 2021-10-23 16:46:15 +02:00
completions.rst docs: Replace all internal links with :ref:s 2021-03-26 19:32:14 +01:00
conf.py sphinx: enable proper quotes with the smartquotes module 2021-10-26 10:46:06 -07:00
design.rst Make rationale spacing consistent 2020-10-12 20:25:35 +02:00
faq.rst docs: Go over the FAQ again 2021-10-29 17:14:53 +02:00
fish_for_bash_users.rst docs: Expand string-for-bash-users section 2021-11-03 17:29:51 +01:00
fish_indent_lexer.py Highlight options differently 2021-10-19 17:20:21 +02:00
index.rst docs: Move configuration section to language 2021-10-23 17:13:36 +02:00
interactive.rst Document turning off suggestions/history 2021-11-02 21:40:56 +01:00
language.rst docs: Expand math for bash users a bit 2021-11-03 17:23:36 +01:00
license.rst Update copyright years 2021-05-03 13:12:11 +02:00
relnotes.rst docs: call the CHANGELOG "release notes" 2021-02-25 22:46:24 +08:00
tutorial.rst Document turning off suggestions/history 2021-11-02 21:40:56 +01:00