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,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.4 Received: (qmail 8797 invoked from network); 23 Apr 2021 20:52:11 -0000 Received: from zero.zsh.org (2a02:898:31:0:48:4558:7a:7368) by inbox.vuxu.org with ESMTPUTF8; 23 Apr 2021 20:52:11 -0000 ARC-Seal: i=1; cv=none; a=rsa-sha256; d=zsh.org; s=rsa-20200801; t=1619211131; b=p73FoAIJ02PfXqE56e+xmB4lMuob8fbpOLbp0dT6J9QoYmPxS6vTZKConAoVV6QdJdHkxfuhT2 iCLFVNz+WdGv3HajOHu1wBDR+R3kAYqJax975bYwwEi8ia4iDtFYNomv32ZJRMNRXNsRL6isp/ oboyb4vcMPyNzi+oRmcAjMNRxKFxU6BiaJCsnIKjvCnahA60romzjvzgK0mg8fjkKGGd+M8gFU Pbvi8+J5QZE1gQtNmdbEVzPwFjCOXtUzbr3IK4OoEK4ruDouQw7St2xGgTuohFmA57F68tdtww 7Yh1kq+wFt9DEdNipYKfiCTSaT6SniVzzrw9cPRpz0Ojmg==; ARC-Authentication-Results: i=1; zsh.org; iprev=pass (mail-ot1-f46.google.com) smtp.remote-ip=209.85.210.46; dkim=pass header.d=brasslantern-com.20150623.gappssmtp.com header.s=20150623 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-20200801; t=1619211131; bh=T5NmNb5mThnujq6yR7bN3PORibj8AXhx0ipLqSa/1Hc=; h=List-Archive:List-Owner:List-Post:List-Unsubscribe:List-Subscribe:List-Help: List-Id:Sender:Content-Type:Cc:To:Subject:Message-ID:Date:From:In-Reply-To: References:MIME-Version:DKIM-Signature:DKIM-Signature; b=yN/2yrW0kp+Qqv3WdquZybyQX0iixeI2p3Z4Krs7Z9lEjwfIl36208WgSrixPtB8rUEomIsL6+ ciewEefrPKmZdC57p1G1ZCCZgZ0lUiWUedY0YQkOOBnGsxQQxuhzBkH3cl8Up68xoBNWQWCXst sKrXfqTp6+L4AF5wX7YSsJBHX+R87xsfXdLT11RpCyYieq5t/MzPDZXdGW0aDpZVYQthalsWpK yF5V0VGcppOPCC/HbruXaClEKhVkS398ADZffyBhngtLp0RV8VN7ojmdXnJ0vp2U2zc75xh2Jq SygigKzxaMMWEak27lljUygghrGJcqIJtdtXvLIovQHUuQ==; DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=zsh.org; s=rsa-20200801; h=List-Archive:List-Owner:List-Post:List-Unsubscribe: List-Subscribe:List-Help:List-Id:Sender:Content-Type:Cc:To:Subject:Message-ID :Date:From:In-Reply-To:References:MIME-Version:Reply-To: Content-Transfer-Encoding:Content-ID:Content-Description:Resent-Date: Resent-From:Resent-Sender:Resent-To:Resent-Cc:Resent-Message-ID; bh=K8a5rXOt8jhXmGIE4zPz4nU7APXgTTINiZlWlDuz6h8=; b=JSEMMyyrus9MA2yxxGHxJ99K+z qLtXmplacx5DKGtdmGrGxXn3eN7cOcBoOtgowYFY2kTBP9APChIciBY+7Fi3clDWk3pnMy/xQNN3D 8h9BY3Gnvm5tIg0CF3sazT2c4qZG3/OWqCXPtWz/Iv42y21jYZBnDL9PeSvcDLZZKx1jPXK7KYwlF q1hciQ4uIySEm6I8tTsD8LtOMNqid3fFw2ClFSI7xDl3ixeE3kSn5TXm37r1hSZ1hbfesG6zo+3sV KkTXKH5j/QFLbvii0VwAGCOY5tYp0gPm7Z3VX1SlCfsoL6HNNjaCPr2rOAGs4Wgj1kJszyYpfV/d2 IjRNiTTA==; Received: from authenticated user by zero.zsh.org with local id 1la2mX-000Ehs-C7; Fri, 23 Apr 2021 20:52:09 +0000 Authentication-Results: zsh.org; iprev=pass (mail-ot1-f46.google.com) smtp.remote-ip=209.85.210.46; dkim=pass header.d=brasslantern-com.20150623.gappssmtp.com header.s=20150623 header.a=rsa-sha256; dmarc=none header.from=brasslantern.com; arc=none Received: from mail-ot1-f46.google.com ([209.85.210.46]:34579) by zero.zsh.org with esmtps (TLS1.3:TLS_AES_128_GCM_SHA256:128) id 1la2mM-000ESf-9t; Fri, 23 Apr 2021 20:51:59 +0000 Received: by mail-ot1-f46.google.com with SMTP id k14-20020a9d7dce0000b02901b866632f29so46414314otn.1 for ; Fri, 23 Apr 2021 13:51:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=brasslantern-com.20150623.gappssmtp.com; s=20150623; h=mime-version:references:in-reply-to:from:date:message-id:subject:to :cc; bh=K8a5rXOt8jhXmGIE4zPz4nU7APXgTTINiZlWlDuz6h8=; b=otWiCZzhgD+ugKNaccmBYqPvRqZRBxQybh099ckM/9vmptSpDVbxYXqb+By6mo6EYP O6SNV0IWXBSSogW0nZkRlhppjcxmhWXpz4/mxKd3WDsJbWoR5jKF9XMm52kVQbI799XQ PxEVwu1ef7AuPjJbU4NmVfO24vkXPCrLU3q46GgKzQaUD+KAm8YlCtE37RWhtopRssDm ZLSogbbe5SQNqN2tP2iIX3TjVyYDPe3wiLuZmIb4pQXmBCBfSaYY3Fo5FE7myBgEDvYL 62YEoZRC0g6nfWCEu2o76GQffmKkJakmvOTvaSUjrIK/KQbPPTXMefh+Aw5MSzOZCrF8 +LmA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:mime-version:references:in-reply-to:from:date :message-id:subject:to:cc; bh=K8a5rXOt8jhXmGIE4zPz4nU7APXgTTINiZlWlDuz6h8=; b=dfLNu06o+DBEsNXeJeav/M4PGc+4LltZmJw7ELNkBtwUCbMeOU6b7CxSlV4G1m+F1k dNZFMyVXPkwkMTc64vYTx7HOaFztcY0mh1BLBSzQB2u+xwkPvenjJ953F5E6uFd+P/Mq 8ltvVIflUuQAtxvrRzJpsbC9aBBrcRIIfxFLTrUmKO2sGgKww5SfTXbHRPs5pJYQgHed em4Cyc6B3+kleZE9pB43+E3TOht00sbldIybyGbyGh+ulEqfXj3bsevXFXnNzp/C7kG3 gEguAVHLgG8KC8b7TzpzwKdn7LA6BLMzK27lsUZLNyCHP4E4f9h6xsz2ceTC8kZktM72 KlEw== X-Gm-Message-State: AOAM5305YufWNTYExefGmEzeJA1TmCuVPh5LdrttT9y0iuDYITSVus5R Bx62AAy1yYDZF0wocgVVtE78hUTHmbzDsTO9H/3OGEUT4a+2Ew== X-Google-Smtp-Source: ABdhPJycBV0dDiifnY3OQu+8+BKzw2wAAatO0gBYThPkzP9lVs+c64AGC5iIIdZaJc+sG7a2nLwBKzDMVIY8M5zS5CQ= X-Received: by 2002:a9d:a4e:: with SMTP id 72mr4784665otg.229.1619211116717; Fri, 23 Apr 2021 13:51:56 -0700 (PDT) MIME-Version: 1.0 References: <20210411141520.4ABA89D5@volny.cz> <20210413155236.GR6819@tarpaulin.shahaf.local2> <20210413200341.D91B3837@volny.cz> <20210414110355.GA31655@tarpaulin.shahaf.local2> <20210414134033.1AB3540B@volny.cz> <20210423141844.D01FC4C9@volny.cz> In-Reply-To: <20210423141844.D01FC4C9@volny.cz> From: Bart Schaefer Date: Fri, 23 Apr 2021 13:51:45 -0700 Message-ID: Subject: Re: revised patch: zshmisc(1) clarify non-successful exit statuses To: Zsh hackers list Cc: zeurkous@volny.cz Content-Type: text/plain; charset="UTF-8" X-Seq: 48675 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: On Fri, Apr 23, 2021 at 5:19 AM wrote: > > vindex(path, use of) > Otherwise, the shell searches each element of tt($path) for a > -directory containing an executable file by that name. If the > -search is unsuccessful, the shell prints an error message and returns > -a nonzero exit status. > +directory containing an executable file by that name. I would leave this paragraph unchanged. It's not necessary to delete the reference to "a nonzero exit status" in order to later explain what the nonzero values are. > +If execution fails: an error message is printed, and one of the > +following values is returned. I would move this along with the sitem list to the very end, to follow the paragraph about the command_not_found handler. Then change "If execution fails:" to "When there is no handler and execution fails,". > +startsitem() > +sitem(127) > +The search was unsuccessful. The error message is > +`tt(command not found:) var(cmd)'. As Daniel mentioned, this should be sitem(127)(Your new text goes here)