From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!not-for-mail From: Paul Eggert Newsgroups: gmane.emacs.devel Subject: Re: master b342815: Improve define-function omitted-arg documentation Date: Fri, 27 May 2016 18:19:15 -0700 Organization: UCLA Computer Science Department Message-ID: <5748F213.3040707@cs.ucla.edu> References: <20160527164722.20278.19217@vcs.savannah.gnu.org> <20160527164723.4A992220156@vcs.savannah.gnu.org> NNTP-Posting-Host: plane.gmane.org Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="------------030807070008080005000309" X-Trace: ger.gmane.org 1464398416 7513 80.91.229.3 (28 May 2016 01:20:16 GMT) X-Complaints-To: usenet@ger.gmane.org NNTP-Posting-Date: Sat, 28 May 2016 01:20:16 +0000 (UTC) To: Stefan Monnier , emacs-devel@gnu.org Original-X-From: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Sat May 28 03:20:07 2016 Return-path: Envelope-to: ged-emacs-devel@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by plane.gmane.org with esmtp (Exim 4.69) (envelope-from ) id 1b6Sv7-0006AM-DL for ged-emacs-devel@m.gmane.org; Sat, 28 May 2016 03:20:05 +0200 Original-Received: from localhost ([::1]:49918 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6Sv6-0007Wt-GS for ged-emacs-devel@m.gmane.org; Fri, 27 May 2016 21:20:04 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:43621) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6SuU-0007Ul-Mz for emacs-devel@gnu.org; Fri, 27 May 2016 21:19:28 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1b6SuQ-0001WO-9v for emacs-devel@gnu.org; Fri, 27 May 2016 21:19:25 -0400 Original-Received: from zimbra.cs.ucla.edu ([131.179.128.68]:41774) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1b6SuQ-0001WJ-1H for emacs-devel@gnu.org; Fri, 27 May 2016 21:19:22 -0400 Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id 5E4861613E3; Fri, 27 May 2016 18:19:21 -0700 (PDT) Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10032) with ESMTP id 2fWEaK_Hz7Q8; Fri, 27 May 2016 18:19:19 -0700 (PDT) Original-Received: from localhost (localhost [127.0.0.1]) by zimbra.cs.ucla.edu (Postfix) with ESMTP id CA20C1613DF; Fri, 27 May 2016 18:19:19 -0700 (PDT) X-Virus-Scanned: amavisd-new at zimbra.cs.ucla.edu Original-Received: from zimbra.cs.ucla.edu ([127.0.0.1]) by localhost (zimbra.cs.ucla.edu [127.0.0.1]) (amavisd-new, port 10026) with ESMTP id fJBczp0jimSj; Fri, 27 May 2016 18:19:19 -0700 (PDT) Original-Received: from [192.168.1.9] (unknown [100.32.155.148]) by zimbra.cs.ucla.edu (Postfix) with ESMTPSA id AB5621613DA; Fri, 27 May 2016 18:19:19 -0700 (PDT) User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.8.0 In-Reply-To: X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x X-Received-From: 131.179.128.68 X-BeenThere: emacs-devel@gnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: "Emacs development discussions." List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: emacs-devel-bounces+ged-emacs-devel=m.gmane.org@gnu.org Original-Sender: "Emacs-devel" Xref: news.gmane.org gmane.emacs.devel:204097 Archived-At: This is a multi-part message in MIME format. --------------030807070008080005000309 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Stefan Monnier wrote: > I'm OK with using &rest in the implementation, but it's probably best > not to document this implementation choice in the manual. > > Similarly we should probably do something like the patch below. Nice, I didn't know about advertised-calling-convention. I installed the attached. --------------030807070008080005000309 Content-Type: text/plain; charset=UTF-8; name="0001-Don-t-document-declare-function-internals.txt" Content-Transfer-Encoding: base64 Content-Disposition: attachment; filename="0001-Don-t-document-declare-function-internals.txt" RnJvbSA1ZDNjNmNhMGZkYjk0MDJmOWJkYjBlYTEwYThjODU4NTAyNGRlMWYyIE1vbiBTZXAg MTcgMDA6MDA6MDAgMjAwMQpGcm9tOiBQYXVsIEVnZ2VydCA8ZWdnZXJ0QGNzLnVjbGEuZWR1 PgpEYXRlOiBGcmksIDI3IE1heSAyMDE2IDE4OjE2OjI0IC0wNzAwClN1YmplY3Q6IFtQQVRD SF0gPT9VVEYtOD9xP0Rvbj1FMj04MD05OXQ9MjBkb2N1bWVudD0yMGRlY2xhcmUtZnVuY3Rp b249MjBpPz0KID0/VVRGLTg/cT9udGVybmFscz89Ck1JTUUtVmVyc2lvbjogMS4wCkNvbnRl bnQtVHlwZTogdGV4dC9wbGFpbjsgY2hhcnNldD1VVEYtOApDb250ZW50LVRyYW5zZmVyLUVu Y29kaW5nOiA4Yml0CgpTdWdnZXN0ZWQgYnkgU3RlZmFuIE1vbm5pZXIgaW46Cmh0dHA6Ly9s aXN0cy5nbnUub3JnL2FyY2hpdmUvaHRtbC9lbWFjcy1kZXZlbC8yMDE2LTA1L21zZzAwNjE4 Lmh0bWwKKiBkb2MvbGlzcHJlZi9mdW5jdGlvbnMudGV4aSAoRGVjbGFyaW5nIEZ1bmN0aW9u cyk6CiogbGlzcC9zdWJyLmVsIChkZWNsYXJlLWZ1bmN0aW9uKToKKiBsaXNwL2VtYWNzLWxp c3AvYnl0ZWNvbXAuZWw6CihieXRlLWNvbXBpbGUtbWFjcm9leHBhbmQtZGVjbGFyZS1mdW5j dGlvbik6CkRvY3VtZW50IGFzIChmbiBmaWxlICZvcHRpb25hbCBhcmdsaXN0IGZpbGVvbmx5 KQpldmVuIHRob3VnaCBpdCBpcyByZWFsbHkgKGZuIGZpbGUgJnJlc3QgYXJncykuCi0tLQog ZG9jL2xpc3ByZWYvZnVuY3Rpb25zLnRleGkgIHwgMTkgKysrKysrKysrLS0tLS0tLS0tLQog bGlzcC9lbWFjcy1saXNwL2J5dGVjb21wLmVsIHwgIDIgKysKIGxpc3Avc3Vici5lbCAgICAg ICAgICAgICAgICB8IDE5ICsrKysrKysrKystLS0tLS0tLS0KIDMgZmlsZXMgY2hhbmdlZCwg MjEgaW5zZXJ0aW9ucygrKSwgMTkgZGVsZXRpb25zKC0pCgpkaWZmIC0tZ2l0IGEvZG9jL2xp c3ByZWYvZnVuY3Rpb25zLnRleGkgYi9kb2MvbGlzcHJlZi9mdW5jdGlvbnMudGV4aQppbmRl eCA3NTEzYWRmLi5mZmY0YWMwIDEwMDY0NAotLS0gYS9kb2MvbGlzcHJlZi9mdW5jdGlvbnMu dGV4aQorKysgYi9kb2MvbGlzcHJlZi9mdW5jdGlvbnMudGV4aQpAQCAtMjIwNCwxNyArMjIw NCwxNiBAQCBEZWNsYXJpbmcgRnVuY3Rpb25zCiBZb3UgZG9uJ3QgaGF2ZSB0byBzcGVjaWZ5 IHRoZSBhcmd1bWVudCBsaXN0LCBidXQgaWYgeW91IGRvIHRoZQogYnl0ZSBjb21waWxlciBj YW4gY2hlY2sgdGhhdCB0aGUgY2FsbHMgbWF0Y2ggdGhlIGRlY2xhcmF0aW9uLgogCi1AZGVm bWFjIGRlY2xhcmUtZnVuY3Rpb24gZnVuY3Rpb24gZmlsZSAmcmVzdCBhcmdzCitAZGVmbWFj IGRlY2xhcmUtZnVuY3Rpb24gZnVuY3Rpb24gZmlsZSAmb3B0aW9uYWwgYXJnbGlzdCBmaWxl b25seQogVGVsbCB0aGUgYnl0ZSBjb21waWxlciB0byBhc3N1bWUgdGhhdCBAdmFye2Z1bmN0 aW9ufSBpcyBkZWZpbmVkIGluIHRoZQotZmlsZSBAdmFye2ZpbGV9LiAgVGhlIHRyYWlsaW5n IGFyZ3VtZW50cyBAdmFye2FyZ3N9IGNhbiBjb250YWluIG9uZSBvcgotdHdvIG9wdGlvbmFs IGFyZ3VtZW50cy4gIFRoZSBmaXJzdCBvcHRpb25hbCBhcmd1bWVudCBAdmFye2FyZ2xpc3R9 IGlzCi1laXRoZXIgQGNvZGV7dH0sIG1lYW5pbmcgdGhlIGFyZ3VtZW50IGxpc3QgaXMgdW5z cGVjaWZpZWQsIG9yIGEgbGlzdAotb2YgZm9ybWFsIHBhcmFtZXRlcnMgaW4gdGhlIHNhbWUg c3R5bGUgYXMgQGNvZGV7ZGVmdW59LkBmb290bm90ZXtBbgotb21pdHRlZCBAdmFye2FyZ2xp c3R9IGRlZmF1bHRzIHRvIEBjb2Rle3R9LCBub3QgQGNvZGV7bmlsfTsgdGhpcwotYXR5cGlj YWwgYmVoYXZpb3IgaXMgd2h5IEBjb2Rle2RlY2xhcmUtZnVuY3Rpb259IGlzIGRlZmluZWQg dG8gaGF2ZQotdGhlIGZvcm1hbCBwYXJhbWV0ZXJzIEBjb2RleyhmdW5jdGlvbiBmaWxlICZy ZXN0IGFyZ3MpfSwgbm90Ci1AY29kZXsoZnVuY3Rpb24gZmlsZSAmb3B0aW9uYWwgYXJnbGlz dCBmaWxlb25seSl9Ln0gIFRoZSBzZWNvbmQKLW9wdGlvbmFsIGFyZ3VtZW50IEB2YXJ7Zmls ZW9ubHl9IG5vbi1AY29kZXtuaWx9IG1lYW5zIG9ubHkgY2hlY2sgdGhhdAorZmlsZSBAdmFy e2ZpbGV9LiAgVGhlIG9wdGlvbmFsIHRoaXJkIGFyZ3VtZW50IEB2YXJ7YXJnbGlzdH0gaXMg ZWl0aGVyCitAY29kZXt0fSwgbWVhbmluZyB0aGUgYXJndW1lbnQgbGlzdCBpcyB1bnNwZWNp ZmllZCwgb3IgYSBsaXN0IG9mCitmb3JtYWwgcGFyYW1ldGVycyBpbiB0aGUgc2FtZSBzdHls ZSBhcyBAY29kZXtkZWZ1bn0uICBBbiBvbWl0dGVkCitAdmFye2FyZ2xpc3R9IGRlZmF1bHRz IHRvIEBjb2Rle3R9LCBub3QgQGNvZGV7bmlsfTsgdGhpcyBpcyBhdHlwaWNhbAorYmVoYXZp b3IgZm9yIG9taXR0ZWQgYXJndW1lbnRzLCBhbmQgaXQgbWVhbnMgdGhhdCB0byBzdXBwbHkg YSBmb3VydGgKK2J1dCBub3QgdGhpcmQgYXJndW1lbnQgb25lIG11c3Qgc3BlY2lmeSBAY29k ZXt0fSBmb3IgdGhlIHRoaXJkLWFyZ3VtZW50CitwbGFjZWhvbGRlciBpbnN0ZWFkIG9mIHRo ZSB1c3VhbCBAY29kZXtuaWx9LiAgVGhlIG9wdGlvbmFsIGZvdXJ0aAorYXJndW1lbnQgQHZh cntmaWxlb25seX0gbm9uLUBjb2Rle25pbH0gbWVhbnMgY2hlY2sgb25seSB0aGF0CiBAdmFy e2ZpbGV9IGV4aXN0cywgbm90IHRoYXQgaXQgYWN0dWFsbHkgZGVmaW5lcyBAdmFye2Z1bmN0 aW9ufS4KIEBlbmQgZGVmbWFjCiAKZGlmZiAtLWdpdCBhL2xpc3AvZW1hY3MtbGlzcC9ieXRl Y29tcC5lbCBiL2xpc3AvZW1hY3MtbGlzcC9ieXRlY29tcC5lbAppbmRleCAxMWViNDRjLi5k Yzc1NzRlIDEwMDY0NAotLS0gYS9saXNwL2VtYWNzLWxpc3AvYnl0ZWNvbXAuZWwKKysrIGIv bGlzcC9lbWFjcy1saXNwL2J5dGVjb21wLmVsCkBAIC0yOTU5LDYgKzI5NTksOCBAQCBieXRl LWNvbXBpbGUtdG9wLWxldmVsLWJvZHkKIAogOzsgU3BlY2lhbCBtYWNyby1leHBhbmRlciB1 c2VkIGR1cmluZyBieXRlLWNvbXBpbGF0aW9uLgogKGRlZnVuIGJ5dGUtY29tcGlsZS1tYWNy b2V4cGFuZC1kZWNsYXJlLWZ1bmN0aW9uIChmbiBmaWxlICZyZXN0IGFyZ3MpCisgIChkZWNs YXJlIChhZHZlcnRpc2VkLWNhbGxpbmctY29udmVudGlvbgorCSAgICAoZm4gZmlsZSAmb3B0 aW9uYWwgYXJnbGlzdCBmaWxlb25seSkgbmlsKSkKICAgKGxldCAoKGdvdGFyZ3MgKGFuZCAo Y29uc3AgYXJncykgKGxpc3RwIChjYXIgYXJncykpKSkKIAkodW5yZXNvbHZlZCAoYXNzcSBm biBieXRlLWNvbXBpbGUtdW5yZXNvbHZlZC1mdW5jdGlvbnMpKSkKICAgICAod2hlbiB1bnJl c29sdmVkCSAgICAgIDsgZnVuY3Rpb24gd2FzIGNhbGxlZCBiZWZvcmUgZGVjbGFyYXRpb24K ZGlmZiAtLWdpdCBhL2xpc3Avc3Vici5lbCBiL2xpc3Avc3Vici5lbAppbmRleCA5N2NkZTY4 Li42ZTY3OWU3IDEwMDY0NAotLS0gYS9saXNwL3N1YnIuZWwKKysrIGIvbGlzcC9zdWJyLmVs CkBAIC0zMyw4ICszMyw3IEBAIGRlY2xhcmUtZnVuY3Rpb24KICAgIlRlbGwgdGhlIGJ5dGUt Y29tcGlsZXIgdGhhdCBmdW5jdGlvbiBGTiBpcyBkZWZpbmVkLCBpbiBGSUxFLgogVGhlIEZJ TEUgYXJndW1lbnQgaXMgbm90IHVzZWQgYnkgdGhlIGJ5dGUtY29tcGlsZXIsIGJ1dCBieSB0 aGUKIGBjaGVjay1kZWNsYXJlJyBwYWNrYWdlLCB3aGljaCBjaGVja3MgdGhhdCBGSUxFIGNv bnRhaW5zIGEKLWRlZmluaXRpb24gZm9yIEZOLiAgUmVtYWluaW5nIEFSR1MgYXJlIHVzZWQg YnkgYm90aCB0aGUKLWJ5dGUtY29tcGlsZXIgYW5kIGBjaGVjay1kZWNsYXJlJyB0byBjaGVj ayBmb3IgY29uc2lzdGVuY3kuCitkZWZpbml0aW9uIGZvciBGTi4KIAogRklMRSBjYW4gYmUg ZWl0aGVyIGEgTGlzcCBmaWxlIChpbiB3aGljaCBjYXNlIHRoZSBcIi5lbFwiCiBleHRlbnNp b24gaXMgb3B0aW9uYWwpLCBvciBhIEMgZmlsZS4gIEMgZmlsZXMgYXJlIGV4cGFuZGVkCkBA IC00NSwyMCArNDQsMjIgQEAgZGVjbGFyZS1mdW5jdGlvbgogYGNoZWNrLWRlY2xhcmUnIHdp bGwgY2hlY2sgc3VjaCBmaWxlcyBpZiB0aGV5IGFyZSBmb3VuZCwgYW5kIHNraXAKIHRoZW0g d2l0aG91dCBlcnJvciBpZiB0aGV5IGFyZSBub3QuCiAKLUFSR1MgY2FuIGNvbnRhaW4gb25l IG9yIHR3byBvcHRpb25hbCBhcmdzLiAgRmlyc3Qgb3B0aW9uYWwgYXJnCi1BUkdMSVNUIHNw ZWNpZmllcyBGTidzIGFyZ3VtZW50cywgb3IgaXMgdCB0byBub3Qgc3BlY2lmeSBGTidzCi1h cmd1bWVudHMuICBBbiBvbWl0dGVkIEFSR0xJU1QgZGVmYXVsdHMgdG8gdCwgbm90IG5pbDog YSBuaWwKK09wdGlvbmFsIEFSR0xJU1Qgc3BlY2lmaWVzIEZOJ3MgYXJndW1lbnRzLCBvciBp cyB0IHRvIG5vdCBzcGVjaWZ5CitGTidzIGFyZ3VtZW50cy4gIEFuIG9taXR0ZWQgQVJHTElT VCBkZWZhdWx0cyB0byB0LCBub3QgbmlsOiBhIG5pbAogQVJHTElTVCBzcGVjaWZpZXMgYW4g ZW1wdHkgYXJndW1lbnQgbGlzdCwgYW5kIGFuIGV4cGxpY2l0IHQKIEFSR0xJU1QgaXMgYSBw bGFjZWhvbGRlciB0aGF0IGFsbG93cyBzdXBwbHlpbmcgYSBsYXRlciBhcmcuCi1TZWNvbmQg b3B0aW9uYWwgYXJnIEZJTEVPTkxZIG5vbi1uaWwgbWVhbnMgdGhhdCBgY2hlY2stZGVjbGFy ZScKLXdpbGwgY2hlY2sgb25seSB0aGF0IEZJTEUgZXhpc3RzLCBub3QgdGhhdCBpdCBkZWZp bmVzIEZOLiAgVGhpcwotaXMgaW50ZW5kZWQgZm9yIGZ1bmN0aW9uIGRlZmluaXRpb25zIHRo YXQgYGNoZWNrLWRlY2xhcmUnIGRvZXMKLW5vdCByZWNvZ25pemUsIGUuZy4sIGBkZWZzdHJ1 Y3QnLgorCitPcHRpb25hbCBGSUxFT05MWSBub24tbmlsIG1lYW5zIHRoYXQgYGNoZWNrLWRl Y2xhcmUnIHdpbGwgY2hlY2sKK29ubHkgdGhhdCBGSUxFIGV4aXN0cywgbm90IHRoYXQgaXQg ZGVmaW5lcyBGTi4gIFRoaXMgaXMgaW50ZW5kZWQKK2ZvciBmdW5jdGlvbiBkZWZpbml0aW9u cyB0aGF0IGBjaGVjay1kZWNsYXJlJyBkb2VzIG5vdCByZWNvZ25pemUsCitlLmcuLCBgZGVm c3RydWN0Jy4KIAogTm90ZSB0aGF0IGZvciB0aGUgcHVycG9zZXMgb2YgYGNoZWNrLWRlY2xh cmUnLCB0aGlzIHN0YXRlbWVudAogbXVzdCBiZSB0aGUgZmlyc3Qgbm9uLXdoaXRlc3BhY2Ug b24gYSBsaW5lLgogCiBGb3IgbW9yZSBpbmZvcm1hdGlvbiwgc2VlIEluZm8gbm9kZSBgKGVs aXNwKURlY2xhcmluZyBGdW5jdGlvbnMnLiIKKyAgKGRlY2xhcmUgKGFkdmVydGlzZWQtY2Fs bGluZy1jb252ZW50aW9uCisJICAgIChmbiBmaWxlICZvcHRpb25hbCBhcmdsaXN0IGZpbGVv bmx5KSBuaWwpKQogICA7OyBEb2VzIG5vdGhpbmcgLSBieXRlLWNvbXBpbGUtZGVjbGFyZS1m dW5jdGlvbiBkb2VzIHRoZSB3b3JrLgogICBuaWwpCiAKLS0gCjIuNS41Cgo= --------------030807070008080005000309--