From b64d9b6d9e7fdc96614e3cbef001f8e078fe9588 Mon Sep 17 00:00:00 2001 From: Ondřej Vašík Date: Thu, 10 Sep 2009 12:33:41 +0100 Subject: doc: improve various BLOCKSIZE and SIZE help * doc/coreutils.texi (multiplierSuffixes): Mention that the suffix can be specified without a leading number * src/split.c (usage): Refactor SIZE help to within a function * src/truncate.c (usage): Likewise * src/ls.c (usage): Likewise * src/df.c (usage): Likewise. Also add a function with BLOCKSIZE help * src/du.c (usage): Likewise. * src/system.h: Define 2 functions to emit common help text This was prompted by https://bugzilla.redhat.com/show_bug.cgi?id=511188 --- doc/coreutils.texi | 15 ++++----------- 1 file changed, 4 insertions(+), 11 deletions(-) (limited to 'doc') diff --git a/doc/coreutils.texi b/doc/coreutils.texi index 93f939019..22d307a99 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -618,15 +618,8 @@ from the shell. @end macro @macro multiplierSuffixes{varName} -@ignore -Appending @samp{b} multiplies @var{\varName\} by 512, -@samp{kB} by 1000, @samp{K} by 1024, -@samp{MB} by 1000*1000, @samp{M} by 1024*1024, -@samp{GB} by 1000*1000*1000, @samp{G} by 1024*1024*1024, -and so on for @samp{T}, @samp{P}, @samp{E}, @samp{Z}, and @samp{Y}. -@end ignore -@var{\varName\} is a number which may have one of the following -multiplicative suffixes: +@var{\varName\} may be, or may be an integer optionally followed by, +one of the following multiplicative suffixes: @example @samp{b} => 512 ("blocks") @samp{KB} => 1000 (KiloBytes) @@ -641,8 +634,8 @@ and so on for @samp{T}, @samp{P}, @samp{E}, @samp{Z}, and @samp{Y}. @c FIXME: same as above, but no ``blocks'' line. @macro multiplierSuffixesNoBlocks{varName} -@var{\varName\} is a number which may have one of the following -multiplicative suffixes: +@var{\varName\} may be, or may be an integer optionally followed by, +one of the following multiplicative suffixes: @example @samp{KB} => 1000 (KiloBytes) @samp{K} => 1024 (KibiBytes) -- cgit v1.2.3-70-g09d2