docs: Command documentation

Author: tony

docs/cli/convert.md

@@ -1,7 +1,5 @@
 (convert-config)=
 
-(tmuxp-config)=
-
 # tmuxp convert
 
 Convert between YAML and JSON
@@ -24,3 +22,12 @@ $ tmuxp convert /path/to/file.json
 
 tmuxp automatically will prompt to convert `.yaml` to `.json` and
 `.json` to `.yaml`.
+
+## Reference
+
+```{eval-rst}
+.. click:: tmuxp.cli:cli
+    :prog: tmuxp convert
+    :commands: convert
+    :nested: full
+```

docs/cli/debug-info.md

@@ -17,3 +17,12 @@ environment:
 ...
 
 ```
+
+## Reference
+
+```{eval-rst}
+.. click:: tmuxp.cli:cli
+    :prog: tmuxp debug-info
+    :commands: debug-info
+    :nested: full
+```

docs/cli/freeze.md

@@ -23,3 +23,12 @@ Tmuxp will offer to save your session state to `.json` or `.yaml`.
 If no session is specified, it will default to the attached session.
 
 If the `--force` argument is passed, it will overwrite any existing config file with the same name.
+
+(cli-freeze-reference)=
+
+```{eval-rst}
+.. click:: tmuxp.cli:cli
+    :prog: tmuxp freeze
+    :commands: freeze
+    :nested: full
+```

docs/cli/import.md

@@ -6,6 +6,12 @@
 
 ## From teamocil
 
+```{eval-rst}
+.. click:: tmuxp.cli:command_import_teamocil
+    :prog: tmuxp import teamocil
+    :nested: full
+```
+
 ````{tab} YAML
 
 ```console
@@ -26,6 +32,12 @@ $ tmuxp import teamocil /path/to/file.json
 
 ## From tmuxinator
 
+```{eval-rst}
+.. click:: tmuxp.cli:command_import_tmuxinator
+    :prog: tmuxp import tmuxinator
+    :nested: short
+```
+
 ````{tab} YAML
 
 ```console

docs/cli/load.md

@@ -118,3 +118,12 @@ $ tmuxp load [filename] --log-file [log_filename]
 ```console
 $ tmuxp --log-level [LEVEL] load [filename] --log-file [log_filename]
 ```
+
+(tmuxp-load-reference)=
+
+```{eval-rst}
+.. click:: tmuxp.cli:cli
+    :prog: tmuxp load
+    :commands: load
+    :nested: full
+```

docs/cli/shell.md

@@ -1,31 +1,30 @@
 (cli-shell)=
 
-(tmuxp-shell)=
-
 # tmuxp shell
 
-```console
-$ tmuxp shell
+```{eval-rst}
+.. click:: tmuxp.cli:command_shell
+    :prog: tmuxp shell
+    :commands: shell
+    :nested: none
 ```
 
-```console
-$ tmuxp shell [session_name]
-```
-
-```console
-$ tmuxp shell [session_name] [window_name]
-```
+## Directly enter commands
 
 ```console
 $ tmuxp shell -c 'python code'
 ```
 
-Launch into a python console with [libtmux] objects. Compare to django's shell.
+## Example
 
 ```{image} ../_static/tmuxp-shell.gif
 :width: 100%
 ```
 
+## Guide
+
+Launch into a python console with [libtmux] objects. Compare to django's shell.
+
 Automatically preloads current tmux {class}`server <libtmux.Server>`,
 {class}`session <libtmux.Session>`, {class}`window <libtmux.Window>`
 {class}`pane <libtmux.Pane>`. Pass additional arguments to select a