home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 8 / CDASC08.ISO / VRAC / FMM10.ZIP / FMM.DOC < prev    next >
Text File  |  1993-08-11  |  14KB  |  296 lines
  1.                  ╔══════════════════════════════════════════╗
  2.                  ║       Forum Menu Maker (FMM) v1.0        ║
  3.                  ║        Especially for Gap BBSes          ║
  4.                  ║        running the MainMail door         ║
  5.                  ║ Copyright 1993, Exhibit A Communications ║
  6.                  ╚══════════════════════════════════════════╝
  7.  
  8.  
  9. ┌─────────────┐
  10. │  About FMM  │
  11. └─────────────┘
  12.  
  13.         Tired of constantly having to re-create your forum menus everytime
  14. you add/delete/move a forum in GAP? Wish there was an easier way to
  15. divide your forum menu into seperate menus for each network? Well them
  16. Forum Menu Maker (FMM10.ZIP) is just for you!
  17.  
  18.         This handy little utility is designed to work exclusively on GAP
  19. BBSes running the MainMail System Mail Door. All you need to do is to
  20. modify the FMM configuration file ONCE and it does all the rest! Forum
  21. information is pulled from the GAP and MainMail 3.x data files to create
  22. ASCII and Xcoded forum menus.
  23.  
  24.         FMM, along with other BBS doors and sysop utilities from Exhibit
  25. A Communication, can be found on InfoMat BBS (714-492-8727) as well as fine
  26. BBSes near you! You can now register your Exhibit A program on InfoMat
  27. with a credit card so call today!
  28.  
  29.  
  30. ┌────────────────────┐
  31. │  About Shareware   │
  32. └────────────────────┘
  33.  
  34.         Shareware is a method of software distribution designed to benefit
  35. both the software developer and the end user.  Shareware (SW) should not
  36. be confused with Public Domain (PD) programs.  While  PD programs are
  37. released to the public with no restrictions attached to their use, SW
  38. programs are the copyrighted work of their authors.  The SW programs are
  39. released to the public for evaluation purposes under the assumption that
  40. if the end user likes the program and continues to use it after a
  41. reasonable period of time, that user is obligated to register the
  42. program.
  43.         If you purchased this program from a SW distributor, you have
  44. not registered it.  You must still pay the programmer to register it.
  45. The money you paid to the distributor was to cover the cost of
  46. duplicating/advertising/etc the files.
  47.         Programmers get to distribute their wares without the expense
  48. of advertising, packaging & distribution.  The users benefit from being
  49. able to try out the programs without having to pay for the privilege of
  50. evaluation.  Shareware programmers (the good ones anyway) are generally
  51. more responsive to bug reports & user requests for additional features.
  52. Everyone benefits provided that the users remember to register and
  53. programmers continue to ... well, program<G>.
  54.  
  55. ┌────────────────────┐
  56. │  Registration      │
  57. └────────────────────┘
  58.  
  59.         Please fill out the file ORDER.FRM, copy it to your printer
  60. and mail it along with a check for $10.00 to Exhibit A Communications
  61. at the address shown on the form.
  62.  
  63.         Or if you want to register painlessly, you can now register
  64. FMM on InfoMat BBS at (714) 492-8727.  Just enter CHARGE at the Main Menu
  65. prompt.  Cost is the same to you and you don't have to mess with U.S(nail).
  66. Mail at all. Or fax your ORDER.FRM to us with your credit card information.
  67. Our fax number is (714) 492-3697.
  68.  
  69.         By sending in your registration fee, you will be entitled to
  70. the following:
  71.         1) Removal of the UNREGISTERED message
  72.         2) Continued use of this program on any single or multiuser BBS
  73.         3) Free upgrades to future versions
  74.         4) Enhanced support from programmer
  75.         5) The satisfaction of knowing that you are helping to make the
  76.                 shareware system alive
  77.         6) A jump to the next Karma level
  78.         7) The undying gratitude of my wife, son and dog <g>
  79.  
  80.  
  81. ┌────────────────────┐
  82. │  Requirements      │
  83. └────────────────────┘
  84.  
  85.         1) FMM  will only run on a GAP BBS system that is currently
  86.                 running the MainMail System mail door.
  87.  
  88.  
  89. ┌────────────────────┐
  90. │  Installation      │
  91. └────────────────────┘
  92.  
  93.         To install FMM, simply copy the FMM.EXE and FMM.CFG files to any
  94. directory on your hard drive. Then edit the FMM.CFG file using the following
  95. directions. (Note that comments in .CFG file must begin the line with ";")
  96.  
  97. Line    Description
  98. ────    ───────────────────────────────────────────────────────────────────
  99. 1)      This is where you will place the number you recieve when you register
  100.         the program with Exhibit A Communications.
  101.  
  102. 2)      This is your name, as detailed in the registration information you
  103.         receive after registering FMM with Exhibit A Communications.
  104.  
  105. 3)      This is the name of your BBS. This line can not be more than 32
  106.         characters in lenght.
  107.  
  108. 4)      This is the full drive\path\filename of the MainMail configuration
  109.         file. It is usually named MMDAT.CNF and is located in GAP's MAIN
  110.         directory.
  111.  
  112. 5)      This is the full drive\path\filename of the GAP forum file. It is
  113.         usually named FORUM.DAT and is located in GAP'S MAIN directory.
  114.  
  115. 6)      This is the full drive\path\filename of the ASCII forum menu file.
  116.         GAP expects this file to be named FORUMM and should be in your GAP
  117.         GEN directory. The Xcode (color) file will be name the same, only
  118.         ending with the letter G.
  119.  
  120. 7)      This line is optional. If you wish to have a file displayed at the
  121.         top of the forum menu, please place the full file\path\filename of
  122.         it on this line. If not, please leave it blank. Please use the ASCII
  123.         file's name, as FMM will look for the same name with a G at the end
  124.         for the Xcode (color) file. If you decide to use the example HEADER
  125.         files, please make sure you adapt it to your particular BBS and network
  126.         names.
  127.  
  128. 8)      This line allows you to select between the more informative, Normal
  129.         menu display and the Condensed menu. You mus place either NORMAL
  130.         or CONDENSED on this line.
  131.  
  132. 9)      This is the color configuration line. It is comprised of a string of
  133.         hexidecimal numbers used to define colors used in the forum menus.
  134.         There needs to be a total of 16 characters on this line and there can
  135.         be no spaces between any characters. Each of the 16 characters are
  136.         defined below:
  137.         1)  Base color            => background
  138.         2)  Base color            => foreground
  139.         3)  Border color          => background
  140.         4)  Border color          => foreground
  141.         5)  Window color          => background
  142.         6)  Window color          => foreground
  143.         7)  Border comments color => background
  144.         8)  Border comments color => foreground
  145.         9)  Forum number color    => background
  146.         10) Forum number color    => foreground
  147.         11) Forum name color      => background
  148.         12) Forum name color      => foreground
  149.         13) Private flag color    => background
  150.         14) Private flag color    => foreground
  151.         15) Files flag color      => background
  152.         16) Files flag color      => foreground
  153.     For example, match the numbers up to the Normal menu sample below:
  154.  
  155.     ╔══[   7&8       ]═══════════════════════[     7&8     ]═╗
  156. 1&2 ║ xxxx) Forum Name  P F    │                             ║
  157.     ║ 9&10)  11&12      │ │    │                             ║
  158.     ║             13&14─┘ │   3&4                            ║
  159.     ║                     │    │                             ║
  160.     ║             15&16───┘    │                             ║
  161.     ║                          │                             ║
  162.     ╚══════════════════3&4═══════════════════[  7&8        ]═╝
  163.  
  164.         ┌──────────────────────────────────────────────────────────┐
  165.         │                       Color Chart                        │
  166.         ├──────────────────────────────────────────────────────────┤
  167.         │                        Background         Foreground     │
  168.         │ Color                Normal   Blink    Normal      Bold  │
  169.         ├──────────────────┬─────────┬─────────┬─────────┬─────────┤
  170.         │ Black            │   0     │    8    │    0    │    8    │
  171.         │ Blue             │   1     │    9    │    1    │    9    │
  172.         │ Green            │   2     │    A    │    2    │    A    │
  173.         │ Cyan             │   3     │    B    │    3    │    B    │
  174.         │ Red              │   4     │    C    │    4    │    C    │
  175.         │ Magenta          │   5     │    D    │    5    │    D    │
  176.         │ Yellow           │   6     │    E    │    6    │    E    │
  177.         │ White            │   7     │    F    │    7    │    F    │
  178.         └──────────────────┴─────────┴─────────┴─────────┴─────────┘
  179.  
  180. Multi-Node operation:
  181.  
  182.         No special provisions are necessary for Multi-Node operations as
  183.         all files are opened in sharing mode.
  184.  
  185.  
  186. ┌────────────────────┐
  187. │  Operation         │
  188. └────────────────────┘
  189.  
  190.         To run FMM, you need only to enter the following command line:
  191.                         FMM [configuration file]
  192.         where [configuration file] is the name of your configuration file.
  193.         Be sure to include the path and drive if the configuration file
  194.         is not in the directory you are launching the program from.
  195.  
  196. ┌────────────────────┐
  197. │  Support           │
  198. └────────────────────┘
  199.  
  200.         READROOM is fully supported by it's programmer Michael J. Gibbs
  201. through Exhibit A Communications.  He can be reached in the following
  202. manners:
  203.         1) Intelec network
  204.                 conferences monitored:
  205.                         SYSOP
  206.                         PCRELAY
  207.                         BBS DOORS
  208.                         PROGRAMMING
  209.                         C PROGRAMMING
  210.                         INTELEC ADMIN
  211.         2) MediaNET network          node id:->EXHIBITA
  212.                 conferences monitored:
  213.                         MEDIANET ADMIN
  214.                         PRO PHOTO
  215.                         MEDIANET CHAT
  216.         2) RaceNet network           node id:->EXHIBITA
  217.                 conferences monitored:
  218.                         EXHIBITA
  219.                         OFFROAD
  220.                         RACENET SYSOPS
  221.         3) InfoMat BBS (714) 492-8727
  222.                 forum 7 is support for Exhibit A Programs
  223.         4) CI$  #72246,1653
  224.         5) Orange County Information Network
  225.                         EXHIBITA forum
  226.         6) Pen and Brush Network     node id:->1153
  227.                         EXHIBITA/READROOM forum
  228.  
  229. ┌────────────────────┐
  230. │  Legal Disclaimer  │
  231. └────────────────────┘
  232. (small print on<g>)
  233.         As with any program, every attempt is made by the programmer to
  234. kill all the bugs in the software before it is release to the public.
  235. Since this is all but impossible, it is recommended that new software
  236. should only be run (for the first time at least) when a current backup
  237. of your hard disk is available.  When shareware is released for public
  238. evaluation, there is little that can be done on the programmer's end to
  239. prevent others from infecting the program with viruses or making
  240. unauthorized changes to the program.  AS SUCH, user agrees to hold
  241. harmless MICHAEL J. GIBBS, INFOMAT BBS and EXHIBIT A COMMUNICATIONS in
  242. regards to any personal, physical, emotion, financial, sexual or other
  243. damage that may occur to hardware, software or the user that may arise
  244. from the use of this program.  Use of this program is considered to be
  245. acceptance of these conditions.
  246.         This program remains the copyrighted work of Exhibit A
  247. Communications.  When you register the program, you are granted a
  248. license to use this program on one (1) BBS system, regardless of how
  249. many nodes are active.  You may sell your registered number to another
  250. if the following conditions are met:
  251.         1) All copies of the software and any documentation are
  252.                 transferred to the new owner.
  253.         2) You must discontinue use of the program following the sale.
  254.         3) The new owner must contact Exhibit A Communications to update
  255.                 our user records.
  256.         This program may not be sold in it's unregistered form.  It is
  257. intended to be distributed freely.  Pay BBS systems are exempt from this
  258. requirement provided they are not charging specifically for access to
  259. this one program.  Shareware distributors/User Groups may charge a nominal
  260. copying/library fee not to exceed $7.00.
  261. (small print off<g>)
  262.  
  263. ┌────────────────────┐
  264. │  Special Thanks    │
  265. └────────────────────┘
  266.  
  267.  
  268.         Special thanks go out to:
  269.                 My wife Lori and son Bobby for tolerating my weird ways.
  270.                 Tony Summy who graciously provided the structure for the
  271.                         MainMail System's data files.  Without this, the
  272.                         project would never have gotten off the ground.
  273.                 Kenny Gardner for making available the structures of GAP's
  274.                         data files available to us third-party programmer's
  275.                         and for creating and continually improving one of
  276.                         the best BBS software packages around.
  277.                 Brett and Todd for suggesting the need for this package as
  278.                         they battle it out to see who can carry more
  279.                         echo-mail forums<g>.
  280.  
  281.  
  282. ┌────────────────────┐
  283. │  Appendix          │
  284. └────────────────────┘
  285.  
  286.  
  287.    Appendix A
  288.    ──────────
  289.                         ┌───────────────┐
  290.                         │ HISTORY:  FMM │
  291.                         └───────────────┘
  292. Version         Date            Fixes, Changes, etc.
  293. ───────         ────────        ─────────────────────────────────────
  294.   1.0           08/11/93        First public release of the program.
  295.  
  296.