From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0.migadu.com ([2001:41d0:303:5f26::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id aPxzO1ehk2V2DgEAkFu2QA (envelope-from ) for ; Tue, 02 Jan 2024 06:38:32 +0100 Received: from aspmx1.migadu.com ([2001:41d0:403:58f0::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0.migadu.com with LMTPS id 0GKSNVehk2UySwEAqHPOHw (envelope-from ) for ; Tue, 02 Jan 2024 06:38:31 +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="uw/5EcjX"; 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-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=yhetil.org; s=key1; t=1704173911; 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=+STb9T/X8z2qM4I/nMu69HkUdf2C3IYiajDcQFu/ARM=; b=BQQ7QJXViT7aMdn/iblrkByUfS5lC6gc4qLiCn9ZCNlUpxREpuYBS4wHi6SFLZ+xiRPUZC 2qDqcNq38Bpr+DgTcUxf4lf261Rf3cChhw8cJZ6csLtShDdoCRr1G6g1rabd5LtQ1DUVEG 7E2E20bfIzkh44/33d+XxGmxpDwdPKNX5fUKUYfilo00T0KH8H5G+RqZO3yFrU8FUZyi0M fHlzR7qX1bAzq+OssEhyAvzbrNY8QpxqkKbbvMVWNSR7M0HwjZ2Bsd/KS7Eol9IL3PSENU H3Ev9RwqoUdaMEwAg9m6RLDRSIhxvSmOjTow9Z1nPKkxUFAUZLL2wU81EYtWFA== ARC-Seal: i=1; s=key1; d=yhetil.org; t=1704173911; a=rsa-sha256; cv=none; b=d/IxBFb3t9d5dnM40623r6WOsbTZzVp6BD393KfUVypRaoqBqf4EVgafjKgMAEDOke8P4v LdeUtJrQ3HpR1Z97kd4m+b0nXFOvLPllFJEdxkV6hEbXVskXqDF7tE4NyFF2E9yn/rCJbU A09fPHB7n+t5U/I7xlEdxpXCn2nnSKMzffiJVg0iutzlw4WcfIr6VhKhHyKX/jCjL/k3nm gIz1q7HhO6v5FCHzostxedjQ1hA4/4vGsE/y6dmvQGBY3o0QjActV1PBXarfYrGolZ7cHV TDkUx64kWyy+bJfKRiOiA1HVQU5X1zBLJcnApWuEqnwHygdTNhjGZnk35+iWJg== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=fail ("headers rsa verify failed") header.d=tsdye.online header.s=default header.b="uw/5EcjX"; 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 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 C7FB642230 for ; Tue, 2 Jan 2024 06:38:31 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rKXT6-0008WP-Jz; Tue, 02 Jan 2024 00:37:36 -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 1rKXT4-0008WH-Rk for emacs-orgmode@gnu.org; Tue, 02 Jan 2024 00:37:34 -0500 Received: from omta36.uswest2.a.cloudfilter.net ([35.89.44.35]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rKXT3-0005fP-2l for emacs-orgmode@gnu.org; Tue, 02 Jan 2024 00:37:34 -0500 Received: from eig-obgw-6002a.ext.cloudfilter.net ([10.0.30.222]) by cmsmtp with ESMTPS id KRDWrnLphhqFdKXSmrIWIo; Tue, 02 Jan 2024 05:37:16 +0000 Received: from box2035.bluehost.com ([74.220.219.237]) by cmsmtp with ESMTPS id KXSkrYPckM0U2KXSlrmrpx; Tue, 02 Jan 2024 05:37:15 +0000 X-Authority-Analysis: v=2.4 cv=BuKOfKb5 c=1 sm=1 tr=0 ts=6593a10b a=VozZY++RX3oc2UgfNhVfaA==:117 a=VozZY++RX3oc2UgfNhVfaA==:17 a=CFyAgp43AAAA:8 a=OWjo9vPv0XrRhIrVQ50Ab3nP57M=:19 a=dLZJa+xiwSxG16/P+YVxDGlgEgI=:19 a=MKtGQD3n3ToA:10 a=1oJP67jkp3AA:10 a=dEuoMetlWLkA:10 a=DPR-AOO6AYYA:10 a=A2tt7buDTgEA:10 a=uChsZFC9AAAA:8 a=o9zw6IYYAAAA:8 a=85Bfl-6d9Byps2sfk8wA:9 a=-FEs8UIgK8oA:10 a=Xwev4ZKu_U9tXES86-1H:22 a=ULtXvzFHYWHLyBAuiDia:22 a=BtxB1_lq3pBo68oZtZ_9: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:In-reply-to :Date:Subject:Cc:To:From:References: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=+STb9T/X8z2qM4I/nMu69HkUdf2C3IYiajDcQFu/ARM=; b=uw/5EcjXivFnEQb2ASsFqR0kFz w3q+0suQi9mIT6K9lw/uV1wibZUcy/1SC/gf+hL0ByqGNkLglNxSlmUWlJIqZyVcM989Y8ilZC9Wt xc58K+Hu9Lu7rAJ91N0fPZTimgPVp0Q3kHXovaY79i+5lYXfpd2Z75P4yRpk08rF+h4N+FCcJwZCu GuQ9DM23meRMRi3e/nSMG4zARR0klebSOIHH7rWJlKcH3YARR17lE/w/GuESrursa8/KRXw1rM/Ey HigmEJTh5sj08PEXY9CA1SmVzq9I1g4WlvpOLe9OM185Z60LxxYBm/iJCQ/BM4RB8aCgguYoWQcpj ZNHchHnA==; Received: from 050-113-033-148.res.spectrum.com ([50.113.33.148]:33396 helo=lemur.tsdye.online) by box2035.bluehost.com with esmtps (TLS1.2) tls TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 (Exim 4.96.2) (envelope-from ) id 1rKXSk-000Hlr-1C; Mon, 01 Jan 2024 22:37:14 -0700 References: <87il4e75u8.fsf@localhost> User-agent: mu4e 1.6.10; emacs 27.1 From: "Thomas S. Dye" To: Ihor Radchenko Cc: Bastien , emacs-orgmode@gnu.org Subject: Re: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable Date: Mon, 01 Jan 2024 19:24:06 -1000 In-reply-to: <87il4e75u8.fsf@localhost> Message-ID: <87v88c5m9j.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: 1rKXSk-000Hlr-1C X-Source: X-Source-Args: X-Source-Dir: X-Source-Sender: 050-113-033-148.res.spectrum.com (lemur.tsdye.online) [50.113.33.148]:33396 X-Source-Auth: tsdyeonl X-Email-Count: 3 X-Org: HG=bhshared;ORG=bluehost; X-Source-Cap: dHNkeWVvbmw7dHNkeWVvbmw7Ym94MjAzNS5ibHVlaG9zdC5jb20= X-Local-Domain: yes X-CMAE-Envelope: MS4xfBYQLydiyAP8RvIIRN7MKt7wbIT75BYeOcmzPO83ukFhI4KPaS9bAgbrnQpusbyI1Ha943SWkkLUUrrT5oeUyL/d2QI7+x2Kbyp/UNTh3CKtlN76sQIq dsTGRnj9PoywUWk0fkzaawgtmXYUWQ6gyqVNWNN/XE6ljSJLJtkV3f0g4sHCDhc6mvdPEZY58Bc95QJU7wPndiDovVkq+5SJ2zI= Received-SPF: pass client-ip=35.89.44.35; envelope-from=tsd@tsdye.online; helo=omta36.uswest2.a.cloudfilter.net 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, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, FROM_SUSPICIOUS_NTLD=0.178, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_PDS_OTHER_BAD_TLD=0.01, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham 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.43 X-Spam-Score: -0.43 X-Migadu-Queue-Id: C7FB642230 X-Migadu-Scanner: mx11.migadu.com X-TUID: TF6gQxr7Dj2B Aloha Ihor, Ihor Radchenko writes: > @@ -22,6 +22,10 @@ ** Summary > It relies on a lightweight plain-text markup language used in > files > with the =.org= extension. > > +Org files can be viewed using any text editor. You can read > and > +understand raw Org markup with a naked eye. Although authoring > Org > +files is best-supported inside Emacs. > + > As an authoring tool, Org helps you write structured documents > and > provides exporting facilities. Org files can also be used for > literate > programming and reproducible research. As a TODO lists > manager, Org > -- > 2.42.0 How about this, assuming lightweight is equivalent to readable and easy to understand? It relies on a readable and easy to understand plain-text markup language saved to files with the =.org= extension. Authoring Org files is best supported by Emacs, but you can view and change them with any text editor. As an authoring tool ... All the best, Tom -- Thomas S. Dye https://tsdye.online/tsdye