Fix documentation build and prettify docs.

Author: cwalther

shared-bindings/supervisor/__init__.c

@@ -113,33 +113,33 @@ MP_DEFINE_CONST_FUN_OBJ_1(supervisor_set_next_stack_limit_obj, supervisor_set_ne
 //| def set_next_code_file(filename: Optional[str], /, *, reload_on_success : bool = False, reload_on_error: bool = False, sticky_on_success: bool = False, sticky_on_error: bool = False, sticky_on_reload: bool = False) -> None:
 //|     """Set what file to run on the next vm run.
 //|
-//|     When not None, the given filename is inserted at the front of the usual ['code.py',
+//|     When not ``None``, the given ``filename`` is inserted at the front of the usual ['code.py',
 //|     'main.py'] search sequence.
 //|
 //|     The optional keyword arguments specify what happens after the specified file has run:
 //|
-//|     sticky_on_… determine whether the newly set filename and options stay in effect: If True,
-//|     further runs will continue to run that file (unless it says otherwise by calling
-//|     set_next_code_filename() itself). If False, the settings will only affect one run and revert
-//|     to the standard code.py/main.py afterwards.
+//|     ``sticky_on_…`` determine whether the newly set filename and options stay in effect: If
+//|     True, further runs will continue to run that file (unless it says otherwise by calling
+//|     ``set_next_code_filename()`` itself). If False, the settings will only affect one run and
+//|     revert to the standard code.py/main.py afterwards.
 //|
-//|     reload_on_… determine how to continue: If False, wait in the usual "Code done running.
+//|     ``reload_on_…`` determine how to continue: If False, wait in the usual "Code done running.
 //|     Waiting for reload. / Press any key to enter the REPL. Use CTRL-D to reload." state. If
 //|     True, reload immediately as if CTRL-D was pressed.
 //|
-//|     …_on_success take effect when the program runs to completion or calls sys.exit().
+//|     ``…_on_success`` take effect when the program runs to completion or calls ``sys.exit()``.
 //|
-//|     …_on_error take effect when the program exits with an exception, including the
+//|     ``…_on_error`` take effect when the program exits with an exception, including the
 //|     KeyboardInterrupt caused by CTRL-C.
 //|
-//|     …_on_reload take effect when the program is interrupted by files being written to the USB
-//|     drive (auto-reload) or when it calls supervisor.reload().
+//|     ``…_on_reload`` take effect when the program is interrupted by files being written to the USB
+//|     drive (auto-reload) or when it calls ``supervisor.reload()``.
 //|
 //|     These settings are stored in RAM, not in persistent memory, and will therefore only affect
 //|     soft reloads. Powering off or resetting the device will always revert to standard settings.
 //|
 //|     When called multiple times in the same run, only the last call takes effect, replacing any
-//|     settings made by previous ones. This is the main use of passing None as a filename: to
+//|     settings made by previous ones. This is the main use of passing ``None`` as a filename: to
 //|     reset to the standard search sequence."""
 //|     ...
 //|