From mboxrd@z Thu Jan 1 00:00:00 1970 From: Bastien Subject: Re: [patch] Don't output preamble DIV if its contents is empty Date: Sun, 30 Oct 2011 02:12:59 +0200 Message-ID: <87aa8jtjzo.fsf@altern.org> References: <80lit75df7.fsf@somewhere.org> <80k48ej9ou.fsf@somewhere.org> <87ipn8yqxu.fsf@gnu.org> <80r51va96w.fsf@somewhere.org> Mime-Version: 1.0 Content-Type: text/plain; charset=iso-8859-1 Content-Transfer-Encoding: 8bit Return-path: Received: from eggs.gnu.org ([140.186.70.92]:48693) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RKJ0V-000633-Mk for emacs-orgmode@gnu.org; Sat, 29 Oct 2011 20:12:12 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1RKJ0U-0002g4-An for emacs-orgmode@gnu.org; Sat, 29 Oct 2011 20:12:11 -0400 Received: from mail-wy0-f169.google.com ([74.125.82.169]:34527) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1RKJ0U-0002ft-5V for emacs-orgmode@gnu.org; Sat, 29 Oct 2011 20:12:10 -0400 Received: by wyg34 with SMTP id 34so6003681wyg.0 for ; Sat, 29 Oct 2011 17:12:09 -0700 (PDT) In-Reply-To: <80r51va96w.fsf@somewhere.org> (Sebastien Vauban's message of "Sat, 29 Oct 2011 21:28:55 +0200") 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-bounces+geo-emacs-orgmode=m.gmane.org@gnu.org To: Sebastien Vauban Cc: emacs-orgmode@gnu.org Hi Sébastien, "Sebastien Vauban" writes: > Question: why do we do like that (inserting the ChangeLog contents after the > first line of the commit log)? Is it automatically used somewhere to generate > a proper ChangeLog file? Yes -- see UTILITIES/make_emacs_changelog which collects logs from git commits and format them into proper Emacs ChangeLog. > Why isn't there a real shared ChangeLog file in the repository? There are already two "ChangeLogs", the one that you get from a simple "git log" in Org's repo, and the ChangeLog in Emacs. It's nice to have both: grep'ing through git logs is quick and useful, you get a lot of detailed information here; on the other hand, looking for a function/variable's name in Emacs ChangeLog (or calling M-x occur RET in this ChangeLog buffer) is also a nice way to get information wrt a particular function/variable. I'm fine with a semi-auto-generated ChangeLog that I review and manually fix before merging new releases of Org into Emacs. But I would not be able to maintain a separate ChangeLog for Org only. Of course, this is a matter of personal preference and laziness and future maintainers might want to have an Org ChangeLog between the git log and the Emacs Org ChangeLog. > I want to know, because I want to learn more about all the aspects of this > project in particular, but as well collaborative work in general... Not sure this can be generalized as I'm not familiar enough with other projects. While seeking information about this issue, I stumbled upon this fresh and not-so-unrelated post by ESR¹ and discover this tool: reposurgeon. ¹ http://esr.ibiblio.org/?p=3859 ² http://catb.org/~esr/reposurgeon/ I promise I won't use it but I was curious if anyone tested it on this list :) -- Bastien