 	<cfreturn loc.returnValue>
 </cffunction>
 
-<cffunction name="buttonTo" returntype="string" access="public" output="false" hint="Creates a form containing a single button that submits to the URL. The URL is built the same way as the `linkTo` function.">
-	<cfargument name="text" type="string" required="false" default="#application.wheels.functions.buttonTo.text#" hint="See documentation for `linkTo`">
-	<cfargument name="confirm" type="string" required="false" default="#application.wheels.functions.buttonTo.confirm#" hint="See documentation for `linkTo`">
+<cffunction name="buttonTo" returntype="string" access="public" output="false"
+	hint="Creates a form containing a single button that submits to the URL. The URL is built the same way as the `linkTo` function."
+	examples=
+	'
+		##buttonTo(text="Delete Account", action="perFormDelete", disabled="Wait...")##
+	'
+	categories="view-helper" functions="URLFor,linkTo,mailTo">
+	<cfargument name="text" type="string" required="false" default="#application.wheels.functions.buttonTo.text#" hint="The text content of the button">
+	<cfargument name="confirm" type="string" required="false" default="#application.wheels.functions.buttonTo.confirm#" hint="See documentation for @linkTo">
 	<cfargument name="image" type="string" required="false" default="#application.wheels.functions.buttonTo.image#" hint="If you want to use an image for the button pass in the link to it here (relative from the `images` folder)">
-	<cfargument name="disable" type="any" required="false" default="#application.wheels.functions.buttonTo.disable#" hint="Pass in `true` if you want the button to be disabled when clicked (can help prevent multiple clicks) or pass in a string if you want the button disabled and the text on the button updated (to 'please wait...' for example)">
-	<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.buttonTo.onlyPath#" hint="See documentation for `URLFor`">
-	<cfargument name="host" type="string" required="false" default="#application.wheels.functions.buttonTo.host#" hint="See documentation for `URLFor`">
-	<cfargument name="protocol" type="string" required="false" default="#application.wheels.functions.buttonTo.protocol#" hint="See documentation for `URLFor`">
-	<cfargument name="port" type="numeric" required="false" default="#application.wheels.functions.buttonTo.port#" hint="See documentation for `URLFor`">
+	<cfargument name="disable" type="any" required="false" default="#application.wheels.functions.buttonTo.disable#" hint="Pass in `true` if you want the button to be disabled when clicked (can help prevent multiple clicks), or pass in a string if you want the button disabled and the text on the button updated (to 'please wait...', for example)">
+	<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.buttonTo.onlyPath#" hint="See documentation for @URLFor">
+	<cfargument name="host" type="string" required="false" default="#application.wheels.functions.buttonTo.host#" hint="See documentation for @URLFor">
+	<cfargument name="protocol" type="string" required="false" default="#application.wheels.functions.buttonTo.protocol#" hint="See documentation for @URLFor">
+	<cfargument name="port" type="numeric" required="false" default="#application.wheels.functions.buttonTo.port#" hint="See documentation for @URLFor">
 	<cfscript>
 		var loc = {};
 		$insertDefaults(name="buttonTo", reserved="method", input=arguments);

	<cfreturn loc.returnValue>
</cffunction>

<cffunction name="pagination" returntype="struct" access="public" output="false" hint="Returns a struct with information about the specificed paginated query. The available variables are `currentPage`, `totalPages` and `totalRecords`.">
	<cfargument name="handle" type="string" required="false" default="query" hint="The handle given to the query to return pagination information for">
	<cfscript>
		if (application.wheels.showErrorInformation)

<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);
