From nobody Thu Feb 27 01:41:14 2025 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4Z3DZg4KVkz5pQfY; Thu, 27 Feb 2025 01:41:15 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4Z3DZf6WFpz4Km0; Thu, 27 Feb 2025 01:41:14 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1740620474; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=lgPS4N0dH1wzMFbbtgTNowVUl35XPFHw4N+xa2a0GXc=; b=txH07kOhnFwxS6xqI8lmQM2lT1ckykmfSQI3SrKft4Q5d4n8AtNO92AkDUWutZv/LZhA1s llOiqczXo2nrtoIBPQ/AH2YrOKLv+5Bbv2uydKUceJiRy2lOEiJDX//oJ4aceMwj43sOuW OAwlmuxyK/7BJGGXYZoBseEo5QA0pgvpqJ+W+ii+WI/lm7L/NcvutzuU09a+R8qPxTrMUi BvFf8bC7/EITvQ8rj9zwVJZa3c//wc4Fq3g41cRAus0HirBjggTdZRKqt1LPucZ+maBZoG gYFIhG5yekRzM4DbA8yxjk1VJ3Ob4N1xQMXWKFkZRVpV0WPVSNkXBjMvihIGdw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1740620474; a=rsa-sha256; cv=none; b=fwrAFQt0GG+GLKXUn1GQrMvTXifWYTerpnEbPovb9KReP8SLGdmLzFu2POVet1jacCmWx4 OtVjPqyf7Mxi86svVvcoQSKugJgWmqgxeG/SrvRw4uY71hCk7YqXyftcLvH3qKCP9LqKRr jZEQf7sNcjYdrCTf/DDQuQPVdIyqPPIJij5oXAqSOHMoBUbosClNgSpik3W3Xdjf+UXB84 bGtWw0qqjMTWFZNt+bq88p+jPv09G7mrDHYOjFItHcYTQj5iJy3v16GU7oUEm/19RjiWX5 ZX1w7Cdl8jSH+DFijBJcy/dHCdTIqFJfGRVyj1+Xyqe6uMlQtN33fm1QuDiBiQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1740620474; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=lgPS4N0dH1wzMFbbtgTNowVUl35XPFHw4N+xa2a0GXc=; b=HSBv5cRCMaqFklB3zGuAAHESryApA8m1Xu0U+HX2rrf7Zl5wspueHO/nMIlNkzf0xslR8E hVm8KnFZlg573SQIQun0Q5OLzOpmz6XLHWAy+A63SJcBmuJhdwTLFHO2Vki7oQJ8BfXpCE TauQS0WIUOq0EsaGu0wMgfp3bl9PFxkQ/8lwcXZrzgOAD79CHoHuV6k8e98QiPhMRz12v/ sDdrHpmOrj8ln6H9nAEY0p5qaYPBtovsgEyRiqDP6QRlcnif8nM3fqxggfG/xsPrtihZRF d0QazY4UEXXY657WyIbe//s1vu87l+ZVjNnCkypoQCyLTJf5UC4FlA1Skbs42A== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4Z3DZf64pQz5mt; Thu, 27 Feb 2025 01:41:14 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 51R1fEd0008748; Thu, 27 Feb 2025 01:41:14 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 51R1fEeA008745; Thu, 27 Feb 2025 01:41:14 GMT (envelope-from git) Date: Thu, 27 Feb 2025 01:41:14 GMT Message-Id: <202502270141.51R1fEeA008745@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: 77eacf827803 - stable/14 - sh.1: document optional arguments to `:` List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/stable/14 X-Git-Reftype: branch X-Git-Commit: 77eacf8278036353ead50e1317f8936dfc49186d Auto-Submitted: auto-generated The branch stable/14 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=77eacf8278036353ead50e1317f8936dfc49186d commit 77eacf8278036353ead50e1317f8936dfc49186d Author: Alexander Ziaee AuthorDate: 2025-01-09 17:51:57 +0000 Commit: Alexander Ziaee CommitDate: 2025-02-27 01:40:40 +0000 sh.1: document optional arguments to `:` TIL the `:` command accepts and discards arguments, and this is occasionally used to embed comments in interesting places. While here, fix another `...` argument that was not marked up. MFC after: 3 days Thanks: Community Discord Approved by: carlavilla, mhorne (mentors) Differential Revision: https://reviews.freebsd.org/D48398 (cherry picked from commit f4727eca405763dd1feb4ca3e17be40c2da337de) --- bin/sh/sh.1 | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/bin/sh/sh.1 b/bin/sh/sh.1 index b220cf550f52..a780d730642c 100644 --- a/bin/sh/sh.1 +++ b/bin/sh/sh.1 @@ -33,7 +33,7 @@ .\" .\" from: @(#)sh.1 8.6 (Berkeley) 5/4/95 .\" -.Dd November 20, 2024 +.Dd January 10, 2025 .Dt SH 1 .Os .Sh NAME @@ -1937,8 +1937,9 @@ make it the first or last character listed. .Ss Built-in Commands This section lists the built-in commands. .Bl -tag -width indent -.It Ic \&: +.It Ic \&: Op Ar arg Ar ... A null command that returns a 0 (true) exit value. +Any arguments are discarded. .It Ic \&. Ar file The commands in the specified file are read and executed by the shell. The @@ -1960,7 +1961,7 @@ it is sought in the current working directory. .It Ic \&[ A built-in equivalent of .Xr test 1 . -.It Ic alias Oo Ar name Ns Oo = Ns Ar string Oc ... Oc +.It Ic alias Oo Ar name Ns Oo = Ns Ar string Oc Ar ... Oc If .Ar name Ns = Ns Ar string is specified, the shell defines the alias