From mboxrd@z Thu Jan 1 00:00:00 1970 From: Achim Gratz Subject: Re: [RFC] Moving "manual.org" into core Date: Mon, 22 Jan 2018 20:04:00 +0100 Message-ID: <87607tsokf.fsf@Rainer.invalid> References: <87bmhooaj9.fsf@nicolasgoaziou.fr> <87tvveqi7u.fsf@bzg.fr> <87wp0a57i5.fsf@nicolasgoaziou.fr> <87d121yhwf.fsf@bzg.fr> Mime-Version: 1.0 Content-Type: text/plain Return-path: Received: from eggs.gnu.org ([2001:4830:134:3::10]:52065) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1edhOo-0001e8-SM for emacs-orgmode@gnu.org; Mon, 22 Jan 2018 14:04:55 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1edhOl-0004yz-Q7 for emacs-orgmode@gnu.org; Mon, 22 Jan 2018 14:04:54 -0500 Received: from [195.159.176.226] (port=38986 helo=blaine.gmane.org) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1edhOl-0004yL-KN for emacs-orgmode@gnu.org; Mon, 22 Jan 2018 14:04:51 -0500 Received: from list by blaine.gmane.org with local (Exim 4.84_2) (envelope-from ) id 1edhMJ-0001FH-T4 for emacs-orgmode@gnu.org; Mon, 22 Jan 2018 20:02:19 +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 Bastien Guerry writes: >> Why do we need it? If it is mandatory (I fail to see why, since we >> provide the source of the info file), can we include it read-only? > > It is mandatory, as long as the GNU standard for documentation is to > provide it as a .texi file. It can always be generated for the Emacs export. But it should cease to exist in the Git repo since it becomes a derivative of manual.org. > I don't think providing it read-only is a good idea: people should be > able to edit it and provide patches against it, even though we prefer > to encourage patches against manual.org. No, I'd strongly discourage that and accept such edits only in exceptional cases. If the source file is manual.org, all patches or other changes need to be against the source. You wouldn't accept patches to the PDF of the manual or any such thing, do you? Regards, Achim. -- +<[Q+ Matrix-12 WAVE#46+305 Neuron microQkb Andromeda XTk Blofeld]>+ Samples for the Waldorf Blofeld: http://Synth.Stromeko.net/Downloads.html#BlofeldSamplesExtra