First take on man pages for all commands

Mostly based on what can be found in -h, but now there is something to
build upon

Signed-off-by: Martin Skøtt <[email protected]>

Author: mskott

docs/podman-bootc-completion.1.md

@@ -1,10 +1,22 @@
 % podman-bootc-completion 1
 
-## NAME
+## NAME 
+podman-bootc-completion - Generate the autocompletion script for the specified shell
 
 ## SYNOPSIS
+**podman-bootc completion** *bash* | *fish* | *powershell* | *zsh* [*options*]
 
 ## DESCRIPTION
+**podman-bootc completion** generate shell completion scripts for a variety of shells. 
+Supported shells are *bash*, *fish*, *powershell*, and *zsh*.
+
+## OPTIONS
+
+#### **--help**, **-h**
+Show details on how to use the script generated for the particular shell.
+
+#### **--no-descriptions** 
+Disable completion descriptions.
 
 ## SEE ALSO
 

docs/podman-bootc-images.1.md

@@ -1,10 +1,14 @@
 % podman-bootc-images 1
 
 ## NAME
+podman-bootc-images - List bootc images in the local containers store
 
 ## SYNOPSIS
+**podman-bootc images**
 
 ## DESCRIPTION
+**podman-bootc images** list bootc images in the containers store of the podman machine.
+The podman machine must be running to use this command.
 
 ## SEE ALSO
 

docs/podman-bootc-list.1.md

@@ -1,10 +1,15 @@
 % podman-bootc-list 1
 
 ## NAME
+podman-bootc-list - List installed OS Containers
 
 ## SYNOPSIS
+**podman-bootc list**
 
 ## DESCRIPTION
+**podman-bootc list** displays installed OS containers and their status.
+
+The podman machine must be running to use this command.
 
 ## SEE ALSO
 

docs/podman-bootc-rm.1.md

@@ -1,14 +1,29 @@
 % podman-bootc-rm 1
 
 ## NAME
+podman-bootc-rm - Remove installed bootc VMs
 
 ## SYNOPSIS
+**podman-bootc rm** *id* [*options*]
 
 ## DESCRIPTION
+**podman-bootc rm** removes an installed bootc VM/container from the podman machine.
+
+Use **[podman-bootc list](podman-bootc-list.1.md)** to find the IDs of installed VMs.
+
+The podman machine must be running to use this command.
+
+## OPTIONS
+
+#### **--all**
+Removes all non-running bootc VMs
+
+#### **--force**, **-f**
+Terminate a running VM
 
 ## SEE ALSO
 
-**[podman-bootc(1)](podman-bootc.1.md)**
+**[podman-bootc(1)](podman-bootc.1.md)**, **[podman-bootc-list(1)](podman-bootc-list.1.md)**
 
 ## HISTORY
 Dec, 2024, Originally compiled by Martin Skøtt <[email protected]>

docs/podman-bootc-run.1.md

@@ -1,10 +1,56 @@
 % podman-bootc-run 1
 
 ## NAME
+podman-bootc-run - Run a bootc container as a VM
 
 ## SYNOPSIS
+**podman-bootc run** [*options*] *image* | *id*
 
 ## DESCRIPTION
+**podman-bootc run** creates a new virtual machine from a bootc container image or starts an existing one.
+It then creates an SSH connection to the VM using injected credentials (see *--background* to run in the background).
+
+The podman machine must be running to use this command.
+
+## OPTIONS
+
+#### **--background**, **-B**
+Do not spawn SSH, run in background.
+
+#### **--cloudinit**=**string**
+--cloud-init <cloud-init data directory>
+
+#### **--disk-size**=**string**
+Allocate a disk image of this size in bytes; optionally accepts M, G, T suffixes
+
+#### **--filesystem**=**string**
+Override the root filesystem, e.g. xfs, btrfs, ext4.
+
+#### **--quiet**
+Suppress output from bootc disk creation and VM boot console
+
+#### **--rm**
+Remove the VM and it's disk image when the SSH connection exits. Cannot be used with *--background*
+
+#### **--root-size-max**=**string**
+Maximum size of root filesystem in bytes; optionally accepts M, G, T suffixes
+
+#### **--user**, **-u**=**root** | *user name*
+User name of injected user, default: root
+
+## EXAMPLES
+Create a virtual machine based on the latest bootable image from Fedora using XFS as the root filesystem.
+```
+$ podman-bootc run --filesystem=xfs quay.io/fedora/fedora-bootc:latest
+```
+
+Start a previously created VM, using *podman-bootc list* to find its ID.
+```
+$ podman-bootc list
+ID            REPO                                       SIZE        CREATED        RUNNING     SSH PORT
+d0300f628e13  quay.io/fedora/fedora-bootc:latest         10.7GB      4 minutes ago  false       34173
+$ podman-bootc run d0300f628e13
+```
 
 ## SEE ALSO
 

docs/podman-bootc-ssh.1.md

@@ -1,14 +1,24 @@
 % podman-bootc-ssh 1
 
 ## NAME
+podman-bootc-ssh - SSH into an existing OS Container machine
 
 ## SYNOPSIS
+**podman-bootc ssh** *id* [*options*]
 
 ## DESCRIPTION
+**podman-bootc ssh** opens an SSH connection to a running OS container machine.
+
+Use **[podman-bootc list](podman-bootc-list.1.md)** to find the IDs of installed VMs.
+
+## OPTIONS
+
+#### **--user**, **-u**=**root** | *user name*
+User name to use for connection, default: root
 
 ## SEE ALSO
 
-**[podman-bootc(1)](podman-bootc.1.md)**
+**[podman-bootc(1)](podman-bootc.1.md)**, **[podman-bootc-list(1)](podman-bootc-list.1.md)**
 
 ## HISTORY
 Dec, 2024, Originally compiled by Martin Skøtt <[email protected]>

docs/podman-bootc-stop.1.md

@@ -1,10 +1,13 @@
 % podman-bootc-stop 1
 
 ## NAME
+podman-bootc-stop - Stop an existing OS Container machine
 
 ## SYNOPSIS
+**podman-bootc stop** *id*
 
 ## DESCRIPTION
+**podman-bootc stop** stops a running OS container machine.
 
 ## SEE ALSO