1. Forum
  2. FidoNet
  3. linux.debian.ports.68k

  • Bug#1066890: rdma-core: don't build docs on minor arches (-DNO_MAN_PAGE

    From John Paul Adrian Glaubitz@3:633/10 to All on Thursday, January 01, 2026 12:30:02
    Subject: Bug#1066890: rdma-core: don't build docs on minor arches (-DNO_MAN_PAGES=1)

    Hi Benjamin,

    On Mon, 2024-04-29 at 13:29 +0200, Benjamin Drung wrote:
    On Fri, 2024-03-15 at 01:27 +0100, Drew Parsons wrote:
    Source: rdma-core
    Version: 50.0-2
    Severity: normal

    rdma-core does not build on minor architectures, since pandoc is not available.

    pandoc is only needed for documentation (man pages). It might be
    possible to only build docs for arch-indepdent builds, then using Build-Depends-Indep: pandoc <!nodoc>

    In any case the rdma-core docs (man pages actually) are controlled by NO_MAN_PAGES in CMakeLists.txt. What would be needed is to configure
    cmake with -DNO_MAN_PAGES=1 on the minor architectires (if not all binary-arch builds) to avoid or reduce the footprint of the pandoc Build-Depends.

    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 pack
    age
    instead of building them for every architecture in the archive.

    Building-depending on pandoc for arch:any packages is usually a bad idea as pandoc has an extremely long list of transitive build-dependencies meaning
    that any package that requires pandoc for building can only be built once
    the complete Haskell stack is available.

    Thus, please let's move the documentation part into arch:all package as thi
    s
    will also dramatically ease the burden when bootstrapping Debian for new architectures such as in the case of loong64 now.

    Adrian

    --
    .''`. John Paul Adrian Glaubitz
    : :' : Debian Developer
    `. `' Physicist
    `- GPG: 62FF 8A75 84E0 2956 9546 0006 7426 3B37 F5B5 F913

    --- PyGate Linux v1.5.2
    * Origin: Dragon's Lair, PyGate NNTP<>Fido Gate (3:633/10)
  • From John Paul Adrian Glaubitz@3:633/10 to All on Thursday, January 01, 2026 13:10:01
    Subject: Bug#1066890: rdma-core: don't build docs on minor arches (-DNO_MAN_PAGES=1)

    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 merg
    e
    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 pa
    ckage
    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 li
    st 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 Recomme
    nds (please don't use Depends!)

    Adrian

    --
    .''`. John Paul Adrian Glaubitz
    : :' : Debian Developer
    `. `' Physicist
    `- GPG: 62FF 8A75 84E0 2956 9546 0006 7426 3B37 F5B5 F913

    --- PyGate Linux v1.5.2
    * Origin: Dragon's Lair, PyGate NNTP<>Fido Gate (3:633/10)
  • From Benjamin Drung@3:633/10 to All on Wednesday, January 14, 2026 02:30:01
    Subject: 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 me
    rge
    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 Recom
    mends (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

    --- PyGate Linux v1.5.2
    * Origin: Dragon's Lair, PyGate NNTP<>Fido Gate (3:633/10)