From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp10.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 qBP7AiXWB2OnNQAAbAwnHQ (envelope-from ) for ; Thu, 25 Aug 2022 22:05:57 +0200 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp10.migadu.com with LMTPS id GH0dAiXWB2NMcQAAG6o9tA (envelope-from ) for ; Thu, 25 Aug 2022 22:05:57 +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 B87A387C8 for ; Thu, 25 Aug 2022 22:05:56 +0200 (CEST) Received: from localhost ([::1]:49094 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1oRJ6x-0007uD-2E for larch@yhetil.org; Thu, 25 Aug 2022 16:05:55 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:46638) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1oRJ66-0007tr-LZ for guix-patches@gnu.org; Thu, 25 Aug 2022 16:05:03 -0400 Received: from debbugs.gnu.org ([209.51.188.43]:33408) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1oRJ66-0007Uv-86 for guix-patches@gnu.org; Thu, 25 Aug 2022 16:05:02 -0400 Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1oRJ65-0002QY-TL for guix-patches@gnu.org; Thu, 25 Aug 2022 16:05:01 -0400 X-Loop: help-debbugs@gnu.org Subject: [bug#57050] [PATCH v3 07/14] gnu: Add Zuo. Resent-From: "Philip McGrath" Original-Sender: "Debbugs-submit" Resent-CC: guix-patches@gnu.org Resent-Date: Thu, 25 Aug 2022 20:05:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 57050 X-GNU-PR-Package: guix-patches X-GNU-PR-Keywords: patch To: "Efraim Flashner" Cc: Thiago Jung Bauermann , "\(" , Maxime Devos , Liliana Marie Prikler , Liliana Marie Prikler , 57050@debbugs.gnu.org Received: via spool by 57050-submit@debbugs.gnu.org id=B57050.16614578949314 (code B ref 57050); Thu, 25 Aug 2022 20:05:01 +0000 Received: (at 57050) by debbugs.gnu.org; 25 Aug 2022 20:04:54 +0000 Received: from localhost ([127.0.0.1]:51390 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oRJ5w-0002Q6-Gl for submit@debbugs.gnu.org; Thu, 25 Aug 2022 16:04:54 -0400 Received: from wout5-smtp.messagingengine.com ([64.147.123.21]:38441) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1oRJ5r-0002Pi-HW for 57050@debbugs.gnu.org; Thu, 25 Aug 2022 16:04:51 -0400 Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.west.internal (Postfix) with ESMTP id D1A7E32000CC; Thu, 25 Aug 2022 16:04:38 -0400 (EDT) Received: from imap52 ([10.202.2.102]) by compute4.internal (MEProxy); Thu, 25 Aug 2022 16:04:39 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= philipmcgrath.com; h=cc:cc:content-transfer-encoding :content-type:date:date:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:sender:subject :subject:to:to; s=fm1; t=1661457878; x=1661544278; bh=Hq0f+PFWRV +fPiiDOUsptDSpo+Bsfv2kAE4RMn81SLs=; b=LQL2Yb757QQofbysR2DMz87+xz NBXwjfQT5ux8N0Tnluv0bbkeoCeEQVeX0WBQWJ5csYERa4DcgvlHzDP6d+jquKVl 9DppNoz6OYpEZTpHx6IXJo2IP13abDGaw75n50qAIUyprwJlu/JqO8KYToIw1SQk DEImbp7Xll5qxmjzgK82v8f71TSYf102Dd9dYTpDaxOhI6EBNW/HsnPufYMHwvQ1 cMa6DMJ2XbdQkdRPXOPPQAm6FrIlgcFKoG1b46uMbZF2tvHePC2h/rtx6erYit/Z 2INHd6Sy2Bq5rgRQcYDZ9Vj1/ANF8Iammu6ehumf5q/q27jP4evMGXNH4jYQ== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding :content-type:date:date:feedback-id:feedback-id:from:from :in-reply-to:in-reply-to:message-id:mime-version:references :reply-to:sender:subject:subject:to:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm1; t=1661457878; x= 1661544278; bh=Hq0f+PFWRV+fPiiDOUsptDSpo+Bsfv2kAE4RMn81SLs=; b=e zoIOGa0YTEfF8h/WmNPkHWZFNVI5SRKujoG7EZqEoKDaX899O3f6ADrbIdABOzUw 5Qo6SOaaLfb0zn4ronmesGhhpb4Nju54D+FPJE4f3P+5+RSOG98D7awoO4LgFEBZ 4P+/okpMn3G/mzEqs4mdh3CPpu7zUeXd0ZYCFxQR+8xrObdQ9oL619B2g0rVKMjn 3Rnc74ngxYgBSE1vRIxshxnvTceJM0wX3ZTB3sdNz9mfePY61iKCNvmw6yXCyfk7 6sgTLzlagJNfRXOYNj9yLbaLFOrZysfAan1qdenUezL9PHwpyLxaT5yXm6B8KUBM g9xhFUMNBk6xkQkrygs6g== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvfedrvdejfedgudegfecutefuodetggdotefrod ftvfcurfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfgh necuuegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmd enucfjughrpefofgggkfgjfhffhffvvefutgfgsehtqhertderreejnecuhfhrohhmpedf rfhhihhlihhpucfotgfirhgrthhhfdcuoehphhhilhhiphesphhhihhlihhpmhgtghhrrg hthhdrtghomheqnecuggftrfgrthhtvghrnhepkeeijeehgfegtedvjeduleeiudeghefh tdffteevudefleeiffelveekhfevveetnecuvehluhhsthgvrhfuihiivgeptdenucfrrg hrrghmpehmrghilhhfrhhomhepphhhihhlihhpsehphhhilhhiphhmtghgrhgrthhhrdgt ohhm X-ME-Proxy: Feedback-ID: i2b1146f3:Fastmail Received: by mailuser.nyi.internal (Postfix, from userid 501) id BA7D9C60093; Thu, 25 Aug 2022 16:04:37 -0400 (EDT) X-Mailer: MessagingEngine.com Webmail Interface User-Agent: Cyrus-JMAP/3.7.0-alpha0-841-g7899e99a45-fm-20220811.002-g7899e99a Mime-Version: 1.0 Message-Id: <490171b8-eb12-4274-830d-039f23d1bb6f@www.fastmail.com> In-Reply-To: References: <3231fd55699bd60448e5aaa3ca8ddf9fbea085c6.1661416343.git.philip@philipmcgrath.com> Date: Thu, 25 Aug 2022 16:04:15 -0400 From: "Philip McGrath" Content-Type: text/plain;charset=utf-8 Content-Transfer-Encoding: quoted-printable 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-To: larch@yhetil.org X-Migadu-Country: US ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1661457956; 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=Hq0f+PFWRV+fPiiDOUsptDSpo+Bsfv2kAE4RMn81SLs=; b=gpUhPJpTu+/T0b+blYsGMfFxrdAUhM3qb0PkLVQ8EuN+4HcHIto45lAOhjuYbjSZkUUqNH 7hEs8Zfaksyhwgl/bnQknELGgNrye49Twqdq8LSzO7MzVWUB+eqW8Tg/4UOaLNhAFPX4CM M1sjcm8EhM3l0hXp/pkpBcDieUiUNt3wSnkiRO/JXc06v8SRZd0CbeKhEVr9TZdDiVv+ya pFuHQTyS4lXpFZVcXsucP6CCaW1Xm9CcAQxfyx1D634hxUpzI776U0IgSGOj5P1N2Z5KNK t7/L41kl4h8EL7xMdJm/YmW6fFOfTyLCCjGgrTPrPbxv95+OLS6/d+u6rmWsQg== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1661457956; a=rsa-sha256; cv=none; b=IoeduFgJULj3N3ElTUsqJvmKJLTrihBCZ/P7gmaQWt22b7JU30mmKbe+PNesZGTaq/aT76 gOqFW7axheMvMwKYAVZtblLSsFY4kT9pfGkdSUHtDUJA7aK1c0cl52OjMAk3YI1F9iCJa8 xP8gQdqSkf8kO5UxzFyIyr3qAIl4QPj8EpnjZcEDEyW4uTtzM95rIsJcoBa+tdE4ekrScB jH06/wir0UBIGee9+OkrnMwKJiqGKz0pFffdOPwh4UHJNJjiKpQZ1/0nBdcdLmG2lhz2HW bxDF0Iv2ke88WTTs+3uzDe/LHFwJmwRHrDFQ4eqPAsnfHhy66udbrPR82omKZA== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=philipmcgrath.com header.s=fm1 header.b=LQL2Yb75; dkim=fail ("headers rsa verify failed") header.d=messagingengine.com header.s=fm1 header.b="e zoIOGa"; 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.90 Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=philipmcgrath.com header.s=fm1 header.b=LQL2Yb75; dkim=fail ("headers rsa verify failed") header.d=messagingengine.com header.s=fm1 header.b="e zoIOGa"; 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: B87A387C8 X-Spam-Score: 1.90 X-Migadu-Scanner: scn0.migadu.com X-TUID: haOj2Sw+bO7Y On Thu, Aug 25, 2022, at 6:30 AM, Efraim Flashner wrote: > On Thu, Aug 25, 2022 at 04:54:09AM -0400, Philip McGrath wrote: >> + (synopsis "Tiny Racket for build scripts") >> + (description "You should use Racket to write scripts. But wha= t if you >> +need something much smaller than Racket for some reason=E2=80=94or w= hat if you're >> +trying to script a build of Racket itself? Zuo (=E4=BD=9C) is a tin= y Racket with >> +primitives for dealing with files and running processes, and it come= s with a >> +@command{make}-like embedded DSL. >> + >> +Zuo is a Racket variant in the sense that program files start with >> +@code{#lang}, and the module path after @code{#lang} determines the = parsing >> +and expansion of the file content. That's how the @command{make}-li= ke DSL is >> +defined, and even the base Zuo language is defined by layers of @cod= e{#lang}s. >> +One of the early layers implements macros.") >> + (license (list license:asl2.0 license:expat))))) > > I'm not sold on the second paragraph, but I understand it's from > upstream so that's not too bad. For the first paragraph I'd drop the > first two sentences and consider @acronym{symbol, Zuo} for the next > sentence. > That seems reasonable. For acronym, though, the manual says that "in Tex= info, an acronym (but not an abbreviation) should consist only of capita= l letters and periods, no lowercase," and when I tried '@abbr{Zuo, =E4=BD= =9C}' it was rejected as "invalid Texinfo markup". I'm also not sure tha= t the generated HTML would be semantically correct. How does this seem? (description "Zuo (=E4=BD=9C) is a tiny Racket with primitives for= dealing with files and running processes. It comes with a @command{make}-like embedded DSL, which is used to build Racket itself. Zuo is a Racket variant in the sense that program files start with @code{#lang}, and the module path after @code{#lang} determines the pars= ing and expansion of the file content. That's how the @command{make}-like D= SL is defined, and even the base Zuo language is defined by layers of @code{#l= ang}s. One of the early layers implements macros.") -Philip