git: 9a7afecc503b - stable/15 - quot: Improve manual page

The branch stable/15 has been updated by des:

URL: https://cgit.FreeBSD.org/src/commit/?id=9a7afecc503b1364132a60d2342b4b56811cf439

commit 9a7afecc503b1364132a60d2342b4b56811cf439
Author:     Dag-Erling Smørgrav <des@FreeBSD.org>
AuthorDate: 2025-11-14 14:28:52 +0000
Commit:     Dag-Erling Smørgrav <des@FreeBSD.org>
CommitDate: 2025-11-19 10:56:50 +0000

    quot: Improve manual page
    
    * Rewrite the first paragraph to clarify that quot(8) only supports FFS.
    
    * Document which options can or cannot be combined with each other.
    
    MFC after:      1 week
    Reviewed by:    ziaee
    Differential Revision:  https://reviews.freebsd.org/D53727
    
    (cherry picked from commit 2f3adab9d512faec3e1891e505d1888db5d0240e)
---
 usr.sbin/quot/quot.8 | 21 ++++++++++++++++++++-
 1 file changed, 20 insertions(+), 1 deletion(-)

diff --git a/usr.sbin/quot/quot.8 b/usr.sbin/quot/quot.8
index 69c0a2d84b9b..b4b40bf395e9 100644
--- a/usr.sbin/quot/quot.8
+++ b/usr.sbin/quot/quot.8
@@ -41,7 +41,9 @@
 The
 .Nm
 utility
-is used to gather statistics about the disk usage for each local user.
+is used to gather per-user disk usage statistics from
+.Xr ffs 7
+file systems.
 .Pp
 The following options are available:
 .Bl -tag -width indent
@@ -51,8 +53,16 @@ Include statistics for all mounted file systems.
 Display three columns containing number of blocks per file,
 number of files in this category, and aggregate total of
 blocks in files with this or lower size.
+This option is mutually exclusive with the
+.Fl n
+option.
 .It Fl f
 For each user, display count of files and space occupied.
+This option has no effect if combined with the
+.Fl c
+or
+.Fl n
+options.
 .It Fl k
 Force the numbers to be reported in kilobyte counts.
 By default, all sizes are reported in 512-byte block counts.
@@ -69,9 +79,17 @@ ls -i | sed -e 's,^  *,,' | sort -k 1n | quot -n filesystem
 .Ed
 .Pp
 to get a report of files and their owners.
+This option is mutually exclusive with the
+.Fl c
+option.
 .It Fl v
 In addition to the default output, display the number of files
 not accessed within 30, 60 and 90 days.
+This option has no effect if combined with the
+.Fl c
+or
+.Fl n
+options.
 .El
 .Sh ENVIRONMENT
 .Bl -tag -width BLOCKSIZE
@@ -88,6 +106,7 @@ size block.
 .Xr quota 1 ,
 .Xr getmntinfo 3 ,
 .Xr fstab 5 ,
+.Xr ffs 7 ,
 .Xr mount 8
 .Sh HISTORY
 This implementation of