From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: zsh-workers-return-43528-ml=inbox.vuxu.org@zsh.org X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on inbox.vuxu.org X-Spam-Level: X-Spam-Status: No, score=-1.1 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,MAILING_LIST_MULTI,RCVD_IN_DNSWL_NONE autolearn=ham autolearn_force=no version=3.4.2 Received: from primenet.com.au (ns1.primenet.com.au [203.24.36.2]) by inbox.vuxu.org (OpenSMTPD) with ESMTP id 70b63e6c for ; Mon, 24 Sep 2018 13:22:29 +0000 (UTC) Received: (qmail 2916 invoked by alias); 24 Sep 2018 13:22:18 -0000 Mailing-List: contact zsh-workers-help@zsh.org; run by ezmlm Precedence: bulk X-No-Archive: yes List-Id: Zsh Workers List List-Post: List-Help: List-Unsubscribe: X-Seq: 43528 Received: (qmail 20456 invoked by uid 1010); 24 Sep 2018 13:22:18 -0000 X-Qmail-Scanner-Diagnostics: from wout2-smtp.messagingengine.com by f.primenet.com.au (envelope-from , uid 7791) with qmail-scanner-2.11 (clamdscan: 0.99.2/21882. spamassassin: 3.4.1. Clear:RC:0(64.147.123.25):SA:0(-1.1/5.0):. Processed in 3.105694 secs); 24 Sep 2018 13:22:18 -0000 X-Envelope-From: d.s@daniel.shahaf.name X-Qmail-Scanner-Mime-Attachments: | X-Qmail-Scanner-Zip-Files: | DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= daniel.shahaf.name; h=date:from:in-reply-to:message-id :references:subject:to:x-me-sender:x-me-sender:x-sasl-enc; s= fm1; bh=EeQb6Jwo5Iu4rVAL+d8CsxY1TR2CwtebZS5JhssO4SA=; b=WDThZlfC HvnORdKAvhhAJAsUr8HcE5PFKCWCS6339RkMEzaa+FWuKpnDaf3hsKdxTqCUSO6R bLPpZrixe/mlbM+/1PUVB4ZDU9VsGrqLyR3GUTQ4wWcWT8tbxA0hYll7wbKAA5Wp WyoQufdIYkmuJ4DTRXp+qB1qhOMnKVk5bZMAM9+DUaA5/1W55WAQA8Q8j/EnPmNp 6Tx/RuE7LrKdQ0XjkLs+l+8DDXFwMZ1erXG+SrXTlKYp7jCde25qySuXcmt/6DJ2 Kns6D8nsGrG21w95pKd8YxqkI3iJcNnVCPeErJA7Q0mGfDuE254HBISrdvfDY8or Bg8Ew2/baUsgow== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=date:from:in-reply-to:message-id :references:subject:to:x-me-sender:x-me-sender:x-sasl-enc; s= fm3; bh=EeQb6Jwo5Iu4rVAL+d8CsxY1TR2CwtebZS5JhssO4SA=; b=CRpanY+6 9wDOhkzgKh5kLjsHmWgWdp0818mvlK/Q1PIXWRMuel+VsraHUgQ2BKqsYLxsHd4R jGLxZElHOfOL+lnPgWZxk4pO8cqSUXuB0oNMjVWXM+GHv/mOadAPY4qB1ZyAoqt8 bqCT9KRHDIf4IkBa0P9eVKfmVC4EJsYuIEnicMHCw1aF496hWZg7tFADf+lryemt A8toU15ZxjBDEwgYndB93dSmsEZzQUtsCho2P8FBNJ6lZwktYJJih4YykeuF05J9 6x91fPTG+sU1mE9kAxyQUSVaZUyw+o5VST6vm1sYykQvFhXnhATfBrrG322fXE3v eRKL+omwxbYoqQ== X-ME-Proxy: X-ME-Sender: From: Daniel Shahaf To: zsh-workers@zsh.org Subject: [PATCH] zshbuiltins(1): Document 'which''s "not found is not an error" behaviour. Date: Mon, 24 Sep 2018 13:22:07 +0000 Message-Id: <20180924132207.25349-1-danielsh@tarpaulin.shahaf.local2> X-Mailer: git-send-email 2.11.0 In-Reply-To: <20180924125126eucas1p2e4ae5b63ce6320957ee99737f93181ae~XVwcoX7b91518615186eucas1p2T@eucas1p2.samsung.com> References: <20180924125126eucas1p2e4ae5b63ce6320957ee99737f93181ae~XVwcoX7b91518615186eucas1p2T@eucas1p2.samsung.com> --- Doc/Zsh/builtins.yo | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/Doc/Zsh/builtins.yo b/Doc/Zsh/builtins.yo index 76b593fd2..0141305b4 100644 --- a/Doc/Zsh/builtins.yo +++ b/Doc/Zsh/builtins.yo @@ -2373,6 +2373,12 @@ item(tt(whence) [ tt(-vcwfpamsS) ] [ tt(-x) var(num) ] var(name) ...)( For each var(name), indicate how it would be interpreted if used as a command name. +If var(name) is not an alias, built-in command, external command, shell +function, hashed command, or a reserved word, the exit status shall be +non-zero, and DASH()- if tt(-v), tt(-c), or tt(-w) was passed DASH()- a message +will be written to standard output. (This is different from other shells that +write that message to standard error.) + tt(whence) is most useful when var(name) is only the last path component of a command, i.e. does not include a `tt(/)'; in particular, pattern matching only succeeds if just the non-directory component of the command is