Re: Bug#1066890: rdma-core: don't build docs on minor arches (-DNO_MAN_PAGES=1)
On Thu, 2026-01-01 at 13:06 +0100, John Paul Adrian Glaubitz wrote:
> Hi Benjamin,
>
> On Thu, 2026-01-01 at 12:27 +0100, John Paul Adrian Glaubitz wrote:
> > > would you be willing to submit a merge request / patch for it? The merge
> > > request can go directly against upstream:
> > > https://github.com/linux-rdma/rdma-core
> >
> > The better approach would be building the documents in a separate -doc package
> > instead of building them for every architecture in the archive.
>
> I can try to send a pull request next week but I've got a lot on my TODO list so
> I'm not sure whether I will be getting around doing it soonish.
>
> What needs to be done:
>
> - create a rdma-core-doc package
> - build documentation in rdma-core-doc package
> - disable doc builds for arch:any package
> - have any binary packages which need manpages add rdma-core-doc to Recommends (please don't use Depends!)
These binary packages ship man pages:
ibacm
ibverbs-providers
ibverbs-utils
infiniband-diags
libibnetdisc-dev
libibumad-dev
libibverbs-dev
librdmacm-dev
rdmacm-utils
rdma-core
srptools
I do not see how a single rdma-core-doc package to ship all man pages be
a better solution.
Alternative proposals:
1. In case you just want to address the bootstrapping problem: Add a
build-profile that excludes pandoc and skips the man pages.
2. Other alternative: We want to convert the man pages from rst to man.
We could switch from pandoc to rst2man (part of python-docutils which is
Python code and Python is already a build-dependency).
I propose to develop and submit a PR upstream to support rst2man as
alternative to pandoc.
--
Benjamin Drung
Debian & Ubuntu Developer
Reply to: