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
