Docs: static opt macro list

Also adds `docs/tests/macro_commands.py` which checks all commands in
`code_examples/macro_commands` against the current yosys build. Format similar
to `run-test.sh` files: logging the file under test and reporting errors.

docs/source/code_examples/macro_commands/opt.ys

@@ -0,0 +1,14 @@
+#start: passes in the following order:
+#end: When called with -fast
+opt_expr
+opt_merge -nomux
+
+do
+    opt_muxtree
+    opt_reduce
+    opt_merge
+    opt_share  (-full only)
+    opt_dff  (except when called with -noff)
+    opt_clean
+    opt_expr
+while <changed design>

docs/source/using_yosys/synthesis/opt.rst

@@ -14,11 +14,9 @@ includes removing unused signals and cells and const folding. It is recommended
 to run this pass after each major step in the synthesis script.  As listed in
 :doc:`/cmd/opt`, this macro command calls the following ``opt_*`` commands:
 
-.. literalinclude:: /cmd/opt.rst
+.. literalinclude:: /code_examples/macro_commands/opt.ys
    :language: yoscrypt
-   :start-after: following order:
-   :end-at: while <changed design>
-   :dedent:
+   :start-after: #end:
    :caption: Passes called by :cmd:ref:`opt`
 
 .. _adv_opt_expr: