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 :)
--
Bastien
prev parent 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:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
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 \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* 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
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
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).