home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / PROG_GEN / FACETV.ZIP / FILELIST.TXT < prev    next >
Text File  |  1994-01-03  |  8KB  |  215 lines
  1.  
  2.  
  3. FILELIST.TXT    01/03/93    Chris Ahlstrom
  4.  
  5.     ╔═════════════════════════════════════════════╗
  6.     ║                                             ║
  7.     ║  Converting food to code for a better life  ║
  8.     ║                                             ║
  9.     ╚═════════════════════════════════════════════╝
  10.  
  11.     To make up for my awful documentation, I've tried to do a
  12. number of things.  First, there's this file, which summarizes the
  13. modules so you'll have some way of collecting your thoughts.
  14. Second, I've got some other minor docs you can read.  Finally,
  15. and most important of all, I've provided lots of fairly clearly
  16. written code, done in a very readable style (I feel), with
  17. more comments than most code I've seen.  And an example application
  18. to boot.
  19.  
  20.     Not bad for free!  Call me at (803)849-0985 (Eastern
  21. Standard Time, try not to call after 10:00 PM), or catch me
  22. on Compuserve [73340,26] if you really want to use this code,
  23. but got stuck.
  24.  
  25.     Please note that this code depends on having Borland C/C++
  26. 3.0 and above, and Borland's Application Frameworks 3.1 or above.
  27.  
  28.  
  29.  
  30.  
  31. DOCUMENTATION
  32.  
  33.     autoexec.bcc    Some settings the makefile needs
  34.  
  35.     dialogs.txt        Crappy, very incomplete description of the
  36.             FACE_TV library.  See the source code and
  37.             test program modules.
  38.  
  39.     face_tv.zip        Compressed source file for the library; it
  40.             is not included.  You have to make it.
  41.             See the procedures roughly documented in
  42.             install.bat.
  43.  
  44.     filelist.txt    This file rite-chere.
  45.  
  46.     install.bat        A rough attempt to install the code.  It's
  47.             much safer to read this file first, edit it,
  48.             and then maybe try to run it.  You do read
  49.             install.bat files before you run them, don't
  50.             you?  Or do you like cleaning up afterward
  51.             (smile).
  52.  
  53.     readme.1st        Read this even before install.bat.
  54.  
  55.  
  56. OBJECT CODE CREATED BY THE MAKEFILE
  57.  
  58.     face_tv.exe        Test bed and example program.  Demonstrates
  59.             a lot of the features of the FACE_TV
  60.             library.
  61.  
  62.     face_tv.lib        The meat of the code.  Give me a call if
  63.             you want to see another application (much
  64.             more complex) that uses this library.
  65.  
  66.  
  67. SOURCE CODE
  68.  
  69.     announce.cpp    Early-version support for message and error
  70.     announce.h        classes.
  71.  
  72.     bios_vid.h        Resolves some DOS references.  This file
  73.             actually comes from another library.
  74.  
  75.     boxtools.cpp    Utilities for making calculations concerning
  76.     boxtools.h        box-shape displays of text and strings.
  77.  
  78.     cnscreen.h        Header file for C interface to C++-implemented
  79.             dumb terminal window.
  80.  
  81.     compiler.h        Not really sure if this is used... just some
  82.             standard compiler-dependent declarations.
  83.  
  84.     dlg_box.cpp        Similar to the tbox modules, but is not meant
  85.     dlg_box.h        to define a base class for TApplications.
  86.             Instead, the dialog-box object is created
  87.             inside the TApplication.  A very new module.
  88.  
  89.     dosshell.cpp    A base class to provide a DOS-shell function
  90.     dosshell.h        for any TApplication.
  91.  
  92.     face_box.h        Bogus data types, data, and dialog-box declarations
  93.     face_box.men    (MenuFields) for the test program.  Actually,
  94.             these modules contain quite a lot of explanation.
  95.  
  96.     face_tv.cpp        The main program and module for the test
  97.     face_tv.h        application.  The *.MEN file defines the
  98.     face_tv.men        menu-bar and status-bar using NestItems.
  99.  
  100.     filedlg.cpp        Supports obtaining complete filenames, drive,
  101.     filedlg.h        path, and all.  Similar to code from Borland,
  102.             but more elaborate.
  103.  
  104.     heapview.cpp    Support for using the heap for debugging, very
  105.     heapview.h        similar to Borland's example code.
  106.  
  107.     makefile        The latest and greatest makefile.
  108.  
  109.     makefile.bcc    Sometimes the latest and greatest makefile.
  110.             I go back to it if I really screwed up the
  111.             makefile.
  112.  
  113.     menubars.cpp    A base class that provides menu-bar support
  114.     menubars.h        for a TApplication.
  115.  
  116.     rbuttons.cpp    Turbo Vision version of support for "button"
  117.     rbuttons.h        code for mouse, keyboard, and Koala pad.
  118.  
  119.     respintr.cpp    Turbo Vision version of support for a window
  120.     respintr.h        containing flashing lights for feedback and
  121.             a "button" device for making responses to
  122.             these lights.
  123.  
  124.     respwind.cpp    Turbo Vision version of support for a window
  125.     respwind.h        containing flashing lights to display feedback
  126.             in an experiment.  These modules implement
  127.             the "public" interface.  The "private" parts
  128.             come from the rbuttons and respintr modules.
  129.  
  130.     screnmsg.cpp    The C++ version of the routine callers use
  131.     screnmsg.h        to write messages to a dumb terminal window.
  132.  
  133.     scrnmsg.c        The C version of the dumb-terminal routine.
  134.  
  135.     tbox.cpp        A base class providing dialog-box support
  136.     tbox.h        based on MenuField arrays that describe the
  137.             the dialog box in gory detail.  This class
  138.             does save a lot of effort in writing code
  139.             to create dialog boxes.
  140.  
  141.     textmode.cpp    Supports the text mode of DOS.  I can't
  142.     textmode.h        remember exactly what this is for.
  143.  
  144.     timerctl.cpp    Defines a special timer class for use in DOS
  145.     timerctl.h        applications... implemented generically so
  146.     timerctl.err    that the code interface under Windows is the
  147.             same as for DOS.
  148.  
  149.     tinpextd.cpp    Defines a class that provides a support for
  150.     tinpextd.h        using the keyboard arrow keys or the mouse
  151.             for altering numeric data as if it were like
  152.             a volume control.  I first wrote a similar,
  153.             but more full-featured controller for floating
  154.             numbers (see tinpmous.cpp/h), but then decided
  155.             that all numeric fields should have the
  156.             same abilities.
  157.  
  158.     tinpmous.cpp    Defines a way to control the Float field using
  159.     tinpmous.h        the mouse or arrow keys.  Also supports hooking
  160.             in a control-function that is called every
  161.             time the numeric value changes (good for
  162.             implementing volume controls).  The test program
  163.             has a couple of fields that use this feature.
  164.  
  165.     tinput.cpp        All the extensions to TInputLine for supporting
  166.     tinput.h        text entry, numeric data entry, and button-
  167.             boxes.
  168.  
  169.     tmouse.c        A couple of mouse routines to supplement
  170.     tmouse.h        what Turbo Vision provides.
  171.  
  172.     tv_box.h        A very recent module... I was planning on
  173.             trying to support Turbo Vision and Windows
  174.             programs with the same set of classes, but
  175.             decided that was much to painful and, even
  176.             if it worked, confusing.  So I dropped the
  177.             idea.
  178.  
  179.     tv_code.h        A bunch of Uses_ defines and an #include of
  180.             tv.h.
  181.  
  182.     tv_confg.cpp    Handles reading and writing of configuration
  183.     tv_confg.h        files in a simple, but safe, way.
  184.     tv_confg.err
  185.  
  186.     tv_menu.h        Defines NestItems, MenuItems, MenuFields, and
  187.             all that ugly MappedField stuff (that last is
  188.             for mouse/arrow-key support).
  189.  
  190.     tvscreen.cpp    A class for supporting a dumb terminal window
  191.     tvscreen.h        that is very useful for logging all error
  192.             messages to (where they can be reviewed later
  193.             as well).  I got sick of trying to pass back
  194.             integer error codes and sort out what
  195.             messages to print.
  196.  
  197.     tvyesno.h        Useful for stock Yes/No buttons.
  198.  
  199.  
  200. FILES CREATED BY THE MAKEFILE
  201.  
  202.     I'm not including the *.LIB, *.OBJ, or *.EXE files created
  203. by the makefile... the title refers to the help, configuration, and
  204. automatic response files that are not part of the zipfile, but
  205. magically appear after your first run of make.
  206.  
  207.     What you do with them is not important, but I just want
  208. to clear up any confusion about these files.  You do not have to
  209. worry about them.
  210.  
  211.     face_lib.arf    Response file for TLIB
  212.     face_tv.arf        Response file for TLINK
  213.     face_tv.cfg        Compiler switches
  214.     hlp            Ugly help message for the makefile.
  215.