From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms9.migadu.com with LMTPS id yEr2AHGA6GSPQgAAG6o9tA:P1 (envelope-from ) for ; Fri, 25 Aug 2023 12:20:33 +0200 Received: from aspmx1.migadu.com ([2001:41d0:403:478a::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id yEr2AHGA6GSPQgAAG6o9tA (envelope-from ) for ; Fri, 25 Aug 2023 12:20:33 +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 29C2F59FAC for ; Fri, 25 Aug 2023 12:18:19 +0200 (CEST) Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=beffara.org header.s=gm1 header.b=pzy9EDDr; 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-Seal: i=1; s=key1; d=yhetil.org; t=1692958699; a=rsa-sha256; cv=none; b=N6F58FXTtsZnf1oE9JmQqY4bTijgWEN0uGhnr4TWUUPnJKYlcy82E777x2juG+S9SWJKAg R+hZEo0PY/6oqXmNUJKgAqoPkm07fsdjLsW6pj2+wrN2Pu43c1+rStMFlfUE4dlq61Kfrf mcP8w2RnZMPfBBP/PIO7SyhD6/DCrj/jWXSXDg1FPSRw4slTUepnC1/BpEtQn/05G137/d qBqf9A7wVG7MwoJAcnUWC9k4vVXAWiEqaQ9uica42G0dvZbo0F2XknynNOA1E6UfLHeLL4 AsPR77tsncqilqsaOheS2HkDVUnvmi58rBDJoey3qoNxhRQRIKyrU1tNXU66rw== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=beffara.org header.s=gm1 header.b=pzy9EDDr; 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=1692958699; h=from:from:sender:sender: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: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=vkSFVjAWgx7UrfYYnI8ydV6J5oCCPY8fILemcwaCOZo=; b=ldmVeRzBLm6QYryeSHFds9LiUIuywkuLWBp6S69KjV32erdkyajeMr/w9R/Wx3mfTYj59x EenGw6IHn22udoA/ynT3CFvkNnEbq5G8OnP7ogx8v0aYRV3FhICFnbEBd25Hb3lE4jVJ0i YXMrjEGRprpOl5/7gQbSf1MKTa51ZIgAw2DNpG15/zSqGL7mA6Fi+VTnQ/MlckxDo6AVml HqmSycaHG+mzUNVNKQFzYpNrwp+LkpZdv4XMMQXlXaQmUHZkutACfHZ4jec6rBAuGj3t3L pX7wZcADqX9H/gawARkbalYny4fcw7RBeivJLqSoGEz4bVV8g4H+hpndzzUGcg== Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qZTt3-0004ig-R2; Fri, 25 Aug 2023 06:17:53 -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 1qZTt2-0004hR-Sd for help-guix@gnu.org; Fri, 25 Aug 2023 06:17:52 -0400 Received: from relay7-d.mail.gandi.net ([217.70.183.200]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qZTsz-0003Sl-RB for help-guix@gnu.org; Fri, 25 Aug 2023 06:17:52 -0400 Received: by mail.gandi.net (Postfix) with ESMTPSA id CC78120005 for ; Fri, 25 Aug 2023 10:17:45 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=beffara.org; s=gm1; t=1692958665; 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: references:references; bh=vkSFVjAWgx7UrfYYnI8ydV6J5oCCPY8fILemcwaCOZo=; b=pzy9EDDrTsbjBehourOLSpoJzNmKuLHDUdAjn4RORqVWoG6sgtq3vv9rbpCfmJUD9GTslF WZEgsMXSVT+w0EIucl6ppkH6h72vPWvER/CdFZV/JlcuRwc+5IeQcF2OiNQFP1YAbl81k3 vl9ii//+Bno5h0sQlenZyeShuo5RMNjYIacIFASbGB1k2aLcYfqSOUwFeYwcoE4XUvTBnS WmaxsqDcirLGQY5AYdVs7nf/fPQcGc+jwrRY5+xrupzYkNJcIunYP8sITBsesLHEMqtqNF g5lrrn3Hb1LAsWdj1JO5zLj5e/PhpL1oSkafxmTzw8RorjJZHFv7A84WjqHp+g== Date: Fri, 25 Aug 2023 12:17:43 +0200 Message-ID: <20230825121743.GD1356@beffara.org> From: Emmanuel Beffara To: help-guix@gnu.org Subject: documentation in TeX Live collections References: 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.200; envelope-from=manu@beffara.org; helo=relay7-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_H4=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-Scanner: mx0.migadu.com X-Spam-Score: -2.21 X-Migadu-Queue-Id: 29C2F59FAC X-Migadu-Spam-Score: -2.21 X-TUID: aOhYJ9QYuUf9 Hello Guix, There has been a lot of movement around TeX Live recently and it is very nice to see. We now have a usable modular installation and a great number of available packages and collections. However, I don't understand what is the proper way to reach documentation in the current system. I installed `texlive-scheme-medium` in my home profile managed by `guix home`, everything works including `texdoc` (although it always says « Info: Running Texdoc not installed in the current TEXMFMAIN. » for some reason), but there is essentially no documentation installed: $ texdoc inputenc Info: Running Texdoc not installed in the current TEXMFMAIN. You don't appear to have any local documentation installed. There may be online documentation available for "inputenc" at https://texdoc.org/serve/inputenc/0 This documentation may be for a different version than you have installed. Would you like to search online? (y/N) Indeed the `doc` folder is nearly empty: $ ls $GUIX_TEXMF/doc bibtex8/ bibtexu/ chktex/ Apparently, all individual packages have a specific "doc" output but collections and schemes do not and they don't have them as inputs either. So we end up with an installation with no documentation (apart from the three above, which is surprising). I tried to explicity include documentation in a sub-shell but this changes nothing: $ guix shell texlive-latex:doc -- texdoc inputenc Info: Running Texdoc not installed in the current TEXMFMAIN. You don't appear to have any local documentation installed. There may be online documentation available for "inputenc" at https://texdoc.org/serve/inputenc/0 This documentation may be for a different version than you have installed. Would you like to search online? (y/N) Including the TeX Live scheme in the same shell makes things worse: $ guix shell texlive-scheme-medium texlive-latex:doc -- texdoc inputenc Info: Running Texdoc not installed in the current TEXMFMAIN. texdoc error: No texlive.tlpdb nor shipped tlpdb data found. Inspecting GUIX_TEXMF in this shell reveals that it now contains two paths, one of which does contain the right documentation: $ guix shell texlive-scheme-medium texlive-latex:doc $ env | grep TEX GUIX_TEXMF=/gnu/store/fg1z0jgkj0r4v8i3rmpg0c1vfirbg1ac-profile/share/texmf-dist:/home/manu/.guix-home/profile/share/texmf-dist $ ls /gnu/store/fg1z0jgkj0r4v8i3rmpg0c1vfirbg1ac-profile/share/texmf-dist/doc bibtex8 bibtexu chktex latex $ export GUIX_TEXMF=${GUIX_TEXMF%:*} $ texdoc inputenc ... inputenc.pdf is displayed! ... Apparently the fact that this GUIX_TEXMF variable contains several paths is problematic for texdoc. As an attempt to work around this, I tried to add texlive-latex:doc to my home profile definition and it did make that documentation available to texdoc. Moreover, for some reason, ALL documentation was downloaded: $ guix home reconfigure home.scm ... texlive-cm-66594-doc 2KiB texlive-etex-66594-doc 189KiB texlive-hyphen-complete-66594-doc 783KiB texlive-kpathsea-66594-doc 1022KiB texlive-pdftex-66594 4.2MiB ... $ ls -d /gnu/store/*-texlive-*-doc/ | wc 1105 1105 82506 Apparently something has triggered the download of documentation for all packages `texlive-scheme-medium` depends on but only the one I explicitly requested is made available in the profile (which is expected). All these other documentation were downloaded but not used and `guix gc` actually deletes them all! So what would be the proper way to install `texlive-scheme-medium` in a home profile with the documentation of the packages it includes ? -- Emmanuel