Return to readme CVS log

Up to [OS/2 SDKs] / pmsdk / samples / comtalk

Annotation of pmsdk/samples/comtalk/readme, revision 1.1

1.1     ! root        1: Comments about COMTALK
        !             2: 
        !             3: Comtalk is a PM communications program.  It is broken up into five modules:
        !             4: 
        !             5: AVIO           This module controls AVIO interactions.  In this routine,
        !             6:                the window size and scrollbars are controlled.
        !             7: 
        !             8: CIRCLEQ                This module controls the circular queue buffer with which
        !             9:                the AVIO module updates the screen.
        !            10: 
        !            11: COMPORT                This module controls reading and writing characters from
        !            12:                the communications port (makes DosDevIOCtl calls, etc...)
        !            13: 
        !            14: COMTALK                This module contains the main window procedure, and processes
        !            15:                user input
        !            16: 
        !            17: THREADS                This module contains 3 secondary threads, which write characters
        !            18:                to the COM port, read from the COM port, and one which takes
        !            19:                characters read from the COM port and pushes them into the
        !            20:                circular line buffer queue.
        !            21: 
        !            22: Possible improvements to this program include:  File transfer capabilities,
        !            23: terminal emulation, small fonts (AVIO).  Also, it might be reasonable to
        !            24: do away with Paging Mode, or make it like Windows Terminal (so that a scrollbar
        !            25: through your entire buffer becomes present when you pause and look at things,
        !            26: then only one screenful is present when you are not in that mode).
        !            27: 
        !            28: 
        !            29: Directory Contents:
        !            30: AVIO.C         AVIO module source routines
        !            31: AVIO.H         AVIO module prototypes
        !            32: CIRCLEQ.C      Circular queue module source
        !            33: CIRCLEQ.H      Circular queue prototypes
        !            34: COMPORT.C      COM port interface
        !            35: COMPORT.H      COM port interface prototypes
        !            36: COMTALK                Makefile
        !            37: COMTALK.C      Core routines
        !            38: COMTALK.DEF    Definition file
        !            39: COMTALK.EXE    Executable
        !            40: COMTALK.H      Resource Identifiers
        !            41: COMTALK.ICO    Icon
        !            42: COMTALK.RC     Resources
        !            43: COMTALK.SYM    Symbol file
        !            44: GLOBAL.H       Definitions common to all modules
        !            45: THREADS.C      Secondary threads module
        !            46: THREADS.H      Secondary thread module prototypes
        !            47: 
        !            48: 
        !            49: Problems:
        !            50:     This application uses AVIO, but the implementation is not very clean.
        !            51:     Merging in the AVIO support from the BROWSE sample might be reasonable.
        !            52: 
        !            53:     Also, the vertical scroll bar has only a page worth of range, instead
        !            54:     of the entire lookback buffer.  (looking back a page can be done with
        !            55:     PgUp and PgDn in "paging mode")
        !            56: 
        !            57:     When you "catch up" and are at the bottom line, in paging mode, you should
        !            58:     automatically get out of paging mode.
        !            59: 
        !            60:     If you move the icon of COMTALK, sometimes the horizontal scroll bar
        !            61:     appears atop it.  This is not a problem with the Browse scrollbar
        !            62:     hiding/showing code.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.