Files
lbmk/util/sbase/tr.1
Leah Rowe e9a910b33c config/git: import suckless sbase
i currently use the output of sha512sum in several
places of xbmk, which is a bit unreliable in case
output changes.

other cases where i use util outputs in variables
are probably reliable, because i'm using mostly
posix utilities in those.

to mitigate this, i now import suckless sbase, which
has a reasonable sha512sum implementation.

*every* binary it builds is being placed in build.list,
because i'll probably start using more of them.

for example, i may start modifying the "date"
implementation, adding the GNU-specific options that
i need as mentioned on init.sh

i'm importing it in util/ because the sha512sum
util is needed for verifying project sources, so
if sbase itself is a "project source", that means
we can into a chicken and egg bootstrapping problem.

this is sbase at revision:
055cc1ae1b3a13c3d8f25af0a4a3316590efcd48

Signed-off-by: Leah Rowe <leah@libreboot.org>
2025-10-04 09:20:12 +01:00

85 lines
1.2 KiB
Groff

.Dd October 5, 2016
.Dt TR 1
.Os sbase
.Sh NAME
.Nm tr
.Nd translate characters
.Sh SYNOPSIS
.Nm
.Op Fl c | Fl C
.Op Fl sd
.Ar set1 set2
.Sh DESCRIPTION
.Nm
matches characters from stdin and performs translations to stdout.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl c | Fl C
Match to
.Ar set1
complement.
.It Fl d
Delete characters matching
.Ar set1 .
.It Fl s
Squeeze repeated characters matching
.Ar set1
or
.Ar set2
if
.Fl d
is set.
.El
.Sh SET
.Bl -tag -width Ds
.It Literal Sy c
.It Escape sequence Sy \ec
\e\e, \e', \e", \ea, \eb, \ee, \ef, \en, \er, \et, \ev, \exH[H], \eO[OO]
.It Range Sy c-d
.It Repeat Sy [c*n]
Only in
.Ar set2 .
If n = 0 or left out, set n to length of
.Ar set1 .
.It Character class Sy [:class:]
See
.Xr wctype 3 .
.It Equivalence class Sy [=c=]
Resolve to
.Sy c .
.El
.Sh TRANSLATION
If
.Fl d
is not set,
.Nm
translates from
.Ar set1
to
.Ar set2
by index or character class.
.Pp
If
.Ar set2
is shorter than
.Ar set1
or
.Ar set1
is a character class,
overflowing characters translate to the last character in
.Ar set2 .
.Sh EXIT STATUS
.Bl -tag -width Ds
.It 0
Input processed successfully.
.It 1
An error occurred.
.El
.Sh SEE ALSO
.Xr awk 1 ,
.Xr sed 1 ,
.Xr utf8 7
.Sh STANDARDS
POSIX.1-2013.
Except from equivalence classes.