Print this page
12328 FNMPERIOD makes little sense for find -path

@@ -43,16 +43,16 @@
 .\" Copyright 1989 AT&T
 .\" Portions Copyright (c) 1992, X/Open Company Limited All Rights Reserved
 .\" Copyright (c) 2008, Sun Microsystems, Inc. All Rights Reserved
 .\" Copyright 2011 Nexenta Systems, Inc. All rights reserved.
 .\" Copyright (c) 2013 Andrew Stormont.  All rights reserved.
+.\" Copyright 2020 Joyent, Inc.
 .\"
-.TH FIND 1 "Sep 5, 2011"
+.TH FIND 1 "Feb 20, 2020"
 .SH NAME
 find \- find files
 .SH SYNOPSIS
-.LP
 .nf
 \fB/usr/bin/find\fR [\fB-E\fR] [\fB-H\fR | \fB-L\fR] \fIpath\fR... \fIexpression\fR
 .fi
 
 .LP

@@ -59,11 +59,10 @@
 .nf
 \fB/usr/xpg4/bin/find\fR [\fB-H\fR | \fB-L\fR] \fIpath\fR... \fIexpression\fR
 .fi
 
 .SH DESCRIPTION
-.LP
 The \fBfind\fR utility recursively descends the directory hierarchy for each
 \fIpath\fR seeking files that match a Boolean \fIexpression\fR written in the
 primaries specified below.
 .sp
 .LP

@@ -73,11 +72,10 @@
 .sp
 .LP
 \fBfind\fR detects infinite loops; that is, entering a previously visited
 directory that is an ancestor of the last file encountered.
 .SH OPTIONS
-.LP
 The following options are supported:
 .sp
 .ne 2
 .na
 \fB\fB-E\fR\fR

@@ -115,11 +113,10 @@
 .LP
 Specifying more than one of the mutually-exclusive options \fB-H\fR and
 \fB-L\fR is not considered an error. The last option specified determines the
 behavior of the utility.
 .SH OPERANDS
-.LP
 The following operands are supported:
 .sp
 .ne 2
 .na
 \fB\fIpath\fR\fR

@@ -167,11 +164,10 @@
 .RE
 
 .RE
 
 .SS "Expressions"
-.LP
 Valid expressions are:
 .sp
 .ne 2
 .na
 \fB\fB-acl\fR\fR

@@ -547,11 +543,12 @@
 .ne 2
 .na
 \fB\fB-path\fR\fR
 .ad
 .RS 17n
-Like \fB-name\fR, but matches the entire file path and not just basename.
+Like \fB-name\fR, but matches the entire file path and not just basename, and
+without any special treatment of leading periods.
 .RE
 
 .sp
 .ne 2
 .na

@@ -715,11 +712,10 @@
 .RS 17n
 True if the file has extended attributes.
 .RE
 
 .SS "Complex Expressions"
-.LP
 The primaries can be combined using the following operators (in order of
 decreasing precedence):
 .sp
 .ne 2
 .na

@@ -781,15 +777,13 @@
 .LP
 The \fB-user\fR, \fB-group\fR, and \fB-newer\fR primaries each evaluate their
 respective arguments only once. Invocation of \fIcommand\fR specified by
 \fB-exec\fR or \fB-ok\fR does not affect subsequent primaries on the same file.
 .SH USAGE
-.LP
 See \fBlargefile\fR(5) for the description of the behavior of \fBfind\fR when
 encountering files greater than or equal to 2 Gbyte (2^31 bytes).
 .SH EXAMPLES
-.LP
 \fBExample 1 \fRWriting Out the Hierarchy Directory
 .sp
 .LP
 The following commands are equivalent:
 

@@ -955,11 +949,10 @@
 .fi
 .in -2
 .sp
 
 .SH ENVIRONMENT VARIABLES
-.LP
 See \fBenviron\fR(5) for descriptions of the following environment variables
 that affect the execution of \fBfind\fR: \fBLANG\fR, \fBLC_ALL\fR,
 \fBLC_COLLATE\fR, \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
 .sp
 .ne 2

@@ -980,11 +973,10 @@
 elements used in the expression defined for \fByesexpr\fR. The locale specified
 in \fBLC_CTYPE\fR determines the locale for interpretation of sequences of
 bytes of text data a characters, the behavior of character classes used in the
 expression defined for the \fByesexpr\fR. See \fBlocale\fR(5).
 .SH EXIT STATUS
-.LP
 The following exit values are returned:
 .sp
 .ne 2
 .na
 \fB\fB0\fR\fR

@@ -1028,11 +1020,10 @@
 .RS 20n
 File that registers distributed file system packages
 .RE
 
 .SH ATTRIBUTES
-.LP
 See \fBattributes\fR(5) for descriptions of the following attributes:
 .sp
 
 .sp
 .TS

@@ -1047,17 +1038,15 @@
 _
 Standard        See \fBstandards\fR(5).
 .TE
 
 .SH SEE ALSO
-.LP
 \fBchmod\fR(1), \fBcpio\fR(1), \fBsh\fR(1), \fBtest\fR(1), \fBls\fR(1B),
 \fBacl\fR(5), \fBregex\fR(5), \fBstat\fR(2), \fBumask\fR(2),
 \fBattributes\fR(5), \fBenviron\fR(5), \fBfsattr\fR(5), \fBlargefile\fR(5),
 \fBlocale\fR(5), \fBstandards\fR(5)
 .SH WARNINGS
-.LP
 The following options are obsolete and will not be supported in future
 releases:
 .sp
 .ne 2
 .na

@@ -1077,11 +1066,10 @@
 Always true. Writes the current file on \fIdevice\fR in \fBcpio\fR \fB-c\fR
 format (5120-byte records).
 .RE
 
 .SH NOTES
-.LP
 When using \fBfind\fR to determine files modified within a range of time, use
 the \fB-mtime\fR argument \fBbefore\fR the \fB-print\fR argument. Otherwise,
 \fBfind\fR gives all files.
 .sp
 .LP