From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2.migadu.com ([2001:41d0:700:3204::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms8.migadu.com with LMTPS id uJQPErpNlWXWkgAAkFu2QA (envelope-from ) for ; Wed, 03 Jan 2024 13:06:18 +0100 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 IHZkCrpNlWVhUgEAe85BDQ (envelope-from ) for ; Wed, 03 Jan 2024 13:06:18 +0100 X-Envelope-To: larch@yhetil.org Authentication-Results: aspmx1.migadu.com; dkim=none; 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=1704283578; 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; bh=CTtLrNBQ2w0Ab6IJDxBQIRqE/GhxVSz4LykLQCYqp90=; b=pVLIz3Pe6KKCo/VV20QJQRFV6/XT1PQ8EnQLFtVuuzy4e/oAajlmthDdGWkkg5/Ls6GNK/ l/dNEnN1x865u2PGcHXpbaT2rjKUW3/wAq5jjeX+1gqV008XEmmKHymxecXTYYuXCj5+kK 6ECMNd4ee8kiIxwKycNloY9jgQz6IeOs7M/Diq2/XJLr3gAiDSsdJ3Dgf9/rX72x5ZzAaG MANy/0x8XLZ3demLG3Yzip15jDkBs7HgApBUzO+CgEfFkgYc0gOLs5cQmdsZpHRhhDYT+5 YOGGw7JUBwehVyjUhO+AMMn6llv9SdgLwRKtB1QNF8wQuoxWvO+kc9s9fz4yjQ== ARC-Authentication-Results: i=1; aspmx1.migadu.com; dkim=none; 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=1704283578; a=rsa-sha256; cv=none; b=RvLwmm128QDwERfbpqWATNRbrj54B0UUuF2gxGSXwUmL4FhYr1fb+3b5zVXK94ZIOK+0ED 00SP+Zpm1qU7rrRH7tUT0oWTQMX1zxWjlVXMXPxTEjjN4vpgqxcNSY1eE/RCfhtoiXfPVM 2TWtnhrA6X5YzBFS2r6acoYNOTHAEBR8PDm2htRX0TXV2Hw2MZ5RPa1SVb1xeD2MxmVM3I I0591Du1/B+BRdunsffdWmVzdEEQXS25dXPPBnhX7HLTvB+W/bK8AIkLpvQmfKZckTGS2F BE37nzr/pkUEOFKJ32jkzI2WMIL3XemVVf/2maqW69MIj/xrrYh5BQfez2dbQQ== 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 BD0C359DC2 for ; Wed, 3 Jan 2024 13:06:17 +0100 (CET) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1rKzzr-00075B-BD; Wed, 03 Jan 2024 07:05:19 -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 1rKzzp-00074t-P4 for emacs-orgmode@gnu.org; Wed, 03 Jan 2024 07:05:17 -0500 Received: from stw1.rcdrun.com ([217.170.207.13]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rKzzm-0008U5-IF; Wed, 03 Jan 2024 07:05:17 -0500 Received: from localhost ([::ffff:41.75.190.173]) (AUTH: PLAIN admin, TLS: TLS1.3,256bits,ECDHE_RSA_AES_256_GCM_SHA384) by stw1.rcdrun.com with ESMTPSA id 0000000000103C0C.0000000065954D56.000066FE; Wed, 03 Jan 2024 05:04:38 -0700 Date: Wed, 3 Jan 2024 10:52:18 +0300 From: Jean Louis To: "Thomas S. Dye" Cc: Ihor Radchenko , Bastien , emacs-orgmode@gnu.org Subject: Re: [PATCH] doc/org-manual.org (Summary): Clarify the Org markup is human-readable Message-ID: Mail-Followup-To: "Thomas S. Dye" , Ihor Radchenko , Bastien , emacs-orgmode@gnu.org References: <87il4e75u8.fsf@localhost> <87v88c5m9j.fsf@tsdye.online> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit Content-Disposition: inline In-Reply-To: <87v88c5m9j.fsf@tsdye.online> User-Agent: Mutt/2.2.10+64 (b470a9a) (2023-06-05) Received-SPF: pass client-ip=217.170.207.13; envelope-from=bugs@gnu.support; helo=stw1.rcdrun.com X-Spam_score_int: -2 X-Spam_score: -0.3 X-Spam_bar: / X-Spam_report: (-0.3 / 5.0 requ) BAYES_00=-1.9, DATE_IN_PAST_03_06=1.592, SPF_HELO_PASS=-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-Country: US X-Migadu-Flow: FLOW_IN X-Migadu-Spam-Score: -3.07 X-Spam-Score: -3.07 X-Migadu-Queue-Id: BD0C359DC2 X-Migadu-Scanner: mx10.migadu.com X-TUID: nPnLIDott9ur * Thomas S. Dye [2024-01-02 08:39]: > 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 ... In my opinion, it's not that Org was intentionally designed to be "lightweight markup readable for humans"; rather, it was maintained in a manner that focused on preserving its readability and prevented it from evolving into something less comprehensible. It's primary use was for Emacs users to make notes, TODO tasks, etc. It is secondary that it became leightweight markup language that can export to various documents. -- Jean Take action in Free Software Foundation campaigns: https://www.fsf.org/campaigns In support of Richard M. Stallman https://stallmansupport.org/