From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <zsh-users-return-19736-mason-zsh=primenet.com.au@zsh.org>
Received: (qmail 10342 invoked by alias); 13 Jan 2015 16:03:59 -0000
Mailing-List: contact zsh-users-help@zsh.org; run by ezmlm
Precedence: bulk
X-No-Archive: yes
List-Id: Zsh Users List <zsh-users.zsh.org>
List-Post: <mailto:zsh-users@zsh.org>
List-Help: <mailto:zsh-users-help@zsh.org>
X-Seq: 19736
Received: (qmail 27969 invoked from network); 13 Jan 2015 16:03:57 -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 autolearn=ham
	version=3.3.2
Date: Tue, 13 Jan 2015 17:03:56 +0100
From: Vincent Lefevre <vincent@vinc17.net>
To: zsh-users@zsh.org
Subject: Re: completion
Message-ID: <20150113160356.GB12079@ypig.lip.ens-lyon.fr>
Mail-Followup-To: zsh-users@zsh.org
References: <141211092824.ZM13349@torch.brasslantern.com>
 <5489F1BC.5000900@eastlink.ca>
 <20150107150109.GA14088@ypig.lip.ens-lyon.fr>
 <CAH+w=7YQ=VrWFjCXn4q7U48e3R+eNTF9xihHBf-oFDYTVR_zGQ@mail.gmail.com>
 <20150108004323.GA7954@xvii.vinc17.org>
 <CAH+w=7ZPnjtZQJLM012ZJFx-zj7pFLzVivEG+Q=vixLGnjrM5g@mail.gmail.com>
 <20150108123606.GA9609@ypig.lip.ens-lyon.fr>
 <150109181241.ZM21734@torch.brasslantern.com>
 <20150112090903.GA27773@xvii.vinc17.org>
 <150112084308.ZM6520@torch.brasslantern.com>
MIME-Version: 1.0
Content-Type: text/plain; charset=iso-8859-1
Content-Disposition: inline
Content-Transfer-Encoding: 8bit
In-Reply-To: <150112084308.ZM6520@torch.brasslantern.com>
X-Mailer-Info: http://www.vinc17.net/mutt/
User-Agent: Mutt/1.5.23-6392-vl-r75100 (2015-01-06)

On 2015-01-12 08:43:08 -0800, Bart Schaefer wrote:
> On Jan 12, 10:09am, Vincent Lefevre wrote:
> }
> } Why hasn't this been done for the man page?
> 
> Because no one considered that one might be using the _foo completer
> for a command whose name is "complete", because there is no such
> command?
> 
> Documentation people make mistakes too ... and none of us is really
> a documentation people.

So, for readability and to avoid any ambiguity, I suggest that the
documentation be updated to use only the form with all the colons,
except when "*" is only used at the end.

-- 
Vincent Lefèvre <vincent@vinc17.net> - Web: <https://www.vinc17.net/>
100% accessible validated (X)HTML - Blog: <https://www.vinc17.net/blog/>
Work: CR INRIA - computer arithmetic / AriC project (LIP, ENS-Lyon)