home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / RCDO_C02.ZIP / RC-DO-C.TXT < prev    next >
Text File  |  1992-12-01  |  4KB  |  99 lines
  1. Release 0.2
  2.  
  3. This file did not go through a spell checker.
  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. To run RC-DO-C, simply type the command name.  An optional .rc filename
  13. may be passed as a parameter.
  14.  
  15. Example:   RC-DO-C rccdo.rc.
  16.  
  17. Even if you enter a file name; the program will still prompt you for a file to read.
  18. We'll fix it sometime later.
  19.  
  20. You will be presented with a list of radio buttons and two push buttons to 
  21. do the code thing. BTW, the CANCEL push button sometimes means 
  22. CANCEL othertimes it means END. While the OKAY button will mean
  23. OKAY sometimes and others END.  It's confusing but You should get the
  24. hang of it.
  25.  
  26. The series of steps to follow are:
  27.    Select a file
  28.    Parse the file (We don't know why we didn't combine this with Select but we didn't).
  29.    Add Controls - This is followed by a whole bunch of dialog windows.
  30.    Create A C file.  
  31.  
  32. There are two other steps (Save and Load RCC file)  Use  these if you want 
  33. to add more controls to a parsed file. BTW the parser is  very weak and needs
  34. lots of attention. So go gentle on it.
  35.  
  36. If you change your RC or DLG and the C file and you re-parse, you will loose
  37. all changes to the C file.
  38.  
  39. Adding Controls -  Multi Step Process.
  40.    Gives a list of all parse Windows and Dialogs.
  41.       Select one and press OKAY.
  42.          Gives a list on all controllable entities.
  43.              Select one and press OKAY.
  44.                  Gives a list of 5 functions (end with warning and help are not complete)
  45.                       Select one and press OKAY.
  46.                           If you pick Start Win/DLG then
  47.                                 you get a list of all other Windows and Dialogs to start.
  48.                                   Select one and press OKAY.
  49.               Select another control when done press CANCEL.
  50.         Select antoher Window or Dialog when done press CANCEL
  51.  
  52. That's it in a nutshell.  Good Luck and read on.
  53.  
  54. First, we apologize for not creating a INF file.  So little time so much code write.
  55.  
  56. Second, we aplogize for no real documentation.  Next release we promise. 
  57. Yeah, right.
  58.  
  59. Third, we tried to make the program use as intuitive as possible. Our intuition
  60. is your obfuscation.
  61.  
  62. Fourth, If you want the next release, send $25.00 and floppy disk to:
  63.          American Coders, LTD
  64.          RC-DO-C Development Team
  65.          Post Office Box 97462
  66.          Raleigh, NC   27624
  67.  
  68. Fifth, If you have a question call us  day or night at (919) 846-2014.
  69.  
  70. Sixth, we included several files. Here is a list:
  71.       RC-DO-C.TXT, this file
  72.       RC-DO-C.LIC, some license we ripped off the VREXX package.
  73.       RC-DO-C.CMD, the program.
  74.       RCCDO.RC, sample resource script.
  75.       RCCDO.DLG, sample resource dialog.
  76.       RCCDO.RES, sample RES file.
  77.       RCCDO.H, output from DIALOG generator.
  78.       RCCDO.C,  C program generated from RC-DO-C.
  79.       RCCDO.ICO, sample ICON file.
  80.       RCCDO.EXE, sample executable.
  81.  
  82. Release 0.2 notes:
  83.  
  84.     Added code to tract non-automatic RadioButtons and CheckBoxes.
  85.  
  86.     In the C code you'll find two arrays to track these two types:
  87.  
  88.          1. CheckBoxes -  Each checkbox is represented as an element in the
  89.               cb array.  If the box is checked  then the element value is TRUE and if
  90.                box is unchecked then the element value is  FALSE.
  91.  
  92.           2. RadioButtons -  Each dialog is represented as an element in the
  93.                rb array.  If one of the dialog buttons is checked then the value of
  94.                that radio button is the value of the dialogs position in the rb array.
  95.  
  96.                 If you need to have more than one group of radio buttons in a dialog,
  97.                 then add a new element to enum list of dialog-radiobuttons and change
  98.                 the CONTROL logic in the dialog procedure.
  99.