From: Bart Schaefer <schaefer@brasslantern.com>
To: zsh-workers@zsh.org
Subject: Re: [PATCH v2] Re: [PATCH] _add-zle-hook-widget: New completion.
Date: Fri, 22 Jul 2016 11:21:26 -0700 [thread overview]
Message-ID: <160722112126.ZM15554@torch.brasslantern.com> (raw)
In-Reply-To: <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 ...
next prev parent reply other threads:[~2016-07-22 18:20 UTC|newest]
Thread overview: 27+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-07-04 10:40 Next release (5.3) Peter Stephenson
2016-07-04 15:04 ` Bart Schaefer
2016-07-05 6:00 ` Sebastian Gniazdowski
2016-07-05 6:33 ` Bart Schaefer
2016-07-05 8:33 ` Peter Stephenson
2016-07-05 11:48 ` Peter Stephenson
2016-07-05 16:29 ` Bart Schaefer
2016-07-07 2:00 ` Daniel Shahaf
2016-07-13 5:00 ` add-zle-hook-widget " Daniel Shahaf
2016-07-14 0:11 ` Bart Schaefer
2016-07-17 1:51 ` Bart Schaefer
2016-07-17 15:00 ` [PATCH] _add-zle-hook-widget: New completion Daniel Shahaf
2016-07-17 19:21 ` Bart Schaefer
2016-07-17 20:40 ` Bart Schaefer
2016-07-17 21:57 ` Bart Schaefer
2016-07-18 9:47 ` Oliver Kiddle
2016-07-18 15:30 ` Bart Schaefer
2016-07-19 10:30 ` Oliver Kiddle
2016-07-19 17:58 ` Bart Schaefer
2016-07-20 6:54 ` [PATCH v2] " Daniel Shahaf
2016-07-21 15:28 ` Oliver Kiddle
2016-07-22 6:22 ` Daniel Shahaf
2016-07-22 18:21 ` Bart Schaefer [this message]
2016-07-22 18:45 ` Oliver Kiddle
2016-07-23 18:03 ` Daniel Shahaf
2016-07-17 14:59 ` add-zle-hook-widget Re: Next release (5.3) Daniel Shahaf
2016-07-17 18:48 ` Bart Schaefer
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=160722112126.ZM15554@torch.brasslantern.com \
--to=schaefer@brasslantern.com \
--cc=zsh-workers@zsh.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://git.vuxu.org/mirror/zsh/
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).