From mboxrd@z Thu Jan  1 00:00:00 1970
Path: news.gmane.io!.POSTED.blaine.gmane.org!not-for-mail
From: Po Lu <luangruo@yahoo.com>
Newsgroups: gmane.emacs.devel
Subject: Re: Org mode and Emacs
Date: Sun, 12 Jun 2022 10:50:53 +0800
Message-ID: <87ilp6iohe.fsf@yahoo.com>
References: <YpuV9DKe9kzNt5np@ACM> <87h74ztshe.fsf@gmx.de>
 <871qw31ois.fsf@yahoo.com> <8735gj4ceo.fsf@gnu.org>
 <87ee038ipt.fsf@gmx.de> <87o7z61v59.fsf@gmail.com>
 <Yp3l+rjJ0mAIcVZJ@ACM> <87bkv527p5.fsf@gmail.com>
 <835yld93w7.fsf@gnu.org> <877d5t0yrn.fsf@gmail.com>
 <Yp92eI2pEuc/gQu4@ACM> <jwvtu8wbbjb.fsf-monnier+emacs@gnu.org>
 <87r140yuof.fsf@gmail.com> <E1nzQh5-0001OB-22@fencepost.gnu.org>
 <875yl9e7zm.fsf@gmail.com> <E1o0BgR-0008J7-Ts@fencepost.gnu.org>
 <87y1y2irhn.fsf@yahoo.com> <87wndmaaow.fsf@localhost>
Mime-Version: 1.0
Content-Type: text/plain
Injection-Info: ciao.gmane.io; posting-host="blaine.gmane.org:116.202.254.214";
	logging-data="39504"; mail-complaints-to="usenet@ciao.gmane.io"
User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.91 (gnu/linux)
Cc: Richard Stallman <rms@gnu.org>,  Tim Cross <theophilusx@gmail.com>,
 monnier@iro.umontreal.ca,  acm@muc.de,  emacs-devel@gnu.org
To: Ihor Radchenko <yantar92@gmail.com>
Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org Sun Jun 12 04:52:24 2022
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 1o0DiB-000A4U-U0
	for ged-emacs-devel@m.gmane-mx.org; Sun, 12 Jun 2022 04:52:24 +0200
Original-Received: from localhost ([::1]:60456 helo=lists1p.gnu.org)
	by lists.gnu.org with esmtp (Exim 4.90_1)
	(envelope-from <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>)
	id 1o0DiA-00068Z-0x
	for ged-emacs-devel@m.gmane-mx.org; Sat, 11 Jun 2022 22:52:22 -0400
Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:40276)
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <luangruo@yahoo.com>)
 id 1o0Dgz-0005Oh-9o
 for emacs-devel@gnu.org; Sat, 11 Jun 2022 22:51:09 -0400
Original-Received: from sonic316-21.consmr.mail.ne1.yahoo.com ([66.163.187.147]:37011)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <luangruo@yahoo.com>)
 id 1o0Dgv-0006DG-RP
 for emacs-devel@gnu.org; Sat, 11 Jun 2022 22:51:08 -0400
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048;
 t=1655002262; bh=IK6/vldqCWckUvFVV0xJ5GZR9AmUdWkiO1nrYAfGrhk=;
 h=From:To:Cc:Subject:References:Date:In-Reply-To:From:Subject:Reply-To;
 b=io6pd8U5v86YqigmgNa2QEyQ5dsG8n0lRvAgPCla8AHoqbSOa3+ERaRnNK050owk5DmUSCLmID5M5JrS0OITTzSbndjQhs1ZrjZbd4NY6g3gS2dLlFMAfOFnIxFiDFVEgK4UXRhnCCjEL2oupjW1u1V/BA9/MQzkp//1Z4O/2M+7ZokUGjgjx5KZHyWfJqstitFV4VSKooomFLTbGst1QV5e9e+yqihIZS76WahH8K0EFYIJQDdkq+jrZX/kpikgNi8HD7b27wC1pgHM7ZeCs//iJM+LaXThk34pRzbAttNj3uWtWpUcZJ5qe19tCawOX+JFrO+yCX+Anqt2Jve2jQ==
X-SONIC-DKIM-SIGN: v=1; a=rsa-sha256; c=relaxed/relaxed; d=yahoo.com; s=s2048;
 t=1655002262; bh=5NJMoAc/uyDf5pf21ch7KiDs5Z1wUaEK1iTaCQ0IT/x=;
 h=X-Sonic-MF:From:To:Subject:Date:From:Subject;
 b=S2suXWuuu9rzXUExIzNOgwLAzv2plJGbqSx4kLPGnqpHZETYo/ht5s8JTcqeTeOc2SMUqwedi+qUjKlWQd0qOhGDZbZya72Eqkm9opuKgHddgVKfD0N2f1wp5ZmYXXcuC45gvNBScFtPCmGWR+JMPC1eFsfz1VmczY+4rWeXNS1PxM6Ifo79BQV3EjcwFVKc2nZSxP3KMywzY4VMBEZP+hqU2i7XWIaZqEdRB7SN6+UOpfMFbnAaIgKGKhOBjB0ZXPxOjG5nS4pidK2ee89JAk3or2Qa/sYWvNCkK/jpXHv8zo8JxIFdzrzejM++nVjjTgfQ317j+yoFg0HrLBw1VQ==
X-YMail-OSG: ArpfpPoVM1knmq5rKqrfub5xu_3VNXT_QEX0PeeXnLFuaz_kuLNmOwr9_OLNc3r
 C2oo2YsDZInjPPH6vvY_nWa4QLnzGMb2knucT6rETBuKoW34TmNXDe4mHhBqLAqY63V7nBOTmqVV
 lQqq1JdmadJk1uvemqVAoe0YK39mISYeqHyhrpcRC8ViXJ5RypK7iyLQ5sLi1pR_kmbDg2PCSERD
 6Cqw5_FUzS3JyNQEUpLwLk.jn81nQgHk1Nr3TepQhau.xnTk40OkhPyoXBPuLUZfhmzTAuDXGBpN
 Z7slqyTQzHJvm0n7vTFRWmnEKXdqmf.qVhQTUhhD0qeDdY.v.gCgqvqoGXyG4_m1rUnv3zEI3CcS
 Q4RZFgCPQEPmbuEztD3MxDbd52Sa9_I_5RDZx38lXSqWuFvrnpVM8uCPlTUmD9wiuEhgkKk8OVef
 Y2DFW9dUnE1l3Av6GV9YWcehfCBt5jGbuaZiFwa.4wGJGIhUVoM52uL99WFrhGaPTFLvBs5CjFEa
 xyRMaQcEB8eVd_0EvM.L20K4la8z5CtWJtvdpD22An4q5mInGu7FUhRNq_RBPXP9Vcbcq5TX_Uv.
 hyYDI7fNj6Os9PviWuoE4fMuxAbP4j0Xw5Y7RPQuO8MeEnXaU.Dw0Kkimy0LkjuiHElk2xXgjqxh
 IQeK80Vf3vbyPhfnu_nhShR_21K3AXxQRVcc8_qz0q2U6rNwmrV8Xh1xY_glPlpHz2UUQV2wcUz.
 Cjq_1v7FJYHveYALQqljC7aydCVklov1E1b73Duu87I3q..hACaAdhD55_vcs0KZvU1vXlsVEg8G
 70PnBowc7PAKFDKlTAWdM97PDETD0Y1TnvRuepWrGB 
X-Sonic-MF: <luangruo@yahoo.com>
Original-Received: from sonic.gate.mail.ne1.yahoo.com by
 sonic316.consmr.mail.ne1.yahoo.com with HTTP; Sun, 12 Jun 2022 02:51:02 +0000
Original-Received: by hermes--canary-production-sg3-5f7658c994-qwjwx (Yahoo Inc. Hermes
 SMTP Server) with ESMTPA ID 99fed5606963c939141d8175eeccd97a; 
 Sun, 12 Jun 2022 02:50:59 +0000 (UTC)
In-Reply-To: <87wndmaaow.fsf@localhost> (Ihor Radchenko's message of "Sun, 12
 Jun 2022 10:15:59 +0800")
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.187.147; envelope-from=luangruo@yahoo.com;
 helo=sonic316-21.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=ham 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." <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"
 <emacs-devel-bounces+ged-emacs-devel=m.gmane-mx.org@gnu.org>
Xref: news.gmane.io gmane.emacs.devel:291056
Archived-At: <http://permalink.gmane.org/gmane.emacs.devel/291056>

Ihor Radchenko <yantar92@gmail.com> writes:

> Could you please quantify much slower?

Making the Org manual takes about 27 seconds on my system:

  GEN      org.texi
  GEN      ../../info/org.info

real	0m27.210s
user	0m25.567s
sys	0m0.783s

Which is longer than it takes for the entire (much more massive) Emacs
Lisp reference manual:

  GEN      ../../info/elisp.info

real	0m24.561s
user	0m23.660s
sys	0m0.515s

And generating the .info file from the Org manual texinfo source takes
only:

  GEN      ../../info/org.info

real	0m5.381s
user	0m5.109s
sys	0m0.141s

So it's clear that the org to texinfo export takes most of the time.

> I believe that if we want to be serious about using Org for
> documentation more widely, we should first identify which particular
> aspects of Org are beneficial for documentation and which particular
> aspects are available in other documentation generators and must be then
> provided by Org (if not yet available).

I don't see why we should be serious about using Org for our
documentation, when most people already know texinfo and are quite happy
with it.

> This is not true. Org mode supports #+include: directives to incorporate
> multiple smaller files into one larger file.

That's nice, but why isn't the Org manual itself structured that way?

> You can edit Org files outside Emacs. Say, in vim.

But does it work very well?

> This last point also raises a question. Can Elisp interpreter and
> libraries be factored out of Emacs to create a way to execute Elisp
> programs without installing all the interactive parts of Emacs?

Probably not without a lot of work.