From 90c7fd21c8cbdae956af5dd016207c5e65ccbad3 Mon Sep 17 00:00:00 2001
From: Benjamin Sonntag <benjamin@sonntag.fr>
Date: Wed, 11 Oct 2017 11:58:04 +0200
Subject: [PATCH] [cosm] many cosmetic comment fixes, + ensure license and
 copyright everywhere

---
 bureau/admin/adm_add.php                    | 17 ++++----
 bureau/admin/bro_tgzdown.php                | 19 ++++-----
 bureau/admin/bro_view.php                   | 18 ++++----
 bureau/admin/browseforfolder2.php           | 46 +++++++++------------
 bureau/admin/cron.php                       | 24 +++++++++++
 bureau/admin/dom_add.php                    | 18 ++++----
 bureau/admin/dom_defdel.php                 | 31 +++++++++++++-
 bureau/admin/dom_dnsdump.php                | 24 +++++++++++
 bureau/admin/dom_doadd.php                  | 18 ++++----
 bureau/admin/dom_dodel.php                  | 18 ++++----
 bureau/admin/dom_edit.inc.php               | 28 +++++++++++--
 bureau/admin/dom_edit.php                   | 29 +++++--------
 bureau/admin/dom_editdns.php                | 20 ++++-----
 bureau/admin/dom_import.php                 | 18 ++++----
 bureau/admin/dom_subdel.php                 | 18 ++++----
 bureau/admin/dom_subdodel.php               | 20 ++++-----
 bureau/admin/dom_subdoedit.php              | 20 ++++-----
 bureau/admin/dom_subedit.php                | 18 ++++----
 bureau/admin/dom_substatus.php              | 28 ++++++++++++-
 bureau/admin/domlist.php                    | 19 ++++-----
 bureau/admin/foot.php                       | 26 ++++++++++++
 bureau/admin/ftp_del.php                    | 19 ++++-----
 bureau/admin/ftp_doedit.php                 | 18 ++++----
 bureau/admin/ftp_edit.php                   | 18 ++++----
 bureau/admin/ftp_list.php                   | 18 ++++----
 bureau/admin/ftp_switch_enable.php          |  9 ++--
 bureau/admin/head.php                       | 13 +++---
 bureau/admin/hta_add.php                    | 18 ++++----
 bureau/admin/hta_adduser.php                | 23 ++++-------
 bureau/admin/hta_del.php                    | 22 ++++------
 bureau/admin/hta_doadd.php                  | 19 ++++-----
 bureau/admin/hta_doadduser.php              | 18 ++++----
 bureau/admin/hta_dodeluser.php              | 18 ++++----
 bureau/admin/hta_doedituser.php             | 18 ++++----
 bureau/admin/hta_edit.php                   | 18 ++++----
 bureau/admin/hta_edituser.php               | 18 ++++----
 bureau/admin/hta_list.php                   | 18 ++++----
 bureau/admin/index.php                      | 14 ++++---
 bureau/admin/ip_main.php                    | 25 +++++++++++
 bureau/admin/login.php                      | 12 +-----
 bureau/admin/logs_download.php              | 18 ++++----
 bureau/admin/logs_list.php                  | 19 ++++-----
 bureau/admin/logs_tail.php                  | 19 ++++-----
 bureau/admin/mail_del.php                   | 15 +++----
 bureau/admin/mail_doadd.php                 | 13 +++---
 bureau/admin/mail_doedit.php                | 11 +++--
 bureau/admin/mail_edit.php                  | 13 +++---
 bureau/admin/mailautoconfig_outlook.php     | 31 +++++++++++++-
 bureau/admin/mailautoconfig_thunderbird.php | 31 +++++++++++++-
 49 files changed, 536 insertions(+), 447 deletions(-)

diff --git a/bureau/admin/adm_add.php b/bureau/admin/adm_add.php
index d427cfa5..bb59bb5f 100755
--- a/bureau/admin/adm_add.php
+++ b/bureau/admin/adm_add.php
@@ -1,10 +1,5 @@
 <?php
 /*
- adm_add.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: new Member managment
- ----------------------------------------------------------------------
 */
+
+/**
+ * Form to add a new account to AlternC
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
@@ -33,7 +32,7 @@ if (!$admin->enabled) {
 	exit();
 }
 
-$fields = array (
+<$fields = array (
 	"canpass"    => array ("post", "integer", 1),
 	"login"      => array ("post", "string", null),
 	"pass"       => array ("post", "string", null),
diff --git a/bureau/admin/bro_tgzdown.php b/bureau/admin/bro_tgzdown.php
index 644472db..2ed65c36 100644
--- a/bureau/admin/bro_tgzdown.php
+++ b/bureau/admin/bro_tgzdown.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: bro_tgzdown.php,v 1.2 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,10 +15,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Sonntag Benjamin
- Purpose of file: Return the current folder in a compressed file
- ----------------------------------------------------------------------
 */
+
+/**
+ * Returns the current folder's in compressed format,
+ * used from the File Browser
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 $fields = array (
diff --git a/bureau/admin/bro_view.php b/bureau/admin/bro_view.php
index 8badd02d..05dc7f72 100644
--- a/bureau/admin/bro_view.php
+++ b/bureau/admin/bro_view.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: bro_view.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: Show a file passed in the URL Name...
- ----------------------------------------------------------------------
 */
+
+/**
+ * Send the content of a file to a user, used by the File Browser
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 $bro->content_send(dirname($PATH_INFO),basename($PATH_INFO));
diff --git a/bureau/admin/browseforfolder2.php b/bureau/admin/browseforfolder2.php
index 1c56f64e..40cae2ec 100755
--- a/bureau/admin/browseforfolder2.php
+++ b/bureau/admin/browseforfolder2.php
@@ -1,39 +1,31 @@
 <?php
 /*
-   Navigateur de dossiers en php. (BrowseForFolder in win32 api :)
-   Version 1.0
-   Notes :
-   Benjamin Sonntag 23/12/2001 Version initiale: n'utilise qu'un seul uid : 1...
-   Fichier :
-   browseforfolder.php3 : Dialogue de navigation BrowseForFolder
-   $caller = composant form appelant (de la forme forms['main'].component )
+ ----------------------------------------------------------------------
+ LICENSE
 
-   function browseforfolder(caller) {
-   eval("file=document."+caller+".value");
-   w=window.open("browseforfolder.php?caller="+caller+"&file="+file,"browseforfolder","width=300,height=400,scrollbars,left=100,top=100");
-   }
+ 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.
 
-   requires : ife($test,$iftrue,$iffalse) function : 
+ 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.
 
-   function ife($test,$true,$false="") {
-   if ($test)
-   return $true;
-   else
-   return $false;
-   }
+ To read the license please visit http://www.gnu.org/copyleft/gpl.html
+ ----------------------------------------------------------------------
+*/
 
-   BrowseForFolder($curdir); Retourne le tableau avec la liste des dossiers à afficher dans
-   la fonction browseforfolder sachant que le dossier actuel et curdir
-   retourne un tableau de tableau de la forme :
-   dir => "directory"      Nom du dossier
-   level => 0-n            Niveau du dossier (0=racine 1,2 ...)
-   put => "/sub/sub/directory" Contenu de la variable post à ajouter pour la balise A si ="" c'est le dossier courant.
-   Si probleme, positionne $errbrowsefold
-   Sinon, retourne le tableau et $maxlevel contient le nombre maximum de sous-dossiers.
+/**
+ * An HTML page to browse for a folder on a remote server and choose it using 
+ * Javascript. Chroot the user to its root, 
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
  */
+
 include("../class/config.php");
 
-// FIXME Refaire ce truc hein...
 $fields = array (
     "caller"               => array ("request", "string", ""),
     "select"               => array ("request", "string", ""),
diff --git a/bureau/admin/cron.php b/bureau/admin/cron.php
index 29dfdbea..e2911ccf 100755
--- a/bureau/admin/cron.php
+++ b/bureau/admin/cron.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
+ ----------------------------------------------------------------------
+*/
+
+/**
+ * Launch the AlternC's panel crontab for users. 
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/dom_add.php b/bureau/admin/dom_add.php
index 5dfa3b21..03094ca9 100755
--- a/bureau/admin/dom_add.php
+++ b/bureau/admin/dom_add.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: dom_add.php,v 1.5 2003/06/10 13:16:11 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: Add a new domain
- ----------------------------------------------------------------------
 */
+
+/**
+ * Form to add a new domain to an AlternC's account
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 include_once("head.php");
diff --git a/bureau/admin/dom_defdel.php b/bureau/admin/dom_defdel.php
index e6ecfff2..3607fbad 100644
--- a/bureau/admin/dom_defdel.php
+++ b/bureau/admin/dom_defdel.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
+ ----------------------------------------------------------------------
+*/
+
+/**
+ * Del a default domain types for all future installed domains
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
@@ -7,7 +31,12 @@ $fields = array (
         );
 getFields($fields);
 
-//checker admin rights
+
+if (!$admin->enabled) {
+	$msg->raise("ERROR", "admin", _("This page is restricted to authorized staff"));
+	echo $msg->msg_html_all();
+	exit();
+}
 
 $dom->del_default_type($id);
 include_once("adm_doms_def_type.php");
diff --git a/bureau/admin/dom_dnsdump.php b/bureau/admin/dom_dnsdump.php
index 5269a05a..527d240a 100644
--- a/bureau/admin/dom_dnsdump.php
+++ b/bureau/admin/dom_dnsdump.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
+ ----------------------------------------------------------------------
+*/
+
+/**
+ * DUMP AXFR information of a zone to the user
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 $fields = array (
diff --git a/bureau/admin/dom_doadd.php b/bureau/admin/dom_doadd.php
index e418985a..c1d08d99 100644
--- a/bureau/admin/dom_doadd.php
+++ b/bureau/admin/dom_doadd.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: dom_doadd.php,v 1.3 2003/06/10 11:18:27 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: Add a new domain to a member's account
- ----------------------------------------------------------------------
 */
+
+/**
+ * Add a new domain name to an AlternC's account
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/dom_dodel.php b/bureau/admin/dom_dodel.php
index 5c1c54e8..240388ab 100755
--- a/bureau/admin/dom_dodel.php
+++ b/bureau/admin/dom_dodel.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: dom_dodel.php,v 1.3 2003/06/10 11:18:27 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: Delete a domain, confirm the deletion
- ----------------------------------------------------------------------
 */
+
+/** 
+ * Delete a domain, confirm the deletion
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/dom_edit.inc.php b/bureau/admin/dom_edit.inc.php
index 47ebad45..1b16a315 100755
--- a/bureau/admin/dom_edit.inc.php
+++ b/bureau/admin/dom_edit.inc.php
@@ -1,10 +1,32 @@
 <?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
+ ----------------------------------------------------------------------
+*/
+
+/**
+ * Form to edit / add subdomains, 
+ * using domaine_type table to show a synamic form.
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
-# Function to create/edit subdomain
-# Take the values of the subdomain in arguments
-
 function sub_domains_edit($domain, $sub_domain_id=false) {
   global $admin, $msg, $oldid, $isedit;
 
diff --git a/bureau/admin/dom_edit.php b/bureau/admin/dom_edit.php
index 9b7a64c7..0367fcfc 100755
--- a/bureau/admin/dom_edit.php
+++ b/bureau/admin/dom_edit.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: dom_edit.php,v 1.8 2006/02/17 18:20:08 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,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 domain parameters
- ----------------------------------------------------------------------
 */
+
+/**
+ * Change a DOMAIN settings
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
@@ -53,7 +49,7 @@ echo $msg->msg_html_all();
 <script type="text/javascript">
 function dnson() {
   alert('This function seems unused. If you see this message, please let us know.');
-	// Active les composants DNS :
+	// enable / disable html components:
 	if (document.forms["fdns"].mx.disabled!=null)
 		document.forms["fdns"].mx.disabled=false;
 	if (document.forms["fdns"].emailon.disabled!=null)
@@ -63,7 +59,7 @@ function dnson() {
 }
 function dnsoff() {
   alert('This function seems unused. If you see this message, please let us know.');
-	// Active les composants DNS :
+	// enable / disable html components:
 	if (document.forms["fdns"].mx.disabled!=null)
 		document.forms["fdns"].mx.disabled=true;
 	if (document.forms["fdns"].emailon.disabled!=null)
@@ -73,7 +69,7 @@ function dnsoff() {
 }
 
 function destruction_alert() {
-  // On ne se pose pas de question si le DNS est deja sur NON
+  // We don't ask question if DNS is already NO
   if (<?php echo (int)$r["dns"]; ?>!=1) {
     return true;
   }
@@ -250,9 +246,7 @@ sub_domains_edit($domain);
 ?>
 <br />
 <?php $mem->show_help("edit_domain"); ?>
-<!-- *****************************************
-		 modification des parametres dns
- -->
+<!-- DNS SETTINGS  -->
 
 </div>
     <?php
@@ -347,7 +341,6 @@ if (!$r['noerase']) {
 } ?>
 </div> <!-- tabsdom -->
 <script type="text/javascript">
-//document.forms['main'].sub.focus(); // not with tabs
 
 $(function() {
   $("#tabsdom").tabs();
diff --git a/bureau/admin/dom_editdns.php b/bureau/admin/dom_editdns.php
index f6a06d5e..8929bf90 100644
--- a/bureau/admin/dom_editdns.php
+++ b/bureau/admin/dom_editdns.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: dom_editdns.php,v 1.3 2003/06/10 11:18:27 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: Edit the dns parameters of a domain
- ----------------------------------------------------------------------
 */
+
+/**
+ * Edit the DNS parameters of a domain
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
@@ -46,7 +42,7 @@ if ($r["dns"] == $dns && $r["mail"] == $email && $r["zonettl"] == $ttl) {
 } else if ($dom->edit_domain($domain,$dns,$email,0,$ttl)) {
   $msg->raise("INFO", "dom", _("The domain %s has been changed."),$domain);
   $t = time();
-// XXX: we assume the cron job is at every 5 minutes
+// TODO: we assume the cron job is at every 5 minutes
   $msg->raise("INFO", "dom", _("The modifications will take effect at %s.  Server time is %s."), array(date('H:i:s', ($t-($t%300)+300)), date('H:i:s', $t)));
 }
 $dom->unlock();
diff --git a/bureau/admin/dom_import.php b/bureau/admin/dom_import.php
index c1c79db6..14625086 100755
--- a/bureau/admin/dom_import.php
+++ b/bureau/admin/dom_import.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: ftp_list.php,v 1.5 2003/06/10 13:16:11 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: List ftp accounts of the user.
- ----------------------------------------------------------------------
 */
+
+/**
+ * Import of DNS informations from an existing zone, transformation into AlternC's system zone.
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/dom_subdel.php b/bureau/admin/dom_subdel.php
index c84cc500..9e3fbaec 100755
--- a/bureau/admin/dom_subdel.php
+++ b/bureau/admin/dom_subdel.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: dom_subdel.php,v 1.3 2003/08/13 23:31:47 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: delete a subdomain
- ----------------------------------------------------------------------
 */
+
+/**
+ * Form to confirm the deletion of a subdomain
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/dom_subdodel.php b/bureau/admin/dom_subdodel.php
index acc84bb7..5ae381c6 100644
--- a/bureau/admin/dom_subdodel.php
+++ b/bureau/admin/dom_subdodel.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: dom_subdodel.php,v 1.2 2003/06/10 11:18:27 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:
- ----------------------------------------------------------------------
 */
+
+/**
+ * After confirmation of a subdomain deletion, do it here.
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
@@ -63,7 +59,7 @@ $dom->unlock();
 		exit();
 	} else {
         $t = time();
-	// XXX: we assume the cron job is at every 5 minutes
+	// TODO: we assume the cron job is at every 5 minutes
         $msg->raise("INFO", "dom", _("The modifications will take effect at %s.  Server time is %s."), array(date('H:i:s', ($t-($t%300)+300)), date('H:i:s', $t))); 
 	echo $msg->msg_html_all();
 	}
diff --git a/bureau/admin/dom_subdoedit.php b/bureau/admin/dom_subdoedit.php
index 2e3018f6..a7e20395 100644
--- a/bureau/admin/dom_subdoedit.php
+++ b/bureau/admin/dom_subdoedit.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: dom_subdoedit.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: Edit a domain parameters
- ----------------------------------------------------------------------
 */
+
+/**
+ * Edit a subdomain parameters 
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 $fields = array (
@@ -71,7 +67,7 @@ if (!$r) {
     exit();
 } else {
   $t = time();
-  // XXX: we assume the cron job is at every 5 minutes
+  // TODO: we assume the cron job is at every 5 minutes
   $noread=false;
   $msg->raise("INFO", "dom", _("The modifications will take effect at %s. Server time is %s."), array(date('H:i:s', ($t-($t%300)+300)), date('H:i:s', $t)));
   foreach($fields as $k=>$v) unset($$k);
diff --git a/bureau/admin/dom_subedit.php b/bureau/admin/dom_subedit.php
index 98e6456c..6b4d851f 100644
--- a/bureau/admin/dom_subedit.php
+++ b/bureau/admin/dom_subedit.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: dom_subedit.php,v 1.3 2003/08/13 23:01:45 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:
- ----------------------------------------------------------------------
 */
+
+/**
+ * Form to edit subdomains informations
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/dom_substatus.php b/bureau/admin/dom_substatus.php
index 7ef5e57c..e702b0f2 100644
--- a/bureau/admin/dom_substatus.php
+++ b/bureau/admin/dom_substatus.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
+ ----------------------------------------------------------------------
+*/
+
+/**
+ * Subdomain change status page
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 $fields = array (
@@ -11,7 +35,7 @@ $dom->lock();
 
 $r=$dom->sub_domain_change_status($sub_id,$status);
 
-# Usefull for dom_edit
+# Useful for dom_edit
 $domi = $dom->get_sub_domain_all($sub_id);
 $domain=$domi['domain'];
 $sub=$domi['name'];
@@ -24,7 +48,7 @@ if (!$r) {
   exit();
 } else {
   $t = time();
-  // XXX: we assume the cron job is at every 5 minutes
+  // TODO: we assume the cron job is at every 5 minutes 
   $msg->raise("INFO", "dom", _("The modifications will take effect at %s. Server time is %s."), array(date('H:i:s', ($t-($t%300)+300)), date('H:i:s', $t)));
   foreach($fields as $k=>$v) unset($k);
 }
diff --git a/bureau/admin/domlist.php b/bureau/admin/domlist.php
index 56c9153c..9909d57a 100644
--- a/bureau/admin/domlist.php
+++ b/bureau/admin/domlist.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: domlist.php,v 1.1 2004/06/02 13:23:45 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:
- Purpose of file:
- ----------------------------------------------------------------------
 */
+
+/**
+ * list of domains hosted on this server
+ * used by DNS slaves to mirror our configurations
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config_nochk.php");
 
 $fields = array (
diff --git a/bureau/admin/foot.php b/bureau/admin/foot.php
index a69edd59..02719c61 100644
--- a/bureau/admin/foot.php
+++ b/bureau/admin/foot.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
+ ----------------------------------------------------------------------
+*/
+
+/**
+ * FOOTER for all HTML pages
+ * use with head.php
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
+?>
 </div> <!-- div content -->
 <div style="clear:both;" ></div>
 </div> <!-- div global -->
diff --git a/bureau/admin/ftp_del.php b/bureau/admin/ftp_del.php
index d7d18ed3..7860d606 100755
--- a/bureau/admin/ftp_del.php
+++ b/bureau/admin/ftp_del.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: ftp_del.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,13 +15,16 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Benjamin Sonntag
- Purpose of file: Delete ftp accounts
- ----------------------------------------------------------------------
 */
+
+/**
+ * Ask for confirmation or delete an FTP account
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
-// On parcours les POST_VARS et on repere les del_.
 reset($_POST);
 $lst_todel=array();
 while (list($key,$val)=each($_POST)) {
diff --git a/bureau/admin/ftp_doedit.php b/bureau/admin/ftp_doedit.php
index 9466c3b7..39a514d8 100755
--- a/bureau/admin/ftp_doedit.php
+++ b/bureau/admin/ftp_doedit.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: ftp_doedit.php,v 1.3 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: Benjamin Sonntag
- Purpose of file: Editing an ftp account
- ----------------------------------------------------------------------
 */
+
+/**
+ * change settings of an FTP account
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 $fields = array (
   "id"        => array ("post", "integer", ""),
diff --git a/bureau/admin/ftp_edit.php b/bureau/admin/ftp_edit.php
index 0ba8263f..f7d009f2 100755
--- a/bureau/admin/ftp_edit.php
+++ b/bureau/admin/ftp_edit.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: ftp_edit.php,v 1.5 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: Benjamin Sonntag
- Purpose of file: Edit an FTP account
- ----------------------------------------------------------------------
 */
+
+/**
+ * Form to edit an FTP account
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/ftp_list.php b/bureau/admin/ftp_list.php
index 805fc1a3..6d3fc253 100755
--- a/bureau/admin/ftp_list.php
+++ b/bureau/admin/ftp_list.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: ftp_list.php,v 1.5 2003/06/10 13:16:11 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: List ftp accounts of the user.
- ----------------------------------------------------------------------
 */
+
+/**
+ * List the FTP accounts of the user
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/ftp_switch_enable.php b/bureau/admin/ftp_switch_enable.php
index 6345d7ce..3ff85963 100644
--- a/bureau/admin/ftp_switch_enable.php
+++ b/bureau/admin/ftp_switch_enable.php
@@ -1,9 +1,5 @@
 <?php
 /*
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2000-2012 by the AlternC Development Team.
- https://alternc.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -21,6 +17,11 @@
  ----------------------------------------------------------------------
 */
 
+/**
+ * Enable a FTP account
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
 
 require_once("../class/config.php");
 
diff --git a/bureau/admin/head.php b/bureau/admin/head.php
index 81fb8c64..5614d070 100644
--- a/bureau/admin/head.php
+++ b/bureau/admin/head.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: Main header of all html files
- ----------------------------------------------------------------------
 */
+
+/**
+ * main HEADER of all HTML page of the panel
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 if (!isset($charset) || ! $charset) $charset="UTF-8";
 @header("Content-Type: text/html; charset=$charset");
 ?>
diff --git a/bureau/admin/hta_add.php b/bureau/admin/hta_add.php
index b3f6fa54..2ec0ea3d 100755
--- a/bureau/admin/hta_add.php
+++ b/bureau/admin/hta_add.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: hta_add.php,v 1.3 2003/06/10 13:16:11 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: Franck Missoum
- Purpose of file: Ask the required values to protect a folder
- ----------------------------------------------------------------------
 */
+
+/**
+ * Form to protect a folder using .htaccess for apache2
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/hta_adduser.php b/bureau/admin/hta_adduser.php
index 53907b18..1fa9c0a1 100755
--- a/bureau/admin/hta_adduser.php
+++ b/bureau/admin/hta_adduser.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: hta_adduser.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: Franck Missoum, Benjamin Sonntag
- Purpose of file: Add a username to a protected folder
- ----------------------------------------------------------------------
 */
+
+/** 
+ * Add a user to a protected folder (using .htaccess for apache)
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
@@ -47,9 +43,6 @@ $passwd_classcount = $c['hta']['classcount'];
 
 <form method="post" action="hta_doadduser.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 border="1" cellspacing="0" cellpadding="4" class='tedit'>
 	<tr>
@@ -74,6 +67,6 @@ $passwd_classcount = $c['hta']['classcount'];
   <input type="button" class="inb" value="<?php __("Cancel"); ?>" onclick="document.location='hta_edit.php?dir=<?php echo urlencode($dir);  ?>';" />
 </form>
 <script type="text/javascript">
-document.forms['main'].user.focus();
+  document.forms['main'].user.focus();
 </script>
 <?php include_once("foot.php"); ?>
diff --git a/bureau/admin/hta_del.php b/bureau/admin/hta_del.php
index a48d932e..1066c087 100644
--- a/bureau/admin/hta_del.php
+++ b/bureau/admin/hta_del.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: hta_del.php,v 1.4 2003/08/20 13:08:28 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,17 +15,19 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Franck Missoum
- Purpose of file: Delete a username from a protected folder
- ----------------------------------------------------------------------
 */
-require_once("../class/config.php");
 
-// On parcours les POST_VARS et on repere les del_.
+/**
+ * delete a protected folder using .htaccess for Apache2
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
+ require_once("../class/config.php");
+
 reset($_POST);
 while (list($key,$val)=each($_POST)) {
 	if (substr($key,0,4)=="del_") {
-		// Effacement du dossier $val
 		$return = $hta->DelDir($val);
 		if ($return) {
 			$msg->raise("INFO", "hta",_("The protected folder %s has been successfully unprotected"),$val);
diff --git a/bureau/admin/hta_doadd.php b/bureau/admin/hta_doadd.php
index 3b2fea23..5a870be6 100644
--- a/bureau/admin/hta_doadd.php
+++ b/bureau/admin/hta_doadd.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: hta_doadd.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,12 +15,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Franck Missoum
- Purpose of file: Protect a folder
- ----------------------------------------------------------------------
 */
-require_once("../class/config.php");
 
+/** 
+ * Protects a folder using a .htaccess / .htpasswd pair for apache2
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
+require_once("../class/config.php");
 
 $fields = array (
 	"dir"     => array ("post", "string", ""),
diff --git a/bureau/admin/hta_doadduser.php b/bureau/admin/hta_doadduser.php
index bf0b4d67..f4a61136 100644
--- a/bureau/admin/hta_doadduser.php
+++ b/bureau/admin/hta_doadduser.php
@@ -1,13 +1,5 @@
  <?php
 /*
- $Id: hta_doadduser.php,v 1.2 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: Franck Missoum
- Purpose of file: Add a username to a protected folder
- ----------------------------------------------------------------------
 */
+
+/**
+ * Add a new username / password pair to a protected folder
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 $fields = array (
         "dir"		=> array ("post", "string", ""),
diff --git a/bureau/admin/hta_dodeluser.php b/bureau/admin/hta_dodeluser.php
index 0cc36495..814e6be4 100755
--- a/bureau/admin/hta_dodeluser.php
+++ b/bureau/admin/hta_dodeluser.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: hta_dodeluser.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: Franck Missoum
- Purpose of file: Delete a username from a protected folder
- ----------------------------------------------------------------------
 */
+
+/**
+ * Delete a username from a protected folder
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 $fields = array (
diff --git a/bureau/admin/hta_doedituser.php b/bureau/admin/hta_doedituser.php
index 3dd7b96e..d62dc0c0 100644
--- a/bureau/admin/hta_doedituser.php
+++ b/bureau/admin/hta_doedituser.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: hta_doedituser.php,v 1.4 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: Franck Missoum
- Purpose of file: Change a username / password from a protected folder
- ----------------------------------------------------------------------
 */
+
+/** 
+ * Change the login / password of a protected folder
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/hta_edit.php b/bureau/admin/hta_edit.php
index ed9ccecb..c4d78d89 100755
--- a/bureau/admin/hta_edit.php
+++ b/bureau/admin/hta_edit.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: hta_edit.php,v 1.4 2003/06/10 13:16:11 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: Franck Missoum, Benjamin Sonntag
- Purpose of file: Edit a protected folder
- ----------------------------------------------------------------------
 */
+
+/**
+ * Edit a protected folder parameters 
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/hta_edituser.php b/bureau/admin/hta_edituser.php
index 44dc0852..2a1348d5 100755
--- a/bureau/admin/hta_edituser.php
+++ b/bureau/admin/hta_edituser.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: hta_edituser.php,v 1.4 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: Franck Missoum
- Purpose of file: Edit a username from a protected folder
- ----------------------------------------------------------------------
 */
+
+/**
+ * Edit a username for a protected folder (using htaccess for apache2)
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once ("head.php");
 
diff --git a/bureau/admin/hta_list.php b/bureau/admin/hta_list.php
index a5cbf92f..3168a7d5 100755
--- a/bureau/admin/hta_list.php
+++ b/bureau/admin/hta_list.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: hta_list.php,v 1.5 2003/08/20 13:08:28 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: Franck Missoum
- Purpose of file: List the users in a protected folder
- ----------------------------------------------------------------------
 */
+
+/**
+ * List the folders having password-protection in the account's home
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/index.php b/bureau/admin/index.php
index 26f19d0a..0ced28cd 100755
--- a/bureau/admin/index.php
+++ b/bureau/admin/index.php
@@ -1,10 +1,6 @@
 <?php
 
 /*
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2000-2012 by the AlternC Development Team.
- https://alternc.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -20,10 +16,16 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Purpose of file: Main index : show the login page
- ----------------------------------------------------------------------
 */
 
+/**
+ * Show the login page (hence the config_nochk below)
+ * this page is the only one, with logout.php, to NOT ask 
+ * for authentication 
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config_nochk.php");
 
 if ($mem->checkid(false)) {
diff --git a/bureau/admin/ip_main.php b/bureau/admin/ip_main.php
index a445e103..acdfc5a0 100755
--- a/bureau/admin/ip_main.php
+++ b/bureau/admin/ip_main.php
@@ -1,4 +1,29 @@
 <?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
+ ----------------------------------------------------------------------
+*/
+
+/** 
+ * List and edit IP-Authentication list for this account
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/login.php b/bureau/admin/login.php
index 833f6c66..3add7233 100644
--- a/bureau/admin/login.php
+++ b/bureau/admin/login.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: login.php,v 1.2 2003/06/10 06:42:25 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,11 +15,9 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file:
- Purpose of file:
- ----------------------------------------------------------------------
 */
 
+// When you log in, you are redirected to the main page.
 
 require_once("../class/config.php");
 
diff --git a/bureau/admin/logs_download.php b/bureau/admin/logs_download.php
index 23237506..24cd1994 100644
--- a/bureau/admin/logs_download.php
+++ b/bureau/admin/logs_download.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: logs_download.php,v 1.2 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,10 +15,14 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Sonntag Benjamin
- Purpose of file: Return the current folder in a compressed file
- ----------------------------------------------------------------------
 */
+
+/**
+ * Download a log file for a user.
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 $fields = array (
diff --git a/bureau/admin/logs_list.php b/bureau/admin/logs_list.php
index 1f427daf..0193813a 100644
--- a/bureau/admin/logs_list.php
+++ b/bureau/admin/logs_list.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: log_list.php,v 1.8 2006/02/16 16:26:28 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: Lerider Steven
- Purpose of file: Manage the log listing of a user
- ----------------------------------------------------------------------
 */
+
+/**
+ * Show a list of all found log files for an account
+ * and allow to see / tail / download them
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/logs_tail.php b/bureau/admin/logs_tail.php
index ad83df2e..c8381936 100644
--- a/bureau/admin/logs_tail.php
+++ b/bureau/admin/logs_tail.php
@@ -1,13 +1,5 @@
 <?php
 /*
- $Id: logs_download.php,v 1.2 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,10 +15,15 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Original Author of file: Sonntag Benjamin
- Purpose of file: Return the current folder in a compressed file
- ----------------------------------------------------------------------
 */
+
+/**
+ * Show the end of a log file and refresh automatically every few seconds
+ * similar to a tail -f in a console
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 
 $fields = array (
diff --git a/bureau/admin/mail_del.php b/bureau/admin/mail_del.php
index 23692af8..24d04228 100755
--- a/bureau/admin/mail_del.php
+++ b/bureau/admin/mail_del.php
@@ -1,9 +1,5 @@
 <?php
 /*
- ----------------------------------------------------------------------
- AlternC - Web Hosting System
- Copyright (C) 2000-2012 by the AlternC Development Team.
- https://alternc.org/
  ----------------------------------------------------------------------
  LICENSE
 
@@ -19,11 +15,16 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Purpose of file: Delete one or more mailboxes
- ----------------------------------------------------------------------
 */
-require_once("../class/config.php");
 
+/**
+ * Form to confirm the deletion of an email account
+ * delete it when confirmed.
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
+require_once("../class/config.php");
 
 $fields = array (
 	"d"    => array ("post", "array", ""),
diff --git a/bureau/admin/mail_doadd.php b/bureau/admin/mail_doadd.php
index bbc2521d..a2b6c980 100644
--- a/bureau/admin/mail_doadd.php
+++ b/bureau/admin/mail_doadd.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: Create a new mail account
- ----------------------------------------------------------------------
 */
+
+/**
+ * create a new mail account and go to its edit form
+ *
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 $fields = array (
 	"mail_arg"     => array ("post", "string", ""),
diff --git a/bureau/admin/mail_doedit.php b/bureau/admin/mail_doedit.php
index 32956009..2ff8141d 100644
--- a/bureau/admin/mail_doedit.php
+++ b/bureau/admin/mail_doedit.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,13 @@
 
  To read the license please visit http://www.gnu.org/copyleft/gpl.html
  ----------------------------------------------------------------------
- Purpose of file: Edit mail account settings
- ----------------------------------------------------------------------
 */
 
+/**
+ * edit an email account settings
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
 
 require_once("../class/config.php");
 
diff --git a/bureau/admin/mail_edit.php b/bureau/admin/mail_edit.php
index a2ea24c4..af9da51b 100755
--- a/bureau/admin/mail_edit.php
+++ b/bureau/admin/mail_edit.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: Edit a mailbox.
- ----------------------------------------------------------------------
 */
+
+/**
+ * Form to edit a mailbox parameters.
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config.php");
 include_once("head.php");
 
diff --git a/bureau/admin/mailautoconfig_outlook.php b/bureau/admin/mailautoconfig_outlook.php
index e924e676..8767a5fd 100644
--- a/bureau/admin/mailautoconfig_outlook.php
+++ b/bureau/admin/mailautoconfig_outlook.php
@@ -1,8 +1,35 @@
 <?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
+ ----------------------------------------------------------------------
+*/
+
+/** 
+ * Show email autoconfiguration xml data for Outlook / Email for windows
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config_nochk.php");
 
-# Test it :
-# wget http://FQDN/mailautoconfig_outlook.php -O - --post-data="test@example.tls" -q
+/*
+ Test it that way :
+ wget http://FQDN/mailautoconfig_outlook.php -O - --post-data="test@example.tls" -q
+*/
 
 // Created by Alesandro Slepcevic - alesandro@plus.hr
 if ( $_SERVER['REQUEST_METHOD'] === 'POST' ){ 
diff --git a/bureau/admin/mailautoconfig_thunderbird.php b/bureau/admin/mailautoconfig_thunderbird.php
index 1d15b85d..9dd63a88 100644
--- a/bureau/admin/mailautoconfig_thunderbird.php
+++ b/bureau/admin/mailautoconfig_thunderbird.php
@@ -1,10 +1,37 @@
 <?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
+ ----------------------------------------------------------------------
+*/
+
+/** 
+ * Show email autoconfiguration xml data for Thunderbird 
+ * 
+ * @copyright AlternC-Team 2000-2017 https://alternc.com/ 
+ */
+
 require_once("../class/config_nochk.php");
 
 header ("Content-Type:text/xml");
 
-# Test it :
-# wget -O - -q  http://FQDN/mailautoconfig_thunderbird.php?emailaddress=test@example.tld
+/*
+ Test it that way:
+ wget -O - -q  http://FQDN/mailautoconfig_thunderbird.php?emailaddress=test@example.tld
+*/
 
 if (empty($_GET['emailaddress'])) die(_("Error: Missing GET of emailaddress"));