From: Cash Costello <cash.costello@gmail.com>
Date: Sat, 5 Nov 2011 12:01:31 +0000 (-0400)
Subject: Refs #4053 improved documentation of page_handler()
X-Git-Url: https://gitweb.fluxo.info/?a=commitdiff_plain;h=0d35f463fbc4ce7d50b6c1540f3c50eb4263440e;p=lorea%2Felgg.git

Refs #4053 improved documentation of page_handler()
---

diff --git a/engine/lib/pagehandler.php b/engine/lib/pagehandler.php
index f331e2aae..aba921416 100644
--- a/engine/lib/pagehandler.php
+++ b/engine/lib/pagehandler.php
@@ -7,7 +7,11 @@
  */
 
 /**
- * Turns the current page over to the page handler, allowing registered handlers to take over.
+ * Routes the request to a registered page handler
+ *
+ * This function sets the context based on the handler name (first segment of the
+ * URL). It also triggers a plugin hook 'route', $handler so that plugins can
+ * modify the routing or handle a request.
  *
  * @param string $handler The name of the handler type (eg 'blog')
  * @param array  $page    The parameters to the page, as an array (exploded by '/' slashes)