From mboxrd@z Thu Jan 1 00:00:00 1970 From: Bastien Guerry Subject: Re: [RFC] Moving "manual.org" into core Date: Sat, 03 Mar 2018 11:18:34 +0100 Message-ID: <87zi3pcvid.fsf@bzg.fr> References: <87bmhooaj9.fsf@nicolasgoaziou.fr> <87tvveqi7u.fsf@bzg.fr> <87wp0a57i5.fsf@nicolasgoaziou.fr> <87d121yhwf.fsf@bzg.fr> <874llxikm4.fsf@nicolasgoaziou.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:44023) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1es4FY-0002rX-2k for emacs-orgmode@gnu.org; Sat, 03 Mar 2018 05:18:44 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1es4FU-0005if-Nc for emacs-orgmode@gnu.org; Sat, 03 Mar 2018 05:18:44 -0500 In-Reply-To: <874llxikm4.fsf@nicolasgoaziou.fr> (Nicolas Goaziou's message of "Sat, 03 Mar 2018 10:17:23 +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: Achim Gratz , Org Mode List Hi Nicolas, Nicolas Goaziou writes: > I'm bumping the thread. What is still needed for that to move > forward? Nothing, please move ahead. I suggest to rename the file org.org, which will produce org.texi. Or org-manual.org, which seems more readable. It would be great to have org-guide.org too, but I guess that's a lot of work. > Again, the first step could be to move manual.org to core and have > it generate a new org.texi, overwriting the previous one. Yes, let's do that manually for now. > I would also be nice to think about what can be done to automatically > generate org.texi upon releases, and remove it from the repository. But > that can come later. Indeed. Sorry it took me long to give the green light on this, I was trying to anticipate all possible outcomes. One of my worries was that moving toward editing a manual in .org does not match GNU developers good practices and habits, which are to edit .texi files. But as long as the .texi file exists I guess we can shake the habits by allowing to edit .org files, which are more convenient to read and write. Hopefully this step forward will help create a useful precedent amont GNU developers. Thanks to you and to anyone who has been involved in making this possible! -- Bastien