The Silicon Frog, Inc. John Hancock The Ultimate Tagline Manager Version 3.0 (c) 1988-92 The Silicon Frog, Inc. All Rights Reserved Table of Contents Introduction...............................................1 Preliminaries..............................................2 Unregistered Users.........................................2 Registered JH Users........................................4 Starting JH3...............................................5 Insufficient Memory....................................5 The JH3 TagFile Screen.....................................6 Screen Elements and Navigation.........................6 Issuing commands.......................................6 Changing Screen Cosmetics..............................7 Navigating the TagFile Window..........................8 - AlphaLoc.........................8 Mouse Navigation...................................8 The ScrollTrombone.....................................9 - Toggling Sound F/X ON and OFF..............9 Tagfile Screen Commands...................................10 - Load New Tagfile................................10 Tagfile Hot Keys......................................10 TagFile Truncation....................................11 - Insert new tag..................................11 - Delete tag......................................12 - Edit Tag........................................12 - tagSearch.......................................13 - Last tag........................................14 and - Carmine and Guido.......................14 - screensiZe......................................15 - Terminate JH3...................................15 - The Great Wurlitzer.............................16 - Toggling Wurlitzer ON and OFF.........16 That's it for the Main Screen.........................17 Beauty and the Program....................................17 The Tagline Beautification Screen.........................17 Beautify Commands.........................................18 Un-Beautifying a tagline..............................18 or doubleclick - Send tagline to reader.......18 - Edit Tagline....................................19 - Frame Tagline...................................19 & - ASCIIFramer...................20 - Invert tagline..................................21 - Jumble tagline..................................21 - Turn tagline to lower case......................21 - TURN TAGLINE TO UPPERCASE.......................22 - rANdOmiZe TAgLinE cASE..........................22 , , - Tagline alignment.....................22 - E x p a n d T a g l i n e......................23 - Removealltaglinespacing.........................23 - rmv tgln vwls...................................23 - Translate Tagline to Pseudo-SiliGweek...........23 - Translate Tagline to Pseudo-Silirp.........24 - Nuts............................................25 - Zing'em.........................................26 - sHuffle tagline.................................27 - Translate tagline...............................27 !(&^!*# - Blaspheme............................28

- Potluck.........................................29 - Return to Main Screen...........................29 Writing JH3 Moosik........................................31 Tune file format......................................31 Set octave: >, <, and On..........................32 Play note: A-G or Nn..............................32 Duration: Ln, MN, ML, MS..........................32 Tempo: Pn, Tn.....................................32 Creating and editing tunes with BASIC.................33 Using QBASIC to create and edit tunes.............33 Framing your Taglines.....................................35 Frame File Format.....................................35 Framing patterns......................................36 Mirrored patterns.................................36 Non-Mirrored patterns.............................37 Left- and Right-side patterns.....................37 The FRAMECK program...................................37 The FRMMAKER Program..................................38 John Hancock 3.0 Page 1 Introduction Welcome to John Hancock release 3.0. This program has taken a team of many determined and dedicated men and one Sysie over 18 months to design, refine, test, and release. JH3 is unquestionably the best tagline manager there is; no programmer in his/her right mind would spend this kind of time to write this kind of program. Of course, there is a lot more to JH3 than JH3.EXE. There's INSTALL, which makes sure you got your stuff together, JH3CFG, a.k.a. JH3's Cockpit and Engineering Department, which you should have run at least once by now, and of course JH3MAINT, which you most assuredly will run many times - and even a few other programs mentioned elsewhere in this document. But *this* is John Hancock. This is the one you have fun with (my atties say "don't end sentences with a preposition" but this is one I like and shall not mess with). This is the program that will propel you into the Tagline Hall of Fame, or Hall of Shame, whichever you would rather have. If you followed the directions in INSTALL.DOC and JH3CFG.DOC, and if you didn't choke on your cigar or lollipop while viewing README.3RD, you are ready to try this wonderful piece of state-of-the-art software. Claims to the contrary by some thirty-something filthy rich bachelor from Redmond, WA, JH3 is clearly superior to Windows in many respects: - JH3 can operate very decently on just about any computer; it does not have to have a 386/33 with 8 megs of RAM. It does run real fast on my 32meg 486/33, though. - JH3 requires about 500K of hard disk space. Windows requires about 12 megabytes. - In all cases, JH3 can display text about 287 times faster than Windows. Most old men with old Underwoods can make a similar statement. - JH3 can play music without 2 megabytes' worth of Multimedia Extensions or a $500 MIDI board and $800 CDROM drive. - JH3 can display 262,144 VGA colors without a 300K video driver. John Hancock 3.0 Page 2 - JH3 only costs seventeen dollars and fifty cents. - Windows can't send taglines to your mail reader. - JH3 Standard Mode is always Enhanced, and it's always a *Real* program. Windows, on the other hand, has to be *told* what mode to use. - JH3 does not produce Unrecoverable Application Errors. - JH3 scales fonts automatically if you have an EGA or VGA and want to take advantage of it; all of its displays are very clearly readable. - JH3 does not have a bunch of silly little icons. Instead, JH3 has a lot of silly little boxes. No need for further convincing arguments. You be the judge. Preliminaries At this point, you should have completed all of JH3's installation steps: 1. You have a JH3 directory, 2. You have a JH3 environment variable, 3. You have tagfiles in the JH3 directory or in some other directory on your hard disk, and that directory was defined to JH3 (either via INSTALL or JH3CFG), and, 4. You have properly defined JH3 to your mail reader. Unregistered Users JH3 has no functional limitations; all of its features will operate normally for as long as you use the program. JH3, however, keeps track of how long and how much you have used it. For the first 30 days following installation, the program will operate as if you were a registered user. After 30 days, but only if you have used the program 250 times or more, JH3 will start to remind you of how long and how much you have used it (when you exit the program, right before you return to your mail reader). The reminder will not be displayed each time you use JH3, but as you continue John Hancock 3.0 Page 3 to use the program, both the frequency and duration of the reminder message will increase. At first, the reminder will be short - less than three seconds - and it will appear every 10 uses. Eventually (after approximately 500 uses), the message will appear each time you use JH3 and will stay on your screen approximately 15 seconds. If you have used JH3 to the point that it starts displaying the reminder message, you probably enjoy the program and you should register it. And if you use it *a lot*, nothing will happen for the first 30 days, a heck of a deal. Time and use information are stored in a small file named JH3D&U.DAT which is stored in the same directory as your JH30.CFG file. I advise against tampering with that file (e.g., saving and restoring earlier copies of it). I also advise against changing the system date to fool the program. If any tampering is detected, JH3 will set its use count to 1,000 and length of service to 60 days. From then on, JH3 will display a 15-second use and registration reminder each time you use it. Few authors document their programs' unregistered mode of operation as thoroughly as I have; I urge you not to try to defeat it. If you do, and the attempt fails, you will have to completely re-install JH3 from its original distribution files. The INSTALL program will not allow partial re-installation for unregistered users (that is, people who do not have a JH3.KEY file). To allow you to test and evaluate JH3 as thoroughly as possible, the program's use count will NOT be increased if you do not send a tagline to your reader. For example, press or click the outside mouse button to exit the program instead of pressing or doubleclicking on the desired tagline. The easiest way to "test" JH3 is to start it from the DOS prompt; you may run it as many times as you want without penalties of any kind as long as you exit the program and do not select a tagline to be sent to the reader. NOTE: DO NOT select a tagline if your mail reader is not active. If you do, JH3 will create JH?.REP files in the default directory, and these files will not be deleted (the reader's responsibility). To delete these files manually, type DEL JH?.REP at the DOS prompt. John Hancock 3.0 Page 4 Note that you may run JH3MAINT and JH3CFG as often as you like; these programs do not increase the JH3 use count. The intent of this reminder system, fondly referred to as "NagWare" in shareware circles, is to remind you that you have conducted a fair evaluation of the program, at which point you should register it or stop using it. Hopefully, most JH3 users will decide to register the program long before the reminder messages appear, or long before they get bothersome. Remember to "dry test" JH3 as much as possible at first to familiarize yourself with the program's features; you may use it as much as you like without nagging as long as you do not send a tagline to your mail reader. In addition to a personalized JH3.KEY file which identifies you as a registered user, registering JH3 will get you a number of very valuable bonus programs. This is a positive incentive to register the program (see BONUS.TXT or the BONUS show for additional information). Registered JH Users If you are a registered JH or JH2 user, you should have received a JH3 Announcement and Bonus offer in the mail. In the event you did not receive it, or if you decided not to take advantage of the offer, you do not have the JH3 Bonus Programs mentioned in this document. The term "Registered JH3 User" used in this document refers to those who registered JH3, or to registered JH or JH2 users who sent for their JH3 bonus diskette and have access to the JH3 bonus programs. By the same token, the sentence "when you register JH3, you receive xxx bonus" does not apply to registered JH and JH2 users. If you are already registered, this sentence should read "if you are a registered user and sent for your JH3 bonus disk". In any event, registered JH2 users should run the JH3KEY program, which will immediately register their copy of JH3 (you must have your original JH2 bonus disk in order to run JH#KEY). See INSTALL.DOC for additional details on installing JH3 and registering it with JH3KEY. If you are a registered user of the original JH program but you did not send for your JH2 bonus disk, you cannot run the JH3KEY program - to register your copy of JH3 you must send for the JH3 bonus disk, which contains your personalized JH3.KEY file. See REGISTER.DOC for details. John Hancock 3.0 Page 5 Starting JH3 To start JH3, use the method prescribed by your reader program. In most cases, you may press a "hot key" to activate JH3. In the case of DeLuxe, you may also invoke JH3 by selecting the "DOS:JH3" user-defined tagline (see INSTALL.DOC for reader-specific procedures). If you are *testing* JH3, there is no need for a mail reader; start the program directly from the DOS prompt by typing JH3 and pressing : C:\JH3\JH3 When JH3 starts, it automatically loads the last tagfile you used. This feature may be overridden by turning ON the JH.TAG AutoLoad Switch and/or the Stash Detect Switch in JH3CFG's PreFlite Checklist. In a nutshell (most JH3 users are certified nuts), JH.TAG Autoload forces JH3 to reload the JH.TAG file whenever it is started. The Stash Detect switch tells JH3 to monitor the STOLEN.TAG file and load it whenever new taglines have been added to it. Stash Detect overrides all other automatic file loading options. See JH3CFG.DOC for additional information on these features. If you have a STOLEN.TAG (all registered JH2 and JH3 users are certified tagline thieves) file in your tagfile directory and Stash Detect is ON, that file will be loaded the first time JH3 is started. From then on, the file will be loaded only if new taglines were added to it since the last time it was used. Insufficient Memory JH3 will not operate if it finds less than 24K of free DOS memory after the program has loaded. In this case, JH3 will display the following message: Insufficient memory to run JH3 Some computers have less memory than others, and some mail readers use more memory than others. Also, various system parameters and resident programs affect the amount of memory available to run programs. Many mail reader programs have a "memory swapping" feature (e.g., DeLuxe's SuperShell) which allows you to execute large external programs such as editors or word processors. If JH3 displays its "Insufficient memory" message, you should activate your John Hancock 3.0 Page 6 reader's memory conservation feature. If this does not solve the problem, you may have to take more radical action, such as reducing the number of resident programs in your system or the number of DOS buffers. If you have a 286/386 or 486 system with 1 megabyte of memory or more, consider using a third-party memory manager such as QEMM/QRAM (tm) or 386^Max (tm). These programs will free up large amounts of DOS memory by moving resident programs and device drivers to unused system memory between 640K and 1,024K. Another solution to "RamCram" is to convert to MSDOS release 5.0 or DRDOS release 6.0, which have similar memory-saving features. JH3 may not be able to load very large tagfiles if there is not enough DOS memory available. To support all functions, and load the maximum size tagfile, JH3 needs approximately 160K of free DOS memory. JH3 will truncate large tagfiles and issue a warning message if sufficient DOS memory is not available. See "Loading Tagfiles" later in this document for additional details. The JH3 TagFile Screen Screen Elements and Navigation JH3's title line is at the top of the screen. The title line displays the JH3 name and *your* name, if you are a registered user, or "Unregistered User" if you're not. JH3's Sound F/X and Wurlitzer switches, represented by a single and double musical notes, are at the left of the title line (more on these critters later). If you have a mouse, its cursor is located at the right edge of the title line. The main screen area takes up the rest of the display. JH3's command buttons are on the left side, and the tagfile window is on the right. When JH3 starts, the window cursor is on the top tagline - the tagline is highlighted. Issuing commands Most of JH3's commands are shown on the command buttons; some are not (we didn't have enough room for all them buttons, folks). To issue a command, press the highlighted command letter shown on the button, or click the mouse on the desired button. JH3 will press the button for you to confirm your request. For consistency's sake, command John Hancock 3.0 Page 7 letters are the only upper-case characters in the command button labels. On the main JH3 screen, most button labels start with their respective command letter (which is not the case in JH3's Beautify Screen). Changing Screen Cosmetics JH3 can best be described as a Silicon Chameleon. If you ran the JH3CFG program, you're familiar with the Crayola Box (tm), which allows you almost total freedom in designing up to 16 ColorSets which control the Look 'n' Feel of *your* JH3 screen. ColorSets are numbered 1 thru 0 and A thru F, which correspond to JH3CFG's ColorSet numbers 1 thru 10 and 11 thru 16, respectively. To switch ColorSet, press and hold , then press the desired colorset's number or letter. For example, to activate ColorSet 4, press <4>. For ColorSet 12, press . Programmers will undoubtedly complain about this confusing numbering scheme, which does not abide by accepted hexadecimal numbering rules. My only defense is that I did not design the darn PC keyboard; I can't help it if they put the &%#$!# zero at the end, folks. You may also cycle thru ColorSets forward or backward by pressing the <+> and <-> keys. When you select a new colorset, the JH3 screen fades to black (on EGA/VGA) and is redisplayed using the new colors, window style, and mouse cursor. Whichever ColorSet you select becomes the new default; it will be used each time JH3 is started (until you select a new one). When you first use JH3, ColorSet 0 is the default. John Hancock 3.0 Page 8 Navigating the TagFile Window You can move around the tagfile window very quickly by using the cursor keys or the mouse: Keypress Resulting Action ------------------------ --------------------------------- Move up one Move down one Move up one screen Move down one screen or Top line of current window or Bottom line of current window First line of tagfile Last line of tagfile Send tagline to reader quit JH3 - AlphaLoc If JH3CFG's PreFlite CheckList's AlphaLoc switch is turned ON, pressing and a letter will position the highlight to the first tagline starting with that letter. Remember that *NOT* pressing shift will either 1) do nothing or 2) issue the command which corresponds to the key you pressed. And if you press and the AlphaLoc switch is OFF, who knows what may happen. Be careful. You may search for *specific* taglines with the tagSearch command, described later in this document. Mouse Navigation You may navigate the tagfile window with your mouse almost as easily as with the cursor keys: Mouse Action Resulting Window Action --------------------------- ----------------------------- Click on Tagline move cursor to tagline Click & Drag Scrollcursor scroll file (ScrollTrombone) Click on top scroll arrow move up one tagline Click on bottom arrow move down one tagline DoubleClick on tagline send tagline to reader Click outside button quit JH3 John Hancock 3.0 Page 9 The ScrollTrombone If Sound F/X are ON, clicking on the scrollbar cursor (the little guy that travels up and down the scrollbar at the right edge of the tagfile window) activates the ScrollTrombone, one of JH3's sound-producing devices. The ScrollTrombone can play 58 real notes. Which note is played depends on the relative position of the mouse cursor within the scrollbar. The number of notes you can play is determined by the depth of your tagfile window; to access the higher octaves you must have an EGA or VGA display and switch to one of the larger screen sizes. CGA and MDA users are limited to 20 notes, sorry. - Toggling Sound F/X ON and OFF Now, there are times when you definitely DON'T want JH3 to produce sounds. For example: - That would wake up Mom and/or Dad (No Allowance Time!!!) - That would wake up the wife (DogHouse Time!!!) - That would wake up Fideaux (the large, mean Canadian Sled Dawg, Rabies Shot Time!!!) - That would wake up your boss or co-workers (No Raise / Pink Slip Time!!!) You can disable JH3's Sound F/X temporarily by pressing , or permanently by pressing . With a mouse, click on the single note at the left of the title bar to disable Sound F/X temporarily, or Click to disable the feature by default. When you do, JH3 displays a message box to acknowledge your command. "Temporary" means "during the current JH3 session"; Sound F/X will be active the next time you run the program. Permanently disabling Sound F/X is the same as turning the JH3CFG Sound F/X switch OFF. If you want to have Sound F/X most of the time, toggle the Switch ON in JH3CFG, or use the or Click method described above. You can then use the or mouse method to disable Sound F/X during the current JH3 session. Conversely, if you do NOT want Sound F/X, toggle the Switch OFF in JH3CFG, or use the or Click method described above. You can then use the or mouse method to re-enable Sound F/X during the current JH3 session. John Hancock 3.0 Page 10 Tagfile Screen Commands - Load New Tagfile Press or click on the 'new Tagfile' button to switch to JH3's Tagfile Selection Screen. Note that this command will refuse to operate if you have one and only one tagfile (JH.TAG). The Tagfile Selection Screen has no buttons, since the only two things you can do are 1) select a new tagfile and 2) NOT select a new tagfile. The tagfile selection window responds to the same keyboard and mouse navigation commands as the tagline window. For example, you may cursor to a tagfile title and or doubleclick to load the file, or press or Click the *outside* mouse button to return to JH3's main screen without loading a new file (but the current file will remain loaded, natch). The tagfile selection window displays tagfile titles (rather than cryptic tagfile names, for you JH2 users). By definition, the first line in a tagfile is its title. Each title line has its "hot key" character preceded by a percent (%) sign. If a tagfile has no valid title, JH3 will call it "Untitled Tagfile #n", where n starts with 1 and increases with each untitled tagfile. By default, this number is the tagfile's hot key. JH3 does not check for hot key conflicts; that's your job. If you made changes to the current tagfile while in the main screen (e.g., you edited, added, or deleted one or more taglines), JH3 will prompt you to save the current file before loading the new one. Press or click on the letter "Y" to save the changes, or press or click on the letter "N" to load the new files without saving changes made to the current file. Tagfile Hot Keys You may select a tagfile by pressing its "hot key" - the highlighted character in the tagfile's title. This is by far the fastest method to load a new tagfile. Use good judgment when assigning hot keys, since JH3 does not handle duplicates gracefully - it always loads the first tagfile whose hot key matches the key you pressed. To change a tagfile's hot key, use the JH3MAINT program. John Hancock 3.0 Page 11 TagFile Truncation As mentioned earlier, JH3 will NOT croak if you do not have sufficient memory to load a tagfile, or if you attempt to load a tagfile with more than 1,200 taglines. It will, however, truncate the file to make it fit available memory. Should this occur, JH3 will display one of the following warning messages: Tagfile too large -- truncated Tagfile truncated -- insufficient memory If either message is displayed, you will not have access to taglines at the end of your file. How much JH3 truncates the tagfile depends on how much DOS memory is available. If memory is very short, only a small portion of your tagfile will be loaded. See "Insufficient Memory" earlier in this document for ways to address RamCram. Whenever JH3 truncates a tagfile, it disables all editing features and file saving options. When only a portion of a tagfile is loaded, it cannot be saved back to disk since it would overwrite the actual file with its truncated version. Careful and in-depth analysis revealed such a feature to be "not nice at all" since it would result in the loss of all those taglines which took you years to collect. Note that if you load a new tagfile which fits into memory, JH3 re-enables its file editing and saving commands. - Insert new tag The command allows you to insert a new tagline at the cursor position (following taglines will be moved down one position). When you issue this command, JH3 inserts a blank tagline and passes control to the tagline editor (see the Edit Tag command for additional information). To cancel the addition and remove the new tagline, press or click the outside mouse button. You may add as many taglines as memory allows (JH3 always reserves enough memory to add 10 new taglines to the file). If there is not enough memory to add a tagline, JH3 issues a warning message and cancels the operation. If the file was truncated due to insufficient memory, or the file was already at the 1,200 tagline maximum, this command will not operate. John Hancock 3.0 Page 12 - Delete tag This command will delete the highlighted tagline (following taglines will be moved up one position). When you issue this command, JH3 displays the following message: Confirm tagline deletion Y/[N]? To delete the tagline, press or click on the letter "Y" in the message. To cancel the deletion, press or click on the letter "N". You may not delete the only tagline in a tagfile. - Edit Tag The command allows you to edit the currently selected tagline. Editing commands are as follows: Keypress Resulting Action -------------- -------------------------------------- Move cursor 1 character to the right Move cursor 1 character to the left Move cursor to start of next word Move cursor to start of previous word Move cursor to start of text Move cursor to end of text Delete character at cursor Delete character to the left Toggle Insert/Overstrike mode Clear field Restore original field Accept changes / leave editor Cancel changes / leave editor Your mouse can also be used when the editor is active: Mouse action Resulting Action ------------------------- ------------------------------- Click within text Locate text cursor Click outside text Accept changes / Leave editor Click outside button Cancel changes / Leave editor Be aware that the text and mouse cursors are completely independent. You may use the mouse to locate the text cursor, however. John Hancock 3.0 Page 13 - tagSearch The command lets you search for taglines based on the text they contain. This command is somewhat similar to the one featured in JH2, except it's a lot better. TagSearch may be case-sensitive or case-insensitive. In addition, the command may search for words or strings. The default search mode is set by the Word Search switch in JH3CFG's PreFlite checklist. If this switch is ON, JH3 searches for words -- the search argument you specify must match an entire word, rather than part of a word. If this switch is OFF, JH3 will match the search argument no matter where it occurs. When you issue the command, JH3 displays the search argument prompt on the screen's bottom line: Search for: The FIRST character of the search argument tells JH3 whether the search is case-sensitive or case-insensitive, and whether you are searching for a string or a word (the search argument prefix may be used to temporarily override the Word Search switch; remember that the default search mode is set in JH3CFG). Search Argument Prefix Meaning ---------------------- -------------------------------- None Case-insensitive, default mode Shrapknockle: ' Case-sensitive, default mode Tilde: ~ Case-sensitive, override mode Caret: ^ Case-insensitive, override mode Here are a few examples: 1. You are searching for taglines which contain the word "Byte". The Word Search switch is OFF. The search must be case-insensitive: Search for: ^byte The caret prefix maintains case-insensitivity, but toggles the search from string mode to word mode. 2. You are searching for taglines which contain the string "Brother". The Word Search switch is ON. The search must be case-sensitive: Search for: ~Brother John Hancock 3.0 Page 14 The tilde makes the search case-sensitive and toggles from word search to string search mode. 3. You are searching for taglines which contain the string "pervert". The Word Search switch is OFF. The search must be case-insensitive: Search for: pervert No prefix needed - the defaults are fine. If JH3 cannot locate any taglines, it will display a message to that effect. If it *does* find matching taglines, they will replace the standard tagfile display. At this point, you may continue to use JH3 *almost* normally. Since you are operating with a subset of the tagfile (called the "search window"), you may not edit, add, or delete taglines. You may Beautify a tagline in the search window, however. You may press or click on the outside mouse button to exit the search window and return to the regular tagline window. - Last tag A very useful command, will temporarily replace the current tagline with the *last* tagline which was sent to the reader - wherever it came from. During a JH3 session, you may load as many tagfiles as you wish, and the command will always produce that same last-sent tagline. This tagline is ephemeral; if you move away from it it will revert back to the original. You may also Beautify it, of course. Question: "Yo! I pressed and nothing happened." Answer: "Yo! More than likely, you're right on top of the very tagline you sent last time. It was displayed, but right on top of itself. Next question." and - Carmine and Guido During a late night JH3 coding session, Carmine and Guido, my Vice-Presidents in charge of Customer Relations and Registration Enforcement, showed up with their violin case and portable cement mixer. Smiling, they suggested that I name two JH3 commands after them. John Hancock 3.0 Page 15 I felt this was an extremely reasonable request, and the very least I could do, given the incentive. Carmine and Guido also suggested what the commands might do, and strongly insisted that I NOT document them. Understand, these two are Good Sicilian Boys, and it is difficult to refuse a favor that was asked so very nicely. So, friends, there you have it. Carmine and Guido are quite harmless, and if you want to know what it is that they do, you have to try it yourself. Note: If Carmine and/or Guido do not operate, you need to change one of JH3's more obscure configuration switches. This is all I am allowed to tell you. If Carmine and Guido are active, there will be absolutely NO doubt in your mind. - screensiZe JH3 is EGA-, VGA-, and UltraVision(tm)-friendly. If you have one of these adapters, or Personics' UltraVision display-enhancing software, the command will cycle through all available screen sizes (the screen width will remain at 80 characters, however). The new screen size becomes JH3's default and will be used by JH3 (and JH3MAINT) until you change it again. Supported screen sizes are: EGA: 25, 43 VGA: 25, 28, 43, 50 UltraVision: 24, 34, 36, 43, 50, 60, 63 Note: UltraVision does not support all screen sizes on all video adapter/monitor combinations. See your UltraVision manual for details. - Terminate JH3 The command immediately ends JH3 and returns you to the reader (or to DOS if you started JH3 from the DOS prompt while testing the program) WITHOUT sending a tagline to the reader. To quit JH3, you may also press or Click the mouse's outside button. Note: if you have not registered JH3, use the command while "dry-running" JH3 to acquaint yourself with the program's features. When you use to exit JH3, you are not charged with a "productive use" of the John Hancock 3.0 Page 16 program. Once you reach 250 productive uses of JH3, registration reminder messages will start. To really acquaint yourself with all of JH3's feature may require quite a few uses of the program - as an unregistered user, you should take advantage of these freebies whenever possible. - The Great Wurlitzer Ever been to one of those Pizza places that feature a Great Wurlitzer Theater Organ? Well, JH3 is nothing like that. JH3, however, can play some cute jingles, most of them good enough to be recognizable by the average person. You have no control over *which* tune is played; JH3 picks them at random, but tells you which tune will play right before it plays it. In order to support this exciting feature, your PC must be equipped with the following hardware: 1. One speaker. 2. A keyboard with a "W" key. Tunes are kept in the JH3.TUN file, a standard ASCII file which you can change with any text editor. You may also create your own tune files - see "Writing JH3 Moosik", in the Appendix, for technical details. The quality of sound is acceptable, but doesn't quite compare to what you can get with a dedicated sound card. It does compare very favorably with Fisher-Price toy pianos and cheap plastic harmonicas, however. Note: A number of environmental conditions may affect the pace at which tunes are played. Specifically, mouse movement, a large number of resident programs loaded in your computer, etc. can measurably slow down the tune's pace, especially on slower machines. - Toggling Wurlitzer ON and OFF The double note (to the right of the single note on the title line), and the and commands control the Great Wurlitzer in exactly the same way as the single note, and keys control the Sound F/X feature - these commands allow you to temporarily disable or enable the Great Wurlitzer, as well as control the default setting of the Wurlitzer Switch. John Hancock 3.0 Page 17 That's it for the Main Screen Whereas most run-of-the-mill software manuals want to WhizzBang you right off the bat, we decided to save the program's best for last. If you printed this manual and followed its lengthy discourse while viewing a live JH3 screen (the recommended procedure, or viewing the .DOC under a multitasker or task switcher), you've noticed that we skipped the Beautify command. Well, folks, Beautify is where 97% of the fun is. Guido, Carmine, the ScrollTrombone, Great Wurlitzer, and date and timestamps account for 2%, and the rest of the main screen's features for the last 1%. Let's go DO things to them taglines, shall we? Beauty and the Program From the main screen, press or click on the Beautify button, and JH3 will display its Tagline Beautification Screen (TBS). Incidentally, you may have caught a glimpse of the TBS while testing the Carmine command. The Tagline Beautification Screen The TBS is similar in layout and identical in navigation and command procedures to JH3's main screen. But that's where the similarities end. The TBS features twenty-one (21, vingt et un, XXI) advertised functional commands which *DO* things to taglines, and the Back () command, which returns you to JH3's main screen. That's a far cry from JH2, which had only 5 or 6 tagline beautification commands. And these are just the commands that you can *see*. There are quite a few others. Now, you may ask yourself "What has this NUT come up with now?" Thank you very much. We here at the Very Silly Frog Genetic Tagline Engineering Research and Development Laboratories, Inc., have come up with seven more ways to mangle taglines than Mr. Carter's got pills. And just think: Carter's pills all look the same. John Hancock 3.0 Page 18 Beautify Commands Most beautification features are cumulative - you may alter the tagline with a command, then alter it further with a second command, etc. ad nauseam. In some cases, the cumulative effect is not possible due to the sorry state in which the tagline was left following the last beautification exercise. Rather than cover all possible beautification combinations, we'll let you experiment for yourself (the *real* fun part). Commands are covered in the order in which they appear, from top to bottom and from left to right (Edit..W i d e, noSpace..Back). Un-Beautifying a tagline At times, you may end up with an unrecognizable mess - definitely not Hall of Fame material. To restore the tagline to its original condition, simply select another. As soon as you select a different tagline, the current tagline's original version is reinstated. To experiment with different beautification sequences, simply hit the and keys, or click on another tagline and click back on the first one, the cosmetic work will be erased, and you'll be able to start anew. or doubleclick - Send tagline to reader Pressing or doubleclicking on a tagline immediately sends it to the reader. If you made changes to the tagfile while in the main screen, JH3 will prompt you to save these changes. Changes made while in the Beautify Screen are not saved. IMPORTANT NOTE Some BBSs or BBS Networks do not allow the use of High-ASCII characters in messages or taglines. Others may not allow translation or encryption of any kind. On the other hand, some BBS or Networks will allow just about *anything* in a message. Although it is legal to buy a large and very heavy hammer at your local hardware store, it is against The Law - in most states - to beat people upside the head with it (unless, of course, they happen to be Sysops, BBS Conference Moderators, or Shareware Authors). John Hancock 3.0 Page 19 Similarly, although JH3 may allow you to break BBS or Network rules, it is your responsibility to comply with these silly regulations. Please don't blame *my* program for what *you* did. Thank you. - Edit Tagline A temporary tagline editor. Unlike the main screen's Edit command which make permanent changes to taglines, this one makes temporary changes. This command operates the same way as its main screen namesake, so the technical blurb won't be repeated here. - Frame Tagline The JH3 TagFramer is a very sophisticated Tagline Cosmetic Surgery Instrument which can make your taglines look radically different. Sometimes, they may even look *better*. Of course, as with cosmetic surgery, you're still stuck with the same old, tired tagline, but it's got a new body around it. This may be enough to convince a few gullible folks that this is a BRAND SPANKING NEW TAGLINE! When you issue the command, the tagline window is replaced by the TagFramer window - the selected tagline is displayed framed in all of the current frame file's patterns (see the command for changing frame files). When you first use JH3, you will only have the limited number of framing patterns available in the JH3.FRM default file. You can add your own framing patterns to this file later (see the Appendix for details). If you register JH3, you will receive the FRMMAKER bonus program, which makes the creation of new framing patterns a breeze. Scroll to the desired frame and press or doubleclick to select it and return to the Beautify Screen, or press or click the outside mouse button to exit TagFramer and return to the Beautify Screen without a framed tagline. If you returned to the Beautify Screen, you may continue your cosmetic work on the framed or unframed tagline. Pressing twice or doubleclicking twice - also known as QuadClicking - will send the selected framed tagline to the reader. John Hancock 3.0 Page 20 & - ASCIIFramer If you used TagFramer, you probably noticed that it did not feature any simple, single-character framing patterns. There is a excellent reason for this obvious shortcoming: ASCIIFramer. ASCIIFramer is a very quick and easy-to-use single-character framing system, which can produce symmetrical () or asymmetrical () frames. Either command causes an ASCII selection chart to pop-up on top of the tagline window. To select the framing character, use the cursor keys to highlight it and press , or click the mouse on it. Press or click the outside mouse button to cancel the ASCIIFramer request. A symmetrical frame utilizes mirror characters on the left and right sides; an asymmetrical frame uses the same character on both sides. Since many characters do not have mirror images, you should exercise some judgment when using the command. For example: If you and select the < character, you will get: <<<<<<<<<<< The JH Hall of Frame >>>>>>>>>>>> However, if you and select the B character, you will get: BBBBBBBBBBB The JH Hall of Frame BBBBBBBBBBB which is the same frame would have produced - there is no mirror character for B. Most characters which have left/right pairs are character graphics and symbols such as and , and , and , and , etc. Once you select a framing character, ASCIIFramer immediately generates the frame, and the framed tagline replaces the unframed tagline in the tagline window. You may then continue your beautification efforts, or send the tagline to the reader. John Hancock 3.0 Page 21 - Invert tagline The command flips the tagline around - the first character becomes the last and vice-versa. For example: The John Hancock Hall of Fame Becomes: emaF fo llaH kcocnaH nhoJ ehT Note that the command does not invert the tagline's alignment; a left-aligned tagline does not become right- aligned. To change alignment, use the and command *after* you use the command. - Jumble tagline The command got its name from the popular word unscrambling game found in or near the comics section of many daily newspapers. In a Jumbled tagline, words are still in their original orders, but their letters are re- arranged very creatively. For example: All lawyers are bloodsucking thieves. Might become: lAl ylserwa rea ldbsuincoogk evhetis. Not obvious, huh? Jumble can be a lot of fun. As is the case with Framer, you may use Jumble to attract the reader's attention away from an otherwise so-so message. Or you may hold Jumble contests. Do not use Jumble to exchange drug-related information or to conduct other illegal activities, such as plotting the overthrow of our fine, upstanding government. - Turn tagline to lower case No big deal here. Use to eradicate all UPPERCASE letters. For example: My Grandmother wears Army Boots! Becomes: my grandmother wears army boots! John Hancock 3.0 Page 22 Some folks are very case-sensitive, i.e., they really get miffed when they notice improper case usage. Use to activate their compulsive complaining reflexes. This technique works best when you proper nouns and end up with words such as abraham lincoln, new york, or iowa. - TURN TAGLINE TO UPPERCASE The command is 's logical complement. Generally, upper-case sentences are used to indicate "electronic screaming". See for yourself: your grandma wears army boots! and: YOUR GRANDMA WEARS ARMY BOOTS! Big difference, no? This is especially effective when the recipient's grandmother *really* does wear army boots. - rANdOmiZe TAgLinE cASE The AnyCaSE command takes a perfectly good tagline and randomly changes the case of its letters. It also conveys the idea that the author is under the influence of some dangerous controlled substance, such as Capt'n Crunch Cereal or Pink Tofu. For example: "Floggings will continue until morale improves" might turn into "FloGgINgS WiLL cOntInuE untiL MoRAle iMpRoVES". , , - Tagline alignment The Left, Right, and Center commands are used to change the tagline's alignment. JH3 taglines are stored in a frame that is 50 characters wide. Alignment commands insert or delete leading spaces to yield the desired visual effect. For example: He's cute, but can he *type*? ^ ^ Will be right-aligned into: He's cute, but can he *type*? ^ ^ John Hancock 3.0 Page 23 - E x p a n d T a g l i n e The W i d e command doubles the size of a tagline by inserting spaces in each position. For example: This tagline made by LHARC becomes: T h i s t a g l i n e m a d e b y L H A R C - Removealltaglinespacing The noSpace command is the logical opposite of the w i d e command - it removes all spaces. For example: This tagline made by PKZIP becomes: ThistaglinemadebyPKZIP - rmv tgln vwls The nVwl command removes all vowels from the tagline, yielding a shorthand-like and often cryptic result: I thank my lucky stars I'm not superstitious. becomes: thnk m lck strs 'm nt sprstts. - Translate Tagline to Pseudo-SiliGweek The Gk command will convert the selected tagline to Pseudo-SiliGweek, a language which almost closely resembles that used by Very Famous Dead People such as Aristotle, Plato, Aphrodite, Hermes, and Jimmy Dimopoulos, who used to make great Gyro sandwiches at the Mt. Olympus Bar & Grill. Translation allowances must be made, mostly because I don't know Greek, and also because our PCs only have a limited subset of the Greek alphabet (of course, you *do* know that the Greek and Roman alphabets have many characters in common, such as Iota, Omicron, P (Rho), Tau, and X, whatever John Hancock 3.0 Page 24 they call that one). To make up for this lack, the Pseudo- Gweek Translator algorithm uses characters that *look* like Greek, but may not be 100% legitimate Greek. I wish to apologize to the real Greek folks among you. I mean no harm, even though I am fully aware that Aristotle, Plato, and Homer will spend much time turning over in their graves whenever JH3 users press while on their tagline Odyssey. Here are a few examples of Pseudo-SiliGweek Tagline Mangling: All true wisdom is found in taglines All pu wi i i Tgli Only a Greek would do life in a barrel ly pk wl li i ppl Prunes give you a run for your money. p giv y pu p yup y. - Translate Tagline to Pseudo-Silirp Since JH3 was released in 1992, the year of the European Community (Communit Europenne de Coopration conomique Ridicule), we felt it was extremely appropriate for JH3 to have its own rp translator. As you all know, rp is a complex mix of languages, spoken mostly across the Atlantic by Very Famous People such as Jean-Marie-Phillipe du Grand Bidet l'Eau Froide, Wilhelm Von KntKmpt, Bjr vrtlv, Pbl De Cllo Csl, Prince Hmlt Van Slg & rr and, of course, Guido and Carmine. There are *a lot* of rp characters available in the PC's alphabet. For an added cosmetic effect, the JH3 rp conversion algorithm also uses not-so-rp special characters. The command will give your taglines an unequalled Continental Flair, a.k.a. "The Euro Look". In Detroit, this consists mostly of putting red pinstripes on black cars, adding the word "Euro" to the vehicle's name, and charging discriminating US customers a couple thousand more for the result. Be that as it may, rp translation will convert your perfectly good tagline into a randomly selected mix of French, Dutch, Swedish, German, Spanish, Norwegian, and John Hancock 3.0 Page 25 other special characters, while at the same time retaining its original looks: All true wisdom is found in taglines ll tr wsdm s d tgls Everyone is entitled to my opinion. vr s ttld t m p. It takes a long word to retard spoilage. t tks lg wrd t rtrd splg. - Nuts According to my atty Testers, \ȼs was a true stroke of genius (we're entitled to *one* of those during our lifetime), and the critical factor that will make JH3 users register the program by the thousands. \ȼs starts where Gk and rp stop; instead of a mere character translation, \ȼs tries its damnedest to *manufacture* new characters for the translation. These characters are often made up of ASCII graphics, but not always. For example, H may be translated as )-( or ]-[, and W as \/\/. \ȼs-like taglines have appeared in messages for quite some time, but these were all carefully handcrafted and required much time and effort. JH3 completely eliminates this effort, replacing it with a simple stroke of the N key. Words cannot do \ȼs justice; you have to use it to see what it can do. One of the beauties of \ȼs lies in its unpredictability - odds are that the same tagline will never yield the same result twice. Here is an example of a few applications of \ȼs to the tagline "Does the name Pavlov ring a bell?": D[]s ̹ ڿ˻ ո\/ riɻg ո __? s \/\˻ p/\_\/ Rg ո b_? DOS ո\/ P/\_o Ri\G b_? See what I mean? John Hancock 3.0 Page 26 - Zing'em The Zinger algorithm is unique to JH3, and is activated by pressing or clicking on the Zing'em button. The idea behind Zinger is similar to the various metavariable substitution schemes found in BBS and other software, but with a twist. If you've ever seen a tagline such as: OS/2 was built on a Monday You've probably thought "Boy, I know a LOT of things that were built on a Monday. I own many of them." You may even have a large collection of very similar taglines, just to cover all that territory: Unix was built on a Monday My car was built on a Monday Windows was built on a Monday And each time you come up with one of these great Zingers, your tagfile grows a little. Some day you'll have thousands of these gems and you'll run out of hard disk space to store them. Not if you use Zingers. Zingers provide a clever and generic solution to this difficult problem. All you need to do is create ONE Zinger tagline, as follows: @Z@ was built on a Monday. You may then store all your generic Zingers in one place, ready to be used on a moment's notice. For example: @Z@ was built on a Monday. Your mother wears @Z@ Anyone who hates @Z@ can't be all bad The Good, The Bad, and @Z@ @Z@ ain't pretty, but it's expensive Walk softly and carry @Z@ Well, you get the idea. When you issue the Zing'em command, JH3 prompts you for the Zinger replacement string (e.g., OS/2, Army Shoes, small children, etc.). Type your gem (or to cancel), and from now on, JH3 will automatically replace the @Z@ metavariable with the Zinger string in the current tagline. John Hancock 3.0 Page 27 You may change the Zinger string as often as you like during a JH3 session. - sHuffle tagline The command creatively re-arranges your tagline word by word, and can yield incomprehensible or totally hilarious results: Floggings will continue until morale improves Continue morale will improves floggings until Prunes give you a run for your money. Money you run give a for prunes your. Stand back, I don't know how big this gets. Big stand know this back gets i how don't. Note that sHuffle tries its best to respect the original case - if the nth original word started with an upper case letter, so will the nth word in the shuffled tagline. - Translate tagline JH2 was able to encrypt taglines. The JH2 Cipher caused so much paranoia that three Net software authors incorporated cipher translation within their programs (taglines were translated to upper ASCII graphics and symbols and were not readily decipherable). As a result, I was accused by some of providing a means of conducting illegal electronic activities (e.g., Colombian Drug Lords exchanging secret trade info and Commies plotting the overthrow of our government). One thing: JH2's encryption was the same for everyone, and anyone with a Tagline Thief program was able to decipher the taglines immediately. I decided that it would be fun to repeat this success, if only to see if mass delirium is as easy to generate as it was 2.5 years ago. The JH3 algorithm is a simple monoalphabetic substitution cipher, similar to that found in cheap word games books which you can buy at your corner drugstore. The command gets its substitution algorithm from the JH3.XLT file, which is stored in the same directory as your .TAG, .TUN, and .FRM files. JH3.XLT contains two copies of John Hancock 3.0 Page 28 the alphabet, the first one in upper-case and the second in lower-case. The order in which letters appear in these alphabets defines the substitution cipher. Originally, the JH3.XLT file yields NO encryption (the two alphabets are in standard order): ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxuz You may use any standard text editor (e.g., DOS 5's EDIT program) to change the JH3.XLT file. The example below does a simple shift-substitution of all vowels (A=E, E=I, I=O, O=U, U=Y, Y=A): EBCDIFGHOJKLMNUPQRSTYVWXAZebcdifghojklmnupqrstyvwxaz With this JH3.XLT file, the tagline: My keyboard sure is screwed up would become: Ma kiabuerd syri os scriwid yp The beauty of the command is that it cannot be detected automatically, and it can provide hours of fun as you try to decipher other people's secret taglines. Of course, identical JH3.XLT files are required on the sending and receiving end for the secret exchanges to occur. To decipher a translated tagline requires a program that can steal it or decipher it, so that you can use JH3 later to view it. Of course, if you register JH3, you will get the Text Thieves which provide instant tagline theft and make deciphering a lot easier. NOTE: Your .XLT file must have two complete alphabets. If the file is too short or too long, or is missing one or more letters, JH3 will produce an appropriate error message and will cancel the command. !(&^!*# - Blaspheme The command is another absolutely useless but hilarious command which occurred to me very late one night after too much coffee and not enough sleep. All of you have seen messages or taglines such as: Get the *^%$@#$ out of my face!, or Why don't you go *^%$%$#! yourself! John Hancock 3.0 Page 29 Of course, the meaning of the &#$$@# expletive strings is entirely up to the reader. The command picks a random word in the selected tagline and converts it to a random [Expletive Deleted] string: All lawyers are blood-sucking thieves All lawyers are blood-sucking $%#@#!@, or All &$%#@#! are blood-sucking thieves Floggings will continue until morale improves &^$%#@$%^ will continue until morale improves

- Potluck Potluck is a tri-mode command which can convert a perfectly readable tagline into a seemingly unreadable mess. However, upon closer inspection, Potlucked taglines are *very* easy to read. It just isn't obvious at first. When you press

, Potluck yields the following: First listen to sermon, THEN eat missionary. Yrano issimt ae nehtno, MRES otn etsiltsrif. Can you figure it out? Easy: Potluck inverted the tagline, but observed the exact spacing, punctuation, and case of the original uninverted text. Of course, those letters which were in upper case probably won't be. - Return to Main Screen Pressing or exits the Beautify screen and returns JH3 to its main screen. Tagline beautification, if any, is lost, including any editing changes made while in the Beautify screen. To send a beautified tagline to the reader, press or doubleclick on the beautified tagline - to save a beautified tagline, use the Keeper command described earlier. John Hancock 3.0 Page 30 Appendix John Hancock 3.0 Page 31 Writing JH3 Moosik When you register JH3, you receive the Maestro program, which greatly eases the creation and testing of JH3 Tune (.TUN) files. At the time you register, you may also send for the JH3 Hall of Fame, which includes a number of additional tunes for your musical enjoyment. If you do not have Maestro, you must create or edit your tune files manually. Tunes produced by the great Wurlitzer are stored in the JH3 Tagfile directory in special .TUN files. These are standard ASCII (text) files which you can create or update with any text editor. To familiarize yourself with tune files, view the JH3.TUN file included in the JH3 distribution file. Furthermore, if you have DOS 5.0, which comes with QBASIC (or an earlier version of DOS and the GWBASIC interpreter), you may also test your own .TUN files, since the Great Wurlitzer uses standardized BASIC music notation (more on this at the end of this chapter). Tune file format Tune files use a very simple format. Each tune requires two lines in the file. The first line is the tune's title, which can be 1 to 25 characters and must be enclosed within square brackets: [Yankee Doodle] [William Tell] [Little Green Apples] The following are invalid titles: The Girl from Ipanema (no brackets) [The Charge of the Light Brigade] (title too long) The second line, which immediately follows the title line, contains the tune itself, defined as a series of contiguous BASIC PLAY statement parameters. These parameters control all aspects of the music: note, tempo, duration, octave, etc. Tunes may not exceed 256 characters. PLAY commands are described below: The LAST LINE in your .TUN files MUST contain the string "[EOF]" (see JH3.TUN for an example). John Hancock 3.0 Page 32 Set octave: >, <, and On There are 7 octaves, numbered 0-6. > Increase octave by 1 < Decrease octave by 1 On set the current octave to n Play note: A-G or Nn A-G Play the note in the range A-G. For a sharp note, follow the note with "#" or "+". For a flat note, follow the note with "-". Nn Play note number n, where n is 1-84. Each octave has 12 notes. "1" corresponds to first note of the first octave, 84 to the last note of the 7th octave. Duration: Ln, MN, ML, MS Ln Specifies the length of each note. L4=1/4 note, L1=whole note, etc. Valid range is 1-64. MN Sets "music normal": each note plays 7/8th of the time specified by the L parameter. ML Sets "music legato": each note plays the full period specified by the L parameter. MS Sets "music staccato": each note plays 3/4 of the time specified by the L parameter. Tempo: Pn, Tn Pn Specifies a pause of duration n (1-64). The pause lasts the length of each note, as specified in the L parameter above. Tn Sets the tempo as the number of 1/4 notes in one minute. The valid range is 32-255, and the default is 120. NOTE: JH3 does not support the period parameter, which increases note duration by 50%. To increase note duration, use the L parameter immediately before the desired note, and reset it after that note if necessary. John Hancock 3.0 Page 33 Creating and editing tunes with BASIC If you have MS-DOS 5.0 and the QBASIC program, or an earlier version of DOS with the GWBASIC or BASICA interpreter, you can use it to create, edit, and test your tunes. You may also edit tunes with the QuickBasic or QBX Microsoft programs or other compilers which support the standard MS BASIC PLAY statement (e.g., Turbo Basic, Power Basic, etc.) The instructions that follow refer to the QBASIC program distributed with Microsoft DOS 5.0; its syntax is fully compatible with the earlier versions of BASIC distributed with pre-5.0 releases of DOS. Using QBASIC to create and edit tunes If you use a BASIC compiler or interpreter, I recommend the following steps: 1. Create one tune at a time using the BASIC program. 2. Save the tune as an ASCII file. 3. Use a text editor to add the tune to your .TUN file. Note that QBASIC features online help; use this facility to view the PLAY command syntax. Once you have started QBASIC, type the PLAY statement on the first line, followed by a double quote. You may now type the music commands. The PLAY string must also end with a quote. To play the tune, execute the program by pressing . Edit the PLAY string until you get the desired result. If you have absolutely no idea where to start, try the following: PLAY "L12N3N8N12N15P2N12N15" Refer to the instructions above to figure what the PLAY statement tells the computer to do. Once you have the tune you want, use the QBASIC command to save the file. For example, if your .TUN files are in the C:\JH3 directory, you could save the file as: C:\JH3\MYTUNE.TUN When the file is saved, exit QBASIC (). Go to your tagfile directory, start your text editor, load your tune file (or JH3.TUN if you haven't created your own tune file), and import or merge the MYTUNE.TUN file you just John Hancock 3.0 Page 34 created. Add a title line, and remove the PLAY statement and quotes: [Chaaaaaarge!] L12N3N8N12N15P2N12N15 That's it! You now have a new tune ready to go. If you do NOT have an editor that can merge external files, use the DOS 5.0 EDIT command (which happens to be the same editor as QBASIC): 1. Type EDIT at the DOS prompt 2. Load MYTUNE.TUN with the / command 3. Place the cursor at the beginning of the line and press . 4. Cut the line by pressing . 5. Load the *real* .TUN file (JH3.TUN, for example) with the / command. Reply "N" to the "save file" prompt. 6. Go to the end of the .TUN file by pressing . 7. Move the cursor to the beginning of the [EOF] line and press . 8. Press . This will paste the new tune into the file. Remove the PLAY statement and quotes. 9. Insert the desired title immediately above the tune. That's it! You can now save the file. Your new tune is ready to go. In case you wondered, the Maestro program makes this process almost painless (you still have to write the tunes). If you enjoy tunes, but hate the process of creating them, consider registering JH3. John Hancock 3.0 Page 35 Framing your Taglines When you register JH3, you receive the FRMMAKER program, which greatly eases the creation and testing of JH3 frame (.FRM) files. At the time you register, you may also send for the JH3 Hall of Fame, which includes a number of excellent handcrafted frames for your visual enjoyment and that of others. If you do not have FRMMAKER, you must create or edit your frame files manually. Frames available in the JH3 Beautify Screen are stored in the JH3 Tagfile directory in special .FRM files. These are standard ASCII (text) files which you can create or update with a standard text editor. To familiarize yourself with frame files, view the JH3.FRM file included in the JH3 distribution package. Frame File Format Each line in the .FRM file defines a frame; a frame file may contain up to 100 frame definitions. Frame definitions contain a header and one or two framing patterns, which may or may not be separated by a pattern delimiter. The format of the frame header is as follows: DSR D is the pattern delimiter. By default, the delimiter is a space. If one or both framing patterns include embedded spaces, the delimiter cannot be a space. You also need a non-blank delimiter if you define a left- or right-side-only framing pattern. The basic rule is simple: the delimiter cannot be a character which also appears in a framing pattern. S is the frame spacing value (0-9). This value defines the number of spaces between the framing pattern(s) and the tagline. A value of 0 removes frame-to-tagline spacing. R is the replication factor, which may be ON (1) or OFF (0). When replication is ON, the Framer program replicates framing patterns to fill the available space. "Available space" is defined as follows: Available Space = 50 - (Length of Tagline + Spacing Value) John Hancock 3.0 Page 36 Framing patterns The framing pattern definition(s) immediately follow(s) the frame header. There are four types of framing patterns: 1. Mirrored patterns. 2. Non-Mirrored patterns. 2. Left-Side pattern. 3. Right-side pattern. Mirrored patterns A Mirrored pattern consists of a single left frame with no delimiter. For example: 11 The above pattern will yield: The JH Hall of Frame The use of a blank delimiter and a single frame pattern definition tells the Framer logic to create a mirror image of the left pattern on the right side of the tagline. The Framer logic uses symmetrical characters whenever possible. For example: 11 will yield: The JH Hall of Frame ιιιιιιι 11< will yield: <<<<<<< The JH Hall of Frame >>>>>>> If the left pattern contains spaces, and you want the same mirrored effect, you must use a delimiter, and you must also define the right pattern - effectively defining a non- mirrored pattern: ^11< ^ > will yield: < < < The JH Hall of Frame > > > Note that the size of the framed tagline has been reduced. The pattern size is longer (4 characters instead of 2), and the replication switch is ON - each replication of the pattern requires 8 characters (4 on the left and 4 on the right). As a result, the pattern could be replicated only 3 John Hancock 3.0 Page 37 times (a fourth replication would have caused the framed tagline to exceed the 50-character maximum). Non-Mirrored patterns The last example above used non-mirrored patterns to yield a mirrored pattern effect. To get non-mirrored patterns, you must use a delimiter and define both the left and right framing patterns: ^11ABC^123 will yield: ABCABCABCABCABC The JH Hall of Frame 123123123123 Left- and Right-side patterns Single-side patterns are a simple subset of non-mirrored patterns -- just eliminate the side you do not want from the pattern definition, but use the non-blank delimiter: ^11ABC^ will yield: ABCABCABCABCABCABCABCABCABC The JH Hall of Frame ^11^123 will yield: The JH Hall of Frame 123123123123123123123123123 The FRAMECK program Once you have created or updated your JH3.FRM frame file, you should validate it with the FRAMECK.COM program. FRAMECK will read each frame definition in the frame file and make sure that it has the proper syntax. When FRAMECK detects an error, it displays an appropriate message and logs it to the FRAMECK.LOG file in the current directory. The line number of the frame in error is shown in the .LOG file to make editing of the .FRM file easier. Error messages and corrective actions follow: Frame too short - minimum size is 4 characters The frame definition must contain at least four characters (the 3-character header and a minimum 1-character left frame). Make sure you didn't forget the leading delimiter - even if it is blank, it has to be there. Frame too long - maximum size is 40 characters John Hancock 3.0 Page 38 More than likely, your framing patterns exceed their 20 characters limit. Delimiter specified and not found in frame definition If the delimiter (the first character in the frame definition) is not blank, it must appear inside the pattern field. Delimiter specified and framing pattern(s) too short More than likely, you did not have any framing patterns defined (e.g., the delimiter was the only character in the pattern field). Incorrect spacing value - valid range is 0-9 Self-explanatory. FRAMECK looks for an integer in the spacing field. Incorrect replicate switch value - must be 0 or 1 Self-explanatory. The replication switch may be ON (1) of OFF(0). The FRMMAKER Program When you register JH3, you receive the FRMMAKER program which actually makes designing frames an enjoyable activity: - FRMMAKER is 100% mouse-friendly. The program can be operated entirely with the mouse. - FRMMAKER won't let you make misteaks. - FRMMAKER's ASCIIPicker lets you select upper ASCII characters quickly and easily. Building graphic frame patterns is a snap! - FRMMAKER lets you copy one frame pattern to the other. - FRMMAKER displays the framed tagline continuously. No guessing, and no need to run the FRAMECK program. - FRMMAKER saves your artwork for you, and it creates new frame files automatically when they are needed. - FRMMAKER won't say ANYTHING when you design a real ugly frame. John Hancock 3.0 Page 39 The fact is, designing frames is not that difficult, but it can take a while, and without FRMMAKER, the only way to test your result is to use JH3. With FRMMAKER, you have a complete, easy-to-use frame studio at your disposal. You *know* what these critters will look like long before you select them in JH3's Beautify Screen.