         ###  #    #    ####  ###  ####   ###  @   @  @@@   @@@ @  @
        #   # #    #    #    #     #   # #   # @   @ @   @ @    @ @
        ##### #    #    ###  #  ## ####  #   # @@@@@ @@@@@ @    @@
        #   # #    #    #    #   # #   # #   # @   @ @   @ @    @ @
        #   # #### #### ####  ###  #   #  ###  @   @ @   @  @@@ @  @

                (Angel, leprechaun, leprechaun, eye, gremlin, 
                 rodent, orc, giant, ant, cockatrice, kobold)

                          Version 3.4.0 - 2.01 Manual
    
        
    Legal stuff:                                                           
         AllegroHack (c) 2000 by Kelly Youngblood.                         
         AllegroHack is distributed under the same terms as Nethack. 
         See license for details.                               


    System requirements:                                                   
         Nethack 3.4.0 DOS Protected mode version already installed.       
         Pentium class CPU or better.                                      
         8 megabytes RAM.                                                  
         Windows ME, Windows 98, Windows 95, or MSDOS-compatible 
                operating system.    
        
         AllegroHack may run on a 486 or with less RAM. It will probably
    NOT run under Windows NT, Windows 2000, or Windows XP. AllegroHack
    has not been tested on DosEmu.  
    
    Installing AllegroHack:                                                
    
         From the command line, copy ahack12b.zip to your Nethack 3.3.1
    directory, and then type "pkunzip -d ahack17b.zip". Or using Winzip, 
    Extract ahack17b.zip to your Nethack 3.3.1 directory with the "use 
    folder names" box checked.                     

         Then, edit alleg.cnf in a text editor such as Notepad to set 
    your preferences.  The text in alleg.cnf describes what each 
    option does.Edit defaults.nh and ensure the line 
    "OPTIONS=video:autodetect" doesn't have a # in front of it.            

         Finally, run anethack.exe as you would nethack.exe.               

         If AllegroHack crashes when you run it, make sure that 
    OPTIONS=video:autodetect is set in your nethack config file!           
    
    
    Controls:                                                              
    
         F3 : Cycle HUD between equipment display, mini-map, combo, and off.
         F4 : Toggle overview mode.                                        
         F6 : Save screenshot. This will dump 2 files,                     
              "nethack.bmp" contains what's on your screen.                
              "nhmap.bmp" is a graphical map of the whole level.           
    
         Control-Left  : Pan the screen left.                              
         Control-Right : Pan the screen right.                             
         Control-PgUp  : Pan the screen up.                                
         Control-PgDn  : Pan the screen down.                              
    
         (I can't get Control-up or Control-down to work)                  
    
    
    Credits:                                                               
        The Nethack Devteam - Nethack 3.3.1. 
        Kelly Youngblood - Allegro interface routines and a few tiles. 
        Warren Cheung [of Slash'EM] - Miscellaneous bugfixes. 
        Mitsuhiro Itakura - 32x32 base tileset. 
        Paul Pliska, John Harris, and Kelly Bailey - Aditional tiles. 
        DJ Delorie - DJGPP Compiler. 
        Shawn Hargreaves - Allegro Library. 
        Michael Bukin - Anti-aliasing routines. 
        The users of rec.games.roguelike.nethack - Suggestions, bug reports,
                                                   testing, you name it!
    
    Known Bugs:                                                            
    
         AllegroHack may not allow you to alt-tab out of it. A possible 
    fix: Create a shortcut to anethack.exe and make sure that all the 
    windows function keys are enabled in its shortcut properties. You may 
    also be able to shell out with '!' then alt-tab. If this doesn't fix 
    it email me or post to rec.games.roguelike.nethack.
    
         On some systems, AllegroHack crashes when the backspace key is 
    pressed.  I have no idea why.                                   
    
    
    Contacting me:                                                         
    
         You can email me at klyoungblood@capitol-college.edu, or post to 
    rec.games.roguelike.nethack. Be sure to include "AllegroHack" 
    somewhere in the subject: line. 

