From mboxrd@z Thu Jan 1 00:00:00 1970 From: Nicolas Goaziou Subject: Re: [RFC] Moving "manual.org" into core Date: Sun, 04 Mar 2018 11:06:48 +0100 Message-ID: <87lgf8f93b.fsf@nicolasgoaziou.fr> References: <87bmhooaj9.fsf@nicolasgoaziou.fr> <87y3j8dw45.fsf@bzg.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:54007) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1esQXh-0007EP-St for emacs-orgmode@gnu.org; Sun, 04 Mar 2018 05:06:58 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1esQXg-0005fJ-Pg for emacs-orgmode@gnu.org; Sun, 04 Mar 2018 05:06:57 -0500 In-Reply-To: <87y3j8dw45.fsf@bzg.fr> (Bastien Guerry's message of "Sun, 04 Mar 2018 10:32:26 +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: Bastien Guerry Cc: Glenn Morris , Achim Gratz , Org Mode List Hello, Bastien Guerry writes: > Is the current contrib/orgmanual.org in sync with doc/org.texi in both > master and maint? Not at all. It is in sync (and a bit above) in master only. > How difficult is it to keep it in sync in both branches? "manual.org" relies on improvements made to the Texinfo exporter in master branch only, and probably to some smaller parts of the export framework. I wouldn't try to sync the manual in maint branch. > Would it be okay to hold on for one week before we make the switch, > just to collect more feedback on this? 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. I spent months on the Org file. If it was a pain to do so ("Let's test org capabilities against a giant .org file."), I think I would have noticed. The difficult part was to define editing conventions and stick to them. This is now done, and unrelated to the problem at hand. I find it much easier to handle and edit than its Texinfo counterpart, even though I have a good command of the Texinfo syntax. This allowed me to do a large number of improvements to it (structure, index, typography, overall consistency...), still not integrated in our official manual. I would be surprised, to say the least, if anyone browsing in parallel "org.texi" and "manual.org" told me in good faith the former is clearer. That being said, we can hold as many number of weeks as you see fit. Regards, -- Nicolas Goaziou 0x80A93738