version 1.5, 1999/06/05 01:21:49 |
version 1.6, 2000/03/14 14:58:25 |
|
|
.Op Fl F Ar foldwidth |
.Op Fl F Ar foldwidth |
.Op Ar file ... |
.Op Ar file ... |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
.Nm vis |
.Nm |
is a filter for converting non-printable characters |
is a filter for converting non-printable characters |
into a visual representation. It differs from |
into a visual representation. |
.Ql cat -v |
It differs from |
|
.Ic cat -v |
in that |
in that |
the form is unique and invertible. By default, all non-graphic |
the form is unique and invertible. |
|
By default, all non-graphic |
characters except space, tab, and newline are encoded. |
characters except space, tab, and newline are encoded. |
A detailed description of the |
A detailed description of the |
various visual formats is given in |
various visual formats is given in |
|
|
.Bl -tag -width Ds |
.Bl -tag -width Ds |
.It Fl b |
.It Fl b |
Turns off prepending of backslash before up-arrow control sequences |
Turns off prepending of backslash before up-arrow control sequences |
and meta-characters, and disables the doubling of backslashes. This |
and meta-characters, and disables the doubling of backslashes. |
produces output which is neither invertible nor precise, but does |
This produces output which is neither invertible nor precise, but does |
represent a minimum of change to the input. It is similar to |
represent a minimum of change to the input. |
.Dq Li cat -v . |
It is similar to |
|
.Ic cat -v . |
.It Fl c |
.It Fl c |
Request a format which displays a small subset of the |
Request a format which displays a small subset of the |
non-printable characters using C-style backslash sequences. |
non-printable characters using C-style backslash sequences. |
.It Fl F |
.It Fl F |
Causes |
Causes |
.Nm vis |
.Nm |
to fold output lines to foldwidth columns (default 80), like |
to fold output lines to foldwidth columns (default 80), like |
.Xr fold 1 , |
.Xr fold 1 , |
except |
except |
|
|
.Fl f |
.Fl f |
or |
or |
.Fl F |
.Fl F |
is selected. When combined with the |
is selected. |
|
When combined with the |
.Fl f |
.Fl f |
flag, |
flag, |
.Nm vis |
.Nm |
becomes like |
becomes like |
an invertible version of the |
an invertible version of the |
.Xr fold 1 |
.Xr fold 1 |
utility. That is, the output |
utility. |
|
That is, the output |
can be unfolded by running the output through |
can be unfolded by running the output through |
.Xr unvis 1 . |
.Xr unvis 1 . |
.It Fl o |
.It Fl o |