[pkg-go] Bug#1080271: podman: please ship the upstream podman-compose.1 manual

[James Addison]

Source: libpod
Version: 5.2.1
Severity: normal
X-Debbugs-Cc: podman-compose at packages.debian.org, cech at debian.org
Control: affects -1 podman-compose

Dear Maintainer,

In #1054460 a duplicate-file conflict on the podman-compose.1 manual was
resolved: the manual was dropped from the podman binary package and the
version from podman-compose was retained.

However, invoking the default podman 5.2.1 'compose' subcommand produces
output referring the user to configuration settings only found in the libpod
documentation:

  $ podman compose help
  >>>> Executing external compose provider "/usr/bin/podman-compose". Please see podman-compose(1) for how to disable this message. <<<<
  ...

This tripped me up recently: running 'man -s 1 podman-compose' opened a manual
that seemed to be the one instructed, but that didn't describe the relevant
compose_warning_logs setting to disable the message.

I'd like to request that we ship the upstream libpod manual[1] instead, and
optionally that we could retain the podman-compose version of the manual in
section 7 (misc).  Most installers of podman-compose would be provided with the
libpod manual thanks to the Recommends dependency that podman-compose has on
libpod.

Thanks!
James

[1] - https://github.com/containers/podman/blob/d0582c9e1e6c80cc08c3f042b91993c853ddcbc6/docs/source/markdown/podman-compose.1.md.in#L16