//
	//	This function will create a new child node for the given parent.
	//	The new node will be created after the last child for this parent.
	//
	function appendNode(docpath, sNewName, sParentName, sStyle, sContent, sNewNodeType) {
		var MainNode = docpath.getElementById(sParentName);
		var newNode = docpath.createElement(sNewNodeType);	// this will create a new div
		newNode.setAttribute('name', sNewName);
		newNode.setAttribute('id', sNewName);
		newNode.setAttribute('style', sStyle);
		MainNode.appendChild(newNode);		// add on the new div
		if (sContent.length > 0 ) {
			newNode.innerHTML = sContent;
		}
	}
	
	//	
	//	This function loops through all elements of a radio group to determine which
	//	one is selected and returns the value of the selected item
	//
	function getRadioValue(rRadioObject) {
		var nRadioElements = rRadioObject.length;

		for (var i=0; i < nRadioElements; i++) {
		    if (rRadioObject[i].checked == true) {
	            return rRadioObject[i].value;
			}
		}    
	}
	
	//	
	//	This function loops through all elements of a select box to determine which one 
	//	should be selected based on it's value and sets that item to be selected
	//
	function setSelectedItem(rSelectObject, nValue) {
		var nSelectElements = rSelectObject.length;

		for (var i=0; i < nSelectElements; i++) {
		    if (rSelectObject[i].value == nValue) {
	            return rSelectObject[i].selected = true;
			}
		}    
	}

//
	//	This function will toggle the given element between inline and none display values
	//
	function toggleElement(sElement) {
		ThisElement = document.getElementById(sElement);
		if (ThisElement.style.display == "inline") {
			ThisElement.style.display = "none";
		} else {
			ThisElement.style.display = "inline";
		}
	}
	
		//
		//	Will give the user a warning and truncate the specified field value to the specified number of characters
		//
	function limitChars(eItem, nLimit) {
		if ( eItem.value.length > nLimit ) {
			alert("There is a limit of " + nLimit + " characters on this item.  Your entry will be truncated to "  + nLimit + " characters.");
			eItem.value = eItem.value.substring(0, nLimit);
		}
	}
	
	function toggleItem(sItemID) {
		eItem = document.getElementById(sItemID);
	
		if ( eItem.style.display == 'none' ) {
			eItem.style.display = 'block';
		} else {
			eItem.style.display = 'none';
		}
	}
	function toggleImage(sImageID, sSrc1, sSrc2) {
		eImage = document.getElementById(sImageID);
		sComparisonString = eImage.src.substring(eImage.src.length - sSrc1.length, eImage.src.length);
		
		if ( sComparisonString == sSrc1 ) {
			eImage.src = sSrc2;
		} else {
			eImage.src = sSrc1;
		}
	}
		//
		//	Returns true if the passed value is found in the array.  Returns false if it is not.
		//	The syntx below will assign this is a function to all arrays
		//
	Array.prototype.inArray = function (value) {
		var i;
		for (i=0; i < this.length; i++) {
			// Matches identical (===), not just similar (==).
			if (this[i] === value) {
				return true;
			}
		}
		return false;
	}
	
	// function takes a display NAME and the VALUE for the new element and then adds it to the dropdown specified in the other parameter
	function addOption(whichDD,name,value) {
		// create a reference to the SELECT and the form
		var theDD=eval(whichDD);
	 
		// create the new OPTION
		var newOption;
		newOption= new Option (name,value);
	 
		// position
		var insertAt = theDD.options.length;
	 
		// create the space
		theDD.options.length=theDD.options.length + 1;
	 
		// add the option
		theDD.options[insertAt] = newOption;
	}
	
		//
		//	This function will select the proper option from a select element based on value
		//
	function setSelectedItem(eDD, nValue) {
		for ( i=0; i<eDD.options.length; i++ ) {
			if ( eDD.options[i].value == nValue ) {
				eDD.options[i].selected = true;
			}
		}
	}
	
	function compareText (option1, option2) {
	  return option1.text < option2.text ? -1 :
		option1.text > option2.text ? 1 : 0;
	}
	function compareValue (option1, option2) {
	  return option1.value < option2.value ? -1 :
		option1.value > option2.value ? 1 : 0;
	}
	function compareTextAsFloat (option1, option2) {
	  var value1 = parseFloat(option1.text);
	  var value2 = parseFloat(option2.text);
	  return value1 < value2 ? -1 :
		value1 > value2 ? 1 : 0;
	}
	function compareValueAsFloat (option1, option2) {
	  var value1 = parseFloat(option1.value);
	  var value2 = parseFloat(option2.value);
	  return value1 < value2 ? -1 :
		value1 > value2 ? 1 : 0;
	}
	function sortSelect (select, compareFunction) {
	  if (!compareFunction)
		compareFunction = compareText;
	  var options = new Array (select.options.length);
	  for (var i = 0; i < options.length; i++)
		options[i] = 
		  new Option (
			select.options[i].text,
			select.options[i].value,
			select.options[i].defaultSelected,
			select.options[i].selected
		  );
	  options.sort(compareFunction);
	  select.options.length = 0;
	  for (var i = 0; i < options.length; i++)
		select.options[i] = options[i];
	}