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: Wed, 06 Sep 2023 19:34:37 +0300 Message-ID: <83fs3r1crm.fsf@gnu.org> References: <83msyemjx8.fsf@gnu.org> <871qfpoij6.fsf@gnu.org> <87fs45ivyo.fsf@localhost> <87h6okga15.fsf@localhost> <87cyz61cbp.fsf@localhost> <87v8cuqtkr.fsf@localhost> <87sf7rsfpd.fsf@localhost> <8334zr32ih.fsf@gnu.org> <87edjbsc8k.fsf@localhost> <83r0nb1mb1.fsf@gnu.org> <871qfbsaju.fsf@localhost> <83pm2v1fyw.fsf@gnu.org> <87y1hjqnzq.fsf@localhost> Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214"; logging-data="37563"; mail-complaints-to="usenet@ciao.gmane.io" Cc: rms@gnu.org, emacs-devel@gnu.org To: Ihor Radchenko Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Sep 06 18:36:13 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 1qdvVj-0009On-6B for ged-emacs-devel@m.gmane-mx.org; Wed, 06 Sep 2023 18:36:11 +0200 Original-Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1qdvUq-0006R1-5v; Wed, 06 Sep 2023 12:35:16 -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 1qdvUo-0006Qb-Jb for emacs-devel@gnu.org; Wed, 06 Sep 2023 12:35:14 -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 1qdvUo-0003F9-B9; Wed, 06 Sep 2023 12:35:14 -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=nyAeR9YmNfrGG6cnnub8R+TuVa+m4Wq+c3ySAtG407o=; b=D6jjrQdJ/7WU wt7PRS/Fm56ka8942fiTcQ/LvF9Bc6gaX34zJr2zl815170uwW2gou3r/2apMcxR5zOzCZeorAjpL IX/G34aBb41/FA89bUefUOaZTiKRrtsnr24ZICf0BoJic1bx6Y8PxTqQj3tocu8q1UcfkKP2Ci3Q9 FMi7k5aX4D8RPzToTjqh8ZVZMRHmJnzENBn/E5E8Rrn3B4nON0Sl4CFGVJ5dp7Zo2ICECv8yaqYt4 fdC7MxG5VtPR/l8N+3ZHfNpIwBnfMVG/WQsGGOn7eq8VqKe83Pf78ZEGRDvs+45sRYeZZsB0bb90f WyFDTs0qvpORN3SRY8XU/g==; In-Reply-To: <87y1hjqnzq.fsf@localhost> (message from Ihor Radchenko on Wed, 06 Sep 2023 16:12:57 +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:310211 Archived-At: > From: Ihor Radchenko > Cc: rms@gnu.org, emacs-devel@gnu.org > Date: Wed, 06 Sep 2023 16:12:57 +0000 > > Eli Zaretskii writes: > > >> > Not the output format, but the language: new directives and sometimes > >> > markup are added with every release of Texinfo. Just read their NEWS > >> > file. > >> > >> The way I see Org markup extension would make it easy to users add new > >> custom markup, as needed. Then, no frequent changes to the base markup > >> will be necessary to accommodate for less common use cases. > > > > You missed the "new directives" part. I do recommend reading their > > NEWS to get the idea of the rate at which new features are added to > > Texinfo. > > There is a single word "directives" in > https://git.savannah.gnu.org/cgit/texinfo.git/plain/NEWS: > > . #line directives are recognized. Look for changes whose heading is "Language:". > >> In other words, I do not see why Org should support every single Texinfo > >> markup. We just need to provide enough support to be on par in terms of > >> the needs of manual authors. > > > > GNU Manuals use a large portion of what Texinfo provides, and limiting > > what they could use when they write in Org would mean some Texinfo > > features cannot be used that way, which is a disadvantage. People > > will have to think twice before they switch to Org, because at some > > point they might want to use a feature you decided not to support. > > I understand. However, new features are added to Texinfo for a reason. > If the same reason is valid for Org, equivalent features may be added. The reason why features are added to Texinfo is that those features are useful for writing software documentation. After all, this is the main purpose of Texinfo. So I cannot see how the same reasons could not be valid for Org -- assuming that Org wants to support writing software documentation, not just the Emacs manuals in their current form. > Similarly, we may add features to Org that have no equivalent in > Texinfo. When you add features to Org, no one needs to catch up with them. But when Texinfo adds new features, users of Org who use Org for writing software documentation will expect those features to be supported, since Org will (AFAIU) claim that it can be used for that. > >> Why so? > > > > Because the production rules are much more complex. I suggest to take > > a look at the Perl source code of texi2any to see what it entails. > > AFAIU, the conversion is done in > /usr/share/texinfo/Texinfo/Convert/Info.pm > I do not see anything extraordinary. Org uses similar approach - working > with parse tree. Fine, then I guess you are all set and can simply forget what I said.