emacs-orgmode@gnu.org archives
 help / color / mirror / code / Atom feed
From: Bastien <bzg@altern.org>
To: Sebastien Vauban <wxhgmqzgwmuf@spammotel.com>
Cc: emacs-orgmode@gnu.org
Subject: Re: [patch] Don't output preamble DIV if its contents is empty
Date: Sun, 30 Oct 2011 02:12:59 +0200	[thread overview]
Message-ID: <87aa8jtjzo.fsf@altern.org> (raw)
In-Reply-To: <80r51va96w.fsf@somewhere.org> (Sebastien Vauban's message of "Sat, 29 Oct 2011 21:28:55 +0200")

Hi Sébastien,

"Sebastien Vauban" <wxhgmqzgwmuf@spammotel.com> 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 :)


      reply	other threads:[~2011-10-30  0:12 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2011-09-29 19:58 [patch] Don't output preamble DIV if its contents is empty Sebastien Vauban
2011-10-09 11:24 ` Carsten Dominik
2011-10-09 18:34   ` Sebastien Vauban
2011-10-29 11:31     ` Bastien
2011-10-29 19:28       ` Sebastien Vauban
2011-10-30  0:12         ` Bastien [this message]

Reply instructions:

You may reply publicly to this message via plain-text email
using any one of the following methods:

* Save the following mbox file, import it into your mail client,
  and reply-to-all from there: mbox

  Avoid top-posting and favor interleaved quoting:

  List information: https://www.orgmode.org/

* Reply using the --to, --cc, and --in-reply-to
  switches of git-send-email(1):

  git send-email \
    --in-reply-to=87aa8jtjzo.fsf@altern.org \
    --to=bzg@altern.org \
    --cc=emacs-orgmode@gnu.org \
    --cc=wxhgmqzgwmuf@spammotel.com \


* If your mail client supports setting the In-Reply-To header
  via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line before the message body.
Code repositories for project(s) associated with this public inbox


This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).