Initial GPL-3.0 Release (v1.0.0)

This commit is contained in:
2026-01-22 21:29:34 -05:00
commit 9c8d1d43fd
23 changed files with 4087 additions and 0 deletions
+81
View File
@@ -0,0 +1,81 @@
.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH sized 1 "sized 1.0.0"
.SH NAME
sized \- A modern, fast, and concurrent disk usage analyzer
.SH SYNOPSIS
\fBsized\fR [\fB\-v\fR|\fB\-\-version\fR] [\fB\-m\fR|\fB\-\-min\-size\fR] [\fB\-n\fR|\fB\-\-number\fR] [\fB\-\-sort\fR] [\fB\-a\fR|\fB\-\-apparent\fR] [\fB\-d\fR|\fB\-\-depth\fR] [\fB\-f\fR|\fB\-\-path\-full\fR] [\fB\-\-path\-relative\fR] [\fB\-j\fR|\fB\-\-threads\fR] [\fB\-\-completions\fR] [\fB\-i\fR|\fB\-\-ignore\fR] [\fB\-\-format\fR] [\fB\-\-save\fR] [\fB\-\-precision\fR] [\fB\-\-units\fR] [\fB\-c\fR|\fB\-\-compare\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fIPATH\fR]
.SH DESCRIPTION
A modern, fast, and concurrent disk usage analyzer
.SH OPTIONS
.TP
\fB\-v\fR, \fB\-\-version\fR
Print version
.TP
\fB\-m\fR, \fB\-\-min\-size\fR \fI<MIN_SIZE>\fR
Minimum size filter (e.g. "10MB", "1gb")
.TP
\fB\-n\fR, \fB\-\-number\fR \fI<NUMBER>\fR
Limit the number of results per table
.TP
\fB\-\-sort\fR \fI<SORT>\fR
Sort by columns (e.g. "type:asc,size:dsc"). defaults to size:dsc. Columns: name, type, size (disk usage), apparent (logical), blocks
.TP
\fB\-a\fR, \fB\-\-apparent\fR
Show apparent size (logical file length) in addition to disk usage
.TP
\fB\-d\fR, \fB\-\-depth\fR \fI<DEPTH>\fR [default: 0]
Depth to traverse (0 = only immediate children)
.TP
\fB\-f\fR, \fB\-\-path\-full\fR
Display full absolute paths
.TP
\fB\-\-path\-relative\fR
Display paths relative to current directory (default)
.TP
\fB\-j\fR, \fB\-\-threads\fR \fI<THREADS>\fR
Number of threads to use (defaults to available logical CPUs)
.TP
\fB\-\-completions\fR \fI<COMPLETIONS>\fR
Generate shell completions
.br
.br
[\fIpossible values: \fRbash, elvish, fish, powershell, zsh]
.TP
\fB\-i\fR, \fB\-\-ignore\fR
Respect .gitignore and .ignore files
.TP
\fB\-\-format\fR \fI<FORMAT>\fR [default: text]
Output format
.br
.br
[\fIpossible values: \fRtext, csv, json]
.TP
\fB\-\-save\fR [\fI<SAVE>\fR]
Save output to file (optional filename, defaults to timestamped name)
.TP
\fB\-\-precision\fR \fI<PRECISION>\fR [default: 2]
Precision for size output (decimal places)
.TP
\fB\-\-units\fR \fI<UNITS>\fR [default: binary]
Unit system to use
.br
.br
[\fIpossible values: \fRbinary, decimal]
.TP
\fB\-c\fR, \fB\-\-compare\fR
Show comparison between total and non\-ignored files
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help
.TP
[\fIPATH\fR] [default: .]
Directory to analyze
.SH VERSION
v1.0.0
.SH COPYRIGHT
sized is licensed under the GNU General Public License v3.0 (GPL-3.0).