From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp12.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id 3vmRJJJGH2KzIgEAgWs5BA (envelope-from ) for ; Wed, 02 Mar 2022 11:27:30 +0100 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp12.migadu.com with LMTPS id wHs1IJJGH2JUtQAAauVa8A (envelope-from ) for ; Wed, 02 Mar 2022 11:27:30 +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 9884D357A4 for ; Wed, 2 Mar 2022 11:27:27 +0100 (CET) Received: from localhost ([::1]:36666 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nPMCc-00070I-97 for larch@yhetil.org; Wed, 02 Mar 2022 05:27:26 -0500 Received: from eggs.gnu.org ([209.51.188.92]:48024) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nPMCE-0006zl-9Q for guix-patches@gnu.org; Wed, 02 Mar 2022 05:27:03 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:45276) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nPMCE-0005hZ-0A for guix-patches@gnu.org; Wed, 02 Mar 2022 05:27:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nPMCD-00086z-KG for guix-patches@gnu.org; Wed, 02 Mar 2022 05:27:01 -0500 X-Loop: help-debbugs@gnu.org Subject: [bug#54220] [PATCH] doc: Add "Using TeX and LaTeX" chapter. Resent-From: Ricardo Wurmus Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Wed, 02 Mar 2022 10:27:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 54220 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: Ludovic =?UTF-8?Q?Court=C3=A8s?= Cc: 54220@debbugs.gnu.org, mail@nicolasgoaziou.fr, bauermann@kolabnow.com X-Debbugs-Original-Cc: debbugs-submit@debbugs.gnu.org, Nicolas Goaziou , 54220@debbugs.gnu.org, Thiago Jung Bauermann Received: via spool by 54220-submit@debbugs.gnu.org id=B54220.164621680731147 (code B ref 54220); Wed, 02 Mar 2022 10:27:01 +0000 Received: (at 54220) by debbugs.gnu.org; 2 Mar 2022 10:26:47 +0000 Received: from localhost ([127.0.0.1]:39171 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPMBy-00086H-Vp for submit@debbugs.gnu.org; Wed, 02 Mar 2022 05:26:47 -0500 Received: from sender4-of-o51.zoho.com ([136.143.188.51]:21186) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPMBx-000866-7V; Wed, 02 Mar 2022 05:26:45 -0500 ARC-Seal: i=1; a=rsa-sha256; t=1646216791; cv=none; d=zohomail.com; s=zohoarc; b=lwzNlMdj3Nenr1gT432kobOmyz6muFWA7JIhv10BFhddS/xIxLVv8Ku9oAlvjsPwYMzwISfP25rutgFBSEECNOKxOcMLpmJxLOesGLgHJpmT2QXI+yCCJFqO2KE9oeXBmj29Dav+Y+Ffm1r8lA7Vhw3XcRqrap+QWMHS5DxhYts= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1646216791; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To; bh=FAq4IWrAoLIZ6gpoGKrw7OpqyAR6opb/zS4PRbqTX90=; b=lieoeQ1CeOoZ7CpKl8ssEeW8uZ7tiWU9OI/XToixiD6fpoQ4YLzWjbzXTUpJaaDedukUkeUcxzxiOesOQSxVDMqEEE3qWa7fN5m69lM2rksVZbrPZb7AqOc0OAvD3rfptyoZNBH8cnrNNfUl5LfPzr4G0J6haLrFKWqVWv6FuxY= ARC-Authentication-Results: i=1; mx.zohomail.com; dkim=pass header.i=elephly.net; spf=pass smtp.mailfrom=rekado@elephly.net; dmarc=pass header.from= DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; t=1646216791; s=zoho; d=elephly.net; i=rekado@elephly.net; h=References:From:To:Cc:Subject:Date:In-reply-to:Message-ID:MIME-Version:Content-Type:Content-Transfer-Encoding; bh=FAq4IWrAoLIZ6gpoGKrw7OpqyAR6opb/zS4PRbqTX90=; b=DRBSGSB/HvRJrO+4czjDuQp7oL+L+TGRoelwG6DQZldJsQSRB96FmSoaixjStf3x F0hWWs9NdCJjTMYHsy3pRNMsb59L20ReLwHtRxSQ73Ki78bnAvYlQy7MJ5kIS2SRCf3 8fePuni6fBAlcYESrS7DzHdwm9wqq7uJLKyZkSZY= Received: from localhost (p54ad4e6f.dip0.t-ipconnect.de [84.173.78.111]) by mx.zohomail.com with SMTPS id 1646216790075227.5879534750386; Wed, 2 Mar 2022 02:26:30 -0800 (PST) References: <20220302095550.17700-1-ludo@gnu.org> User-agent: mu4e 1.6.10; emacs 28.0.50 From: Ricardo Wurmus Date: Wed, 02 Mar 2022 11:12:46 +0100 In-reply-to: <20220302095550.17700-1-ludo@gnu.org> X-URL: https://elephly.net X-PGP-Key: https://elephly.net/rekado.pubkey X-PGP-Fingerprint: BCA6 89B6 3655 3801 C3C6 2150 197A 5888 235F ACAC Message-ID: <87pmn41wh9.fsf@elephly.net> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-ZohoMailClient: External X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-BeenThere: guix-patches@gnu.org List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: guix-patches-bounces+larch=yhetil.org@gnu.org Sender: "Guix-patches" X-Migadu-Flow: FLOW_IN X-Migadu-Country: US ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1646216850; 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:resent-cc: resent-from:resent-sender:resent-message-id:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=FAq4IWrAoLIZ6gpoGKrw7OpqyAR6opb/zS4PRbqTX90=; b=RBHv53v7//kABY1fBtYXn8ceL6jVjKvEQWGP/8sCeOPxHXJnyecMKAuksK/4fSSoowFYWQ xVTDQ9xpfumVLyPftu2wR0reFh29IYiU1fDEcyn/sWOHJ090afDW3NdXFFdeNGbFxXYpYF +OcUaYe/YdCPaN57+wbC2tPM2XuZDDNr2Fku8KNOBXm20OjsBuUMLh9pdWc5KPLuJcA7iR Jrx7K9h9nHj6ewDJx/9Ta9fX1VcXv1XO3fohcpLW1PiwrG3x6lceIhe243kA30LFNm2jSk Sd9AWlCisQ+hdYpU3gSsXmqOZ5XtNKZ3ky2qfkQYgLa1lZ7wYY9d3r/nUJPRHg== ARC-Seal: i=2; s=key1; d=yhetil.org; t=1646216850; a=rsa-sha256; cv=fail; b=raloj5hw3dE0G2SZ+rhO6xGnS0BZ31foGTCpu1gVzCpTwxkhPrSt3LGNv7Gah6X5eLVvfX uPlL+j80+AioT8NTHLL67wQM1LvgGfXaGvi1RTuc/d5IPjNhfCKfClxha6ZNeyGkwVPkfW RaMvCTfcdoActtwgqd4cfC5+ukIcam848x83rFThVW8r+3Kttd5J6GnsjTTKbUO7ne68CJ QBCuFEHDAcEh4WJDT2tsrw1S6NsFTLuQdineMlS0CphQ2c4HdS1ac4P8z1LoXhmR8NPS0r foxm8NUmdtQ7glsC602NMmmhBhP4PVt24tcOt7yU/RC8Ej9QPRfiUdhxrDhLMg== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=elephly.net header.s=zoho header.b="DRBSGSB/"; arc=reject ("signature check failed: fail, {[1] = sig:zohomail.com:reject}"); dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Spam-Score: 1.52 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=elephly.net header.s=zoho header.b="DRBSGSB/"; arc=reject ("signature check failed: fail, {[1] = sig:zohomail.com:reject}"); dmarc=none; spf=pass (aspmx1.migadu.com: domain of "guix-patches-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="guix-patches-bounces+larch=yhetil.org@gnu.org" X-Migadu-Queue-Id: 9884D357A4 X-Spam-Score: 1.52 X-Migadu-Scanner: scn0.migadu.com X-TUID: DBnqr25MyRne Ludovic Court=C3=A8s writes: > * doc/guix.texi (Using TeX and LaTeX): New node. Perfect! > It=E2=80=99s a top-level chapter, because I couldn=E2=80=99t find any bet= ter place, but > I think it=E2=80=99s fine. Hmm, maybe in (possibly renamed) =E2=80=9CApplication Setup=E2=80=9D? > +@cindex @TeX{} packages > +@cindex @LaTeX{} packages > +Guix provides packages for the @TeX{} and @LaTeX{} typesetting systems, > +taken from the @uref{https://www.tug.org/texlive/, @TeX{} Live > +distribution}. However, because @TeX{} Live is so huge and because > +finding your way in this maze is tricky, we thought that you, dear user, > +would welcome guidance on how to deploy the relevant packages so you can > +compile your @TeX{} and @LaTeX{} documents. Why single out TeX in particular? TeX Live also includes ConTeXt, Xe(La)TeX, Lua(La)TeX etc. I guess LaTeX is the most widely known and TeX is the common basis of them all, so maybe that=E2=80=99s good enough a reason. > +the features you need---@code{texlive-latex-listings} for the > +@code{listings} package, @code{texlive-hyperref} for @code{hyperref}, > +@code{texlive-beamer} for Beamer, @code{texlive-latex-pgf} for PGF/TikZ, I=E2=80=99d very much like to avoid giving the old names visibility. =E2=80=9Ctexlive-latex-listings=E2=80=9D is old as is =E2=80=9Ctexlive-late= x-pgf=E2=80=9D. It really should be =E2=80=9Ctexlive-listings=E2=80=9D and =E2=80=9Ctexlive-pgf=E2=80= =9D. Previously I had not been aware of the tlpdb, so these packages were literally just an arbitrary slice of the TeX Live SVN repository and thus had to be named according to the directory name to disambiguate the package providing =E2=80=9Ctex/generic/foo=E2=80=9D from the one providing =E2=80=9Ctex/latex= /foo=E2=80=9D. With the svn-multi fetch method we were finally able to fully specify the source for any given TeX Live package by selecting more than one SVN location. Together with the tlpdb, which specifies all locations for a given packgae name, this allowed us to finally include *all* expected files in =E2=80=9Ctexlive-=E2=80=9D packages, and thus removing the need for disambiguation through package name infixes. In short: I=E2=80=99d prefer to deprecate all old names and only mention th= e new names in the documentation to avoid confusion. > +@xref{Invoking guix package, @option{--manifest}}, for more on > +manifests. In the future, we plan to provide packages for @TeX{} Live > +@dfn{collections}---``meta-packages'' such as @code{fontsrecommended}, > +@code{humanities}, or @code{langarabic} that provide the set of packages > +needed in this particular domain. That will allow you to list fewer > +packages. Working on it! > +@example > +$ guix shell texlive-base -- tlmgr info phvr7t > +tlmgr: cannot find package phvr7t, searching for other matches: > + > +Packages containing `phvr7t' in their title/description: > + > +Packages containing files matching `phvr7t': > +helvetic: > + texmf-dist/fonts/tfm/adobe/helvetic/phvr7t.tfm > + texmf-dist/fonts/tfm/adobe/helvetic/phvr7tn.tfm > + texmf-dist/fonts/vf/adobe/helvetic/phvr7t.vf > + texmf-dist/fonts/vf/adobe/helvetic/phvr7tn.vf > +tex4ht: > + texmf-dist/tex4ht/ht-fonts/alias/adobe/helvetic/phvr7t.htf > +@end example > + > +The file is available in the @TeX{} Live @code{helvetic} package, which = is > +known in Guix as @code{texlive-helvetic}. Quite a ride, but we found > +it! Perfect! Thank you! --=20 Ricardo