Moving details about how the docs are built into a separate doc, allowing `documenting.rst` to focus on guidance for how to document passes/cells (and what the help text should contain).
Also puts cell help v2 and `Pass::formatted_help` as the primary means of providing help text, with the older styles being pseudo deprecated (or at least depreciated), reframing them as the more limited original methods rather than the default (despite functionally being that).
Still very much WIP.
Doesn't actually resolve the `:noindex:` failure, which is how I discovered the option wasn't being inherited, but it is a step in the right direction.
Use an external file to demonstrate the `autoref` role (the external file lets us `literalinclude` and `include` without writing out the source twice, while still showing all the different ways of using our custom roles).
Allow autoref to render `help *` as yoscrypt instead of trying to link when `*` starts with `<` or `-`, as in `help <command>` and `help -all`.
Fix autoref `help *` being linkable when there is a line break in the middle.
Move to a (single) `log_content_body()` instead of the dual `log_pass_str()` (nothing used the string-based indent arg), and pass the `ContentListing` directly; printing codeblocks verbatim (with indent).
Refactor (non-codeblock) line splitting slightly so that it can print up to and including 80 characters before the line break.
Add comments.
Add a sed command to the (top level) makefile for extract comment block for the specified cell. Works with both simlib.v and simcells.v (by abusing `%` pattern matching slightly to disambiguate which to search).
Split into cmd/cell sections. cmd json is in paragraphs, cell json is bullet points (and pending example).
Add (bullet point) section for warning flags.
Add note to `Pass::help()` about how each line should be a single `log()` call.
If a word by itself meets the max line length it should only drop to a new line if the current line has content (would previously force an empty line before it).
Include the length of indent when adding a line break (was previously only accounted for on the first line).
Also moved them to the bottom, instead of being under the "command help" heading.
Now includes more info about cells, and the custom sphinx domains/directives/roles we have.
