From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 14934 invoked by alias); 25 Jan 2015 01:06:33 -0000 Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: X-Seq: 34377 Received: (qmail 14392 invoked from network); 25 Jan 2015 01:06:32 -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,RCVD_IN_DNSWL_NONE, SPF_HELO_PASS autolearn=ham version=3.3.2 From: Frank Terbeck To: zsh-workers@zsh.org Subject: Re: [PATCH] vcs_info docs: Document patch-format and more In-Reply-To: <20150124154521.GF20359@tarsus.local2> (Daniel Shahaf's message of "Sat, 24 Jan 2015 15:45:21 +0000") References: <20150124154521.GF20359@tarsus.local2> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4.51 (gnu/linux) Date: Sun, 25 Jan 2015 01:50:35 +0100 Message-ID: <87r3ujwun8.fsf@ft.bewatermyfriend.org> MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Df-Sender: NDMwNDQ0 Hey, Daniel Shahaf wrote: > 1. I didn't actually document all of them, for some I only added > placeholders. I think that would be better than not documenting them at > all, but obviously it would be nice if the documentation were actually > written. I don't use most of that myself (e.g., I don't use the quilt > support at all), so I think the docs would be better if someone who > actually uses the features documented them =E2=80=94 for example, because= they > would be better placed to notice edge case bugs, instead of documenting > them as features. I'll hold off on this, basically because I don't know what the general consensus about "TODO"s is in zsh reference documentation. Maybe I'll fill in the blanks sometime tomorrow. Then it won't matter. Regards, Frank