Click above to get retro games delivered to your door ever month!

   Input Watches

   Every character read from a serial port is passed through the input
   watch system.  This system allows you to specify "watch strings",
   sequences of characters which are interesting to you and which you
   would like to take note of when received.  The input watch concept is
   similar to tp_waitfor(), except that it scans for interesting text in
   the background, allowing you to process serial input normally.

   Input watches are particularly useful in connection with the terminal
   emulation facility.  When an emulator is running, receiving any watch
   string triggers a call to the emulator's exception handler.  This can
   be used for things like Zmodem auto-downloads, where the presence of
   a special "Zmodem request init" string in the input starts a
   download.

   When not using a terminal emulator, you process input watches
   yourself, by calling one of the functions which returns information
   on which watch strings have been received.

   The functions related to input watches are:

   tp_watch()      Set input watch.
   tp_iswatch()    Tell whether watch has matched.
   tp_getwatch()   Find next matched watch.
   tp_watchoff()   Delete input watch.