[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[PATCH] Clarifications for the info page for the split command
From: |
Pádraig Brady |
Subject: |
[PATCH] Clarifications for the info page for the split command |
Date: |
Wed, 21 Nov 2007 16:29:22 +0000 |
User-agent: |
Thunderbird 2.0.0.6 (X11/20071008) |
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?= <address@hidden>
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 <address@hidden>
---
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
address@hidden -a @var{length}
address@hidden address@hidden
address@hidden -a
address@hidden --suffix-length
-Use suffixes of length @var{length}. The default @var{length} is 2.
-
@item -l @var{lines}
@itemx address@hidden
@opindex -l
@@ -2805,27 +2799,36 @@ For compatibility @command{split} also supports an
obsolete
option syntax @address@hidden New scripts should use @option{-l
@var{lines}} instead.
address@hidden -b @var{bytes}
address@hidden address@hidden
address@hidden -b @var{size}
address@hidden address@hidden
@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,
address@hidden by 1000, @samp{K} by 1024,
address@hidden by 1000*1000, @samp{M} by 1024*1024,
address@hidden 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.
address@hidden is a number which may be optionally followed by these
+multiplicative suffixes:
address@hidden
address@hidden => 512 ("blocks")
address@hidden => 1000 (KiloBytes)
address@hidden => 1024 (KibiBytes)
address@hidden => 1000*1000 (MegaBytes)
address@hidden => 1024*1024 (MebiBytes)
address@hidden example
+and so on for @samp{G}, @samp{T}, @samp{P}, @samp{E}, @samp{Z}, and @samp{Y}.
address@hidden -C @var{bytes}
address@hidden address@hidden
address@hidden -C @var{size}
address@hidden address@hidden
@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
address@hidden 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
address@hidden bytes are broken into multiple files.
address@hidden has the same format as for the @option{--bytes} option.
+
address@hidden -a @var{length}
address@hidden address@hidden
address@hidden -a
address@hidden --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?= <address@hidden>
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 <address@hidden>
---
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 <address@hidden>
+
+ * coreutils.texi (split invocation): Improve the
+ descriptions of the split command options.
+
2007-10-05 Jim Meyering <address@hidden>
* coreutils.texi (chroot invocation): List two systems on which
--
1.5.3.4
- [PATCH] Clarifications for the info page for the split command,
Pádraig Brady <=