From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp11.migadu.com ([2001:41d0:403:4789::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id wFqFHuC07GQcmQAA9RJhRA:P1 (envelope-from ) for ; Mon, 28 Aug 2023 16:53:20 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:4789::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp11.migadu.com with LMTPS id wFqFHuC07GQcmQAA9RJhRA (envelope-from ) for ; Mon, 28 Aug 2023 16:53:20 +0200 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 C8ABF3FAF1 for ; Mon, 28 Aug 2023 16:53:19 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=beffara.org header.s=gm1 header.b=B2HnXOMY; spf=pass (aspmx1.migadu.com: domain of "help-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="help-guix-bounces+larch=yhetil.org@gnu.org"; dmarc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1693234400; 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=sF5UPl/0AilB6uNT7aNiiAP0qkaIX2SUQvUcCKtJhuo=; b=ChX9PELhesTp5nj4ATnYNqI/G2MvOKmiB1m5Smx+ny1ww/lc0E8v9M45bI9P6/tyu/AgD1 3b4mAHskRgMgiBPBvb+KWBanvCb2sgb6Nd0Wm2z5eaHfi2nyoDgjQfOvl4nhJJpoiPNHN2 HFVDnmJqHPdwAUr2fVxrWUD7YW5fItXhFuFIN8fyIDoHbtwwyFNqZDK2+1VYA8EZc3yPzS XAHcQ4g1LA82eaRA3moevlTO/vDEdRDQqGZYy46u1167rnhl5gRDpmrotAFEJ8lmDau3o4 x9pxLnO5ZPCZXO0FlQsuvJjwxtz+qESOLHkuSkqpCISmXlTxisho1L1BLzRX2A== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1693234400; a=rsa-sha256; cv=none; b=tGhM7YnCGUXpZmDkKo2X6dxmlBtQjOikx4STnb2dzAe737uzkHB4M/x+XwnWXxcNy9VZ6d AJRBH3eF+2uzO7B5uqS6Enom5vHFwnDuo19Rr4kH2dGmfdhz7gt93fYYvFFHOGMF29U8oY QNXTOb2f3PpVpdNtKuYnknCXm63obM0aBvmZfCJhgtCL0b1a3BnyR9YOB0EHtHJoFHLlw1 UZDIZ8NtDbox6xnSGJPesONXYwfRbhbIPmm572sRT8aeA3f3oudfBFVF11SSe6WBfOwYE2 KCy2NefbVDA/7iNYNaKzDPeJtUgUusmJ1gNFcRRemGUaEnfQ6ro7dYRNaO1Tuw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=beffara.org header.s=gm1 header.b=B2HnXOMY; spf=pass (aspmx1.migadu.com: domain of "help-guix-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="help-guix-bounces+larch=yhetil.org@gnu.org"; dmarc=none Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qadbn-0002gO-HO; Mon, 28 Aug 2023 10:52:51 -0400 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 1qadbm-0002g4-H6; Mon, 28 Aug 2023 10:52:50 -0400 Received: from relay2-d.mail.gandi.net ([217.70.183.194]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qadbj-0008PN-PX; Mon, 28 Aug 2023 10:52:50 -0400 Received: by mail.gandi.net (Postfix) with ESMTPSA id 6AE0A4000A; Mon, 28 Aug 2023 14:52:43 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=beffara.org; s=gm1; t=1693234363; h=from:from: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; bh=sF5UPl/0AilB6uNT7aNiiAP0qkaIX2SUQvUcCKtJhuo=; b=B2HnXOMYZkAFoSwwNAIBnzkK8zq9F1tyzt43+DdpSi7LEhxOPnD0/5r3GzsGU+bPSfTXej NOr1Y2ts5gw042R5q0Q0YXZ3KeY/7UOWhi2g3OFIX8ajQhmix9cQ6RizJXq8vKe14bzYLn 39tpnwk3skU+tDcrya2tguU3DUaoA6YlOrwYNyHrGVoCYMuZXEN/yExVjYWNlhSbCTomZy JQxi8Kzj2HYqLTFloIVSsyZiikh/3DdzOXUsDMAd1yDRU6RZFVGSMjj7LbzHl6RzRib8eM 1qgs6XhxrPnGmfLheQTG5+MkI+y1w6LWL50sz3MqzvysYiCjKh9922JQhDkl0Q== Date: Mon, 28 Aug 2023 16:52:41 +0200 Message-ID: <20230828165241.GC2918@beffara.org> From: Emmanuel Beffara To: Nicolas Goaziou Cc: help-guix@gnu.org, guix-devel Subject: Re: documentation in TeX Live collections In-Reply-To: <871qfnqvku.fsf@nicolasgoaziou.fr> References: <20230825121743.GD1356@beffara.org> <87bkesrdx0.fsf@nicolasgoaziou.fr> <20230828094924.GB1032@beffara.org> <871qfnqvku.fsf@nicolasgoaziou.fr> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Content-Transfer-Encoding: 8bit X-GND-Sasl: manu@beffara.org Received-SPF: none client-ip=217.70.183.194; envelope-from=manu@beffara.org; helo=relay2-d.mail.gandi.net X-Spam_score_int: -27 X-Spam_score: -2.8 X-Spam_bar: -- X-Spam_report: (-2.8 / 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_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, SPF_HELO_PASS=-0.001, SPF_NONE=0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: help-guix@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: help-guix-bounces+larch=yhetil.org@gnu.org Sender: help-guix-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -9.13 X-Spam-Score: -9.13 X-Migadu-Queue-Id: C8ABF3FAF1 X-Migadu-Scanner: mx1.migadu.com X-TUID: txHzlxeuDDaf Hello, Thanks for the instructive feedback! De Nicolas Goaziou le 28/08/2023 à 13:01: > Every texlive-* package comes with its documentation, in a separate > output. "doc" output are not uncommon at all in Guix. Therefore, > I disagree with the inconsistency you're talking about. Ok, I admit I didn't investigate much before asserting that! I just observed that most of the tools I use come with their man or info pages in the main output and extrapolated from that. > > I think it would make much more sense to have "doc" outputs also for > > collections and schemes. It would be consistent with the structure of > > individual packages and would not require artificial packages. > > I disagree. Collections are meta-packages. There is no documentation, > nor content, attached to them. Moreover Guix meta-packages do nothing > special about the documentation of packages they propagate. This would > be inconsistent. I don't understand how "out" and "doc" are different in this respect. The "out" output of a collection meta-package has no content of its own and it only serves to gather the "out" outputs of its inputs. Similarly, the "doc" output would have no content of its own and only gather the "doc" outputs of its inputs. How is that inconsistent? There may be something I misunderstand about how Guix packages work here. > > Having individual package documentations in one's manifests is of course > > doable but it is contradictory with the approach of collections. > > How so? The point of a collection is to bring a meaningful set of packages on a general topic without having to worry about its specific contents: the exact list of packages may evolve from one version to another, it may contain many things that are indirectly required, etc. I think it makes sense to be able to request such an collection of packages with its documentation, and that should not involve listing all the packages individually. I realise it could also be possible to program that with something like (map (lambda (p) (list p "doc")) (filter (lambda (p) (member "doc" (package-outputs p))) (map cadr (package-transitive-inputs texlive-scheme-medium)))) in the definition of a manifest but it feels a bit low-level. But it is nice that doing this kind of thing possible, by the way! > In any case, I suggest to write a proper bug report for this. Hopefully, > someone with better understanding about the implications of GUIX_TEXMF > will be able to solve this. I can do that for the texdoc behaviour. -- Emmanuel