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: Org mode and Emacs Date: Sun, 12 Jun 2022 13:04:25 +0800 Message-ID: <874k0qiiau.fsf@yahoo.com> References: <87h74ztshe.fsf@gmx.de> <871qw31ois.fsf@yahoo.com> <8735gj4ceo.fsf@gnu.org> <87ee038ipt.fsf@gmx.de> <87o7z61v59.fsf@gmail.com> <87bkv527p5.fsf@gmail.com> <835yld93w7.fsf@gnu.org> <877d5t0yrn.fsf@gmail.com> <87r140yuof.fsf@gmail.com> <875yl9e7zm.fsf@gmail.com> <87y1y2irhn.fsf@yahoo.com> <87wndmaaow.fsf@localhost> <87ilp6iohe.fsf@yahoo.com> Mime-Version: 1.0 Content-Type: text/plain Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="33714"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.91 (gnu/linux) Cc: Ihor Radchenko , Richard Stallman , Tim Cross , Stefan Monnier , Alan Mackenzie , EMACS development team To: chad Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jun 12 07:05:35 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 1o0Fn5-0008bz-Ex for ged-emacs-devel@m.gmane-mx.org; Sun, 12 Jun 2022 07:05:35 +0200 Original-Received: from localhost ([::1]:41046 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1o0Fn4-0002WK-9a for ged-emacs-devel@m.gmane-mx.org; Sun, 12 Jun 2022 01:05:34 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:55990) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1o0FmA-0001k6-SW for emacs-devel@gnu.org; Sun, 12 Jun 2022 01:04:38 -0400 Original-Received: from sonic312-25.consmr.mail.ne1.yahoo.com ([66.163.191.206]:44860) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1o0Fm7-0008CS-Qi for emacs-devel@gnu.org; Sun, 12 Jun 2022 01:04:37 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1655010273; bh=6QYXBJpRyAJWccVnAtrupTxgNJKbfqb8vzGogOnESkY=; h=From:To:Cc:Subject:References:Date:In-Reply-To:From:Subject:Reply-To; b=Eo6XH8sIgVkKhXyTUygIPa587nRUQRxREsBdz7SSeiMAbk4Faxljoi9lxHdFPDNtF7JTqE+HAuqE7RghaFVPfY/ezWY17hUdQCIaD1suLfcJauWhUBItiClzTwo7cRNP/r5A5WuNfndipMwf5QoX2wDxtmNNvRLBosjTKMlXbeffGufTtv1CIUmRKWf65N4VOOZd9IQYOjvZjBU4tIleRIfAz96I0kJxnT9yLA9Jybyz6s9LsnhGEUY1G2jpJNta2SeV0FEilRj+80ZmV9WMIGgL0Jlemj5jSaOPH7/BklJaRftF9FvmlZ/u5S0V010FFiWpD6zeDsaQD8gnWfUxsA== X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048; t=1655010273; bh=vHeh5xwLNKO/RSTheb1uo2IVtUSmPydpnPUxPLyyW3H=; h=X-Sonic-MF:From:To:Subject:Date:From:Subject; b=Fx3prw98CudSIJIWUEx6riQNOhAnkUsc5HwmRNmIZKY0yOz1ctIO3eHwHu/jNeic+G7jZxs3bzfifDH5dn5E9+XJ0KIKcByoowJov0uhzpI8DPUB5pP2ui7VNyZYYJI8NxfplJWGZP+I0ScQBg7v7ilzWqEHEO70LF23ymXzowPMzLdFCSkSGuiK9rCdUmDywyIRxstJkEtQOZGnGWHuU+fDyWx6vz5uc6EEsFQbzopRRXNgob+rlfDaIum5mZL/oaKqg2WMcFye1EDC8/Wwc17qoCDLwdV3U4EyahBSRH5fQgyxCejOvQlfuRahq9p+/SHrSWz+ECvTPeaifRVwrA== X-YMail-OSG: X9jUJ.kVM1mq0EQ5EWoCq32.cKo2S2FOWLzW9p5F4B69u.LMKzZ7ed.FUBqWZMJ QK6wZ3nqx9FiR.jo_3KuBFcEttY2q5_1qwNTE3.LwFmCMLnzaDrVYPmEq_NpPx.haabNBnyPxB.w XdPnz5d9Z0bfhxKlkdNsmvm7kjEM.QoHIgofvn1WxBfIrxSORYEtIWtivHvx.HSe4qFj3qwU2FDd JqJbX1IEt0KjzEav1dl5Y9kCiErsV78Rip.3.M.vkPmM2jgNfpDei6yMecQI3McAeLsFB_gR0ytb qz5ih3LR2.UA9EfhuIzJZo.53S5ZjQYo0ixOFEnXb0UISe2hWdJR36Tb2a4_cFMNKYB.ssn5AgHC JT1T16zqREV4VLUVuHNDgZHrrJxDATl6Mp0UVkVALavkUAAd5uXfdYymzOYJvypZfHTX0y4Trdjc A3yT6VClB7PQxyl9qYZIP_NaDH7iFb7dcns7BnvOOEmk..VodaZRvevDtW89J2KYCioBfXqVjrGl _JxbS9qzXfYmppGjg0w8t8s6.zgaW7tk2DJ.vd7C.xWZ7QOMGNwTeCvzv2qkhiC2MVCMcF_qn33O 6oC5yEoCOg1nwMf4t19lUlzyn8YGhppUSmWGDKo3O8LuP_tc.Hbb0eMc50ZS3XVeyV6Jd4EhHQ48 L13aDaq0pTrAF74u5ED3F9MpcZUqj3KikjVDUeSprFdtoxz9yr2g6eL_2vVef5O9h0EyC5ueCYVZ diExCdapGTj_KCnTq4LGm.v0O0mhfgUOMiLGUgQ5szgRdz7YD4sq3YU53NB4Klo6Yl2pmhYFVxIw CyuU.hOspVO78m7v4ZHtQIjnoqfM4cXGPbpYZo9a_x X-Sonic-MF: Original-Received: from sonic.gate.mail.ne1.yahoo.com by sonic312.consmr.mail.ne1.yahoo.com with HTTP; Sun, 12 Jun 2022 05:04:33 +0000 Original-Received: by hermes--canary-production-sg3-5f7658c994-6jtvl (Yahoo Inc. Hermes SMTP Server) with ESMTPA ID 0c09cc46ef8bf9b96300eb646841ba54; Sun, 12 Jun 2022 05:04:31 +0000 (UTC) In-Reply-To: (chad's message of "Sat, 11 Jun 2022 23:54:39 -0400") X-Mailer: WebService/1.1.20280 mail.backend.jedi.jws.acl:role.jedi.acl.token.atz.jws.hermes.yahoo Received-SPF: pass client-ip=66.163.191.206; envelope-from=luangruo@yahoo.com; helo=sonic312-25.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=unavailable 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:291063 Archived-At: chad writes: > I think a reasonable examination of the emacs-devel archives as well > as the common practices of most of the people publishing emacs lisp > packages today would lead to a very different conclusion. There are > several threads about maintenance concerns around makeinfo/texinfo, > and many discussions about replacing texinfo with, for example, > HTML. Published Emacs Lisp packages in the wild typically come with no documentation at all, aside from doc strings and a single README file. Org mode happens to be popular for the latter, but I don't know why. The learning curve is high and the results seem to be unjustified. An easier format such as HTML or Markdown can be used instead. > There are periodic threads where people claim that they won't try to > add their project to GNU because the burden of learning and using > texinfo is too high, although those have died down in volume since it > became more practical to translate other formats to texinfo. Why would Org mode be any different? Unlike HTML, it is completely specific to Emacs, which actually makes it worse than Texinfo, because Texinfo is at least widely used throughout the entire GNU project. And anyway, I make the following offer: if someone doesn't want to contribute documentation (or code) because he doesn't know Texinfo, he can write the documentation in plain text, and I will translate it to Texinfo for him. IIRC the GDB developers made a similar offer, and for the many years that it existed nobody ever took advantage of it, which shows that Texinfo is not a serious barrier to contributors. Further more, using Org mode for documentation will make Emacs lose many people who are actually writing documentation, right now. At least I have no interest in ever learning Org mode, and there seem to be no volunteers who will translate Texinfo (or plain text) to Org mode for me if we begin to use it for documentation in the future.