Sneeze ====== Sneeze ("Applesoft Text-Based User Interface" --> "A.T.U.I." --> "Sneeze") is a text-display/menu/launcher program originally written for A2-Central On Disk. Thanks to the genorosity of the people at A2-Central, I am able to release this public domain version to be used by anyone for anything, free of charge. (Speaking of A2-Central magazine, I should mention that the clock, file copy, and S16 launch routines are largely taken from the pages of this indispensable journal. For subscription information, write to: A2-Central, P.O. Box 11250, Overland Park, KS 66207) About Sneeze ============ Sneeze evolved from an earlier program called "Windows". Windows (or "Window") was originally written by Andy Anderson 1987, and was later extensively modified by me -- Karl Bunker -- with help from Dean Esmay. Sneeze is the result of a complete re-write of that version of Windows. As one might expect from a program with such a long and involved history, Sneeze is now quite a formidable little program. Here's a partial list of what it can do: * Navigate through your disks and directories. * Launch BASIC, SYS, and S16 programs. * Print TXT or AWP (AppleWorks Word Processor) files. * Display TXT or AWP files on-screen. * Display all of the more popular types of graphics files. * Copy files, with disk-swapping. * Run on any 80 column Apple II except for the ][+. New Features: ============= For those familiar with earlier versions of this program, here is a list of features added since version 1.0: 1.01: Apple Preferred Format graphics that are 400 lines tall can be scrolled to view the lower half. OpenApple-X added to revert to the "copied-from" prefix after copying a file. 1.02: Bug with viewing multiple DHR graphics on a //e or //c fixed. Bug with launching AppleWorks after viewing graphics on a //e or //c fixed. Using Sneeze: ============= Most of Sneeze's functions are pretty self-evident from the on screen list of commands, but some additional information will be helpful with a few of the operations. Launching programs: Sneeze can launch BASIC (BAS), system (SYS), and GS/OS application (S16) files. It can also launch binary (BIN) files, providing they are locked. This requirement is added as a safety feature, as not all binary files are launchable. As you may know, some very large SYS programs can't normally be launched from BASIC. Although Sneeze is a BASIC program, it doesn't have this limitation. It can launch SYS programs of any size. When a SYS program quits or "exits to ProDOS", you will be automatically returned to Sneeze. If a BASIC program exits with a "quit to BASIC", you can return to Sneeze by entering "BYE" at the "]" prompt. S16 (IIgs application programs) can also be launched from Sneeze. To do this, however, you must have booted your IIgs into GS/OS, and have then selected Sneeze from the Finder, or some other GS/OS program launcher. If you haven't done this, the message "GS/OS not available" will appear when you select an S16 file. When you exit from an S16 program, you will be returned to your GS/OS launcher, rather than Sneeze. If you launched Sneeze from another program launcher (either a GS/OS or a ProDOS 8 launcher), you can return to that launcher at any time by pressing OpenApple-Q. (Note: on most Apples, Sneeze uses the MouseText OpenApple symbol to represent that key; on un-enhanced //e's, an inverse "oa" is used.) Text: Sneeze can display or print TXT (ASCII text) and AWP (AppleWorks Word Processor) files. To print a file, press

with that file highlighted. You will be given the option of typing in a header which will appear at the top of each printed page. If this header includes the character "#", this character will be replaced by the page number in the printout. If the file you're printing is a TXT file, you will be asked if it is a "Hard or soft formatted file? (H/S):". A file is called hard formatted if there is a at the end of each line. Usually, you will want to answer "S" to this prompt. If you find that your printout has a lot of short lines of text mixed with normally lengthed lines, try printing it again, answering "H" to the prompt. Sneeze can also scan through a text file for a word or phrase. If you press (to scan the highlighted file) or OpenApple-S (to scan ALL the text files in the current folder), you will be prompted for the word or phrase to search for. Sneeze will then start "flipping through" the text file(s), and will stop if it finds the string of characters you entered. This search is not case-sensitive. If you want to abort a long scan, press OpenApple. Graphics: Sneeze can display the following types of graphics files: Hi-res, DazzleDraw-style Double Hi-res, unpacked Super Hi-res (shown as filetype PIC), BINary SHR, Apple Preferred Format SHR and PaintWorks format SHR (both shown as PNT). The IIgs-specific types can only be displayed on a IIgs. With Apple Preferred Format graphics that are 400 lines tall, you can see the lower half of the image by pressing the down-arrow key. Not all PIC files are simple SHR screen images, and not all PNT files are Apple Preferred Format or PaintWorks format SHR, so you may occasionally see an "Unsupported graphic file format" message when you try to view SHR graphics. By pressing OpenApple-G, you can do a "slide show" of all the graphics files in the current folder. Each graphic will remain on screen until a key is pressed; pressing or OpenApple-. (period) will end the slide show. Displaying any type of graphic file requires 128K, and will cause any files you have on the slot 3, drive 2 /RAM disk to be erased. Don't use /RAM if you are going to be viewing graphics. Some additional functions: Due to space limitations, not all of the functions Sneeze can perform are shown on screen. Here is a list of the unlisted functions: OpenApple up-arrow and OpenApple down-arrow will hop Sneeze's highlight bar up or down one full screen. OpenApple-/ to create a new folder (subdirectory). This will produce a prompt for a name for the new folder. to display disk information -- this will show the total blocks, blocks used, and blocks available on the current disk. to load a BASIC program. If the highlighted file is an Applesoft program, this will load it into memory. OpenApple-G to perform a slide show of all graphics files in the current folder. OpenApple-C to perform a chop-copy. Pressing will perform a normal copy of the highlighted file (this is a listed function). If you press OpenApple-C, and the highlighted file is TXT, then the file will be chopped into segments as it is copied. This function probably won't be too useful to many people, but it was included to fill a need with the A2-Central disks, so it's there if you should want it. The purpose of chop-copy is to provide a means of dividing up a large text file into segments small enough to be loaded into any word processor. A chop-copy will divide a file into segments of about 16K each, appending the suffix ".A", ".B", etc. to the filename for each segment. The segments will be "chopped" at a . OpenApple-X to exchange prefixes. When copying a file, you first select the file to be copied, and then select the target folder. You can then return to the "copied-from" prefix by pressing OpenApple-X. Sneeze's files ============== There are several Sneeze-related files in the Sneeze "package": Sneeze Dogpaw Sneeze.Utils Sneeze.Docs Dogpaw.Docs Sneeze.Icon The function of these files is as follows: * Sneeze is the big cheese, the one in charge. * Dogpaw is the utility program that Sneeze uses to display and print TXT and AWP files. * Sneeze.Utils is a utility program that manipulates the ProDOS quit code, so that SYS programs launched from Sneeze will return to Sneeze when you quit. Sneeze.Utils also handles the display of graphics files. * Sneeze.Docs is what you are reading now. * Dogpaw.Docs is a full description of Dogpaw. Dogpaw has many features and options that Sneeze doesn't take advantage of. If you're interested, read Dogpaw.Docs. * Sneeze.Icon is, of course, a IIgs icon for the Sneeze program. It's pretty cute. To copy Sneeze to another disk, the only requirements are: 1) that BASIC.System be in the root directory of the disk, and 2) that Dogpaw and Sneeze.Utils be in the same folder that Sneeze is in. In order for the "Quit to prior launcher" option to function, the disk's write-protection must be off, and the file Sneeze.Utils unlocked. I hope you get some use out of this program. If you have any problems with it, I'd like to hear about it. Karl Bunker 59 Parkman St. Brookline, MA 02146 GEnie: K.BUNKER