home *** CD-ROM | disk | FTP | other *** search
/ Garbo / Garbo.cdr / mac / comm / revrdist.sit / RevRdist / documents / README < prev    next >
Encoding:
Text File  |  1990-07-30  |  3.8 KB  |  40 lines  |  [TEXT/ttxt]

  1. README for RevRdist, July 30, 1990
  2.  
  3. This is the distribution of RevRdist version 1.2 Beta.  Since it is a beta release, be very careful!  We have been using version 1.0 beta for several months without loss of data, but version 1.2 has been in use only a month.
  4.  
  5. The distribution contains the complete sources for RevRdist as well as for the INIT which can be used to run RevRdist automatically.  It also contains those parts of the "TransSkel" package by Paul DuBois which are used by RevRdist.  Note that I have modified TransSkel.  RevRdist will not work correctly with the unmodified version.
  6.  
  7. Except where otherwise noted, the sources were written entirely by me and are in the public domain.
  8.  
  9. RevRdist is written in THINK C, version 4.0, but does not use the object extensions.  It might port to MPW C simply by changing the typedefs in C_config.h, but this has not been tested.
  10.  
  11. There are two top-level folders.  If you installed THINK C following the Symantec suggestions, the ╥RevRdist╙ folder should go in the ╥Development╙ folder and the ╥Local #defines╙  folder should go in the THINK C folder.  The local folder could also go within the RevRdist folder, with suitable changes to the #include lines.
  12.  
  13. After copying the folders, you should rebuild RevRdist.╣ and RevRINIT.╣ in the RevRdist folder.
  14.  
  15. Both RevRdist and the INIT have matching RMaker input files (in the ╥resources╙ folder in the RevRdist folder.)  The RevRdist.r file, in turn, INCLUDEs resources from other files within the resources folder.  Note the tight coupling between the "rsrc.h" and "junkp.h" header files and the RevRdist.r RMaker file:  if you change one, you may need to change the other.  There is a similar relationship between ╥errors.h╙ and ╥syserrs.r.╙  A little study will show the dependencies.
  16.  
  17. If you change any of the RMaker files except RevRINIT.r, you should rerun RMaker on all of the .r files, running RevRdist.r last.  Then use the ╥Build Application╙ menu item in THINK C to update the RevRdist application.  For the INIT, the order is the reverse: build a new code resource from within THINK C and then run RMaker with the RevRINIT.r file to create the INIT.
  18.  
  19. An administrator's guide, in the form of a Microsoft Word 4.0 document is in the ╥documentation╙ folder inside the RevRdist folder.
  20.  
  21. The ╥RR configs╙ folder in the RevRdist folder contains a sample preferences file and matching distribution control file.  These are derived from ones actually used at Purdue.  They were not created by me, and are not exactly how I would  set things up.  Nonetheless, they may serve as starting points for your own files.
  22.  
  23. Known BUGS in the current release:
  24. Ñ    When the "Debug flags" dialog is open, menu selections are either ignored or made pending.  You must dispose of the dialog, via the Save or Okay buttons, before you can continue or quit.
  25. Ñ    The Preferences dialog should let you specify pathnames using the Standard File Dialog.  This is planned.
  26. Ñ    The password should be hidden on the Preferences dialog.  However, any password entered is easily discovered by other means, so fixing this has low priority.
  27. Ñ    RevRdist is not MultiFinder aware, but it is MultiFinder friendly.  I.e., it runs under MultiFinder without problems, but does not do anything special when it is switched into the background.
  28. Ñ    If the Status window is visible, but not frontmost, then you must click twice on a button for it to take effect.
  29. Ñ    The documentation needs to be completed and reorganized.
  30. Ñ    The INIT starts RevRdist using a horrible kludge which is sure to break at System 7.  Since I am not a Developer, I╒ll have to wait until System 7 is available to the rest of us to find how to get the same function.  From what I╒ve read, it should be much cleaner.
  31.  
  32. Please send comments, suggestions, and bug reports to:
  33.  
  34. Dale Talcott
  35. G182 Math building
  36. Purdue University
  37. West Lafayette, IN   47907
  38.  
  39. aeh@cc.purdue.edu or AEH@PURCCVM.BITNET
  40.