COMMAND NAME:

        MEMLOAD

ABBREVIATION:

        ML

ALIAS:

        LOADMEMORY

USAGE:
        MEMLOAD "filename" [,file-bit-range [,file-word-range],
        primitive-bit-range[,primitive-word-range]]

        Loads the memory specified by the current memory path from 
        the given file. The user is prompted for a file name if none 
        is given. All other parameters are optional. The optional 
        arguments to the MEMLOAD command are used to specify a mapping
        from the memory contents file to the memory primitive.
    
        The file word range specifies which words from the memory contents 
        file are to be deposited in the memory primitive, and the 
        primitive word range specifies the  mapping of the words within 
        the memory primitive.  
    
        The file bit range specifies which of the file word bits are
        deposited in the memory primitive, and the primitive bit range
        specifies the mapping of the file word bits within the memory 
        primitive.  
    
        Note that bit and word range arguments must be given as integers
        and must be enclosed in the appropriate brackets (either angle
        or square, as indicated). 
    
        The syntax for word range is 

            [high address..low address:step]

        Note that the square brackets indicated above are actually
        to be typed.  They are NOT indicating an optional field
        like the square brackets in the command syntax given at the
        top of this file.  If word ranges are not specified, they
        default to [depth-1..0:1], where depth is the depth of the
        memory primitive specified on the GED drawing.

        The syntax for bit range is 

            <n..m>

        Again the angle brackets are actually to be typed.  
        If bit ranges are not specified, they default to the range of 
        the memory primitive (either <size-1..0> or <0..size-1>, 
        depending on the signal syntax being used at the site).


        An example of the complete command syntax is:
    
            MEMLOAD "memdata.dat",<8..5>,[200..100:10],<3..0>,[20..0:2]

        which a) maps words 200,190,180,170,.._. of the file into words
                            20,18,16,14,.._. of the memory primitive.
          and b) maps bit 8 of file word into bit 3 of the primitive
                      bit 7 of file word into bit 2 of the primitive, 
                      and so on. 

