=================================================================== RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/vis/vis.1,v retrieving revision 1.5 retrieving revision 1.6 diff -u -r1.5 -r1.6 --- src/usr.bin/vis/vis.1 1999/06/05 01:21:49 1.5 +++ src/usr.bin/vis/vis.1 2000/03/14 14:58:25 1.6 @@ -1,4 +1,4 @@ -.\" $OpenBSD: vis.1,v 1.5 1999/06/05 01:21:49 aaron Exp $ +.\" $OpenBSD: vis.1,v 1.6 2000/03/14 14:58:25 aaron Exp $ .\" $NetBSD: vis.1,v 1.5 1994/11/17 07:56:00 jtc Exp $ .\" .\" Copyright (c) 1989, 1991, 1993, 1994 @@ -46,12 +46,14 @@ .Op Fl F Ar foldwidth .Op Ar file ... .Sh DESCRIPTION -.Nm vis +.Nm is a filter for converting non-printable characters -into a visual representation. It differs from -.Ql cat -v +into a visual representation. +It differs from +.Ic cat -v 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. A detailed description of the various visual formats is given in @@ -61,16 +63,17 @@ .Bl -tag -width Ds .It Fl b Turns off prepending of backslash before up-arrow control sequences -and meta-characters, and disables the doubling of backslashes. This -produces output which is neither invertible nor precise, but does -represent a minimum of change to the input. It is similar to -.Dq Li cat -v . +and meta-characters, and disables the doubling of backslashes. +This produces output which is neither invertible nor precise, but does +represent a minimum of change to the input. +It is similar to +.Ic cat -v . .It Fl c Request a format which displays a small subset of the non-printable characters using C-style backslash sequences. .It Fl F Causes -.Nm vis +.Nm to fold output lines to foldwidth columns (default 80), like .Xr fold 1 , except @@ -95,14 +98,16 @@ .Fl f or .Fl F -is selected. When combined with the +is selected. +When combined with the .Fl f flag, -.Nm vis +.Nm becomes like an invertible version of the .Xr fold 1 -utility. That is, the output +utility. +That is, the output can be unfolded by running the output through .Xr unvis 1 . .It Fl o