home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / RCDOC4.ZIP / RC-DO-C.TXT < prev    next >
Text File  |  1993-01-05  |  7KB  |  155 lines
  1. Release 0.4
  2.  
  3. This file did not go through a spell checker. ( or a grammer checker for that matter.)
  4.  
  5. RC-DO-C, is a VREXX command program that reads a .RC and .DLG file to create
  6. a .C file.
  7.  
  8. It requires the VREXX package from IBM.  Remember VREXX, REXX, and IBM 
  9. are trademarks of the International Business Machine Corporation.  Get the 
  10. VREXX package from your favorite BBS. It's a nice little package. 
  11.  
  12. The C code generated is accepted by the C Set/2 Compile.  Again C Set/2 is
  13. a trademark of the International Business Machine Corporation.
  14.  
  15. To run RC-DO-C, simply type the command name.  An optional .rc filename
  16. may be passed as a parameter.
  17.  
  18. Example:   RC-DO-C rccdo.rc.
  19.  
  20. Even if you enter a file name; the program will still prompt you for a file to read.
  21. We'll fix it sometime later.
  22.  
  23. You will be presented with a list of radio buttons and two push buttons to 
  24. do the code thing. (BTW, the CANCEL push button sometimes means
  25. CANCEL othertimes it means END. While the OKAY button will mean
  26. OKAY sometimes and others END.  It's confusing but You should get the
  27. hang of it.)
  28.  
  29. The series of steps to follow are:
  30.    Select a file (Radio Button 1)
  31.    Parse the file (Radio Button 2 -We don't know why we didn't combine this with Select but we didn't).
  32.    Add Controls (Radio Button 3) - This is followed by a whole bunch of dialog windows.
  33.    Create A C file (Radio Button 6).
  34.  
  35. There are two other steps: Save (Radio Button 4) and Load RCC file(Radio 
  36.  Button 5).   Use  these if you want to add more controls to a parsed file. 
  37.  
  38. (BTW the parser is  very weak and needs lots of attention. So go gentle on it.)
  39.  
  40. Please note: That if you edit the C file. 
  41.                         Then  you change your RC or DLG 
  42.                         and regenerate the C file 
  43.                          you re-parse, you will loose all your changes to the C file.
  44.                         MAKE A BACKUP OR GEN TO DIFFERENT FILE NAME.
  45.  
  46. -How To Add Controls (Radio Button 3) -
  47.                Multi Step Process.
  48.    Gives a list of all known Windows and Dialogs from the RC and DLG files.
  49.       Select one and press OKAY.
  50.          Gives a list on all define PM PMs, with names for the selected Window Or
  51.           .         Dialog.  BTW, numbered IDs are ignored.
  52.           .  Select one and press OKAY.
  53.           .   .  Gives a list of 5 functions (help(Selection 5) is implemented)
  54.           .   .       Select one and press OKAY.
  55.           .   .           If you pick Start Win/DLG then
  56.           .   .                 you get a list of all other Windows and Dialogs to be started.
  57.           .   .                   Select one and press OKAY.
  58.           .   Select another ID when done press CANCEL.
  59.          Select anthoer Window or Dialog when done press CANCEL
  60.  
  61.  
  62.  
  63. That's it in a nutshell.  Good Luck and read on.
  64.  
  65. First, we apologize for not creating a INF file.  So little time so much code write.
  66.  
  67. Second, we aplogize for no real documentation.  Next release we promise. 
  68. Yeah, right.
  69.  
  70. Third, we tried to make the program use as intuitive as possible. Our intuition
  71. is your obfuscation.
  72.  
  73. Fourth, If you want the next release, send $25.00 and floppy disk to:
  74.          American Coders, LTD
  75.          RC-DO-C Development Team
  76.          Post Office Box 97462
  77.          Raleigh, NC   27624
  78.  
  79. Fifth, If you have a question call us  day or night at (919) 846-2014.
  80.  
  81. Sixth, we included several files. Here is a list:
  82.       RC-DO-C.TXT, this file
  83.       RC-DO-C.LIC, some license we ripped off the VREXX package.
  84.       RC-DO-C.CMD, the program.
  85.       RCCDO.RC, sample resource script.
  86.       RCCDO.DLG, sample resource dialog.
  87.       RCCDO.RES, sample RES file.
  88.       RCCDO.H, output from DIALOG generator.
  89.       RCCDO.C,  C program generated from RC-DO-C.
  90.       RCCDO.ICO, sample ICON file.
  91.       RCCDO.EXE, sample executable.
  92.  
  93. Release 0.2 notes:
  94.  
  95.     Added code to track non-Automatic RadioButtons and CheckBoxes.
  96.  
  97.     In the C code you'll find two arrays to track these two types:
  98.  
  99.          1. CheckBoxes -  Each checkbox is represented as an element in the
  100.               cb array.  If the box is checked  then the element value is TRUE and if
  101.                box is unchecked then the element value is  FALSE.
  102.  
  103.           2. RadioButtons -  Each dialog is represented as an element in the
  104.                rb array.  If one of the dialog buttons is checked then the value of
  105.                that radio button is the value of the dialogs position in the rb array.
  106.  
  107.                 If you need to have more than one group of radio buttons in a dialog,
  108.                 then add a new element to enum list of dialog-radiobuttons and change
  109.                 the CONTROL logic in the dialog procedure.
  110.  
  111.        There is no logic for AutoRadioButtons or AutoCheckBoxes.
  112.  
  113.  
  114. Release 0.3 notes:
  115.  
  116.     Added code to store and read Entry Fields and Multiple Line Entry Field.
  117.  
  118.       In the C code you'll find one array for each Entry Field and
  119.       one  character pointer  for each MLE.  Also the MLE have a ULONG
  120.        field for tracking its size.  Entry fields size are pre-determined by the
  121.        ylen paramter in the DLG file.
  122.  
  123.        Both types of fields are loaded into when the DIALOG is
  124.         initialized.  Well the MLE are only if the length is > 0.
  125.  
  126.        In the CASE CONTROL structure each type of field
  127.        is tested for *_KILLFOCUS (which means the user is leaving that
  128.        field for another)  At that time the C code will save what the user
  129.        has put in there.  There is probably a better place to put this type of
  130.        code.  If you can think of a better place let us know.
  131.  
  132.    Added logic for Quit W/ Message (Option 3) for Add Control function.
  133.  
  134.        Look in the C code you'll find it.  The message and title we send out
  135.        is rather generic.  It uses the YES NO push buttons with NO as the
  136.        default.
  137.  
  138. Release 0.4 notes:
  139.  
  140.     Added code to allow just dialog boxes to be created.  It didn't dawn on us that you
  141. didn't need a primary window to start a dialog until we started to think about what VREXX
  142. is doing.  BTW - the program is stupid so it always picks the first window
  143. or dialog it finds as the one to start.
  144.  
  145.      Used window/dialog name to create processing procedure/function name.
  146.  
  147.      Did some general code cleanup.
  148.  
  149. Plans for release 0.5 -  list boxes
  150.                             0.6 -  combo boxes
  151.                             0.7 -  spin boxes
  152.                             0.8 - tba.
  153.  
  154. Copyright 1993  American Coders, LTD  Raleigh  NC  USA   All rights reserved.
  155.