From 1a6195b4285e2ce05181ab11368b12d60c5920ea Mon Sep 17 00:00:00 2001
From: Dongsheng Cai <unoter@gmail.com>
Date: Fri, 29 Jan 2010 05:50:40 +0000
Subject: [PATCH] "MDL-21443, update phpdocs"

---
 repository/lib.php | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

diff --git a/repository/lib.php b/repository/lib.php
index 872a7db89de..68d71191d87 100644
--- a/repository/lib.php
+++ b/repository/lib.php
@@ -798,11 +798,16 @@ abstract class repository {
      * @global object $DB
      * @global object $CFG
      * @global object $USER
+     * @global object $OUTPUT
      * @param string $filepath file path in download folder
      * @param string $name file name
      * @param integer $itemid item id to identify a file in filepool
      * @param string $filearea file area
-     * @return array information of file in file pool
+     * @return array containing the following keys:
+     *           icon
+     *           file
+     *           id
+     *           url
      */
     public static function move_to_filepool($thefile, $name, $itemid, $filepath = '/', $filearea = 'user_draft') {
         global $DB, $CFG, $USER, $OUTPUT;
@@ -1453,7 +1458,20 @@ abstract class repository {
      *
      * @param string $parent The parent path, this parameter can
      * a folder name, or a identification of folder
-     * @return array the list of files, including meta infomation
+     * @return array the list of files, including meta infomation, containing the following keys
+     *           manage, url to manage url
+     *           client_id
+     *           login, login form
+     *           repo_id, active repository id
+     *           login_btn_action, the login button action
+     *           login_btn_label, the login button label
+     *           total, number of results
+     *           perpage, items per page
+     *           page
+     *           pages, total pages
+     *           search_result, is it a search result?
+     *           list, file list
+     *           path, current path and parent path
      */
     public function get_listing($path = '', $page = '') {
     }