From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms5.migadu.com with LMTPS id mMksDdxSkWN5+wAAbAwnHQ (envelope-from ) for ; Thu, 08 Dec 2022 03:58:36 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:bcc0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id mEEZDdxSkWObvQAAauVa8A (envelope-from ) for ; Thu, 08 Dec 2022 03:58:36 +0100 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id D6F5C15EEB for ; Thu, 8 Dec 2022 03:58:35 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1p376j-0002ve-Id; Wed, 07 Dec 2022 21:57:57 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p376h-0002vU-FU for guix-devel@gnu.org; Wed, 07 Dec 2022 21:57:55 -0500 Received: from mail-4323.proton.ch ([185.70.43.23]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1p376e-0007pP-2Q for guix-devel@gnu.org; Wed, 07 Dec 2022 21:57:55 -0500 Date: Thu, 08 Dec 2022 02:57:41 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=lendvai.name; s=protonmail2; t=1670468267; x=1670727467; bh=+2KC+gHqafuZaawJtf9sVvtyJSDPO+CS4v3ncaZA/hc=; h=Date:To:From:Cc:Subject:Message-ID:In-Reply-To:References: Feedback-ID:From:To:Cc:Date:Subject:Reply-To:Feedback-ID: Message-ID:BIMI-Selector; b=eXok00iY1HRcCNUPbUSnBsS9JhjoYRIxGSgqBdPIMbnHz7pL3+f82nhpjn/QPqGZu nQzb8bN2UYgKjZHWKjDy8z9PU9ct/zGm6QynhFMvICnM5rNztiAOvTY5ssO1uze2zj jASCdcGYNYr8cpsMzL4pMYMi5Cme4NfaN7l9jik4lt37kM8mnbBgUc2cGULeU+oEwv OLVc6yop2rFdD13jeXfj9eyyuf7lobFiAGxnCvsZoAQzxLbGQsDDH/5dIZ3upncu/z cRegjZlMG0HNYpUgSUW4KIXrDHdfm/qhOyxnGVOycRcAT1HlaWdXutj7SGGibDpjQb q/hZDOx4B9vkA== To: jgart From: Attila Lendvai Cc: Guix Devel Subject: Re: Should a Guix package include documentation dependencies to be considered complete? Message-ID: <8BmdmAq5fLisa0AW_iOVfatVPxy8WWctbNc2wEikKTV_0d0GyvhFv8yCDbKh-PGYpZWgvCuIeLFLItXt6cXLn9fNF6We4EpT9m3jTiVssiM=@lendvai.name> In-Reply-To: <20221207191711.GB847@dismail.de> References: <20221207191711.GB847@dismail.de> Feedback-ID: 28384833:user:proton MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: pass client-ip=185.70.43.23; envelope-from=attila@lendvai.name; helo=mail-4323.proton.ch X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_PASS=-0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: guix-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Development of GNU Guix and the GNU System distribution." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-devel-bounces+larch=yhetil.org@gnu.org Sender: guix-devel-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1670468316; h=from:from:sender:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc: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=+2KC+gHqafuZaawJtf9sVvtyJSDPO+CS4v3ncaZA/hc=; b=mYefhEnGRUmspal6oSRh63uUCbnrydK/RjTYYVayvxkiOsjVhVqMiqcfUVX9uD0qPGFGS/ gfQCoNDMXOSmp0FdtnnQjP3ZzU3RQl5VY8h81ZYsRCI6yZah0jOwaFxPEGGkFFiL0+lvdC 0ZIaVtKn2ImDpYeaCTfFfS9US/29M6RBR+fmvq0IGRr3GBWxgRyXap/x+aHmg56AzyOTsI YP7soiGollPYiwGFu9+ylwoQ+JEtwPS6K5QZk+EouCYvldj3HO7q9ibXfrSxS98d1DOXF/ AJJS87mgeiYjjmPu3OTIohnJfwFEA9nHmiztRGey1omltx379IQuZzlDO89Tdg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1670468316; a=rsa-sha256; cv=none; b=QZNqxRIJydx5jYR4CvT+oWaRrly06YKZdk8Dw+fQp/EKDUms5hpUK6m5ndDH2duIRtYwsg eX1GUwjc/UJN45V2e2LL2xMV6H97Kl8HuVdsjRWVdBpBOc66FTy1kDe52Xb3SSHlhgSttG rqagoDP/hLaV31Q82EqvxLQ4nZJS7+ygslJDPUScINVsbLb+yD0bA3AtHfxxCGAzeaELut sOYREQuPVchVHQW1wsIM/k/o2OR7ixPWnxftMADDvANOj/M/B4bP5zVfZ9j1xIYKM5OG6T /Lfa0f3k8BlT9Oh30OnyntI49xCHdIzW18Cw2TnWqbtq5EcII/8gnrhNf+CdDg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=lendvai.name header.s=protonmail2 header.b=eXok00iY; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: -2.46 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=lendvai.name header.s=protonmail2 header.b=eXok00iY; dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-devel-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-devel-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: D6F5C15EEB X-Spam-Score: -2.46 X-Migadu-Scanner: scn1.migadu.com X-TUID: KPkxnpMBRnbk > We currently include all the dependencies to run the tests, why not do > the same for documentation building? >=20 > Should we make it a requirement or goal to always package a given package= 's "documentation-inputs"? i also lack guidance on this. and i somewhat miss a "test-inputs" field to explicitly mark the dependenci= es that are only needed to run the tests. this often doubles the native-inp= uts dependencies of python packages. then the infrastructure could be smartened up to not require those dependen= cies when the tests are disabled for a package. it could serve as a tempora= ry bandaid to fix/upgrade a package while there are some issues with the de= pendencies needed to run the tests. i guess same applies to documentation. some brainstorm follows: but what should be the way to control this for doc= umentation? package arguments, like #:tests? #f for tests? or some way to m= ark some of the outputs as optional, and a way to request the optional outp= uts? how would the latter apply to tests, that have no package output? is t= he anomaly justified? --=20 =E2=80=A2 attila lendvai =E2=80=A2 PGP: 963F 5D5F 45C7 DFCD 0A39 -- =E2=80=9CTo every man is given the key to the gates of heaven; the same key= opens the gates of hell. And so it is with science.=E2=80=9D =09=E2=80=94 Richard Feynman (1918=E2=80=931988)