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 ms5.migadu.com with LMTPS id sD5SAH0xaGO7WgEAbAwnHQ (envelope-from ) for ; Sun, 06 Nov 2022 23:13:17 +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 8CkxAH0xaGNmtgAAauVa8A (envelope-from ) for ; Sun, 06 Nov 2022 23:13:17 +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 57F86143D2 for ; Sun, 6 Nov 2022 23:13:16 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1ornsc-0005lX-5h; Sun, 06 Nov 2022 17:12:38 -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 1ornsY-0005lK-AF for guix-devel@gnu.org; Sun, 06 Nov 2022 17:12:34 -0500 Received: from mail-wr1-x42f.google.com ([2a00:1450:4864:20::42f]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1ornsW-0001hf-7A for guix-devel@gnu.org; Sun, 06 Nov 2022 17:12:34 -0500 Received: by mail-wr1-x42f.google.com with SMTP id cl5so13783951wrb.9 for ; Sun, 06 Nov 2022 14:12:30 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=beadling-co-uk.20210112.gappssmtp.com; s=20210112; h=content-transfer-encoding:mime-version:date:message-id:in-reply-to :subject:cc:to:from:user-agent:references:from:to:cc:subject:date :message-id:reply-to; bh=+Q/7mLzxDBLh9+TYJrwiEt3VmI0xW9UdBQpM7n6AG7A=; b=kzFabRM9w4rp3EhF7ndzvNsWI6vQaUiWxB5XrKWDxeduvFK1mNJUY501h6bQPAFx1M Qu6g0zyznHsdFH4dicHltXYWQmRUXOLlVQYMwgjuUr0Fz6+93vUGD7l6x+aXsjwpidoN +V4+A302K9c1hX/aQbirgvFXD+lIGiCmrnEfWf2nBGE3Qr//mCcwws/zN8BLsZ7dkcoS Sn/C6H998wAdvbcxEGJMvB+WOrHCv+zAm5sHJKhyp2uEON0D4HD+8gvY6Sp1e48q6nMr ZY6YoqubvKE9Z2x7EKi6hPS1G86b9odDf4GDtWLmKO9mHjmablG6d5UhCGskyuXVamCp nGRg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:date:message-id:in-reply-to :subject:cc:to:from:user-agent:references:x-gm-message-state:from:to :cc:subject:date:message-id:reply-to; bh=+Q/7mLzxDBLh9+TYJrwiEt3VmI0xW9UdBQpM7n6AG7A=; b=HDAfjsjHb93F+h7xDKB57Hwf5Ck5+fxdRD60un0feEehHJPmtikSbz1mT3Krqr28bc sDZLUBn0+R24E5ibHxqAMbYcoyLUYHZPPjjDLFrbHFG9ejYlDaoK9M8/KJnVvXBFaBGO RvAVmmPTxzB9s1nLzvsA5W5BSawBiTXBY9yyTN/JKDT9uXFIqgCyGYc70fHPGG9Hp18r EptL84HuwHxM9QUPLUiRUkGhpBSAP73RiKzSSwug3/nWLiupDmeFOFXgwyaX4Vk5NI5G f2nFjwWz/WJRaJusqdV/fjhgCypmLlbkZX83SCqqeeRwmi9KBvaBMojs055xbjEIv0A6 f1DQ== X-Gm-Message-State: ACrzQf3KpJLZ4vclgDPE4cQscHXQe25rXt9l/yzQ4aIJvPBFs+p1fa87 VagS/RJpDFzqzYU+aZlH7Ukd3onW3Kvf+uEp X-Google-Smtp-Source: AMsMyM6peM+fH+aIbBI+zvObbGj6uFLbp+58l+QBN72x4BisGtMzrZcQcXLjmD9vkvRn5evL4uopNg== X-Received: by 2002:a5d:64e8:0:b0:236:6225:5c16 with SMTP id g8-20020a5d64e8000000b0023662255c16mr29585399wri.219.1667772749090; Sun, 06 Nov 2022 14:12:29 -0800 (PST) Received: from xps13 ([2a02:6b61:74f3:0:fae3:def7:9be5:1ea1]) by smtp.gmail.com with ESMTPSA id d6-20020adfe2c6000000b0022cc6b8df5esm5611715wrj.7.2022.11.06.14.12.28 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 06 Nov 2022 14:12:28 -0800 (PST) References: <87edup9h0y.fsf@beadling.co.uk> <87wn8dtwo5.fsf@gnu.org> <87sfiymkqn.fsf@beadling.co.uk> <87mt95mk1j.fsf@beadling.co.uk> <878rkpjn3e.fsf@gnu.org> <86wn87lxwv.fsf@gmail.com> User-agent: mu4e 1.4.15; emacs 27.2 From: Phil To: zimoun Cc: Ludovic =?utf-8?Q?Court=C3=A8s?= , guix-devel@gnu.org Subject: Re: Compile skribilo doc containing guix channel references In-reply-to: <86wn87lxwv.fsf@gmail.com> Message-ID: <87h6zbn35f.fsf@beadling.co.uk> Date: Sun, 06 Nov 2022 22:12:28 +0000 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable Received-SPF: none client-ip=2a00:1450:4864:20::42f; envelope-from=phil@beadling.co.uk; helo=mail-wr1-x42f.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_NONE=0.001 autolearn=unavailable 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=1667772796; 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=+Q/7mLzxDBLh9+TYJrwiEt3VmI0xW9UdBQpM7n6AG7A=; b=LNZ++zVEpMlpLoVYE+ry9ZKENeuwit+Q+0sYwGXpfdrEQHLC0IThJdiebHG4ZH39dBaZ7e VQ0YyMAywtftwNPBBo/4ZIwRkcOkFvno2AGb4t6qRcWhi1YavD95KIPexXb6HXFeYLYvmG vQ2oEteBMaHm76ImxI1xMEYiJYqeitbwuSud//UN8ujvuhyX9qCgum7SG/pDMe6hQJmw1m 1EkzgQsCxgOkMbDeizJSy9jpySd2tzNoMoEKclRNMukVquWiSxzBTAQPhgada11sjXrpkK b+UXxV1WTKXw+bcCN9zDRBBLHXP7s8YY6yFDQD5ZDBKTYr0IMaDqJv9R7klMQQ== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1667772796; a=rsa-sha256; cv=none; b=EP97oq5ByBewUrV4yzqzquENVtx5UVNRc8nUcafOtq2kn0yaINnhV4tphD6Syp+KzwpFK3 GEbjaHghkAf7iSWbdLxBjtPSBF9lwaGeonBjGl83XvsQbaIyKppdgV1g8LX+Ad/s0C0lou oWPqXHfnVObIUOXfrprgSnTaHryVaw/Ik+gELp7dAcp32rHK1QYmSc5GwobJz8elsIa5fy lYPMMYuFAB+rCTo/aDLqS/qTG3wOtYe/HkRluk/vCrz6n2P2rj7mFhmx6dqfRmJZG5Bmjx JEH2948qG4fRtFaJxc5Wp6cffAjbkEi6KYLTUkmxwu3HllWIlcvbKvafVP0mGg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=pass header.d=beadling-co-uk.20210112.gappssmtp.com header.s=20210112 header.b=kzFabRM9; 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: -3.50 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=beadling-co-uk.20210112.gappssmtp.com header.s=20210112 header.b=kzFabRM9; 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: 57F86143D2 X-Spam-Score: -3.50 X-Migadu-Scanner: scn1.migadu.com X-TUID: Z87TNYbPUINM Hi Simon, zimoun writes: > I am missing how the Skribilo file is it compiled? At =E2=80=9Cguix pull= =E2=80=9D time? > Or manually when running the script compile-docs.scm? > At the moment compilation is only manual and from inside the repo clone: guix environment skribilo guile -- guix repl -- compile-docs.scm Making it part of guix pull is an interesting idea given this is where standard package compilation takes place. For this to work any code references would have to be of the form: (use-modules (my-module foo) (package->code my-package) rather than direct access to scheme files in the repo clone using: (source :file "foo.scm" :definiton 'my-package) The advantage of using pacakge->code is that the documentation compilation is then decoupled from the repo clone and can be generated anywhere guix can be run (just like guix pull). The 2 disadvantages are 1) Files in the repo, but not part of the guix module system cannot be referenced, 2) The pretty-printing of packages generated using package->code does not perfectly reproduce the format in the repo clone - although they are functionally identical. For example inputs are referenced fully qualified in-situ - eg (@ (foo bar) baz), rather than just referencing baz in the inputs, and importing (foo bar) at the top of the module. Comments etc, are also lost too. If there was a nice way of referencing the uncompiled scheme files in the channel without needing the repo cloned that would be perfect IMHO. I don't think this is possible tho?