From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Michael Albinus Newsgroups: gmane.emacs.devel Subject: Re: Convert README.org to plain text README while installing package Date: Mon, 06 Jun 2022 18:56:14 +0200 Message-ID: <87zgipivdd.fsf@gmx.de> References: <87leuca7v7.fsf@disroot.org> <87czfopmsd.fsf@gnu.org> <87h74ztshe.fsf@gmx.de> <871qw31ois.fsf@yahoo.com> <8735gj4ceo.fsf@gnu.org> <87ee038ipt.fsf@gmx.de> <87o7z61v59.fsf@gmail.com> Mime-Version: 1.0 Content-Type: text/plain Content-Transfer-Encoding: quoted-printable Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="15951"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/29.0.50 (gnu/linux) Cc: emacs-devel@gnu.org To: Tim Cross Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Mon Jun 06 18:59:19 2022 Return-path: Envelope-to: ged-emacs-devel@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1nyG4U-0003xi-Se for ged-emacs-devel@m.gmane-mx.org; Mon, 06 Jun 2022 18:59:18 +0200 Original-Received: from localhost ([::1]:54136 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nyG4T-0006MV-Ow for ged-emacs-devel@m.gmane-mx.org; Mon, 06 Jun 2022 12:59:17 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58538) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nyG1e-0003ni-IV for emacs-devel@gnu.org; Mon, 06 Jun 2022 12:56:22 -0400 Original-Received: from mout.gmx.net ([212.227.15.15]:48919) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nyG1c-0007Xn-OE for emacs-devel@gnu.org; Mon, 06 Jun 2022 12:56:22 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=gmx.net; s=badeba3b8450; t=1654534576; bh=XoMQgBld8eymqSc1xhoOamxgafQU1RLNF29enO1ujkc=; h=X-UI-Sender-Class:From:To:Cc:Subject:References:Date:In-Reply-To; b=Qir1vqAWfH2jexwEGZGHdCaiA+SSRGGhfSkM6CWiXmqW2zMRtzoqbPcfY5hxsS8K/ ms3SZGjdYVqc9U4bRaj3A/ICjlTw4WHULVxDbtpkE8PiiY2Y5rlbECHpcH7TXAFZwk mfKNmLRrL3aHiNWUg074YF4YkyCQxB4zndbCAHK4= X-UI-Sender-Class: 01bb95c1-4bf8-414a-932a-4f6e2808ef9c Original-Received: from gandalf.gmx.de ([213.220.156.59]) by mail.gmx.net (mrgmx004 [212.227.17.190]) with ESMTPSA (Nemesis) id 1MrQIv-1nSAv10JxX-00oZqQ; Mon, 06 Jun 2022 18:56:16 +0200 In-Reply-To: <87o7z61v59.fsf@gmail.com> (Tim Cross's message of "Mon, 06 Jun 2022 10:19:38 +1000") X-Provags-ID: V03:K1:dQF6I9FAUFSIKiGPorKXenH0trmJkBWcad/w2T6ZbXw0bd4W7XR UlwE7jk6ZYyLHpyWZwniMxQIvBzNRR17EIEdfn1DaD4Ky2bvEqMnTW1lbNanLnnxUS1WjfZ aERM2ZPS3A6mJ8mRdX6yYGGrKm6zIw3YiwHIY1C2GxlObG2e5su9QRTE+S7CnJY9odn8CWi GLKboCqYWPfVK+jz/OeOA== X-UI-Out-Filterresults: notjunk:1;V03:K0:4JlrSY5By7U=:enPLvuEJ1ZA100f3kE2gz1 WLOVHnaEbaY68XswOkAFZf9TZNsWTZUWxzbA8zAOmh7YGoA8/8pZ0JI0p5ULILVWy/jGwyAb3 DoTtzxsMYIH5En1GZsNPtl+FqSfzU5sVUgrp7KbyHjjdov/AeeJ8geD7NO/Mu6cqXyl0Ge+m8 NpEGnag4ScuIgXgS10FgLP1Pely019cLXwFvYQvrqbDBZB1F4/cS2THj2vUQB21ADMD8ngu2A wRa3MIK9wuHdHXlplGiMEyEJav5Gus4uXHV/2V7NosnFMgyhjAjry+cmLnveskG67qv+M7ZvR d+VyPt/BMSWsW25KhzUNwenOsmhFp4FQ2+zNlKfQqEGJ9LxJ91WHBHDsdPNe7szHHvck59ho5 PH7hmrdg/gPBKLJYTGHJyUi4PCRqoZiq2SGHbHN2jOD/lqp4sVdFldf2l7dxhUfjJRd8L2c0M rhvPAohZzzPxh9GyJqf24xr/Id/vzNetWVYC/AzGEXNUA335mRXnZ3SlFeUYCio4iJGzEW3eK OH2QtuJedDxkXlbNiJEaEBdiidSNfaPzYBUVoDXjTv+6+dPdoFoU79cEdIm5a5ZxlFP2c3lt/ 5wwnB5fHkbqCNSgdyX0RszlTh8UH1VZBwR2L0t//RLo0pas/U4fivZzwL9pn5pfS7nBFDYQ6O NL69rNSGUJKwnQ7fWbAKF5Xib+f9TzEwCoYgBpFDMMRF4X6BBmAhD8HPgyOx6nzMG44+Sp3LM fCe/VU7v7WDFJrV7o27Hkaj1TSvs0GGK9HFm1ZEAGwoxG/ElGWa7R8XR3R193iZdRAq7GHjt Received-SPF: pass client-ip=212.227.15.15; envelope-from=michael.albinus@gmx.de; helo=mout.gmx.net X-Spam_score_int: -25 X-Spam_score: -2.6 X-Spam_bar: -- X-Spam_report: (-2.6 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_LOW=-0.7, RCVD_IN_MSPIKE_H2=-0.001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.io gmane.emacs.devel:290807 Archived-At: Tim Cross writes: Hi Tim, >> I have no problem if there are structured README.org or README.md files >> in parallel. But a README file should be plain text. > > I've seen this mentioned multiple times in this thread and it doesn't > make sense to me. > > Org files *are* plain text. This is one of (perhaps the biggest) selling > points for org mode. They don't use any form of 'binary' data and can be > read just fine in any text editor or just using cat/less/more whatever. > They may look a little *ugly*, especially with respect to URLs, but are > still quite readable - a lot more readable than other plain text formats > such as xml or html or json etc. My point in this discussion is, that package's README files are also visited by people not using Emacs. I'm confident that Emacs is able to present an org-mode structure nicely, but this isn't true outside the Emacs world. Yes, we're speaking about Emacs packages first-hand. But even they are distributed outside the Emacs or GitHub/GitLab infrastructure. So we need a single starting point for users, w/o org-mode dependencies. Best regards, Michael.