Skip site navigation (1)Skip section navigation (2)
Date:      Thu, 27 Feb 2025 01:41:14 GMT
From:      Alexander Ziaee <ziaee@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org
Subject:   git: 77eacf827803 - stable/14 - sh.1: document optional arguments to `:`
Message-ID:  <202502270141.51R1fEeA008745@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch stable/14 has been updated by ziaee:

URL: https://cgit.FreeBSD.org/src/commit/?id=77eacf8278036353ead50e1317f8936dfc49186d

commit 77eacf8278036353ead50e1317f8936dfc49186d
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-01-09 17:51:57 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
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



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202502270141.51R1fEeA008745>