From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms0.migadu.com with LMTPS id eMbIJcFxH2ITlwAAgWs5BA (envelope-from ) for ; Wed, 02 Mar 2022 14:31:45 +0100 Received: from aspmx1.migadu.com ([2001:41d0:8:6d80::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id JuG2HsFxH2J1KAEAG6o9tA (envelope-from ) for ; Wed, 02 Mar 2022 14:31:45 +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 37DB93BD8F for ; Wed, 2 Mar 2022 14:31:45 +0100 (CET) Received: from localhost ([::1]:41608 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nPP4x-000800-UD for larch@yhetil.org; Wed, 02 Mar 2022 08:31:43 -0500 Received: from eggs.gnu.org ([209.51.188.92]:43574) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nPNrm-0003ZT-Gr for guix-patches@gnu.org; Wed, 02 Mar 2022 07:14:04 -0500 Received: from debbugs.gnu.org ([209.51.188.43]:45399) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nPNrm-0000ec-7w for guix-patches@gnu.org; Wed, 02 Mar 2022 07:14:02 -0500 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1nPNrl-00073B-TE for guix-patches@gnu.org; Wed, 02 Mar 2022 07:14: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 12:14: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: mail@nicolasgoaziou.fr, 54220@debbugs.gnu.org, bauermann@kolabnow.com Received: via spool by 54220-submit@debbugs.gnu.org id=B54220.164622324127087 (code B ref 54220); Wed, 02 Mar 2022 12:14:01 +0000 Received: (at 54220) by debbugs.gnu.org; 2 Mar 2022 12:14:01 +0000 Received: from localhost ([127.0.0.1]:39296 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPNrk-00072p-Do for submit@debbugs.gnu.org; Wed, 02 Mar 2022 07:14:00 -0500 Received: from sender4-of-o51.zoho.com ([136.143.188.51]:21178) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1nPNrh-00072f-Uc for 54220@debbugs.gnu.org; Wed, 02 Mar 2022 07:13:58 -0500 ARC-Seal: i=1; a=rsa-sha256; t=1646223222; cv=none; d=zohomail.com; s=zohoarc; b=L89SMux66ffx4aUvLU4nCB5cScwIpMz+BtLIBJlWCbsQV5n6zw4FQpOwBDdQ8KI0zju1aHf/7PRudwIqU3lq4/DISqlgfave1lI9hQsDobc/mBbudvrBGUgTYvcMPSgtMFWarq1nnoPuyWXq639ZX49QDN2K7ORTR6rafKz/FaY= ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=zohomail.com; s=zohoarc; t=1646223222; h=Content-Type:Content-Transfer-Encoding:Cc:Date:From:In-Reply-To:MIME-Version:Message-ID:References:Subject:To; bh=mYHh7MI2BgfPuC34G3sYN+uhLidKxe5jQsi/SkPZYCc=; b=kWwP32bMzsi3WUSjU7PmFqTTDRbnQMlZ1xMlJga4c08K/ZT9M+gEZyY23jX1DTm8r/Ti8oxWgy/Xvott3+LDUptmhvDwpeyod0P9BTVrprgfqYhTsidjQWB/8zGZ5KVsx9BSoWZ5304DxXNxZ0lMWKObu9Z0Deim1AXD/PE6P04= 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=1646223222; 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=mYHh7MI2BgfPuC34G3sYN+uhLidKxe5jQsi/SkPZYCc=; b=Cgx3pF1+6Um0JJdu7t2f2W17jc4fI4M1xgqzxDPuHcE4LDOaTveBD8FdjU05ieM/ 6igckCwqzKXdPPhlgq5V5nhpRY0WGxfHEhW+JiRZVUFKVTdaFLwX7cVjtZaXfF/3w5Q t4v0rpfHT8KSCavWMedy1jiFYszMSyEUfE0B6wqw= Received: from localhost (p54ad4e6f.dip0.t-ipconnect.de [84.173.78.111]) by mx.zohomail.com with SMTPS id 1646223220509498.5634129328407; Wed, 2 Mar 2022 04:13:40 -0800 (PST) References: <20220302095550.17700-1-ludo@gnu.org> <87pmn41wh9.fsf@elephly.net> <877d9c37me.fsf_-_@gnu.org> User-agent: mu4e 1.6.10; emacs 28.0.50 From: Ricardo Wurmus Date: Wed, 02 Mar 2022 13:11:05 +0100 In-reply-to: <877d9c37me.fsf_-_@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: <87lexs1rin.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=1646227905; 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=mYHh7MI2BgfPuC34G3sYN+uhLidKxe5jQsi/SkPZYCc=; b=kuyPoLI7f0ZB8i8tCNzoP3w/mVte54RpCLJjiIj/tHwEqAxTz92ecsZEyE6rlb8XSvs+3f aXXsNdi6CqQiEkL24LfkJ4qFfk0w78uShPW3E6prPWPYh9O2HAAIqEmJdU68CqFGn8iwR0 K8ugaQlemmBfXG5TY35m5zwLMkkBt+zZh4371Ui2k6I5FsGAYJrNfzS5RrocG3bxYVqllO qBdZtq6n2ZD9gc7SI3ypl4z0RP099ajY4o9U1mQHFUhAlGDUa4qz+UQAhSDvAZWJXw0NhT 9+hHCu60mqf7J0+qUzM1WnhxcjJGoD1gBZaCQglk4TRLVmK1w3cmISp4eOZ+Yg== ARC-Seal: i=2; s=key1; d=yhetil.org; t=1646227905; a=rsa-sha256; cv=fail; b=qVa9OKPR0eU9jhfxI6e1zv5Sutvo55DhDnTC6+9ulIrs4m2hKty5rqT2+Bh4Oyg5cdnZNV tTNx+4vtEshb78Jc7j0XyScUhM1glUr2ewTOnZBamz9X/tPHNAT9J805eEeW7lvypPwEwZ /HaMsKN3yXYl1Ww/EO5BikyryHkBTpC9Fdd/frLcagH4lAgXECf4auMVdgI1ZkfqJIdBh6 iVLRoYXkjQVQAk2w9SeKm1lhDSixoAdOHcYLYCkRVFsQx7RCokNd/6iUIf81ruQhu8EFIX Gmsblng/gE1GicxBmNoaAOMd+eEt7m+NElgr+zleAjM2F6JVnFmbBExXKn/Zug== ARC-Authentication-Results: i=2; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=elephly.net header.s=zoho header.b=Cgx3pF1+; 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.32 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=elephly.net header.s=zoho header.b=Cgx3pF1+; 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: 37DB93BD8F X-Spam-Score: 1.32 X-Migadu-Scanner: scn0.migadu.com X-TUID: oKkF/oRdluKN Ludovic Court=C3=A8s writes: >>> It=E2=80=99s a top-level chapter, because I couldn=E2=80=99t find any b= etter place, but >>> I think it=E2=80=99s fine. >> >> Hmm, maybe in (possibly renamed) =E2=80=9CApplication Setup=E2=80=9D? > > =E2=80=9CApplication Setup=E2=80=9D is about configuration on a foreign d= istro, so I > don=E2=80=99t think it=E2=80=99s the right place. > > Perhaps we need a more general chapter on using things under Guix, where > we could also have (say) a =E2=80=9CWorking with Python=E2=80=9D section,= and perhaps we > could move =E2=80=9CInstalling Debugging Files=E2=80=9D there? I thought= I=E2=80=99d leave that > for later. Sounds good. >>> +@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 use= r, >>> +would welcome guidance on how to deploy the relevant packages so you c= an >>> +compile your @TeX{} and @LaTeX{} documents. >> >> Why single out TeX in particular? > > You mean LaTeX, right? Heh, see: that shows how subjective it is :) No, I did mean TeX, because in my experience it is extremely uncommon to use TeX directly. >> 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. > > Yeah, I think to most people it=E2=80=99s all the same :-) and LaTeX is b= y far > the most famous one. > > Maybe we could phrase it differently, like =E2=80=9CUsing TeX, LaTeX, and > Related Tools=E2=80=9D? Nah, it=E2=80=99s fine. By the time I wrote the last sentence you quoted a= bove I had convinced myself that it=E2=80=99s fine to mention TeX (because it=E2= =80=99s the foundation) and LaTeX (because it=E2=80=99s the most popular). >>> +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/Tik= Z, >> >> 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-l= atex-pgf=E2=80=9D. It really >> should be =E2=80=9Ctexlive-listings=E2=80=9D and =E2=80=9Ctexlive-pgf=E2= =80=9D. > > [...] > > Yeah, I can rename at least these two packages in a first patch (I will > have to check the number of rebuilds) and adjust the text to refer to > the new names. Thanks. --=20 Ricardo