[From nobody Tue May 26 11:07:11 2026
Received: (at submit) by bugs.debian.org; 17 Mar 2023 02:22:11 +0000
X-Spam-Checker-Version: SpamAssassin 3.4.6-bugs.debian.org_2005_01_02
 (2021-04-09) on buxtehude.debian.org
X-Spam-Level: 
X-Spam-Status: No, score=-10.1 required=4.0 tests=BAYES_00,DKIM_SIGNED,
 DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FOURLA,HAS_PACKAGE,
 SPF_HELO_NONE,SPF_PASS autolearn=ham autolearn_force=no
 version=3.4.6-bugs.debian.org_2005_01_02
X-Spam-Bayes: score:0.0000 Tokens: new, 37; hammy, 149; neutral, 63; spammy,
 1. spammytokens:0.946-+--H*r:bugs.debian.org
 hammytokens:0.000-+--H*M:reportbug, 0.000-+--H*MI:reportbug,
 0.000-+--cutf8, 0.000-+--CUTF8, 0.000-+--c.utf-8
Return-path: <cyan@cyano.uk>
Received: from jupiter.guys.cyano.uk ([45.63.120.176]:46006)
 by buxtehude.debian.org with esmtps
 (TLS1.3:ECDHE_X25519__RSA_PSS_RSAE_SHA256__AES_256_GCM:256)
 (Exim 4.94.2) (envelope-from <cyan@cyano.uk>) id 1pczjP-001ZYi-CQ
 for submit@bugs.debian.org; Fri, 17 Mar 2023 02:22:11 +0000
Content-Type: text/plain; charset="us-ascii"
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=cyano.uk; s=dkim;
 t=1679019345;
 h=from:from:reply-to:subject:subject:date:date:message-id:message-id:
 to:to:cc:mime-version:mime-version:content-type:content-type:
 content-transfer-encoding:content-transfer-encoding;
 bh=uXAljsvumpZaI6GX/M1ZubeibzD0dTzb6Ztnh39gA9w=;
 b=h/xduA93c2OcciQvlSWlbgIN8vYKL/7RpI9gom5cLW6+kwQeP845RJshCDIleP6ow6C9/c
 CqYysCur8izYk2o9KK5GoLFvSDQNzttNJZJCG4lfCO7XOG/iT8X+Lj9TTvkKsJGcL+DM47
 N8w3UboJ+QRu0mkvSTsKOkCb0t5acAQSuggYKlw1hB8ZwrznLROgFPwpQ1/ZPTTMFJydXH
 IZlPA/RkOIoKT5lRtKGp//ghhMNvhyt8vK5S3Mu9ClUmg7yLXoCgkgiRlXv7wS2aB43Wz+
 YQL2s7Tmmswotf35mKBQpSoc+ZXdAbx48yrpHNkR6ik71z9T9LZEkkm4v10YcQ==
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
From: Cyan Young <cyan@cyano.uk>
To: Debian Bug Tracking System <submit@bugs.debian.org>
Subject: llvm-toolchain-14: missing nodoc build profile support (for
 bootstrapping)
Message-ID: <167901930420.548.12039979185874203578.reportbug@debian-11>
Date: Fri, 17 Mar 2023 10:15:09 +0800
X-Spamd-Bar: /
Authentication-Results: jupiter.guys.cyano.uk;
 auth=pass smtp.mailfrom=cyan@cyano.uk
X-Greylist: delayed 381 seconds by postgrey-1.36 at buxtehude;
 Fri, 17 Mar 2023 02:22:09 UTC
Delivered-To: submit@bugs.debian.org

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-@LLVM_VERSION@/share/doc/llvm/ocaml-html/ usr/share/doc/libllvm-@LLVM_VERSION@-ocaml-dev/
usr/lib/llvm-@LLVM_VERSION@/share/doc/LLVM/llvm/ocaml-html/ usr/share/doc/libllvm-@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
]