Lint most manpages

Reviewed-by: Richard Laager <[email protected]>
Reviewed-by: Brian Behlendorf <[email protected]>
Reviewed-by: Tony Nguyen <[email protected]>
Reviewed-by: Ryan Moeller <[email protected]>
Signed-off-by: Ahelenia Ziemiańska <[email protected]>
Closes #12129

1 files changed, 43 insertions, 55 deletions

diff --git a/man/man8/zfs-project.8 b/man/man8/zfs-project.8
index 21c300f83..f264a110f 100644
--- a/man/man8/zfs-project.8
+++ b/man/man8/zfs-project.8
@@ -18,7 +18,6 @@
 .\"
 .\" CDDL HEADER END
 .\"
-.\"
 .\" Copyright (c) 2009 Sun Microsystems, Inc. All Rights Reserved.
 .\" Copyright 2011 Joshua M. Clulow <[email protected]>
 .\" Copyright (c) 2011, 2019 by Delphix. All rights reserved.
@@ -30,68 +29,65 @@
 .\" Copyright 2018 Nexenta Systems, Inc.
 .\" Copyright 2019 Joyent, Inc.
 .\"
-.Dd June 30, 2019
+.Dd May 27, 2021
 .Dt ZFS-PROJECT 8
 .Os
+.
 .Sh NAME
 .Nm zfs-project
-.Nd List, set, or clear project ID and/or inherit flag on the file(s) or directories.
+.Nd manage projects in ZFS filesystem
 .Sh SYNOPSIS
 .Nm zfs
 .Cm project
 .Oo Fl d Ns | Ns Fl r Ns Oc
-.Ar file Ns | Ns Ar directory Ns ...
+.Ar file Ns | Ns Ar directory Ns …
 .Nm zfs
 .Cm project
 .Fl C
 .Oo Fl kr Ns Oc
-.Ar file Ns | Ns Ar directory Ns ...
+.Ar file Ns | Ns Ar directory Ns …
 .Nm zfs
 .Cm project
 .Fl c
 .Oo Fl 0 Ns Oc
 .Oo Fl d Ns | Ns Fl r Ns Oc
 .Op Fl p Ar id
-.Ar file Ns | Ns Ar directory Ns ...
+.Ar file Ns | Ns Ar directory Ns …
 .Nm zfs
 .Cm project
 .Op Fl p Ar id
 .Oo Fl rs Ns Oc
-.Ar file Ns | Ns Ar directory Ns ...
+.Ar file Ns | Ns Ar directory Ns …
+.
 .Sh DESCRIPTION
 .Bl -tag -width ""
 .It Xo
 .Nm zfs
 .Cm project
 .Oo Fl d Ns | Ns Fl r Ns Oc
-.Ar file Ns | Ns Ar directory Ns ...
+.Ar file Ns | Ns Ar directory Ns …
 .Xc
-List project identifier (ID) and inherit flag of file(s) or directories.
+List project identifier (ID) and inherit flag of files and directories.
 .Bl -tag -width "-d"
 .It Fl d
-Show the directory project ID and inherit flag, not its children. It will
-overwrite the former specified
-.Fl r
-option.
+Show the directory project ID and inherit flag, not its children.
 .It Fl r
-Show on subdirectories recursively. It will overwrite the former specified
-.Fl d
-option.
+List subdirectories recursively.
 .El
 .It Xo
 .Nm zfs
 .Cm project
 .Fl C
 .Oo Fl kr Ns Oc
-.Ar file Ns | Ns Ar directory Ns ...
+.Ar file Ns | Ns Ar directory Ns …
 .Xc
-Clear project inherit flag and/or ID on the file(s) or directories.
+Clear project inherit flag and/or ID on the files and directories.
 .Bl -tag -width "-k"
 .It Fl k
-Keep the project ID unchanged. If not specified, the project ID will be reset
-as zero.
+Keep the project ID unchanged.
+If not specified, the project ID will be reset to zero.
 .It Fl r
-Clear on subdirectories recursively.
+Clear subdirectories' flags recursively.
 .El
 .It Xo
 .Nm zfs
@@ -100,54 +96,46 @@ Clear on subdirectories recursively.
 .Oo Fl 0 Ns Oc
 .Oo Fl d Ns | Ns Fl r Ns Oc
 .Op Fl p Ar id
-.Ar file Ns | Ns Ar directory Ns ...
+.Ar file Ns | Ns Ar directory Ns …
 .Xc
-Check project ID and inherit flag on the file(s) or directories, report the
-entries without project inherit flag or with different project IDs from the
-specified (via
-.Fl p
-option) value or the target directory's project ID.
-.Bl -tag -width "-0"
+Check project ID and inherit flag on the files and directories:
+report entries without the project inherit flag, or with project IDs different from the
+target directory's project ID or the one specified with
+.Fl p .
+.Bl -tag -width "-p id"
 .It Fl 0
-Print file name with a trailing NUL instead of newline (by default), like
-"find -print0".
+Delimit filenames with a NUL byte instead of newline.
 .It Fl d
-Check the directory project ID and inherit flag, not its children. It will
-overwrite the former specified
-.Fl r
-option.
-.It Fl p
-Specify the referenced ID for comparing with the target file(s) or directories'
-project IDs. If not specified, the target (top) directory's project ID will be
-used as the referenced one.
+Check the directory project ID and inherit flag, not its children.
+.It Fl p Ar id
+Compare to
+.Ar id
+instead of the target files and directories' project IDs.
 .It Fl r
-Check on subdirectories recursively. It will overwrite the former specified
-.Fl d
-option.
+Check subdirectories recursively.
 .El
 .It Xo
 .Nm zfs
 .Cm project
-.Op Fl p Ar id
+.Fl p Ar id
 .Oo Fl rs Ns Oc
-.Ar file Ns | Ns Ar directory Ns ...
+.Ar file Ns | Ns Ar directory Ns …
 .Xc
-Set project ID and/or inherit flag on the file(s) or directories.
-.Bl -tag -width "-p"
-.It Fl p
-Set the file(s)' or directories' project ID with the given value.
+Set project ID and/or inherit flag on the files and directories.
+.Bl -tag -width "-p id"
+.It Fl p Ar id
+Set the project ID to the given value.
 .It Fl r
 Set on subdirectories recursively.
 .It Fl s
-Set project inherit flag on the given file(s) or directories. It is usually used
-for setup tree quota on the directory target with
-.Fl r
-option specified together. When setup tree quota, by default the directory's
-project ID will be set to all its descendants unless you specify the project
-ID via
-.Fl p
-option explicitly.
+Set project inherit flag on the given files and directories.
+This is usually used for setting up tree quotas with
+.Fl r .
+In that case, the directory's project ID
+will be set for all its descendants, unless specified explicitly with
+.Fl p .
 .El
 .El
+.
 .Sh SEE ALSO
 .Xr zfs-projectspace 8