Bug 265199 - du.1 doesn't mention --si in SYNOPSIS and is missing -g from some places
Summary: du.1 doesn't mention --si in SYNOPSIS and is missing -g from some places
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Warner Losh
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2022-07-13 18:27 UTC by наб
Modified: 2026-07-17 07:06 UTC (History)
2 users (show)

See Also:


Attachments
patch :) (962 bytes, message/rfc822)
2022-07-13 18:27 UTC, наб
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
Description наб 2022-07-13 18:27:35 UTC
Created attachment 235242 [details]
patch :)

See attached patch, output diff:

--- /dev/fd/63	2022-07-13 20:26:54.274901055 +0200
+++ /dev/fd/62	2022-07-13 20:26:54.274901055 +0200
@@ -4,8 +4,9 @@
      du – display disk usage statistics

 SYNOPSIS
-     du [-Aclnx] [-H | -L | -P] [-g | -h | -k | -m] [-a | -s | -d depth]
-	 [-B blocksize] [-I mask] [-t threshold] [file ...]
+     du [-Aclnx] [-H | -L | -P] [-g | -h | -k | -m | --si]
+	 [-a | -s | -d depth] [-B blocksize] [-I mask] [-t threshold]
+	 [file ...]

 DESCRIPTION
      The du utility displays the file system block usage for each file
@@ -20,7 +21,7 @@

      -B blocksize
	      Calculate block counts in blocksize byte blocks.	This is
-	      different from the -h, -k, -m, --si and -g options or setting
+	      different from the -g, -h, -k, -m, and --si options or setting
	      BLOCKSIZE and gives an estimate of how much space the examined
	      file hierarchy would require on a filesystem with the given
	      blocksize.  Unless in -A mode, blocksize is rounded up to the
@@ -89,7 +90,7 @@
      options override each other and the command's actions are determined by
      the last one specified.

-     The -h, -k, -m and --si options all override each other; the last one
+     The -g, -h, -k, -m and --si options all override each other; the last one
      specified determines the block counts used.

 ENVIRONMENT
Comment 1 commit-hook freebsd_committer freebsd_triage 2026-06-10 12:36:34 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=82780af43b113ab16a1a4fab5bf085b2b159f81e

commit 82780af43b113ab16a1a4fab5bf085b2b159f81e
Author:     Kit Dallege <xaum.io@gmail.com>
AuthorDate: 2026-03-27 04:30:11 +0000
Commit:     Warner Losh <imp@FreeBSD.org>
CommitDate: 2026-06-10 12:35:03 +0000

    du(1): document --si option

    The --si option (human-readable output with SI units based on
    powers of 1000) was implemented but missing from both the SYNOPSIS
    and the options list.

    PR: 265199
    Signed-off-by: Kit Dallege <xaum.io@gmail.com>
    Reviewed by: imp
    Pull Request: https://github.com/freebsd/freebsd-src/pull/2104

 usr.bin/du/du.1 | 9 +++++++--
 1 file changed, 7 insertions(+), 2 deletions(-)
Comment 2 Mark Linimon freebsd_committer freebsd_triage 2026-07-17 07:06:55 UTC
^Triage: since there is no way to set MFC flags for Manual Pages, there is
nothing to do here but close this.