Bug#1033087: llvm-toolchain-14: missing nodoc build profile support (for bootstrapping)

[Cyan Young]

Package: llvm-toolchain-14
Severity: wishlist

Dear Maintainer,

Recently we are bootsrtraping Debian from scratch for a project. We already
have a set of "devel" packages, and most of LLVM's build dependencies can be
satisfied.

The problem is, LLVM is using Doxygen and Sphinx to generate documentation,
and Doxygen depends on LLVM itself - such dependency loop can block
LLVM from being bootstrapped.

After stripping out every *-doc package and disabling documentation build
process, LLVM can be successfully built without any issue.

I consulted a DD about this problem, DD suggests me to add 'nodoc' build
profile support to LLVM. So I tried to implement this change, but encountered
a new problem, package 'libllvm-ocaml-dev' is requiring some documentation
related files:

$ cat debian/libllvm-X.Y-ocaml-dev.install.in
@OCAML_STDLIB_DIR@
usr/lib/llvm- at LLVM_VERSION@/share/doc/llvm/ocaml-html/ usr/share/doc/libllvm- at LLVM_VERSION@-ocaml-dev/
usr/lib/llvm- at LLVM_VERSION@/share/doc/LLVM/llvm/ocaml-html/ usr/share/doc/libllvm- at LLVM_VERSION@-ocaml-dev/ 

I expect that there is a package which contains LLVM OCaml documentation only,
so it does not build with 'nodoc'. This means package libllvm-*-ocaml-dev
should be splited.

Do you have any suggestions about this? I should not remove those two lines
in d/rules with nodoc enabled, since this may against Debian policies.

Thanks,
    Cyan

-- System Information:
Debian Release: 11.5
  APT prefers stable
  APT policy: (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 6.2.1-aosc-main (SMP w/16 CPU threads; PREEMPT)
Locale: LANG=C.UTF-8, LC_CTYPE=C.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: unable to detect