home *** CD-ROM | disk | FTP | other *** search
/ HomeWare 14 / HOMEWARE14.bin / windows / comms / pb115.arj / PB.DOC < prev    next >
Text File  |  1994-04-27  |  20KB  |  599 lines
  1. PacketBoy v1.15
  2.  
  3. by Glen Neal
  4.  
  5. -
  6.  
  7. DOCS for PacketBoy  v1.15  by Glen Neal
  8.  
  9. A QWK compatible offline mail reader for Windows 3.1.
  10.  
  11. -
  12.  
  13. Requirements
  14.  
  15. PacketBoy <g> requires Windows 3.1. A Soundblaster is recommended.
  16.  
  17. Description
  18.  
  19. PacketBoy is a QWK compabtible offline mail reader for Windows.
  20.  
  21. There are tagline generation options for increased compatibility with non-qwk networks.
  22.  
  23. If you're not familiar with this concept, the purpose of an offline reader
  24. is to allow you to quickly exchange mail with a bbs once per day,
  25. or however often you wish, and then read/reply to the mail at your leisure.
  26.  
  27. The description of this process is rather more complicated than
  28. the actual day-to-day operation. You'll get the 'hang' of it quickly.
  29.  
  30. PacketBoy includes in version 1.xx features many readers leave out,
  31. such as a spell checker, message database manager and message
  32. router, tagline manager/stealer, phone/note list, multicolor message
  33. text even without ansi, resizable window, text import, export and
  34. printing, and word wrap with left and right margins, all in a simple to use
  35. and attractive Windows interface.
  36.  
  37. Now let me get down off my highhorse and let's see if we can't figure
  38. out why it isn't working for you...<g>
  39.  
  40. Files Included in Zip
  41.  
  42. Here is a list of files included with the zip file, and a description of what they do:
  43.  
  44. PB1xx.EXE    Version 1.xx series executable file. Main program.
  45. PB.WRI    This document in Windows Write format.
  46. PB.DOC    This document in ascii format.
  47. PB.CFG    Main configuration file.
  48. PB.PTH    Paths configuration file.
  49. PB.SPL        Spelling dictionary, ascii.
  50. PB.TAG    Tagline database, ascii.
  51. PB.PHN    Phone database, ascii.
  52. PB.DBN    Database name list, ascii.
  53. PB.SND    Sound files/paths list, ascii.
  54. PB.HLP    Help file in Windows Help format.
  55.  
  56. BWCC.DLL    Borland Windows Custom Class dll. Put in Windows/System directory.
  57.  
  58. ?.DB        Various demo database files.
  59. ?.WAV        Various system sound files.
  60.  
  61. You can delete any and all files (except the .exe !) and the program will still work!
  62. If you get into a startup error condition try deleting the pb.cfg (setup system) file.
  63. If this doesn't work, try deleting your pb.pth (setup paths) file also.
  64.  
  65. The ascii files pb.spl, pb.tag and pb.phn are ok to modify with a text editor.
  66. Any or all the .wav files may be deleted to save disk space if you wish.
  67.  
  68. Quick Startup
  69.  
  70. Just unzip the files into whatever directory you wish to use.
  71.  
  72. When PacketBoy runs it will create any directories and files it needs.
  73.  
  74. When it can't find a packet it will present a file chooser dialog so you
  75. can open the first qwk packet. You cannot send out messages until
  76. you have opened your first packet, so the program will know the
  77. conference names and numbers.
  78.  
  79. If you do not have a bbs_name.QWK file, you must call a bbs and
  80. use their mail facilities to download a qwk packet. Before you download
  81. your first packet, use thier conference/network selection facilities.
  82.  
  83. PacketBoy is fairly automatic. If you run it and it finds a qwk packet in
  84. the qwk directory, it will present the qwk manager/browser where you
  85. can manage and select a qwk packet to open.
  86.  
  87. If there are inbox messages still in the work directory, it will load the
  88. inbox without asking.
  89.  
  90. Unless...
  91.  
  92. If there are both qwk packet(s) and inbox mail waiting, it will ask if you
  93. want to delete the inbox mail. If you do, it will then present the qwk
  94. manager so you can select the next packet to open. If you don't, it will
  95. load the inbox mail instead.
  96.  
  97. If you fail to load any packet and have no inbox mail, it will default to
  98. loading the Default DB database, and show the color test pattern.
  99.  
  100. When you exit the program, if you have generated outbox mail, the
  101. program will ask if you want to export the outbox to a bbs_name.REP file.
  102. I will add a Reply Export option to the file menu soon, as well as an
  103. export manager in case you have generated reply packets to more than
  104. one bbs.
  105.  
  106. When it starts up, the program will also ask about deleting any outbox
  107. or reply files it finds when it starts up.
  108. Deleting or backing up these files automatically will be added
  109. as system options, as I learn more about user's exact needs.
  110.  
  111. Menu Items
  112.  
  113. Here are the menu items and their functions:
  114.  
  115. File
  116.  
  117. File|Open    Used to select and open a new message packet.
  118.  
  119. The packet manager has been expanded to include the qwk, rep and backup
  120. directories. You can now manage or open packets from any of these paths.
  121.  
  122. To open a new packet, select the packet and click on OK.
  123.  
  124. Use the QWK, REP and Backups buttons to view contents of these three
  125. paths. To locate a packet in another directory, use the Browse button.
  126.  
  127. While in QWK or REP paths, you can move a selected packet to the
  128. backups directory.
  129.  
  130. From any path, you can delete a selected packet with the Delete button.
  131.  
  132. This dialog comes up when PB is started, if the work directory is empty.
  133.  
  134. The view buttons are a quick way to select the Newest, Oldest or most
  135. Recent opened packet.
  136.  
  137. File|Save    Zips a new bbs_name.REP reply packet. (not online yet)
  138.  
  139. File|Import    Imports ascii text from a file, at the current cursor position.
  140.  
  141. File|Export    Writes the current edit window to an ascii text file.
  142.  
  143. File|Print    Prints the current edit window using Windows Print Manager.
  144.  
  145. File|Exit        Saves current settings and exits the program.
  146.  
  147. -
  148.  
  149. Edit|Cut        Cuts the currently selected edit text to the clipboard.
  150.  
  151. Edit|Copy    Copys the currently selected edit text to the clipboard.
  152.  
  153. Edit|Paste    Pastes the current clipboard text to the current edit position.
  154.  
  155. -
  156.  
  157. View|Welcome    Shows the current bbs welcome screen, if present.
  158.  
  159. View|Bulletins    Shows the current bbs bulletins, if present.
  160.  
  161. View|New Files    Shows the current bbs new files list, if present.
  162.  
  163. View|Goodbye    Shows the current bbs goodbye screen, if present.
  164.  
  165. -
  166.  
  167. Message
  168.  
  169. -
  170.  
  171. Conference
  172.  
  173. -
  174.  
  175. Database
  176.  
  177. -
  178.  
  179. Setup
  180.  
  181. Setup|System
  182.  
  183. This dialog lets you set many of the technical system functions
  184. and appearance of the program. These settings are saved in the
  185. file named PB.CFG.
  186.  
  187. Widescreen/Letterbox mode
  188.  
  189. 640x480 resolution Windows users can now see the full lines of the
  190. messages in color mode. To enable widescreen mode, locate the
  191. Button Bar group check boxes. Select Hide to hide all but the top
  192. two push buttons, and the color screen moves over to fill the void.
  193.  
  194. To disable widescreen mode, locate the Button Bar group check
  195. boxes again, and select Right.
  196.  
  197. The Left function will be implemented in a future version.
  198.  
  199. -
  200.  
  201. Run
  202.  
  203. Run|User Editor
  204.  
  205. PacketBoy lets you use you favorite 'external' editor to edit your messages.
  206.  
  207. To setup your editor path, select the menu item Setup|Paths. Locate the item
  208. 'Name/Path-commands to ext. editor'.
  209.  
  210. The name of the file PB uses to exchange with your editor is USEREDIT.TXT.
  211.  
  212. If the editor is an .exe program in your path, you can just use the filename, such as:
  213.  
  214. NOTEPAD useredit.txt
  215.  
  216. This tells PacketBoy to run Notepad and also sends it the command line file to edit.
  217.  
  218. If the editor is not an .exe program, you have to use the program extension:
  219.  
  220. EDIT.COM useredit.txt
  221.  
  222. If the program is not in your path, use the full path/filename:
  223.  
  224. C:\ED\BOXER\BOXER.EXE useredit.txt
  225.  
  226. You might even have to use a full path/filename for the exchange file:
  227.  
  228. C:ED\BOXER\BOXER.EXE c:\telecom\pb\useredit.txt
  229.  
  230. These last two paths are just an example. Yours would be different.
  231.  
  232. -
  233.  
  234. Help
  235.  
  236. Help|Index    Shows very brief help. To get full Windows program help,
  237.         click on the Help button.
  238.  
  239. Help|Write Help
  240.         This opens the .wri (write) version of the help file you
  241.         are now reading.
  242.  
  243. Help|About    Shows version number, and support bbs information. If you
  244.         have not registered, there is also a button to register.
  245.  
  246. Detailed Operation
  247.  
  248. Well here it is version 1.xx and the docs are just getting started.
  249. Trouble is, like most programmers, that's the only part I really hate.
  250.  
  251. I've tried to make the operation of PacketBoy (hereafter known
  252. as PB) as automatic and easy to use as possible. But for those
  253. of you who do things the exact opposite of me, perhaps these
  254. docs will explain things in a way you will understand, and if
  255. you've never used an offline reader before (gawd forbid) then
  256. you should have a quick lookaround. (Don't worry, knowing
  257. myself, they're going to be none to long. :>)
  258.  
  259. The basic idea is for one person to call one system and exchange
  260. mail on a daily basis, or however often the user wishes. It is
  261. essentially untested, so I'm sure it's not going to be setup to
  262. serve all possible needs that users may come up with. I welcome
  263. your comments (the support bbs is 405-243-3200) and version one
  264. is my idea of what a reader should be, version two will be
  265. the user's version of the reader.
  266.  
  267. The program will create four directories when you first run it.
  268.  
  269. The QWK directory is where your telecom program should download
  270. the .qwk packets to. Use your favorite terminal communications program.
  271.  
  272. The REP directory is where the program will place your OUTBOX
  273. messages that you have created. When you exit the program, it
  274. asks if you want your outbox messages to be exported (zipped).
  275.  
  276. The WORK directory is where the program will unzip your .qwk
  277. packet into. This directory contains critical files, and should
  278. only be erased when you're about to unzip another .qwk packet.
  279. This directory also contains your inbox and outbox messages.
  280.  
  281. The BACKUPS directory is where PacketBoy will place your
  282. qwk and rep packets when requested to do so. This feature
  283. is almost finished.
  284.  
  285. I'm also thinking of adding a DATABASE directory for keeping
  286. all the database files in.
  287.  
  288. Future versions will manage these files more fully, but at
  289. present it will only delete them if you say yes to the questions.
  290. If you want backups you must manage those yourself for now. :<
  291.  
  292. How to Reply to a message:
  293.  
  294. The normal routine to reply to a message is to use the mouse to
  295. mark the area you want to quote. Then with the text still quoted
  296. click on REPLY. It will generate the reply screen which you may
  297. edit and add your reply to. Before editing and adding your replay,
  298. you may want to run the external editor function at this point.
  299. When finished, click on SEND and the message is added to the outbox.
  300.  
  301. For a new message, click and NEW and the rest is the same.
  302.  
  303. [To be expaned and continued...]
  304.  
  305. History (in reverse order)
  306.  
  307. v2.00    7-4-94    Version 2.0 on July 4th!
  308. -----------------------
  309. v1.21    6-?-94    Just this one last little feature...
  310. v1.20    6-?-94    The sky's the limit. <g>
  311. v1.19    5-?-94    RIP graphics detection/showing.
  312. v1.18    5-?-94    Database Routing/Sorting/Packing.
  313. v1.17    5-?-94    Ansi color detection/showing.
  314. -----------------------
  315. v1.15    4-28-94    Widescreen mode for 640x480 users.
  316. v1.14    4-13-94    Sounds dialog. Multi-bbs aware. Thanks Judie!
  317. v1.13    3-30-94    Color mode scroll bar, Slideshow & MUCH more!
  318. v1.12    3-16-94  Improvements too numerous to mention.
  319. v1.11    3-4-94    Slim version without so many .wav files.
  320. v1.10    3-2-94    Word wrap online! Much faster spell check! Yeah!
  321. v1.09    2-25-94    External editor online. More bug fixes. Thanks Jerry!
  322. v1.08    2-20-94    Several DB bugs bite the dust. <g> QWK manager.
  323. v1.07    2-16-94    Many improvements and bug fixes.
  324. v1.06    2-11-94    Bug fix for loading packet. Thanks Bruce!
  325. v1.05    2-10-94    Show bulletins added.
  326. v1.04    2-6-94    Bug fix for loading packet. Thanks Carl!
  327. v1.03    2-5-94    PCBoard color detection/showing, bug fixes.
  328. v1.02    2-3-94    Bug fixes and minor spiffs.
  329. v1.01    2-2-94    Bug fixes and minor spiffs.
  330. v1.00    2-1-94    Release of PacketBoy v1.00. Cool!
  331.  
  332. Get the newest version 1.xx series while it's only $25.00!
  333.  
  334. Version 2.xx series will start *July 4* of this year, and will
  335. cost $50.00.
  336.  
  337. Register now and the upgrade after July 4 will only be $10.00 - save $15.00.
  338.  
  339. Your registration number is good for all version 1.xx series.
  340.  
  341. You'll get a new registration number for v2.xx but your reader serial number
  342. will stay the same.
  343.  
  344. Word Wrap Online
  345.  
  346. Word wrap with user definable left and right magins is working as of version 1.10!
  347.  
  348. This is a much-wanted feature, both by myself and the users. Since you cannot judge
  349. in the windows edit box how many characters you've typed, this is an especially
  350. welcome feature.
  351.  
  352. The default for the program is a left margin of 8 and right margin of 70.
  353.  
  354. To change these numbers from a minimum of 0 up to a maximum of 77,
  355. use the menu item Setup|System.
  356.  
  357. Yeah!
  358.  
  359. Right Mouse Button
  360.  
  361. PacketBoy uses the right mouse button.
  362.  
  363. In the blue header area:
  364.  
  365. Click left button in blue header area to switch to edit box mode.
  366.  
  367. Click right button in blue header area ot switch to color graphics mode.
  368.  
  369. By doing this you can switch rapidly between modes.
  370.  
  371. In the color text area:
  372.  
  373. Click left button in color text area to select lines to quote one by one.
  374.  
  375. Click right button in color text area to select a whole paragraph.
  376.  
  377. You can also mark text in the edit box by clicking and dragging.
  378.  
  379. Keyboard Support
  380.  
  381. If you click on the message list box so it has the focus (turns inverse),
  382. the following keyboard keys can be used to paruse messages:
  383.  
  384. Arrow keys for going foward or back one message at a time.
  385.  
  386. Page Up and Page Down for going a list box foward or back.
  387.  
  388. Control-Home and Control-End for going to the first and last message.
  389.  
  390. If you click on the Next or Last buttons, then spacebar will press
  391. that key for you, until it looses the focus.
  392.  
  393. Hotkeys:
  394.  
  395. Numeric Keypad:
  396.  
  397. 1 (End)        jump to End message.
  398.  
  399. 2
  400.  
  401. 3 (PgDn)    goes foward 20 messages.
  402.  
  403. 4 (Left)        Last message.
  404.  
  405. 5
  406.  
  407. 6 (Right)    Next message.
  408.  
  409. 7 (Home)    jump to First message.
  410.  
  411. 8
  412.  
  413. 9 (PgUp)    goes back 20 messages.
  414.  
  415. 0
  416.  
  417. About the DB files
  418.  
  419. The database files aren't .dbf files, there simply message files in exactly the 
  420. same format as used by the qwk system. I thought by having only one format
  421. of files, the program could use the same methods for manipulating both, and
  422. this has worked out very well, to good effect!
  423.  
  424. I'm using the first 128 byte 'master header' to store the english name of your
  425. database, since this first header isn't really used by the qwk system except
  426. in reply packets.
  427.  
  428. I'm also going to start using the 'password' field to store the name of the bbs
  429. the message came from, which is a rather clever way to do it so the reader
  430. won't have to have extra files to keep track of this information.
  431.  
  432. If you ever had need to do so, you could even 'trick' another reader into reading
  433. my .db files by renaming one 'messages.dat' and putting it your reader's work
  434. directory, although I don't know why you would ever need to do this. <g>
  435.  
  436. Secret Features
  437.  
  438. You can get all three bottem list boxes up at once by:
  439.  
  440. Click on menu items Message|List, then Conference|List, then Database|List.
  441.  
  442. Don't click on anything else in between. Neat.
  443.  
  444. -
  445.  
  446. There is a secret function in the Setup|Taglines dialog. Have you found it? :>
  447.  
  448. Hint: It's the only dialog where the PacketBoy icon does something.
  449.  
  450. THIS IS SHAREWARE!
  451.  
  452. You may try out this program for a reasonable time. If you continue to use
  453. it, please register it.
  454.  
  455. This shareware version is NOT crippled in any way! It simply reminds you
  456. to register, once for every 5 times you use it.
  457.  
  458. I have my doubts about this shareware business. We will see about honor.
  459.  
  460. WHY SHOULD I REGISTER?
  461.  
  462. Aside from freedom of guilt and a good nights sleep, here's what you get:
  463.  
  464. +  A disk containing the latest, NO NAG, NO DATE LIMIT version.
  465.  
  466. +  A megabyte of wave files on the disk to use.
  467.  
  468. +  Full access to the support bbs PC-Oklahoma for three months.
  469.  
  470. +  This documentation in printed form. ($10.00 more by mail)
  471.  
  472. +  You registration number will work with all version 1.xx series.
  473.  
  474. HOW DO I PAY TO REGISTER?
  475.  
  476. +  Online, using Visa, Mastercard or Discover by calling the support bbs
  477.    at 405-243-3200. After you are online, type CHARGE at the main prompt,
  478.    then select item 2, then select item 1. You'll see how, it's easy.
  479.  
  480.    Download registered version online for $25.00.
  481.  
  482. +  By voice, using Visa, Mastercard or Discover by calling me at 405-243-0574.
  483.  
  484. +  By mail, send check, money order, or credit card number.
  485.  
  486.    Glen Neal
  487.    220 Ridgecrest #45
  488.    Elk City, OK  73644
  489.  
  490.    By mail it's $35.00, which includes this document printed.
  491.  
  492.    Sorry, I'm just starting. I don't have fancy books printed yet. <g>
  493.  
  494. HOW DO I REGISTER THE PROGRAM?
  495.  
  496. If you stay online on the bbs long enough (page me) for me to verify your
  497. credit card, I can give you your registration number right then.
  498.  
  499. Otherwise, call back and I'll have a personal message waiting in the
  500. main conference which has you registration number. If you prefer, you
  501. may call my voice number to register and get your registration number.
  502.  
  503. If you've ordered by mail, I'll send it with your disk, etc.
  504.  
  505. In the program, select the menu item Help|About, then select the Register
  506. button. Type in you name, and registration number. You must type in your
  507. registration number EXACTLY as I gave it to you,
  508. with no extra or missing characters.
  509.  
  510. After you register, all register buttons will vanish, and the program will no
  511. longer 'nag' each 5 times it is run. It will also not expire in the future.
  512.  
  513. However, keep looking for new versions. I can put out a new version in
  514. minutes, rather faster than those large sluggish companies. <g>
  515.  
  516. Keep your registration number. If you delete your pb.cfg file, or if you get
  517. a new version and the program deletes it for you, you'll have to re-register
  518. using the register button and your registration number again!
  519.  
  520. HOW DO I GET SUPPORT?
  521.  
  522. +  Online, call the support bbs PC-Oklahoma at 405-243-3200.
  523.     Page the sysop, or better yet, leave the sysop a comment or message.
  524.  
  525.     Do NOT post your registration number on the bbs!
  526.  
  527. +  By voice, call me at 405-243-0574. 
  528.  
  529. HOW DO I GET THE NEWEST VERSION?
  530.  
  531. +  Call the support bbs PC-Oklahoma at 405-243-3200.
  532.     New versions are posted regularly.
  533.  
  534. +  To get newest version download PB1??.ZIP, the bbs can locate this name.
  535.     (No need to search)
  536.  
  537. +  I have over a dozen Windows 3.1 products for you to try. All are available
  538.     for downloading on your fist call.
  539.  
  540. TROUBLESHOOTING
  541.  
  542. +  I am contantly adding items and changing the configuration file, PB.CFG.
  543.    When you get a new version, it's a good idea to first delete your config file.
  544.    The paths are in a seperate file (PB.PTH) so at least you don't loose those. <g>
  545.    If you delete your config file, you'll be back in shareware mode, so keep
  546.    the registration number I give you, or put the number in a file for the future. <g>
  547.  
  548. +  If you get the message saying BWCC.DLL was not found, or error = -1,
  549.    call the support bbs at 405-243-3200 and download BWCCDLL.ZIP.
  550.  
  551.    Unzip it into your Windows System folder. No need to restart windows.
  552.  
  553.    Other windows programs will need this DLL also. It is similar to the DLL
  554.    used by Visual Basic, VBRUNx00.DLL.
  555.  
  556. +  If it says a sound driver is not installed, go to the Windows control
  557.    panel, and run the Sounds icon. Select ADD, and pick a Soundblaster
  558.    driver that is for your card version.
  559.  
  560.    I hope to add support for other sound cards and the pc speaker soon.
  561.  
  562. Known Bugs
  563.  
  564. 1.  640x480 users cannot see all the text in color mode
  565.  
  566. -and-
  567.  
  568. 2.  There is no scroll bar in color mode.
  569.  
  570. 3.  Ansi mode not working properly yet.
  571.  
  572. 4.  Text in combo boxes not in neat columns.
  573.  
  574. 5.  Dictionary is still too small.
  575.  
  576. 6.  RIP mode not online at all yet.
  577.  
  578. 7.  Not marking messages as read.
  579.  
  580. 8.  Several other dialogs not online yet.
  581.  
  582. I'm aware of these problems and they will all be fixed soon in future versions.
  583. Right now I'm putting up a new version about every 2 weeks, often at noon
  584. on Wednesday. The support bbs number is 405-243-3200. You can always
  585. call and download the newest version (on the first call).
  586.  
  587. Attitude
  588.  
  589. I'm always interested in features people want. I only know how I use the reader,
  590. I have no idea how other users on other systems might want to use it.
  591. Please fell free to call me or the bbs and suggest new features.
  592.  
  593. Please call the support bbs if you have problems or discover a bug(!).
  594.  
  595. Join the PacketBoy conference by typing PB and hitting return.
  596.  
  597. End of Documentation
  598.  
  599.