home *** CD-ROM | disk | FTP | other *** search
/ ftp.wwiv.com / ftp.wwiv.com.zip / ftp.wwiv.com / pub / BBS / JM_PD_12.ZIP / PULL.DOC < prev    next >
Text File  |  1995-01-07  |  21KB  |  457 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                           PullDown Menu System v1.2
  15.                   Copyright (C) 1994, by Cutting Edge Online
  16.                              All rights reserved.
  17.  
  18.                   Programming and Documentation by John Marx
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.        Cutting Edge Online                              (318) 537-7089 Voice
  38.        6372-B Kucinski Street                           (318) 537-7746 BBS
  39.        Fort Polk, LA  71459                             Hayes Optima 28.8k
  40.        U.S.A.                                           FidoNet: 1:3817/9
  41.  
  42.  PullDown Menu System v1.2                                     Page 1 of 11
  43. ----------------------------------------------------------------------------
  44.  
  45.                                Table of Contents
  46.  
  47.  
  48.           System Requirements . . . . . . . . . . . . . . . . . . . . . 2
  49.  
  50.           Disclaimers . . . . . . . . . . . . . . . . . . . . . . . . . 3
  51.  
  52.           Program Overview  . . . . . . . . . . . . . . . . . . . . . . 4
  53.  
  54.           Program Installation  . . . . . . . . . . . . . . . . . . . . 5
  55.  
  56.           Possible Error Codes  . . . . . . . . . . . . . . . . . . . . 6
  57.  
  58.           Contacting the author . . . . . . . . . . . . . . . . . . . . 7
  59.  
  60.           Registration  . . . . . . . . . . . . . . . . . . . . . . . . 8
  61.  
  62.           Obtaining the latest versions . . . . . . . . . . . . . . . . 10
  63.  
  64.           Frequently asked questions  . . . . . . . . . . . . . . . . . 11
  65.  
  66.  PullDown Menu System v1.2                                     Page 2 of 11
  67. ----------------------------------------------------------------------------
  68.  
  69.                               System Requirements
  70.  
  71.      The requirements for using this PPE are as follows:
  72.  
  73.           a.  PCBoard 15.2+ (This program was created with PPLC v3.0 and will
  74. not work with any version less than 15.2.)
  75.  
  76.           b.  Enough space on your hard drive for installation of the
  77. program.
  78.  
  79.           c.  It's not needed but placing this PPE and all your PPE's into
  80. different subdirectories is helpful.  This allows you to more easily update
  81. or remove a PPE with it's accompanying files.  Plus if you place more than
  82. one PPE in a directory you may run into the program trying to use a file it
  83. shouldn't.
  84.  
  85.      This is all that is needed to run this program.
  86.  
  87.  PullDown Menu System v1.2                                     Page 3 of 11
  88. ----------------------------------------------------------------------------
  89.  
  90.                                   Disclaimer
  91.  
  92.      This is the part everyone hates.  The disclaimer is the legalities to
  93. protect the programmer/writer of the program and documentation.  It is here
  94. that we designate what and what not can be done with this program.
  95.  
  96.      You may NOT reverse engineer this program.  Either by HEX editor or by
  97. decompiler (such as PPLD and variants.)  You agree that you will not attempt
  98. to reverse compile, modify, translate, or disassemble the software in whole or
  99. in part.
  100.  
  101.      You are granted to try this software for upto 7 days.  If after this
  102. trial period you feel this program is not worth the amount being asked for it
  103. then you must remove it, otherwise send in your registration fee so that you
  104. will not be running pirated software.
  105.  
  106.      You are granted that once you register this program that it will only be
  107. allowed on one system.  This system can have an unlimited number of nodes, but
  108. these nodes must be in the same location.  If you're business is operating with
  109. a WAN then each remote system connection must have a registered copy.
  110.  
  111.      This software is protected by United States copyright law and international
  112. treaty provisions.  You acknowledge that no title to the intellectual property
  113. in the software is transferred to you.  You further acknowledge that title and
  114. full ownership rights to the software will remain the exclusive property of
  115. Cutting Ege Online or its suppliers, and you will not acquire any rights to the
  116. software except as expressly set forth in this license.  You agree that any
  117. copies of the software will contain the same proprietary notices which appear
  118. on and in the software.
  119.  
  120.      We are not liable for any damages which you may incur using this software.
  121. In no event shall Cutting Edge Online or its supplies be liable to you for any
  122. consequential, special, incidental or indirect damages of any kind arising out
  123. of the delivery, performance or use of the software, even if we are advised of
  124. the possibility of such damages.
  125.  
  126.      This license will be governed by the laws of the State of Louisiana as
  127. they are applied to agreements between Louisiana residents entered into and to
  128. be performed entirely within Louisiana.  The United Nations Convention on
  129. Contracts for the International Sale of Goods is specifically disclaimed.
  130.  
  131.      This is the entire agreement between you and Cutting Edge Online which
  132. supersedes any prior agreement or understanding, whether written or oral,
  133. relating to the subject matter of this license.
  134.  
  135.      Should you have any questions concerning this license agreement, or if
  136. you desire to contact Cutting Edge Online for any reason, please call
  137. (318) 537-7089, or write: Cutting Edge Online, 6372-B Kucinski Street,
  138. Fort Polk, Louisiana  71459
  139.  
  140.  PullDown Menu System v1.2                                     Page 4 of 11
  141. ----------------------------------------------------------------------------
  142.  
  143.                                Program Overview
  144.  
  145.      I would like to thank the Scott Eby who created the Pull Down Menu PPE
  146. which gave me the idea for this menu.  I've taken what he started and pretty
  147. much copied his look and feel and made an entirely new and what I believe
  148. quite faster PPE.
  149.  
  150.      Some of the features which I copied off of Scott were the idea of a
  151. CTRL based menu hot key to select the menus.  In his PPE he also had it so
  152. that you could use the command prompt line.  This was not done in mine for I
  153. felt that most people who wished to use the command line would just choose the
  154. ordinary (default) language on my system.  The menu names and structures were
  155. also used for it's my hope that users who used his fine program will like mine
  156. even more and all they will have to do is copy my program over theirs, minus
  157. the .men and .key files and will be up and running in less than a minute.
  158.  
  159.      I've made many enhancements to his PPE.  The enhancements are as follows:
  160.  
  161.           · External PROMPTS file for defining menu style and colors.  There
  162.             are sample PR-SAMP? files included within this file.
  163.  
  164.           · Multiple language support.
  165.  
  166.           · Checks for ANSI.  His might have done this, but I've incorporated
  167.             an external definition file also.  If the required graphics mode
  168.             is not found the program will revert to language 1.
  169.  
  170.           · Checks for Carrier speed.  His might have done this, but I've
  171.             incorporated an external definition file also.  Speed selectable
  172.             by System Operator.  If the required speed is not there the program
  173.             will switch to language 1.
  174.  
  175.           · Configuration file.
  176.  
  177.           · Checks for keyboard inactivity.  When running his program I left
  178.             my computer for about two hours and the program was still there.
  179.             (It didn't time out and automatically logoff, it does now.)
  180.  
  181.           · He had it so that if the menu files were missing the program would
  182.             lock up the system.  I didn't want this to happen so I've also
  183.             added checking for all of the required system files and if any or
  184.             all are missing then the program will not be run and switch to
  185.             language 1.
  186.  
  187.           · If you must have the use of the command line then you do have
  188.             the capability.  If you want to display the command line you can
  189.             press the ESCape key and then enter the command you want.  When
  190.             you press the ESCape key it will display a ? on line 21 of the
  191.             display.
  192.  
  193.           · There is an "initial logon" display file which will be displayed
  194.             anytime the program gets displayed from the start of the program
  195.             (i.e. you view file directories, change conferences, etc).  This
  196.             display file (if it exists) will be displayed.  It may be used
  197.             to show the user what keys do what.
  198.  
  199.           · There are bound to be items which I've forgotten about, but these
  200.             are the ones which have popped into my head while typing the
  201.             documentation.
  202.  
  203.           · Ability to use a background file (called BACK).  This file is
  204.             language, security and graphic capable.
  205.  
  206.           · Ability to use the 2,4,6,8 keys for cursor movement.
  207.  
  208.  PullDown Menu System v1.2                                     Page 5 of 11
  209. ----------------------------------------------------------------------------
  210.  
  211.                              Program Installation
  212.  
  213.      To install this program you will need to do the following:
  214.  
  215.           1.  First unZIP the archive into its new subdirectory.
  216.  
  217. * NOTE:  If you're upgrading from a previous PullDown Menu System or the
  218. Pull Down menus by Scott Eby you may wish to back up your .men and .key
  219. files so that you don't erase your hard work you've done.
  220.  
  221.           2.  The first thing which must be done is edit the language file
  222. you wish to use with this.  After you've done that you will have to do the
  223. following:
  224.  
  225.                a.  MKPCBTXT PCBTEXT.[language]
  226.                b.  Press F3
  227.                c.  Enter 396 for the record number to update
  228.                d.  Add the following line to your PCBTEXT file:
  229.  
  230.                     (1) ![drive:][path]\pull.ppe
  231.  
  232. * NOTE:  It's extremely important that you add the ! in front of this.
  233. * NOTE:  The [drive:] is the drive where the PPE is located
  234. * NOTE:  The [path] is the path where the PPE is located
  235.  
  236.                e.  Press the ESC key.
  237.  
  238.           3.  Next you will want to edit your configuration file if you
  239. wish to change it.  Most people will likely not need to change this file.
  240.  
  241.           4.  If you wish to change your .men files or .key files now is
  242. the appropriate time.  Here's the layout of the files:
  243.  
  244.         M?.MEN                         M?.KEY
  245.  ───────────────────────────────────  ───────────────────────────────────
  246.   Description Line                    Action Line
  247.     · Upto 16 characters wide.          · Does what ever is described
  248.       (If wider it will be                for thee line in the menu.  This
  249.        truncated to 16 characters.)       may be either a PPE (defined in
  250.     · Upto 16 items (lines).  Any         the CMD.LST file or any internal
  251.       line over 16 will not be            PCBoard command.
  252.       displayed.
  253.  
  254. * NOTE:  There are 5 menus.  All 5 menus MUST exist or the program won't
  255. run.  The appropriate .KEY files must also exist.
  256.  
  257. * NOTE:  You will not want a BRDM.[language] or BRDS.[language] file to
  258. exist for the language you are using for this program.  On my system I've
  259. created a BRDM and BRDS for this language which contains absolutely nothing
  260. so I know nothing will get displyed.
  261.  
  262. * NOTE:  You must have multiple languages enabled!  If you don't the program
  263. may not work correctly for this PPE was designed to be part of our complete
  264. PullDown/Light bar menu system and if any errors occur it will change the
  265. language to the default language (language 1).
  266.  
  267.  PullDown Menu System v1.2                                     Page 6 of 11
  268. ----------------------------------------------------------------------------
  269.  
  270.                            Possible Error Codes
  271.  
  272.      There are several reasons for error codes.  The main reason is something
  273. went wrong in the program.  Even though all efforts have been made to remove
  274. any and all possible errors there still may be some configuration we haven't
  275. thought of.  As such we've included extensive error checking in all of our
  276. programs to eliminate any and all possible errors.
  277.  
  278.      Errors will be shown to the caller on the screen explaining what went
  279. wrong and why if the program can determine without a doubt what it was.
  280.  
  281.      All errors will be logged to the callers log!  This allows you to
  282. correct any problems that your users might not tell you.  A lot of times when
  283. an error occurs the users like "that's nice."  We feel that even as nice as
  284. it would be for the user to explain to the SysOp what they were doing when
  285. such errors occur, we know not to expect it so we've added this to the code
  286. as well.  When it logs this information to the callers log it also logs the
  287. exact saying that it gave to the user.  This gives you the most complete
  288. information we can.
  289.  
  290.      You may also wish to check out the "Frequently Asked Questions" at the
  291. end of this document for it may cover a question you are currently having
  292. about PCBoard and PPE's.
  293.  
  294.  PullDown Menu System v1.2                                     Page 7 of 11
  295. ----------------------------------------------------------------------------
  296.  
  297.                              Contacting the Author
  298.  
  299.      I can be reached on either my BBS or through my home phone number at any
  300. time.  If I'm not home and you receive the answering machine just leave your
  301. name and number with a short explanation, if you can, of the problem.  I WILL
  302. call you back as soon as I can and if you gave me a description of your
  303. problem will more than likely have an answer for you when I do call you back.
  304.  
  305.      When you do call us with information about a bug in the program please
  306. give us the following information.  This information will help us determine
  307. what the problem is:
  308.  
  309.           1.  Program name and version number.
  310.  
  311.           2.  Type and brand of computer, hard disk, plus any peripherals.
  312.  
  313.           3.  Version of DOS plus any TSRs or device drivers in use.
  314.  
  315.           4.  Explanation of your AUTOEXEC.BAT and CONFIG.SYS files.
  316.  
  317.           5.  Description of what is in memory from the MEM command (DOS 4
  318.               and above users only) or a similar utility.
  319.  
  320.           6.  The exact problem you are having.  Please be as specific as
  321.               possible.  Having a printout of the screen and/or being at your
  322.               computer will be helpful.
  323.  
  324.      The Cutting Edge Online BBS operates 24 hours a day, is using a Hayes
  325. Optima 28.8k modem, PCBoard 15.2/10 and the number is (318) 537-7746.  You
  326. will be able to download if you wish on the first call.  There are no
  327. callback doors.  We do use CALLER-ID for just this purpose.  I personally
  328. don't like callback doors and am sure many others feel the same.
  329.  
  330.      I'm available also on the PCBoard Support BBS, Salt Air.  I only call
  331. once a week, normally on Saturday so the replies won't be as quick as you may
  332. like.  I'm also in the FidoNet PCBoard, PCB-Net conferences.  Our FidoNet
  333. address is 1:3817/9.
  334.  
  335.      If you have a problem, suggestion, comment, download or just wish to
  336. talk please call and we will be more than glad to serve you.  We're not happy
  337. until YOU are happy so let us know if we're doing something wrong.  If we're
  338. doing it right tell your fellow PCBoard SysOps, if not tell US!
  339.  
  340.  PullDown Menu System v1.2                                     Page 8 of 11
  341. ----------------------------------------------------------------------------
  342.  
  343.                                  Registration
  344.  
  345.      A registration fee is required for use of this program and any other
  346. program we create that is used of 7 days.  This registration will be used to
  347. help further the development of this and other fine PPE's.
  348.  
  349.      The complete set of PPE's can be bought in for one small fee which will
  350. entitle you to all future PPE's for FREE.  There will never be an upgrade
  351. cost to upgrade a previous PPE to future PPE's.  Even if there is a complete
  352. re-write of the code; there will NOT be an upgrade fee, EVER!
  353.  
  354.      By register our products you are allowing us to continue to improve
  355. online computer systems for the better.  We have a continued commitment to
  356. see the online community grow for it's this growth which will allow all of
  357. us to further increase our knowledge.
  358.  
  359.      We hope that you will try our PPE's and find them of us to you.  If you
  360. see a PPE which costs more and would like to see it offered by us, if you want
  361. to see an improvement, if you're having a problem call us up and let us know.
  362.  
  363.      On the following page is a complete order form for this product.  We
  364. hope that you will enjoy our PPE's enough to show support for the continued
  365. improvement of our PPE's.  Thank you.
  366.  
  367.      Make checks or money orders payable to: John Marx
  368.  
  369. Send orders to:
  370.  
  371. John Marx
  372. ATTN: PPE Registration
  373. 6372-B Kucinski Street
  374. Fort Polk, LA  71459
  375.  
  376.  PullDown Menu System v1.2                                     Page 9 of 11
  377. ----------------------------------------------------------------------------
  378.                                   Order Form
  379. ----------------------------------------------------------------------------
  380.  
  381. System Operator: ___________________________________________________________
  382.  
  383. BBS Name: __________________________________________________________________
  384.           Above line must be exact for the Registration code is based on it.
  385.  
  386. Address: ___________________________________________________________________
  387. City: _________________________ State: ________________ Zip Code: __________
  388. Voice Phone: (_____) _____-_______        Data Phone:  (_____) _____-_______
  389. Login Password: ___________________________________________________
  390.                 (minimum of 6 characters, maximum of 13 characters)
  391.  
  392. Available Products:
  393.  
  394. Description              Released   Cost (each)     Quantity        Total
  395. ----------------------------------------------------------------------------
  396. Automated File Uploader   Yes        $10.00       __________      __________
  397. Clear Locked Node         Yes        $ 5.00       __________      __________
  398. Enter Replacement         Yes        $ 5.00       __________      __________
  399. File Menu                 Yes        $10.00       __________      __________
  400. Graphics Mode Changer     Yes        $ 5.00       __________      __________
  401. Alias Changer             Yes        $ FREE       __________      __________
  402. New File Scanner          Yes        $ 5.00       __________      __________
  403. Offline File Grabber      Yes        $ 5.00       __________      __________
  404. OneLiners                 Yes        $ 5.00       __________      __________
  405. Page Length Changer       Yes        $ 5.00       __________      __________
  406. Personal Statistics       Yes        $ 5.00       __________      __________
  407. PPE Loader                Yes        $ 5.00       __________      __________
  408. Quote of the Day          Yes        $ 5.00       __________      __________
  409. Quick Scan                Yes        $ 5.00       __________      __________
  410. Who's Online              Yes        $ 5.00       __________      __________
  411. eXpert mode Changer       Yes        $ 5.00       __________      __________
  412. PullDown Menu System      Yes        $10.00       __________      __________
  413.  
  414. Entire Package
  415. (all PPE's and future PPE's)    $50.00          __________      __________
  416.  
  417. Sub-total                                                       __________
  418.  
  419. Delivery Costs (pick one):
  420.      FidoNet (CRASH MAIL, we send it to you!)           $5.00   __________
  421.      By US Mail (3.5" HD disk, with all recent PPE's)   $8.00   __________
  422.      By US Mail (5.25" HD disk, with all recent PPE's)  $8.00   __________
  423.      You call and pick up (must provided name/password)  Free   __________
  424.  
  425. Tax (Louisiana residents add 7% tax)                            __________
  426.  
  427. Grand Total                                                     __________
  428.  
  429.  PullDown Menu System v1.2                                    Page 10 of 11
  430. ----------------------------------------------------------------------------
  431.  
  432.                         Obtaining the latest versions
  433.  
  434.      The latest version of our PCBoard PPE's are always available on our
  435. system as FREE/NO TIME downloads, even to the first time caller.
  436.  
  437.      Our PPE's will also be available for download from the following
  438. systems.
  439.  
  440.            1.  Cutting Edge Online            -- (318) 537-7746
  441.  
  442.            2.  Salt Air (PCBoard Support BBS) -- (801) 261-8976
  443.  
  444.            3.  Software Creations             -- (508) 368-7036
  445.  
  446.      These systems will always have the most current copy of our programs
  447. online.
  448.  
  449.  PullDown Menu System v1.2                                    Page 11 of 11
  450. ----------------------------------------------------------------------------
  451.  
  452.                           Frequently asked questions
  453.  
  454.      This section is currently left blank.  This area will grow as the
  455. questions begin to come in.  This area will be for future references to
  456. problems some users are experiencing.
  457.