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 (was: Convert README.org to plain text README while installing package) Date: Sat, 11 Jun 2022 09:58:59 +0300 Message-ID: <83bkuzznws.fsf@gnu.org> 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> <83czfh12kp.fsf@gnu.org> <87pmjhghu2.fsf@localhost> <835yl910gp.fsf@gnu.org> <87wndndbhq.fsf@gmail.com> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="26950"; mail-complaints-to="usenet@ciao.gmane.io" Cc: yantar92@gmail.com, rms@gnu.org, monnier@iro.umontreal.ca, acm@muc.de, emacs-devel@gnu.org To: Tim Cross Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sat Jun 11 09:02:28 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 1nzv8d-0006ol-Vb for ged-emacs-devel@m.gmane-mx.org; Sat, 11 Jun 2022 09:02:28 +0200 Original-Received: from localhost ([::1]:60044 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1nzv8c-0002yP-EY for ged-emacs-devel@m.gmane-mx.org; Sat, 11 Jun 2022 03:02:26 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:48958) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nzv5Q-00026r-Is for emacs-devel@gnu.org; Sat, 11 Jun 2022 02:59:08 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:50478) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nzv5P-0001hO-VR; Sat, 11 Jun 2022 02:59:08 -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=eOnhOm2fcNImQQ/HtoB5WVRNsZ9cP1JeqtpZp7BeeZE=; b=irP26XeGvv5d DP1V/K/L3NzlfZWjBaWOwEVn6hvB5cdfS323Jdoffjn06fztwMDf6Ek2ZwJcOUXgzGqr3w3wDTYYp WEc4UDtQerUxUhleGdGAiYEuP56no17gJ31AOMbLXLRA57I2zRanKAdF/te3brp9pjxvIQ43HABRm sv3Y1xcEPeuH9wlwVbEJMFBseEr/24nKFBjyVUW/qBOy+VER2nHaBwquuQu5vmnqcx8b/eBfMaM7a kKjAin1cf7/igYg0keifUNMGCqFgqOZF48L5Ogl/RybqSIFJ4ZzzSpv4zKpVBtlzIzKSisVsJ/Yyl nASweQvNYufODFbWWtdBNw==; Original-Received: from [87.69.77.57] (port=4475 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1nzv5L-0001UF-2W; Sat, 11 Jun 2022 02:59:03 -0400 In-Reply-To: <87wndndbhq.fsf@gmail.com> (message from Tim Cross on Sat, 11 Jun 2022 14:49:21 +1000) 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:291021 Archived-At: > From: Tim Cross > Cc: Ihor Radchenko , rms@gnu.org, > monnier@iro.umontreal.ca, acm@muc.de, emacs-devel@gnu.org > Date: Sat, 11 Jun 2022 14:49:21 +1000 > > >> >> I"m also not convinced that org mode would be the right solution for > >> >> Emacs documentation. > >> > > >> > Then why Org's own manual is written in Org instead of Texinfo? > >> > >> I do not know if Org mode would be a good solution for Emacs > >> documentation. However, compared to texinfo, our manual is lacking index > >> entries in all the exported versions but texinfo. > > > > Lack of an index makes for a less useful manual, IME. > > > > Anyway, is the lack of the index the _only_ missing feature from what > > the Org markup provides as compared to Texinfo? Tim's message sounded > > like there are many more omissions. > > My statement is simply waht it says. I am not convinced org mode would > be the right solution for Emacs documentation. This is for many reasons, > some relating to org, some relating to the fact I'm not convinced there > is a need to replace texinfo, especially given that in some areas, I > think texinfo is more feature rich and consistent and some relating to the feeling I have > that the result is hard to justify given the amount of work it would > require. Well, it is hard to say anything intelligent without knowing those "many reasons". And if your POV is shared by the Org developers, then I ask again: why is the Org manual, which weighs in at 23,000 lines, is being written in Org?