never enough documentation

diff --git a/include/text.php b/include/text.php
index 38ac58a6c30461dab2ea7038baf5bf45e4a049d7..0f7d2f731c5328f53f8884e3f8d0945a916d5ce0 100755 (executable)
--- a/include/text.php
+++ b/include/text.php
@@ -675,6 +675,15 @@ function linkify($s) {
  * @Parameter: string $s
  *
  * Returns string
+ *
+ * It is expected that this function will be called using HTML text.
+ * We will escape text between HTML pre and code blocks from being 
+ * processed. 
+ * 
+ * At a higher level, the bbcode [nosmile] tag can be used to prevent this 
+ * function from being executed by the prepare_text() routine when preparing
+ * bbcode source for HTML display
+ *
  */
 
 if(! function_exists('smilies')) {