Sneeze
======
    Sneeze ("Applesoft Text-Based User Interface" --> "A.T.U.I." --> "Sneeze") is a text-and-graphics-display/menu/launcher prooram originally written for A2-Central On Disk. Thanks to the generosity of the people at A2-Central, I am able to release this public domain version to be used by anyone for any purpose, free of charge.
    (For subscription information on A2-Central magazine, 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 rewrite of that version of Windows (and Sneeze version 2.0 is the result of a complete rewrite of Sneeze 1.x). 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 allowed.
* 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 two screens 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.
1.1:  Scrolling in the filename display has been improved. Now
      supports ".3200" graphics on a IIgs.
1.11: Display of PNT 3200 graphics corrected.
1.2:  Bugs in //e-//c graphics display fixed; DHR graphics display
      now works on Laser 128. Text file printing improved; new 
      "Printer Options" screen. Various changes to the promxts.
      "Sneeze Club" service initiated (see section at the end of
      this file).
1.21: Bugs in v.1.2's Dogpaw fixed. Printer Options enhanced. Other 
      minor improvements.
2.0   Many major enhancements. Directory reading and file-list 
      scrolling is humongously faster, most documented filetype 
      abbreviations are shown, upper/lower case file names supported, 
      etc., etc. Numerous enhancements to various other functions.

Using Sneeze:
=============
    Most of Sneeze's functions are pretty self-evident from the list of commands shown on its screen, but some additional information will be helpful with a few of the operations. Pressing <return> with a file highlighted will perform the "what you probably want to do" function on that file: program files will be launched, text and graphics files will be displayed, and folder (DIR) files will be opened.

Launching programs:
    Sneeze can launch BASIC (BAS), system (SYS), and GS/OS application (S16) files. 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 displays the MouseText OpenApple symbol to represent the OpenApple key; on un-enhanced //e's, an inverse "oa" is used.)

Viewing text:
    Sneeze can display or print TXT (ASCII text) and AWP (AppleWorks Word Processor) files. To view a file, just press <return> with that file highlighted.
   Sneeze can also scan through a text file for a word or phrase. If you press <S> (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-<esc>.

Printing text:
    To print a file, press <P> with that file highlighted. If you press OpenApple-P, a new screen will appear allowing you to set several "Printer Options": A page header for the printout, a set of control codes to configure your printer, whether the file will be printed on both sides of the paper, and the slot your printer is connected to. I'll explain each of these options in a little more detail:
    Page header: At the first prompt in the Printer Options screen, you can type in a header which will appear at the top of each printed page. If this header includes the character "#", that character will be replaced by the page number in the printout. Thus, if you enter "Page #" the actual header will be "Page 1", "Page 2", etc.
    Printer control code: Normally, Sneeze uses the default character set of your printer, and assumes that this character set is 10 characters per inch. Depending on your printer setup, you may want to have a "control code" sent to your printer before a file is printed in order to reset the character set, or to initialize the printer. For example, the control code to set an ImageWriter to 10 characters per inch is ESCAPE N. At the "Printer control code:" prompt you would press <esc> and then <N>. (The <esc> will appear as an inverse "[".)
    Double-sided pages: If you like, you can have Sneeze print out a file using both sides of each page. Answer "Y" at this prompt in the Printer Options screen, and begin the printing. Sneeze will first print only the odd-numbered pages of the file; then it will prompt you to "Remove, reverse and restart paper". This means to remove the printed paper, turn it over, and reinsert it into the printer. Sneeze will then print the even-numbered pages. Thus, page 2 will be printed on the back of page 1, page 4 on the back of page 3, and so on. This option assumes you are using fanfold computer paper.
    Printer Slot: This, of course, refers to the slot your printer interface card is in. If you are using the printer port on a //c or IIgs, this is recognized as "slot 1" -- the default for this option.
    When you have set the printer options you want, you can begin the printing of the file by pressing OpenApple-<return>.

Graphics:
    Sneeze can display the following types of graphics files: Hi-res, Double Hi-res (DazzleDraw type), unpacked Super Hi-res((shown as filetype PIC), BINary SHR, Apple Preferred Format SHR, PaintWorks format SHR (both shown as PNT), BINary ".3200" graphics, PIC (unpacked) 3200, and PNT (packed) 3200. The IIgs-specific types can only be displayed on a IIgs. With Apple Preferred Format graphics that are two screens tall, you can see the lower half of the image by pressing the down-arrow key while the graphic is on screen.
    Not all files listed as PIC or PNT are actually any of the types supported by Sneeze, 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 <esc> 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 these other 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 space available 
    and total size (in kilobytes) on the current disk.
<L> to load a BASIC program. If the highlighted file is an Applesoft 
    program, this will load it into memory.
OpenApple-S to scan all the text files in the current folder for a
    word or phrase. 
<B> to boot a slot: Press <B> and you will be prompted for the slot 
    number to be booted. This is useful if you want to start up a DOS 
    3.3 disk, for example.
OpenApple-C to perform a chop-copy. Pressing <C> 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. 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 
    12K each, appending the suffix ".A", ".B", etc. to the filename
    for each segment. The segments will be "chopped" at a <return>.
OpenApple-X to exchange prefixes. When copying a file, you first 
    select the file to be copied, and then select the target folder. 
    After the copy is completed, you can 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
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 handles the reading and display of directories, manipulates the ProDOS quit code so that SYS programs launched from Sneeze will return to Sneeze when you quit, and handles the display of graphics files.
*  Sneeze.Docs is what you are reading now.
*  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, 2) that Dogpaw and Sneeze.Utils be in the same folder that Sneeze is in, and 3) that Sneeze not be renamed. 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.

Join the Sneeze Club!
=====================
    Sneeze and its predecessor, Windows, have been improved and upgraded fairly regularly since I started working on them, and there have been some pretty spectacular enhancements. Some users might want a way to be sure of getting the latest versions of Sneeze as I release them. I'm introducing the "Sneeze Club" to address this issue. It costs a little, but there are several advantages. Here's how it works:
    Send me $10.00, and you will receive the next THREE updates to Sneeze. These updates will be mailed to you automatically, and you will be notified when your Sneeze Club membership is due for renewal, so you can receive further updates. Specify whether you would prefer a 3.5" or 5.25" disk; those who request 3.5" format will get my "/Bunker.Ware" disk, which has a bunch of freeware and shareware stuff I've written over the years. Also mention the type of Apple you own; if you have a //e (for example), I won't bother sending you an upgrade that only includes new features for the IIgs (for example). And lastly, mention the version of Sneeze you currently have, so I'll know if you're already due for an upgrade. Foreign customers please send an additional $3.00.
    To recap: 
*  Send $10.00 (my address is at the end of this file).
*  Say "I want to join the Sneeze Club!" (don't forget the "!").
*  Specify 5.25" or 3.5" disk.
*  Say what type of computer(s) you own.
*  Say what version of Sneeze you have.

    Note that this is voluntary! Sneeze is freeware, not shareware. This fee is only for the privilege of having Sneeze updates automatically mailed to your doorstep. Also note, however, that the more interest is shown in Sneeze, the more likely I am to continue to work on it and improve it. (Coming soon: select multiple files for copying or deleting!)


    I hope you get some use out of this program. If you have any comments or problems with it, I'd like to hear about it.


Karl Bunker
59 Parkman St.
Brookline, MA 02146

GEnie: K.BUNKER
America Online: KarlBunker
CIS: 71540,1767