From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <zsh-workers-return-31623-mason-zsh=primenet.com.au@zsh.org>
Received: (qmail 21152 invoked by alias); 30 Jul 2013 20:42:36 -0000
Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm
Precedence: bulk
X-No-Archive: yes
List-Id: Zsh Workers List <zsh-workers.zsh.org>
List-Post: <mailto:zsh-workers@zsh.org>
List-Help: <mailto:zsh-workers-help@zsh.org>
X-Seq: 31623
Received: (qmail 12587 invoked from network); 30 Jul 2013 20:42:31 -0000
X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on f.primenet.com.au
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,DKIM_SIGNED,
	DKIM_VALID,RCVD_IN_DNSWL_NONE autolearn=ham version=3.3.2
Received-SPF: pass (ns1.primenet.com.au: SPF record at _netblocks.google.com designates 209.85.192.172 as permitted sender)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=gmail.com; s=20120113;
        h=mime-version:sender:in-reply-to:references:date
         :x-google-sender-auth:message-id:subject:from:to:cc:content-type
         :content-transfer-encoding;
        bh=LubSlNRUQwORdxYGHlo2fcwSRFAVnsevgZHBo+VEfgU=;
        b=0fAFP1BWRBG8OYH3FyM2aXrz7UDVEGXxDhcSxJRTxPH/QoMD2svr9vKdbsOw0F3rMM
         /u7zx78hPIUXRGGE8iBjsFMyd7CLwKh4mRf5MO06nPRmL9aWNqvzpaf8Ujx2LMn/DH6c
         bAYU1q2VQWtWsHCngn4flfcDvL2D6rsaf1kE+cgcav8EuZJOhgbklOTiM1FfCtB9ZYMA
         MAZTaiGI7WcWRw2d/Q6HhnUqzflVGrW0ErRA+Kq5SJP4sREWzS95zs1nLFKTyZCMfKd6
         YFRTlDsafQVXOPyEwEs8WatUahXCLLAKp/xzIgQbE3YJceYncsvEo+iLl02cEaP5amYX
         4YRA==
MIME-Version: 1.0
X-Received: by 10.68.203.161 with SMTP id kr1mr75767878pbc.192.1375216948438;
 Tue, 30 Jul 2013 13:42:28 -0700 (PDT)
Sender: nikolai.weibull@gmail.com
In-Reply-To: <CAFaJEquG7_qUYwK6CFV=n1+8kzT7g3g8JBFCdnnnUQhcFrczOg@mail.gmail.com>
References: <cover.1375006129.git.oystwa@gmail.com>
	<a8731d9d3b21a5a6225b228795d21862bcc0ced7.1375006129.git.oystwa@gmail.com>
	<CADdV=MvFK6C3g6dmSHEJzuGizkoiFf8=WGHmTEg6C1PPSKErcQ@mail.gmail.com>
	<CAFaJEquG7_qUYwK6CFV=n1+8kzT7g3g8JBFCdnnnUQhcFrczOg@mail.gmail.com>
Date: Tue, 30 Jul 2013 22:42:28 +0200
X-Google-Sender-Auth: BZ9PJ2lQM1pqCmxC8ujoaDrK2RM
Message-ID: <CADdV=Msmc23iNy+EgLVKL1Qzo2=fwWsAbdJH8C32bShYpK24OQ@mail.gmail.com>
Subject: Re: [PATCH 16/16] _git: Document --early-output
From: Nikolai Weibull <now@disu.se>
To: =?UTF-8?Q?=C3=98ystein_Walle?= <oystwa@gmail.com>
Cc: zsh-workers@zsh.org
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

On Tue, Jul 30, 2013 at 6:31 PM, =C3=98ystein Walle <oystwa@gmail.com> wrot=
e:
> On 30 July 2013 16:35, Nikolai Weibull <now@disu.se> wrote:
>> On Sun, Jul 28, 2013 at 6:22 PM, =C3=98ystein Walle <oystwa@gmail.com> w=
rote:
>>
>>> -    # TODO: --early-output is undocumented.
>>> -    '--early-output=3D-[undocumented]::undocumented'
>>> +    '--early-output=3D-[generate some output early even if not done]: =
:__git_guard_number "number of commits"'
>>
>> The point here is that --early-output isn=E2=80=99t documented in Git=E2=
=80=99s
>> documentation.  Please notify the Git developers that it isn=E2=80=99t s=
o that
>> the description here can match that in the documentation (once
>> written).
>
> I was planning on writing the corresponding patch to Git too, but the log=
s make
> it clear that this option is only meant for other calling processes.
>
> While it would make sense to document it in Git's man pages still (what o=
ther
> reference is there?) it makes less sense to suggest it for interactive us=
e.
>
> I suggest you ignore this patch.

Agreed.