Normal When running podman pod --help, the available subcommands are listed.
Currently, it shows the ps subcommand (to list pods), but does not mention ls, even though podman pod ls is a valid and working command that produces the same output as podman pod ps.
For consistency and clarity, ls should be documented in the podman pod --help output.
[root@podman-machine ~]# podman version Client: Podman Engine Version: 5.2.2 API Version: 5.2.2 Go Version: go1.23.6 (Red Hat 1.23.6-2.el9_5) Built: Mon Mar 17 08:03:54 2025 OS/Arch: linux/amd64 [root@podman-machine ~]# podman pod ps POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS 43d0bc109c23 newpod Running 22 seconds ago 3e95f6999227 2 [root@podman-machine ~]# podman pod ls POD ID NAME STATUS CREATED INFRA ID # OF CONTAINERS 43d0bc109c23 newpod Running 25 seconds ago 3e95f6999227 2
The podman pod --help do not show ls as the subcommand.
podman pod --help Manage podsDescription: Pods are a group of one or more containers sharing the same network, pid and ipc namespaces.Usage: podman pod [command]Available Commands: clone Clone an existing pod create Create a new empty pod exists Check if a pod exists in local storage inspect Display a pod configuration kill Send the specified signal or SIGKILL to containers in pod logs Fetch logs for pod with one or more containers pause Pause one or more pods prune Remove all stopped pods and their containers ps List pods restart Restart one or more pods rm Remove one or more pods start Start one or more pods stats Display a live stream of resource usage statistics for the containers in one or more pods stop Stop one or more pods top Display the running processes of containers in a pod unpause Unpause one or more pods
