From mboxrd@z Thu Jan 1 00:00:00 1970 From: Achim Gratz Subject: Re: [RFC] Moving "manual.org" into core Date: Sat, 20 Jan 2018 19:36:30 +0100 Message-ID: <87po64ml75.fsf@Rainer.invalid> References: <87bmhooaj9.fsf@nicolasgoaziou.fr> <87tvvgmnqx.fsf@Rainer.invalid> <874lngo0qk.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:52813) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1ecy0m-00049m-OH for emacs-orgmode@gnu.org; Sat, 20 Jan 2018 13:37:05 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1ecy0j-0006qP-EL for emacs-orgmode@gnu.org; Sat, 20 Jan 2018 13:37:04 -0500 Received: from [195.159.176.226] (port=51624 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1ecy0j-0006q2-79 for emacs-orgmode@gnu.org; Sat, 20 Jan 2018 13:37:01 -0500 Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1ecxyR-0002di-MM for emacs-orgmode@gnu.org; Sat, 20 Jan 2018 19:34:39 +0100 List-Id: "General discussions about Org-mode." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-orgmode-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org Sender: "Emacs-orgmode" To: emacs-orgmode@gnu.org Nicolas Goaziou writes: > Actually, I have another idea. We could implement a function generating > the manual, right in Org core. It can be useful for both packaging, like > the above, and for developers, who can update the manual on the fly. That should go into mk/org-fixup.el then. I am not aware that any packagers have actually picked those helper functions up, so the primary aim should still be that "make doc" keeps things updated. > Assuming the function above is called `org-generate-manuals', and > manual.org is located in doc/, what changes would be needed? I assume > they would be minimal. > >> ORG2HTML=-f org-html-export-to-html > > I think HTML should still be generated from the texi file. I assume > there is some compatibility to preserve among GNU manuals. We could and probably should provide an option for doing it both ways. The intent back when was that sometimes one of the export paths did work while the other didn't, so it was quite useful to have both available. >> ORG2INFO=--eval "(org-texinfo-compile \"./$<\")" > > See above. As I said, all of this is several years old and still working. > What kind of modifications do you have in mind? Nothing, unless we find something missing or wrong. But at least we need to check that it works as intended. Regards, Achim. -- +<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+ SD adaptation for Waldorf rackAttack V1.04R1: http://Synth.Stromeko.net/Downloads.html#WaldorfSDada