OSDN Git Service

Update original to coreutils 8.25
[linuxjm/coreutils.git] / original / man1 / split.1
index 8d4919f..6331b4f 100644 (file)
@@ -1,47 +1,54 @@
-.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.43.3.
-.TH SPLIT "1" "May 2014" "GNU coreutils 8.22" "User Commands"
+.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.3.
+.TH SPLIT "1" "January 2016" "GNU coreutils 8.25" "User Commands"
 .SH NAME
 split \- split a file into pieces
 .SH SYNOPSIS
 .B split
-[\fIOPTION\fR]... [\fIINPUT \fR[\fIPREFIX\fR]]
+[\fI\,OPTION\/\fR]... [\fI\,FILE \/\fR[\fI\,PREFIX\/\fR]]
 .SH DESCRIPTION
 .\" Add any additional description here
 .PP
-Output fixed\-size pieces of INPUT to PREFIXaa, PREFIXab, ...; default
-size is 1000 lines, and default PREFIX is 'x'.  With no INPUT, or when INPUT
-is \-, read standard input.
+Output pieces of FILE to PREFIXaa, PREFIXab, ...;
+default size is 1000 lines, and default PREFIX is 'x'.
+.PP
+With no FILE, or when FILE is \-, read standard input.
 .PP
 Mandatory arguments to long options are mandatory for short options too.
 .TP
-\fB\-a\fR, \fB\-\-suffix\-length\fR=\fIN\fR
+\fB\-a\fR, \fB\-\-suffix\-length\fR=\fI\,N\/\fR
 generate suffixes of length N (default 2)
 .TP
-\fB\-\-additional\-suffix\fR=\fISUFFIX\fR
+\fB\-\-additional\-suffix\fR=\fI\,SUFFIX\/\fR
 append an additional SUFFIX to file names
 .TP
-\fB\-b\fR, \fB\-\-bytes\fR=\fISIZE\fR
+\fB\-b\fR, \fB\-\-bytes\fR=\fI\,SIZE\/\fR
 put SIZE bytes per output file
 .TP
-\fB\-C\fR, \fB\-\-line\-bytes\fR=\fISIZE\fR
-put at most SIZE bytes of lines per output file
+\fB\-C\fR, \fB\-\-line\-bytes\fR=\fI\,SIZE\/\fR
+put at most SIZE bytes of records per output file
+.TP
+\fB\-d\fR
+use numeric suffixes starting at 0, not alphabetic
 .TP
-\fB\-d\fR, \fB\-\-numeric\-suffixes\fR[=\fIFROM\fR]
-use numeric suffixes instead of alphabetic;
-FROM changes the start value (default 0)
+\fB\-\-numeric\-suffixes\fR[=\fI\,FROM\/\fR]
+same as \fB\-d\fR, but allow setting the start value
 .TP
 \fB\-e\fR, \fB\-\-elide\-empty\-files\fR
 do not generate empty output files with '\-n'
 .TP
-\fB\-\-filter\fR=\fICOMMAND\fR
+\fB\-\-filter\fR=\fI\,COMMAND\/\fR
 write to shell COMMAND; file name is $FILE
 .TP
-\fB\-l\fR, \fB\-\-lines\fR=\fINUMBER\fR
-put NUMBER lines per output file
+\fB\-l\fR, \fB\-\-lines\fR=\fI\,NUMBER\/\fR
+put NUMBER lines/records per output file
 .TP
-\fB\-n\fR, \fB\-\-number\fR=\fICHUNKS\fR
+\fB\-n\fR, \fB\-\-number\fR=\fI\,CHUNKS\/\fR
 generate CHUNKS output files; see explanation below
 .TP
+\fB\-t\fR, \fB\-\-separator\fR=\fI\,SEP\/\fR
+use SEP instead of newline as the record separator;
+\&'\e0' (zero) specifies the NUL character
+.TP
 \fB\-u\fR, \fB\-\-unbuffered\fR
 immediately copy input to output with '\-n r/...'
 .TP
@@ -55,36 +62,40 @@ display this help and exit
 \fB\-\-version\fR
 output version information and exit
 .PP
-SIZE is an integer and optional unit (example: 10M is 10*1024*1024).  Units
-are K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB, ... (powers of 1000).
-.PP
-CHUNKS may be:
-N       split into N files based on size of input
-K/N     output Kth of N to stdout
-l/N     split into N files without splitting lines
-l/K/N   output Kth of N to stdout without splitting lines
-r/N     like 'l' but use round robin distribution
-r/K/N   likewise but only output Kth of N to stdout
-.PP
-GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
-Report split translation bugs to <http://translationproject.org/team/>
+The SIZE argument is an integer and optional unit (example: 10K is 10*1024).
+Units are K,M,G,T,P,E,Z,Y (powers of 1024) or KB,MB,... (powers of 1000).
+.SS "CHUNKS may be:"
+.TP
+N
+split into N files based on size of input
+.TP
+K/N
+output Kth of N to stdout
+.TP
+l/N
+split into N files without splitting lines/records
+.TP
+l/K/N
+output Kth of N to stdout without splitting lines/records
+.TP
+r/N
+like 'l' but use round robin distribution
+.TP
+r/K/N
+likewise but only output Kth of N to stdout
 .SH AUTHOR
 Written by Torbjorn Granlund and Richard M. Stallman.
+.SH "REPORTING BUGS"
+GNU coreutils online help: <http://www.gnu.org/software/coreutils/>
+.br
+Report split translation bugs to <http://translationproject.org/team/>
 .SH COPYRIGHT
-Copyright \(co 2013 Free Software Foundation, Inc.
+Copyright \(co 2016 Free Software Foundation, Inc.
 License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
 .br
 This is free software: you are free to change and redistribute it.
 There is NO WARRANTY, to the extent permitted by law.
 .SH "SEE ALSO"
-The full documentation for
-.B split
-is maintained as a Texinfo manual.  If the
-.B info
-and
-.B split
-programs are properly installed at your site, the command
-.IP
-.B info coreutils \(aqsplit invocation\(aq
-.PP
-should give you access to the complete manual.
+Full documentation at: <http://www.gnu.org/software/coreutils/split>
+.br
+or available locally via: info \(aq(coreutils) split invocation\(aq