Return to vis.1 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.bin / vis

Annotation of 43BSDReno/usr.bin/vis/vis.1, revision 1.1.1.1

1.1       root        1: .\" Copyright (c) 1989 The Regents of the University of California.
                      2: .\" All rights reserved.
                      3: .\"
                      4: .\" Redistribution and use in source and binary forms are permitted
                      5: .\" provided that the above copyright notice and this paragraph are
                      6: .\" duplicated in all such forms and that any documentation,
                      7: .\" advertising materials, and other materials related to such
                      8: .\" distribution and use acknowledge that the software was developed
                      9: .\" by the University of California, Berkeley.  The name of the
                     10: .\" University may not be used to endorse or promote products derived
                     11: .\" from this software without specific prior written permission.
                     12: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
                     13: .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
                     14: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
                     15: .\"
                     16: .\"    @(#)vis.1       1.2 (Berkeley) 6/29/90
                     17: .\"
                     18: .TH VIS 1 "June 29, 1990"
                     19: .UC 7
                     20: .SH NAME
                     21: vis \- display non-printable characters in a visual format
                     22: .SH SYNOPSIS
                     23: .B vis
                     24: [
                     25: .B \-nwctsobfl
                     26: ] [
                     27: .B \-F
                     28: foldwidth
                     29: ] [ file ... ]
                     30: .SH DESCRIPTION
                     31: \fIVis\fP is a filter for converting non-printable characters
                     32: into a visual representation.  It differs from cat -v in that
                     33: the form is unique and invertible.  By default, all non-graphic
                     34: characters except space, tab, and newline are encoded.
                     35: A detailed description of the
                     36: various visual formats is given in vis(3).
                     37: .SH OPTIONS
                     38: .IP -c
                     39: Request a format which displays a small subset of the
                     40: non-printable characters using C-style backslash sequences.
                     41: .IP -o
                     42: Request a format which displays non-printable characters as
                     43: an octal number, \\ddd.
                     44: .IP -t
                     45: Tabs are also encoded.
                     46: .IP -w
                     47: White space (space-tab-newline) is also encoded.
                     48: .IP -s
                     49: Only characters considered unsafe to send to a terminal are encoded.
                     50: This flag allows backspace, bell, and carriage return in addition
                     51: to the default space, tab and newline.
                     52: .IP -f
                     53: and
                     54: .IP -F
                     55: Causes
                     56: .B vis
                     57: to fold output lines to foldwidth columns (default 80), like fold(1), except
                     58: that a hidden newline sequence is used, (which is removed
                     59: when inverting the file back to its original form with unvis(1)).
                     60: If the last character in the encoded file does not end in a newline,
                     61: a hidden newline sequence is appended to the output.
                     62: This makes
                     63: the output usuable with various editors and other utilities which
                     64: typically don't work with partial lines.
                     65: .IP -n
                     66: Turns off any encoding, except for the fact that backslashes are
                     67: still doubled and hidden newline sequences inserted if -f or -F
                     68: is selected.  When combined with the -f flag, vis becomes like
                     69: an invertible version of the fold(1) utility.  That is, the output
                     70: can be unfolded by running the output through unvis(1).
                     71: .IP -b
                     72: Turns off prepending of backslash before up-arrow control sequences
                     73: and Meta characters, and disables the doubling of backslashes.  This
                     74: produces output which is neither invertible or precise, but does
                     75: represent a minimum of change to the input.  It is similar to cat -v.
                     76: .IP -l
                     77: Mark newlines with the visable sequence '\\$', followed by the newline.
                     78: .SH "SEE ALSO
                     79: unvis(1) vis(3)

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.