From ade44744d724b1989ce33792e94284fabd8dfd6f Mon Sep 17 00:00:00 2001
From: nicolasconnault <nicolasconnault>
Date: Thu, 12 Apr 2007 05:56:30 +0000
Subject: [PATCH] Added a few more comments

---
 mod/forum/lib.php | 30 +++++++++++++++++++++++++++---
 1 file changed, 27 insertions(+), 3 deletions(-)

diff --git a/mod/forum/lib.php b/mod/forum/lib.php
index 38953033cb979..f6e936758634a 100644
--- a/mod/forum/lib.php
+++ b/mod/forum/lib.php
@@ -743,7 +743,16 @@ function forum_cron() {
 }
 
 /**
- * TODO document
+ * Builds and returns the body of the email notification in plain text.
+ *
+ * @param object $course
+ * @param object $forum
+ * @param object $discussion
+ * @param object $post
+ * @param object $userfrom
+ * @param object $userto
+ * @param boolean $bare
+ * @return string The email body in plain text format.
  */
 function forum_make_mail_text($course, $forum, $discussion, $post, $userfrom, $userto, $bare = false) {
     global $CFG, $USER;
@@ -804,7 +813,15 @@ function forum_make_mail_text($course, $forum, $discussion, $post, $userfrom, $u
 }
 
 /**
- * TODO document
+ * Builds and returns the body of the email notification in html format.
+ *
+ * @param object $course
+ * @param object $forum
+ * @param object $discussion
+ * @param object $post
+ * @param object $userfrom
+ * @param object $userto
+ * @return string The email text in HTML format
  */
 function forum_make_mail_html($course, $forum, $discussion, $post, $userfrom, $userto) {
     global $CFG;
@@ -845,8 +862,15 @@ function forum_make_mail_html($course, $forum, $discussion, $post, $userfrom, $u
 
     return $posthtml;
 }
+
+
 /**
- * TODO document
+ * 
+ * @param object $course
+ * @param object $user
+ * @param object $mod TODO this is not used in this function, refactor
+ * @param object $forum
+ * @return object A standard object with 2 variables: info (number of posts for this user) and time (last modified)
  */
 function forum_user_outline($course, $user, $mod, $forum) {