edstr — Apollo

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 | args...} [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.


COMMANDS

  o  For a summary of EDSTR commands, type:

    - HELP EDSTR COMMANDS

  o  For a complete description of the commands, type:

    - HELP ED COMMANDS


EXAMPLE

  $ 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".
Museum
