/**
 *	function formatEmail
 *		box: the mail box to send the mail to.  The is the part before the @ in an email address.
 *		domain: this is the domain with out the top level domain.  Include all qualifiers up to the top level domain (com, net, org, etc.)
 *		topDomain: this is the top level domain - com, net, org, etc.)
 *	Returns a string of te formatted email address
 **/
function formatEmail(box, domain, topDomain) {
	return box + "@" + domain + "." + topDomain;
}

/**
 *   function emailLink
 *		theLink: this can be text or contain html markup such as an image.  This is what will be displayed as a link
 *		box: the mail box to send the mail to.  The is the part before the @ in an email address.
 *		domain: this is the domain with out the top level domain.  Include all qualifiers up to the top level domain (com, net, org, etc.)
 *		topDomain: this is the top level domain - com, net, org, etc.)
 *	Returns a string containing html markup for an email link.  This includes the ancor tags and everthing in between.
 *
 **/
function emailLink(theLink, box, domain, topDomain) {
	// build a formated email address from the box, domain and topDomain.
	email = formatEmail(box, domain, topDomain);
	// format the string and return the email link.
	return '<a href="mailto:' + email + '">' + theLink + '</a>'
}
