home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / comm / mbbs25a4.zip / !UPGRADE.DOC < prev    next >
Text File  |  1993-05-14  |  21KB  |  443 lines
  1.   MacroBBS 2.5a - (C)opyright 1992,93 by Jeff Oberlee - All Rights Reserved
  2.  
  3.  
  4.                                 * * * * * *
  5.                                 * Upgrade *
  6.                                 * * * * * *
  7.  
  8.     Upgrading to MacroBBS 2.5a is very easy.  There are some new files in the
  9. archive as well as upgraded "carry-over" files.  All of the .MAC files from
  10. previous versions of MacroBBS should be replaced by the new files.  I do NOT
  11. suggest overwriting any of the system data files (such as CALLER.DAT,
  12. CALLERS.LST, .MNU files, etc.) unless you want to start COMPLETELY from scratch.
  13.  
  14. Step 1:  Copy the file MBBS25a.ZIP to your {COMMO} disk directory and type:
  15.  
  16.                    PKUNZIP -de MBBS25a     <press ENTER>
  17.  
  18. This will create some new NECESSARY sub-directories and extract the
  19. files. It will ask you if you want to overwrite existing files.  Answer
  20. YES to all of the .MAC files, and to any other files you want
  21. overwritten.  A new "trick" has been incorporated into the protocol
  22. "stubs" (MBXPRO-*.MAC) and overwriting (or re-configuring these files
  23. via the MacroBBS config module) is HIGHLY recommended.
  24.  
  25. Step 2:  Next, type:
  26.  
  27.                    MACROBBS    <press ENTER>
  28.  
  29. This batch file will copy some files from your CALLERS directory to the
  30. new directories.  The reason for this is simple: five files per user in
  31. ONE directory can cause problems as your callership grows.  Hence, the
  32. house cleaning.  I've merely attempted to organize things a bit
  33. better.
  34.  
  35. Step 3:  Lastly, type:
  36.  
  37.                    MBCFG    <press ENTER>
  38.                     or
  39.                    MBBS   <press ENTER>
  40.  
  41. Either batch file will get you into the MacroBBS config module.
  42. (MBBS.BAT gets you there only because you need to make a few
  43. configuration changes before MacroBBS will boot; it will normally
  44. boot MacroBBS.  MBCFG goes straight to the config module.)   Go through
  45. config sections 1, 2, and 3 AT LEAST.  There are a few new options.
  46. When you've had enough, save and exit to the BBS and yer OFF!  Have fun!
  47.  
  48.  ** IMPORTANT NOTE **
  49.  
  50.  1. You MUST use {COMMO} version 5.3 or higher.
  51.  
  52.  2. Due to changes in {COMMO} 5.3 and adjustments in MacroBBS 2.0 Beta,
  53. MacroBBS must always be started using a DOS command line that includes
  54. "/v10000". Here's an example:
  55.  
  56.               COMMO /v10000 /in /mMACROBBS.MAC /:bbs
  57.                     ^^^^^^^
  58.    The above line would boot {COMMO} 5.3 (or higher) with a 10K variable
  59. buffer, then boot MacroBBS.  This extra memory appropriation requires
  60. your machine to have at least 138K available RAM, rather than the usual
  61. 128K.  The extra memory is used by MacroBBS's message editor, enabling
  62. it to perform much more efficiently, not to mention FASTER! :)
  63.    ALL included batch files have been modified to include the above enhance-
  64. ment.  But if you boot MacroBBS any OTHER way, be sure to make all necessary
  65. changes.
  66.  
  67.  
  68.  
  69.                            * * * * * * * * * * * *
  70.                            * MacroBBS  Evolution *
  71.                            * * * * * * * * * * * *
  72. * * * * * * *
  73. * 2.5 Alpha *
  74. * * * * * * *
  75.  
  76. =======================================================================
  77.   MacroBBS has grown!  But it is now near-fully modular: Use of ALL the
  78. macro files is not required.  The only .MAC files that ARE required are:
  79.  
  80.        MACROBBS.MAC  -  The MAIN program
  81.        MACROCFG.MAC  -  The configuration module
  82.     &  MACRONYT.MAC  -  The midnight maaintaenance macro
  83.  
  84.   Using any or all of the remaining macro files is optional.
  85. =======================================================================
  86.  
  87. 1.  MacroBBS now includes an easily configurable BULLETIN menu as well
  88.     as an easily configurable EXTERNAL PROGRAMS menu.
  89.  
  90. *  The Bulletin menu can be modified at any time via Offline Wait Screen
  91. option "3" -- "Text/Bulletins".  When you choose option 3, you will be
  92. placed in {COMMO}'s text editor, editing the Bulletin Config file.  This
  93. one file will contain ALL your bulletin definitions. After reading the
  94. on-screen instructions, you may add or delete bulletins as you like.
  95. Each bulletin requires THREE lines in this format:
  96.  
  97.     Line 1; A number  (1 for the first, 2 for the second, etc)
  98.     Line 2: Short description
  99.     Line 3: FULL path and filename of the file to display.
  100.  
  101. You can set-up as many bulletins as you want.
  102.  
  103. *  The External Programs menu is modifiable from the MacroBBS Config
  104. module.  Select Offline option "S", enter your password, then select
  105. Special Functions option "8".  At the Config Menu, select option "5" to
  106. setup an External Program.  The program you want to setup can be an
  107. online game, a program, a dual-transfer protocol...just about anything!
  108. After entering all the pertinent data for your external program, you
  109. will be placed inside {COMMO}'s text editor, editing the Door Config
  110. file.  This one file will contain your external program names only.
  111. After reading the on-screen instructions, you may add or delete door
  112. definitions as you like. Each door definition requires TWO lines in this
  113. format:
  114.  
  115.     1st line; A single letter from A to Z (keypress to run the door)
  116.     2nd line: Full name of the door program as you want it to appear to users.
  117.  
  118. There is currently a limit of 26 External Program definitions.  {This
  119. should not be confused with External PROTOCOL definitions; You can have
  120. upto 26 of those, too...)
  121.  
  122. NOTE:  The "drop file" you choose (DOOR.SYS, DORINFO1.DEF, etc) will be
  123.        written to your {COMMO} home directory whenever a user enters a door
  124.        program (ie. when he/she plays an online game.)
  125.  
  126. 2.  The External Protocol Config routine was modified.
  127.  
  128.    An external protocol can be installed via the MacroBBS Config module.
  129. Select Offline option "S", enter your password, then select Special
  130. Functions option "8".  At the Config Menu, select option "4" to setup an
  131. External Protocol.  After entering all the technical data pertaining to
  132. your external protocol, you will be placed inside {COMMO}'s text editor,
  133. editing the Protocol Config file.  This one file will contain your
  134. external protocol names only.  After reading the on-screen instructions,
  135. you may add or delete protocol definition as you like.  Each protocol
  136. definition requires TWO lines in this format:
  137.  
  138.     Line 1;  A single letter from A to Z (keypress to select the protocol)
  139.     Line 2:  Full name of the protocol as you want it to appear to users.
  140.  
  141. There is currently a limit of 26 External Protocol definitions.  {This
  142. should not be confused with External PROTOCOL definitions; You can have
  143. upto 26 of those, too...)
  144.  
  145. 3.  If EVENTS.BAT exists in your {COMMO} home directory, it will be
  146.     executed at midnight each night when MacroBBS begins its daily
  147.     clean-up.  This is handy for maintenance purposes when running an
  148.     online game that requires nightly MAINTENANCE.
  149.  
  150. 4.  The Offline Screen will now (optionally) blank before MacroBBS
  151.     pop-up menus are displayed.  This option is configurable from the
  152.     MacroBBS Configuration module.
  153.  
  154. 5.  An ANSI/TTY auto-detection routine now replaces the "Does your
  155.     system do ANSI?" logon question.
  156.  
  157. 6.  Entering an "*" at the Login: prompt will no longer crash MacroBBS.
  158.     (Neither will a "?"... :)
  159.  
  160. 7.  Due to overwhelming complaints, ;*) every User of your BBS may now
  161.     enable or disable the screen clears which occur between screen-fulls
  162.     of a long message.  A toggle was added to the "Your data" option of the
  163.     Main Menu.
  164.  
  165. 8.  The "Forward" and "Reverse" options of the MESSAGE MENU and
  166.     FILE MENU will now cycle to the first/last area, rather than
  167.     dead-ending.
  168.  
  169. 9.  Added an experimental MESSAGE UPLOAD option.to the Message Menu.
  170.     This will use XMODEM ONLY.  I made it this way on purpose.  Callers may
  171.     usw either Xmodem-CRC or Xmodem-1K.  WARMING!!  There is no message size
  172.     restriction:  A Caller could EASILY upload a 20-Meg message!
  173.     Use with caution!
  174.  
  175. 10. If MAREASa.MNU and/or MAREASn.MNU exist in your datadir
  176.     (eg. C:\Commo\Macrobbs), one of these files will be displayed (when a user
  177.     chooses option "A" to list all message areas), rather than the default
  178.     internal message area listing.  Similarly, with the File Base:  If
  179.     FAREASa.MNU and/or FAREASn.MNU exist in your datadir,  one of these files
  180.     will be displayed (when a user chooses option "A" to list all file areas),
  181.     rather than the default internal file area listing.  The file to be
  182.     displayed is determined by the user's video mode (A = Ascii, N = aNsi).
  183.     Say you create JUST the ANSI message listing (MAREASn.MNU).  Users with
  184.     ANSI active will see this list, but ASCII-only callers would still see
  185.     the same old internal message area list.
  186.  
  187. 11. Reworked the message last-read pointer system and added a "Message
  188.     Packer" which will allow users to pack unread messages in each
  189.     message area they have "tagged".  Then the message packet may be
  190.     downloaded and viewed/read at the user's convenience.  Message packets
  191.     are straight ASCII files.  PKZIP is the default archiver, but users may
  192.     choose from a list of available archivers you provide.  The included
  193.     sample file (MBBSARCH.LST) should be used as a guideline for setting up
  194.     archivers; Edit it to include your favorite archiver utilities.  Each
  195.     archiver you specify requires THREE lines in this format:
  196.  
  197.     Line 1; A number  (1 for the first, 2 for the second, etc)
  198.     Line 2: Archiver NAME as you want it to appear on the menu.
  199.     Line 3: The DOS command needed to COMPRESS with this archiver.
  200.  
  201. You can set-up as many archivers as you want.
  202.  
  203. 12. Added an offline EDIT MENU.  Use this menu as an easy way to edit
  204.     thee following three MacroBBS system files:
  205.  
  206.   1. NOTICES,.DAT - The file containing your logon notices.
  207.   2. MBBSBULL.LST - The file containing your BULLETIN/TEXT FILE definitions.
  208.   3. MBBSARCH.LST - The file containing your archiver configuration.
  209.  
  210. 13. DOS 5.0 users that had modified the DIRCMD environment variable in
  211.     DOS 5.0 were experiencing malfunctions with MacroBBS local/remote
  212.     uploads.  Thanks to Dennis Boone, author of QuotEd, a small batch file
  213.     fix was implemented to correct this.
  214.  
  215. 14. Added REMOTE CONFIG-ability (option "!" from the Main Menu).  This
  216.     is a clone of the offline Master SysMenu minus option 2 - Edit a
  217.     FileList. (A remote user could edit a filelist using DOS DOORWAY,
  218.     if installed.)  "Remote Config" is available to anyone with DOS
  219.     DOORWAY access  The online user can ADD, EDIT, DELETE, and REVIEW
  220.     File Areas, Message Areas, and Caller Records.
  221.  
  222.  
  223. Many thanks to Jim Bianchi, sysop of The Garbanzo BBS, (707-539-1279),
  224. for his many suggestions, several of which were implemented.
  225.  
  226.  
  227. * * * * * * *
  228. * 2.0  Beta *
  229. * * * * * * *
  230.  
  231. 1.  Fido DOES NOT YET WORK -- just ignore the Fido options.
  232.  
  233. 2.  This version does, however, optionally support a front-end mailer (eg.
  234.     BinkleyTerm).  See the included file BINKLEY.BAT for an example of how
  235.     to pass carrier to MacroBBS.
  236.  
  237. 3.  All OFF-LINE options that call on the "Add, Delete, Edit or Review" routine
  238.     were combined into the Master SysMenu.  Now the system password need only
  239.     be entered once.  The "Review" option is for VIEWING only and was added to
  240.     eliminate the need for an external viewer just to look-up someone's
  241.     password.
  242.  
  243. 4.  Three new fields were added to the User records:  Real name, Location, and
  244.     Last call.  Callers will be prompted at log-on to provide their real name
  245.     and City, State ONLY IF THIS INFORMATION IS NOT PRESENT IN HIS/HER RECORD.
  246.     That means Callers will only be asked once.  This information is User-
  247.     editable from the "Your System Data" MAIN MENU option.  The LAST CALL
  248.     field is displayed on the GREETINGS/INTROMSG screen.  A second line was
  249.     added to the MacroBBS status line to display the current Caller's real
  250.     name and Location.
  251.  
  252. 5.  E-Z Sysop-configurable external protocols via the MacroBBS Config routine.
  253.     Sample DSZ.COM Zmodem configuration included (MBXPRO-Z.MAC).  Set up an
  254.     external protocol by entering MacroBBS's Configuration module and follow
  255.     the prompts.  It's E-Z!
  256.  
  257. 6.  MacroBBS's E-MAIL/MESSAGE editor is now FULLY memory-resident, which
  258.     means it's MUCH FASTER -- no more disk reads/writes!  Some of the Editor's
  259.     functions have been enhanced as a result of the change.  Upto 100 lines.
  260.  
  261. 7.  The E-MAIL System was re-worked to include the JUMP command for quickly
  262.     jumping to the E-mail message you specify.  Upon reaching the end of their
  263.     E-mail, Callers are now asked whether or not to delete it, allowing E-mail
  264.     to be saved for another time.  It is no longer automatically deleted.
  265.  
  266. 8.  The Caller Time Limit routine was rewritten.  You can now specify whether
  267.     the time limit is PER DAY or PER CALL specific to EACH USER.  You can mod
  268.     this setting via the Useredit option of the On-line Sysop Menu (for the
  269.     current Caller), or utilize the Off-line Master SysMenu.  Specify "D" if
  270.     you want the time limit to be a per DAY limit, or a "C" if you want it to
  271.     be a per CALL limit.  For example, let's say you set a limit of 60 minutes
  272.     in the MacroBBS Config.  You can now have some Callers that can only use
  273.     60 minutes TOTAL per DAY.  Others can use upto 60 minutes per CALL, every
  274.     time they call.  It's up to you.  New User Default = "D" (PER DAY).
  275.  
  276.  
  277. * * * * * * * *
  278. * 1.2 a/b/c/d *
  279. * * * * * * * *
  280.  
  281.  -  Bug fixes:
  282.  
  283.     1.  A BIG bug in the protocol menu (dealing with XMODEM) was fixed.
  284. A       BOTH of {COMMO}'s built-in protocols (XMODEM csum and XMODEM-1k)
  285.         are now available.  THESE DO NOT NEED DSZ, but you must have DSZ
  286.         installed if you want to support YMODEM and ZMODEM transfers.
  287.  
  288.     2.  A certain line of code was limiting COM port access to CON1: -- this
  289. A       oversight has been corrected and MacroBBS should work fine with COM
  290.         ports 1, 2, 3, or 4 -- whichever {COMMO} is configured for.
  291.  
  292.     3.  MacroBBS was assuming too much about the format of your DOS directory
  293. C       listings.  MBBS was crashing when there were more/less than 2 lines in
  294.         the DIRectory header:
  295.  
  296.         Eg.           Volume in drive C is DISK
  297.                       Volume Serial Number is ????-????
  298.                       Directory of E:\COMMO
  299.  
  300.             ...would cause MacroBBS to crash during local and remote uploads.
  301.  
  302.             Thanks, Dennis! :)
  303.  
  304.     4.  {COMMO} 5.3's new military time format capability was conflicting with
  305. D       a portion of MacroBBS that relied on am's and pm's.  This has been
  306.         corrected.
  307.  
  308.  -  Improvements:
  309. REV
  310.  A  1.  The Hall of Fame display/edit routine was re-worked and now re-displays
  311.         info only when the Caller enters "L" to LIST, rather than each time the
  312.         Caller updates a data field.
  313.  
  314.  A  2.  Made refinements to the "Intromsg" and "Your Data" MAIN MENU
  315.         subroutines.
  316.  
  317.  A  3.  Made a few changes to the OFF-LINE WAIT SCREEN.  All options that
  318.         utilize {COMMO}'s built-in text editor were combined into a small
  319.         menu under OFF-LINE option 3, "Text Edit Menu".
  320.  
  321.  A  4.  Extended Name/Handle maximum length from 15 characters to 30 characters.
  322.  
  323.  A  5.  The older ADD CALLER routine assumed you knew EXACTLY what you were
  324.         doing; It would allow you to use an already taken Name/Handle as well
  325.         as allowing invalid input.  That has been corrected.
  326.  
  327.  A  6.  The ON-LINE SYSOP MENU also assumed too much.  Input length and
  328.         validity are now tested.
  329.  
  330.  A  7.  Seriously reworked the CONNECT routine to support many popular baud
  331.         rates and made configurable the CONNECT and RING modem result codes
  332.         to allow for greater versatility.
  333.  
  334.  -  New features:
  335. REV
  336.  A  1.  Options were added to the MESSAGE BASE, the FILE BASE, and the Hall of
  337.         Fame menus to allow direct access from one to another.
  338.  
  339.  A  2.  Added a Sysop configurable Personal Caller Data routine.  If the file
  340.         PERSONAL.DAT is present in your MacroBBS data dir (\COMMO\MACROBBS\)
  341.         and there is no <id#>.DAT file for the current Caller (if the Caller is
  342.         new or his/her last call was before this feature was implemented),
  343.         normal log-on will be interrupted by the "System Information Request"
  344.         routine.  The questions (prompts) are taken from the file PERSONAL.DAT
  345.         and the information provided by the Caller is saved to a file in the
  346.         CALLERS disk directory (\COMMO\CALLERS\).  The newly saved file will
  347.         be named according to the Caller's id#. For example, User 5's info is
  348.         saved as 5.DAT.  Create/edit PERSONAL.DAT with any ASCII editor or
  349.         select off-line option 3 to use {COMMO}'s built-in editor.
  350.  
  351.         The format you MUST use for PERSONAL.DAT is exactly the same as the
  352.         format of QUESTION.DAT:  two lines per item.  The first line contains
  353.         a number -- the maximum number of characters MacroBBS will accept for
  354.         that item's answer.  The second line contains the prompt.
  355.  
  356.         Example:
  357.  
  358.         25
  359.         Real name
  360.         2
  361.         Age
  362.         13
  363.         Phone #
  364.  
  365.         In the above example, up to 25 characters will be accepted for the
  366.         Caller's REAL NAME, UP TO 2 for AGE, and UP TO 13 for PHONE #.
  367.  
  368.  A  3.  If the file NOTICES.DAT is present in your MacroBBS data directory
  369.         (eg.  C:\COMMO\MACROBBS\), it will be displayed during log-on after the
  370.         stats/INTROMSG screen.  Create/edit this file with any ASCII editor
  371.         or select off-line option 3 to create/edit this file with {COMMO}'s
  372.         built-in editor.
  373.  
  374.  A  4.  Added the (S)ysop command to the message READ MENU.  Selecting S will
  375.         display the SYSOP MENU.  Options available are: (D)elete the current
  376.         message, (M)ove the current message to another area, (E)dit the current
  377.         message (local uses {COMMO}'s built-in editor; remote uses MacroBBS's
  378.         editor), and (Q)uit to the READ MENU.
  379.  
  380.         The Access Level needed to access the (S)ysop option must be set in
  381.         the MacroBBS configuration.  ALSO, the Access Level needed to access
  382.         (D)OS from the MAIN MENU is now configurable.
  383.  
  384.  A  5.  Added the FORWARD (>) and REVERSE (<) commands to both the File Base and
  385.         Message Base menus for quickly jumping to the next File or Message area
  386.         without having to utilize the AREA LIST.
  387.  
  388.  A  6.  Added the (R)eviewScan option to the MESSAGE BASE MENU for scanning
  389.         message headers quickly.
  390.  
  391.  A  7.  Added the (T)race command to the message READ MENU.  Selecting T will
  392.         auto-display the message to which the current message is a reply,
  393.         assuming the current message IS a reply to another message.
  394.  
  395.  A  8.  Added a configurable time limit per call, not counting chat time or
  396.         time spent UPloading.  If you and a Caller chat for an hour, the
  397.         Caller will still have as much on-line time left as he/she did upon
  398.         entering chat mode.  The same goes for file UPload.
  399.  
  400.  -  Hint for the not-so-distant future:
  401.  
  402.         I have BIG plans for that empty off-line options slot.  <grin>
  403.  
  404.  
  405. * * * *
  406. * 1.1 *
  407. * * * *
  408.  
  409.  -  Bug fixes:
  410.  
  411.     1.  The NEWSCAN routine -  The NEWSCAN flag was not being reset when
  412.         NEWSCAN was QUITted via the READ MENU command.
  413.  
  414.     2.  Off-line Edit Caller routine:  If you edited a Caller before 12 noon,
  415.         that Caller's name/id# would be saved to disk as the "last Caller"
  416.         when the time flag was updated at noon.
  417.  
  418.     3.  OFF-LINE option 2, "See Scrollback," now works.
  419.  
  420.     4. Protocol select:  The protocol selection menu was "missing" but has
  421.        been replaced and is now working properly.
  422.  
  423.     5.  A ton of misspellings in the MACROBBS.DOC file were fixed.
  424.         (I *CAN* spell...  Really I can.  :)
  425.  
  426.  -  New features:
  427.  
  428.     1.  Local file upload routine:  Now there's an automated way to add files
  429.         to a file list.  Copy the files (the ones you want to add to a file
  430.         list) to the proper disk directory (ie. \COMMO\FILES\F2), log-on
  431.         locally and go to the File Base Menu.  After switching to the area you
  432.         want to add files to, choose U for Upload.  Enter a file mask (it may
  433.         include wildcards, eg. *.ZIP)  If any files matching the mask exist in
  434.         that file area's disk directory, they will be displayed one at a time
  435.         and you will be asked whether or not you want to add the displayed file
  436.         to the list.  If you choose YES, you will be prompted to enter a file
  437.         description.  To abort (NOT add the file), Press ENTER only. Otherwise,
  438.         type in a description and press ENTER.  The file/size/description is
  439.         then added to the file list for that area.
  440.  
  441.     2.  Added the [D]OS shell option to the ON-LINE SYSOP MENU.
  442.  
  443.