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     ! 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.