sbase/cut.1

.Dd 2015-10-08
.Dt CUT 1
.Os sbase
.Sh NAME
.Nm cut
.Nd extract columns of data
.Sh SYNOPSIS
.Nm
.Fl b Ar list
.Op Fl n
.Op Ar file ...
.Nm
.Fl c Ar list
.Op Ar file ...
.Nm
.Fl f Ar list
.Op Fl d Ar delim
.Op Fl s
.Op Ar file ...
.Sh DESCRIPTION
.Nm
out bytes, characters or delimited fields from each line of
.Ar file
and write to stdout.
.Pp
If no
.Ar file
is given or
.Ar file
is '-',
.Nm
reads from stdin.
.Pp
.Ar list
is a comma or space separated list of numbers and ranges starting
from 1.
Ranges have the form 'N-M'. If N or M is missing, beginning or end
of line is assumed.
Numbers and ranges may be repeated, overlapping and in any order.
.Pp
Selected input is written in the same order it is read
and is written exactly once.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl b Ar list | Fl c Ar list
.Ar list
specifies byte | character positions.
.It Fl d Ar delim
Use
.Ar delim
as field delimiter, which can be an arbitrary string.
Default is '\et'.
.It Fl f Ar list
.Ar list
specifies field numbers.
Lines not containing field delimiters are passed through, unless
.Fl s
is specified.
.It Fl n
Do not split multibyte characters.
A character is written when its last byte is selected.
.It Fl s
Suppress lines not containing field delimiters.
.El
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification.
.Pp
The possibility of separating numbers and ranges with a space and specifying
multibyte delimiters of arbitrary length is an extension to that specification.
Use ISO-date-format in manpages The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org. 2015-10-08 15:15:08 +00:00			`.Dd 2015-10-08`
remove sbase-VERSION from man page, fix sponge.1 date 2015-01-31 13:20:02 +00:00			`.Dt CUT 1`
Add .Os sbase and sed replace to .Os sbase $(VERSION) in make install 2015-01-31 19:37:03 +00:00			`.Os sbase`
Add mandoc-manpage for cut(1) and clean up code and mark it as finished in README. 2015-01-18 10:30:31 +00:00			`.Sh NAME`
			`.Nm cut`
			`.Nd extract columns of data`
			`.Sh SYNOPSIS`
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff. 2015-01-30 20:17:58 +00:00			`.Nm`
Add mandoc-manpage for cut(1) and clean up code and mark it as finished in README. 2015-01-18 10:30:31 +00:00			`.Fl b Ar list`
			`.Op Fl n`
			`.Op Ar file ...`
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff. 2015-01-30 20:17:58 +00:00			`.Nm`
Add mandoc-manpage for cut(1) and clean up code and mark it as finished in README. 2015-01-18 10:30:31 +00:00			`.Fl c Ar list`
			`.Op Ar file ...`
add some mandoc pages and fix some warnings - add .Os, it is mandatory. - don't redeclare .Nm when it's not needed. - fix some warnings (checked with mandoc -Tlint). - remove some leftover old stuff. 2015-01-30 20:17:58 +00:00			`.Nm`
Add mandoc-manpage for cut(1) and clean up code and mark it as finished in README. 2015-01-18 10:30:31 +00:00			`.Fl f Ar list`
			`.Op Fl d Ar delim`
			`.Op Fl s`
			`.Op Ar file ...`
			`.Sh DESCRIPTION`
			`.Nm`
			`out bytes, characters or delimited fields from each line of`
			`.Ar file`
			`and write to stdout.`
			`.Pp`
			`If no`
			`.Ar file`
			`is given or`
			`.Ar file`
			`is '-',`
			`.Nm`
			`reads from stdin.`
			`.Pp`
			`.Ar list`
			`is a comma or space separated list of numbers and ranges starting`
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command. 2020-03-01 22:37:31 +00:00			`from 1.`
			`Ranges have the form 'N-M'. If N or M is missing, beginning or end`
			`of line is assumed.`
			`Numbers and ranges may be repeated, overlapping and in any order.`
Add mandoc-manpage for cut(1) and clean up code and mark it as finished in README. 2015-01-18 10:30:31 +00:00			`.Pp`
			`Selected input is written in the same order it is read`
			`and is written exactly once.`
			`.Sh OPTIONS`
			`.Bl -tag -width Ds`
			`.It Fl b Ar list \| Fl c Ar list`
			`.Ar list`
			`specifies byte \| character positions.`
man pages: improve consistency 2015-02-01 19:52:28 +00:00			`.It Fl d Ar delim`
			`Use`
			`.Ar delim`
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command. 2020-03-01 22:37:31 +00:00			`as field delimiter, which can be an arbitrary string.`
			`Default is '\et'.`
Add mandoc-manpage for cut(1) and clean up code and mark it as finished in README. 2015-01-18 10:30:31 +00:00			`.It Fl f Ar list`
			`.Ar list`
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command. 2020-03-01 22:37:31 +00:00			`specifies field numbers.`
			`Lines not containing field delimiters are passed through, unless`
Add mandoc-manpage for cut(1) and clean up code and mark it as finished in README. 2015-01-18 10:30:31 +00:00			`.Fl s`
			`is specified.`
man pages: improve consistency 2015-02-01 19:52:28 +00:00			`.It Fl n`
Fix various lint warnings in manuals Fix "new sentence, new line" warnings throughout so that formatters can produce correct spacing between sentences. join.1 Remove unnecessary Ns macros. These are not necessary for delimeters, which get special treatment. xinstall.1 Fix date in manual. The contents were last modified on 2016-12-03, so use that instead of the invalid date. grep.1 Fix escape sequence for `\<` and `\>`. ed.1 Remove spurious `\\n` escape for the null-command. 2020-03-01 22:37:31 +00:00			`Do not split multibyte characters.`
			`A character is written when its last byte is selected.`
Add mandoc-manpage for cut(1) and clean up code and mark it as finished in README. 2015-01-18 10:30:31 +00:00			`.It Fl s`
Add cut(1) 2013-10-08 19:39:08 +00:00			`Suppress lines not containing field delimiters.`
Add mandoc-manpage for cut(1) and clean up code and mark it as finished in README. 2015-01-18 10:30:31 +00:00			`.El`
			`.Sh STANDARDS`
			`The`
			`.Nm`
			`utility is compliant with the`
POSIX 2013 audit Mostly manpage-shuffling according to the changes in the corrigendum, wording changes and more idiomatic expressions. All this is finished up by marking the POSIX 2013 conformant tools with .St -p1003.1-2013 which is not available in older mandoc builds or nroff, but which reflects what we actually did, so who cares? This is a huge step and it's not far until we can release sbase 0.1. 2015-03-27 16:22:48 +00:00			`.St -p1003.1-2013`
Add mandoc-manpage for cut(1) and clean up code and mark it as finished in README. 2015-01-18 10:30:31 +00:00			`specification.`
			`.Pp`
fix mandoc warnings - sort references in SEE ALSO section to section number, name. - cols.1: proper order of sections. - wrap lines to max 79 column length. 2015-01-31 13:43:27 +00:00			`The possibility of separating numbers and ranges with a space and specifying`
			`multibyte delimiters of arbitrary length is an extension to that specification.`