From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <zsh-workers-return-38919-mason-zsh=primenet.com.au@zsh.org>
Received: (qmail 17540 invoked by alias); 22 Jul 2016 18:20:59 -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: 38919
Received: (qmail 1952 invoked from network); 22 Jul 2016 18:20:59 -0000
X-Qmail-Scanner-Diagnostics: from mail-pa0-f65.google.com by f.primenet.com.au (envelope-from <schaefer@brasslantern.com>, uid 7791) with qmail-scanner-2.11 
 (clamdscan: 0.99.2/21882. spamassassin: 3.4.1.  
 Clear:RC:0(209.85.220.65):SA:0(0.0/5.0):. 
 Processed in 0.12498 secs); 22 Jul 2016 18:20:59 -0000
X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on f.primenet.com.au
X-Spam-Level: 
X-Spam-Status: No, score=0.0 required=5.0 tests=T_DKIM_INVALID
	autolearn=unavailable autolearn_force=no version=3.4.1
X-Envelope-From: schaefer@brasslantern.com
X-Qmail-Scanner-Mime-Attachments: |
X-Qmail-Scanner-Zip-Files: |
Received-SPF: none (ns1.primenet.com.au: domain at brasslantern.com does not designate permitted sender hosts)
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==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=1e100.net; s=20130820;
        h=x-gm-message-state:from:message-id:date:in-reply-to:comments
         :references:to:subject:mime-version;
        bh=aMDPyElcq7MOvHr1/VSJBe3tGnlsEBGXzXmoKhZ+gHk=;
        b=VeLAAzTX0UYIoO2pr77ulJbHe9EYOsZF5URKycm5kJwOlvrpLxJScbWBsEolrqGvmd
         oiEaOIs5LLiAbeLZF20eeG5Giu+Oj+OaLD9rri5t1IWadAT5PwETDHmNd92nMq1AkrKb
         I8b5WscPjo9zpBIiSVByqd/qBGuhk8a+cFAyIV/0cBaNhnygiRjE0VAA9SMDRu0I8Da4
         5rv96fduY+nXpO5NFkJz11m0+AmQwQs4QtiT3PIEbG3Rckm299qfszykNFbrjyTuNZ7q
         CgykKakC/tYHoCj7PEwZlka6BaILB5QJA0OhN9Ck7e657GIzxzz0RhPILOwAIbh4pWmF
         VkJQ==
X-Gm-Message-State: AEkoouuy4aCek79v/6j+ypy9Rft8Ad46T4bkupYXwwyfRUv7IlCKRREhnpXiSHlUFk69gQ==
X-Received: by 10.66.153.163 with SMTP id vh3mr8879872pab.0.1469211648084;
        Fri, 22 Jul 2016 11:20:48 -0700 (PDT)
From: Bart Schaefer <schaefer@brasslantern.com>
Message-Id: <160722112126.ZM15554@torch.brasslantern.com>
Date: Fri, 22 Jul 2016 11:21:26 -0700
In-Reply-To: <20160722062259.GB3457@tarsus.local2>
Comments: In reply to Daniel Shahaf <d.s@daniel.shahaf.name>
        "Re: [PATCH v2] Re: [PATCH] _add-zle-hook-widget: New completion." (Jul 22,  6:22am)
References: <160716185103.ZM5258@torch.brasslantern.com> 
	<1468767614-9635-1-git-send-email-danielsh@tarsus.local2> 
	<91351.1468835277@hydra.kiddle.eu> 
	<20160720065421.GE28939@tarsus.local2> 
	<22468.1469114906@hydra.kiddle.eu> 
	<20160722062259.GB3457@tarsus.local2>
X-Mailer: OpenZMail Classic (0.9.2 24April2005)
To: zsh-workers@zsh.org
Subject: Re: [PATCH v2] Re: [PATCH] _add-zle-hook-widget: New completion.
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii

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 ...