From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-3.4 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,FREEMAIL_FROM,MAILING_LIST_MULTI,RCVD_IN_DNSWL_MED, T_SCC_BODY_TEXT_LINE,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 31263 invoked from network); 29 Mar 2022 04:41:31 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 29 Mar 2022 04:41:31 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1648528891; b=E4Uki4LyVS5zQ4Dax2H1xB+lJnUf+O8ZAQC1ZeFx8xVjFecreg2f5Gq6G0VhJ2ypk5GkUU+w49 rby0oGXxrmf4wb6NAG1pfL5IrPHfPoXymH5/SpyzItzvtNhz6vY+0LI49QnSO5TGaVcxpUCYxz sn2vOMBYkF3a8547i97QfjZqJ7GC1F2AIpPSfFh6fGK5KkpEbj74TgMNChxX0Lpt15WvZQo+j+ IwAvZptWYbR+o1U9exygJOtaKob/ps9cXsjSkfeEiHK0DRGMmh2WkNhfde3ea8r4nhdoCy2BzI iHj/C30nRSDRCM3jmwvuUkVTBNCCvFtJHALtDzoplUKcnQ==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-oa1-f50.google.com) smtp.remote-ip=209.85.160.50; dkim=pass header.d=gmail.com header.s=20210112 header.a=rsa-sha256; dmarc=pass header.from=gmail.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1648528891; bh=gEmC638eJL8gk994sm/TrPA/eePs4BFp4B3PrzcHv2Y=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Type:MIME-Version:Message-ID:Subject:To:From:Date: DKIM-Signature:DKIM-Signature; b=g7VngxtjcG9KTM7kMPZTblXtUxMGYv07spiK+FuVoZUhB3BnxLQHu1RVD4SFij/oGsdCBONAOz k7wPbcm1RtSBZan7mg4utKLAOwpazCKtc/BnJjtI54GlM01UyQoWIvODG7vcqFu3NvfPw7qkgV mKSpcWLW2ReoDMcn3S9jCskqOGpDmKVsXqx/x3iayU0qvxjCN6rQXPCMVWGOjUElP5xTejAY6x Hi5qQ8aPPTAeD6UwxpzDpvZjTu3mPyl1xJ3OyFj6HHtBe86LFUbBjID0Hw8665JWyqGHupg/hj wYMJkzUgsHOzvxr0/U+48Kb7Sz0az88GaurGMdBZTAjT+A==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20210803; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:Content-Type:MIME-Version:Message-ID: Subject:To:From:Date:Reply-To:Cc:Content-Transfer-Encoding:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:In-Reply-To:References; bh=w1RCCL2fhP8cLMDMmCIcXUBkhAl8rBYAd2h4j9B5CDk=; b=fnfp/q1wbVtJhTSyPmoVzSeC75 91XZY4D7tbeSSTNxqzEDRsJ1v67Tv42M9YiJ6CJAkHBzXR4hFqhBy1NEQbNT3qan7NnBrDwV8N4Jf 7GyUF4TW/fgk7aYfr/r8DFXVuQKiU6XwkZhbq5dhFIJDLgZvVnBqznOswJLJO1dXP0iPa7SOylXGu oIT6DuNbdhIAgJ9EucgtdtYGj7QQf3H0A5iHqqIhuWAORteP3aUziowunZVmCXNzvBxqhz+M1U9RD Iy6TH4fS07rSaavx4zHTiYaTndTSXpfWFDdP1yYGglnEsCplXK62Hdqj0nq5hs/ezIrNzJx+hnshS aYO29hPQ==; Received: from authenticated user by zero.zsh.org with local id 1nZ3fc-000IqB-Vb; Tue, 29 Mar 2022 04:41:29 +0000 Authentication-Results: zsh.org; iprev=pass (mail-oa1-f50.google.com) smtp.remote-ip=209.85.160.50; dkim=pass header.d=gmail.com header.s=20210112 header.a=rsa-sha256; dmarc=pass header.from=gmail.com; arc=none Received: from mail-oa1-f50.google.com ([209.85.160.50]:45359) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1nZ3fL-000IXU-AE; Tue, 29 Mar 2022 04:41:11 +0000 Received: by mail-oa1-f50.google.com with SMTP id 586e51a60fabf-d6ca46da48so17503899fac.12 for ; Mon, 28 Mar 2022 21:41:11 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=date:from:to:subject:message-id:mail-followup-to:mime-version :content-disposition; bh=w1RCCL2fhP8cLMDMmCIcXUBkhAl8rBYAd2h4j9B5CDk=; b=S4pS+cu3XU5ybdo1WQH2b2wb72JyJUF0UOoWYolxgtidFjZTLUk74BvMjbVeQdk8RR r+4+kHIS3/lCbQXyLATqHWNWxRyuc04woGOfNXPMhRS7d2N5XFqXSWPg8qmBwvUcCiht i9adNJqlYc3EzCKlMIonAqPP7DD9sHSH3sOAtOTxteWJFsID/8DyG9SUqWegUIInhDZE gpKjFraDONjsWYhlNiAXstU8IDq3//IfqA+o0Y4okVleqaw31O9N8xW3qF0KWvQgzCGr 501DdHmB87GEKgR8tzWvcA261rXa9e3Lrx7II9OxuSIaADeQwOau/PzV+VEnOJRTBX0H k53w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:date:from:to:subject:message-id:mail-followup-to :mime-version:content-disposition; bh=w1RCCL2fhP8cLMDMmCIcXUBkhAl8rBYAd2h4j9B5CDk=; b=mzTcLCUv8Yf8fA0ZV5qR+1rdwtXygQnkGEEObS/WbK2BnYiisoUz9mELQAD09z2DuC 5t1UDvsaiEuY4ySB6I7IEacawVtplzMX6H4Nl29v5athWLEN6+yBBXWszrkLRfodC230 DQiCnm2fiNsjJnM0SDT6kkXKh2LVvASBDirnkwX6AykwTasgSjlzxn8/Fb/+/XnGikQk x4ACaWRGilDIG08i1r7XZhs+b8uww8P+tlHc+T/nLP4UR/KRR9SDrZbJ9ETYhNl8Jszf 5oghJLomc0+dJVums/9EapqhrwHd3VM7/fsBNioe4/2Z4TEqUcoMNAq4D1SYnSIWZ6GB sDnA== X-Gm-Message-State: AOAM533DwFoex1NU9MdqEiHpy43+T+AMsWpFe5UkynLi8/kBhIv1G/qw /Eaixf/HEgZ0XT3+M1RF3XoKiwrmWYs= X-Google-Smtp-Source: ABdhPJz4ZNeblfbFHpbcYxVubS7JaWrMbRB1i1BYVU4E8prZACLud5q4eElPigwClXMDAkwxHlLbGg== X-Received: by 2002:a05:6870:f697:b0:d7:5679:8fc8 with SMTP id el23-20020a056870f69700b000d756798fc8mr1313697oab.172.1648528869787; Mon, 28 Mar 2022 21:41:09 -0700 (PDT) Received: from CptOrmolo.darkstar (cpe-76-184-110-212.tx.res.rr.com. [76.184.110.212]) by smtp.gmail.com with ESMTPSA id m126-20020aca3f84000000b002ef895f4bf8sm8244047oia.24.2022.03.28.21.41.09 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 28 Mar 2022 21:41:09 -0700 (PDT) Date: Mon, 28 Mar 2022 23:41:06 -0500 From: Matthew Martin To: zsh-workers@zsh.org Subject: PATCH: Mention _numbers in completion guide Message-ID: Mail-Followup-To: zsh-workers@zsh.org MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline X-Seq: 49907 Archived-At: X-Loop: zsh-workers@zsh.org Errors-To: zsh-workers-owner@zsh.org Precedence: list Precedence: bulk Sender: zsh-workers-request@zsh.org X-no-archive: yes List-Id: List-Help: List-Subscribe: List-Unsubscribe: List-Post: List-Owner: List-Archive: Seems _numbers should be mentioned to nudge people in that direction. diff --git a/Etc/completion-style-guide b/Etc/completion-style-guide index 4fa0040a5..f7dcae230 100644 --- a/Etc/completion-style-guide +++ b/Etc/completion-style-guide @@ -75,6 +75,8 @@ but use: To indicate a default value, use square brackets: '--timeout[specify connection timeout]:timeout (ms) [5000]' These two conventions can be used together or individually as appropriate. +Alternatively the `_numbers' function may be used: + '--timeout[specify connection timeout]: :_numbers -u ms -d 5000 timeout' Group descriptions should be singular because only one thing is being completed even though many may be listed. This applies even where you