From 390eb15e7d00a0616d73cc86595182f099639644 Mon Sep 17 00:00:00 2001
From: friendica <info@friendica.com>
Date: Wed, 22 Feb 2012 01:50:06 -0800
Subject: [PATCH] never enough documentation

---
 include/text.php | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/include/text.php b/include/text.php
index 38ac58a6c3..0f7d2f731c 100755
--- 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')) {