Changeset View
Changeset View
Standalone View
Standalone View
usr.bin/cmb/cmb.1
- This file was added.
Property | Old Value | New Value |
---|---|---|
svn:eol-style | null | native \ No newline at end of property |
svn:keywords | null | FreeBSD=%H \ No newline at end of property |
svn:mime-type | null | text/plain \ No newline at end of property |
.\" Copyright (c) 2018 Devin Teske <dteske@FreeBSD.org> | |||||||||||
.\" All rights reserved. | |||||||||||
pauamma_gundo.com: SPDX license ID for new files. | |||||||||||
.\" | |||||||||||
.\" Redistribution and use in source and binary forms, with or without | |||||||||||
.\" modification, are permitted provided that the following conditions | |||||||||||
.\" are met: | |||||||||||
.\" 1. Redistributions of source code must retain the above copyright | |||||||||||
.\" notice, this list of conditions and the following disclaimer. | |||||||||||
.\" 2. Redistributions in binary form must reproduce the above copyright | |||||||||||
.\" notice, this list of conditions and the following disclaimer in the | |||||||||||
.\" documentation and/or other materials provided with the distribution. | |||||||||||
.\" | |||||||||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND | |||||||||||
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |||||||||||
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |||||||||||
.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE | |||||||||||
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |||||||||||
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |||||||||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |||||||||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |||||||||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |||||||||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |||||||||||
.\" SUCH DAMAGE. | |||||||||||
.\" | |||||||||||
.\" $FreeBSD$ | |||||||||||
.\" | |||||||||||
Not Done Inline ActionsNo longer needed. pauamma_gundo.com: No longer needed. | |||||||||||
.Dd July 4, 2018 | |||||||||||
.Dt CMB 1 | |||||||||||
Not Done Inline ActionsBump. pauamma_gundo.com: Bump. | |||||||||||
.Os | |||||||||||
.Sh NAME | |||||||||||
.Nm cmb | |||||||||||
.Nd combinatorics utility | |||||||||||
.Sh SYNOPSIS | |||||||||||
.Nm | |||||||||||
.Op Fl 0t | |||||||||||
.Op Fl c Ar # | |||||||||||
.Op Fl d Ar str | |||||||||||
.Op Fl i Ar # | |||||||||||
.Op Fl k Ar range | |||||||||||
.Op Fl p Ar str | |||||||||||
.Op Fl s Ar str | |||||||||||
.Ar item1 | |||||||||||
.Ar ... | |||||||||||
.Sh DESCRIPTION | |||||||||||
The | |||||||||||
.Nm | |||||||||||
utility prints combinations, | |||||||||||
one per line | |||||||||||
.Pq default , | |||||||||||
separated by space | |||||||||||
.Pq default . | |||||||||||
.Pp | |||||||||||
Available options: | |||||||||||
.Bl -tag -width ".Fl r Ar range" | |||||||||||
.It Fl 0 | |||||||||||
Terminate combinations with ASCII NUL | |||||||||||
.Pq character code 0 | |||||||||||
instead of newline. | |||||||||||
Use in conjunction with | |||||||||||
.Dq Li xargs -0 | |||||||||||
for example. | |||||||||||
.It Fl c Ar num | |||||||||||
Not Done Inline Actions
pauamma_gundo.com: | |||||||||||
Produce | |||||||||||
Not Done Inline Actions
pauamma_gundo.com: | |||||||||||
.Ar num | |||||||||||
Not Done Inline Actions
pauamma_gundo.com: | |||||||||||
combinations. | |||||||||||
If | |||||||||||
Not Done Inline Actions
pauamma_gundo.com: | |||||||||||
.Ql 0 | |||||||||||
.Pq default | |||||||||||
all combinations produced. | |||||||||||
.It Fl d Ar text | |||||||||||
Delimiter for separating items. | |||||||||||
Default is space. | |||||||||||
.It Fl i Ar num | |||||||||||
Not Done Inline Actions
pauamma_gundo.com: | |||||||||||
Set starting position in combination set. | |||||||||||
Default is 1. | |||||||||||
.It Fl k Ar range | |||||||||||
Number or range | |||||||||||
Not Done Inline Actions
pauamma_gundo.com: | |||||||||||
.Pq Qo min..max Qc or Qo min-max Qc | |||||||||||
of how many items appear in each combination. | |||||||||||
A value of | |||||||||||
.Ql 0 | |||||||||||
.Pq default | |||||||||||
calculates all combinations. | |||||||||||
.It Fl n Ar num | |||||||||||
Use | |||||||||||
.Ar num | |||||||||||
arguments. | |||||||||||
Default is to use all arguments. | |||||||||||
.It Fl p Ar text | |||||||||||
Prefix each combination with | |||||||||||
.Ar text . | |||||||||||
.It Fl s Ar text | |||||||||||
Suffix each combination with | |||||||||||
.Ar text . | |||||||||||
.It Fl t | |||||||||||
Print total number of combinations and exit. | |||||||||||
.El | |||||||||||
.Sh HISTORY | |||||||||||
Not Done Inline Actions
pauamma_gundo.com: | |||||||||||
The | |||||||||||
.Nm | |||||||||||
utility first appeared in | |||||||||||
.Fx 13.0 . | |||||||||||
.Sh AUTHORS | |||||||||||
.An Devin Teske Aq Mt dteske@FreeBSD.org | |||||||||||
Not Done Inline Actions
pauamma_gundo.com: | |||||||||||
Not Done Inline ActionsMaybe add that the limit is 2^32-1 for people who don't have powers of 2 memorized and to explain why it's that. pauamma_gundo.com: Maybe add that the limit is 2^32-1 for people who don't have powers of 2 memorized and to… | |||||||||||
Not Done Inline Actions
pauamma_gundo.com: | |||||||||||
Not Done Inline Actions
pauamma_gundo.com: | |||||||||||
Not Done Inline Actions
pauamma_gundo.com: | |||||||||||
Not Done Inline ActionsI guess it's 15.0 now. pauamma_gundo.com: I guess it's 15.0 now. |
SPDX license ID for new files.