From f9fd0be9dee2377cdc1652ebe21d26c720b5d8e9 Mon Sep 17 00:00:00 2001
From: Dongsheng Cai <unoter@gmail.com>
Date: Fri, 13 Nov 2009 08:51:49 +0000
Subject: [PATCH] "MDL-17391, document file_type_to_ext class"

---
 lib/filelib.php | 20 +++++++++++++-------
 1 file changed, 13 insertions(+), 7 deletions(-)

diff --git a/lib/filelib.php b/lib/filelib.php
index 1330b6fb0e..c922dcc225 100644
--- a/lib/filelib.php
+++ b/lib/filelib.php
@@ -2752,17 +2752,20 @@ class curl_cache {
 }
 
 /**
- * @todo Document this class
+ * This class is used to parse lib/file/file_types.mm which help get file
+ * extensions by file types. 
+ * The file_types.mm file can be edited by freemind in graphic environment.
  *
  * @package moodlecore
  * @subpackage file
- * @copyright 1999 onwards Martin Dougiamas  {@link http://moodle.com}
+ * @copyright 2009 Dongsheng Cai <dongsheng@moodle.com>
  * @license http://www.gnu.org/copyleft/gpl.html GNU GPL v3 or later
  */
 class file_type_to_ext {
     /**
-     * @todo Document this function
-     * @global object
+     * Check file_types.mm file, setup variables
+     *
+     * @global object $CFG
      * @param string $file
      */
     public function __construct($file = '') {
@@ -2777,7 +2780,8 @@ class file_type_to_ext {
     }
 
     /**
-     * @todo Document this function
+     * A private function to browse xml nodes
+     *
      * @param array $parent
      * @param array $types
      */
@@ -2798,7 +2802,8 @@ class file_type_to_ext {
     }
 
     /**
-     * @todo Document this function
+     * A private function to select text nodes
+     *
      * @param array $parent
      */
     private function _select_nodes($parent){
@@ -2813,7 +2818,8 @@ class file_type_to_ext {
 
 
     /**
-     * @todo Document this function
+     * Get file extensions by file types names.
+     *
      * @param array $types
      * @return mixed
      */
-- 
2.39.5