Changeset View
Changeset View
Standalone View
Standalone View
usr.bin/split/split.1
| Context not available. | |||||
| .\" @(#)split.1 8.3 (Berkeley) 4/16/94 | .\" @(#)split.1 8.3 (Berkeley) 4/16/94 | ||||
| .\" $FreeBSD$ | .\" $FreeBSD$ | ||||
| .\" | .\" | ||||
| .Dd May 9, 2013 | .Dd May 26, 2023 | ||||
| .Dt SPLIT 1 | .Dt SPLIT 1 | ||||
| .Os | .Os | ||||
| .Sh NAME | .Sh NAME | ||||
| Context not available. | |||||
| .Nd split a file into pieces | .Nd split a file into pieces | ||||
| .Sh SYNOPSIS | .Sh SYNOPSIS | ||||
| .Nm | .Nm | ||||
| .Fl d | .Op Fl cd | ||||
| .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 cd | ||||
| .Fl b Ar byte_count Ns | .Fl b Ar byte_count Ns | ||||
| .Oo | .Oo | ||||
| .Sm off | .Sm off | ||||
| Context not available. | |||||
| .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 cd | ||||
| .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 cd | ||||
| .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 | ||||
| Context not available. | |||||
| is appended to the number, the file is split into | is appended to the number, the file is split into | ||||
| .Ar byte_count | .Ar byte_count | ||||
| gigabyte pieces. | gigabyte pieces. | ||||
| .It Fl c | |||||
| Continue creating files and do not overwrite existing | |||||
| output files. | |||||
christos: You can also mention the mnemonics you have in your description: "create, don't overwrite" or… | |||||
| .It Fl d | .It Fl d | ||||
| Use a numeric suffix instead of a alphabetic suffix. | Use a numeric suffix instead of a alphabetic suffix. | ||||
| .It Fl l Ar line_count | .It Fl l Ar line_count | ||||
| Context not available. | |||||
| files named with the prefix | files named with the prefix | ||||
| .Dq Li x | .Dq Li x | ||||
| and with suffixes as above. | and with suffixes as above. | ||||
| .Pp | |||||
| By default, | |||||
| .Nm | |||||
| will overwrite any existing output files. | |||||
| If the | |||||
| .Fl c | |||||
| flag is specified, | |||||
| .Nm | |||||
| will instead create files with names that do not already exist. | |||||
| .Sh ENVIRONMENT | .Sh ENVIRONMENT | ||||
Not Done Inline ActionsI think "generate output file names..." is a bit technical and the user typically wouldn't care about the underlying mechanism. It might be better to phrase it as "...will instead create files with names that do not already exist." christos: I think "generate output file names..." is a bit technical and the user typically wouldn't care… | |||||
| The | The | ||||
| .Ev LANG , LC_ALL , LC_CTYPE | .Ev LANG , LC_ALL , LC_CTYPE | ||||
| Context not available. | |||||
You can also mention the mnemonics you have in your description: "create, don't overwrite" or "continue where you left off".