















                                                                       
                                                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
                    <Shift><letter> - AlphaLoc.........................8
                    Mouse Navigation...................................8
                The ScrollTrombone.....................................9
                <F2> <F4> - Toggling Sound F/X ON and OFF..............9
            Tagfile Screen Commands...................................10
                <T> - Load New Tagfile................................10
                Tagfile Hot Keys......................................10
                TagFile Truncation....................................11
                <I> - Insert new tag..................................11
                <D> - Delete tag......................................12
                <E> - Edit Tag........................................12
                <S> - tagSearch.......................................13
                <L> - Last tag........................................14
                <C> and <G> - Carmine and Guido.......................14
                <Z> - screensiZe......................................15
                <Q> - Terminate JH3...................................15
                <W> - The Great Wurlitzer.............................16
                    <F3> <F5> - 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
                <Enter> or doubleclick - Send tagline to reader.......18
                <E> - Edit Tagline....................................19
                <F> - Frame Tagline...................................19
                <Ctrl><S> & <Ctrl><A> - ASCIIFramer...................20
                <I> - Invert tagline..................................21
                <J> - Jumble tagline..................................21
                <O> - Turn tagline to lower case......................21
                <U> - TURN TAGLINE TO UPPERCASE.......................22
                <A> - rANdOmiZe TAgLinE cASE..........................22
                <L>, <R>, <C> - Tagline alignment.....................22
                <W> - E x p a n d  T a g l i n e......................23
                <S> - Removealltaglinespacing.........................23
                <V> - rmv tgln vwls...................................23
                <G> - Translate Tagline to Pseudo-SiliGweek...........23







                <Y> - Translate Tagline to Pseudo-Silirp.........24
                <N> - Nuts............................................25
                <Z> - Zing'em.........................................26
                <H> - sHuffle tagline.................................27
                <X> - Translate tagline...............................27
                <!>  !(&^!*# - Blaspheme............................28
                <P> - Potluck.........................................29
                <B> - 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 <Esc> or click the outside mouse button to exit the
            program instead of pressing <Enter> 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.TXT 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 <Enter>:

            C:\JH3\JH3 <Enter>

            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 <Alt>, then press the
            desired colorset's number or letter.  For example, to
            activate ColorSet 4, press <Alt><4>.  For ColorSet 12, press
            <Alt><B>.

            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
            ------------------------   ---------------------------------
                                <Up>   Move up one
                              <Down>   Move down one
                              <PgUp>   Move up one screen
                              <PdDn>   Move down one screen
              <Home> or <Ctrl><PgUp>   Top line of current window
               <End> or <Ctrl><PgDn>   Bottom line of current window
                        <Ctrl><Home>   First line of tagfile
                         <Ctrl><End>   Last line of tagfile
                             <Enter>   Send tagline to reader
                               <Esc>   quit JH3

            <Shift><letter> - AlphaLoc

            If JH3CFG's PreFlite CheckList's AlphaLoc switch is turned
            ON, pressing <Shift> 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 <Shift> 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.


            <F2> <F4> - 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
            <F2>, or permanently by pressing <F4>.  With a mouse, click
            on the single note at the left of the title bar to disable
            Sound F/X temporarily, or <Shift>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 <F4> or <Shift>Click method
            described above.  You can then use the <F2> 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 <F4> or <Shift>Click method
            described above.  You can then use the <F2> or mouse method
            to re-enable Sound F/X during the current JH3 session.





                                                John Hancock 3.0 Page 10

            Tagfile Screen Commands


            <T> - Load New Tagfile

            Press <T> 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 <Enter> or doubleclick to load the file, or press
            <Esc> 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 <Y> or click on the
            letter "Y" to save the changes, or press <N> 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.


            <I> - Insert new tag

            The <I> 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 <Esc> 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


            <D> - 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 <Y> or click on the letter "Y"
            in the message.  To cancel the deletion, press <N> or click
            on the letter "N".

            You may not delete the only tagline in a tagfile.


            <E> - Edit Tag

            The <E> command allows you to edit the currently selected
            tagline.  Editing commands are as follows:

                      Keypress    Resulting Action
                --------------    --------------------------------------
                       <Right>    Move cursor 1 character to the right
                        <Left>    Move cursor 1 character to the left
                 <Ctrl><Right>    Move cursor to start of next word
                  <Ctrl><Left>    Move cursor to start of previous word
                        <Home>    Move cursor to start of text
                         <End>    Move cursor to end of text
                         <Del>    Delete character at cursor
                   <Backspace>    Delete character to the left
                         <Ins>    Toggle Insert/Overstrike mode
                      <Alt><C>    Clear field
                      <Alt><R>    Restore original field
                       <Enter>    Accept changes / leave editor
                         <Esc>    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


            <S> - tagSearch

            The <S> 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 <S> 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 <Esc> or click on the outside mouse button to
            exit the search window and return to the regular tagline
            window.


            <L> - Last tag

            A very useful command, <L> 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 <L>
            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 <L> 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."


            <C> and <G> - 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.


            <Z> - screensiZe

            JH3 is EGA-, VGA-, and UltraVision(tm)-friendly.  If you
            have one of these adapters, or Personics' UltraVision
            display-enhancing software, the <Z> 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.


            <Q> - Terminate JH3

            The <Q> 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 <Esc> or Click the
            mouse's outside button.

            Note: if you have not registered JH3, use the <Q> command
                  while "dry-running" JH3 to acquaint yourself with the
                  program's features.  When you use <Q> 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.


            <W> - 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.


            <F3> <F5> - Toggling Wurlitzer ON and OFF

            The double note (to the right of the single note on the
            title line), and the <F3> and <F5> commands control the
            Great Wurlitzer in exactly the same way as the single note,
            <F2> and <F4> 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 <B> 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 (<B>) 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 <Up>
            and <Dn> 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.


            <Enter> or doubleclick - Send tagline to reader

            Pressing <Enter> 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.


            <E> - 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.


            <F> - 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 <F> 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 <F8> 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 <Enter> or doubleclick
            to select it and return to the Beautify Screen, or press
            <Esc> 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 <Enter> twice or doubleclicking twice - also known
            as QuadClicking - will send the selected framed tagline to
            the reader.





                                                John Hancock 3.0 Page 20

            <Ctrl><S> & <Ctrl><A> - 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 (<Ctrl><S>) or
            asymmetrical (<Ctrl><A>) 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 <Enter>, or
            click the mouse on it.  Press <Esc> 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 <Ctrl><S> command.  For example:

            If you <Ctrl><S> and select the < character, you will get:

            <<<<<<<<<<< The JH Hall of Frame >>>>>>>>>>>>

            However, if you <Ctrl><S> and select the B character, you
            will get:

            BBBBBBBBBBB The JH Hall of Frame BBBBBBBBBBB

            which is the same frame <Ctrl><A> 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

            <I> - Invert tagline

            The <I> 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 <I> command does not invert the tagline's
            alignment; a left-aligned tagline does not become right-
            aligned.  To change alignment, use the <L> and <R> command
            *after* you use the <I> command.


            <J> - Jumble tagline

            The <J> 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.


            <O> - Turn tagline to lower case

            No big deal here.  Use <O> 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 <O> to
            activate their compulsive complaining reflexes.  This
            technique works best when you <O> proper nouns and end up
            with words such as abraham lincoln, new york, or iowa.


            <U> - TURN TAGLINE TO UPPERCASE

            The <U> command is <O>'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.


            <A> - 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".


            <L>, <R>, <C> - 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



            <W> - 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


            <S> - 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


            <V> - 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.


            <G> - 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 <G> 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.


            <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 <Y> 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.


            <N> - 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

            <Z> - Zing'em

            The Zinger algorithm is unique to JH3, and is activated by
            pressing <Z> 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 <Esc> 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.


            <H> - sHuffle tagline

            The <H> 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.


            <X> - 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 <X> 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 <X> 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 <X> 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 <X> 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


            <P> - 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
            <P>, 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.

            <B> - Return to Main Screen

            Pressing <B> or <Esc> 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 <Enter> 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
            <Shift><F5>.  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 <Alt><F><A> 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 (<Alt><F><X>).  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 <Alt><F>/<O> command
            3. Place the cursor at the beginning of the line and press
               <Shift><End>.
            4. Cut the line by pressing <Shift><Del>.
            5. Load the *real* .TUN file (JH3.TUN, for example) with the
               <Alt><F>/<O> command.  Reply "N" to the "save file"
               prompt.
            6. Go to the end of the .TUN file by pressing <Ctrl><End>.
            7. Move the cursor to the beginning of the [EOF] line and
               press <Enter>.
            8. Press <Shift><Ins>.  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.