[cosm] many cosmetic comment fixes, + ensure license and copyright everywhere

bureau/admin/mail_list.php

@@ -1,9 +1,5 @@
 <?php
 /*
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2000-2012 by the AlternC Development Team.
- https://alternc.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -19,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Purpose of file: listing of mail accounts for one domain.
- ----------------------------------------------------------------------
 */
 
+/**
+ * List the email account of a domain 
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 

bureau/admin/mail_manage_catchall.php

@@ -1,9 +1,5 @@
 <?php
 /*
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2000-2012 by the AlternC Development Team.
- https://alternc.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -19,10 +15,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Purpose of file: Manage catch-all
- ----------------------------------------------------------------------
 */
-require_once("../class/config.php");
+
+/**
+ * Manages the catch-all account of a domain for a user 
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */ 
+
+ require_once("../class/config.php");
 include_once("head.php");
 
 $fields = array (

bureau/admin/mail_undelete.php

@@ -1,9 +1,5 @@
 <?php
 /*
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2000-2012 by the AlternC Development Team.
- https://alternc.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -19,9 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Purpose of file: undelete one mailbox
- ----------------------------------------------------------------------
 */
+
+/**
+ * Undelete a user's mailbox
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 $fields = array (

bureau/admin/main.php

@@ -1,10 +1,5 @@
 <?php
 /*
- main.php
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2002-2017 by the AlternC Development Team.
- https://alternc.com/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -20,9 +15,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Purpose of file: Main page shown after login, display misc information
- ----------------------------------------------------------------------
 */
+
+/**
+ * Main page shown after a successful login of an account
+ * Displays misc informations
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 include_once("head.php");

bureau/admin/mem_admin.php

@@ -1,10 +1,5 @@
 <?php
 /*
- mem_admin.php
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2002-2017 by the AlternC Development Team.
- https://alternc.com/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -20,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag <benjamin@octopuce.com>
- Purpose of file: Manage administrators preferences
- ----------------------------------------------------------------------
 */
+
+/**
+ * Change the administrator's account preferences
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 $fields = array (

bureau/admin/mem_chgmail.php

@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: mem_chgmail.php,v 1.3 2003/06/10 08:18:26 root Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -23,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file:  Benjamin Sonntag
- Purpose of file: Change the email of a member step 1.
- ----------------------------------------------------------------------
 */
+
+/**
+ * Changes the email of an account, STEP 1
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 $fields = array (

bureau/admin/mem_cm.php

@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: mem_cm.php,v 1.6 2004/11/29 17:27:04 anonymous Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -23,11 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file:  Benjamin Sonntag
- Purpose of file: Change the email of a member step 2.
- ----------------------------------------------------------------------
 */
 
+/**
+ * Change the email of an account, STEP 2
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config_nochk.php");
 include_once("head.php");
 

bureau/admin/mem_cm2.php

@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: mem_cm2.php,v 1.5 2004/11/29 17:27:04 anonymous Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -23,11 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file:  Benjamin Sonntag
- Purpose of file: Change the email of a member step 3.
- ----------------------------------------------------------------------
 */
 
+/**
+ * Change the email of an account, STEP 3
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config_nochk.php");
 
 $fields = array (

bureau/admin/mem_logout.php

@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: mem_logout.php,v 1.3 2003/08/13 23:52:24 root Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -23,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file:
- Purpose of file:
- ----------------------------------------------------------------------
 */
+
+/**
+ * Logout a member.
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 $mem->del_session();

bureau/admin/mem_param.php

@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: mem_param.php,v 1.8 2004/07/23 14:03:57 anonymous Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -23,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file:  Benjamin Sonntag
- Purpose of file: Allow the customization of the user interface
- ----------------------------------------------------------------------
 */
+
+/**
+ * Customize the user's interface of AlternC
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 include_once("head.php");

bureau/admin/mem_passwd.php

@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: mem_passwd.php,v 1.1.1.1 2003/03/26 17:41:29 root Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -23,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file:
- Purpose of file:
- ----------------------------------------------------------------------
 */
+
+/**
+ * Changes a user account's password
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 $fields = array (

bureau/admin/menu.php

@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: menu.php,v 1.9 2005/01/18 22:16:10 anarcat Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -23,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file:
- Purpose of file:
- ----------------------------------------------------------------------
 */
+
+/**
+ * Main left menu of AlternC, uses Hooks 
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 // Getting logo

bureau/admin/piwik_user_dodel.php

@@ -17,6 +17,10 @@
  ----------------------------------------------------------------------
 */
 
+/**
+ * delete piwik users
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
 require_once("../class/config.php");
 
 $fields = array (

bureau/admin/piwik_useradmin.php

@@ -17,7 +17,12 @@
  ----------------------------------------------------------------------
 */
 
-require_once("../class/config.php");
+/**
+ * Manages piwik user accounts
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
+ require_once("../class/config.php");
 include_once("head.php");
 
 $fields = array (