tmp

doc/source/commandline.rst

@@ -208,3 +208,12 @@ Remove contact:
 
 .. |khard.conf| replace:: :manpage:`khard.conf`
 .. _khard.conf: man/khard.conf.html
+
+
+command line usage 2
+====================
+
+.. argparse::
+  :module: khard.cli
+  :func: _sphinxarg_helper
+  :prog: khard

doc/source/conf.py

@@ -53,6 +53,7 @@ def update_template_file():
     'sphinx.ext.autosectionlabel',
     'sphinx.ext.todo',
     'sphinx_autodoc_typehints',  # https://pypi.org/project/sphinx-autodoc-typehints/
+    'sphinxarg.ext',
 ]
 
 autoapi_type = 'python'
@@ -136,6 +137,8 @@ def update_template_file():
 man_pages = [
     ('man/khard', 'khard', 'Console address book manager', '', 1),
     ('man/khard.conf', 'khard.conf', 'configuration file for khard', '', 5),
+    ('man/khard_new', 'khard_foo', 'foo for khard', '', 1),
+    ('man/khard_new2', 'khard_bar', 'foo for khard', '', 1),
 ]
 
 

doc/source/man.rst

@@ -8,3 +8,4 @@ The following man pages are available for khard:
 
    khard(1) <man/khard>
    khard.conf(1) <man/khard.conf>
+   new <man/khard_new.rst>

doc/source/man/khard_new.rst

@@ -0,0 +1,8 @@
+foo
+===
+
+.. argparse::
+  :module: khard.cli
+  :func: _sphinxarg_helper
+  :prog: khard
+  :manpage:

doc/source/man/khard_new2.rst

@@ -0,0 +1,7 @@
+foo
+===
+
+.. argparse::
+  :module: khard.cli
+  :func: _sphinxarg_helper
+  :prog: khard

khard/cli.py

@@ -455,3 +455,8 @@ def init(argv: list[str]) -> tuple[argparse.Namespace, Config]:
         return args, merge_args_into_config(args, conf)
     except ConfigError as err:
         sys.exit(str(err))
+
+
+def _sphinxarg_helper():
+    """Helper function to return the correct argument parser for the docs."""
+    return create_parsers()[1]

pyproject.toml

@@ -31,7 +31,12 @@ dependencies = [
 ]
 
 [project.optional-dependencies]
-doc = ['sphinx', 'sphinx-autoapi', 'sphinx-autodoc-typehints']
+doc = [
+    'sphinx',
+    'sphinx-argparse',
+    'sphinx-autoapi',
+    'sphinx-autodoc-typehints',
+]
 
 [project.urls]
 homepage = "https://github.com/lucc/khard"