From 4fd853c6ae70f008b10281dc7cbd94812a14f1cb Mon Sep 17 00:00:00 2001
From: Benjamin Sonntag <benjamin@sonntag.fr>
Date: Thu, 12 Oct 2017 17:54:48 +0200
Subject: [PATCH] [cosm] many cosmetic comment fixes, + ensure license and
 copyright everywhere

---
 bureau/admin/about.php                  | 22 +++++++++------------
 bureau/admin/adm_authip_whitelist.php   | 24 +++++++++++++++++++++++
 bureau/admin/adm_cancel.php             | 19 ++++++++----------
 bureau/admin/adm_db_servers.php         | 13 +++++++------
 bureau/admin/adm_deactivate.php         | 21 +++++++++-----------
 bureau/admin/adm_defquotas.php          | 20 +++++++------------
 bureau/admin/adm_del.php                | 12 +-----------
 bureau/admin/adm_dnsweberror.php        | 18 +++++++----------
 bureau/admin/adm_doadd.php              | 15 +++++++-------
 bureau/admin/adm_dodefquotas.php        | 20 +++++++------------
 bureau/admin/adm_dodel.php              | 19 ++++++++----------
 bureau/admin/adm_doedit.php             | 20 +++++++------------
 bureau/admin/adm_domlock.php            | 19 ++++++++----------
 bureau/admin/adm_doms.php               | 18 +++++++----------
 bureau/admin/adm_doms_def_type.php      | 26 +++++++++++++++++++++++++
 bureau/admin/adm_domstype.php           | 18 +++++++----------
 bureau/admin/adm_domstypedoedit.php     | 24 +++++++++++++++++++++++
 bureau/admin/adm_domstypeedit.php       | 18 +++++++----------
 bureau/admin/adm_domstyperegenerate.php | 24 +++++++++++++++++++++++
 bureau/admin/adm_donosu.php             | 18 +++++++----------
 bureau/admin/adm_dorenew.php            | 19 +++++++-----------
 bureau/admin/adm_dosu.php               | 18 +++++++----------
 bureau/admin/adm_edit.php               | 25 ++++++++----------------
 bureau/admin/adm_email.php              | 13 +++++++------
 bureau/admin/adm_list.php               | 16 +++++++--------
 bureau/admin/adm_lockpanel.php          | 18 +++++++----------
 bureau/admin/adm_login.php              | 18 +++++++----------
 bureau/admin/adm_mxaccount.php          | 20 +++++++++----------
 bureau/admin/adm_panel.php              |  6 ++++++
 bureau/admin/adm_passpolicy.php         | 15 +++++++-------
 bureau/admin/adm_quotadoedit.php        | 18 +++++++----------
 bureau/admin/adm_quotaedit.php          | 18 +++++++----------
 bureau/admin/adm_slavedns.php           | 19 ++++++++----------
 bureau/admin/adm_tld.php                | 19 ++++++++----------
 bureau/admin/adm_tldadd.php             | 19 ++++++++----------
 bureau/admin/adm_tlddoadd.php           | 19 ++++++++----------
 bureau/admin/adm_tlddoedit.php          | 18 +++++++----------
 bureau/admin/adm_tldedit.php            | 19 ++++++++----------
 bureau/admin/adm_update_domains.php     | 18 +++++++----------
 bureau/admin/adm_variables.php          | 18 +++++++----------
 bureau/admin/alternc_debugme.php        | 23 ++++++++++++++++++++++
 bureau/admin/bro_downloadfile.php       | 11 +++++++----
 bureau/admin/bro_editor.php             | 20 ++++++++-----------
 bureau/admin/bro_main.php               | 25 ++++++++++++------------
 bureau/admin/bro_pref.php               | 18 +++++++----------
 45 files changed, 416 insertions(+), 422 deletions(-)

diff --git a/bureau/admin/about.php b/bureau/admin/about.php
index 6966cdc1..61907875 100644
--- a/bureau/admin/about.php
+++ b/bureau/admin/about.php
@@ -1,13 +1,5 @@
 <?php
 /*
-$Id: adm_email.php,v 1.1 2005/09/05 10:55:48 arnodu59 Exp $
-----------------------------------------------------------------------
-AlternC - Web Hosting System
-Copyright (C) 2005 by the AlternC Development Team.
-http://alternc.org/
-----------------------------------------------------------------------
-Based on:
-Valentin Lacambre's web hosting softwares: http://altern.org/
 ----------------------------------------------------------------------
 LICENSE
 
@@ -23,11 +15,15 @@ GNU General Public License for more details.
 
 To read the license please visit http://www.gnu.org/copyleft/gpl.html
 ----------------------------------------------------------------------
-Original Author of file: Benjamin Sonntag
-Purpose of file: Show a form to edit a member
-----------------------------------------------------------------------
 */
-require_once("../class/config.php");
+
+/**
+ * About page
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
+ require_once("../class/config.php");
 
 include("head.php");
 
@@ -51,7 +47,7 @@ __("AlternC is an automatic hosting software suite. It features a PHP-based admi
 </li>
 
 <hr/>
-<p class="center"><a href="http://www.alternc.com" target="_blank"><img src="images/logo2.png" border="0" alt="AlternC" /></a>
+<p class="center"><a href="https://www.alternc.com" target="_blank"><img src="images/logo2.png" border="0" alt="AlternC" /></a>
 <br />
 <?php 
 __("You are currently using AlternC ");
diff --git a/bureau/admin/adm_authip_whitelist.php b/bureau/admin/adm_authip_whitelist.php
index 9411048d..60abc1b9 100755
--- a/bureau/admin/adm_authip_whitelist.php
+++ b/bureau/admin/adm_authip_whitelist.php
@@ -1,4 +1,28 @@
 <?php 
+/*
+ ----------------------------------------------------------------------
+ LICENSE
+
+ This program is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License (GPL)
+ as published by the Free Software Foundation; either version 2
+ of the License, or (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+
+ To read the license please visit http://www.gnu.org/copyleft/gpl.html
+ ----------------------------------------------------------------------
+*/
+
+/**
+ * Manages Whitelists in IP auth module 
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/adm_cancel.php b/bureau/admin/adm_cancel.php
index 3726b373..8e202100 100644
--- a/bureau/admin/adm_cancel.php
+++ b/bureau/admin/adm_cancel.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_login.php,v 1.4 2005/04/01 17:13:10 benjamin 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,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Connect a super-user to another account
- ----------------------------------------------------------------------
 */
+
+/**
+ * Page used by Administrator to forbid an impersonate session
+ * to go back to Admin rights.
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 setcookie('oldid','',0,'/');
diff --git a/bureau/admin/adm_db_servers.php b/bureau/admin/adm_db_servers.php
index f49d6879..f2d259ea 100644
--- a/bureau/admin/adm_db_servers.php
+++ b/bureau/admin/adm_db_servers.php
@@ -1,10 +1,6 @@
 <?php
 /*
 ----------------------------------------------------------------------
-AlternC - Web Hosting System
-Copyright (C) 2000-2012 by the AlternC Development Team.
-https://alternc.org/
-----------------------------------------------------------------------
 LICENSE
 
 This program is free software; you can redistribute it and/or
@@ -19,9 +15,14 @@ GNU General Public License for more details.
 
 To read the license please visit http://www.gnu.org/copyleft/gpl.html
 ----------------------------------------------------------------------
-Purpose of file: Show a form to edit a member
-----------------------------------------------------------------------
 */
+
+/**
+ * Show the list of MySQL db servers that this AlternC instance can use
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 include("head.php");
diff --git a/bureau/admin/adm_deactivate.php b/bureau/admin/adm_deactivate.php
index 01da441e..1ac69217 100755
--- a/bureau/admin/adm_deactivate.php
+++ b/bureau/admin/adm_deactivate.php
@@ -1,13 +1,5 @@
 <?php 
 /*
- $Id: adm_tld.php,v 1.4 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,10 +15,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Manage allowed TLD on the server
- ----------------------------------------------------------------------
 */
+
+/**
+ * Page used by administrators to deactivate an account
+ * and redirect its domains
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 include_once("head.php");
@@ -90,7 +87,7 @@ if (! ($confirmed ) ) {
   } 
 }
 
-# this string will contain an SQL request that will be printed at the end of the process and that can be used to reload the old domain configuration
+// this string will contain an SQL request that will be printed at the end of the process and that can be used to reload the old domain configuration
 $backup = "";
 
 # 1. list the domains of the user
diff --git a/bureau/admin/adm_defquotas.php b/bureau/admin/adm_defquotas.php
index 74f2d18f..a940195f 100755
--- a/bureau/admin/adm_defquotas.php
+++ b/bureau/admin/adm_defquotas.php
@@ -1,15 +1,5 @@
 <?php
 /*
- $Id: adm_defquotas.php,v 1.4 2006/01/24 05:03:30 joe Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2006 Le r�seau Koumbit Inc.
- http://koumbit.org/
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -25,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: Manage the default quotas
- ----------------------------------------------------------------------
 */
+
+/**
+ * Administrator page to manage default quotas for users
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_del.php b/bureau/admin/adm_del.php
index 47ac1c8e..a3d3c386 100644
--- a/bureau/admin/adm_del.php
+++ b/bureau/admin/adm_del.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_del.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,8 +15,6 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file:
- Purpose of file:
- ----------------------------------------------------------------------
 */
+
 ?>
diff --git a/bureau/admin/adm_dnsweberror.php b/bureau/admin/adm_dnsweberror.php
index 1e2395e4..a54f28e8 100644
--- a/bureau/admin/adm_dnsweberror.php
+++ b/bureau/admin/adm_dnsweberror.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_dnsweberror.php,v 1.4 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,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Alan Garcia
- Purpose of file: Report domains and websites having error in the DB
- ----------------------------------------------------------------------
 */
+
+/**
+ * Report DNS and WEBSITES being in error mode in the DB
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_doadd.php b/bureau/admin/adm_doadd.php
index 35409a7a..63e247db 100644
--- a/bureau/admin/adm_doadd.php
+++ b/bureau/admin/adm_doadd.php
@@ -1,10 +1,5 @@
 <?php
 /*
- adm_doadd.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
- Purpose of file: validate and create a new member
- ----------------------------------------------------------------------
 */
+
+/**
+ * Validate and create a new account
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_dodefquotas.php b/bureau/admin/adm_dodefquotas.php
index 881c45a5..ce5aab17 100755
--- a/bureau/admin/adm_dodefquotas.php
+++ b/bureau/admin/adm_dodefquotas.php
@@ -1,15 +1,5 @@
 <?php
 /*
- $Id: adm_dodefquotas.php,v 1.3 2006/01/24 05:03:30 joe Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2006 Le réseau Koumbit Inc.
- http://koumbit.org/
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -25,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: Manage the default quotas
- ----------------------------------------------------------------------
 */
+
+/**
+ * Change the default quotas
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_dodel.php b/bureau/admin/adm_dodel.php
index bdb8fdbe..5fa16ca3 100755
--- a/bureau/admin/adm_dodel.php
+++ b/bureau/admin/adm_dodel.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_dodel.php,v 1.2 2004/05/19 14:23:06 benjamin 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,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Delete a member
- ----------------------------------------------------------------------
 */
+
+/**
+ * Delete one or more AlternC's accounts
+ * of course, confirm the deletion
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_doedit.php b/bureau/admin/adm_doedit.php
index bea0b0bf..8e508277 100644
--- a/bureau/admin/adm_doedit.php
+++ b/bureau/admin/adm_doedit.php
@@ -1,15 +1,5 @@
 <?php
 /*
- $Id: adm_doedit.php,v 1.6 2006/01/24 05:03:30 joe Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2006 Le reseau Koumbit Inc.
- http://koumbit.org/
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -25,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: Edit a member's parameters
- ----------------------------------------------------------------------
 */
+
+/**
+ * Edit an account settings (name, password, etc.)
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_domlock.php b/bureau/admin/adm_domlock.php
index b3de275b..0203b2b7 100644
--- a/bureau/admin/adm_domlock.php
+++ b/bureau/admin/adm_domlock.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_domlock.php,v 1.1 2003/09/20 19:41:06 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,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Manage allowed TLD on the server
- ----------------------------------------------------------------------
 */
+
+/**
+ * Lock a domain on an account, forbid any dangerous / low-level change on it
+ * including removing the domain from the user account
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_doms.php b/bureau/admin/adm_doms.php
index 960f14d0..00a7eef6 100755
--- a/bureau/admin/adm_doms.php
+++ b/bureau/admin/adm_doms.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_doms.php,v 1.1 2003/09/20 19:41:06 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: Manage allowed TLD on the server
- ----------------------------------------------------------------------
 */
+
+/**
+ * List domains on the server and their DNS / Vhost compatibility
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_doms_def_type.php b/bureau/admin/adm_doms_def_type.php
index 541187ac..e325630b 100755
--- a/bureau/admin/adm_doms_def_type.php
+++ b/bureau/admin/adm_doms_def_type.php
@@ -1,4 +1,30 @@
 <?php
+/*
+ ----------------------------------------------------------------------
+ LICENSE
+
+ This program is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License (GPL)
+ as published by the Free Software Foundation; either version 2
+ of the License, or (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+
+ To read the license please visit http://www.gnu.org/copyleft/gpl.html
+ ----------------------------------------------------------------------
+*/
+
+/**
+ * Manages default domain types, 
+ * they are the subdomains automatically installed on a domain when you host it.
+ * AlternC's modules such as squirrelmail or roundcube may create new ones, you'll see them here
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_domstype.php b/bureau/admin/adm_domstype.php
index 4de3aa13..2315874f 100644
--- a/bureau/admin/adm_domstype.php
+++ b/bureau/admin/adm_domstype.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_tld.php,v 1.4 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,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Alan Garcia
- Purpose of file: Manage domain types on the server 
- ----------------------------------------------------------------------
 */
+
+/**
+ * Manages domain types on the server
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_domstypedoedit.php b/bureau/admin/adm_domstypedoedit.php
index 94a29288..eccb5ee2 100644
--- a/bureau/admin/adm_domstypedoedit.php
+++ b/bureau/admin/adm_domstypedoedit.php
@@ -1,4 +1,28 @@
 <?php
+/*
+ ----------------------------------------------------------------------
+ LICENSE
+
+ This program is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License (GPL)
+ as published by the Free Software Foundation; either version 2
+ of the License, or (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+
+ To read the license please visit http://www.gnu.org/copyleft/gpl.html
+ ----------------------------------------------------------------------
+*/
+
+/**
+ * Change a domain type on the server
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 if (!$admin->enabled) {
     $msg->raise("ERROR", "admin", _("This page is restricted to authorized staff"));
diff --git a/bureau/admin/adm_domstypeedit.php b/bureau/admin/adm_domstypeedit.php
index a07a724f..5fadf67d 100755
--- a/bureau/admin/adm_domstypeedit.php
+++ b/bureau/admin/adm_domstypeedit.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_domstypeedit.php,v 1.6 2006/01/12 01:10:48 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: Alan Garcia
- Purpose of file: Edit the domain types
- ----------------------------------------------------------------------
 */
+
+/**
+ * Form to update a domain type on the server
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 if (!$admin->enabled) {
     $msg->raise("ERROR", "admin", _("This page is restricted to authorized staff"));
diff --git a/bureau/admin/adm_domstyperegenerate.php b/bureau/admin/adm_domstyperegenerate.php
index 78bec7d4..30e21e78 100644
--- a/bureau/admin/adm_domstyperegenerate.php
+++ b/bureau/admin/adm_domstyperegenerate.php
@@ -1,4 +1,28 @@
 <?php
+/*
+ ----------------------------------------------------------------------
+ LICENSE
+
+ This program is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License (GPL)
+ as published by the Free Software Foundation; either version 2
+ of the License, or (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+
+ To read the license please visit http://www.gnu.org/copyleft/gpl.html
+ ----------------------------------------------------------------------
+*/
+
+/**
+ * Regenerate all subdomains DNS and VHOST informations of a specific domain type
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 if (!$admin->enabled) {
     $msg->raise("ERROR", "admin", _("This page is restricted to authorized staff"));
diff --git a/bureau/admin/adm_donosu.php b/bureau/admin/adm_donosu.php
index 3a71c700..f51eb5b1 100644
--- a/bureau/admin/adm_donosu.php
+++ b/bureau/admin/adm_donosu.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_donosu.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: Benjamin Sonntag
- Purpose of file: Transform an account from Normal to Administrator
- ----------------------------------------------------------------------
 */
+
+/**
+ * Transform an administrator account to become a normal one
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_dorenew.php b/bureau/admin/adm_dorenew.php
index 07c4fb7b..437f3c3c 100644
--- a/bureau/admin/adm_dorenew.php
+++ b/bureau/admin/adm_dorenew.php
@@ -1,15 +1,5 @@
 <?php
 /*
- $Id: adm_dorenew.php,v 1.6 2006/01/24 05:03:30 joe Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2006 Le réseau Koumbit Inc.
- http://koumbit.org/
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -25,9 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Purpose of file: Renew an account for the specified period
- ----------------------------------------------------------------------
 */
+
+/**
+ * Renew an account's access for a specific period
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_dosu.php b/bureau/admin/adm_dosu.php
index 80f4a049..88ae79fc 100644
--- a/bureau/admin/adm_dosu.php
+++ b/bureau/admin/adm_dosu.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_dosu.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: Benjamin Sonntag
- Purpose of file: Transform an account from Normal to Administrator
- ----------------------------------------------------------------------
 */
+
+/**
+ * Change an account to make it an administrator account
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_edit.php b/bureau/admin/adm_edit.php
index af24901f..d561214d 100755
--- a/bureau/admin/adm_edit.php
+++ b/bureau/admin/adm_edit.php
@@ -1,15 +1,5 @@
 <?php
 /*
- $Id: adm_edit.php,v 1.13 2006/01/24 05:03:30 joe Exp $
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2006 Le r�seau Koumbit Inc.
- http://koumbit.org/
- Copyright (C) 2002 by the AlternC Development Team.
- http://alternc.org/
- ----------------------------------------------------------------------
- Based on:
- Valentin Lacambre's web hosting softwares: http://altern.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -25,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: Show a form to edit a member
- ----------------------------------------------------------------------
 */
+
+/**
+ * Show a form to edit an account
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
@@ -65,9 +59,6 @@ echo $msg->msg_html_all();
 ?>
 <form method="post" action="adm_doedit.php" name="main" id="main" autocomplete="off">
   <?php csrf_get(); ?>
-<!-- honeypot fields -->
-<input type="text" style="display: none" id="fakeUsername" name="fakeUsername" value="" />
-<input type="password" style="display: none" id="fakePassword" name="fakePassword" value="" />
 
 <table class="tedit">
 <tr>
@@ -150,7 +141,7 @@ echo $msg->msg_html_all();
 </tr>
 </table>
 </form>
-<?php } /* Renouvellement */ ?>
+<?php } /* Renewal */ ?>
 
 <p>
 <?php
diff --git a/bureau/admin/adm_email.php b/bureau/admin/adm_email.php
index eda7d174..89636d0c 100755
--- a/bureau/admin/adm_email.php
+++ b/bureau/admin/adm_email.php
@@ -1,10 +1,6 @@
 <?php
 /*
 ----------------------------------------------------------------------
-AlternC - Web Hosting System
-Copyright (C) 2000-2012 by the AlternC Development Team.
-https://alternc.org/
-----------------------------------------------------------------------
 LICENSE
 
 This program is free software; you can redistribute it and/or
@@ -19,9 +15,14 @@ GNU General Public License for more details.
 
 To read the license please visit http://www.gnu.org/copyleft/gpl.html
 ----------------------------------------------------------------------
-Purpose of file: Show a form to edit a member
-----------------------------------------------------------------------
 */
+
+/**
+ * Show a form to send a mail to another account's owner
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 include("head.php");
diff --git a/bureau/admin/adm_list.php b/bureau/admin/adm_list.php
index 89bcdd22..985cd275 100755
--- a/bureau/admin/adm_list.php
+++ b/bureau/admin/adm_list.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,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Show the member list
- ----------------------------------------------------------------------
  */
+
+/**
+ * Show the list of all accounts on AlternC, or those created by a subadmin
+ * allow to impersonate, edit the account, change the quotas
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/adm_lockpanel.php b/bureau/admin/adm_lockpanel.php
index e3b21076..b887975e 100644
--- a/bureau/admin/adm_lockpanel.php
+++ b/bureau/admin/adm_lockpanel.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_tld.php,v 1.4 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,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Alan Garcia
- Purpose of file: Manage domain types on the server 
- ----------------------------------------------------------------------
 */
+
+/**
+ * Lock the panel, allowing no access to it, except by admins
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled || $cuid!=2000) {
diff --git a/bureau/admin/adm_login.php b/bureau/admin/adm_login.php
index cee4c0a8..94105c6f 100644
--- a/bureau/admin/adm_login.php
+++ b/bureau/admin/adm_login.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_login.php,v 1.4 2005/04/01 17:13:10 benjamin 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: Connect a super-user to another account
- ----------------------------------------------------------------------
 */
+
+/**
+ * Any ADMIN account can impersonate to any other account by using this page.
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 /*
diff --git a/bureau/admin/adm_mxaccount.php b/bureau/admin/adm_mxaccount.php
index 5bf1b7a1..70d72bfe 100755
--- a/bureau/admin/adm_mxaccount.php
+++ b/bureau/admin/adm_mxaccount.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_mxacount.php,v 1.2 2006/02/17 18:57:02 olivier 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,16 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Manage list of allowed accounts for secondary mx
- ----------------------------------------------------------------------
 */
+
+/**
+ * Manage the list of allowed accounts to operate as secondary MX
+ * those account are allowed to list the hosted domains
+ * to configure their postfix as a secondary MX
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_panel.php b/bureau/admin/adm_panel.php
index 3e9b8b47..ee5d9f41 100644
--- a/bureau/admin/adm_panel.php
+++ b/bureau/admin/adm_panel.php
@@ -17,6 +17,12 @@
  ----------------------------------------------------------------------
 */
 
+/**
+ * Administrator misc. settings
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_passpolicy.php b/bureau/admin/adm_passpolicy.php
index 20e5646e..488fcd92 100755
--- a/bureau/admin/adm_passpolicy.php
+++ b/bureau/admin/adm_passpolicy.php
@@ -1,10 +1,5 @@
 <?php
 /*
- adm_passpolicy.php
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2002-2010 by the AlternC Development Team.
- http://alternc.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -20,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: Manage the password policy for AlternC
- ----------------------------------------------------------------------
 */
+
+/**
+ * Manages password policy for misc. services on AlternC (ftp, mail etc.)
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_quotadoedit.php b/bureau/admin/adm_quotadoedit.php
index 3c010d33..f984de2c 100644
--- a/bureau/admin/adm_quotadoedit.php
+++ b/bureau/admin/adm_quotadoedit.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_quotadoedit.php,v 1.3 2004/10/24 20:09:21 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: Edit a member's quotas
- ----------------------------------------------------------------------
 */
+
+/**
+ * Edit an account's quotas
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_quotaedit.php b/bureau/admin/adm_quotaedit.php
index aea60efa..b7338752 100755
--- a/bureau/admin/adm_quotaedit.php
+++ b/bureau/admin/adm_quotaedit.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_quotaedit.php,v 1.4 2004/10/24 20:09:21 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: Show the form to edit the user's quota
- ----------------------------------------------------------------------
 */
+
+/** 
+ * Show the form used to update users' quotas
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/adm_slavedns.php b/bureau/admin/adm_slavedns.php
index beea1005..69ca1d7e 100755
--- a/bureau/admin/adm_slavedns.php
+++ b/bureau/admin/adm_slavedns.php
@@ -1,13 +1,5 @@
 <?php
 /*
-   $Id: adm_slaveip.php,v 1.2 2004/06/02 13:03:13 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,15 @@
 
    To read the license please visit http://www.gnu.org/copyleft/gpl.html
    ----------------------------------------------------------------------
-   Original Author of file: Benjamin Sonntag
-   Purpose of file: Manage list of allowed ip for zone transfers
-   ----------------------------------------------------------------------
  */
+
+/**
+ * Manage the list of SLAVE DNS machines account and IPs
+ * used for the transfer of zones in Bind and the list of domains in domlist.php
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_tld.php b/bureau/admin/adm_tld.php
index b81ecbc4..48049a6c 100755
--- a/bureau/admin/adm_tld.php
+++ b/bureau/admin/adm_tld.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_tld.php,v 1.4 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,10 +15,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Manage allowed TLD on the server
- ----------------------------------------------------------------------
 */
+
+/**
+ * Manages Allowed TLD's to be installed as domain names on the server
+ * soon deprecated due to all those new TLDs 
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/  
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_tldadd.php b/bureau/admin/adm_tldadd.php
index 10fbb40a..3de4249f 100755
--- a/bureau/admin/adm_tldadd.php
+++ b/bureau/admin/adm_tldadd.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_tldadd.php,v 1.3 2003/06/10 12:14:09 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,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Manage allowed TLD on the server
- ----------------------------------------------------------------------
 */
+
+/**
+ * Manage allowed TLDs on the server
+ * soon deprecated
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_tlddoadd.php b/bureau/admin/adm_tlddoadd.php
index bca99777..1cd2df59 100644
--- a/bureau/admin/adm_tlddoadd.php
+++ b/bureau/admin/adm_tlddoadd.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_tlddoadd.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,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Manage allowed TLD on the server
- ----------------------------------------------------------------------
 */
+
+/**
+ * Manages allowed TLDs on the server
+ * soon deprecated
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_tlddoedit.php b/bureau/admin/adm_tlddoedit.php
index d699fc34..aebda638 100644
--- a/bureau/admin/adm_tlddoedit.php
+++ b/bureau/admin/adm_tlddoedit.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_tlddoedit.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: Benjamin Sonntag
- Purpose of file: Manage allowed TLD on the server
- ----------------------------------------------------------------------
 */
+
+/** 
+ * Manage allowed TLDs to be installed as domain on the server
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/  
+ */
+
 require_once("../class/config.php");
 $fields = array (
         "tld"                 => array ("post", "string", ""),
diff --git a/bureau/admin/adm_tldedit.php b/bureau/admin/adm_tldedit.php
index 981ca5f0..0b58ca39 100755
--- a/bureau/admin/adm_tldedit.php
+++ b/bureau/admin/adm_tldedit.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_tldedit.php,v 1.2 2003/06/10 12:14:09 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,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Manage allowed TLD on the server
- ----------------------------------------------------------------------
 */
+
+/**
+ * Manage allow TLDs domains to be installed here
+ * soon deprecated
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/  
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_update_domains.php b/bureau/admin/adm_update_domains.php
index 84871ab2..f38a4c65 100644
--- a/bureau/admin/adm_update_domains.php
+++ b/bureau/admin/adm_update_domains.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_tld.php,v 1.4 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,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Alan Garcia
- Purpose of file: Manage domain types on the server 
- ----------------------------------------------------------------------
 */
+
+/**
+ * Launch update-domaines.sh crontab through admin account and inotify
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/  
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/adm_variables.php b/bureau/admin/adm_variables.php
index 4ad8ba7e..4507dafc 100755
--- a/bureau/admin/adm_variables.php
+++ b/bureau/admin/adm_variables.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: adm_variables.php,v 1.1 2005/01/19 06:09:36 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: Benjamin Sonntag
- Purpose of file: Manage allowed TLD on the server
- ----------------------------------------------------------------------
 */
+
+/**
+ * Manages global variables of AlternC
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/  
+ */
+
 require_once("../class/config.php");
 
 if (!$admin->enabled) {
diff --git a/bureau/admin/alternc_debugme.php b/bureau/admin/alternc_debugme.php
index 53eba554..85fcb651 100644
--- a/bureau/admin/alternc_debugme.php
+++ b/bureau/admin/alternc_debugme.php
@@ -1,4 +1,27 @@
 <?php
+/*
+ ----------------------------------------------------------------------
+ LICENSE
+
+ This program is free software; you can redistribute it and/or
+ modify it under the terms of the GNU General Public License (GPL)
+ as published by the Free Software Foundation; either version 2
+ of the License, or (at your option) any later version.
+
+ This program is distributed in the hope that it will be useful,
+ but WITHOUT ANY WARRANTY; without even the implied warranty of
+ MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ GNU General Public License for more details.
+
+ To read the license please visit http://www.gnu.org/copyleft/gpl.html
+ ----------------------------------------------------------------------
+*/
+
+/**
+ * Manage debug mode that admins can enable
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/  
+ */
 
 require_once("../class/config.php");
 
diff --git a/bureau/admin/bro_downloadfile.php b/bureau/admin/bro_downloadfile.php
index e190bc4c..eec34cf3 100644
--- a/bureau/admin/bro_downloadfile.php
+++ b/bureau/admin/bro_downloadfile.php
@@ -1,9 +1,5 @@
 <?php
 /*
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2000-2012 by the AlternC Development Team.
- https://alternc.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -20,6 +16,13 @@
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
 */
+
+/**
+ * File downloader of AlternC file browser.
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/  
+ */
+
 require_once("../class/config.php");
 
 $fields = array (
diff --git a/bureau/admin/bro_editor.php b/bureau/admin/bro_editor.php
index 74412398..7fc5ac71 100755
--- a/bureau/admin/bro_editor.php
+++ b/bureau/admin/bro_editor.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: bro_editor.php,v 1.5 2005/05/03 14:49:06 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,11 +15,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Editor of the browser
- ----------------------------------------------------------------------
 */
-require_once("../class/config.php");
+
+/**
+ * File editor part of AlternC file manager / browser.
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/  
+ */
+
+ require_once("../class/config.php");
 
 // We check it ourself : not fatal
 define("NOCSRF",true);
diff --git a/bureau/admin/bro_main.php b/bureau/admin/bro_main.php
index 575e8a98..af65598e 100755
--- a/bureau/admin/bro_main.php
+++ b/bureau/admin/bro_main.php
@@ -1,13 +1,5 @@
 <?php
 /*
-   $Id: bro_main.php,v 1.11 2004/09/06 18:14:36 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,12 +15,19 @@
 
    To read the license please visit http://www.gnu.org/copyleft/gpl.html
    ----------------------------------------------------------------------
-   Original Author of file: Benjamin Sonntag, Remi
-   Purpose of file: Online file Browser of AlternC
-   TODO : Voir ??? + D�placer / Copier 
-   ----------------------------------------------------------------------
  */
-require_once("../class/config.php");
+
+/**
+ * A file browser / manager for AlternC
+ * Warning: complex spaghetti-style code below.
+ * allow an account user to browse files, move, copy, upload, rename,
+ * and set permissions
+ * also, uncompress tarballs and zips, and import SQL files
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/  
+ */
+
+ require_once("../class/config.php");
 include_once ("head.php");
 
 $fields = array (
diff --git a/bureau/admin/bro_pref.php b/bureau/admin/bro_pref.php
index 1d03e93b..21dee960 100755
--- a/bureau/admin/bro_pref.php
+++ b/bureau/admin/bro_pref.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: bro_pref.php,v 1.2 2003/06/10 06:45:16 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: Configuration of the file browser
- ----------------------------------------------------------------------
 */
+
+/**
+ * Form to set the preferences of the file browser of AlternC
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/
+ */
+
 require_once("../class/config.php");
 
 $fields = array (