From 5871b90da4b8be093d2a1fc0efdb59ed73173896 Mon Sep 17 00:00:00 2001
From: wangchunsheng <chunsheng@cnezsoft.com>
Date: Fri, 19 Nov 2010 03:46:38 +0000
Subject: [PATCH]  * change the comment of release module.

---
 module/release/control.php | 50 ++++++++++++++++++++++++++++++++------
 module/release/model.php   | 32 +++++++++++++++++++++---
 2 files changed, 71 insertions(+), 11 deletions(-)

diff --git a/module/release/control.php b/module/release/control.php
index 4b88f7431b..38a7db641a 100644
--- a/module/release/control.php
+++ b/module/release/control.php
@@ -11,7 +11,13 @@
  */
 class release extends control
 {
-   /* 公共操作。*/
+    /**
+     * Common actions.
+     * 
+     * @param  int    $productID 
+     * @access public
+     * @return void
+     */
     public function commonAction($productID)
     {
         $this->loadModel('product');
@@ -20,7 +26,13 @@ class release extends control
         $this->product->setMenu($this->product->getPairs(), $productID);
     }
 
-    /* 浏览发布列表。*/
+    /**
+     * Browse releases.
+     * 
+     * @param  int    $productID 
+     * @access public
+     * @return void
+     */
     public function browse($productID)
     {
         $this->commonAction($productID);
@@ -31,7 +43,13 @@ class release extends control
         $this->display();
     }
 
-    /* 添加release。*/
+    /**
+     * Create a release.
+     * 
+     * @param  int    $productID 
+     * @access public
+     * @return void
+     */
     public function create($productID)
     {
         if(!empty($_POST))
@@ -50,7 +68,13 @@ class release extends control
         $this->display();
     }
 
-    /* 编辑release。*/
+    /**
+     * Edit a release.
+     * 
+     * @param  int    $releaseID 
+     * @access public
+     * @return void
+     */
     public function edit($releaseID)
     {
         if(!empty($_POST))
@@ -76,7 +100,13 @@ class release extends control
         $this->display();
     }
                                                           
-    /* 查看release。*/
+    /**
+     * View a release.
+     * 
+     * @param  int    $releaseID 
+     * @access public
+     * @return void
+     */
     public function view($releaseID)
     {
         $release = $this->release->getById((int)$releaseID);
@@ -84,7 +114,6 @@ class release extends control
 
         $this->commonAction($release->product);
 
-        /* 赋值。*/
         $this->view->header->title = $this->lang->release->view;
         $this->view->position[]    = $this->lang->release->view;
         $this->view->release       = $release;
@@ -93,7 +122,14 @@ class release extends control
         $this->display();
     }
  
-    /* 删除release。*/
+    /**
+     * Delete a release.
+     * 
+     * @param  int    $releaseID 
+     * @param  string $confirm      yes|no
+     * @access public
+     * @return void
+     */
     public function delete($releaseID, $confirm = 'no')
     {
         if($confirm == 'no')
diff --git a/module/release/model.php b/module/release/model.php
index 531cdf940f..55227c76e9 100644
--- a/module/release/model.php
+++ b/module/release/model.php
@@ -13,7 +13,13 @@
 <?php
 class releaseModel extends model
 {
-    /* 获取release详细信息。*/
+    /**
+     * Get release by id.
+     * 
+     * @param  int    $releaseID 
+     * @access public
+     * @return object
+     */
     public function getByID($releaseID)
     {
         return $this->dao->select('t1.*, t2.name as buildName, t3.name as productName')
@@ -25,7 +31,13 @@ class releaseModel extends model
             ->fetch();
     }
 
-    /* 查找release列表。*/
+    /**
+     * Get list of releases.
+     * 
+     * @param  int    $productID 
+     * @access public
+     * @return array
+     */
     public function getList($productID)
     {
         return $this->dao->select('t1.*, t2.name as productName, t3.name as buildName')
@@ -38,7 +50,13 @@ class releaseModel extends model
             ->fetchAll();
     }
 
-    /* 创建。*/
+    /**
+     * Create a release.
+     * 
+     * @param  int    $productID 
+     * @access public
+     * @return int
+     */
     public function create($productID)
     {
         $release = fixer::input('post')
@@ -50,7 +68,13 @@ class releaseModel extends model
         if(!dao::isError()) return $this->dao->lastInsertID();
     }
 
-    /* 编辑。*/
+    /**
+     * Update a release.
+     * 
+     * @param  int    $releaseID 
+     * @access public
+     * @return void
+     */
     public function update($releaseID)
     {
         $oldRelease = $this->getByID($releaseID);