Zsh Mailing List Archive
Messages sorted by:
Re: [PATCH v2] Re: [PATCH] _add-zle-hook-widget: New completion.
- X-seq: zsh-workers 38919
- From: Bart Schaefer <schaefer@xxxxxxxxxxxxxxxx>
- To: zsh-workers@xxxxxxx
- Subject: Re: [PATCH v2] Re: [PATCH] _add-zle-hook-widget: New completion.
- Date: Fri, 22 Jul 2016 11:21:26 -0700
- Dkim-signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=brasslantern-com.20150623.gappssmtp.com; s=20150623; h=from:message-id:date:in-reply-to:comments:references:to:subject :mime-version; bh=aMDPyElcq7MOvHr1/VSJBe3tGnlsEBGXzXmoKhZ+gHk=; b=Ynk3HURUnYne3MHQTQlwvGWRxanSConJ0sw/FVfswidRf6lNo4a0vjMELdhtPdgwQ3 xcAMC//weLqaJ922JC2bFg5ARg2wqkV8GweGcsOxDSTi2dm8pV+qDcj/bsbsMdOZSAmK GgL7RThoAMuAWAj2C31hB0v6xtLGnAqTbROnG2XDCUKnh4jsVXFJ5U5Kb3JUBL46jXTE iBaVwckJuFsHbGAPVdF1gsNeIMd2THp4SK+DcinWgMmJ3My7TtDuBHhzcjBfI9O4sg9m G0xHJhM7kblb4GGptV5JEMpmDsjCxJMbScYnmq8lwOieOb4GXu7XyOpIX61QHTCr+9zH JPwA==
- In-reply-to: <20160722062259.GB3457@tarsus.local2>
- List-help: <mailto:email@example.com>
- List-id: Zsh Workers List <zsh-workers.zsh.org>
- List-post: <mailto:firstname.lastname@example.org>
- Mailing-list: contact zsh-workers-help@xxxxxxx; run by ezmlm
- References: <160716185103.ZM5258@torch.brasslantern.com> <email@example.com> <firstname.lastname@example.org> <20160720065421.GE28939@tarsus.local2> <email@example.com> <20160722062259.GB3457@tarsus.local2>
On Jul 22, 6:22am, Daniel Shahaf wrote:
} _default appears to be undocumented.
There was a decision made at some point (*very* long ago, while Sven
was still actively inventing the compltion system) that the yodl doc
should only describe commands and functions etc. that an ordinary user
might employ in startup files, and all other details that developers
would use to write new parts of the completion system would only be
documented where developers could see it, e.g., in code comments.
Hence for example the complete lack of explanation of comptags and
comptry, even though they are at least *mentioned* in the yodl.
Sadly this didsn't really take new developers into account, because
you'd have to know what you were looking for before you could find
any doc for it, and not everything was adequately commented either.
Leaving us with a bunch of stuff that ought to be documented and
nobody with time to backfill it.
I learned the term "technical debt" recently ...
Messages sorted by: