From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: Eli Zaretskii <eliz@gnu.org>
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> <E1qa4df-0001Eb-GD@fencepost.gnu.org>
 <87h6okga15.fsf@localhost> <E1qaR7D-0004xD-Lu@fencepost.gnu.org>
 <87cyz61cbp.fsf@localhost> <E1qbsnq-0007QF-5f@fencepost.gnu.org>
 <87v8cuqtkr.fsf@localhost> <E1qcySQ-0005mz-5b@fencepost.gnu.org>
 <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 <yantar92@posteo.net>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Wed Sep 06 18:36:13 2023
Return-path: <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
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 <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	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 <emacs-devel-bounces@gnu.org>)
	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 <eliz@gnu.org>) 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 <eliz@gnu.org>)
 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." <emacs-devel.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/emacs-devel>
List-Post: <mailto:emacs-devel@gnu.org>
List-Help: <mailto:emacs-devel-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-devel>,
 <mailto:emacs-devel-request@gnu.org?subject=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: <http://permalink.gmane.org/gmane.emacs.devel/310211>

> From: Ihor Radchenko <yantar92@posteo.net>
> Cc: rms@gnu.org, emacs-devel@gnu.org
> Date: Wed, 06 Sep 2023 16:12:57 +0000
> 
> Eli Zaretskii <eliz@gnu.org> 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.