Add CLI options reference documentation

changelog/4492.doc.rst

@@ -0,0 +1 @@
+Added comprehensive CLI options reference documentation in the reference section, documenting all command-line flags with detailed descriptions and examples. Added a new ``:optionval:`` role for cross-referencing CLI options throughout the documentation.

doc/en/conf.py

@@ -293,6 +293,13 @@ def setup(app: sphinx.application.Sphinx) -> None:
         indextemplate="pair: %s; global variable interpreted by pytest",
     )
 
+    app.add_object_type(
+        "optionval",
+        "optionval",
+        objname="command-line option",
+        indextemplate="pair: %s; command-line option",
+    )
+
     app.add_crossref_type(
         directivename="hook",
         rolename="hook",