git: 45438f9c8b5b - main - find: Add a warning about -delete.

The branch main has been updated by des:

URL: https://cgit.FreeBSD.org/src/commit/?id=45438f9c8b5b91ebf5606b4a98e891559913d25b

commit 45438f9c8b5b91ebf5606b4a98e891559913d25b
Author:     Dag-Erling Smørgrav <des@FreeBSD.org>
AuthorDate: 2023-12-21 23:41:05 +0000
Commit:     Dag-Erling Smørgrav <des@FreeBSD.org>
CommitDate: 2023-12-21 23:41:16 +0000

    find: Add a warning about -delete.
    
    MFC after:      1 week
    Sponsored by:   Klara, Inc.
    Reviewed by:    pauamma_gundo.com
    Differential Revision:  https://reviews.freebsd.org/D43162
---
 usr.bin/find/find.1 | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/usr.bin/find/find.1 b/usr.bin/find/find.1
index 80cb175c550d..de16b012ce4d 100644
--- a/usr.bin/find/find.1
+++ b/usr.bin/find/find.1
@@ -28,7 +28,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd January 23, 2023
+.Dd December 22, 2023
 .Dt FIND 1
 .Os
 .Sh NAME
@@ -347,6 +347,22 @@ The
 .Ic -delete
 primary will fail to delete a directory if it is not empty.
 Following symlinks is incompatible with this option.
+.Pp
+.Em WARNING :
+The
+.Ic -delete
+primary will immediately attempt to delete the current path when
+evaluated.
+Be mindful of its place in the expression; as a general rule, it
+should almost always come last.
+If in doubt, try running with
+.Ic -print
+in place of
+.Ic -delete
+first.
+See
+.Sx OPERATORS
+below for additional information on the order of evaluation.
 .It Ic -depth
 Always true;
 same as the non-portable