From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <zsh-workers-return-37079-mason-zsh=primenet.com.au@zsh.org>
Received: (qmail 5145 invoked by alias); 8 Nov 2015 20:01:51 -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: 37079
Received: (qmail 29285 invoked from network); 8 Nov 2015 20:01:51 -0000
X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on f.primenet.com.au
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00,T_DKIM_INVALID
	autolearn=ham autolearn_force=no version=3.4.0
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
        d=brasslantern_com.20150623.gappssmtp.com; s=20150623;
        h=from:message-id:date:to:subject:mime-version:content-type;
        bh=4pVzbaJz7GBp2SaA4QHOaJ5Gf0fFLCkmdobOWOOE/9c=;
        b=j+XuHLxX/Sy3Wk2sq2tCyC+f7PXSMCWXUVzUfPSlOnXaP+PGMU21grhSSBCC6SK58g
         0Kxi3rbfzHo9GSuscUt2lOHRn+pQBH/4NYyys6SFmyflr/Lnb3vkssGitQDB1tS70oCx
         hIrorecTuQsJydQd2TvN46B5jeYlZoVdRPJpoziq9yk6IOQWSMrcmL5t+GS37ercyG3t
         qOm8tI1vnkMl/H0vjIjDHCTcg3aiH9wdE/vGRzc3ZZcoBaqRQBV5XmYFQywQT6SbTWTR
         psHFOLWumP2/Lo94iI5hpYfHNC8rxr+C25jPvcUcamsUxYuVHgln82Ch7UNBXam0SmvW
         fZdw==
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:to:subject:mime-version
         :content-type;
        bh=4pVzbaJz7GBp2SaA4QHOaJ5Gf0fFLCkmdobOWOOE/9c=;
        b=B+PKTLIfaW/eNZ7+Gm47YmPLmRj2ugoAUXCiWY2lo68OD0wgzgFiOMerGTi6pyk0Wz
         M8AGe0OAz548P8taPVihDi7j21Clr1pGQVyvfOKrRxws8Y3PzRAKpLyDboLtV8gmlSfy
         Pj6PLUOsvMjCFa1KSKvytNK6E1QoFglphYMOPXLIC9yYKYvBBpyzbsaHirsWQQ/sEi3b
         om3Of1CrLhojd2g0Awmtn6PegstNCjCPM9zyHqcJTq33RLwshvkPP79Wg23vTIGCzhhm
         X3+R6u9tBb43gwW+wV1ptEwQcLJYGwXUV3W8nq9/yYImlDivx61Z1yvWC+nmynekZGS3
         XQ1w==
X-Gm-Message-State: ALoCoQkEqoGNIjbKTB6H/YJrWeqLvMJ48aEStQww8ko7FXg8OETAuKxrqhKZfcTHh9g1Mv5vwwTJ
X-Received: by 10.60.33.232 with SMTP id u8mr14564810oei.22.1447012909596;
        Sun, 08 Nov 2015 12:01:49 -0800 (PST)
From: Bart Schaefer <schaefer@brasslantern.com>
Message-Id: <151108120146.ZM915@torch.brasslantern.com>
Date: Sun, 8 Nov 2015 12:01:46 -0800
X-Mailer: OpenZMail Classic (0.9.2 24April2005)
To: zsh-workers@zsh.org
Subject: PATCH: zsh-development-guide clarification
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii

Some missing detail about the meaning of fields in "struct builtin".

diff --git a/Etc/zsh-development-guide b/Etc/zsh-development-guide
index 9ca441b..c4aa1b2 100644
--- a/Etc/zsh-development-guide
+++ b/Etc/zsh-development-guide
@@ -503,7 +503,9 @@ arguments are:
   - the options the builtin accepts, given as a string containing the
     option characters (the above example makes the builtin accept the
     options `f', `l', `a', `g', and `s').  Passing NULL here disables
-    all flag handling, i.e. even "--".
+    all flag handling, i.e. even "--".  Each option letter may be
+    followed by one of ":" (argument must follow), "::" (optional
+    argument may follow), or ":%" (optional numeric argument).
   - and finally a optional string containing option characters that
     will always be reported as set when calling the C-function (this,
     too, can be used when using one C-function to implement multiple