Doc P1.c

src/partie1/saeP1.c

@@ -9,6 +9,15 @@
 
 void menuUser(VilleIUT* lvIUT[],int tlogi, int CandidOpen, candidat* tcandidat[])
 {
+    /*
+    Menu pour les utilisateurs du système, les candidats.
+    Entrée : 
+        Tableau des IUT tiut;
+        taille logique de tiut tlogi;
+        Booléen gérant l'ouverture ou non des candidatures CandidOpen; 
+        tableau des candidats tcandidats. 
+    Sortie : Aucune
+    */
     int quit=0, ck=0, act;
     while(!quit)
     {
@@ -74,11 +83,25 @@ void menuUser(VilleIUT* lvIUT[],int tlogi, int CandidOpen, candidat* tcandidat[]
 
 void SearchCityWithIUT(VilleIUT* lvIUT[], int tlogi)
 {
+    /*
+    Affiche toute les villes possèdant un IUT
+    Entrée : 
+        Tableau des IUT tiut;
+        taille logique de tiut tlogi;
+    Sortie : Aucune
+    */
     for (int i=0;i<tlogi;++i) printf("\n - %s",lvIUT[i]->Ville);
 }
 
 void DepEachIUT(VilleIUT* lvIUT[], int tlogi)
 {
+    /*
+    Affiche toute les villes possèdant un IUT et leurs départements
+    Entrée : 
+        Tableau des IUT tiut;
+        taille logique de tiut tlogi;
+    Sortie : Aucune
+    */
     for (int i=0;i<tlogi;++i)
     {
         printf("\n - %s :\n",lvIUT[i]->Ville);
@@ -93,6 +116,14 @@ void DepEachIUT(VilleIUT* lvIUT[], int tlogi)
 
 void SearchPlaceFromDepInIUT(VilleIUT* lvIUT[],int tlogi)
 {
+    /*
+    Affiche le nombre de place d'un département précis dans un iut précis.
+    Les deux sont entrées par l'utilisateur.
+    Entrée : 
+        Tableau des IUT tiut;
+        taille logique de tiut tlogi;
+    Sortie : Aucune
+    */
     char sVille[31];
     char sDep[31];
     int boolF=0, i;
@@ -136,6 +167,13 @@ void SearchPlaceFromDepInIUT(VilleIUT* lvIUT[],int tlogi)
 
 void SearchIUTFromDep(VilleIUT* lvIUT[],int tlogi)
 {
+    /*
+    Affiche toutes les villes possèdant le département entrée par l'utilisateur.
+    Entrée : 
+        Tableau des IUT tiut;
+        taille logique de tiut tlogi;
+    Sortie : Aucune
+    */
     char sDep[31];
     printf("\nMerci de renseignez le département dont vous cherchez les IUTs :\n");
     scanf("%s",sDep);
@@ -153,6 +191,14 @@ void SearchIUTFromDep(VilleIUT* lvIUT[],int tlogi)
 //Partie Administrateur.
 
 void menuAdmin(VilleIUT* tiut[],int *tlogi, int* CandidOpen){
+    /*
+    Menu pour les administrateurs du système.
+    Entrée : 
+        Tableau des IUT tiut; 
+        taille logique de tiut tlogi;
+        booléen indiquant l'ouverture ou fermeture des candidature CandidOpen;
+    Sortie : Aucune
+    */
 	int quit=0, ck=0, act;
 	while(!quit){
 		printf("#--------------------------------------------------------------------#\n");
@@ -217,6 +263,13 @@ void menuAdmin(VilleIUT* tiut[],int *tlogi, int* CandidOpen){
 }
 
 void modifPlaces(VilleIUT* tiut[],int tlogi){
+    /*
+    Permet de modifier les places d'un département dans un IUT.
+    Entrée : 
+        Tableau des IUT tiut; 
+        taille logique de tiut tlogi;
+    Sortie : Aucune
+    */
     printf("\nEntrez la ville correspondant à l'IUT à modifier (Q pour abandonner): ");
     char ville[31];
     scanf("%s",ville);
@@ -245,6 +298,13 @@ void modifPlaces(VilleIUT* tiut[],int tlogi){
 }
 
 void creerDep(VilleIUT* tiut[],int tlogi){
+    /*
+    Permet de créer un département dans un IUT.
+    Entrée : 
+        Tableau des IUT tiut; 
+        taille logique de tiut tlogi;
+    Sortie : Aucune
+    */
     printf("\nEntrez la ville correspondant à l'IUT à modifier (Q pour abandonner): ");
     char ville[31];
     scanf("%s",ville);
@@ -293,6 +353,13 @@ void creerDep(VilleIUT* tiut[],int tlogi){
 }
 
 void supprimerDep(VilleIUT* tiut[],int tlogi){
+    /*
+    Permet de supprimer un département dans un IUT.
+    Entrée : 
+        Tableau des IUT tiut; 
+        taille logique de tiut tlogi;
+    Sortie : Aucune
+    */
     printf("\nEntrez la ville correspondant à l'IUT à modifier (Q pour abandonner): ");
     char ville[31];
     scanf("%s",ville);
@@ -335,6 +402,13 @@ void supprimerDep(VilleIUT* tiut[],int tlogi){
 }
 
 void modifNomResponsable(VilleIUT* tiut[],int tlogi){
+    /*
+    Permet de modifier le nom d'un responsable d'un département d'un IUT.
+    Entrée : 
+        Tableau des IUT tiut; 
+        taille logique de tiut tlogi;
+    Sortie : Aucune
+    */
     printf("\nEntrez la ville correspondant à l'IUT à modifier (Q pour abandonner): ");
     char ville[31];
     scanf("%s",ville);
@@ -363,6 +437,13 @@ void modifNomResponsable(VilleIUT* tiut[],int tlogi){
 }
 
 void creerIUT(VilleIUT* tiut[],int* tlogi){
+    /*
+    Permet de créer un IUT (quand elle segfault pas.)
+    Entrée : 
+        Tableau des IUT tiut; 
+        taille logique de tiut tlogi;
+    Sortie : Aucune
+    */
 	printf("\nEntrez le nom de la ville correspondant à l'IUT à ajouter (Q pour abandonner): ");
 	char ville[31];
 	scanf("%*c%s",ville);