From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms13.migadu.com with LMTPS id yFJrEN00mWcDRgAAe85BDQ:P1 (envelope-from ) for ; Tue, 28 Jan 2025 19:49:49 +0000 Received: from aspmx1.migadu.com ([2001:41d0:403:4876::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2.migadu.com with LMTPS id yFJrEN00mWcDRgAAe85BDQ (envelope-from ) for ; Tue, 28 Jan 2025 20:49:49 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=tsdye.online header.s=default header.b=KM8WxdXy; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; dmarc=none ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=tsdye.online header.s=default header.b=KM8WxdXy; spf=pass (aspmx1.migadu.com: domain of "emacs-orgmode-bounces+larch=yhetil.org@gnu.org" designates 209.51.188.17 as permitted sender) smtp.mailfrom="emacs-orgmode-bounces+larch=yhetil.org@gnu.org"; dmarc=none ARC-Seal: i=1; s=key1; d=yhetil.org; t=1738093788; a=rsa-sha256; cv=none; b=QBuTdRbLch8rDPGqz/QjzPa0/2iNzPQBlKlRcssb2j5BLuMhAzxmddJnEndJArIjVLqvkW ylLYzm0PS7Z8eJQjocgOSSNW+HECK8s0CpdRiYj9C2tsjVhMwRIqVdj9eom029GqgnG9z+ ZdZyrm9n4rBkGZO+wIZazuHvJs+fnRpPN8ZkvAJ7vXbN6M3L1ABONTYJIuXExxVtoOFVio iM4VJCijWMqL7ssEPwmNn/Hhd40bOoxP0uHon7QbiB5C0aVBUKlF62Fgj2vzS8NAB9ctEK j9oMFY/Mwz+4iAOWFOce91V/cAxNGL+k2Z3mE+X0pSmIjgaxQ6siGlayxv6Czg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1738093788; 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:in-reply-to:in-reply-to: references:references:list-id:list-help:list-unsubscribe: list-subscribe:list-post:dkim-signature; bh=+iDBNze5pHnJxAJ8IHpLOcpfwwvuN3+dtCVDto/p3t4=; b=nb0qJ+lvJmQUMhcDVg7v2C8X75tCvR0u5DYU5MKxu9VQlyhmI1HR/aJ1xmPIAbAPV0sbst 8YK+nYRgTy1ux7b5PWX0XyDVITNaVOZx64apNLZuFdpNZ5X/m+JQufEtsX4AVyzG62wR3F t48keN8sOa7b8l8a8QNW2xEdcr9H9DOigZDVJYjIidUzbDIzb0RBVgskrAcZSwS9qUY34P Xn0mlBOChBDOQYYC4QXxWpxWNSHyLD9DukC2GmwV4AH6oApbwKr5zqFQl5GG1TuZolRMsi eOHBCx5ZVIz01ZDnYUNt0AnrSjmu+h3mUkhkZiB5DhJJb06BfmW5bBpN8lLlAQ== 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 290FD910AA for ; Tue, 28 Jan 2025 20:49:48 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1tcrZz-0001nO-Ba; Tue, 28 Jan 2025 14:48:59 -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 1tcrZw-0001lG-Vl for emacs-orgmode@gnu.org; Tue, 28 Jan 2025 14:48:56 -0500 Received: from omta040.useast.a.cloudfilter.net ([44.202.169.39]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1tcrZv-000717-8t for emacs-orgmode@gnu.org; Tue, 28 Jan 2025 14:48:56 -0500 Received: from eig-obgw-6007a.ext.cloudfilter.net ([10.0.30.247]) by cmsmtp with ESMTPS id cpZRtV7MK1T3hcrZhtGb4M; Tue, 28 Jan 2025 19:48:41 +0000 Received: from box2035.bluehost.com ([74.220.219.237]) by cmsmtp with ESMTPS id crZgtuqNf3770crZgt66yK; Tue, 28 Jan 2025 19:48:40 +0000 X-Authority-Analysis: v=2.4 cv=WYoKaVhX c=1 sm=1 tr=0 ts=67993498 a=VozZY++RX3oc2UgfNhVfaA==:117 a=VozZY++RX3oc2UgfNhVfaA==:17 a=MKtGQD3n3ToA:10 a=1oJP67jkp3AA:10 a=VdSt8ZQiCzkA:10 a=nJrs4UJQBjcA:10 a=NjIK7znJAAAA:8 a=o9zw6IYYAAAA:8 a=uChsZFC9AAAA:8 a=KSH9B2dW1M0guzfJGn8A:9 a=1iEmZPVasz4A:10 a=wW9FBh6_r7wA:10 a=-FEs8UIgK8oA:10 a=O1c1nmEkCxIQdeELtU9r:22 a=BtxB1_lq3pBo68oZtZ_9:22 a=ULtXvzFHYWHLyBAuiDia:22 a=A2tt7buDTgElyBcRWK2c:22 a=1ZBvEmPAInNS7xgDtvbF:22 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=tsdye.online; s=default; h=Content-Type:MIME-Version:Message-ID:Date: References:In-Reply-To:Subject:Cc:To:From:Sender:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID:List-Id: List-Help:List-Unsubscribe:List-Subscribe:List-Post:List-Owner:List-Archive; bh=+iDBNze5pHnJxAJ8IHpLOcpfwwvuN3+dtCVDto/p3t4=; b=KM8WxdXymX1VVzBTv3vMU1zsIa 6cj2xI0guoSDA+txxdHbs215vdLd/AwttZrH9mpp0FVgBQv9W0d9IgfjcLyVjUde1TLkkR737THal Prrci1zTuaQELB0e38Aiw/QbwKGAdUwpZYKArBc5Qux9xWYyNf8Q9bNvWjL/m+rwzDOMSm8NpohQm 7lV81sc9j+xUztdyQcMyGZg/BNMzvZXQFcOjofMrnj/cmIREzNVo0XnrAyjgxu2+fzAw6hHyZwQJf qw+UWSaqkLyCy8yW9wXMmEEB+YQlsgQ085zwGvA/80AhEKaOZ3iA/ZBetqaKntIeDVF6Y7xxhLcCH lQqAF6cQ==; Received: from syn-050-113-033-148.res.spectrum.com ([50.113.33.148]:56858 helo=poto-foou.tsdye.online) by box2035.bluehost.com with esmtpsa (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96.2) (envelope-from ) id 1tcrZg-002Wwo-07; Tue, 28 Jan 2025 12:48:40 -0700 From: "Thomas S. Dye" To: Ihor Radchenko Cc: emacs-orgmode@gnu.org Subject: Re: Babel Forth In-Reply-To: <87jzaeaio6.fsf@localhost> (Ihor Radchenko's message of "Tue, 28 Jan 2025 18:37:45 +0000") References: <874j1qlgxe.fsf@tsdye.online> <87zfjhxrb7.fsf@localhost> <87y0z112w9.fsf@tsdye.online> <87jzaeaio6.fsf@localhost> Date: Tue, 28 Jan 2025 09:48:37 -1000 Message-ID: <875xlysoru.fsf@tsdye.online> MIME-Version: 1.0 Content-Type: text/plain; format=flowed X-AntiAbuse: This header was added to track abuse, please include it with any abuse report X-AntiAbuse: Primary Hostname - box2035.bluehost.com X-AntiAbuse: Original Domain - gnu.org X-AntiAbuse: Originator/Caller UID/GID - [47 12] / [47 12] X-AntiAbuse: Sender Address Domain - tsdye.online X-BWhitelist: no X-Source-IP: 50.113.33.148 X-Source-L: No X-Exim-ID: 1tcrZg-002Wwo-07 X-Source: X-Source-Args: X-Source-Dir: X-Source-Sender: syn-050-113-033-148.res.spectrum.com (poto-foou.tsdye.online) [50.113.33.148]:56858 X-Source-Auth: tsd@tsdye.online X-Email-Count: 2 X-Org: HG=bhshared;ORG=bluehost; X-Source-Cap: dHNkeWVvbmw7dHNkeWVvbmw7Ym94MjAzNS5ibHVlaG9zdC5jb20= X-Local-Domain: yes X-CMAE-Envelope: MS4xfFnPVXLH+8BRIvl5DgFuMBB+wVJdF9IAXbyE0A9xh5/yT8p2a988ydCMMEVBNQMkJfUcdepivs9pLfIx0+8QvS0jhTSCFBfae1oo0Wi7Ka5DrbUHdofo 0Retw/zx74+UJknjwZW5hfRsTCejpRfmxtDze2ECgSUtjTWOD8JVugxQuWPZstbz4TUa1ngeUlaa8IWYcW629AVFx0yQVy6dvSs= Received-SPF: pass client-ip=44.202.169.39; envelope-from=tsd@tsdye.online; helo=omta040.useast.a.cloudfilter.net X-Spam_score_int: -10 X-Spam_score: -1.1 X-Spam_bar: - X-Spam_report: (-1.1 / 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, FROM_SUSPICIOUS_NTLD=0.499, PDS_OTHER_BAD_TLD=0.512, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_MSPIKE_H3=0.001, RCVD_IN_MSPIKE_WL=0.001, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001, RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=no autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-orgmode@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+larch=yhetil.org@gnu.org Sender: emacs-orgmode-bounces+larch=yhetil.org@gnu.org X-Migadu-Flow: FLOW_IN X-Migadu-Country: US X-Migadu-Spam-Score: -0.99 X-Spam-Score: -0.99 X-Migadu-Queue-Id: 290FD910AA X-Migadu-Scanner: mx10.migadu.com X-TUID: 9h6o+zX3M5ZV Ihor Radchenko writes: > "Thomas S. Dye" writes: > >> I pushed Forth documentation to the Worg repo, > > Thanks! > I have 2 comments: > >> +Babel evaluates Forth code blocks in an inferior Forth >> process. >> +You can start an inferior Forth process with =M-x run-forth=. > > Does it mean that users _must_ run M-x run-forth? Otherwise, I > am not > sure why this paragraph is present. Thanks! Edited to indicate a running Forth instance is needed to evaluate Forth code blocks. >> +#+begin_example >> +,#+begin_src forth :exports both >> +." Hello World!" >> +,#+end_src >> +#+end_example >> + >> +#+begin_src forth :exports both >> +." Hello World!" > > This will export into 3! snippets. I feel that > https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-forth.html > is confusing. Maybe we just put both the code and result into > verbatim > example, as in > https://orgmode.org/worg/org-contrib/babel/languages/ob-doc-shell.html Matt did a great job on ob-doc-shell. I kind of like the 3 (not 3! :) snippets because they show the Org mode buffer, the code export, and the results export. I feel this illustrates a lot of Babel capability. Nevertheless, the multiple snippets are potentially confusing, so I've followed Matt's lead and changed to a single example block. Hopefully, some Forth programmers can help flesh out this documentation stub. All the best, Tom -- Thomas S. Dye https://tsdye.online/tsdye