From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Po Lu Newsgroups: gmane.emacs.devel Subject: Re: Convert README.org to plain text README while installing package Date: Sun, 05 Jun 2022 16:51:39 +0800 Message-ID: <871qw31ois.fsf@yahoo.com> References: <87leuca7v7.fsf@disroot.org> <87czfopmsd.fsf@gnu.org> <87h74ztshe.fsf@gmx.de> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="40352"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.91 (gnu/linux) Cc: Alan Mackenzie , Stefan Kangas , Tassilo Horn , Akib Azmain Turja , Emacs developers To: Michael Albinus Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jun 05 10:54:41 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 1nxm1w-000AJF-Sl for ged-emacs-devel@m.gmane-mx.org; Sun, 05 Jun 2022 10:54:40 +0200 Original-Received: from localhost ([::1]:48936 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nxm1v-0006ex-DN for ged-emacs-devel@m.gmane-mx.org; Sun, 05 Jun 2022 04:54:39 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:48538) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nxlzP-0004Zt-MW for emacs-devel@gnu.org; Sun, 05 Jun 2022 04:52:06 -0400 Original-Received: from sonic312-23.consmr.mail.ne1.yahoo.com ([66.163.191.204]:35694) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1nxlzK-0003Uy-Gb for emacs-devel@gnu.org; Sun, 05 Jun 2022 04:52:03 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1654419109; bh=MOz/r+pS7Pf1HCAMsCtd37oaa3S0PskfQrjRctECGRo=; h=From:To:Cc:Subject:In-Reply-To:References:Date:From:Subject:Reply-To; b=ZohJsVyXgOP67xxy9hbH8AB+1MIvQmCnQPDt3Xa+jMFrQsGK8H+zrcx0WLHSE8QVMHHYqlmQNkP+74A3K8juLG+wSfYw+0iYEqu2ij4pIpl+wZ4utclPcCKbMj38bIAkb8tb1Md1FeM6fBXMs31i0uTgHmOZm6er7fvceuQIf4S8dOXzJsssmSbJh1UqPOVtMrktgEmdJa0dwhEQM81/QKsZkgUt9QWHaeM+rKkdelBi0N3RhPDBqUl7g+f6Iu21KD03cEiQRzFplZj1PbyFmkGnWpt2eN/RmOoKiTUgx1QeS6D2QJGfMmC6A+z2N7qBRjwGSENGM2NKh7Ew84PzMg== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1654419109; bh=47VbwQEnjODohE0uKioaDboRO4nK6+1z6PYrs2zLiZ8=; h=X-Sonic-MF:From:To:Subject:Date:From:Subject; b=BTIJTKEVwkq6XGbCaqi1PWBGdJoGM/A4nNaprriiv4dIcGaOcIomj0BxqjxN0yyqpMIjhTMTUm8E5qJu1//TN6g17DewOLc8MPfzBM8WheSU6Su72Nd3Mc9zlxiT5HFzHZMrVVn1GDT4UxrP8YZKZ5PuIY48c0D2MiJHowxvGlVqXss3MaHwihhpie5XjUi1uS2dGA+hQjkdg5P2nDXg6r+KMXFcQDV3wI7CwcqBsnyLZFL7xkpkM6kJ/EQeVmDP2k2/hbXZkV3EzuiqqZ3G8/45Lrx1ezSieGNPgOGI7Izo+N4JuD1z61x1MGy14hDcOziSIgC0yFPB8rOHmSOa2g== X-YMail-OSG: ktMAbXIVM1n_tEDv_hCYzFLb437wE2yh.QdTu79Y1OavzthKMYIkQKMwElBkQlU 6eiaNiDbm_cgztPv55nVBhMHXK2SOnVwZkYuTWB4n..XSAkdtngiMfSYTnCi2.9bzsqcUOAKHfCH iBgUnpDcAtuuRPqARfAa9i3K33Fsng_i6ekenRvXDOg6aeKUk80qo1mIRkEShjUcis3oABeVlbNc RVIIlQi4ZimsigOXy6pAiwATihqfJ_Z5X1ia6Jd5zb_C4IORTTKjg1U0GRnxk370Fx9pXiTpwRhb J.YFDG937fOnAm89ka.QIzrYVINortXLM2J0NjmHsy6S8boqwZIUUD9UOvhTSm4d9sUfBWRoYqg0 KVGvxjcCiBobbXGcu8NnyXquzUm6uvZIhoLR3znc48f5tN7kN8FxjJHXPaNW7xQFzA5NulmChHuC q4vGfKSRdRqe_FE1_2K.SKgYX_Gv9IpxM0KfGXihtBsUcTjQ1oSQWCfVBi02hQbG45s5H2pwt3UU 4RwAYAiCOtVMDbNVDHrxZPr8i3wY2tSaf78mcIFB8Pizx7dGlAaqZG4jqHoBq.t3fRL6t3Qe.q19 OpbF.f53Du6KlWDlj8e1zcN_SctzSvvVPbGmRbovP7b6dUlvl46Ha6HS9lD2DaLRQD1vN34OGp2G SEWLId64cT_8YlDxPVmsBOlyC444vxdRne5j0aUH92rZQE5G50iuGX.hByPrWhA0FCYynXjhzdhK rLywCZBmkPz1N4QgGXs6BROwFOMOV9s4fok4epaITiYpny4tozmmo2k0.WiEe6dzT75zUnk0PqJj T0z8PSR8gq6uqfCC_mKG9NSkGFyTZ0R59DmaKh2qrp X-Sonic-MF: Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic312.consmr.mail.ne1.yahoo.com with HTTP; Sun, 5 Jun 2022 08:51:49 +0000 Original-Received: by hermes--canary-production-sg3-5f7658c994-bv4wk (Yahoo Inc. Hermes SMTP Server) with ESMTPA ID c520d5737f3a52360b78339386a7161b; Sun, 05 Jun 2022 08:51:44 +0000 (UTC) In-Reply-To: <87h74ztshe.fsf@gmx.de> (Michael Albinus's message of "Sun, 05 Jun 2022 10:38:37 +0200") X-Mailer: WebService/1.1.20225 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo Received-SPF: pass client-ip=66.163.191.204; envelope-from=luangruo@yahoo.com; helo=sonic312-23.consmr.mail.ne1.yahoo.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.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, FREEMAIL_FROM=0.001, RCVD_IN_DNSWL_NONE=-0.0001, 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:290681 Archived-At: Michael Albinus writes: > Alan Mackenzie writes: > >> Hello, Stefan. > > Hi, > >>> I think we should actively encourage using it for most types of >>> documentation, certainly for README type files. >> >> I disagree entirely with you. Org mode is highly complicated, obscure >> (I've never managed to get a feel for what it does), and difficult to >> learn (I've never managed it). A text file is far easier to read for >> those not familiar with org. We're talking about READMEs here. They're >> typically 20 to 100 lines long. A text file is ideal for these. > > 1+. README is a text file which is consulted in order to get information > about the related software. There's no rule to visit it by Emacs only. > > Best regards, Michael. Hear, hear! It also takes a relatively long time to load Org mode, so opening a README.org-type file for the first time will always cause an annoying pause.