From 6e249b4ab5aa292d78cfaa9be9dce8706e27ad80 Mon Sep 17 00:00:00 2001
From: Brion Vibber <brion@pobox.com>
Date: Mon, 29 Nov 2010 11:57:27 -0800
Subject: doc comments on User::allowed_nickname

---
 classes/User.php | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/classes/User.php b/classes/User.php
index 964bc3e7f..92180a9fb 100644
--- a/classes/User.php
+++ b/classes/User.php
@@ -116,6 +116,16 @@ class User extends Memcached_DataObject
         return $result;
     }
 
+    /**
+     * Check whether the given nickname is potentially usable, or if it's
+     * excluded by any blacklists on this system.
+     *
+     * WARNING: INPUT IS NOT VALIDATED OR NORMALIZED. NON-NORMALIZED INPUT
+     * OR INVALID INPUT MAY LEAD TO FALSE RESULTS.
+     *
+     * @param string $nickname
+     * @return boolean true if clear, false if blacklisted
+     */
     static function allowed_nickname($nickname)
     {
         // XXX: should already be validated for size, content, etc.
-- 
cgit v1.2.3-54-g00ecf