62 lines
1.2 KiB
Groff
62 lines
1.2 KiB
Groff
.Dd July 15, 2025
|
|
.Dt valid-utf8 1
|
|
.Os
|
|
.Sh NAME
|
|
.Nm valid-utf8
|
|
.Nd check whether text is utf-8 encoded or not
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Fl h
|
|
.Nm
|
|
.Fl \-version
|
|
.Nm
|
|
.Op Ar
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility reads the files given as arguments, and sets its exit status to 0 when
|
|
the text has been detected to be valid UTF-8, or to 1 otherwise.
|
|
When no file arguments are given,
|
|
.Nm
|
|
will read from the standard input.
|
|
.Pp
|
|
.Nm
|
|
will not write anything to the standard output, and will only write error
|
|
messages, if any, to the standard error output.
|
|
.Pp
|
|
This behaviour makes
|
|
.Nm
|
|
useful as a
|
|
.Ar -exec
|
|
criterion for the
|
|
.Xr find 1
|
|
tool.
|
|
.Pp
|
|
The options are as follows:
|
|
.Bl -tag -width Ds
|
|
.It Fl h, \-help
|
|
Print help text and exit.
|
|
.It Fl \-version
|
|
Print version info and exit.
|
|
.El
|
|
.\" .Sh ENVIRONMENT
|
|
.\" For sections 1, 6, 7, and 8 only.
|
|
.\" .Sh FILES
|
|
.Sh EXIT STATUS
|
|
.\" For sections 1, 6, and 8 only.
|
|
.Nm
|
|
exits 0 when the text is encoded in valid UTF-8, and 1 otherwise, or if an error
|
|
occurs.
|
|
.\" .Sh EXAMPLES
|
|
.\" .Sh DIAGNOSTICS
|
|
.\" For sections 1, 4, 6, 7, 8, and 9 printf/stderr messages only.
|
|
.\" .Sh SEE ALSO
|
|
.\" .Xr foobar 1
|
|
.\" .Sh STANDARDS
|
|
.\" .Sh HISTORY
|
|
.Sh AUTHORS
|
|
.An Bob Polis
|
|
.\" .Sh CAVEATS
|
|
.\" .Sh BUGS
|
|
.\" .Sh SECURITY CONSIDERATIONS
|