commit: ea69f8fc6eb1e1ee71eea57b938eac631dedb4de Author: Fabian Groffen <grobian <AT> gentoo <DOT> org> AuthorDate: Tue Apr 3 13:39:15 2018 +0000 Commit: Fabian Groffen <grobian <AT> gentoo <DOT> org> CommitDate: Tue Apr 3 13:39:15 2018 +0000 URL: https://gitweb.gentoo.org/proj/portage-utils.git/commit/?id=ea69f8fc
qsize: improve documentation Bug: https://bugs.gentoo.org/645554 man/include/qpkg.optdesc.yaml | 2 +- man/qsize.1 | 37 +++++++++++++++++++++---------------- qsize.c | 6 +++--- 3 files changed, 25 insertions(+), 20 deletions(-) diff --git a/man/include/qpkg.optdesc.yaml b/man/include/qpkg.optdesc.yaml index 2da2810..62c0b52 100644 --- a/man/include/qpkg.optdesc.yaml +++ b/man/include/qpkg.optdesc.yaml @@ -1,2 +1,2 @@ verbose: Check and report MD5 hash mismatches during install. -quiet: Ignored for compatability with other qapplets. +quiet: Ignored for compatibility with other qapplets. diff --git a/man/qsize.1 b/man/qsize.1 index aa613f8..a734afd 100644 --- a/man/qsize.1 +++ b/man/qsize.1 @@ -1,56 +1,61 @@ -.TH qsize "1" "Mar 2016" "Gentoo Foundation" "qsize" +.\" generated by mkman.py, please do NOT edit! +.TH qsize "1" "Apr 2018" "Gentoo Foundation" "qsize" .SH NAME qsize \- calculate size usage .SH SYNOPSIS .B qsize \fI[opts] <pkgname>\fR .SH DESCRIPTION - +\fIqsize\fR calculates the storage size taken by an installed package. +The reported sizes can be the recorded exact sizes of all files, or the +storage space they consume given the underlying filesystem. .SH OPTIONS .TP \fB\-f\fR, \fB\-\-filesystem\fR -Show size used on disk +Show size used on disk. .TP \fB\-s\fR, \fB\-\-sum\fR -Include a summary +Include a summary. .TP \fB\-S\fR, \fB\-\-sum\-only\fR -Show just the summary +Show just the summary. .TP \fB\-m\fR, \fB\-\-megabytes\fR -Display size in megabytes +Display all sizes in megabytes. .TP \fB\-k\fR, \fB\-\-kilobytes\fR -Display size in kilobytes +Display all sizes in kilobytes. .TP \fB\-b\fR, \fB\-\-bytes\fR -Display size in bytes +Display all sizes in bytes. .TP \fB\-i\fR \fI<arg>\fR, \fB\-\-ignore\fR \fI<arg>\fR -Ignore regexp string +Filter out entries matching \fI<arg>\fR, which is a regular +expression, before calculating size. .TP \fB\-\-root\fR \fI<arg>\fR -Set the ROOT env var +Set the ROOT env var. .TP \fB\-v\fR, \fB\-\-verbose\fR -Make a lot of noise +Ignored for compatibility with other qapplets. .TP \fB\-q\fR, \fB\-\-quiet\fR -Tighter output; suppress warnings +Ignored for compatibility with other qapplets. .TP \fB\-C\fR, \fB\-\-nocolor\fR -Don't output color +Don't output color. .TP \fB\-h\fR, \fB\-\-help\fR -Print this help and exit +Print this help and exit. .TP \fB\-V\fR, \fB\-\-version\fR -Print version and exit +Print version and exit. .SH "REPORTING BUGS" Please report bugs via http://bugs.gentoo.org/ .br -Product: Portage Development; Component: Tools +Product: Portage Development; Component: Tools, Assignee: +portage-ut...@gentoo.org .SH AUTHORS .nf Ned Ludd <so...@gentoo.org> diff --git a/qsize.c b/qsize.c index c485aa6..78b8f88 100644 --- a/qsize.c +++ b/qsize.c @@ -23,9 +23,9 @@ static const char * const qsize_opts_help[] = { "Show size used on disk", "Include a summary", "Show just the summary", - "Display size in megabytes", - "Display size in kilobytes", - "Display size in bytes", + "Display all sizes in megabytes", + "Display all sizes in kilobytes", + "Display all sizes in bytes", "Ignore regexp string", COMMON_OPTS_HELP };
