
                                   My Little Realm

                               DizzE (The DIZ Editor)

                                     Version 1.0
          ____________________________________________________________________

                                       Important

          My Little Realm's DizzE (The DIZ Editor) is protected by copyright.
          It is not freeware, and it is not in the public domain.

          DizzE requires 89 Kb of disk space.  It can be run from a floppy or
          a hard disk.  DizzE should run on any type IBM compatible.
          ____________________________________________________________________

                               Introduction/Overview

          DizzE allows you to perform the mundane task of DIZ editing with
          alacrity.  DizzE checks for: 

               1  The separator (minus sign/hyphen)
               2  Number of lines in the file (won't let you exceed ten)

          The separator must appear in the first two lines, or DizzE will
          notify you that it is missing or misplaced.  You may bypass this 
          safety check to save a DIZ file without the requisite separator.

          You can delete a DIZ file by loading it into DizzE, viewing it to
          verify that it is indeed the one you want to delete, deleting all
          of its lines with block-delete, and exiting the editor.  DizzE
          will tell you that you have no lines of text, and it will ask if 
          you wish to delete the existing file.  Reply yes.

          If you want to really churn out the DIZ files, call up one of your
          best works of art, make the necessary changes, and save it to the
          appropriate program's directory.  Then immediately go back into 
          the editor, make more changes and save that version to another 
          program's directory, and so on.

          I suggest you put DizzE in its own directory (like DIZEDIT) and 
          simply call it from whatever directory you're working in at the 
          time you need it.  If you are lacking hard disk space, put DizzE
          on a floppy and call it up whenever you need it.  DizzE can save
          files to any legitimate drive.

          Note:  The bottom line on the screen is called the Escape Line.
          It will keep you apprised of the escape key's function at any
          point during the operation of the program.
          ____________________________________________________________________

                                   Program Specifics

          - Creating or loading a file.

          The Create/Load window.    
              ___________________________________________________________
             |                                                           |
             |    1 Create file     2 Load file        3 Exit program    | 
             |___________________________________________________________|

          When you start DizzE, you're placed in the Create/Load window.  You
          can either load an existing file or leap right into the editor.
          
          Loading a file.
          If you select Load File, Dizze will ask for a path.  If the path is
          legitimate, but the file does not exist, DizzE will assume you are 
          creating a new file with the path you gave it.  You must give DizzE
          the complete path, but you need not enter the filename which, of 
          course, remains a constant.  After you've entered the path, you're 
          placed in the editor.

          You can load an existing file from one directory, modify it to meet
          the needs of another program and save it to the other program's 
          directory.  This boilerplate production method speeds document 
          creation time considerably.

          Creating a file.
          If you select the option Create File, you'll be placed in the 
          editor immediately.  Let your purple prose flow.

          Exiting the editor.
          The only key that gets you out of the editor properly is the
          escape key.  When you've finished your literary showpiece, press 
          <esc> to exit the editor.  You'll then be placed in the Save/Print 
          window which is described below.

          After you exit the editor, DizzE checks for the separator.  It must
          appear in the first two lines.  [Note:  Many BBS's recommend that
          you put the title in uppercase, followed by the version number and
          then the hyphen.]

          Sample editor screen.

                       1     MY LITTLE REALM'S DIZZE V1.0 <ASP> - This
                       2     is the DIZ editor you've been waiting for!
                       3     Hark the herald angels sing and all that
                       4     jazz.  Baby it's cold outside.  What's it
                       5     all about, Alfie?  Where were you when I
                       6     needed you, where were you when I wanted 
                       7     you?  In my midnight confessions, when I
                       8     tell all the world that I love you.  
                       9     Cherish is a word I use to describe all the
                      10     feeling that I have hiding here for you
              ---     11     inside.  Can't you see I love you, please
               |      12     don't break my heart in two, that's not 
               |      13     hard to do, 'cause I don't have a wooden
               |      14     heart.  I should have known, you bid me
              ---     15     farewell, there's a lesson to be learned

          You will notice that the editor allows for fifteen lines of text 
          even though a FILE_ID.DIZ file may only have ten.  The reason for
          this Is to permit liberal use of the blocking and copying ability 
          of the editor, allowing you to cut and paste with relative abandon.
          After you've got the wording just right, it's up to you to delete 
          the excess verbiage in the remaining lines.

          If you don't, DizzE will notify you that there are more than ten 
          lines of text in your edit field, and it will ask you what you want
          done with them.

                  ___________________________________________________
                 |                                                   |
                 |     You have more than ten lines of text.         |
                 |     1  Return to editor      2  Delete excess     |
                 |___________________________________________________|


          Select <1> or <R> to go back to the editor to tidy up the file 
          yourself, or if the top ten lines are perfect, choose <2> or <D> 
          to truncate the lines 11 through 15.  [Note:  <esc> also puts you 
          back in the editor at this juncture.]

          If you've selected Create File from the Create/Load window and exit
          the editor leaving the edit field blank, you'll be returned to the 
          Create/Load window automatically.  If you load an existing file, 
          delete all of the text, and exit the editor, you'll be shown the 
          following warning:

                     __________________________________________ 
                    |                                          |
                    |     Working on C:\TESTING\FILE_ID.DIZ.   |
                    |     Your edit field is empty.            |
                    |     Delete existing file?  <Y>  <N>      |
                    |__________________________________________|


          Press <N> or <esc> to avoid deleting the file.  To effect the
          delete, press <Y>.

          Once you've made it past these checks, you're placed in the 
          Save/Print window.
          ____________________________________________________________________

          - Saving and printing files.

          The Save/Print window.    
              ___________________________________________________________
             |                                                           |
             |    1 Save file      2 Print file      3 Exit Save/Print   |
             |___________________________________________________________|


          Whenever you exit the editor with text in it, DizzE displays the
          Save/Print window shown above.  If you select Exit Save/Print 
          before you save the file (by pressing <3> or <E>) or by pressing 
          <esc>, DizzE will tell you that you have not saved the file and 
          will display the following prompt:

                   ____________________________________________________    
                  |                                                    |
                  |   C:\TESTING\FILE_ID.DIZ not saved.                |
                  |   1  Editor     2  Save file    3  Confirm exit    |
                  |____________________________________________________|

          
          Pressing <1> or <E> will put you back in the editor, and <2> or <S>
          will put you in the Save File function.  Pressing <3> or <C> 
          confirms your desire to exit the Save/Print function without saving
          the file, and <esc> will return you to the Save/Print window.

          Saving your files.
          When you choose Save File either in the Save/Print window or in 
          the prompt, DizzE tells you the current path\filename and asks how 
          you want it saved, like so:

                     _________________________________________    
                    |                                         |
                    |     Working on C:\TESTING\FILE_ID.DIZ.  |
                    |     Save as:  C:\TESTING\FILE_ID.DIZ    |
                    |_________________________________________|


          If you want to send it off someplace else (like a floppy disk),
          make the appropriate changes in the Save As line and press <enter>.

          If the target path is different from the original path and there is
          an existing file at the target location, DizzE will warn you of the
          situation.

                   ____________________________________________________ 
                  |                                                    |
                  |   B:\FILE_ID.DIZ already exists.                   |
                  |   1  Overwrite     2  Reenter path    3  Cancel    |
                  |____________________________________________________|


          Press <3>, <C>, or <esc> to return to the Save/Print window.  Press
          <1> or <O> to overwrite the existing file, and, <2> or <R> allows
          you to reenter the FILE_ID.DIZ path.

          Printing your masterpieces.
          You can print your FILE_ID.DIZ files in any of three page layouts:
          Normal, Top Center, and Dead Center.  Normal printout puts the 
          text in the top left corner of your page.  Top Center puts it where
          you'd imagine, and Dead Center puts the text in the approximate
          center (vertically and horizontally) of your page.
          ____________________________________________________________________

          - About the editor.

          When in the editor, press <F1> to review the keys needed to block 
          text, copy, delete, and so on.  It's fairly standard:  use 
          <shift> + a directional key to block text; <ctrl> + <insert> to 
          capture text to the buffer and <shift> + <insert> to insert 
          buffered material into the text field.

          You'll find five extra lines of working space in the editor that 
          allow you to cut and paste fairly freely.  You are supposed to 
          tidy up, but if you forget, DizzE will notify you that your line
          count exceeds ten.  You have the option of telling DizzE to erase 
          the unwanted lines or returning to the editor and tidying up 
          yourself.

          Note:  For anyone interested, the editor comes from Crescent 
          Software's QuickPak Professional library.  I have noticed a few
          quirks in it, but it seems to be pretty solid.
          ____________________________________________________________________

                              John L. Salisbury
                              My Little Realm Enterprises
                              22 Church Street #103, Suite 376
                              Ramsey, New Jersey  07446
                              (201) 529-8318
                              CIS # 70761,2175

          DizzE (The DIZ Editor) copyright 1993 John L. Salisbury
          All rights reserved.
          ____________________________________________________________________
