This directory contains files and scripts that let you convert from 
the SDDF file format used in Pablo Releases 1.0 and 1.1 to the revised
SDDF format used in Pablo Releases 2.0 and later.  Release 2.0 introduced a 
SDDF header in each SDDF file that was not in the previous versions.

1) Converting Saved Configurations:

The script, convertConfigurations, can be used to convert any Pablo 
configurations saved under Release 1.* to work under Release 2.0 and later. 
Change into the top-level directory where your configurations are
saved, and run 'convertConfigurations'.   This will convert all
"StructureDictionary" files found in any directory under the top-level
directory to be converted to the new SDDF ascii format.

2) Converting SDDF Files:

This directory contains files that may be prepended onto SDDF files created
with old versions of the SDDF library so that the files can be processed by the
current version of the library.   

	AsciiHdr		Header for SDDF files in ASCII format

	BigEndianHdr		Header for SDDF files in binary format written
				on machine with big-endian byte ordering.
				( Sparcs )

	LittleEndianHdr		Header for SDDF files in binary format written
				on machines with little-endian byte ordering.
				( DecStations, Intel )


To transform an old-format ASCII SDDF file named 'File.ascii' into the new 
format, do:

 mv File.ascii File.ascii.OLD
 cat AsciiHdr File.ascii.OLD > File.ascii
 wc -c File.ascii.OLD File.ascii   // File.ascii should have 6 more characters
 rm File.ascii.OLD		   // remove the old version
	

To transform an old-format BINARY SDDF file named 'File.binary' that was 
written on a big-endian machine such as a SparcStation into the new format, do:

 mv File.binary File.binary.OLD
 cat BigEndianHdr File.binary.OLD > File.binary
 wc -c File.binary.OLD File.binary // File.binary should have 19 more characters
 rm File.binary.OLD		   // remove the old version
	

To transform an old-format BINARY SDDF file named 'File.binary' that was 
written on a little-endian machine into the new format, do:

 mv File.binary File.binary.OLD
 cat LittleEndianHdr File.binary.OLD > File.binary
 wc -c File.binary.OLD File.binary // File.binary should have 19 more characters
 rm File.binary.OLD		   // remove the old version
