 	<cfreturn loc.returnValue>
 </cffunction>
 
-<cffunction name="mailTo" returntype="string" access="public" output="false" hint="Creates a mailto link tag to the specified email address, which is also used as the name of the link unless name is specified.">
+<cffunction name="mailTo" returntype="string" access="public" output="false"
+	hint="Creates a mailto link tag to the specified email address, which is also used as the name of the link unless name is specified."
+	examples=
+	'
+		##mailTo(emailAddress="webmaster@yourdomain.com", name="Contact our Webmaster")##
+		-> <a href="mailto:webmaster@yourdomain.com">Contact our Webmaster</a>
+	'
+	categories="view-helper" functions="URLFor,linkTo,buttonTo">
 	<cfargument name="emailAddress" type="string" required="true" hint="The email address to link to">
-	<cfargument name="name" type="string" required="false" default="" hint="A string to use as the link text ('Joe' or 'Support Department' for example)">
-	<cfargument name="encode" type="boolean" required="false" default="#application.wheels.functions.mailTo.encode#" hint="Pass true here to encode the email address, making it harder for bots to harvest it">
+	<cfargument name="name" type="string" required="false" default="" hint="A string to use as the link text ('Joe' or 'Support Department', for example)">
+	<cfargument name="encode" type="boolean" required="false" default="#application.wheels.functions.mailTo.encode#" hint="Pass `true` here to encode the email address, making it harder for bots to harvest it">
 	<cfscript>
 		var loc = {};
 		$insertDefaults(name="mailTo", reserved="href", input=arguments);

	<cfreturn request.wheels[arguments.handle]>
</cffunction>

<cffunction name="paginationLinks" returntype="string" access="public" output="false" hint="Builds and returns a string containing links to pages based on a paginated query. Uses `linkTo` internally to build the link so you need to pass in a route name, controller or action. All other `linkTo` arguments can of course be supplied as well in which case they are passed through directly to `linkTo`. If you have paginated more than one query in the controller you can use the `handle` argument to reference them (don't forget to pass in a `handle` to the `findAll` function in your controller first though).">
	<cfargument name="windowSize" type="numeric" required="false" default="#application.wheels.functions.paginationLinks.windowSize#" hint="The number of page links to show around the current page">
	<cfargument name="alwaysShowAnchors" type="boolean" required="false" default="#application.wheels.functions.paginationLinks.alwaysShowAnchors#" hint="Whether or not links to the first and last page should always be displayed">
	<cfargument name="anchorDivider" type="string" required="false" default="#application.wheels.functions.paginationLinks.anchorDivider#" hint="String to place next to the anchors on either side of the list">

<cffunction name="linkTo" returntype="string" access="public" output="false"
	hint="Creates a link to another page in your application. Pass in a route name to use your configured routes or a controller/action/key combination."
	examples=
	'
		##linkTo(text="Log Out", controller="account", action="logout")##
		-> <a href="/account/logout">Log Out</a>
		
		<!--- if you''re already in the "account" controller, Wheels will assume that''s where you want the link to go. --->
		##linkTo(text="Log Out", action="logout")##
		-> <a href="/account/logout">Log Out</a>
		
		##linkTo(text="View Post", controller="blog" action="post", key=99)##
		-> <a href="/blog/post/99">View Post</a>
		
		##linkTo(text="View Settings", action="settings", params="show=all&sort=asc")##
		-> <a href="/account/settings?show=all&amp;sort=asc">View Settings</a>
		
		<!--- given that a userProfile route has been configured in config/routes.cfm --->
		##linkTo(text="Joe''s Profile", route="userProfile", userName="joe")##
		-> <a href="/user/joe">Joe''s Profile</a>
	'
	categories="view-helper" chapters="linking-pages" functions="URLFor,buttonTo,mailTo">
	<cfargument name="text" type="string" required="false" default="" hint="The text content of the link">
	<cfargument name="confirm" type="string" required="false" default="" hint="Pass a message here to cause a JavaScript confirmation dialog box to pop up containing the message">
	<cfargument name="route" type="string" required="false" default="" hint="See documentation for @URLFor">
	<cfargument name="controller" type="string" required="false" default="" hint="See documentation for @URLFor">
	<cfargument name="action" type="string" required="false" default="" hint="See documentation for @URLFor">
	<cfargument name="key" type="any" required="false" default="" hint="See documentation for @URLFor">
	<cfargument name="params" type="string" required="false" default="" hint="See documentation for @URLFor">
	<cfargument name="anchor" type="string" required="false" default="" hint="See documentation for @URLFor">
	<cfargument name="onlyPath" type="boolean" required="false" default="#application.wheels.functions.linkTo.onlyPath#" hint="See documentation for @URLFor">
	<cfargument name="host" type="string" required="false" default="#application.wheels.functions.linkTo.host#" hint="See documentation for @URLFor">
	<cfargument name="protocol" type="string" required="false" default="#application.wheels.functions.linkTo.protocol#" hint="See documentation for @URLFor">
	<cfargument name="port" type="numeric" required="false" default="#application.wheels.functions.linkTo.port#" hint="See documentation for @URLFor">
	<cfscript>
		var loc = {};
		$insertDefaults(name="linkTo", reserved="href", input=arguments);
