Re: [PATCH v2 1/3] git-fetch.txt: document fetch output

From: Jeff King <peff@peff.net>
Date: Jun 3, 2016, 16:55 UTC
Message-ID: <20160603165502.GA1733@sigill.intra.peff.net>
In-Reply-To: <20160603110843.15434-2-pclouds@gmail.com>

On Fri, Jun 03, 2016 at 06:08:41PM +0700, Nguyễn Thái Ngọc Duy wrote:

> This patch is a copy from git-push.txt, modified a bit because the
> flag '-' means different things in push (delete) and fetch (tag
> update). We probably should unify the documents at some point in
> future.

This is stderr output from a porcelain. I don't think we make any promises about the format, and since we're changing other bits, perhaps now is a good time to unify the "-" handling.

> +The status of the push is output in tabular form, with each line
> +representing the status of a single ref. Each line is of the form:

Like Marc, I wondered what this means. :) I know that there have been different status outputs from transport.c and fetch.c in the past, but I thought we had unified a lot of that. If we haven't, it seems like a good time to do so (and I'd prefer fixing to documenting quirks, when it's something that isn't plumbing).

-Peff