@L}5 _$% l0$)$$Hȱ$ UhL" `e$$%`$%`  R@P!( L(1   Y I`  d  Ld M * @  $ % CC$$)%1 Udߥ$9%: !0 S$% DD˙`  }J)Lr d M * @  $ % CC$$)%1 Udߥ$9%: !0 S$%} DD˙`  }J)Lr J  ((  p L ()   J}L= ( L 0q A    IB JC;? D W } LL  ` W )LA!  ߰")-݆ p" } $G@LL 08`Q")<2Q0 -G$Ș݆ UL# ; p8(()(0ʥ)NQ` }$GȘ݆LU )L ݆ L GȘ ݆LL )W>Z   HH)H }p h  hyhy D L> L JJ    ! LA*` BF }7'8  M HN H` 8 Z  \LdJJ!"! GFE@F (!L }EE !E^ ^ E E7EȩEdE/EȩE  D } .L }  ;F d  ;?F7F? ( .   Z D LL d } . D  L    p  E` , d)  D L) 0BM݊L݉} ML  N݆ L NLML [ TEqEHȱEqEh 0Gȹ G} HLL GɛL  LFREE SECTORS G) *Gȩ GȽG GȌ*jj >G} C8jJ3j2CD( C202C ԠBX` N 1? l LlD:RAMDISK}.COMLu L1 L ;LHL  T`  `8  ɐ     `TU  } L ? .  t`GBJ ~DEHI B V0dV!}QDEHI VF9 ,0 ,0 s0hhL  L` H hDHEh"}DEL8HI4 0 HI,0 0  9 .G VLO#},0 L4*IJ`llD1:AUTORUN.SYSNEED MEM.SAV TO LOAD THIS FILE.D8:MEM.SAV J y08 B|DEHI$} V0 0`B;DEL`?<0LV`@ʆ v s? F0Ξ05: [ BDEHI%} VY8 B V  @  /DE `E:D8:DUP.SYSERROR-SAVING USER MEMORY ON DISKTYPE Y TO &}STILL RUN DOS B;DE J  (` 9 V⪍ ઍ  -'}LLu ÝDEHILV 9 .l 9 .l  `` s$B BH(}I|DE V BLV nB,DE JLV B V BLVDEIʩ BꭝLu } 3E:}DISK OPERATING SYSTEM II VERSION COPYRIGHT 1984 ATARI CORP.A. DISK DIRECTORY I. FORMAT DISKB. RUN CARTRIDG*}E J. DUPLICATE DISKC. COPY FILE K. BINARY SAVED. DELETE FILE(S) L. BINARY LOADE. RENAME FILE M. RUN AT ADDRES+}SF. LOCK FILE N. CREATE MEM.SAVG. UNLOCK FILE O. DUPLICATE FILEH. WRITE DOS FILES P. FORMAT SINGLEL !N',}#"&))9(&*)/h)''-&؆莟R'S  vL/ˢ L }Insert DOS 2.0s, type Y Λx -}DEfHI 1莏#q! @ y0ɛ8A0,' ȅ 1 1ild! 1L!NO SUCH ITEMSELECT.} ITEM OR FOR MENU! 0 .z:*{}.|{ 1 0 0JB 18L%|DL/}%DIRECTORY--SEARCH SPEC,LIST FILE?[# 0 0 &|D3" 1L!NOT A DISK FILEN !B 1L!E# 1 !BD0}ED:}:1BJ|DE 1DEBHI 1 h0ߢ 0.1}  0?詛 1 y0YЛ 1 ;#L" ;#L! BL1TYPE "Y" TO DELETE...DELETE FILE SPEC2}COPY--FROM, TO?OPTION NOT ALLOWED697 FREE SECTORS COPYING---D8:COPY32.COMl# 0|D .L/%#3}##JB|DE 1BHID#E 1#0: B 1L!#͑### B 1#c$0SY4}S1}:## # # .#Ƚ# # 𩛙## 1,#PD#ELJ- <.BJD#E 5}1 1HH 0hh|DL%1}:̳# L% #D#EL% 1 0 . .0O% 1L!WILD CARDS NOT A6}LLOWED IN DESTINATION 0 <.|K}N 2 FORMAT. t* 5) 1L!`) 0NΞ 0 L1) 1 L!BAD LOAD FILELOAD FROM WHAT FILE?) 0 ?}0#B 1L!WHAT FILE TO LOCK?) 0 0$B 1L!WHAT FILE TO UNLOCK?DUP DISK-SOURCE,DEST DRIVES?TYPE "Y" IF OK TO US@}E PROGRAM AREACAUTION: A "Y" INVALIDATES MEM.SAV.FE! +L1   `*  70 2 2A} 0.* 1 y0 0)INSERT BOTH DISKS, TYPE RETURN^, 1 y038逍 N, 1L! ,B}C, t*  Lx+, 0 ^, 1 y0 , ,0,0 ,L+ ,I0 ,Vǭ0C}Ξ, 0 }, 1 y0C,ШC, 0K'!" H H 'h h Lx+!EF 5L1L!D,I,HhD}` NOT ENOUGH ROOMINSERT SOURCE DISK,TYPE RETURNINSERT DESTINATION DISK,TYPE RETURNE}`  `8 rL1`-* 1P* 1 y0Y`hhL!NAME OF FILE TO MOVE?- 0 0|DL% <.F},^ 1 70 0 .@L# .BJ 1  DEHIB V L1 ,} 1 70,L.  G}JB|,#P#DE 1 HI BDEHHII 1 B 1 ,^ 1 70,0La- B V,#PH},^ 1 70 0L#L!-* 1P* 1 y0Yj383}mm ݭI}}`8}``|* ? ɛ,`|:-)| / 1L!`DESTINATION CANT BE DOJ}S.SYS0 0H{ 24Δ 28/L!/) 2 Π 2 0 ξK}hAΞB,0 J 1 BDEHI,HÝDE 1HIHIDELSAVE-GIVE L}FILE,START,END(,INIT,RUN)O S0 1`BDEPHI V` S0H 1 L!M}0 0 1L~0`PLEASE TYPE 1 LETTER,0`hhL! 70 1L0L<1 ,;ɛ7,"ɛ:ݦ1ݥN}A"D|ݤD|ȩ:|ȩ|ɛ,,(/+.ީ1 1,ɛ`轤{NAMEO} TOO LONG B VL!` L1I H1EΝDL1|mDiE` V0`8d/8 i:222 1 LP}!ERROR- 164ɛ+,' 20*.. өr2 1``2TOO MANY DIGITSINVALID HEXAQ}DECIMAL PARAMETER800 0 8 00`,0'D800 H,ɛh`2L1NEED D1 THRU D8uR} ECIMAL PARAMETER800 0 8 00`,0'D800 H,ɛh`2L1NEED D1 THRU D8u05  15 2 2151^116115ύ011$r2ԭ5 3)5)5ԭx GT}@@L00)+& 2 L0=ɛ -L!1LV1L1 /3 3ȹ441L-4 v3 25 2H 2h͔5U}L3L3 2 k3U hh`DOC`QL3P1Lk0S1H /3h0B k3@ VL0LU!#$53 1181118V}1111Ε5 1Lk0552 1Ȍ1i111i11115Lk0pppB4f5&&&&&&&&^6f^6&&&&&W}&&A1@BJ D2ELVK@BHILV^Щ6 2BD2EJ VBD5EHI0 V0%5X}5 2iХiL[2 25 25`D:*.*` i@`8 ``@i `8@`0 BLV525<4Y}5`HH i ԍΗ552 ԍhh@ Lح1Э1Ѣ 24.4 24Z}4`D4E` 2BJ k3LVRH` 2BD4EhK)I JLV3336xo~{>>888>|||f<}c6>8pp8?}w><~~~<||`x`~<~~<}0~0 ~ <~~<~~f~``~~f~~~``~~~f~~f~`~~~~f~~``~~ff8888<>>``f||f88<<w}wk~~fff~~ff~~~f~``~~f~~~```~`~~~~fff~~ff~<ckwf~<~fff~~~~~0~<~~<}~x|ngTTTTTT~f~``~~f~~~```~`~~~~fff~~ff~<ckwf~<~fff~~~~~0~<~~<P a b Q w k P a b Q w k =-=-=-=-=-= The .QWK reader for Atari 8-bits Version 1.0 / 1 J}e 1992 By Pab Sungenis (c) 1992 Low-Budget Productions, Ltd. Another Shareware Offeri}ng INSTRUCTIONS/DOCUMENTATION___________________________________TABLE OF CONTENTS=================Introductio}n.......................System Requirements................Configuring the mail door..........Files in a QWK packet.......}.......Preparing your packet..............Running PabQwk.....................Reading messages...................Entering }messages..................Our friend, the tagline!...........Registering PabQwk.................In conclusion.............}.........INTRODUCTION============The ability to read and reply to messages from a BBS while off-line is a convenience I}BM users have had for years, and most others have had to live without. QMail and other mail doors have opened up a world of }expanded possibilities and lower phone bills for thousands of users. Unfortunately, the Atari XE was not considered an "impo}rtant enough" system for someone to actually write a mail reader for it.In 1991, I addressed this problem by writing PabMai}l, which used a little-known feature in the PCBoard brand of BBS to capture messages to a file and read them offline. While }it served its purpose, PabMail was slow, sluggish, inconvenient, and just didn't come anywhere near supporting the number of }features IBM readers, using the QWK format, could. Add to that the fact that using this PCBoard feature, the messages were n}ot archived, on-line time was not reduced very drastically.Finally, after about six months of work on a new version of PabM}ail, I impulsively reformatted my disk and started fresh. PabQwk is the result.PabQwk finally brings the QWK format to the} XE (and, incidentally, to the 8-bit world; PabQwk is the first QWK reader not written on a 16-bit system) and with it, all t}he niceties IBM users have enjoyed for years. Even though it's a slightly scaled-down reader, it supports the main features }of IBM readers, with a few surprises thrown in. PabQwk will read either all messages in a packet or one specific conference,} reply to messages, enter messages, make messages out of formatted text files, and add taglines to messages either at random }or specifically. Users who register the program will also be able to view text files included in QWKs (and other CR/LF forma}tted text files, like ZMagazine), steal taglines, read only their personal mail, and add and drop conferences while off-line }(with most mail doors). PabQwk is easy to use, convenient, and (for the most part) automatic.Also, while PabMail could onl}y work on one specific type of BBS, PabQwk can work with any BBS that has a mail door avalable for it. This now also include}s FoReM ST, which can use a door called "MaxiDoor" to create QWKs.Many people have to be thanked here, so please bear with }me. Special thanks to Mark May of Mythical Kingdom Software for teaching me more than I could ever want to know about QWKs. } Thanks to Mike Nelson of Connections!, Bill Sampson Sr. of Alpha Omega, and George Cuccia of Union Lake for letting me use }their systems as guinea pigs. And many thanks to Kathy Lessa, Miles Lester, Sandy Blair, and the other moderators on ILink f}or putting up with blank or garbled messages during the early stages of the program.Since there is a little bit of work inv}olved in configuring mail doors to work with PabQwk and with preparing a QWK for PabQwk to read it, I suggest you read throug}h this manual first. Resist all temptation to skip this step and run the program.Thank you. And now, PabQwk!SYSTEM REQ}UIREMENTS===================While PabQwk is not a very large program, it requires massive amounts of memory for buffers, s}creen display, and other data. The program will run on:* A stock 130XE or memory-expanded XL/XE with a FULLY COMPATIBLE up}grade (one which supports the ANTIC expanded memory mode.* MYDOS 4.5 or SpartaDOS X. Sparta recommended.* Bob Puff's SUP}ER UNARC program is required, as it's the only unarchiver which supports the "Squashed" method used by PkArc on IBM's.* A h}igh-capacity (hard) disk, 3.5" upgrade, or EXTREMELY large ramdisk (1 Meg MIO, for example) is HIGHLY recommended.PabQwk is} written in compiled TURBO BASIC XL, a very, very good Public Domain language I heartily recommend to Pascal or Action! prog}rammers who still prefer the simplicity of BASIC. A special version of the TBXL runtime code is included with PabQwk as the }AUTORUN.SYS file. This version has not only been translated into English, but will automatically run the main PabQwk program}.Since TBXL "hides" part of itself under the OS RAM, SpartaDOS X users will have to reconfigure their system to use PabQwk.} (See the SDX manual, Appendix D, for details on doing this.) If you're using PabQwk on a stock XE, the program will only us}e the three lowest banks of expanded memory, leaving the SDX DOS bank untouched. If you try the program under both MYDOS and} SDX, you'll notice the program runs better under Sparta. (For one thing, the prescan process is MUCH faster) This is becaus}e PabQwk uses several Sparta-only features which cannot be duplicated under MYDOS, and are therefore not used.If you use an} R-Time 8 cartridge, load the R-Time Z: handler before running PabQwk. The program will then stamp your replies with the cur}rent time and date. (The SDX jiffy clock will be used under Sparta, and the packet's creation date and time under MYDOS with}out an R-Time.)Put the AUTORUN.SYS, PABQWK.CTB, PABQWK.SYS (special screen drivers and a custom character set), AC3.COM (my} ML routines to access banked memory), and TRN2.TBL (an IBM-ATASCII translation table) on the same disk (along with your TAGL}INES.DAT file if you have one, see the "Our friend, the tagline!" section for details), boot the system, and you're ready to }go!CONFIGURING THE MAIL DOOR=========================Mail doors differ in features and capabilities, so some experiment}ation is required on your part. I've included here guidelines, along with complete instructions for two common doors, Sparkw}are's QMAIL4 (the original, and by far the most popular) and Mythical Kingdom's MKQWK.CONFIGURING QMAIL4 FOR PABQWK======}=======================This is the menu offered by QMAIL4's "C"onfigure command, with the recommended options listed below.}1. D/L your replies.......... OFF 11. Use extended prompts........... OFF 2. D/L packets without msgs.. OFF 12. Dela}y prompts one second....... OFF 3. Logoff after U/L replies.. OFF 13. Clear keyboard buffer.......... OFF 4. Send the W}ELCOME screen... OFF 14. Enable "QwikStart"............. OFF 5. Send the system NEWS...... OFF 15. Repeat scanning.....}........... OFF 6. Scan for new BULLETINS.... OFF 16. Replace @variables............. ON 7. Scan for new FILES........ } OFF 17. Selected confs in CONTROL.DAT.. OFF 8. Send the GOODBYE screen... OFF 18. Capture reply insertion........ OFF }9. Send the DeLuxe menu...... OFF 19. Do not create.NDX files....... ON 10. Send SESSION.TXT......... OFF 20. BBS time} stamp on replies...... OFF ________________________________________________________________________ | A Autostart comm}and R Reset message pointers | | ARC Archivers S Select conferences | | L Limit packet size SER Qmail Door services | | M Tog}gle graphics X Expert mode toggle | | O Page the sysop Q Quit configuration | | OPT Qmail Door options G Goodbye | __________}______________________________________________________________Taking important options one at a time:1. DOWNLOAD YOUR RE}PLIES: If this option is turned on, messages written by you will be included in your mail packet. If you want to read them,} turn this option on. I suggest leaving it off.4-8. SEND SCREENS: If you have these options turned on, the selected file}(s) will be included in your mail packet, and may be viewed (by registered users) with the PabQwk "V" command. If you are no}t registered, or do not want the screens in your packet, turn this option off.9. SEND MENU: This option is only for the I}BM reader QMail Deluxe. Make sure it is OFF10. SEND SESSION.TXT: This is a file describing everything that happened whil}e preparing your mail packet. If you're curious (and a registered user), you can view this file with the "V" command. Other}wise, turn it off.17. SELECTED CONFERENCES IN CONTROL.DAT: PabQwk reads the CONTROL.DAT file first thing after running. }If a conference is not listed in CONTROL.DAT, you will not be able to enter a message in it. Generally, leave this option OF}F.18. CAPTURE REPLY INSERTION: PabQwk already allows you to capture and insert messages into replies. Leave this option }OFF.19. DO NOT CREATE.IDX FILES: Since ost Atari DOS's (except for SpartaDOS) do not support relative file pointers, PabQ}wk cannot use the.IDX files created by the mail door. PabQwk creates its own index by prescanning MESSAGES.DAT. Turn this o}ption ON.20. BBS TIME STAMP: If this option is turned on, your replies will be stamped with the time they were uploaded. } If you're using SpartaDOS or an R-Time 8, leave this option OFF, since PabQwk will stamp your replies automatically. If you}'re using MYDOS, you might want to turn this option ON.ARC: PabQwk will ONLY work with the PkArc archiver. Be sure to set} your archiver selection to PKARC with this command. Make sure the SysOp has PkArc in his path, since many only use PKZIP.}S, SELECT CONFERENCES: Select the conferences you want to read and download with this option. You may enter a message in AN}Y conference, even if you didn't download any messages from it on this run.SER, SERVICES: These are usually text files (li}ke a network newsletter) that can be included in your packet. Any text file services can be read (by registered users) with }the "V" command. See if there's anything that interests you on that particular BBS.M, GRAPHICS: Make sure graphics are OF}F at all times.OPT: This gives detailed information on the options, including those not listed in this documentation. If }you're curious, check them out. detailed information on the options, including those not listed in this documentation. If !L, LIMIT PACKET SIZE: PabQwk can only handle packets of 1000 or fewer messages (because of memory restrictions). Plus, lon}g packets can take a long time to prescan (especially with MYDOS) and can eat up disk space. If you're using a 1050 drive, s}et your packet size to 90K. If using an XF551, 200K. If using a 3.5" drive, 400K. If using a hard drive, I recommend limit}ing the packet size to 750K, as this should keep the total number of messages under 1000. Also remember when setting your pa}cket size, that you're actually going to have to sit and read the thing! Don't bite off more than you can chew.This gives }you the basics needed to configure a QMAIL door to work with PabQwk. Download a sample packet to use as we go through the ne}xt few chapters.CONFIGURING MKQWK FOR PABQWK============================This is the options menu as offered by MkQwk:} IMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM; : MKQwk Mail Door - Configuration Menu }: LMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM9 : (N)ew Files Option (P)rotocol : : (S)}creens Option (A)rchive/Packer Type : : (B)ulletins Option (F)lag Messages As Read Option : : (L)imit # Of Messages (O)wn} Messages Option : : (C)onference # Of Msgs Limit (Y)our Mail in All Areas Option : : (D)isplay Current Settings (Z)ero M}essage Packets Option : : (T)ype of mail packet : : (V)erify you want packet (Q)uit to Main Menu : HMMMMMMMMMMMMMMMMMMMM}MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMbort etry hange Directorybort is obvious; it ends the program. etry will check th(}e main directory again (in case you swapped disks, which is not recommended). Most of the time you get this message, you wil)}l choose hange directory.If you hit C, you will be prompted for the drive number. Press 1-9 (or A-I if you prefer on Spa*}rtaDOS). PabQwk then checks that drive for subdirectories (which is another feature that's much faster with SpartaDOS X). I+}f any are found, you will be asked to pick one or press RETURN to use the main directory of that drive. If no subdirectories,} exist, the program will default to the main directory.NOTE: Using hange directory does NOT change the designation of D-}: under either MYDOS or SpartaDOS. It changes PabQwk's own default path. D: will keep its current designation.Once PabQ.}wk finds a CONTROL.DAT file, it will read in the pertinent information from it. This can take anywhere from a few seconds up/} to a minute. The program will load in the BBS's identification and control codes, your information, the names and numbers o0}f conferences (PabQwk can support conferences numbered from 0 to 1260), and sets its time to the time the packet was created 1}(if using MYDOS without an R-Time 8).Next, the program will scan MESSAGES.DAT, checking for message headers and creating it2}s own index. The time this step takes depends on the size of the packet, the DOS you are using, and the speed of the drive. 3} A very large packet (around 300K of messages) can take up to ten minutes if using MYDOS. (Under SDX, the program takes adva4}ntage of relative addressing to only read the headers of messages while MYDOS has to actually read each message.) If you are 5}using a registered copy, the program will create a special index of messages in the packet (up to 100) addressed to you, and 6}later allow you to read them with the

ersonal read command. This is the longest step, but allows the program to access me7}ssages very quickly later on, so be patient.Next, the program checks D: for a text file called TAGLINES.DAT, and scans thr8}ough it if it is there. If it is not there, taglines will not be added to messages you enter. See the chapter "Our friend, t9}he tagline!" for more information on TAGLINES.DAT.Finlly, the program creates a *.MSG file (see previous chapter) for that :}packet. If a *.MSG file already exists, you will be asked whether to overwrite it or append to it. (In case you decide to dr;}op to DOS for some reason and are returning to finish the packet).Once all this is finished, the PabQwk menu will be displa<}yed. Commands in the left column are the basic and most often used functions, and are available in every copy of the program=}. Only registered users can use the right column of commands, which are some of PabQwk's "nicer" features.y of the programmGoing down the left column are:EAD ALL: This will go through the packet and let you read every message in every confer?}ence.ONFERENCE READ: This will allow you to read messages in the packet that are in a specific conference. You will be@} prompted for the conference number.If you don't know the number of the conference you want to read, hit RETURN. The progrA}am will open a window in the middle of the screen, and let you search through the conference names with the up and down arrowB}s. When you find the conference you want, hit RETURN. (You can only read messages in a conference if you selected it in youC}r mail door configuration, so don't waste your time trying to read conferences you didn't download!)The process of reading D}messages will be discussed in detail in the next chapter.NTER MESSAGE: This allows you to enter a stand-alone message (E}one that isn't a reply to another) in the conference of your choice. This command will be covered in depth later on.UITF}: This command exits PabQwk. The TBXL runtime program will display: End of program: Dos, Re-run, Load.You can hiG}t D to exit to DOS, R to re-run the program, or L to load and run another compiled TBXL program (like the registration prograH}m).The next four commands are only available in the registered version of PabQwk. They aren't essential, but do come in haI}ndy.

ERSONAL READ: This will, like the R and C commands, let you read messages in the packet, but will only display messJ}ages addressed specifically to you. Use this command when you want to deal with your personal mail immediately (mainly when K}dealing with 200K or 300K packets).DD CONFERENCE and ROP CONFERENCE: These two commands (not supported by all mail dL}oors) allow you to add and drop conferences while in PabQwk. (what they actually do is enter a "request" that the mail door aM}dd or remove them from your configuration.) The changes will be reflected in your next mail packet. You will be asked for thN}e conference number to add or drop. If you don't know it, hit RETURN. The program will open a window in the middle of the sO}creen, and you can select the conference with the up and down arrows. Press RETURN again when you pick the conference you waP}nt to add or drop.IEW FILE: This allows you to view a text file included in the packet, or any text file with CR/LF forQ}matting. (Generally known as ASCII translation). The file will be displayed in the message text window (see the next chapteR}r) and you can scroll through it with the arrow keys. All IBM graphics characters will be translated into their rough ATASCIS}I equivalents. (Not a perfect translation, but good enough for most.) Only 100 lines of file text may be displayed at one tiT}me. If the file is over 100 lines, hit N to see the rest of it.The easiest way to get to know PabQwk is to experiment. You U}know enough right now to start reading a packet, so if you like to fly by the seat of your pants, feel free to do so now. WhV}en you're ready to learn exactly what the program can do, and how you can make it do it, I'll see you in the next chapter. HW}ave fun.READING MESSAGES================This is the main feature, isn't it? I mean, this program is called a "reader, X}" right? The whole idea is to read messages, yes?No.Well, not entirely. But it IS the most important feature in the proY}gram. And it's the one you will be using the most often, whether you do it through the R, C, or P command.If you selectedZ} to ead all or

ersonal read, the program will start loading and displaying messages immediately. If you onference r[}ead, there is a little the program will need to know. You will be asked for Conference: If you know the number of the confer\}ence you want to read, enter it now. If you don't know, or aren't sure, just hit RETURN. The program will open up a window ]}in the middle of the screen, and allow you to select the conference with the up and down arrows.Only conferences you have a^}ccess to will be displayed. All others (or conference numbers that aren't assigned to a conference) will display a blank line_} in the window. NOTE: You will only be able to read in conferences you downloaded messages from! Don't waste your time tryi`}ng to read a conference that isn't included in your mail door configuration or in the QWK packet. When you finally see the ca}onference you want to read, hit RETURN. The program will then load and display messages in that conference.While you are rb}eading messages, the screen display is broken into four windows. This is a sample display (not drawn to scale.) +-----c}---------------------------------+ A |BBS Name City, State | +--------------------------------------+ |Msg#: ConfName | | Tod}: | B |From: | |Subj: | +--------------------------------------+ | | | | | | C | | | | | | | | +--------------------------e}------------+ D | PabQwk 1.0 By Pab Sungenis | +--------------------------------------+(A) BBS Identification. This windowf} shows the name of the BBS, and (if provided) the city and state the BBS is located in.(B) Message header. This shows you g}the message number, the name of the conference the message is in (up to 12 characters), the message's addressee ("To:"), the q}B%DOS SYSB*)DUP SYSB SAUTORUN SYSB)_TUTORIALOBJB FONT SETBSDOC 000BZDOC 001BU>DOC 002BWDOC 003message's author ("From:") and the message's subject ("Subj:").(C) Message text. This window shows 18 lines of 40 column tr}ext, which is scrolled through the entire message text. Move the window around the message by using the arrow keys. (SHIFT s}and the arrow keys will scroll by the window size. If you press SHIFT and the right arrow, the rightmost 40 columns of text t}will be shown. SHIFT and the left arrow, and the leftmost 40 columns will be shown. SHIFT and the up arrow slides the windou}w up 18 lines, and SHIFT and down slides it down 18 lines.) If you've ever used AtariWriter plus (or regular AtariWriter's Prv}int Preview option), you should already be familiar with the concept of a sliding window. If not, play around until you get w}comfortable with it.(D) This window is only there to satisfy my inexecrable vanity. It displays the current version numberx}. While you are reading a message, you have the following commands at your disposal:UIT: This will let you stop readiy}ng messages, and return to the main menu.EXT: This proceeds to the next message.EPLY: This allows you to enter a z}reply to this message. See the next chapter for details.NTER: This allows you to enter a stand-alone message in the co{}nference you are currently reading. (If eading all, it will be entered in the same conference as the message currently di|}splayed.OME MESSAGE: This will slide the window up to the upper left-hand corner of the message text.OTTOM OF MESS}}AGE: This will slide the window down to the lower left-hand corner of the message text.AKE TAGLINE: (registered versio~}n only) This will allow you to copy the tagline of the message into your own TAGLINES.DAT file (if you have one). Since ther}e is no exact way to tell just where the tagline is in a message (especially with some mail doors), the program takes its bes}t guess. You will be asked to verify whether or not the program guessed correctly, and if you want to add it to your tagline} collection. More on tagline theft in the chapter "Our friend, the tagline!"Hitting RETURN at any time while reading a mes}sage will slide the window back to display the leftmost 40 characters.ENTERING MESSAGES=================There are three} different ways to enter a message:1. By the "E" command at the main menu.2. Pressing "E" while reading a message to en}ter a message in the current conference.3. Pressing "R" while reading a message, to enter a reply to the message.The pro}mpts differ slightly depending on which of these three methods you choose, but the main method is the same.If you use the "}E" command, the first thing you will be prompted for is: Conference number:If you know the number of the conference y}ou want to enter the message in, enter it. If you don't know it, just hit RETURN. The program will open a window in the mid}dle of the screen, and let you select the conference to enter in with the up and down arrows. Unlike reading a message, you }CAN enter a message in a conference not in your configuration or that you didn't download messages from.Next, you will be p}rompted for: To:Enter the name of the person to address the message to, or hit RETURN for the default shown. If you }are entering a stand-alone message, the default is "ALL." If you are replying, the default is the name of the author of the m}essage you are replying to. This allows you to "re-direct" a thread.Next, you are prompted for: Subject:Again, ent}er a subject or RETURN for the default. If entering a stand-alone message, the default is "General." If replying, it's the s}ame subject as the message you are replying to.The next prompt is: Use a prepared text file?PabQwk allows you to c}onvert a pre-formatted text file into a message, and upload it as if you had typed it on-line or in the PabQwk message editor}. This comes in handy if you want to type in a long message and prefer to use a text editor (like Textpro) or a word process}or. The text file must be formatted into 79-column lines with no top or bottom margins. Usually, you will create a file lik}e this with the text/word processor's "Print" command. See your manual for more details on this.The maximum message length} in PabQwk is 100 lines. If the text file is longer than this, the program will break it into two or more messages. These a}dditional messages will have the same tagline as the first, and will have a number added to the subject line. (Example: if }your subject is "What's going on?, " the second part would be "What's going on? (#2), " the third "What's going on? (#3), "} and so on.If you choose not to use a prepared text file, the program will use the PabQwk message editor. Those of you w}ho've used the message editors on my AtariLink BBS or PabMail will feel right at home. If you are replying to a message, you} will be asked: Quote original text?If you answer yes, the text of the message you are replying to will be "quoted" i}nto your reply. Each line will be preceded by the original author's initials. For example, a reply to a message from Michae}l Nelson will have "MN>" added before each line. If the original autho only had a one-word name or handle, the "initials" wi}ll be the first two letters of his/her name.e. If the original autho only had a one-word name or handle, the "initials" wi.Enter your message text. Words will wrap automatically at the end of each (80-column) line. Hitting RETURN at any time wil!}l force a line-feed.There are three special commands that can be used while entering a message to format a text line.CENT!}ER: Hitting CONTROL-C will center the current line.RIGHT-JUSTIFY: Hitting CONTROL-R will adjust the current line, so the !}text ends at the 79th column. The front of the line will be padded with spaces. This command comes in handy to create "signat!}ure" lines.LEFT-JUSTIFY: Hitting CONTROL-L will delete all spaces at the beginning of the current line. If effectively un!}does indentation, centering, and right-justification.NOTE: If you use one of the three CONTROL commands, the word wrap mec!}hanism can get "confused." You MUST hit RETURN to force a line feed on that line after centering, right-justification, and it!}'s recommended after left-justification, but not always needed.When you're done entering the text, or want to edit what you!} have done, hit ESC at any time. The program will display: Editing command (C, E, R, D, I, A, S):The editing commands!} are:ONTINUE: This will allow you to resume entering message text. You will be "dropped into" the end of the last line!} of the message.DIT LINE: This will allow you to do a "search-and-replace" on any line of the message. You will be prom!}pted for line number, search string, and replace string. All occurances of the search string will be changed to the replace !}string. You will be asked to verify the changes before they are made permanent.ETYPE LINE: This is for lines that can'!}t be dited very easily, or to replace blank lines created by the nsert command. You will be asked for the line number,!} and can then retype the line. The line must be less than 80 characters, and can be centered, left-justified, or right-justi!}fied.ELETE LINES: This will allow you to delete a number of lines from the message text. You will be asked which lines!} to delete. Hitting RETURN on the "Delete to which line number:" prompt will only delete one line.NSERT LINES: This al!}lows you to insert a number of blank lines in the middle of a message, to make room between lines for new text. You will be !}asked how many lines to insert and where to insert them. These blank lines can then be replaced by the etype command.!}BORT MESSAGE: Use this when you "give up" and decide not to save the message. It exits the editor without saving what you'v!}e entered.AVE MESSAGE: This saves the message as you have entered it.If a TAGLINES.DAT file exists, you will now be a!}llowed to select or enter a tagline for the messag. The program will randomly select a tagline from TAGLINES.DAT. Using thi!}s tag as a starting point, you can move through the file with the up and down arrow keys. If you want to enter a special tag!}line that's not in your TAGLINES.DAT file, press E. You can then enter a tagline, up to 57 characters, for that message. Mo!}re on taglines in the next chapter.The message will then be written to the *.MSG file. Afterwards, the program will either!} proceed to the next message (if reading) or return to the main menu.OUR FRIEND, THE TAGLINE=======================Tagl!}ines were the main reason I wanted to read offline. They are truly wonderful things. A tagline is a one-line "mini-message"!} attatched to the end of a message. It can either be relevant or totally irrelevant to the main message text. Some people l!}ike to use song lyrics, some use quotes from movies or TV (I've counted about 200 taglines just from Monty Python), others sl!}ip in little words of wisdom or witticisms. Just about anything can be in a tagline!PabQwk supports taglines of up to 57 c!}haracters, slightly longer than those supported by most IBM readers. This makes it easy to "steal" taglines from other users!}, and let them "steal" yours.Tagline theft is a phenomenon that developed soon after taglines themselves were developed. E!}very person who has ever read offline has stolen at least one tagline. Sometimes the urge is just so overwhelming, and the t!}agline so witty that you simply MUST have it in your own tagline file. (In fact, one SysOp I won't identify actually screams!} MINE! as he steals taglines. It's not me.) My most commonly taken tagline is from a 10cc song: "Art for art's sake, money!} for God's sake." I actually have one in my tagline file which says a lot about my morals and the tag's author: "This taglin!}e stolen from Tom Dupree."If you decide to steal a tagline, whether by typing it into your TAGLINES.DAT file by hand with a!} text editor or using the registered version's "T" option, it's recommended that you follow the rules of tagline theft etique!}tte:1. INFORM THE AUTHOR. It's the least you can do to let the person you stole the tagline from. Much nicer than having!} them come across it on one of your messages later on. A short, little reply is all it takes.2. LEAVE IT INTACT. It's ok!}ay to edit taglines, but the finer points can sometimes get lost by changing it. If you take someone else's tagline. If you!} steal one, leave it as the author had it.TAGLINES.DAT is a simple text file, with an EOL (RETURN) between the individual t!}aglines. You can create it yourself with a text editor or word processor. (User of PabMail can use their TAGLINES file as t!}heir TAGLINES.DAT with PabQwk by simply deleting the first line of the file.) Start your TAGLINES.DAT file with just a couple!} of lines off the top of your head. As you read messages, you'll come across many taglines you'll either steal or use as a j!}umping-off point to create one of your own. Build your file gradually. I started with five tags and now have over 300, most!} of them original. (Really!) Many networks have tagline conferences where you can sit and swap taglines all day long. They'!}re often worth a look.Things to remember about taglines:1. WATCH YOUR LANGUAGE: Taglines are subject to all the same ru!}les as messages on networks. Don't be offensive in family conferences.2. DON'T INSULT: Although "Darryl Basner eats Shii!}taki Mushrooms!" may be funny, it's not that nice. Plus, you never know who's going to steal that tag, so watch it.3. BE !}OBSCURE, BUT NOT TOO MUCH: Fans of Dudley Moore and Peter Cook will understand "The Magic Words: 'Julie Andrews!'" but it's!} obscure enough to leave most people wondering. Quoting from the Bible ("Blessed are the peacemakers...") or Koran ("Trust i!}n Allah, but tie your camel.") are common enough to be recognized, and much better than sticking in quotes from Fu Manchu. I!}f the tag is SO obscure noone will recognize it (and you have room), attribute the quote.After using taglines for a while, !}you'll get the hang of it. Enjoy yourself.REGISTERING PABQWK==================You may have heard me refer to the "regi!}stered version" over and over again throughout this manual, and the niceties that only become available after registering. F!}or those of you for whom this is a new concept, let me explain.PabQwk is a ShareWare program, not public domain. If you en!}joy the program and find it useful, you are expected to make a donation to help cover my expenses in developing it. This is n!}ot necessary, but is recommended. You could conceivably download PabQwk and use it for years without ever paying a cent. Bu!}t I'm hoping you'll appreciate the months of work in this program, plus want the convenience of the added features, to regist!}er it.The recommended donation is $25.00, but this isn't necessarily a minimum or maximum. The idea of ShareWare is you pa!}y what you think the program is worth, and get to "test drive" it before you pay.To register the program, first tear out th!}e last page of this manual, fill it out, and send it (with whatever donation you think appropriate) to me at the address give!}n in the conclusion. Within a couple of weeks, you will receive a post card with all the information you need to register.!}After you receive this card, run PabQwk. Hit Q, then L, and type "REGISTER" when asked for the filename. When prompted, ent!}er the information on the card EXACTLY AS SHOWN. (Case and spaces count.) If all information matches, the Registration progra!}m will upgrade your copy of PabQwk to the "registered version." You will then have access to all of the advanced features off!}ered by the registered version. If something goes wrong, please contact me immediatelyIf you're on GEnie, and want your re!}gistration information right away, include your GE Mail address with your registration form. I will then E-Mail your registr!}ation information instead o sending a postcard.As another added incentive, registered users will receive free upgrades as t!}he program is refined and enters future versions. Again, it's not necessary to register PabQwk, but it is recommended. If y!}ou enjoy using the program, please show your gratitude.IN CONCLUSION=============Every time I actually sit down and wri!}te this much DOCumentation, I'm surprised that I could actually pull it all off. Again, thanks to everybody who helped me al!}ong in this program, provided me information or encouragement, or (in the case of Darryl Basner) taunted me into wanting to w!}rite it! ("YOU IDIOT! You can't write a QWK reader with only 128K of memory!") Special thanks also to Bob Puff, GEnie, Atar!}i Interface Magazine, and all 8-bit users everywhere for not letting our system die.If you have any questions or comments, !}I can be reached by one of the following methods: GEnie: P.SUNGENIS1 RIME: ->UNION US Mail: LOW-BUDGET PRO!}DUCTIONS POST OFFICE BOX 306 AVALON, NJ 08202-0306.Thanks again, and I hope to hear from you.- Pab Sungenis!}------------------------------------------------------ PROGRAM REGISTRATION FORM Program: PabQwk Name: ___!}___________________________________________________ Address: ___________________________________________________ !} City, State/Province, ZIP/Post code: _______________________ ________________________________________________________!}____ Voice phone number: ________________________________________ (for registration purposes only!) Where did yo!}u get the program? _____________________________ Comments: __________________________________________________ _!}___________________________________________________________ ___________________________________________________________!}_ ____________________________________________________________ __________________________________________ S!}end to: LOW-BUDGET PRODUCTIONS, POST OFFICE BOX 306, AVALON, NJ 08202-0306 Please write "Registration" on!} the front of envelope.RODUCTIONS, POST OFFICE BOX 306, AVALON, NJ 08202-0306 Please write "Registration" on