From mboxrd@z Thu Jan  1 00:00:00 1970
From: phillip.lord@russet.org.uk (Phillip Lord)
Subject: Re: [RFC] Moving "manual.org" into core
Date: Mon, 05 Mar 2018 16:22:45 +0000
Message-ID: <87fu5eebl6.fsf@russet.org.uk>
References: <87bmhooaj9.fsf@nicolasgoaziou.fr> <87y3j8dw45.fsf@bzg.fr>
	<87lgf8f93b.fsf@nicolasgoaziou.fr> <87lgf89lro.fsf@gnu.org>
	<WM!6f8274ba0065f984ff76586f7cf117703ccda15adbb5042672b0d2695ee5ac6b367ee58f70aacbbc9c2b10eecb9672ea!@mailhub-mx3.ncl.ac.uk>
Mime-Version: 1.0
Content-Type: text/plain
Return-path: <emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
Received: from eggs.gnu.org ([2001:4830:134:3::10]:54751)
	by lists.gnu.org with esmtp (Exim 4.71)
	(envelope-from <phillip.lord@russet.org.uk>) id 1esstj-000359-3N
	for emacs-orgmode@gnu.org; Mon, 05 Mar 2018 11:23:35 -0500
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
	(envelope-from <phillip.lord@russet.org.uk>) id 1essti-0004IO-6K
	for emacs-orgmode@gnu.org; Mon, 05 Mar 2018 11:23:35 -0500
In-Reply-To: <WM!6f8274ba0065f984ff76586f7cf117703ccda15adbb5042672b0d2695ee5ac6b367ee58f70aacbbc9c2b10eecb9672ea!@mailhub-mx3.ncl.ac.uk>
	(Bastien's message of "Sun, 4 Mar 2018 11:29:31 +0100")
List-Id: "General discussions about Org-mode." <emacs-orgmode.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=unsubscribe>
List-Archive: <http://lists.gnu.org/archive/html/emacs-orgmode/>
List-Post: <mailto:emacs-orgmode@gnu.org>
List-Help: <mailto:emacs-orgmode-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/emacs-orgmode>,
	<mailto:emacs-orgmode-request@gnu.org?subject=subscribe>
Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org
Sender: "Emacs-orgmode"
	<emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org>
To: Bastien <bzg@gnu.org>
Cc: Glenn Morris <rgm@gnu.org>, Achim Gratz <Stromeko@nexgo.de>, Org Mode List <emacs-orgmode@gnu.org>, Nicolas Goaziou <mail@nicolasgoaziou.fr>

Bastien <bzg@gnu.org> writes:

>> For the record, and as a first feedback, I totally disagree with the
>> FUD (".org flexibility will bring us new problems", seriously)
>> spread about the Org manual.
>
> Testing the .texi exporter (and maybe .html and .pdf) against this big
> file will be interesting.
>
> Testing the process of running "make pdf" while emacs will in charge
> of producing a PDF file (.org => .texi => .pdf) will be interesting,
> and potentially more error-prone than the current .texi=>.pdf process.
>
> But again, that's fine.

I think it will slow the build. Currently, the texi gets compiled in
parallel with the C, while having Emacs build it will shunt it till the
very end (after byte-compilation) where there is nothing to parallelize
(except for the tests).

Of course, if it's only org.org (or whatever) and everything else is
texi, then most of the manual would build earlier. If everything were
org, I think it would add about a minute to a 5 or 6 minute
build. Probably, by the time all of the manuals are in org-mode,
machines will be significantly faster, there will be emacs-free org mode
converter, or we will have hit the heat death of the universe. Perhaps
it's not a problem.

Phil