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.3 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, 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 15783 invoked from network); 9 Jun 2022 04:40:08 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 9 Jun 2022 04:40:08 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20210803; t=1654749608; b=RfGR48xmz4j7+Rtv+/gEe6vRisZdWCZgohrhpoqZCHRK0OLwCn3xD/rrgr3+THVmalXf58WCGb R9mWm1dPFa5VGO73WfUM63MPpacCEFHcoGBDwbMMsspeE2y0+RyQVVDhbvAXYEn3shQaBvKE5G RmPWlIHusj8vxlxJrZJU2DRGHU29cToCxbrZErhR98uPZK1YXtKzTArePeC77Mwi3EZG0p4OGh xpL/YL8tdQPcGwfOU4rTSyHRgXj8ab92fXut2kflBXWOC1PNRrV4h0YXppg1ZX2nyhR4SdEa1U urPxWSAMLSXccquV9hyxsElpKKzlIggX5my1DbFaXHt7/w==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-ej1-f54.google.com) smtp.remote-ip=209.85.218.54; dkim=pass header.d=brasslantern-com.20210112.gappssmtp.com header.s=20210112 header.a=rsa-sha256; dmarc=none header.from=brasslantern.com; arc=none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed; d=zsh.org; s=rsa-20210803; t=1654749608; bh=5bLl1oStxSh5/AywTICZnMGgTS/czgfkhGVzi7VmjTw=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Type:To:Subject:Message-ID:Date:From:MIME-Version: DKIM-Signature:DKIM-Signature; b=EYDctT2HmXIGcn8OqTZSyYgDGitrkwn7gwY8gtm1S8f9QrE4ipOJixVo0Zh8zXjNej03EanJjM mf5q/680qFhnMyWE7mwGlfzLt0nFYJAxjFX5NBfkVPuwf5ZIkYdt/w34kU9qMfdN+dNz5EGOOi FUy1rcsqV9GNQjWLZsVWnxtc57yj1B0nDiBnxCXDOwwwSHoGtnQK63E5GsCmH3oRwH70dC1ptc mFcoUJMLKMAdLEwAHnKvZ3778HYl2uobKXWBC0yn/sX1ubVCGsRLLnrf3g+qpeZgsPWqFtuUUb PCnJlKxPS8yxBO7zMbgYSceCAuce6FBzp7WS1iUyNgJdPQ==; 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:To:Subject:Message-ID: Date:From:MIME-Version: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=gb68k2rBH5BGyisjnaP6hfTl2nzYhnmL9NyMylONwOw=; b=hzD2vAvbAfsul9I7HKWzI0n1xj j7vPA1e/AzSvyc54oTlHlOwwSwRPnlWYfPp1jRMyOQGhSdFvNPP7yuQs1AufHWbHDhSlKST73d7tI EVOmLmWOjffcQ3EwCI8B/c/ZxUuEIAclZr60URvh8kwlg1HrKM4dDWc+8h2leO2aYWsgISOfebU/X E74jST0G7yHJkyozxFVUuNqDimBaJUk0Hi79VOiwvxfdDr3m7cicEnLMi6wk4AXE4TnQiDNs1CqKi j77NNydx1PxFIlgY0MiRMrRE/VaLF4xn2jLQmAS3g4ByfcMWfVHUTy2oRGv/SD2eytS5eXL8Fwp2X +pQdDX6w==; Received: from authenticated user by zero.zsh.org with local id 1nz9xo-000L6s-5k; Thu, 09 Jun 2022 04:40:08 +0000 Authentication-Results: zsh.org; iprev=pass (mail-ej1-f54.google.com) smtp.remote-ip=209.85.218.54; dkim=pass header.d=brasslantern-com.20210112.gappssmtp.com header.s=20210112 header.a=rsa-sha256; dmarc=none header.from=brasslantern.com; arc=none Received: from mail-ej1-f54.google.com ([209.85.218.54]:45917) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1nz9wr-000Kml-3B; Thu, 09 Jun 2022 04:39:10 +0000 Received: by mail-ej1-f54.google.com with SMTP id h23so34064387ejj.12 for ; Wed, 08 Jun 2022 21:39:09 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=brasslantern-com.20210112.gappssmtp.com; s=20210112; h=mime-version:from:date:message-id:subject:to; bh=gb68k2rBH5BGyisjnaP6hfTl2nzYhnmL9NyMylONwOw=; b=MvUuvFP+kyqxVrl0WN1gMXhXj7lUJHtCn3YZ6nCBXxVr4sMcNkUmap9TKcZUjB1pQN zz6ELUZ6U1B0FUAim/ZPSBAa12nXVSI58Vo/K7MJEVFiP8Gpm1eKcw+1VIZKb9cXRkoL gGIHwZs01FPQU/At0quc+Cr/URswilMMHJzOhA+dNBYVNWBzZHnf81D0AdgjPEkdxjCO /xhypwRPjDAvkkwpc4UGNgFpXMILegqpiuP85/aEZjeB/xLd02UdaQUnAwUDkn3B8GZW YuPaM2fQXM4QARLF2g9x16+BAQ9XBXgE2LPuy+ZBezsAi7irjoTQFl018Nr7yV7g/fUC 703g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=x-gm-message-state:mime-version:from:date:message-id:subject:to; bh=gb68k2rBH5BGyisjnaP6hfTl2nzYhnmL9NyMylONwOw=; b=g9TAAqw1c6nQnzA+c31LLkqgg53dwgyEa6tzY4YySl/omjsEy8JE+zhD0Qw8NdqZLQ LIsuEppvgS7ty93nd2rSHNbskyvE39C9agxjjsLUbItd4eGfEhGvK81R+AU3QfDk4N9K YlilJ5MjfRVFe0aBZoH+eWILNkihc+7OVI2GhqiXrMhN2saJcF0dm3dYlmozhvnGqTdf HKNNisbWuBx3JPiShzDHFlJ1tXhbQE35pBcXRjwJQNsY6m412cy7gryI4/QsIUzXbcNM aR/Z0jQefphBTAuKNFZwmDsemgNyFVnnZk0mjmyDMhasbSmM5oHQcAnkVFofFLiwmMa8 OMuw== X-Gm-Message-State: AOAM530ovfSDv61XlrSJbUXc52Bs+z4rHUp+YlIJjlHowsiixQBHjUK/ VwagY9J7xL0XYDJtCsOmUfBHkmA/B9zPMkH1yRp6dpwthCg= X-Google-Smtp-Source: ABdhPJwB1uKjZzejHcVMVsQNAVGGO2l0Su9ze5Onq0DwgpsPYakx35ybwbRJdB7X+pFa54VU7ZGLuQE5ZhQ6w3aqqO8= X-Received: by 2002:a17:907:7290:b0:6ff:1fa2:e9e3 with SMTP id dt16-20020a170907729000b006ff1fa2e9e3mr33932474ejc.345.1654749548503; Wed, 08 Jun 2022 21:39:08 -0700 (PDT) MIME-Version: 1.0 From: Bart Schaefer Date: Wed, 8 Jun 2022 21:38:57 -0700 Message-ID: Subject: [PATCH] documentation and return status consistency in zsh/system module To: Zsh hackers list Content-Type: multipart/mixed; boundary="00000000000008122205e0fc67fe" X-Seq: 50355 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: --00000000000008122205e0fc67fe Content-Type: text/plain; charset="UTF-8" Had this tucked away labeled to-do post-release. Trying to clean up my local git clone. --00000000000008122205e0fc67fe Content-Type: text/plain; charset="US-ASCII"; name="zsystem.txt" Content-Disposition: attachment; filename="zsystem.txt" Content-Transfer-Encoding: base64 Content-ID: X-Attachment-Id: f_l46j50ma0 ZGlmZiAtLWdpdCBhL0RvYy9ac2gvbW9kX3N5c3RlbS55byBiL0RvYy9ac2gvbW9kX3N5c3RlbS55 bwppbmRleCA4ODRjM2U3NTMuLmUyNTIwMWZhYSAxMDA2NDQKLS0tIGEvRG9jL1pzaC9tb2Rfc3lz dGVtLnlvCisrKyBiL0RvYy9ac2gvbW9kX3N5c3RlbS55bwpAQCAtNzQsNiArNzQsMTEgQEAgdHJ1 bmNhdGUgZmlsZSB0byBzaXplIDAKICkKIGVuZGl0ZW0oKQogCitBIHJldHVybiBzdGF0dXMgb2Yg MCBpbmRpY2F0ZXMgdGhlIGRlc2NyaXB0b3Igd2FzIHN1Y2Nlc3NmdWxseSBvcGVuZWQsCitvdGhl cndpc2UgYW4gZXJyb3IgbWVzc2FnZSBpcyBwcmludGVkLCBhbmQgMSBpcyByZXR1cm5lZCBmb3Ig YW4gZXJyb3IKK2luIHRoZSBwYXJhbWV0ZXJzIHRvIHRoZSBjb21tYW5kLCBvciAyIGlzIHJldHVy bmVkIGZvciBhIHN5c3RlbSBlcnJvci4KK1RoZSBwYXJhbWV0ZXIgdHQoRVJSTk8pIGlzIG5vbnpl cm8gZm9yIHN5c3RlbSBlcnJvcnMuCisKIFRvIGNsb3NlIHRoZSBmaWxlLCB1c2Ugb25lIG9mIHRo ZSBmb2xsb3dpbmc6CiAKIGV4YW1wbGUodHQoZXhlYyB7KXZhcihmZCl0dCh9PCYtKQpAQCAtMTIz LDExICsxMjgsMTEgQEAgZXJyb3IgZm9yIHdoaWNoIGEgbWVzc2FnZSBpcyBwcmludGVkIHRvIHN0 YW5kYXJkIGVycm9yLgogKQogaXRlbSgyKSgKIFRoZXJlIHdhcyBhbiBlcnJvciBvbiB0aGUgcmVh ZCwgb3Igb24gcG9sbGluZyB0aGUgaW5wdXQgZmlsZSBkZXNjcmlwdG9yCi1mb3IgYSB0aW1lb3V0 LiAgVGhlIHBhcmFtZXRlciB0dChFUlJOTykgZ2l2ZXMgdGhlIGVycm9yLgorZm9yIGEgdGltZW91 dC4gIFRoZSBwYXJhbWV0ZXIgdHQoRVJSTk8pIGlkZW50aWZpZXMgdGhlIGVycm9yLgogKQogaXRl bSgzKSgKIERhdGEgd2VyZSBzdWNjZXNzZnVsbHkgcmVhZCwgYnV0IHRoZXJlIHdhcyBhbiBlcnJv ciB3cml0aW5nIHRoZW0KLXRvIHZhcihvdXRmZCkuICBUaGUgcGFyYW1ldGVyIHR0KEVSUk5PKSBn aXZlcyB0aGUgZXJyb3IuCit0byB2YXIob3V0ZmQpLiAgVGhlIHBhcmFtZXRlciB0dChFUlJOTykg aWRlbnRpZmllcyB0aGUgZXJyb3IuCiApCiBpdGVtKDQpKAogVGhlIGF0dGVtcHQgdG8gcmVhZCB0 aW1lZCBvdXQuICBOb3RlIHRoaXMgZG9lcyBub3Qgc2V0IHR0KEVSUk5PKSBhcyB0aGlzCkBAIC0x NDcsNiArMTUyLDExIEBAIGV4cHJlc3Npb24uIFRoZSB0dCgtdSkgb3B0aW9uIGFsbG93cyB0aGUg ZmlsZSBkZXNjcmlwdG9yIHRvIGJlIHNwZWNpZmllZC4gQnkKIGRlZmF1bHQgdGhlIG9mZnNldCBp cyBzcGVjaWZpZWQgcmVsYXRpdmUgdG8gdGhlIHN0YXJ0IG9yIHRoZSBmaWxlIGJ1dCwgd2l0aCB0 aGUKIHR0KC13KSBvcHRpb24sIGl0IGlzIHBvc3NpYmxlIHRvIHNwZWNpZnkgdGhhdCB0aGUgb2Zm c2V0IHNob3VsZCBiZSByZWxhdGl2ZSB0bwogdGhlIGN1cnJlbnQgcG9zaXRpb24gb3IgdGhlIGVu ZCBvZiB0aGUgZmlsZS4KKworVGhlIHJldHVybiBzdGF0dXMgbWF5IGJlIDAgZm9yIHN1Y2Nlc3Ms IDEgZm9yIGFuIGVycm9yIGluIHRoZSBwYXJhbWV0ZXJzCit0byB0aGUgY29tbWFuZCwgb3IgMiBm b3IgYW4gZXJyb3Igb24gdGhlIHNlZWs7IG5vIGVycm9yIG1lc3NhZ2UgaXMKK3ByaW50ZWQgaW4g dGhlIGxhc3QgY2FzZSwgYnV0IHRoZSBwYXJhbWV0ZXIgdHQoRVJSTk8pIHJlZmxlY3RzCit0aGUg ZXJyb3IgdGhhdCBvY2N1cnJlZC4KICkKIGl0ZW0odHQoc3lzd3JpdGUpIFsgdHQoLWMpIHZhcihj b3VudHZhcikgXSBbIHR0KC1vKSB2YXIob3V0ZmQpIF0gdmFyKGRhdGEpKSgKIFRoZSBkYXRhIChh IHNpbmdsZSBzdHJpbmcgb2YgYnl0ZXMpIGFyZSB3cml0dGVuIHRvIHRoZSBmaWxlIGRlc2NyaXB0 b3IKQEAgLTE2Niw3ICsxNzYsNyBAQCByZXR1cm5pbmcgZWFybHkuCiAKIFRoZSByZXR1cm4gc3Rh dHVzIG1heSBiZSAwIGZvciBzdWNjZXNzLCAxIGZvciBhbiBlcnJvciBpbiB0aGUgcGFyYW1ldGVy cwogdG8gdGhlIGNvbW1hbmQsIG9yIDIgZm9yIGFuIGVycm9yIG9uIHRoZSB3cml0ZTsgbm8gZXJy b3IgbWVzc2FnZSBpcwotcHJpbnRlZCBpbiB0aGUgbGFzdCBjYXNlLCBidXQgdGhlIHBhcmFtZXRl ciB0dChFUlJOTykgd2lsbCByZWZsZWN0CitwcmludGVkIGluIHRoZSBsYXN0IGNhc2UsIGJ1dCB0 aGUgcGFyYW1ldGVyIHR0KEVSUk5PKSByZWZsZWN0cwogdGhlIGVycm9yIHRoYXQgb2NjdXJyZWQu CiApCiB4aXRlbSh0dCh6c3lzdGVtIGZsb2NrKSBbIHR0KC10KSB2YXIodGltZW91dCkgXSBbIHR0 KC1pKSB2YXIoaW50ZXJ2YWwpIF0gWyB0dCgtZikgdmFyKHZhcikgXSBbdHQoLWVyKV0gdmFyKGZp bGUpKQpkaWZmIC0tZ2l0IGEvU3JjL01vZHVsZXMvc3lzdGVtLmMgYi9TcmMvTW9kdWxlcy9zeXN0 ZW0uYwppbmRleCBlYTExZWYwMzcuLjkyOWE4YjAwMiAxMDA2NDQKLS0tIGEvU3JjL01vZHVsZXMv c3lzdGVtLmMKKysrIGIvU3JjL01vZHVsZXMvc3lzdGVtLmMKQEAgLTc0LDYgKzc0LDggQEAgYmlu X3N5c3JlYWQoY2hhciAqbmFtLCBjaGFyICoqYXJncywgT3B0aW9ucyBvcHMsIFVOVVNFRChpbnQg ZnVuYykpCiAgICAgaW50IGluZmQgPSAwLCBvdXRmZCA9IC0xLCBidWZzaXplID0gU1lTUkVBRF9C VUZTSVpFLCBjb3VudDsKICAgICBjaGFyICpvdXR2YXIgPSBOVUxMLCAqY291bnR2YXIgPSBOVUxM LCAqaW5idWY7CiAKKyAgICBlcnJubyA9IDA7CS8qIERpc3Rpbmd1aXNoIG5vbi1zeXN0ZW0gZXJy b3JzICovCisKICAgICAvKiAtaTogaW5wdXQgZmlsZSBkZXNjcmlwdG9yIGlmIG5vdCBzdGRpbiAq LwogICAgIGlmIChPUFRfSVNTRVQob3BzLCAnaScpKSB7CiAJaW5mZCA9IGdldHBvc2ludChPUFRf QVJHKG9wcywgJ2knKSwgbmFtKTsKQEAgLTIzOCw2ICsyNDAsOCBAQCBiaW5fc3lzd3JpdGUoY2hh ciAqbmFtLCBjaGFyICoqYXJncywgT3B0aW9ucyBvcHMsIFVOVVNFRChpbnQgZnVuYykpCiAgICAg aW50IG91dGZkID0gMSwgbGVuLCBjb3VudCwgdG90Y291bnQ7CiAgICAgY2hhciAqY291bnR2YXIg PSBOVUxMOwogCisgICAgZXJybm8gPSAwOwkvKiBEaXN0aW5ndWlzaCBub24tc3lzdGVtIGVycm9y cyAqLworCiAgICAgLyogLW86IG91dHB1dCBmaWxlIGRlc2NyaXB0b3IgaWYgbm90IHN0ZG91dCAq LwogICAgIGlmIChPUFRfSVNTRVQob3BzLCAnbycpKSB7CiAJb3V0ZmQgPSBnZXRwb3NpbnQoT1BU X0FSRyhvcHMsICdvJyksIG5hbSk7CkBAIC0zMDMsNiArMzA3LDEzIEBAIHN0YXRpYyBzdHJ1Y3Qg eyBjb25zdCBjaGFyICpuYW1lOyBpbnQgb2ZsYWc7IH0gb3Blbm9wdHNbXSA9IHsKICAgICB7ICJ0 cnVuYyIsIE9fVFJVTkMgfQogfTsKIAorLyoKKyAqIFJldHVybiB2YWx1ZXMgb2YgYmluX3N5c29w ZW46CisgKgkwCVN1Y2Nlc3MKKyAqCTEJRXJyb3IgaW4gcGFyYW1ldGVycyB0byBjb21tYW5kCisg KgkyCUVycm9yIG9uIG9wZW4sIEVSUk5PIHNldCBieSBzeXN0ZW0KKyAqLworCiAvKiovCiBzdGF0 aWMgaW50CiBiaW5fc3lzb3BlbihjaGFyICpuYW0sIGNoYXIgKiphcmdzLCBPcHRpb25zIG9wcywg VU5VU0VEKGludCBmdW5jKSkKQEAgLTMxOSw2ICszMzAsOCBAQCBiaW5fc3lzb3BlbihjaGFyICpu YW0sIGNoYXIgKiphcmdzLCBPcHRpb25zIG9wcywgVU5VU0VEKGludCBmdW5jKSkKICAgICBpbnQg ZmRmbGFncyA9IDA7CiAjZW5kaWYKIAorICAgIGVycm5vID0gMDsJLyogRGlzdGluZ3Vpc2ggbm9u LXN5c3RlbSBlcnJvcnMgKi8KKwogICAgIGlmICghT1BUX0lTU0VUKG9wcywgJ3UnKSkgewogCXp3 YXJubmFtKG5hbSwgImZpbGUgZGVzY3JpcHRvciBub3Qgc3BlY2lmaWVkIik7CiAJcmV0dXJuIDE7 CkBAIC0zNzQsMTIgKzM4NywxMiBAQCBiaW5fc3lzb3BlbihjaGFyICpuYW0sIGNoYXIgKiphcmdz LCBPcHRpb25zIG9wcywgVU5VU0VEKGludCBmdW5jKSkKIAogICAgIGlmIChmZCA9PSAtMSkgewog CXp3YXJubmFtKG5hbSwgImNhbid0IG9wZW4gZmlsZSAlczogJWUiLCAqYXJncywgZXJybm8pOwot CXJldHVybiAxOworCXJldHVybiAyOwogICAgIH0KICAgICBtb3ZlZF9mZCA9IChleHBsaWNpdCA+ IC0xKSA/IHJlZHVwKGZkLCBleHBsaWNpdCkgOiBtb3ZlZmQoZmQpOwogICAgIGlmIChtb3ZlZF9m ZCA9PSAtMSkgewogCXp3YXJubmFtKG5hbSwgImNhbid0IG9wZW4gZmlsZSAlcyIsICphcmdzKTsK LQlyZXR1cm4gMTsKKwlyZXR1cm4gMjsKICAgICB9CiAKICNpZmRlZiBGRF9DTE9FWEVDCkBAIC00 MjMsNiArNDM2LDggQEAgYmluX3N5c3NlZWsoY2hhciAqbmFtLCBjaGFyICoqYXJncywgT3B0aW9u cyBvcHMsIFVOVVNFRChpbnQgZnVuYykpCiAgICAgY2hhciAqd2hlbmNlOwogICAgIG9mZl90IHBv czsKIAorICAgIGVycm5vID0gMDsJLyogRGlzdGluZ3Vpc2ggbm9uLXN5c3RlbSBlcnJvcnMgKi8K KwogICAgIC8qIC11OiAgZmlsZSBkZXNjcmlwdG9yIGlmIG5vdCBzdGRpbiAqLwogICAgIGlmIChP UFRfSVNTRVQob3BzLCAndScpKSB7CiAJZmQgPSBnZXRwb3NpbnQoT1BUX0FSRyhvcHMsICd1Jyks IG5hbSk7Cg== --00000000000008122205e0fc67fe--