From owner-dev-commits-src-branches@freebsd.org Sun May 16 08:38:05 2021 Return-Path: Delivered-To: dev-commits-src-branches@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 0DD1163A6CA; Sun, 16 May 2021 08:38:05 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4FjbHw6zWcz4lVN; Sun, 16 May 2021 08:38:04 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 D8BC0158AA; Sun, 16 May 2021 08:38:04 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 14G8c49f021133; Sun, 16 May 2021 08:38:04 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 14G8c46K021132; Sun, 16 May 2021 08:38:04 GMT (envelope-from git) Date: Sun, 16 May 2021 08:38:04 GMT Message-Id: <202105160838.14G8c46K021132@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Gordon Bergling Subject: git: ed5c8820f478 - stable/12 - find(1): Document the -f option MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: gbe X-Git-Repository: src X-Git-Refname: refs/heads/stable/12 X-Git-Reftype: branch X-Git-Commit: ed5c8820f4786ddca97ef0411c133bccee2ddd85 Auto-Submitted: auto-generated X-BeenThere: dev-commits-src-branches@freebsd.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: Commits to the stable branches of the FreeBSD src repository List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sun, 16 May 2021 08:38:05 -0000 The branch stable/12 has been updated by gbe (doc committer): URL: https://cgit.FreeBSD.org/src/commit/?id=ed5c8820f4786ddca97ef0411c133bccee2ddd85 commit ed5c8820f4786ddca97ef0411c133bccee2ddd85 Author: Ceri Davies AuthorDate: 2021-05-13 08:10:22 +0000 Commit: Gordon Bergling CommitDate: 2021-05-16 08:37:47 +0000 find(1): Document the -f option PR: 223127 Reported by: Mathieu Arnold Reviewed by: bcr, gbe Differential Revision: https://reviews.freebsd.org/D30215 (cherry picked from commit 82483ea7adfe4213059f6dacf31f3bd1327b2cc0) --- usr.bin/find/find.1 | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/usr.bin/find/find.1 b/usr.bin/find/find.1 index 0c5c113479a3..8bc9f9d69604 100644 --- a/usr.bin/find/find.1 +++ b/usr.bin/find/find.1 @@ -31,7 +31,7 @@ .\" @(#)find.1 8.7 (Berkeley) 5/9/95 .\" $FreeBSD$ .\" -.Dd March 13, 2021 +.Dd May 13, 2021 .Dt FIND 1 .Os .Sh NAME @@ -135,6 +135,19 @@ primary specified by Refer to its description under .Sx PRIMARIES for more information. +.It Fl f Ar path +Add +.Ar path +to the list of paths that will be recursed into. +This is useful when +.Ar path +begins with a character that would otherwise be interpreted as an +.Ar expression , +namely +.Dq Li "!" , +.Dq Li "(" +and +.Dq Li - . .It Fl s Cause .Nm