From mboxrd@z Thu Jan 1 00:00:00 1970 From: Bastien Guerry Subject: Re: [RFC] Moving "manual.org" into core Date: Sun, 04 Mar 2018 11:54:07 +0100 Message-ID: <87r2p0un5c.fsf@bzg.fr> References: <87bmhooaj9.fsf@nicolasgoaziou.fr> <87y3j8dw45.fsf@bzg.fr> <87lgf8f93b.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:59414) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1esRHT-0002Tl-MI for emacs-orgmode@gnu.org; Sun, 04 Mar 2018 05:54:16 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1esRHQ-0006TG-JT for emacs-orgmode@gnu.org; Sun, 04 Mar 2018 05:54:15 -0500 In-Reply-To: <87lgf8f93b.fsf@nicolasgoaziou.fr> (Nicolas Goaziou's message of "Sun, 04 Mar 2018 11:06:48 +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: Nicolas Goaziou Cc: Glenn Morris , Achim Gratz , Org Mode List Hi Nicolas, Nicolas Goaziou 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. Okay. >> 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. So when we make the move, we publish 9.2 by merging master in maint and edit orgmanual.org from both maint and master. Correct? > 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. For the record: I have no doubt on this and this is also one of the reasons I'm willing to make the switch. > 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. I find orgmanual.org to be clearer. And I think we can make even more aesthetics progress on this. > That being said, we can hold as many number of weeks as you see fit. It is not about setting a time window: we just need to be careful with this move and discuss it. One week seems fine. I know I have been missing in action very often, and asking for more time may not sound reassuring... but I'll push this forward, no worry. Thanks, -- Bastien