This directory contains the following files:

miscellaneous files
-------------------
README		the file you are reading now

version.c	contains the "version" and "options" strings for use with
		the "what" program and xtmconvert


xtm.h		contains the defines and structure definitions for xtmrecord,
		xtmexecute, and xtmconvert

xtmbuttons.c	contains the button names used by xtmrecord, xtmexecute,
		and xtmconvert

xtmconvert.man	contains the man pages (before nroff -man) for xtmconvert

xtmexecute.man	contains the man pages (before nroff -man) for xtmexecute

xtmrecord.man	contains the man pages (before nroff -man) for xtmrecord


xtmconvert routines
-------------------
xtmconvert.c	contains the "main" function for xtmconvert and some utility
		routines used only by xtmconvert

tranin.c	contains the "output_to_script" function to convert a test
		script from output format to internal format and the
		"summary_to_script" function to convert a test script from
		summary format to internal format

tranout.c	contains the "script_to_test" function to convert a test script
		from internal format to output or summary formats


match data manipulation routine
-------------------------------
inttoout.c	contains the "inttoout" function to convert match data from
		internal format to output format

inttosum.c	contains the "inttosum" function to convert match data from
		internal format to summary format

outtoint.c	contains the "outtoint" function to convert match data from
		output format to internal format

sumtoint.c	contains the "sumtoint" function to convert match data from
		summary format to internal format

xwdtomatd.c	contains the "read_match_data_from_xwd" function to read
		data into a match data structure from an xwd format file


utility routines (used by xtmconvert and xtmrecord)
---------------------------------------------------
getkey.c	contains the "getkey" function to get a string (skipping
		leading white space but including inner white space)
		until a delimiter character

chk_copy.c	contains the "chk_copy" function to copy input actions to the
		input action buffer

write_i_a.c	contains the "write_input_actions" function to write input
		actions from the input action buffer to the test script

xtmexecute routines
-------------------
xtmexecute.c	contains the "main" function for xtmexecute and some utility
		routines used only by xtmexecute

exmatch.c	contains the "exmatch" function to do screen comparisons


match data handling routines
----------------------------
checksum.c	contains the "compute_checksum" function for computing a 16-bit
		CRC checksum of a buffer of bytes

clrpadbits.c	contains the "clear_pad_bits" function for clearing the pad
		bits of image data (this only contains some special cases,
		it may need additional special cases added)

inttomatd.c	contains the "read_match_data_from_internal" function to read
		data into a match data structure from an internal format file

matdtoint.c	contains the "write_match_data_to_internal" function to write
		out data from a match data structure to an internal format file

inttotemp.c	contains the "inttotemp" function to read match data from an
		internal format file into a match data structure and a match
		data temp file

temptoint.c	contains the "temptoint" function to write out match data
		from a match data structure and a match data temp file to an
		internal format file

wintotemp.c	contains the "wintotemp" function to read match data from the
		X server into a match data structure and a match data temp file

matdtoxwd.c	contains the "write_match_data_to_xwd" function to write out
		match data from a match data structure and a match data temp
		file to an xwd format file 


utility routines (used by xtmrecord, xtmexecute and xtmconvert)
---------------------------------------------------------------
chkopen.c	contains the "chkopen" function for opening a file

clipwin.c	contains the "clipwin" function for clipping a match area

compress.c	contains the "compress" function for compressing match data

copymatd.c	contains the "copy_match_data" function to copy compressed
		match data from one file to another

findchild.c	contains the "findchildren" function to find all children of
		the root window

findmouse.c	contains the "findmouse" function to determine which window
		the pointer (mouse) is in

getcurscr.c	contains the "get_current_screen" function to determine which
		screen the mouse is in

getint.c	contains the "getint" function to retrieve a string of digits
		from a file and convert them to an integer

getkeysym.c	contains the "getkeysym" function to translate key codes into
		key name strings

getmouse.c	contains the "getmouse" function to return the window which 
		contains the mouse and is a child of the root window

getrectw.c	contains the "get_rect_window" function to try to find a window
		which contains a specified rectangle

getroot.c	contains the "getroot" function to return the root window

gettmp.c	contains the "gettmp" function to create a temporary file

gettop.c	contains the "gettop" function to return the window which is
		the "top" window and is a child of the root window

makef.c		contains the "makef" function to create a file

readchk.c	contains the "readchk" function to read from a file and check
		the return code for errors

sigcatch.c	contains the "sigcatch" function to capture and report signals

swaplong.c	contains the "swaplong" function to swap the bytes in a long

swapshort.c	contains the "swapshort" function to swap the bytes in a short

wrchk.c		contains the "wrchk" function to write a string to a file and
		check the return code for errors

wrchk2.c	contains the "wrchk2" function to write a number of bytes
		to a file and check the return code for errors

xerror.c	contains the "xerror" function to report x errors


xtmrecord routines
------------------
xtmrecord.c	contains the "main" function for xtmrecord and some utility
		routines used only by xtmrecord

intbox.c	contains the functions used by the partial window specification
		command in xtmrecord

##############################################################################
# 
# Copyright 1986, 1987, 1988, 1989 by Hewlett-Packard Corporation
# Copyright 1986, 1987, 1988, 1989 by the Massachusetts Institute of Technology
# 
# Permission to use, copy, modify, and distribute this
# software and its documentation for any purpose and without
# fee is hereby granted, provided that the above copyright
# notice appear in all copies and that both that copyright
# notice and this permission notice appear in supporting
# documentation, and that the name of M.I.T. not be used in
# advertising or publicity pertaining to distribution of the
# software without specific, written prior permission.
# 
# Hewlett-Packard and M.I.T. make no representations about the 
# suitability of this software for any purpose.  It is provided 
# "as is" without express or implied warranty.
# 
# This software is not subject to any license of the American
# Telephone and Telegraph Company or of the Regents of the
# University of California.
# 
##############################################################################
