Return to readme CVS log

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

Annotation of pmsdk/samples/comtalk/readme, revision 1.1.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.