 ͻ
                       **** DISCLAIMER!!!!! ****                       
                                                                       
  This software is provided by Jon Durward "as is" and any express or  
  implied warranties, including, but not limited to, the implied       
  warranties or merchantability and fitness for a particular purpose   
  are disclaimed. In no event shall Jon Durward (or any member of      
  JD Software) be liable for any direct, indirect, incidental,	        
  special, exemplary or consequential damages (including, but not      
  limited to, procurement of substitute goods or services; loss of     
  use, data or profits; or business interruption however caused and on 
  any theory of liability, whether in contract, strict liability, or   
  tort (including negligence or otherwise) arising in any way out of   
  the  use of this software, even if advised of the possibility of     
  such damage.							        
 ͼ
                 ͻ
                        HEX by Jonathan Durward       
                            March 29, 1995            
                                                      
                       Address Until Sept 1,1995      
                  258 Lester St., Waterloo, Ont, Can  
                                N2L 3W5     	       
                                                      
                  E-mail:   jgdurwar@uwaterloo.ca     
                  WWW   :   http://u36.kwic.net/hex   
                  FTP   :    u36.kwic.net (pub/hex)   
                 ͼ

 ͻ
                 Fixes and Enhancements from 3.2 to 5.1              
 ͼ

 
                              
    New Stuff :

     *-Search and Replace capabilities. 
     *-On the fly configuration. You'll NEVER touch the hex.cfg file again!	
     *-'Pull Down' menus and scrollers. It is pretty nice. 
     *-Key Mapping greatly improved. Dynamically reflected in Help and menus!
     *-Mini Converter for Binary, Octal, Hex and Decimal numbers
      -Context sensitive help menus.
      -Windows with 'Close Down Boxes'
      -Pick an executable from file selector and run it. Overlays Hex!
      -Internal text viewer. Very quick.
      -File manipulation goodies (change file attributes at a click...)
	

	
    Fixes:

	-Print File option works with any size file	
        -Cutting and pasting works marvelously now	
        -Fixed garbage that appeared when using F6 (change colors).
	-Long paths handled. Used to kick out around 60 chars.
	-Some other stuff. ie. Clicking outside 'Yes' 'No' box problem.

    Neat Stuff:

	-Mouse interface

	-Allows searching:
 
		-Multiple HEX values (ie. 'FF 23 7E')
		-Hex or Text searches
		-Count occurences of Hex or Text values
		-Search again 

	-Allows inserting and deleting 
	-Pop-up windows
	-Configuration:

		-Colors
		-Key mapping
		-Screen saver timeout,memory to use...

	-Edits files of any size
	-Change file attributes at a click
	-Point and click style file selection
	-Allows viewing with alternate editor
	-Screen Saver 

	
 ͻ
                              Index                                  
 ͼ

	1.	Command line
	2.	Overview of files
	3.	Hex.cfg file
	4.	Environment variables
	5.	Mapping keys
	6.	Additional comments

 ͻ
                     1.  The Command Line                            
 ͼ


        Usage: HEX [/r] [filename] \n");

        /r      View mode (read-only). Speed is greatly increased.      

       filename	This can be a full path, relative path. Using
		the format *.c for example would list all of the
		files with a .c extension. One may be picked from
		there.
			
   No Filename  This will put you into the file selection mode.


 ͻ
                     2. Quick file Overview                          
 ͼ

        Hex.exe:  Main executable. Should be in path.

        Hex.cfg:  Configuration options. It is first searched
                  for in the path pointed to by HEXPATH. If it
                  is not there, it is searched for in the 
                  directory where the hex.exe is found. If it        
                  is found in neither, the defaults are used.
 
        Hex.hlp:  Contains information for help screens. It is
                  searched for in the same way as hex.cfg. Do
                  not touch this file! Any change will seriously
                  screw up the help menus.


 ͻ
                      3. The HEX.CFG File                            
 ͼ

        Configuration is now done on the fly. You should not
        touch the hex.cfg file by hand anymore. You can change
        the options under the Option menu heading. This is where
        you save them as well.


        The AUTO DELETE variable indicates whether
        the user wishes to be able to delete files
        without prompting. If AUTO DELETE=YES then
        the user can use the Alt-D combination to
        delete files without prompting. This is 
        useful when one know that they will be deleting
        many files. 

	The CASE SENSITIVE variable is used for searches.

	The HEXBIG (or BIG FILE) variable controls how
        big a file must be before it is considered a 'big'
        file. If a file of this size or bigger is loaded,
        the user will be asked if they'd like to load the
        file as read-only. If, for example, someone 
        wanted to peek at part of a 4MEG file, they
        would normally have to wait quite a while for
        the temp file to be created. If it was caught
        by the HEXBIG variable, it would save the user
        a lot of time! 

        The HEXMEM (or MEMORY or BUFFER) variable
        sets the maximum amount of memory that is set
        aside for information storage. The larger the
        number is, the slower text manipulation will be
        but disk access will be lessened. You need a
        minumum of 5000 bytes due to overhead.

        The LINES variable controls what video mode
        you are in. Values of 25, 43 or 50 are the
        recommended ones, but any value can be used.
	if it is set to AUTO, it auto detects.

        The OVERWRITE variable indicates where hex will
	start in Insert mode or Overwrite mode.

        The PAUSE TIME variable controls the number of
        milli-seconds information windows remain on 
        the screen. A value of one or two thousands
        might be useful to a new user, where most users
        will have it set to 0, to make things quicker.

        The SCRTIME variable holds the number of seconds
        HEX waits until the screen saver kicks in.
        
        The TEMP variable allows you to set the directory
        in which tempfiles will be written. This directory
        must be able to hold at least the size of the file
        you are editing. (RAM drives are great for this!)
	if it is set to AUTO it uses the TEMP environment
	variable.
                
     Ŀ
                                                       
       The following are the colors that may be used   
                                                       
       "BLACK"                                                       
       "BLUE"                                          
       "GREEN"                                         
       "CYAN"                                          
       "RED"                                           
       "MAGENTA"                                       
       "BROWN"                                         
       "WHITE"                                         
       "GREY"                                          
       "BRIGHT BLUE"                                   
       "BRIGHT GREEN"                                  
       "BRIGHT CYAN"                                   
       "BRIGHT RED"                                    
       "BRIGHT MAGENTA"                                
       "YELLOW"                                        
       "BRIGHT WHITE"                                  
                                                       
     
        
 ͻ
                  4. Environment Variables                           
 ͼ


        HEXLINES        ie. set HEXLINES=25

        HEXBIG          ie. set HEXBIG=100000

        HEXMEM          ie. set HEXMEM=50000    

        HEXPATH         ie. set HEXPATH=c:\hex

           This points to the directory in which
           the hex.cfg is found. If it is not set
           the file will be looked for in the
           directory from which hex.exe was run.If                           
           it is not found there, the default values
           are used. This is also the directory used
           to find the hex.hlp file. 

        
        TEMP            ie. set TEMP=c:\tmp

           If this is not set, the current directory
           will be used. This may be a problem if
           you are sitting in a directory where you
                  do not have write permissions. Make sure
           there is enough room in this directory
           for a swap file the size of the file you
           are editing (unless in read-only mode).


 ͻ
                          5. Mapping Keys                            
 ͼ

           This has been greatly improved. You do not to touch
           the Hex.cfg file anymore. It is all done in Hex. Basically,
           you pick a key and then select the function you want it
           to do. If doing this will overwrite a previously defined key
           the two are swapped. 

           This is done under the Options/Misc Config option. It is 
           straight forward, just follow the instructions!



 ͻ
                        6. Additional Comments                       
 ͼ




                          GETTING HELP

   
   It is recommended that you use the F1 option to get help in
   both the file selection mode and file editor mode. Go through
   all of the options available, learning the significance of all
   of the different functions.


                          HORSES MOUTH


   If you have any other questions or requests for enhancements,
   please do not hesitate to mail me at jgdurwar@uwaterloo.ca.

			http://u36.kwic.net/hex
			u36.kwic.net (pub/hex)
 


 
   
