git@vger.kernel.org mailing list mirror (one of many)
 help / color / mirror / code / Atom feed
From: Eric Sunshine <sunshine@sunshineco.com>
To: "Lê Duy Quang" <leduyquang753@gmail.com>
Cc: git@vger.kernel.org
Subject: Re: [RFC PATCH 0/1] Add lines to `git log --graph` to separate connected regions
Date: Sun, 7 Apr 2024 01:30:48 -0400	[thread overview]
Message-ID: <CAPig+cQVQrrXrDqys-TyCqFynR6=pmbxs-NK-ca-s0K8mjADaA@mail.gmail.com> (raw)
In-Reply-To: <20240407051031.6018-1-leduyquang753@gmail.com>

On Sun, Apr 7, 2024 at 1:10 AM Lê Duy Quang <leduyquang753@gmail.com> wrote:
> `git log --graph`, when invoked with multiple starting revisions and some
> exclusions which cut the commit graph, may give a disconnected graph. In other
> words, the resulting graph has more than one separate connected regions. The
> command currently prints the connected regions on top of each other without any
> separation.
>
> This leads to a problem. Say there are two connected regions, each having two
> commits, the graph would look like this:
>
> * a2
> * a1
> * b2
> * b1
>
> which may lead to a misunderstanding that these four commits belong to the same
> timeline, i.e. b2 is a parent of a1.
>
> This patchset adds a separator line between each pair of connected regions to
> clarify that they are not actually connected:
>
> * a2
> * a1
> ---
> * b2
> * b1

This sort of information which explains why the patch may be desirable
is not only helpful to reviewers of the submission, but will be
helpful to future readers of the patch once it becomes part of the
project's permanent history (assuming it is accepted). However, the
cover letter does not become part of the project's history (it exists
only in the mailing list). As such, please move this discussion into
the commit message of the patch itself.


  parent reply	other threads:[~2024-04-07  5:31 UTC|newest]

Thread overview: 15+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2024-04-07  5:10 [RFC PATCH 0/1] Add lines to `git log --graph` to separate connected regions Lê Duy Quang
2024-04-07  5:10 ` [RFC PATCH 1/1] Add separator lines into `git log --graph` Lê Duy Quang
2024-04-07  5:47   ` Eric Sunshine
2024-04-07  5:52     ` Eric Sunshine
2024-04-07  7:06       ` Quang Lê Duy
2024-04-07  8:35         ` Dragan Simic
2024-04-07  7:03     ` Quang Lê Duy
2024-04-07  9:07       ` Eric Sunshine
2024-04-07  5:30 ` Eric Sunshine [this message]
2024-04-07  5:37   ` [RFC PATCH 0/1] Add lines to `git log --graph` to separate connected regions Junio C Hamano
2024-04-07  6:40     ` Quang Lê Duy
2024-04-07  8:34       ` Dragan Simic
2024-04-07  8:46         ` Quang Lê Duy
2024-04-07  9:13           ` Dragan Simic
2024-04-08 15:49     ` Junio C Hamano

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: http://vger.kernel.org/majordomo-info.html

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

  git send-email \
    --in-reply-to='CAPig+cQVQrrXrDqys-TyCqFynR6=pmbxs-NK-ca-s0K8mjADaA@mail.gmail.com' \
    --to=sunshine@sunshineco.com \
    --cc=git@vger.kernel.org \
    --cc=leduyquang753@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.
Code repositories for project(s) associated with this public inbox

	https://80x24.org/mirrors/git.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).