Return to ex.1 CVS log

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

Annotation of 43BSDReno/usr.bin/ex/ex.1, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1980, 1990 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted provided
        !             5: .\" that: (1) source distributions retain this entire copyright notice and
        !             6: .\" comment, and (2) distributions including binaries display the following
        !             7: .\" acknowledgement:  ``This product includes software developed by the
        !             8: .\" University of California, Berkeley and its contributors'' in the
        !             9: .\" documentation or other materials provided with the distribution and in
        !            10: .\" all advertising materials mentioning features or use of this software.
        !            11: .\" Neither the name of the University nor the names of its contributors may
        !            12: .\" be used to endorse or promote products derived from this software without
        !            13: .\" specific prior written permission.
        !            14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
        !            15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
        !            16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            17: .\"
        !            18: .\"     @(#)ex.1       6.6 (Berkeley) 7/24/90
        !            19: .\"
        !            20: .Dd July 24, 1990
        !            21: .Dt EX 1
        !            22: .Os BSD 4
        !            23: .Sh NAME
        !            24: .Nm ex , edit
        !            25: .Nd text editor
        !            26: .Sh SYNOPSIS
        !            27: .Nm ex
        !            28: .Op Fl
        !            29: .Op Fl v
        !            30: .Op Fl t Ar tag
        !            31: .Op Fl r
        !            32: .Oo
        !            33: .Op Cm + Ar command
        !            34: .Oo
        !            35: .Op Fl l
        !            36: .Ar name
        !            37: \&...
        !            38: .Nm edit
        !            39: .Op ex options
        !            40: .Sh DESCRIPTION
        !            41: .Nm Ex
        !            42: is the root of a family of editors:
        !            43: .Nm edit ,
        !            44: .Nm ex
        !            45: and
        !            46: .Nm vi .
        !            47: .Nm Ex
        !            48: is a superset of
        !            49: .Xr ed ,
        !            50: with the most notable extension being a display editing facility.
        !            51: Display based editing is the focus of
        !            52: .Xr vi 1 .
        !            53: .Pp
        !            54: If you have not used
        !            55: .Xr ed 1 ,
        !            56: or are a casual user, you will find that the editor
        !            57: .Nm edit
        !            58: is convenient for you.
        !            59: It avoids some of the complexities of
        !            60: .Nm ex
        !            61: used mostly by systems programmers and persons very familiar with
        !            62: .Xr ed 1 .
        !            63: .Pp
        !            64: If you have a
        !            65: .Li CRT
        !            66: terminal, you may wish to use a display
        !            67: based editor; in this case
        !            68: see
        !            69: .Xr vi  1  ,
        !            70: which is a command which focuses on the display editing portion of
        !            71: .Nm ex .
        !            72: .Sh DOCUMENTATION
        !            73: The document
        !            74: .Em Edit: A tutorial
        !            75: (USD:14) provides a comprehensive introduction to
        !            76: .Nm edit
        !            77: assuming no previous knowledge of computers or the UNIX
        !            78: system.
        !            79: .Pp
        !            80: The
        !            81: .Em Ex Reference Manual \- Version 3.7
        !            82: (USD:16)
        !            83: is a comprehensive and complete manual for the command mode features
        !            84: of
        !            85: .Nm ex ,
        !            86: but you cannot learn to use the editor by reading it.
        !            87: For an introduction to
        !            88: more advanced forms of editing using the command mode of
        !            89: .Nm ex
        !            90: see the editing documents written by Brian Kernighan for the editor
        !            91: .Xr ed 1 ;
        !            92: the material in the introductory and advanced documents works also with
        !            93: .Nm ex .
        !            94: .Pp
        !            95: .Em An Introduction to Display Editing with Vi
        !            96: (USD:15)
        !            97: introduces the display editor
        !            98: .Xr vi 1
        !            99: and provides reference material on
        !           100: .Xr vi 1 .
        !           101: In addition, the
        !           102: .Em Vi Quick Reference
        !           103: card summarizes the commands
        !           104: of
        !           105: .Xr vi 1
        !           106: in a useful, functional way, and is useful with the
        !           107: .Em Introduction .
        !           108: .Sh ENVIRONMENT
        !           109: The
        !           110: .Nm
        !           111: command uses the following environment variables.
        !           112: .Tw Fl
        !           113: .Tp Ev EXINIT
        !           114: User specified startup values for
        !           115: .Nm ex .
        !           116: .Tp Ev HOME
        !           117: Default directory to search for
        !           118: the file
        !           119: .Pa ~/.exrc
        !           120: .Tp Ev SHELL
        !           121: Shell used for
        !           122: .Em escaped
        !           123: commands (with the
        !           124: .Ic \&!
        !           125: command).
        !           126: .Tp Ev TERM
        !           127: Terminal type.
        !           128: .Tp Ev TERMCAP
        !           129: Alternate termcap file.
        !           130: .Tp
        !           131: .Sh FILES
        !           132: .Dw /usr/libexec/ex?.?preserve
        !           133: .Di L
        !           134: .Dp Pa  /usr/libexec/ex?.?strings
        !           135: error messages
        !           136: .Dp Pa  /usr/libexec/ex?.?recover
        !           137: recover command
        !           138: .Dp Pa  /usr/libexec/ex?.?preserve
        !           139: preserve command
        !           140: .Dp Pa  /usr/share/misc/termcap
        !           141: describes capabilities of terminals
        !           142: .Dp Pa  ~/.exrc
        !           143: editor startup file
        !           144: .Dc Pa /tmp/Ex
        !           145: .Ar nnnnn
        !           146: .Cx
        !           147: editor temporary
        !           148: .Dc Pa /tmp/Rx
        !           149: .Ar nnnnn
        !           150: .Cx
        !           151: named buffer temporary
        !           152: .Dp Pa /var/preserve
        !           153: preservation directory
        !           154: .Dp
        !           155: .Sh SEE ALSO
        !           156: .Xr awk 1 ,
        !           157: .Xr ed 1 ,
        !           158: .Xr grep 1 ,
        !           159: .Xr sed 1 ,
        !           160: .Xr grep 1 ,
        !           161: .Xr vi 1 ,
        !           162: .Xr termcap 5 ,
        !           163: .Xr environ 7
        !           164: .Sh HISTORY
        !           165: .Nm Ex
        !           166: appeared in 3 BSD.
        !           167: .Sh AUTHOR
        !           168: Originally written by William Joy
        !           169: .br
        !           170: Mark Horton has maintained the editor since version 2.7, adding macros,
        !           171: support for many unusual terminals,
        !           172: and other features such as word abbreviation mode.
        !           173: .Sh BUGS
        !           174: The
        !           175: .Ic undo
        !           176: command causes all marks to be lost on lines changed and then restored
        !           177: if the marked lines were changed.
        !           178: .Pp
        !           179: .Ic Undo
        !           180: never clears the buffer modified condition.
        !           181: .Pp
        !           182: The
        !           183: .Ic z
        !           184: command prints a number of logical rather than physical lines.
        !           185: More than a screen full of output may result if long lines are present.
        !           186: .Pp
        !           187: File input/output errors don't print a name if the command line
        !           188: .Sq Fl
        !           189: option is used.
        !           190: .Pp
        !           191: There is no easy way to do a single scan ignoring case.
        !           192: .Pp
        !           193: The editor does not warn if text is placed in named buffers and not used
        !           194: before exiting the editor.
        !           195: .Pp
        !           196: Null characters are discarded in input files, and cannot appear in resultant
        !           197: files.

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