src/usr.bin/split/split.1, branch releng/14.0

Remove $FreeBSD$: one-line nroff pattern

2023-08-16T17:55:15+00:00

Remove /^\.\\"\s*\$FreeBSD\$$\n/

split(1): add '-c' to continue creating files

2023-05-30T13:13:16+00:00

Currently, split(1) will clobber any existing output files:

$ split file; ls
xaa xab xac xad
$ split second-file; ls
xaa xab xac xad xae xaf

This patch adds a flag "-c" (mnemonic "create, don't overwrite" or
"continue where you left off"):

$ split file; ls
xaa xab xac xad
$ split -c second-file; ls
xaa xab xac xad xae xaf xag xah xai xaj

Reviewed by:	christos
Approved by:	kevans
Different Revision:	https://reviews.freebsd.org/D38553

split(1): auto-extend suffix length if required

2023-05-30T12:55:38+00:00

If the input cannot be split into the number of files resulting from the
default suffix length, automatically extend the suffix length rather
than bailing out with 'too many files'.

Suffixes are extended such that the resulting files continue to sort
lexically and "cat *" would reproduce the input. For example, splitting
a 1M lines file into (default) 1000 lines per file would yield files
named 'xaa', 'xab', ..., 'xyy', 'xyz', 'xzaaa', 'xzaab', ..., 'xzanl'.

If '-a' is specified, the suffix length is not auto-extended.

This behavior matches GNU sort(1) since around version 8.16.

Reviewed by:	christos
Approved by:	kevans
Different Revision:	https://reviews.freebsd.org/D38279

split: Update synopsis and usage; fix examples

2023-04-18T13:30:00+00:00

- 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.

split: add word order fix

2022-10-25T21:52:14+00:00

This was meant to note that both pattern and line matching were
previously restricted, but words are difficult.  +line and rearrange.

Sponsored by:	Klara, Inc.

split: switch to getline() for line/pattern matching

2022-10-25T15:05:23+00:00

Get rid of split's home-grown logic for growing the buffer; arbitrarily
breaking at LONG_MAX bytes instead of 65536 bytes gives us much more
wiggle room.  Additionally, we'll actually fail out entirely if we can't
fit a line, which makes noticing this class of problem much easier.

Reviewed by:	bapt, emaste, pauamma
Sponsored by:	Klara, Inc.
Differential Revision:	https://reviews.freebsd.org/D36323

split(1): Add EXAMPLES section

2020-06-18T15:14:10+00:00

Add EXAMPLES covering -d, -n and -p
Include small explanation about the size of the chunks for the -n option

Approved by:	0mp
Differential Revision:	https://reviews.freebsd.org/D25198

Renumber copyright clause 4

2017-02-28T23:42:47+00:00

Renumber cluase 4 to 3, per what everybody else did when BSD granted
them permission to remove clause 3. My insistance on keeping the same
numbering for legal reasons is too pedantic, so give up on that point.

Submitted by:	Jan Schaumann 
Pull Request:	https://github.com/freebsd/freebsd/pull/96

Bump .Dd for recent content change.

2013-05-10T12:49:16+00:00

Reported by:	delphij

Implement 'split -d' which allows a numeric suffix instead of an

2013-05-10T04:23:03+00:00

alphabetic one.

PR:		bin/116209
Submitted by:	Marcin Gryszkalis  (adapted from)
Reviewed by:	will
MFC after:	1 week