SHOW_DIRECTORY

  .  Summary

  show_directory(str <filespec>, int <cecho>, int <carrier>);

  .  Description

  The show_directory function displays a files directory listing to
  the screen and optionally echoes it to the comm port. The <filespec>
  is the file mask to use (e.g., "*.*"), and may also include a drive
  and/or directory, just like the DOS 'dir' command. If the <cecho>
  argument is non-zero (TRUE), the listing is also be echoed to the
  comm port. If the <carrier> argument is non-zero (TRUE) and the
  listing is being echoed to the comm port, the carrier signal is mon-
  itored in case the connection is lost (which aborts the display).
  The user is prompted to press a key after every screen full of data.

  .  Return Value

  None.

  .  Example

  show_directory("*.DOC", 0, 0);