home *** CD-ROM | disk | FTP | other *** search
/ Liren Large Software Subsidy 9 / 09.iso / l / l015 / 1.ddi / README.DOC < prev    next >
Encoding:
Text File  |  1991-03-01  |  10.0 KB  |  235 lines
  1.                        C-Worthy Version 2.0 Release Notes
  2.                               [February 26, 1991]
  3.  
  4. Welcome to C-Worthy 2.0.
  5.  
  6. We're pleased that you have selected C-Worthy as your user interface
  7. development system.  This version of C-Worthy owes a great deal to comments and
  8. suggestions from C-Worthy users like yourself; if you have any problems or
  9. suggestions for improvements we are eager to listen to you.
  10.  
  11. This file contains the latest information on this version of C-Worthy, as well
  12. as hints on solving common problems and using some of C-Worthy's features.
  13.  
  14. Compiler Support Notes
  15.  
  16. These disks contain libraries to support Microsoft C versions 5.1 and 6.0,
  17. Borland Turbo C (not C++) version 2.0, and Borland Turbo C++ version 1.0.
  18.  
  19. Support for Microsoft C 5.1, Turbo C 2.0, and Turbo C++ 1.0 may not be included
  20. in future versions of C-Worthy, as these compilers have been superseded by more
  21. recent versions.
  22.  
  23. We have not yet had the opportunity to do extensive testing with the newly
  24. released Borland C++ 2.0.  However, source code customers will note that all
  25. the library source code compiles correctly if the Turbo C++ 1.0 batch files are
  26. modified to call bcc instead of tcc.
  27.  
  28. Upgrade Notes
  29.  
  30. See the file "upgrade.doc" on the C-Worthy Install Disk if you are upgrading
  31. from a previous version of C-Worthy.
  32.  
  33. Help System
  34.  
  35. The file "h_lib.doc" on the install disk has information on how to use the help
  36. librarian to implement context-sensitive help.
  37.  
  38. Unresolved Externals at Link Time
  39.  
  40. If, when linking, you encounter numerous errors of the form "unresolved
  41. external" or "undefined symbol", one of the following conditions probably
  42. applies:
  43.  
  44.    A.   Your application has been compiled with the old versions of the
  45.    C-Worthy header files.  You must recompile with the new header files.
  46.  
  47.    If the undefined symbols are preceded by an underscore, this is the
  48.    most likely source of the problem.
  49.  
  50.    B.   Your application has been compiled without defining your compiler
  51.    version on the command line.  One of the following preprocessor symbols
  52.    must be defined before any of the C-Worthy include files are processed:
  53.  
  54.    If you are using Microsoft C 6.0: MSC600 (example: cl -c -DMSC600 my.c)
  55.  
  56.    If you are using Microsoft C 5.1: MSC510 (example: cl -c -DMSC510 my.c)
  57.  
  58.    If you are using Turbo C 2.0: BTC200 (example: tcc -c -DBTC200 my.c)
  59.  
  60.    The best way to ensure that the correct command line options are used
  61.    is to compile using the C-Worthy compiler batch files CWCL.BAT for
  62.    large model and CWCM.BAT for medium model.
  63.  
  64.    If the undefined symbols are all capitalized, and are not preceded by
  65.    an underscore, or if they are preceded by an '@', this is the most
  66.    likely source of the problem.
  67.  
  68.    C.   If your application has been compiled correctly, you could be linking
  69.    with the old version of the C-Worthy libraries.
  70.  
  71. _CDECL and _FASTCALL calling conventions
  72.  
  73. All C-Worthy routines are now declared as either _CDECL or _FASTCALL.  These
  74. identifiers are defined in CWGEN.H.  For Microsoft C 6.0, the statements are
  75.  
  76. #define _CDECL _cdecl
  77.  
  78. #define _FASTCALL _fastcall
  79.  
  80. For Microsoft C 5.1 and Borland Turbo C, the statements are
  81.  
  82. #define _CDECL cdecl
  83.  
  84. #define _FASTCALL pascal
  85.  
  86. These statements allow C-Worthy to take advantage of special calling
  87. conventions available with these compilers, resulting in slightly smaller and
  88. faster code.  In addition, you may now use one of these calling conventions as
  89. the default in your own program which uses C-Worthy.
  90.  
  91. Note that the compiler will convert symbols declared as _pascal to all
  92. uppercase, with no prepended underscore (example: "STRING_LENGTH").  Symbols
  93. defined as _fastcall will have '@' prepended by the compiler (example:
  94. "@string_length"), while _cdecl symbols will have a prepended '_' (example:
  95. "_string_length").
  96.  
  97. See "Unresolved Externals at Link Time" in this file for a description of
  98. possible linking problems related to these naming conventions.
  99.  
  100. For additional details, see your compiler documentation.
  101.  
  102. If you need to disable this feature (for instance, if you are recompiling
  103. C-Worthy with a compiler that does not support any of the above calling
  104. conventions), just change the lines in CWGEN.H to read
  105.  
  106. #define _CDECL
  107. #define _FASTCALL
  108.  
  109. Note for rebuilders of cwArchitect
  110.  
  111. As in past versions of C-Worthy, we have included library and source files to
  112. enable the intrepid customer to modify and rebuild cwArchitect to handle
  113. user-defined data types.  See the contents of the CWA directory for specifics.
  114.  
  115. Because of the greatly increased functionality of cwArchitect, it would no
  116. longer function usefully within 640k unless we overlaid it.  We selected
  117. Borland's VROOM technology to accomplish this; therefore, users who wish to
  118. rebuild cwArchitect will need to use the Turbo C++ version of the libraries for
  119. that task, and CWA.LIB is provided only for that compiler.  You may, of course,
  120. continue to use the modified version of cwArchitect in support of Microsoft C
  121. programming.
  122.  
  123. Additional toggle in cwArchitect Preferences
  124.  
  125. Because of the large amount of data associated with a menu being constructed
  126. within cwArchitect, cwArchitect may be unable to handle menus with very many
  127. choices.  If this occurs, cwArchitect will simply refuse to accept new menu
  128. options in the Choices box.
  129.  
  130. If this happens to you (it should occur only with menus with very many choices,
  131. such as a Windows-style menu with many pulldowns), select Preferences
  132. cwArchitect from the main menu and set the Conserve Memory option to On.  This
  133. will cause cwArchitect to save menu options to disk more frequently, resulting
  134. in more capacity at the cost of slower performance.
  135.  
  136. As a side effect, with Conserve Memory on it is not possible to abandon changes
  137. made to pulldowns by pressing Escape on the Choices box.
  138.  
  139. On-line reference for Microsoft PWB/Quickhelp
  140.  
  141. The file ISV.HLP in the C-Worthy Help directory contains the entire C-Worthy
  142. reference manual in on-line form for users of Microsoft C 6.0.
  143.  
  144. Copy ISV.HLP into the directory containing your PWB help and it will be
  145. instantly accessible from PWB or Quickhelp.  To try it, type QH and the name of
  146. a C-Worthy function or data type - for example,
  147.  
  148.      QH menu
  149.  
  150. A reference page about C-Worthy's menu() function will appear.
  151.  
  152. Using the Palette Editor in your application
  153.  
  154. You may include cwArchitect's Palette Editor in your application, to allow
  155. end-users to customize screen colors.
  156.  
  157. Simply call the function palette_editor() (documented in the Reference Manual)
  158. from the menu choice you designate.
  159.  
  160. The palette editor requires two functions in the procedure table generated by
  161. cwArchitect.  The functions are:
  162.  
  163.      text_style_action_proc
  164.      palette_display_proc
  165.  
  166. To enter the procedures, just go to any field in a cwArchitect form that
  167. requires a procedure name (for example, the Entry Procedure field on the Form
  168. Information form).  Bring up the list of procedures by pressing <Grey+>, then
  169. enter the two functions by pressing <Ins> and typing in their names.  After you
  170. have entered the two procedures, press Escape to leave the list without
  171. selecting a new Entry Procedure for your form.
  172.  
  173. Known Bugs
  174.  
  175. This section contains descriptions of known problems in the current version.
  176. Where possible, we provide a workaround.
  177.  
  178.    Menu Choice Help Contexts may give wrong help.
  179.  
  180.    If you use cwArchitect to specify help contexts for menu choices, then add
  181.    or delete contexts using H_LIB, you may get the wrong help for the menu
  182.    choices in your application.
  183.  
  184.    cwArchitect normally stores the name of the context for each menu, form, or
  185.    field that has a help context.  In the case of menu choices, the number is
  186.    stored.  When help contexts are added or deleted, it is possible for some
  187.    contexts to be re-numbered; therefore, stored numbers may no longer
  188.    correspond to the correct help.
  189.  
  190.    The workaround for this version is to check your menu choice help contexts
  191.    using cwArchitect after you make changes with H_LIB.  If the help context
  192.    that appears for the option in the Option Information box is incorrect,
  193.    change it back to the correct help context.
  194.  
  195.    Help contexts for forms, fields, and menus work correctly.
  196.  
  197.    Windows-Style Menu Pulldowns don't have Destroy Objects bit set by default.
  198.  
  199.    If you use cwArchitect to attach an object (a menu or a form) to a pulldown
  200.    choice, the memory associated with the object won't be automatically freed
  201.    after you access it in your application.
  202.  
  203.    To automatically free the memory, read the pulldown menu in cwArchitect,
  204.    select Menu Information, and set the Destroy Object bit in the Control Flags
  205.    field.
  206.  
  207.    H_LIB Write Ascii buffer pointer off by two.
  208.  
  209.    The Write Ascii function of H_LIB.EXE writes two nonsense characters at the
  210.    start of each help context, and truncates the last two characters of the
  211.    context.
  212.  
  213.    This does not affect the operation of the help system, only conversion from
  214.    help files to ascii files.
  215.  
  216.    Errors occur in H_LIB when trying to open currently open file.
  217.  
  218.    If, while working in a file in H_LIB, you select File Open and enter the
  219.    name of the currently open file, errors will occur if you immediately save
  220.    the current file or proceed to reread the current file.
  221.  
  222.    If you enter the name of the currently open file in the File Open box by
  223.    mistake, do not accept the "Save <filename>" prompt if it comes up.
  224.    Instead, escape back to the main menu and save your work.
  225.  
  226.    Blank help contexts may confuse H_CONVRT.
  227.  
  228.    If you are upgrading from a prior version of C-Worthy, and your help files
  229.    contain help contexts with no attached help, H_CONVRT may convert the files
  230.    incorrectly.  If this occurs, simply use the HELPLIB that came with the old
  231.    version of C-Worthy you have to attach a small amount text to each of the
  232.    blank help contexts in your old help library.  H_CONVRT will then convert
  233.    the file correctly.  You can then use H_LIB to make the contexts blank
  234.    again, if you wish.
  235.