From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.devel Subject: Re: Org mode and Emacs Date: Fri, 18 Aug 2023 22:11:45 +0300 Message-ID: <83pm3k2mj2.fsf@gnu.org> References: <87y1u8b1gj.fsf@gmail.com> <8735cgot9x.fsf@gnu.org> <83leq7naql.fsf@gnu.org> <86o7v3ryan.fsf@gmail.com> <87wn9qfyv6.fsf@gnu.org> <87r0zy63u3.fsf@localhost> <87h70ufwr1.fsf@gnu.org> <87o7j48eg9.fsf@localhost> <83ttsw2oeb.fsf@gnu.org> <87lee889ta.fsf@localhost> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="25492"; mail-complaints-to="usenet@ciao.gmane.io" Cc: bzg@gnu.org, yantar92@gmail.com, theophilusx@gmail.com, emacs-devel@gnu.org To: Ihor Radchenko Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Fri Aug 18 21:12:15 2023 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 1qX4tL-0006Sz-1s for ged-emacs-devel@m.gmane-mx.org; Fri, 18 Aug 2023 21:12:15 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qX4sj-0002hD-4m; Fri, 18 Aug 2023 15:11:37 -0400 Original-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 1qX4sh-0002fg-LY for emacs-devel@gnu.org; Fri, 18 Aug 2023 15:11:35 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qX4sg-0006sX-TS; Fri, 18 Aug 2023 15:11:34 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=L+u83JPLiNq81KFvxWc7L/R8vXFAgYPdLuq/TxCfvg4=; b=nUctFi+BPW6Q 3n1f5YdLsicVa/talV3l54tM76JytDyKB4fluBdlBEtM4TpC5Ajg/KOqFfI4SQOUzapapYEg/lz6p Nsz/lM6jBTlO1/ct7TMn3wL6PJAMWsCEjmrlEvlItOgD9/llczYvwMB1xt3RPpIlP/0ScrkUN2Q1E Z7DOgI7XTeolN4KyEH6LecxzyGRFK0hUzCw5fZHc3TVNqq6W+zqGC5d8grRmeNhrBIERwoTC7VuhW R+v3P6KGYOKAVXRer0BvakoedbFV5GL7qSnr8rr10xFtGKJQW4GHO8ai+3j5Zx2tJuWbMJTHEaGC9 KajsKhwNRuQTOpAFxId+vg==; In-Reply-To: <87lee889ta.fsf@localhost> (message from Ihor Radchenko on Fri, 18 Aug 2023 18:49:53 +0000) 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-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Xref: news.gmane.io gmane.emacs.devel:308900 Archived-At: > From: Ihor Radchenko > Cc: bzg@gnu.org, yantar92@gmail.com, theophilusx@gmail.com, emacs-devel@gnu.org > Date: Fri, 18 Aug 2023 18:49:53 +0000 > > I was looking into the idea that we can get more help from Emacs > contributors if we switch the format back from .org to .texi. I'd welcome such a change, FWIW. > Having said that, RMS officially asked Org team to work towards allowing > Org to become the new GNU documentation standard. > https://list.orgmode.org/orgmode/87bkqx4jyg.fsf@localhost/ > So, the above idea was rather theoretical. Unless we disregard RMS > request, Org manual will be a good reference template to explore > real-life caveats of using .org as the true documentation source. I don't know why Richard made that request. From my POV, switching from Texinfo to _any_ significantly different markup has the significant disadvantage that people who routinely improve our manuals will have to learn a new language, and that will likely lower their motivation. For better and for worse, Texinfo is our documentation system. It is a good system, and is actively developed (version 7.1 will be released soon), so abandoning it for something that is less familiar to those who take care of the documentation is a net loss, IMO. We have enough real problems on our hands to afford inventing new ones.