 	<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).">
+<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/action/key combination. All other `linkTo` arguments can 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)"
+	examples=
+	'
+		<!--- controller code --->
+		<cfparam name="params.page" default="1">
+		<cfset allAuthors = model("author").findAll(page=params.page, perPage=25, order="lastName")>
+		
+		<!--- view code --->
+		<ul>
+		    <cfoutput query="all-authors">
+		        <li>##firstName## ##lastName##</li>
+		    </cfoutput>
+		</ul>
+		<cfoutput>##paginationLinks(action="listAuthors")##</cfoutput>
+		
+		<!--- view code --->
+		<cfoutput>##paginationLinks(action="listAuthors", windowSize=5)##</cfoutput>
+		
+		
+		<!--- controller code --->
+		<cfset allAuthors = model("author").findAll(handle="authQuery", page=5, order="id")>
+		
+		<!--- view code --->
+		<ul>
+		    <cfoutput>##paginationLinks(action="listAuthors", handle="authQuery", prependToLink="<li>", appendToLink="</li>")##</cfoutput>
+		</ul>
+		
+		
+		<!--- route setup in config/routes.cfm --->
+		<cfset addRoute(name="paginatedCommentListing", pattern="blog/[year]/[month]/[day]/[page]", controller="theBlog", action="stats")>
+		<cfset addRoute(name="commentListing", pattern="blog/[year]/[month]/[day]",  controller="theBlog", action="stats")>
+		
+		<!--- controller code --->
+		<cfparam name="params.page" default="1">
+		<cfset comments = model("comment").findAll(page=params.page, order="createdAt")>
+		
+		<!--- view code --->
+		<ul>
+		    <cfoutput>##paginationLinks(route="paginatedCommentListing", year=2009, month="feb", day=10)##</cfoutput>
+		</ul>
+	'
+	categories="view-helper" chapters="getting-paginated-data,displaying-links-for-pagination" functions="linkTo,findAll,URLFor">
 	<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">

	<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.">
	<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">
	<cfscript>
		var loc = {};
		$insertDefaults(name="mailTo", reserved="href", 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`."
	examples=''
	categories="view-helper">
	<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)
