home *** CD-ROM | disk | FTP | other *** search
/ CD Shareware Magazine 1997 January / CD_shareware_1-97.iso / DOS / COMUNICA / STAREA11.ZIP / STARAREA.DOC < prev    next >
Encoding:
Text File  |  1996-10-06  |  5.2 KB  |  135 lines
  1.            StarArea - LightBar Files/Message Area Selector V1.1
  2.                            Public Domain Software
  3.               (!) 1996 Larry Monte/StarLab Systems Software
  4. -----------------------------------------------------------------------------
  5.  
  6. Release :     StarArea V1.1 Is a second Wide Beta version.  Although many
  7. Notes   :     hours were spent to make StarArea as Bug-Free as possible, it's
  8.               difficult to anticipate the _thousands_ of different setup
  9.               possibilities MAX provides. Should any problems occur, please
  10.               contact the author as described in REGISTER.DOC and report
  11.               your find.
  12.               Fixed:
  13.                - PgUp problem on the last page exiting the program.
  14.                - PgDn on last page locking the user on page one.
  15.                - Incorrect version variable in STARAREA.LH fixed.
  16. -----------------------------------------------------------------------------
  17.  
  18. GUARANTEES:
  19. -----------
  20.               None expressed or implied. If StarArea works for
  21.               you...great. If not, feel free to modify the code
  22.               to work on your system. 
  23. -----------------------------------------------------------------------------
  24.  
  25. What Is StarArea?
  26. -----------------
  27.  
  28.               StarArea allows you and your users to select File/Message areas
  29.               by using a lightbar and your cursor keys. Users can also view
  30.               information about the areas. IE: By pressing a key, the user
  31.               will see how many Messages are in the area, and how many of
  32.               those remain unread. For File areas: the total number of files
  33.               and  bytes, and how much of those are new since their last new
  34.               files scan.
  35. -----------------------------------------------------------------------------
  36. -----------------------------------------------------------------------------
  37.                          General SetUp Instructions
  38. -----------------------------------------------------------------------------
  39.  
  40. !!!!!MAKE BACKUPS OF ANY FILES WHICH THIS INSTALLATION WILL BE MODIFYING!!!!!
  41.  
  42. NOTES: Make sure you have the MEX_INCLUDE environment set in your
  43.        autoexec.bat file. Your autoexec.bat should have this line:
  44.  
  45.        SET MEX_INCLUDE=c:\max\m
  46.                        ^^^^^^^^^
  47.                        Should be set to where you keep your *.MH MEX files...
  48.  
  49.  
  50. BEFORE STARTING ANY OF THE FOLLOWING:
  51. -------------------------------------
  52.  
  53.     Because of omissions in the MAX.MH file in the MAXV3.0 release, you should
  54. check to be sure the following lines are included in MAX.MH, which should
  55. be found in your \M directory.
  56.  
  57. int fileareafindprev(ref struct _farea: fa);
  58. int msgareafindprev(ref struct _marea: ma);
  59.  
  60.     These lines should be found somewhere after line 680 in the MAX.MH. If not
  61. you can add them after the lines defining file/msgareafindnext() prototypes.
  62.  
  63.     You should also note that even if you have upgraded to MAXV3.1, you
  64. should still have a look to make sure the above lines are included. The 3.1
  65. upgraded from V3.0 does not fix this (at least it didn't here).
  66.  
  67. SetUp:
  68. ------
  69.  
  70. 1) Make a directory off your main \MAX dir called STARAREA. Then, unpack the
  71.    STAREAxx.ZIP archive in this directory.
  72.  
  73. 2) Move (not COPY) both STARAREA.MH and STARAREA.LH into your \M directory.
  74.    Be sure these files DO NOT exist in your /STARAREA dir!
  75.  
  76. 3) If you intend to use StarArea in your file areas as well, copy STMAREA.MEX
  77.    to STFAREA.MEX. Then edit lines 18-19 in STFAREA.MEX so that the
  78.    #define MSG is commented out, and #define FILE is uncommented.
  79.  
  80. 4) Change to your language file directory (here it's C:\MAX\LANG) and load
  81.    the <language>.MAD (here it's ENGLISH.MAD) file into your text editor.
  82.    At the end of this file is a section called ; Include any user heaps here.
  83.    You will likely see a line (or more) which looks something like this:
  84.  
  85.    #include <user.lh>
  86.  
  87.    On a blank line below this add:
  88.  
  89.    #include <../m/stararea.lh>
  90.  
  91.    Make sure this line is flush against the left margin.
  92.    I realize that you can include this line in the USER.LH file, but to cut
  93.    down on confusion, we will put it directly into the <language>.MAD file.
  94.  
  95. 5) Compile your language file using:
  96.  
  97.    MAID <language>.MAD             (Here it's MAID ENGLISH.MAD)
  98.  
  99. 6) Load your MENUS.CTL file into your text editor and make the following
  100.    changes in your MESSAGE section:
  101.  
  102.    Replace:
  103.  
  104.    Msg_Area                                 Twit "Area Change"
  105.  
  106.    With:
  107.  
  108.    MEX             stararea\stmarea         Twit "Area Change"
  109.  
  110.    And for the FILE section:
  111.  
  112.    Replace:
  113.  
  114.    File_Area                                Twit "Area Change"
  115.  
  116.    With:
  117.  
  118.    MEX             stararea\stfarea         Twit "Area Change"
  119.  
  120.    Or whatever suits your system/tastes.
  121.  
  122. 7) Change to the STARAREA dir and compile the two StarArea Modules using:
  123.  
  124.    MEX STMAREA
  125.    MEX STFAREA
  126.  
  127. 8) Change to your main Maximus directory (C:\MAX here) and SILT MAX (and
  128.    any other PRM files you may have)
  129.  
  130. That's it. Enjoy!
  131. -----------------------------------------------------------------------------
  132.  
  133. You can contact me as described in REGISTER.DOC
  134.  
  135.