home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 7 / 07.iso / c / c003 / 1.ddi / READ.AAA < prev    next >
Encoding:
Text File  |  1987-05-07  |  9.3 KB  |  240 lines
  1.                 WINDOWS FOR C
  2.  
  3.  
  4.     ORGANIZATION OF READ.AAA
  5.  
  6.     1. Compiler-Specific Information
  7.     2. General Information
  8.     3. New Features
  9.     4. Documentation Corrections
  10.     5. Bugs, Errors, and Corrections
  11.     6. Problems and Solutions
  12.  
  13.  
  14. 1.  COMPILER-SPECIFIC INFORMATION
  15.  
  16.     COMPATIBILITY WITH VERSION 2.0 MICROSOFT COMPILERS
  17.  
  18.     The libraries supplied are incompatible with version 2.x of the
  19.     Microsoft compiler.  This is because of the different manner that
  20.     global variables and functions are referenced.  Version 4.0
  21.     of the compiler prefix an _ to all function and global variable names.
  22.  
  23.     COMPATIBILITY WITH VERSION 3.0 MICROSOFT COMPILERS
  24.  
  25.     The libraries supplied were compiled using v4.0 of the Microsoft
  26.     compiler.  This version of the compiler will produce references to
  27.     Microsoft internal functions that are not present in the Microsoft v3.0
  28.     standard C library.  Therefore, these libraries are incompatible with
  29.     Microsoft C Compiler v3.0.    If you have version 3.0 of the Microsoft
  30.     compiler, we suggest you upgrade to the latest release or call us for a
  31.     set of libraries that are compatible.
  32.  
  33.     WFC LIBRARIES WILL WORK WITH EITHER BYTE ALIGNMENT OR WORD ALIGNMENT
  34.  
  35.     Microsoft provides the option of compiling programs with either byte or
  36.     word alignment.  Alignmnent affects the way in which memory is
  37.     allocated for data structures.  In previous versions of WFC, one of our
  38.     data structures needed to be modified to work properly under byte
  39.     alignment.    This is no longer the case.  WFC will work as supplied
  40.     whichever type of alignment is specified for the compiler.
  41.  
  42.     CONFLICT BETWEEN CL.BAT and CL.EXE
  43.  
  44.     We provide a batch file (cl.bat) that will compile and link programs
  45.     using the Windows for C system.  Microsoft supplies a program (cl.exe)
  46.     that compiles and links general C source programs.    The conflict in
  47.     names prevents you from running cl.bat.  We suggest you rename the
  48.     cl.bat file.
  49.  
  50.     RUNNING OUT OF COMPILER SPACE
  51.  
  52.     When using WFC with the Microsoft compiler, you may be able to create
  53.     files that are too large to be optimized.  Microsoft provides a
  54.     large-model version of C3.EXE named C3L.EXE.  The default version on
  55.     C3.exe was compiled using the small model.    See the readme.doc file on
  56.     disk 2 of the Microsoft distribution package for more information.
  57.  
  58.     WINDOW LIBRARIES
  59.  
  60.     The object code libraries for Windows for C are on the accompanying
  61.     Library Diskette.  See READ.AAA on that diskette for information on the
  62.     libraries.
  63.  
  64.  
  65.  
  66. 2. GENERAL INFORMATION
  67.  
  68.     DEMO PROGRAMS
  69.  
  70.     All demonstration programs are provided in source form and must be
  71.     compiled and linked before they can be run.  You can adapt CL.BAT on
  72.     this diskette to perform this task.  The demo programs can be found in
  73.     the sub-directory \demos on this diskette.
  74.  
  75.     MICROSOFT WINDOWS AND TOPVIEW COMPATIBILITY
  76.  
  77.     Windows for C (and Windows for Data) are fully compatible with
  78.     Microsoft Windows and IBM's TopView.  Programs that use Windows for C
  79.     for screen output and keyboard input can operate within a window in MS
  80.     Windows and TopView and run in the background.
  81.  
  82.     All of your programs built using VCS Windows will automatically run
  83.     under TopView and MS Windows.  You do not need to buy Microsoft's or
  84.     IBM's Programmer's Toolkits or incorporate any special code in your
  85.     programs.  Compatibility is handled automatically by Windows for C,
  86.     which detects the presence of MS Windows or TopView and adjusts its
  87.     screen handling to conform to their requirements.
  88.  
  89.     Exactly the same functions of Windows for C are used to interface
  90.     Microsoft Windows and TopView.  The material in Chapter 9 about TopView
  91.     compatibility is completely applicable to MS Windows.
  92.  
  93.     The Program Interface File (PIF) format is exactly the same in TopView
  94.     and MS Windows; thus the demonstration programs for which PIF files are
  95.     provided on the system diskette can be run under either TopView or MS
  96.     Windows.  PIF files are found in the sub-directory \demos on this
  97.     diskette.
  98.  
  99.     FUNCTIONS NOT RETURNING INTEGERS HAVE EXTERN DECLARATIONS
  100.  
  101.     Library functions that do not return integers have been given
  102.     appropriate extern declarations in wfc_xtrn.h.  You do not need to
  103.     declare them within functions that you build.  This will assist in
  104.     preventing errors in the large and program models.
  105.  
  106.     If you do not like this feature, you can remove the declarations in
  107.     wfc_xtrn.h.
  108.  
  109.  
  110.  
  111. 3.  NEW FEATURES
  112.  
  113.     CHANGES FROM VERSION 4.0
  114.  
  115.     Major changes are listed below:
  116.  
  117.     *  Renaming of system header files, libraries and functions
  118.     *  New naming system introduced
  119.         **    Many functions have been renamed
  120.         **    Memory file structures have been renamed
  121.     *  Revised memory handling in memory files
  122.         **    Replacement of def_fr()
  123.         **    Added functions and capabilities
  124.     *  System structure changes
  125.     *  Revised WINDOW structure
  126.     *  VCS Debugging and Error Handling System
  127.     *  Mouse support
  128.     *  Simplified access to system error and informational messages
  129.     *  Template Definition function
  130.     *  Improved compatibility with re-entrant applications
  131.     *  Added options for placing the window name in a border
  132.     *  New macro for determining if a window is set on the screen
  133.     *  First-character selection of menu items
  134.     *  Deleted NULL #define in header files
  135.  
  136.     For more detailed information on these and other changes, refer to the
  137.     section on "Important Information for Previous Users", pg vii.
  138.  
  139.     Because of the many changes in the system data structures, you must
  140.     recompile all of your previous code to use the present version of
  141.     Windows for C.
  142.  
  143. 4.  DOCUMENTATION CORRECTIONS
  144.  
  145.     ATTRIBUTE CHANGED FOR ACTIVE MENU ITEMS
  146.  
  147.     The attribute for the active choice field in menu2() has been changed
  148.     from LREVERSE to LCHOICEA.    On monochrome displays, no change will be
  149.     seen.  For color displays, the active choice field will appear
  150.     different.
  151.  
  152.     COMPUTER.H FILE IN MANUAL IS OUTDATED
  153.  
  154.     The file computer.h in the Tables and Listing section of the manual is
  155.     outdated.  Please refer to the computer.h file on this diskette for the
  156.     updated version.
  157.  
  158.  
  159.  
  160. 5.  BUGS, ERRORS, AND CORRECTIONS
  161.  
  162.     The bug fixes made in this version are listed in file HISTORY.DOC.
  163.  
  164.  
  165. 6.  PROBLEMS AND SOLUTIONS
  166.  
  167.     MAXIMUM NUMBER OF FILES THAT CAN BE OPENED BY THE SYSTEM
  168.  
  169.     We had a report from a user that he needed to change the maximum number
  170.     of files that could be opened on the system because our include files
  171.     were nested so deeply.  If you find this necessary, modify your
  172.     config.sys file and change the value assigned to FILES.  You will then
  173.     have to reboot.  If FILES is not present in config.sys, it defaults to
  174.     8.    We set ours to 10 and have never had any problems.
  175.  
  176.     COMPATIBILITY WITH COMPUTERS WITH MONOCHROME MONITORS THAT DISPLAY
  177.     SHADES OF GRAY
  178.  
  179.     Some IBM PC compatibles have a monochrome monitor that will duplicate
  180.     the function of the IBM PC MONOCHROME card and the COLOR/GRAPHICS card.
  181.     This enables the monitor to work in either the MONOCHROME mode or COLOR
  182.     mode.  When in the "COLOR" mode, the colors are mapped to various
  183.     shades of gray.  For systems like this, the monochrome video attribute
  184.     UNDERLINE is not supported.  The computer maps this video attribute to
  185.     a shade of grey.  Compaq computers (and possibly other brands as well)
  186.     have this problem.
  187.  
  188.     TOPVIEW COMPATIBILITY AND INCOMPATIBILITY PROBLEMS
  189.  
  190.     Incompatibility with the EGA
  191.  
  192.     Version 4.1 of Windows for C is compatible with TopView, IBM's
  193.     multi-tasking operating programs.  However, according to IBM, at one
  194.     time there was an incompatiblity between TopView and the IBM Enhanced
  195.     Graphics Adapter when using the Enhanced Color Display in the Enhanced
  196.     Color Mode (Hi-Res).  This incompatibility is independent of Windows
  197.     for C.  This incompatibility exists when the dip-switches on the EGA
  198.     board are set in the following manner:
  199.  
  200.     SW1 - off
  201.     SW2 - on
  202.     SW3 - on
  203.     SW4 - off
  204.  
  205.     To solve this incompatibility, you must change the switch settings to
  206.     configure the EGA for use with an Enhanced Color Display in the Normal
  207.     Color Mode.
  208.  
  209.     SW1 - on
  210.     SW2 - on
  211.     SW3 - on
  212.     SW4 - off
  213.  
  214.     Refer to the Installation Instructions for the EGA for more information
  215.     on the switch settings.
  216.  
  217.     We do not know at this time if this problem has been fixed within
  218.     TopView.
  219.  
  220.     Demo_wn.c and dem_menu.c are supplied with TopView PIF files.  After
  221.     you have compiled and linked these demo programs, they can be run under
  222.     TopView.  Both the executable file and the PIF file must be accessible
  223.     on the same drive.
  224.  
  225.     Incompatibility with Some Compatibles
  226.  
  227.     Checking for TopView availability causes Windows for C to be
  228.     incompatible with some IBM PC compatible computers.  This
  229.     incompatibility problem can be corrected within WFC.  See Chapter 9 of
  230.     the reference manual.
  231.  
  232.     The following IBM PC compatible computers are known to have this
  233.     problem:
  234.  
  235.     Seequa Chameleon
  236.     Lee Data 3279 - Combination 3279 terminal and PC
  237.  
  238.     If you discover any other machines with this problem, please let us
  239.     know.
  240.