PAPERCLP.TXT [Documentation file for PAPERCLP.BAS. Requires BASICA. TRANSFERRING AND TRANSLATING FILES FROM PAPERCLIP (c) FOR THE COMMODORE 64 TO IBM ASCI SUITABLE FOR WORDSTAR (c) DOCUMENT MODE The problem: You have files created on the Commodore 64 with the word processing program Paperclip, by Batteries Included. You want to use these files on your IBM compatible without retyping the files byte by byte. The solution: You must use only sequential files saved with Paperclip's Control-Z command. If you used the Control-S command, which saves files in a program format, you will need to get back to the Commodore, run Paperclip, load your Control-S- saved file, and resave it with the Control-Z format. There is a big difference: Control-S saves files using Commodore screen codes, while Control-Z saves files using Commodore Pet Ascii, sometimes called Petscii, which, although it is similar to "real" Ascii, is not identical. 1) On the Commodore, save file with Control-Z command (see above) of Paperclip. 2) Send the Petscii file from the Commodore to the IBM compatible using XMODEM or other error-detecting protocol. As a guide to how long the file transfer will take, be aware that XMODEM blocks are approximately half the size of a Commodore disk sector: e.g. a Commodore sequential file of 94 blocks (approximately the largest Paperclip file you can make on the Commodore) will require 188 XMODEM blocks. At 300 baud, this can take 15-20 minutes. 3) Run the program PAPERCLP.BAS from BASICA. You will be prompted for the source file and destination file. Since the program is written in Basic, with the concomitant problems involving delimiters, the carriage returns are missing from the document. You will have to manually reinsert carriage returns where necessary in your destination file. 4) Enter WORDSTAR, using DOCUMENT MODE. At this point, you have one sentence a trillion characters long. Well, maybe less than a trillion. How can this be? Wordstar documentation states that horizontal scrolling allows you to view up to 32,000 characters, and Paperclip for the Commodore 64 cannot create documents that large. 5) Leave Hyphen Help ON (the default setting), and separate paragraphs, by adding the carriage returns needed. Don't worry about how the lines look at this point; they will still extend beyond the right side of the screen. You may find that a word needs to "break" at the right margin, and the screen asks you about hyphenating the word. DO NOT HYPHENATE AT THIS POINT. Press Contrl-B to signify "no hyphens" as you continue through the document. I insert two carriage returns between paragraphs, so there will be one blank line between lines; if you insert only one carriage return between paragraphs, there will be no blank lines between printed lines, and each paragraph will begin at the left margin. I tend to use the default Wordstar page, with it's margins set at column 1 and column 65. Continue through your document, adding carriage returns to separate out your paragraphs, until you reach the end. 6) Return to the beginning of your document. You can use Contrl-QR or just hold down the up arrow until you arrive at the beginning of the document. 7) Turn off Hyphen Help, with Contrl-OH. Be aware that this is a toggle function, which is normally ON. If you had turned it off already, leave it that way. Hyphen Help MUST be off for Global Paragraph Reformat to work. 8) Now, you need to reformat all of those lopsided paragraphs you have. Press Contrl-QQ Contrl-B to continuously reformat paragraphs starting at the first paragraph. The cursor must be in the first paragraph to do the entire document. This may take a bit of time to run, but you can watch the progress paragraph by paragraph. (If you are asked about hyphenation, then you did not toggle off Hyphen Help. Go back to the first paragraph of the document, toggle off hyphen help, and press Contrl-QQ Contrl-B.) 9) Done! At this point, you should have a restored document showing. Save the file with Contrl-KD before doing anything further. Leave any comments on Chicago Computer Society BBS 942-0706 for Anthony Parson WARRANTY AND DISCLAIMER Just like the large, extremely large, and really huge software companies in these United States, this shareware software carries absolutely NO warranty, either expressed or implied, nor any guarantee of fitness, compatibility, efficaciousness, or safety, of any kind whatsoever. NO liability of ANY kind is assumed for ANY damage this program may cause your computer and/or peripheral equipment, your other software, your emotional or physical health, or anything in the immediate vicinity of your computer, your soul and/or your karma, the room and/or building you and your computer are in, etc. By using this software, you, alone, by yourself, a trembling blob of protoplasm facing the harsh, cruel, vagaries of the world, assume and take all, absolutely all, the risk, liability, and responsibility for anything that happens when you use or try to use this software. In fact, read the fine print on the shrinkwrapped commercial packages sometime, and note that the big corporations don't even affirm that the program actually will do ANYTHING. My warranty is the same: I don't guarantee that this software even exists. I don't even guarantee that I, myself, exist, let alone that the alleged software that you have sitting on your alleged desk , on or in your alleged computer, that allegedly was written by me! "I think, therefore I am" is just one man's opinion... about himself! It is a sad fact of life, as we near the end of the decade, that you no longer get what you pay for, in the form of a guarantee or warrantee, from the "big guys", and the same goes here. [good news, however, follows below] Being shareware, you are able to try this BEFORE you register, BEFORE you buy anything, and BEFORE you send in your hard earned $10 CHECK (check preferred, but I'll accept new U.S.A. postage stamps in the 25 cent denomination -- forty of them -- and I'll accept cash -- but hide them well in your envelope, as I cannot guarantee that I will receive what you send. Notice that even first class mail is not guaranteed to be correctly delivered, by the Post Office. REGISTRATION FORM I want to register PAPERCLP.BAS in my name, since I have tried PAPERCLP.BAS, liked it, and use it. I am registering as a [ ] Full registered user ($10.00). I understand that I can call or write about problems I have using PAPERCLP.BAS, that I can make facetious remarks, but in a constructive manner, about PAPERCLP.BAS, and that I will be notified of any updates or enhancements to PAPERCLP.BAS, as befitting a fully registered user of any product. I rightfully can suggest improvements be made, to various sections of the program (although the author has the final say on this, I realize). OR [ ] Minimal user ($2.00). I understand that this small amount will help to relieve the guilt that I have, as a partially registered user of PAPERCLP.BAS, that MAYBE I will be notified of upgrades and enhancements, and that I realize that I should not make snide remarks about a product that I am not even fully registered to use. I understand that there is a strong liklihood that mail sent to the author may not be answered, unless I have included a stamped, self-addressed envelope, since I think so little of the author that I have not sent sufficient funds to amply reward him for his efforts. Enclosed please find $____________. User name:______________________________________________ User address:___________________________________________ User city,state,zip:____________________________________ Mail all contributions to: Anthony M. Parson, Jr. 1431 S. Kenilworth Av. Berwyn, Il 60402