git.vger.kernel.org archive mirror
 help / color / mirror / Atom feed
From: Jakub Narebski <jnareb@gmail.com>
To: Junio C Hamano <gitster@pobox.com>
Cc: Tay Ray Chuan <rctay89@gmail.com>,
	Git Mailing List <git@vger.kernel.org>,
	Johannes Schindelin <Johannes.Schindelin@gmx.de>,
	Mike Hommey <mh@glandium.org>
Subject: Re: [PATCH 00/23] http*: refactor (v6)
Date: Sat, 06 Jun 2009 11:23:17 -0700 (PDT)	[thread overview]
Message-ID: <m3tz2t43xr.fsf@localhost.localdomain> (raw)
In-Reply-To: <7v8wk5dyrw.fsf@alter.siamese.dyndns.org>

Junio C Hamano <gitster@pobox.com> writes:

> Tay Ray Chuan <rctay89@gmail.com> writes:

[...]
> By the way, this is not your fault at all, but for a patch series
> description, "shortlog" is a sucky way, as we can see below.  When you
> talk about "patch #15", the reader cannot find which one you are talking
> about but has to go back to the MUA, so the list is useless for that
> purpose.
> 
> The output of "shortlog" in an e-mail message is wonderful when you are a
> subsystem maintainer who bundles many people's work and are sending out a
> pull request (i.e.  you are transferring the whole graph in "take it or
> reject all" fashion, and you can refer to an individual changeset with its
> commit object name).
> 
> But I think a cover letter to a patch series should serve as an easy index
> from patch number to the title in some way, and "shortlog" is not suitable
> for that eapecially for a multi-author series.

Before git-send-email learned --cover option, I have used the
following commands to generate "Table of contents" for a patch series:
 * generate patches to some subdirectory using '-o' option 
   of git-format-patch
 * grep for subject and remove "Subject:" line:
   $ grep -h "Subject:" mdir/* | sed -e 's/Subject://' >> mdir/0000-cover.txt

This way I had list of patches in the series in actual order...

P.S. Tay Ray Chuan, this patch series is again not being replies to
     cover letter...
-- 
Jakub Narebski
Poland
ShadeHawk on #git

  reply	other threads:[~2009-06-06 18:24 UTC|newest]

Thread overview: 6+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2009-06-06  8:42 [PATCH 00/23] http*: refactor (v6) Tay Ray Chuan
2009-06-06 18:04 ` Junio C Hamano
2009-06-06 18:23   ` Jakub Narebski [this message]
2009-06-07  0:45     ` Tay Ray Chuan
2009-06-07  0:41   ` Tay Ray Chuan
2009-06-10 10:36     ` Tay Ray Chuan

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

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

  git send-email \
    --in-reply-to=m3tz2t43xr.fsf@localhost.localdomain \
    --to=jnareb@gmail.com \
    --cc=Johannes.Schindelin@gmx.de \
    --cc=git@vger.kernel.org \
    --cc=gitster@pobox.com \
    --cc=mh@glandium.org \
    --cc=rctay89@gmail.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.
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 NNTP newsgroup(s).