From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id gKoWIzXiZmFpOwEAgWs5BA (envelope-from ) for ; Wed, 13 Oct 2021 15:42:13 +0200 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id iPvGHjXiZmEqBQAAB5/wlQ (envelope-from ) for ; Wed, 13 Oct 2021 13:42:13 +0000 Received: from mail.notmuchmail.org (nmbug.tethera.net [144.217.243.247]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id D876622D07 for ; Wed, 13 Oct 2021 15:42:12 +0200 (CEST) Received: from nmbug.tethera.net (localhost [127.0.0.1]) by mail.notmuchmail.org (Postfix) with ESMTP id C21FC2C18E; Wed, 13 Oct 2021 09:42:08 -0400 (EDT) Received: from mail-lf1-x129.google.com (mail-lf1-x129.google.com [IPv6:2a00:1450:4864:20::129]) by mail.notmuchmail.org (Postfix) with ESMTPS id CD69E2C16A for ; Wed, 13 Oct 2021 09:42:05 -0400 (EDT) Received: by mail-lf1-x129.google.com with SMTP id n8so12089446lfk.6 for ; Wed, 13 Oct 2021 06:42:05 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nikula-org.20210112.gappssmtp.com; s=20210112; h=from:to:subject:in-reply-to:references:date:message-id:mime-version; bh=Xo/8S35NS3vevtuEc5YJ0+BekfxRe5HGpbccP0in3uk=; b=eu/mNj5pFoT0AoCU2QMlfGH9PMvHWY/SKhx263rJWb8+z0MBI8X9ZDsLYNJThOxbOr rflJrWmHkImM8V3k8FuMFrbjLxgjc2IDA9HHB4G6ZCNgrhCRWeGcQODahdg4/pStS3Ks R3mG86hSOoPV1yb97asitrfTw4Tott+dlCO3JX46/NUftbVFzB+r2KjoBsnPaUordmqt X24O9Xyd4kclgqCR00UyuBjyHjq6HHdB7+jbk0ojAFcK7aJMz/1sWeRhny+7A4GTCHMQ k/s9B/L668ZMvemAONAJVdF6DMudhJWr2c2dvp45xPIVteUpWXioGnKv/xX2pR0X0G/U Rx2Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:from:to:subject:in-reply-to:references:date :message-id:mime-version; bh=Xo/8S35NS3vevtuEc5YJ0+BekfxRe5HGpbccP0in3uk=; b=GmrrnzhgCpfoxQapNuCTedV12WFPXAIMmYIpB8088JKxENnnyyhGdv3j4JFZ8+rqeH Cro2nbN+ZajqxXuK8n29aCVuemSSK5KSkjDu8N/lW+BGRoS3rSalxagPwpqFbYUcphpU abWx7d8jB+v8r3vtrQwwE9g28Og7cc17ZPEOLhIIslWvVjJvEsDI8GulG9r+/CG6tu9z TJrrpOgwsk1wU9EyYTc9SfpJw6LI7TFQ4B8G3BC1PxUSN0wRKm49S7/SXE2wZNI1Nqzx qT/cvExHxOC52gD7hcIYIvDt+FuKNbn7KD315duQV+T3vAeEDWz9JeRKHvhRqTqGOGGE hOKQ== X-Gm-Message-State: AOAM530oLhFg6BMdGtfmtscz2/y2DwDCBdIrEPhSgiXI+ZgeJnFAS5oO rCH7GvG9pr/x56GZZReo5uutqg== X-Google-Smtp-Source: ABdhPJwR8NtirxfDcM4CftDlZwsYi5VMYuIsrE82OqxnYYO4YX+Y4XfwnkGgX5u/ga1tnrDEGKynng== X-Received: by 2002:a05:651c:249:: with SMTP id x9mr28200683ljn.257.1634132523714; Wed, 13 Oct 2021 06:42:03 -0700 (PDT) Received: from localhost (87-95-50-104.bb.dnainternet.fi. [87.95.50.104]) by smtp.gmail.com with ESMTPSA id y5sm219340ljy.38.2021.10.13.06.42.02 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 13 Oct 2021 06:42:03 -0700 (PDT) From: Jani Nikula To: David Bremner , notmuch@notmuchmail.org Subject: Re: [RFC 0/5] doc: api docs overhaul In-Reply-To: <871r4pm83w.fsf@tethera.net> References: <20211012185127.198348-1-jani@nikula.org> <871r4pm83w.fsf@tethera.net> Date: Wed, 13 Oct 2021 16:41:59 +0300 Message-ID: <87fst511p4.fsf@nikula.org> MIME-Version: 1.0 Message-ID-Hash: TA6Y6QHNIECWDRRTC57VZN2JYRBWODLJ X-Message-ID-Hash: TA6Y6QHNIECWDRRTC57VZN2JYRBWODLJ X-MailFrom: jani@nikula.org X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; emergency; loop; banned-address; member-moderation; header-match-notmuch.notmuchmail.org-0; nonmember-moderation; administrivia; implicit-dest; max-recipients; max-size; news-moderation; no-subject; suspicious-header X-Mailman-Version: 3.2.1 Precedence: list List-Id: "Use and development of the notmuch mail system." List-Help: List-Post: List-Subscribe: List-Unsubscribe: Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit X-Migadu-Flow: FLOW_IN ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1634132533; 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: in-reply-to:in-reply-to:references:references:list-id:list-help: list-unsubscribe:list-subscribe:list-post:dkim-signature; bh=Vetvfi9Hr0i0dnxt+xVlcXjNx2yGPi1vgL6opi6uImE=; b=VjOtMGVxtWZ8fd2r2VI3EQuJP3853OVMA3I/YZoredAANL3vnF6d1Vfw+xBNojjKmD1VPE DhvAV3w34UXcI+aAv8lNBFwMpDOp3S8fPjRvhasuYdVoqENTi2wTZ6f3oXAj650SCGHc6q I6n2nwxapJZkKr9f7/FWKx5h//UGf+GCHcK+KgpMUtOOrb68+RP4WXIukK/aO2ZGNnrfKH av+/90RXUDD+7yPiMrQQY+9JbnRkrnQ4y8nWIGgjSDtdtK0yojRE9vrItO7vysPw+CT50Y pqOzcjI4vGhnZKM8Cnmty0p+K76P3cElc7kUaWQk/m5TX3gK1s5nMg4GCm1Qqw== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1634132533; a=rsa-sha256; cv=none; b=ktoRZH1upXmWWv2jmQG6iruZgJZh9sHuIt70qZeuE7ti7FvgMNbaTQ04bP6YAqVMtrx7Sp 7gxvOj7ZYAL5Lh5GHbM5LJZV0O6MmP8M4GFT/P4UxFl73smBSj5rpku5JvN+Qb/KieGP3Z r//Yvj2XPXLF+qCrvTXYJieF/9yb+AyWiJFUeIodMGGQ/C4s79AuWrAeYxKhMVb4GY9/km MoaHz0KU53g+XgfjsN7Z+E9zHdSKqytt0St49eWEOtdUpOYk+2dOto2DWD41Ua/Hdb1o3G x5sSyFuEzhdl5n7BkD39IuskW7Bn3T6agoyRrR2znUFIMcXs06X9yXqzsXsPbA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=nikula-org.20210112.gappssmtp.com header.s=20210112 header.b="eu/mNj5p"; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 144.217.243.247 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Spam-Score: -1.18 Authentication-Results: aspmx1.migadu.com; dkim=fail ("body hash did not verify") header.d=nikula-org.20210112.gappssmtp.com header.s=20210112 header.b="eu/mNj5p"; dmarc=none; spf=pass (aspmx1.migadu.com: domain of notmuch-bounces@notmuchmail.org designates 144.217.243.247 as permitted sender) smtp.mailfrom=notmuch-bounces@notmuchmail.org X-Migadu-Queue-Id: D876622D07 X-Spam-Score: -1.18 X-Migadu-Scanner: scn0.migadu.com X-TUID: P/CCwk7c9f6e On Wed, 13 Oct 2021, David Bremner wrote: > Jani Nikula writes: > >> The main downside is that Hawkmoth is not available via distro >> packaging, only PyPI. > > I guess another issue is the new dependency on Clang + > bindings. Although maybe that's a fair trade for dropping doxygen. Doxygen already depends on libclang: $ dpkg -s doxygen | grep "^Depends:" Depends: libc6 (>= 2.29), libclang-cpp11 (>= 1:11.0.1), libclang1-11 (>= 1:5.0~svn298832-1~), libgcc-s1 (>= 3.0), libllvm11 (>= 1:9~svn298832-1~), libstdc++6 (>= 7), libxapian30 (>= 1.4.14~) The difference is that the libclang python bindings depend on the dev packages: $ dpkg -s python3-clang-11 | grep "^Depends:" Depends: python3, libclang-11-dev $ dpkg -s libclang-11-dev | grep "^Depends:" Depends: libstdc++-10-dev, libgcc-10-dev, libobjc-10-dev, libclang1-11 (= 1:11.0.1-2), libclang-common-11-dev (= 1:11.0.1-2) I think you're probably in a better position to judge the relative sizes of the dependency trees than me, but the libclang dependency is already there with Doxygen. The Python parts are pretty small, it's the dev packages vs. Doxygen that makes the difference. > What would be the plan for transition while distros package hawkmoth? > Embed it in notmuch? Ship the compiled docs? I'm afraid I don't have an answer to that. What do projects do when they depend on packages from PyPI? It's a kind of chicken and egg problem. I saw that you made the Debian packaging request; many thanks! But is that enough? What is your stance on imposing new dependencies on other distros? BR, Jani.