I found the info page describing the options for the split command somewhat confusing.
Hopefully the attached version is better. Pádraig.
>From f6307e244b499f572fcdf0b8aa40450fa1ca5fdf Mon Sep 17 00:00:00 2001 From: =?utf-8?q?P=C3=A1draig=20Brady?= <[EMAIL PROTECTED]> Date: Wed, 21 Nov 2007 16:17:23 +0000 Subject: [PATCH] Clarifications for the info page for the split command * doc/coreutils.texi (split invocation): The descriptions of the split command options were hard to understand, so hopefully this clarifies them somewhat. Signed-off-by: Pádraig Brady <[EMAIL PROTECTED]> --- doc/coreutils.texi | 45 ++++++++++++++++++++++++--------------------- 1 files changed, 24 insertions(+), 21 deletions(-) diff --git a/doc/coreutils.texi b/doc/coreutils.texi index a733292..230f208 100644 --- a/doc/coreutils.texi +++ b/doc/coreutils.texi @@ -2789,12 +2789,6 @@ The program accepts the following options. Also see @ref{Common options}. @table @samp [EMAIL PROTECTED] -a @var{length} [EMAIL PROTECTED] [EMAIL PROTECTED] [EMAIL PROTECTED] -a [EMAIL PROTECTED] --suffix-length -Use suffixes of length @var{length}. The default @var{length} is 2. - @item -l @var{lines} @itemx [EMAIL PROTECTED] @opindex -l @@ -2805,27 +2799,36 @@ For compatibility @command{split} also supports an obsolete option syntax @[EMAIL PROTECTED] New scripts should use @option{-l @var{lines}} instead. [EMAIL PROTECTED] -b @var{bytes} [EMAIL PROTECTED] [EMAIL PROTECTED] [EMAIL PROTECTED] -b @var{size} [EMAIL PROTECTED] [EMAIL PROTECTED] @opindex -b @opindex --bytes -Put the first @var{bytes} bytes of @var{input} into each output file. -Appending @samp{b} multiplies @var{bytes} by 512, [EMAIL PROTECTED] by 1000, @samp{K} by 1024, [EMAIL PROTECTED] by 1000*1000, @samp{M} by 1024*1024, [EMAIL PROTECTED] by 1000*1000*1000, @samp{GB} by 1024*1024*1024, -and so on for @samp{T}, @samp{P}, @samp{E}, @samp{Z}, and @samp{Y}. +Put @var{size} bytes of @var{input} into each output file. [EMAIL PROTECTED] is a number which may be optionally followed by these +multiplicative suffixes: [EMAIL PROTECTED] [EMAIL PROTECTED] => 512 ("blocks") [EMAIL PROTECTED] => 1000 (KiloBytes) [EMAIL PROTECTED] => 1024 (KibiBytes) [EMAIL PROTECTED] => 1000*1000 (MegaBytes) [EMAIL PROTECTED] => 1024*1024 (MebiBytes) [EMAIL PROTECTED] example +and so on for @samp{G}, @samp{T}, @samp{P}, @samp{E}, @samp{Z}, and @samp{Y}. [EMAIL PROTECTED] -C @var{bytes} [EMAIL PROTECTED] [EMAIL PROTECTED] [EMAIL PROTECTED] -C @var{size} [EMAIL PROTECTED] [EMAIL PROTECTED] @opindex -C @opindex --line-bytes Put into each output file as many complete lines of @var{input} as -possible without exceeding @var{bytes} bytes. For lines longer than [EMAIL PROTECTED] bytes, put @var{bytes} bytes into each output file until -less than @var{bytes} bytes of the line are left, then continue -normally. @var{bytes} has the same format as for the @option{--bytes} -option. +possible without exceeding @var{size} bytes. Individual lines longer than [EMAIL PROTECTED] bytes are broken into multiple files. [EMAIL PROTECTED] has the same format as for the @option{--bytes} option. + [EMAIL PROTECTED] -a @var{length} [EMAIL PROTECTED] [EMAIL PROTECTED] [EMAIL PROTECTED] -a [EMAIL PROTECTED] --suffix-length +Use suffixes of length @var{length}. The default @var{length} is 2. @item -d @itemx --numeric-suffixes -- 1.5.3.4 >From db0be54adb0e5ee749f119a216304d90ceb01031 Mon Sep 17 00:00:00 2001 From: =?utf-8?q?P=C3=A1draig=20Brady?= <[EMAIL PROTECTED]> Date: Wed, 21 Nov 2007 16:19:16 +0000 Subject: [PATCH] Clarifications for the info page for the split command Signed-off-by: Pádraig Brady <[EMAIL PROTECTED]> --- doc/ChangeLog | 5 +++++ 1 files changed, 5 insertions(+), 0 deletions(-) diff --git a/doc/ChangeLog b/doc/ChangeLog index 5043a8f..c603eb7 100644 --- a/doc/ChangeLog +++ b/doc/ChangeLog @@ -1,3 +1,8 @@ +2007-11-21 Pádraig Brady <[EMAIL PROTECTED]> + + * coreutils.texi (split invocation): Improve the + descriptions of the split command options. + 2007-10-05 Jim Meyering <[EMAIL PROTECTED]> * coreutils.texi (chroot invocation): List two systems on which -- 1.5.3.4
_______________________________________________ Bug-coreutils mailing list Bug-coreutils@gnu.org http://lists.gnu.org/mailman/listinfo/bug-coreutils