split: Update synopsis and usage; fix examples

- Mark -d as an optional flag
- Add a prompt to one of the examples for consistency
- Add -d to the usage message

Sponsored by:	Klara Inc.
This commit is contained in:
Mateusz Piotrowski 2023-04-14 13:50:13 +02:00
parent 1943c40cd6
commit fb49925999
2 changed files with 10 additions and 10 deletions

View File

@ -28,7 +28,7 @@
.\" @(#)split.1 8.3 (Berkeley) 4/16/94 .\" @(#)split.1 8.3 (Berkeley) 4/16/94
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd October 25, 2022 .Dd April 18, 2023
.Dt SPLIT 1 .Dt SPLIT 1
.Os .Os
.Sh NAME .Sh NAME
@ -36,12 +36,12 @@
.Nd split a file into pieces .Nd split a file into pieces
.Sh SYNOPSIS .Sh SYNOPSIS
.Nm .Nm
.Fl d .Op Fl d
.Op Fl l Ar line_count .Op Fl l Ar line_count
.Op Fl a Ar suffix_length .Op Fl a Ar suffix_length
.Op Ar file Op Ar prefix .Op Ar file Op Ar prefix
.Nm .Nm
.Fl d .Op Fl d
.Fl b Ar byte_count Ns .Fl b Ar byte_count Ns
.Oo .Oo
.Sm off .Sm off
@ -51,12 +51,12 @@
.Op Fl a Ar suffix_length .Op Fl a Ar suffix_length
.Op Ar file Op Ar prefix .Op Ar file Op Ar prefix
.Nm .Nm
.Fl d .Op Fl d
.Fl n Ar chunk_count .Fl n Ar chunk_count
.Op Fl a Ar suffix_length .Op Fl a Ar suffix_length
.Op Ar file Op Ar prefix .Op Ar file Op Ar prefix
.Nm .Nm
.Fl d .Op Fl d
.Fl p Ar pattern .Fl p Ar pattern
.Op Fl a Ar suffix_length .Op Fl a Ar suffix_length
.Op Ar file Op Ar prefix .Op Ar file Op Ar prefix
@ -186,7 +186,7 @@ $ echo -e "This is 22 bytes long" | split -d -b10
.Pp .Pp
Split input generating 6 files: Split input generating 6 files:
.Bd -literal -offset indent .Bd -literal -offset indent
echo -e "This is 22 bytes long" | split -n 6 $ echo -e "This is 22 bytes long" | split -n 6
.Ed .Ed
.Pp .Pp
Split input creating a new file every time a line matches the regular expression Split input creating a new file every time a line matches the regular expression

View File

@ -395,9 +395,9 @@ static void
usage(void) usage(void)
{ {
(void)fprintf(stderr, (void)fprintf(stderr,
"usage: split [-l line_count] [-a suffix_length] [file [prefix]]\n" "usage: split [-d] [-l line_count] [-a suffix_length] [file [prefix]]\n"
" split -b byte_count[K|k|M|m|G|g] [-a suffix_length] [file [prefix]]\n" " split [-d] -b byte_count[K|k|M|m|G|g] [-a suffix_length] [file [prefix]]\n"
" split -n chunk_count [-a suffix_length] [file [prefix]]\n" " split [-d] -n chunk_count [-a suffix_length] [file [prefix]]\n"
" split -p pattern [-a suffix_length] [file [prefix]]\n"); " split [-d] -p pattern [-a suffix_length] [file [prefix]]\n");
exit(EX_USAGE); exit(EX_USAGE);
} }