 ͻ
                       **** 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                      
                             May 19, 1997                            
                                                                     
                       Please send $20 to register                   
               (Not very much money when you think about it)         
                                                                     
                             2-451 Albert St.                        
                          Waterloo, Ont, Canada                      
                                N2L 5A7                              
                                                                     
     Please E-mail me for up to date mailing address and phone no.   
                                                                     
                                                                     
                 E-mail:   jgdurwar@uwaterloo.ca                     
      WWW:    http://www.undergrad.math.uwaterloo.ca/~jgdurwar/hex   
                                                                     
                                                                     
                                                                     
     The Registered Version of this program can be purchased and     
     received immediately on the Internet at Albert's Ambry.         
     Registration at Albert's also eliminates shipping and handling  
     Please go to:                                                   
                                                                     
                       http://www.alberts.com                        
                                                                     
     Search on: hex51c.zip or hex52a.zip (soon)                      
                                                                     
     Click on the "Buy It" Hotlink to register this software.        
                                                                                              
     Thank you for registering this program.                         
                                                                       
   ͼ


 ͻ
                              Index                                  
 ͼ


         i.     Evaluation Copy.
        ii.     Purchasing.
       iii.     Installation.
        
         0.     Fixes and Enhancements
         1.     Command line
         2.     Overview of files
         3.     Hex.cfg file
         4.     Environment variables
         5.     Mapping keys
         6.     New utilities
         7.     Additional comments




 ͻ
                         i. Evaluation copy.                         
 ͼ

        There are three versions of Hex available. 
        
                - Stripped Down version.
                - An evalution (full version) with expiry.
                - Full version. Includes command line utilities.

        The first, the stripped down version, is available to anyone
        in order to provide a 'feel' for the product. If does not 
        seem like it could appeal to you, then your quest is over.

        An evaluation copy is available to those who are considering
        purchasing Hex. This is not a shareware version, but rather
        a version given to the customer under the assumption that he
        or she will destroy it if it does not meet their needs. It
        will also expire after a pre-determined evaluation period.
        This allows the customer a reasonable time to become familiar
        with the full version of Hex.  

 ͻ
                        ii. Purchasing Hex.                          
 ͼ


        If the evaluation copy proves to be what you are looking for,
        a full, registered version can then be acquired for $20. Please
        see the information on Albert's Ambry above!

        If you purchase Hex, you will also receive some useful command
        line utilites, bit-editing utilities as well as tech support
        for any problems you may have.

 ͻ
                       iii. Installing Hex.                          
 ͼ

   Hex.exe, hex.hlp and hex.cfg should be put in the same directory.
   The directory they are put in should be in the path (ie. Path=C:\Hex)

   Hex searches for hex.cfg in the directory where hex.exe was run from.
   It then searches in the current directory. If it still can't find it,
   Hex will create a new hex.cfg.

   Hex.hlp is searched for in the same way as hex.cfg. However, if hex.hlp
   cannot be found, the F1 (Help) key will not function.


 ͻ
              0. Fixes and Enhancements from 4.0 to 5.2a             
 ͼ

 
                              
    New Stuff :

     *-Searched text is highlighted throughout the file		
     *-Batch processing for command line search and replaces

     *-New binary file utilities!  (Only in registered version)

			
        -'delete'       Deletes data from file given boundary offsets 
        -'insert'       Inserts one file into another at a given offset

        -'splitter'     Splits a file into specified sizes
        -'joiner'       Joins a bunch of files into one
        -'cmp'          Does a binary compare of files


        See end for more information about above

     *-Search and Replace can be restricted to only area selected
     *-Selection (for cutting/pasting) of ANY size now allowed!
     *-Much Faster insertion and deletion
     *-More online help and tips and useful information too.
     *-More intuitive layout for new files, general user suggestions.
     *-Faster Search and Replace capabilities. 
     *-EBCDIC editing is available on request.
     *-Bit-Editing is available on request.

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

        
    Neat Stuff:

        -Mouse interface

        -Allows searching and replacing:
 
                -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 

        
 ͻ
                     1.  The Command Line                            
 ͼ


        Usage: HEX [/r] [/c] [filename] [(search) [(replace)]]

        /c      Load just the converter. No files are edited.      

        /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.
                        
        (search) (replace)

        You can now do some command line processing of files. For
        example, if you wanted to replace all occurences of the word
        "Hi" with "ABC", you could do:

        c:\>hex filename (Hi) (ABC)

or

        c:\>hex filename (Hi) (0x41 42 43)

or

        c:\>hex filename (Hi) "(ABC)"

        Note that the quotes can be used if you have spaces in the
        search or replace string.

        If only a 'search' string is given then hex is entered with 
        the searched item already chosen.        
			


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


 ͻ
                      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.
                
 ͻ
                  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 need 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. New Utilities                             
 ͼ

           These new utilities very useful for command line 'hexing'.
           The splitter is very nice when working on really large files.
           It allows you to break it into small chunks, work on those,
           and then use 'joiner' to put them back together.
           Insert and delete are very useful for touch up jobs.         



'delete'        Usage:    delete file1 begin end [file3]

                  The data at offset 'begin' through and including 'end' is deleted.
                  NOTE: By default 'file1' is rewritten without deleted data.
                  If 'file3' is specified, the result is stored in it.
        
'insert'        Usage:    insert file1 file2 offset [file3]
        
                  'file1' is inserted into 'file2' at 'offset'
                  NOTE: By default 'file2' is rewritten with new insertion.
                  If 'file3' is specified, the result is stored in it.
        
'splitter'      Usage:    splitter file1 size [file2]
        
                  'file1' is split into 'size' size chunks.
                  The split files are put into files 'file2.aaa', 'file2.aab' ...
                  If 'file2' is not specified, file are put into 'file1.aa' ...
        
'joiner'        Usage:    joiner file1 [file2]
        
                  'file1.aaa', 'file1.aab'... are joined to make file2.
                  If 'file2' is not specified, destination is file1.
         

 ͻ
                        7. 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. Find an easter egg, win a prize.


                          HORSES MOUTH


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

        WWW     http://www.undergrad.math.uwaterloo.ca/~jgdurwar/hex

  

 
   
