2.0;edstr (edit_stream), revision 1.1, 81/07/01
EDSTR (EDIT_STREAM) -- Edit a stream.
usage:  EDSTR { command | -E command | -F cmdfile ...} [pathname] [-N]


FORMAT

  EDSTR { command | -E command | -F cmdfile ...} [pathname] [option]


  EDSTR  copies  the named input files to standard output, performing editing as
  directed by EDSTR commands in the command line or in the named command file.


ARGUMENTS

  If neither the -E or -F argument is specified, EDSTR assumes  that  the  first
  token on the command line without a hyphen is an EDSTR command (see below) and
  that the remaining tokens (if any) are pathnames.

  command
  (optional)          Specify a single EDSTR command (except A, C, or I).  EDSTR
                     accepts the ED commands A, C, D, I, P, R, S, W, and =.   To
                     use  the  A, C, or I commands, place them in a command file
                     as described below.

                     Default if omitted:  use -E and/or -F

  The following two arguments may be  repeated  and  intermixed  in  any  order.
  EDSTR executes them in the order in which they appear on the command line.

  -E command
  (optional)          Specify  an EDSTR command (except A, C, or I).  To use the
                     A, C, or I commands,  place  them  in  a  command  file  as
                     described  below.   EDSTR can accommodate commands totaling
                     approximately 5000 characters (including <text> arguments),
                     and lines up to 120 characters long.

                     Default if omitted:  use 'command' or -F

  -F cmdfile
  (optional)         Specify a file containing EDSTR  commands,  one  per  line.
                     Control is passed to this file for command processing.  See
                     -E for EDSTR command restrictions.

                     Default if omitted:  use 'command' or -E

  pathname
  (optional)          Specify  input  file to be edited.  Multiple pathnames are
                     permitted.

                     Default if omitted:  edit standard input


OPTIONS

  -N                 Supress  writing  of  output  except  for  P  and  W  EDSTR
                     commands.    By default, EDSTR writes each line of input to
                     standard output after editing.


EXAMPLES

    $ edstr -e s/joe/mary/g -e 20r add_stuff infile >outfile

  This command first replaces all occurences of "joe" with "mary",  then  copies
  material in the file "add_stuff" into "infile" following line 20.  Results are
  written to the file "outfile".


RELATED TOPICS

  More information is available.  Type:

  - HELP EDSTR COMMANDS
    for a summary of EDSTR commands.

  - HELP ED COMMANDS
    for a complete description of the commands.