updated all doc comments to phpDocumentor format

libs/plugins/modifier.truncate.php

@@ -1,14 +1,26 @@
 <?php
-
-/*
+/**
  * Smarty plugin
- * -------------------------------------------------------------
- * Type:     modifier
- * Name:     truncate
+ * @package Smarty
+ * @subpackage plugins
+ */
+
+
+/**
+ * Smarty truncate modifier plugin
+ *
+ * Type:     modifier<br>
+ * Name:     truncate<br>
  * Purpose:  Truncate a string to a certain length if necessary,
  *           optionally splitting in the middle of a word, and 
  *           appending the $etc string.
- * -------------------------------------------------------------
+ * @link http://smarty.php.net/manual/en/language.modifier.truncate.php
+ *          truncate (Smarty online manual)
+ * @param string
+ * @param integer
+ * @param string
+ * @param boolean
+ * @return string
  */
 function smarty_modifier_truncate($string, $length = 80, $etc = '...',
                                   $break_words = false)