Index: /bureau/class/m_sta2.php
===================================================================
--- /bureau/class/m_sta2.php	(revision 430)
+++ /bureau/class/m_sta2.php	(revision 577)
@@ -1,5 +1,5 @@
 <?php
 /*
- $Id: m_sta2.php,v 1.7 2004/10/24 20:05:19 anonymous Exp $
+ $Id: m_sta2.php,v 1.8 2005/03/07 20:57:20 benjamin Exp $
  ----------------------------------------------------------------------
  AlternC - Web Hosting System
@@ -28,12 +28,12 @@
  ----------------------------------------------------------------------
 */
+
 /**
-* Classe de gestion des statistiques web webalizer / apache des hébergés
+* This class manages raw Apache log file for the end users.
 * 
-* Cette classe permet de gérer les statistiques web générées par webalizer
-* dans la langue de votre choix, ainsi que les fichiers logs bruts d'apache.<br />
-* Copyleft {@link http://alternc.net/ AlternC Team}
+* This class allow each AlternC's account to get its raw apache log file every day.
+* The files are stored in the user space.
 * 
-* @copyright    AlternC-Team 2002-11-01 http://alternc.net/
+* @copyright    AlternC's Team 2002-2005 http://alternc.org/
 * 
 */
@@ -42,5 +42,5 @@
   /* ----------------------------------------------------------------- */
   /**
-   * Constructeur
+   * Constructor, dummy
    */
   function m_sta2() {
@@ -48,6 +48,7 @@
 
   /* ----------------------------------------------------------------- */
-  /**
-   * Nom du quota
+  /** Hook function that returns the quota names for this class
+   * 
+   * @return string the quota names for this class
    */
   function alternc_quota_names() {
@@ -57,7 +58,7 @@
 
   /* ----------------------------------------------------------------- */
-  /** Retourne la liste des domaines / sous-domaines autorisés pour le membre.
-   * 
-   * @return array retourne un tableau indexé des domaines / sous-domaines utilisables.
+  /** Returns the list of domains and/or subdomains for this account
+   * 
+   * @return array returns an array with all the domains / subdomains for this account.
    */
   function host_list() {
@@ -76,7 +77,7 @@
 
   /* ----------------------------------------------------------------- */
-  /** 
-   * Affiche des options select de la liste des noms de domaines autorisés pour
-   * le membre. sous forme de champs d'options (select)
+  /** Draw option html tags of ths allowed domains / subdomains for the account.
+   * 
+   * @param $current string The current selected value in the list
    */
   function select_host_list($current) {
@@ -90,4 +91,7 @@
   }
 
+  /* ----------------------------------------------------------------- */
+  /** Hook function that delete a user's raw stats.
+   */
   function alternc_del_member() {
     global $db,$err,$cuid;
@@ -98,7 +102,6 @@
 
   /* ----------------------------------------------------------------- */
-  /** 
-   * Fonction appellée par m_dom lorsqu'un domaine est supprimé.
-   * @param string $dom est le domaine à supprimer.
+  /** Hook function that delete a user's domain, called by m_dom.
+   * @param string $dom is the domain that is to be deleted.
    */
   function alternc_del_domain($dom) {
@@ -121,11 +124,11 @@
 
   /* ----------------------------------------------------------------- */
-  /** Retourne un tableau contenant les jeux de stats APACHE 
-   * d'un membre. Le tableau est de la forme
-   * $r[0-n]["id"] = numéros du jeu
-   * $r[0-n]["hostname"]= domaine concerné
-   * $r[0-n]["folder"]= Répertoire destination (dans le dossier du membre)
-   * 
-   * @return array Tableau de résultat, ou FALSE si une erreur est survenue
+  /** Returns an array with the user's raw stat list
+   * The returned array is as follow : 
+   * $r[0-n]["id"] = Id of the raw stat set.
+   * $r[0-n]["hostname"]= Domain
+   * $r[0-n]["folder"]= Destination's folder (in the user space)
+   * 
+   * @return array Returns the array or FALSE if an error occured.
    */
   function get_list_raw() {
@@ -136,5 +139,5 @@
     if ($db->num_rows()) {
       while ($db->next_record()) {
-	// On passe /var/alternc/html/u/user
+	// We skip /var/alternc/html/u/user
 	preg_match("/^\/var\/alternc\/html\/.\/[^\/]*\/(.*)/", $db->f("folder"),$match);
 	$r[]=array(
