1.0;crpad (create_pad), revision 1.0, 84/03/21
CRPAD (CREATE_PAD) -- Create a transcript pad and window.
usage:  CRPAD [pathname | -IN[PUT]] [-TEE] [-PN pathname]


FORMAT

  CRPAD [pathname] [options]


  CRPAD  creates  a  transcript pad, copies a file (or standard input) into that
  pad, and then opens a window into the pad.  This new pad is NOT related to the
  transcript pad attached to processes running the Shell; it is for viewing file
  contents only.  This is primarily useful for displaying output being  produced
  inside a pipeline without interrupting the flow of control in the pipe.

  Transcript  pads  are  not editable.  If you wish to place a file in a pad for
  editing, use the <EDIT> key or the DM command CE (CREATE_EDIT).

  CRPAD -IN behaves differently.  This creates an edit pad and lets  you  create
  whatever  text  you  want. When you close the edit pad (with WC or CONTROL-Y),
  that text is copied to standard output.


ARGUMENTS

  pathname
  (optional)         Specify the file to be copied into the pad.  Not  valid  if
                     -IN is present.

                     Default if omitted:  copy standard input.


OPTIONS

  -IN[PUT]            Copies  data  from  a  temporary  edit  window to standard
                     output.  Not valid if -TEE or -PN are specified.

  -PN pathname       Specify a pathname for the pad. If you specify a  pathname,
                     the pad is saved in that file.  Note that you can also save
                     the  pad  after  it  is  created by using the DM command PN
                     (PAD_NAME).

  -TEE               Copy output to standard output in addition to the new pad.


EXAMPLES

  1. $ crpad test.data    Create a pad that displays
                           the file "test.data".

  2. $ fpat -p '256-' <phone.book | crpad -tee | srf >phone.book.local
                          Display the intermediate results
                           in a pipeline.

  3. $ crpad -input | srf | crpad
                          Create an edit pad. When the pad is closed,
                           sort the text edited and display it in a
                           transcript pad.


RELATED TOPICS

  More information is available.  Type:

  - HELP PN
    for details about saving pads in files.

  - HELP WC
    for details about closing windows.

  - HELP TEE
    for details about copying intermediate results in a  pipeline  into  a  disk
    file.