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
This commit is contained in:
Dag-Erling Smørgrav 2023-12-22 00:41:05 +01:00
parent dc0b4094ab
commit 45438f9c8b

View file

@ -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