home *** CD-ROM | disk | FTP | other *** search
/ The Devil's Doorknob BBS Capture (1996-2003) / devilsdoorknobbbscapture1996-2003.iso / Dloads / PROGRAMM / QWKBAS18.ZIP / QWKBASIC.DOC < prev    next >
Text File  |  1992-02-05  |  21KB  |  843 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                 TheZoftWare Programming System
  10.  
  11.                            Presents
  12.  
  13.  
  14.       ■■■■■  ■■      ■■ ■■   ■■ ■■■■■
  15.      ■■   ■■  ■      ■   ■  ■   ■    ■
  16.      ■■   ■■  ■■ ■■ ■■   ■■■    ■■■■■   ■■■ ■ ■■■■ ■ ■■■■■
  17.      ■■ ■ ■■   ■ ■■ ■    ■  ■   ■    ■ ■    ■ ■__  ■ ■
  18.      ■■  ■■■   ■■  ■■    ■   ■  ■    ■ ■   ■■    ■ ■ ■
  19.       ■■■■■ \   ■  ■    ■■   ■■ ■■■■■   ■■■ ■ ■■■■ ■ ■■■■■
  20.  
  21.  
  22.                          Version 1.08
  23.  
  24.  
  25.  
  26.  
  27.           Copyright (C) 1992-1993 By Manuel Godinez
  28.               All Rights Reserved By the author.
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                 Release date: February 9, 1992
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.        Documentation By Mark Phillips & Manuel Godinez
  56.  
  57.  
  58.  
  59. QWKBasic
  60.  
  61.  
  62. Master Index
  63. ------------------------------------------------------------
  64.  
  65. Presentation............................................. 1
  66.  
  67. Distribution............................................. 1
  68.  
  69. Registration............................................. 2
  70.  
  71. What's QWKBasic ? ....................................... 3
  72.  
  73. Hardware Requirements ................................... 3
  74.  
  75. Word Processors ......................................... 4
  76.  
  77. The Packers & Unpackers ................................. 4
  78.  
  79. The Quick Start ......................................... 5
  80.  
  81. Configuration of QWKBasic.CFG ........................... 5
  82.  
  83. Using QWKBasic .......................................... 6
  84.  
  85. The QWK Main Menu ........................................7
  86.  
  87. The Selection Menu ...................................... 8
  88.  
  89. The Conference Menu ..................................... 9
  90.  
  91. Entering a New Message .................................. 9
  92.  
  93. The Reading Menu ....................................... 10
  94.  
  95. Replying ............................................... 11
  96.  
  97. Editing a Reply ........................................ 11
  98.  
  99. Taglines ............................................... 11
  100.  
  101. History ................................................ 12
  102.  
  103. Thanks to .............................................. 13
  104.  
  105. The author ............................................. 13
  106.  
  107. Misc ....................................................14
  108.  
  109.  
  110.  
  111.  
  112.  
  113. QWKBasic                                               Page 1
  114. -------------------------------------------------------------
  115.  
  116. PRESENTATION :
  117.  
  118. Welcome to the new offline mail reader : QWKBasic !
  119. Thank you for trying this program, hoping that you will like
  120. it. As the name of the program says, this program was written
  121. using the language QuickBASIC version 4.50, as you can see
  122. it's small compared to other mail readers and the speed is
  123. fast enough for the tales they say about using Basic
  124. programs.
  125.  
  126.  
  127. DISTRIBUTION :
  128.  
  129. You may distribute the program in its ORIGINAL form and
  130. not charge no more than $4 for shipping/other costs. This
  131. program is being distribute as SHAREWARE, NOT freeware or
  132. public domain. You may try it for 30 day trial basis, and
  133. if you find that it's for you, please send the registration
  134. form to the address provided in the same.
  135.  
  136. After the 30 - day trial, you have to discontinue using this
  137. program. Do NOT take or add anything to the executable files
  138. or ANY other file inside the archive that comes with this
  139. program.
  140.  
  141. This program is distribute 'AS IS', that means I am NOT
  142. responsible for ANY damages that this program may do to your
  143. computer, hard drive ,floppy, etc. I am not held responsible
  144. for anything.
  145.  
  146.  
  147. This program is Copyright (C) 1992-1993 by the U.S. laws and
  148. you may not change the copyright in any way. If you have
  149. registered this program, then you may NOT give, share, loan
  150. the registered program to anybody but yourself.
  151.  
  152. You should ONLY make copies for backup purposes. Other than
  153. that, you cannot give away copies of the registered program.
  154.  
  155. The latest version of QWKBasic will be at The Fuzzy Connection BBS
  156. (414) 822-1121.
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167. QWKBasic                                               Page 2
  168. -------------------------------------------------------------
  169.  
  170. REGISTRATION :
  171.  
  172.  
  173.  
  174.             * R E G I S T R A T I O N    F O R M *
  175.  
  176.                  QWKBasic Offline Mail Reader
  177.  
  178.           Copyright (C) 1992-1993 By Manuel Godinez
  179.             All Rights are Reserved By the Author
  180.                             Above.
  181.  
  182.  
  183.          Send Registration Fee and your Personal Info
  184.                              to:
  185.  
  186.                         TheZoftWare PS
  187.                         Attn. Manuel Godinez [PX]
  188.                         P.O. Box 8761
  189.                         Green Bay, WI 54302-8761.
  190.  
  191.  
  192.  
  193. First Name: _________________  Last Name: ___________________
  194.  
  195. Address: _____________________________. Apt/Suite: _______.
  196.  
  197. City: _______________________ State: _____.   Zip Code _____
  198.  
  199. Age: _____.  Your Telephone Number: (    )  _____-________.
  200.  
  201. Where did you get this copy of QWKBasic? (Be Specific please)
  202.  ___________________________________________________________
  203.  ___________________________________________________________
  204.  ___________________________________________________________
  205.  
  206.  
  207. Please Send me ____ Copy(ies) of QWKBasic of $18.95 each copy
  208. via :
  209.  
  210.              [  ]   U.S. Mail  $4.00 (U.S. Only)
  211.  
  212.        Current Shareware Version you have is Ver. 1.08
  213.  
  214.  A am sending the total Money Order/Check (U.S. Only) of $
  215.  _____.__ , that included Shipping & Handling Fees Payable to
  216.  
  217.  MANUEL GODINEZ.
  218.  
  219. *** NOTE: Make Money Order or Check payable to Manuel
  220. Godinez.
  221. QWKBasic                                               Page 3
  222. -------------------------------------------------------------
  223.  
  224. WHAT'S QWKBasic ???
  225.  
  226. Well, QWKBasic is a mail reader for .QWK mail packets created
  227. by mail doors in BBS's (Bulletin Boards) such as Tomcat,
  228. MarkMail, and many more that allow users of BBS's to download
  229. mail from that BBS and read it and reply in the comfort of
  230. your own home, without having to stay online to read each
  231. messages in the BBS.
  232.  
  233. This is great for long distance callers because they can
  234. download mail and log off, saving a lot of money by having to
  235. stay online by reading message by message and replying.
  236.  
  237. That's why QWKBasic was created as many other mail reader,
  238. but cheaper and does the same as some other readers, but
  239. EASY & Fast.
  240.  
  241.  
  242. HARDWARE REQUIREMENTS :
  243.  
  244. * An IBM PC, XT, AT or 100% Compatible computer.
  245.  
  246. * At least 320 Kb of RAM memory. (512 Kb Recommendable)
  247.  
  248. * Color Monitor (Not necessary)
  249.  
  250. * A Text Editor (TED.COM is included if you don't have one)
  251.  
  252. * Hard Drive (Not necessary but Highly recommended)
  253.  
  254.  
  255.  
  256. As you can see, the requirements are minimum. Now let's go to
  257. the next section of this manual.
  258.  
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275. QWKBasic                                               Page 4
  276. -------------------------------------------------------------
  277.  
  278. WORD PROCESSORS :
  279.  
  280. Since QWKBasic does not have a built in word processor (to
  281. save size of .EXE and memory), you will have to supply
  282. QWKBasic with one. You can choose from many shareware,
  283. freeware, text editor programs or even commercial programs to
  284. use with QWKBasic.
  285.  
  286. I have also included one in case you don't have one, it's
  287. called TED, that stands for Tiny-EDitor. This small but
  288. powerful text editor is only 3 Kb in size so it should be
  289. great for you.
  290.  
  291.  
  292.  
  293. PACKERS AND UNPACKERS :
  294.  
  295. Well, since mail doors compress the .QWK packet in a
  296. compression format, you will need one for each compression
  297. format such as : ARC, ZIP, ARJ, LZH.
  298.  
  299. You can find this program in almost any public BBS or
  300. private.
  301.  
  302. The above formats are accepted by QWKBasic v1.06 +
  303.  
  304. The filenames QWKBasic expects to find in the path supplied
  305. are:
  306.  
  307. LHA.EXE                  (.LZH)
  308. ARJ.EXE                  (.ARJ)
  309. PKPAK.EXE                (.ARC)
  310. PKUNPAK.EXE              (.ARC)
  311. PKZIP.EXE                (.ZIP)
  312. PKUNZIP.EXE              (.ZIP)
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329. QWKBasic                                               Page 5
  330. -------------------------------------------------------------
  331.  
  332. QUICK START :
  333.  
  334.     First of all, please make a hard copy of this document.
  335.  
  336.  
  337.     First create a subdirectory to hold QWKbasic programs,
  338.     such as C:\QWK.  QWKBASIC is a self extracting program so
  339.     before you run it make sure you are in the directory you
  340.     have just created.
  341.  
  342.     NOTE: QWKbasic is small enough so it will work on floppy
  343.     disk. It is best with two floppy drives. Just put the
  344.     reader programs on one drive and the .QWK packets on
  345.     another.
  346.  
  347.  
  348. CONFIGURATION :
  349.  
  350.     Now that you have your reader extracted its time to set
  351.     it up for your personal use. Run QWKSETUP.COM program so
  352.     it will create the .CFG file to work with your system.
  353.     The QWKBASIC.CFG file is only 8 lines long, here is the
  354.     format:
  355.  
  356.     C:\QWK\TAGLINES.MR  ...(Tagline file)
  357.     C:\WORK\  .............(QWKbasic's work directory)
  358.     C:\COMPRESS\  .........(Where your unpacker is located)
  359.     C:\TELIX\DL\  .......(Path where your .QWK packets are)
  360.     C:\TELIX\UL\  ......(Path where the .REP files go)
  361.     C:\QWK\TED    ......(Path/name of text editor)
  362.     C:\QWK\REPLY.MSG  ..(Path/name of Dummy File for replies)
  363.     0    ...............(Quoted Reply Mode)
  364.  
  365.     Note the 'zero'(0) at the end of the config file this
  366.     will supply a > when it quotes the message. If you put a
  367.     'one(1) there it will Box the quote. The Box will cut the
  368.     reply text to 72 characters per line, so the > will too.
  369.  
  370.     This is all it takes to make QWKbasic run.
  371.  
  372.     NOTE: The REPLY.MSG can be any valid DOS name, but the
  373.     above is recommended.
  374.  
  375.  
  376.  
  377.  
  378.  
  379.  
  380.  
  381.  
  382.  
  383.  
  384.  
  385. QWKBasic                                               Page 6
  386. -------------------------------------------------------------
  387.  
  388. USING QWKBASIC :
  389.  
  390. Ok, now that you have configured your .CFG file and created
  391. the valid subdirectories etc. Let's now go and start the
  392. program making sure first that we are in the Main path (Where
  393. the .EXE files are).
  394.  
  395. Just to give you an idea, here are the files that should be
  396. in the main directory of QWKBasic :
  397.  
  398. * QWKBASIC.EXE       The Main Program
  399.  
  400. * QWKBASIC.CFG       The configuration file
  401.  
  402.  
  403. That's it !!!  And make sure all paths are correct in the
  404. .CFG file or the program will not work properly.
  405.  
  406.  
  407. Ok, now from the DOS prompt type
  408.  
  409. C>QWKBASIC    [ENTER]
  410.  
  411. follow by the [ENTER] key or [RETURN] in some keyboards.
  412. Now you are in the Main Menu or should we say the QWK Main
  413. Menu.
  414.  
  415. Ok, now let's go to the next step.
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.  
  434.  
  435.  
  436.  
  437.  
  438.  
  439. QWKBasic                                               Page 7
  440. -------------------------------------------------------------
  441.  
  442. THE QWK MAIN MENU :
  443.  
  444. Ok, here you can select the .QWK packet you want to read, by
  445. using the up and down arrow keys to highlight the name of
  446. the packet and pressing [ENTER]. After that, the program will
  447. shell to DOS and load the UnPackers program and dump all the
  448. files inside to the QWKBasic working directory.
  449.  
  450. There are a few other keys available here in this first
  451. section that I will explain briefly next :
  452.  
  453. Key            Description
  454. ============================================================
  455.  
  456. [Alt] + [C]    This two keys will Display a Pop-Up Calander.
  457.  
  458. [Alt] + [S]    This two keys will Shell to DOS.
  459.  
  460. [Alt] + [D]    Delete the current highlighted .QWK packet.
  461.  
  462. [Esc]          Quit to DOS.
  463.  
  464.  
  465. =============================================================
  466.  
  467. This is it for this section, one more thing, QWKBasic will
  468. Unpack any reply packet .REP if there is any with the same
  469. name as the packet you pick to Unpack and after you are done
  470. reading, it will update the .REP packet.
  471.  
  472.  
  473.  
  474.  
  475.  
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.  
  491.  
  492.  
  493. QWKBasic                                               Page 8
  494. -------------------------------------------------------------
  495.  
  496. THE SELECTION MENU :
  497.  
  498. Here you can select to read:
  499.  
  500. MAIL         This option allows you to read the mail.
  501.  
  502. NEWS         This other option allows you to read the news
  503.              from the BBS.
  504.  
  505. FILES        Displays the new files available in the BBS
  506.  
  507. BLT-??       If any, this are the bulletins from the BBS.
  508.  
  509.  
  510. To select any, just move the highlighted bar to select one
  511. and press [ENTER].
  512.  
  513.  
  514. If you wish to cancel this packet and go and select another
  515. .QWK packet, just press [Esc] key.
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.  
  534.  
  535.  
  536.  
  537.  
  538.  
  539.  
  540.  
  541.  
  542.  
  543.  
  544.  
  545.  
  546.  
  547. QWKBasic                                               Page 9
  548. -------------------------------------------------------------
  549.  
  550.  
  551. THE SELECTION MENU :
  552.  
  553. After you have seen (if any) the HELLO or screen, the next
  554. screen you will see is the Conference Menu in a vertical
  555. form.
  556.  
  557. Here the menu will display all the conferences available in
  558. your BBS along with the REPLY conference and the PERSONAL
  559. conference.
  560.  
  561. This two above are very different from the rest of them, the
  562. REPLY conference is where all replies are kept for editing or
  563. deleting or review. I will explain this later.
  564.  
  565. The PERSONAL conference is where all the mail address to you
  566. is. This conference gathers all your personal mail from other
  567. conferences and puts them here for easy retrieval, you can
  568. reply here but make sure you know the conference number when
  569. replying by looking in the upper-right-corner of the Reading
  570. menu and look for the number of this conference.
  571.  
  572.  
  573. ENTERING A NEW MESSAGE :
  574.  
  575. From this section you can enter a new message in any
  576. conference EXCEPT the REPLY/PERSONAL conference, by using the
  577. arrow keys to move the highlighted bar and selecting the
  578. conference which to put the new message.
  579.  
  580. After this press [ENTER] and you will be asked to confirm if
  581. you want to enter a new message in there.
  582.  
  583. NOTE: This procedure will occur ONLY if there is NO mail
  584.       inside that conference. If there IS mail in that
  585.       conference, then you will need to go to that conference
  586.       and then, when reading mail from that conference, just
  587.       press [R] like if you were replying to that message but
  588.       you CHANGE the destination to your choice.
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601. QWKBasic                                              Page 10
  602. -------------------------------------------------------------
  603.  
  604. THE READING MENU :
  605.  
  606. Well, here we are now, in the Main Reading Menu.
  607.  
  608.   Date: 01-31-92        Time: 13:43
  609.   From: MARK SILVE      Msgs: 455          Read: NO
  610.   To: JOHN DENAR        Refe: NONE         Message 1 of 1
  611.   Subj: Net Mail        Flag: Public       Conference : 0 Gen
  612. ┌───────────────────[ ■ QWKBasic 1.06 ■ ]──────────────────┐
  613. │>                                                         │
  614. │>So what do you think ?                                   │
  615. │>                             Later...                    │
  616. │>                                       John              │
  617. │                                                          │
  618. │Make that 4 for IDO.                                      │
  619. │■ QWKBasic 1.06 ■  Control is being able to hit           │
  620. │                                                          │
  621. │                                                          │
  622. │                                                          │
  623. │                                                          │
  624. │                                                          │
  625. │                                                          │
  626. │                                                          │
  627. └──────────────────────────────────────────────────────────┘
  628.  BBS: Bass Ace's  Green Bay, WI              Time 12:00  pm
  629.  
  630.  
  631. This is the Reading Menu, it simple to understand. From here
  632. you can press any of this keys:
  633.  
  634. Keys           Description
  635. =============================================================
  636.  
  637. [Alt] + [C]    Displays a Calander
  638.  
  639. [PgDn] [PgUp]  This keys will allow you to scroll Text 10
  640.                lines.
  641.  
  642. [Up] [Dn]      This keys will scroll text up/down
  643.  
  644. [Left] [Right] This will scroll text left/right.
  645.  
  646. [Ins]          use the Index menu.
  647.  
  648. [R]            Reply to a message (or enter a new message)
  649.  
  650. [A]            Display the current message in ANSI.
  651.  
  652. [+] or [ENTER] Go to the Next message.
  653.  
  654. [-]            Go back to the last message.
  655. QWKBasic                                              Page 11
  656. -------------------------------------------------------------
  657.  
  658. REPLYING TO A MESSAGE :
  659.  
  660. After you Select [R] , a small menu will appear asking you
  661. the name to who you'll send the letter, press [ENTER] to keep
  662. the current name or press [Del] until the current name is
  663. erase completely and insert the new name to whom you will
  664. send the letter follow by the [ENTER] key.
  665.  
  666. Next, do the same with the subject, if you want to keep the
  667. same subject just press [ENTER], if not change it.
  668.  
  669. Next, if you want to make the message private or public, just
  670. type YES or NO or if you don't want to make any changes, just
  671. press [ENTER].
  672.  
  673. Last is the conference number. A Pop-Up Menu will appear
  674. asking you to highlight with the bar, the conference you
  675. want, to put the message in the same conference number, just
  676. look at the upper-right-corner for the conference number and
  677. select it with the arrow keys in the Pop-Up menu.
  678.  
  679. Now it will ask you if you want to continue, select YES or NO
  680. with the arrow keys follow by the [ENTER] key.
  681.  
  682. Now select the Tagline. Press [Esc] if no tagline.
  683.  
  684.  
  685. EDITING A REPLY :
  686.  
  687. To edit a reply go first to the conference Menu and select
  688. the REPLY Conference.
  689.  
  690. Select the message to edit by using the [+] or [-] keys.
  691.  
  692. Then press [E] for edit. Follow the same rules for replying a
  693. message.
  694.  
  695. You may also Delete a reply by pressing [Del] key.
  696.  
  697. TAGLINES:
  698.  
  699. You may steal taglines while reading messages that have the
  700. following trademarks by pressing [T] key :
  701.  
  702. ■ QWKBasic ■    Steal taglines from QWKBasic Logo
  703. ■ SLMR     ■    Steal Taglines from Silly Little Mail Reader
  704. ■ OLX      ■    Steal taglines from OLX.
  705.  
  706.  
  707.  
  708.  
  709.  
  710. QWKBasic                                              Page 12
  711. -------------------------------------------------------------
  712.  
  713. HISTORY :
  714.  
  715. -------------------------------------------------------------
  716. Version 1.00
  717.                This version wasn't release to the public.
  718.                Very simple version with not many options.
  719. -------------------------------------------------------------
  720. Version 1.02   This version with some features and some bugs
  721.                fixed in the conference menu.
  722. -------------------------------------------------------------
  723. Version 1.06 ß Major changes and additions. Some bugs fixed
  724.                in the QWK menu and Reading Menu.
  725. -------------------------------------------------------------
  726. Version 1.06   Original Version -ShareWare- This was sended
  727.            via SDS distribution files. The Documentation
  728.            was ok but some subjects missing.
  729. -------------------------------------------------------------
  730. Version 1.08  This Version. Better Documentation and the
  731.           addition of a sharware screen. Same as Ver 1.06
  732. -------------------------------------------------------------
  733.  
  734.         
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772. QWKBasic                                              Page 13
  773. -------------------------------------------------------------
  774.  
  775. THANKS TO :
  776.  
  777. Thanks to Mark Phillips for helping me fix bugs and some VERY
  778. valuable suggestions for this new reader. Without him
  779. couldn't done nothing. Thanks for the docs Mark too !!!!
  780.  
  781. Also will like to thank Mark Goodwin, Mark May, Mike Nelson,
  782. Jim Brewer too any so many people who helped me develop this
  783. type of reader.
  784.  
  785. The reader was created using QuickBASIC 4.50 and it works
  786. VERY fast by reading messages. So far I haven't been able to
  787. calculate the number of messages it can read. The maximum
  788. have been 300 messages  PER CONFERENCE so I think it Should
  789. read more than that, unlike other readers that have the
  790. barrier of # of messages that can handle, QWKBasic can read a
  791. few more.
  792.  
  793. THE AUTHOR :
  794.  
  795. Me <grin>, you can contact me for ANY questions concerning
  796. the QWKBasic Reader by sending me mail via:
  797.  
  798. FIDONET    1:139/630.23
  799.  
  800. COMPUSERVE  72470,330
  801.  
  802. U.S. MAIL    TheZoftWare PS
  803.              Attn. Manuel Godinez
  804.              P.O. Box 8761
  805.              Green Bay, WI 54302-8761.
  806.  
  807. Or the QuickBASIC echo in the Fidonet area.
  808.  
  809.  
  810.  
  811.  
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.  
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826. QWKBasic                                              Page 14
  827. -------------------------------------------------------------
  828. MISC.
  829.  
  830. Please remit any suggestions, comments or questions to the
  831. above address. Anything will be greatly appreciate it !
  832.  
  833. About the docs, I will try to improve them as the next
  834. version comes public. Thanks for your understanding !
  835.  
  836.  
  837.  
  838.  
  839.                          Sincerely,
  840.  
  841.                        Manuel Godinez
  842.  
  843.