BOFH/socle_bash
2
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

"Conversion README en markdown"

Browse Source
This commit is contained in:
Doug Le Tough 2017-07-21 12:00:45 +02:00
parent c7a72add50
commit 0ea09f0dcf
1 changed files with 215 additions and 212 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

407
README.md
View File

@ -39,21 +39,21 @@ en découlent.
Sous l'arborescence ${NC_EXPL_ROOT} on trouve les dossiers suivants : Sous l'arborescence ${NC_EXPL_ROOT} on trouve les dossiers suivants :
+-----------------+-----------------------------------------------------------------------------------------------+ +-----------------+-----------------------------------------------------------------------------------------------+
| Dossier | Description | | Dossier | Description |
+-----------------+-----------------------------------------------------------------------------------------------+ +-----------------+-----------------------------------------------------------------------------------------------+
| {Racine}/bin | Contient les binaires (scripts Bash) | | {Racine}/bin | Contient les binaires (scripts Bash) |
| {Racine}/conf | Contient les fichiers de configuration des scripts, ainsi que du socle | | {Racine}/conf | Contient les fichiers de configuration des scripts, ainsi que du socle |
| {Racine}/cpt | Contient les fichiers de comtpe-rendus génerés par les script (purge auto, 8 jours par défaut)| | {Racine}/cpt | Contient les fichiers de comtpe-rendus génerés par les script (purge auto, 8 jours par défaut)|
| {Racine}/dat | Contient les fichiers de données gérés par les scripts | | {Racine}/dat | Contient les fichiers de données gérés par les scripts |
| {Racine}/hist | Contient l'historique d'exécution des scripts (pas de purge) | | {Racine}/hist | Contient l'historique d'exécution des scripts (pas de purge) |
| {Racine}/lib | Contient les bibliothèques chargées par le socle | | {Racine}/lib | Contient les bibliothèques chargées par le socle |
| {Racine}/log | Contient les fichiers de logs d exécution des scripts (purge auto , 8 jours par défaut ) | | {Racine}/log | Contient les fichiers de logs d exécution des scripts (purge auto , 8 jours par défaut ) |
| {Racine}/man | Contient les fichiers d'aide des scripts pour l'utilitaire "man" | | {Racine}/man | Contient les fichiers d'aide des scripts pour l'utilitaire "man" |
| {Racine}/mod | Contient les fichiers modèles (templates) à usage des scripts | | {Racine}/mod | Contient les fichiers modèles (templates) à usage des scripts |
| {Racine}/msg | Contient les fichiers de messages des scripts utilisés par la bibliothèque "fct_erreur" | | {Racine}/msg | Contient les fichiers de messages des scripts utilisés par la bibliothèque "fct_erreur" |
| {Racine}/tmp | Contient les fichiers temporaires des scripts | | {Racine}/tmp | Contient les fichiers temporaires des scripts |
+-----------------+-----------------------------------------------------------------------------------------------+ +-----------------+-----------------------------------------------------------------------------------------------+
Note : Sous chaque dossier vous trouverez un fichier texte lisezmoi.txt decrivant l'usage du répertoire. Note : Sous chaque dossier vous trouverez un fichier texte lisezmoi.txt decrivant l'usage du répertoire.
@ -135,236 +135,239 @@ Remarque : Les variables SH_SILENCE et SH_NIV_DEBUG sont controlées par les opt
si la gestion des options a été activée. si la gestion des options a été activée.
III - Utilisation du socle bash ## III - Utilisation du socle bash
-------------------------
Cette partie decrit sommairmement les quelques regles d usage pour ecrire un script Bash sous le socle DTSI Cette partie decrit sommairmement les quelques regles d usage pour ecrire un script Bash sous le socle DTSI
Ceci ne concerne pas les script Ruby qui ne sont pas pris en charge par le socle decrit ici. Ceci ne concerne pas les script Ruby qui ne sont pas pris en charge par le socle decrit ici.
1 - Cartouche ### 1 - Cartouche
Les scripts doivent commencer par le cartouche ci-dessous :
+----------------------------------------------------------------------------------------------------+
| |
| #!/bin/bash |
| ##---------------------------------------------------------------------------- |
| ## Script : <Nom_du_script> |
| ## Module Puppet : <Nom_du_module_hebergeant_le_script> |
| ## Auteur : <Auteur ayant cree le script> |
| ## Date : <Derniere_date_d_actualisation_au_format_JJ-MM-AAAA> |
| ## Version : <Version> |
| ## Objet : <Resume de la fonction> |
| ## |
| # ---------------------------------------------------------------------------- |
| # Mise a jour : |
| # <Version> <Date> - <Auteur> - <Action> : <Description> |
| # 0.0.1 08-06-2016 - Toto Laricot - Cre : Creation |
| # 0.0.2 08-09-2016 - Titi Alapeti - Ano : Ce truc est faux |
| # ---------------------------------------------------------------------------- |
| # Dependance : |
| # @DEP: <Nom_du_script>:<Version[-|+]> |
| # ---------------------------------------------------------------------------- |
| # Liste des options et arguments |
| # @OPT: <type>:<nom>:<var>:<nb_arg>:<def_val>:<OptE>:<OptI>:<ctl_val> # <Commentaire> |
| # @OPT: <type>:... # <Commentaire> |
| # @ARG: <type>:<var>:<nb_arg>:<def_val>:<ctl_val> # <Commentaire> |
| ##---------------------------------------------------------------------------- |
| ## |
| ## Syntaxes : |
| ## -------- |
| ## |
| ## prompt> <Nom_du_script> <Liste_des_arguments_et_options> |
| ## |
| ## <Opt1> : <Description> |
| ## |
| ## Fonctionnement : |
| ## -------------- |
| ## |
| ## <Que fait le script dans les details et comment ca marche......> |
| ## |
| ##---------------------------------------------------------------------------- |
| . |
| . |
| . |
| |
+----------------------------------------------------------------------------------------------------+
Note : Les lignes commencant par 2 "#" sont utilisees pour generer l aide, leur maintient est donc necessaire Les scripts doivent commencer par le cartouche ci-dessous :
pour garantir la fiabilite de l information. Ce sont ces lignes, qui sont lues lors de l utilisation de
l'option par defaut "-h".
1.1 Elements du cartouche +----------------------------------------------------------------------------------------------------+
1.1.1 Meta-donnees | |
- <Action> : peut prendre les valeurs suivantes -> cre, ano, evo, typo | #!/bin/bash |
cre : Creation du script. | ##---------------------------------------------------------------------------- |
evo : Evolution du script -> Ajout de nouvelles fonctionnalites, Amelioration du code. | ## Script : <Nom_du_script> |
ano : Correction du code suite a un comportement inattendu. | ## Module Puppet : <Nom_du_module_hebergeant_le_script> |
typo : Ajout de commentaires, de texte ou correction gramatical sans influence sur le code. | ## Auteur : <Auteur ayant cree le script> |
| ## Date : <Derniere_date_d_actualisation_au_format_JJ-MM-AAAA> |
| ## Version : <Version> |
| ## Objet : <Resume de la fonction> |
| ## |
| # ---------------------------------------------------------------------------- |
| # Mise a jour : |
| # <Version> <Date> - <Auteur> - <Action> : <Description> |
| # 0.0.1 08-06-2016 - Toto Laricot - Cre : Creation |
| # 0.0.2 08-09-2016 - Titi Alapeti - Ano : Ce truc est faux |
| # ---------------------------------------------------------------------------- |
| # Dependance : |
| # @DEP: <Nom_du_script>:<Version[-|+]> |
| # ---------------------------------------------------------------------------- |
| # Liste des options et arguments |
| # @OPT: <type>:<nom>:<var>:<nb_arg>:<def_val>:<OptE>:<OptI>:<ctl_val> # <Commentaire> |
| # @OPT: <type>:... # <Commentaire> |
| # @ARG: <type>:<var>:<nb_arg>:<def_val>:<ctl_val> # <Commentaire> |
| ##---------------------------------------------------------------------------- |
| ## |
| ## Syntaxes : |
| ## -------- |
| ## |
| ## prompt> <Nom_du_script> <Liste_des_arguments_et_options> |
| ## |
| ## <Opt1> : <Description> |
| ## |
| ## Fonctionnement : |
| ## -------------- |
| ## |
| ## <Que fait le script dans les details et comment ca marche......> |
| ## |
| ##---------------------------------------------------------------------------- |
| . |
| . |
| . |
| |
+----------------------------------------------------------------------------------------------------+
- <Auteur> : <Prenom> <Nom> Note : Les lignes commençant par 2 "#" sont utilisees pour generer l'aide, leur maintient est donc nécéssaire
pour garantir la fiabilité de l'information. Ce sont ces lignes, qui sont lues lors de l'utilisation de
l'option par defaut "-h".
- <Version> : Format x.y.z ### 1.1 Elements du cartouche
Pour le suivie des versions on utilisera le versionnement semantique (voir paragraphe III-1.2).
1.1.2 Paragraphe #### 1.1.1 Meta-données
- Mise a jour : Ce paragraphe est utilise pour suivre l evolution des versions. La derniere version en
vigueur doit etre reportee dans le premier paragraphe.
- Dependance : Permet de definir la liste ainsi que la version des scripts qui sont appeles. <Action> : peut prendre les valeurs suivantes -> cre, ano, evo, typo
Dans le cas d un changement cela permet de connaitre les scripts qui sont impactes. * cre : Création du script.
Pour le moment aucun script n exploite cette meta-donnee. * evo : Évolution du script -> Ajout de nouvelles fonctionnalités, Amélioration du code.
Present pour un future usage. * ano : Correction du code suite à un comportement inattendu.
* typo : Ajout de commentaires, de texte ou corrections gramaticales sans influence sur le code.
- Liste des options : La declaration des options n est pas obligatoire. <Auteur> : <Prenom> <Nom>
Si aucune declaration n est presente alors la librairie params.lib ne fait aucune action. <Version> : Format x.y.z
Dans ce cas les options par defaut -h, -log, -hist, -cpt, -s et -dbg ne seront pas disponible. Pour le suivi des versions on utilisera le versionnement sémantique (voir paragraphe III-1.2).
Si le script ne necessite pas d option mais que l on souhaite disposer des options par defaut, il #### 1.1.2 Paragraphe
faudras declarer une option bidon. ex: "# @OPT: f:bidon::::::"
Si la declaration existe alors le socle gerera les parametres en entree du script, ainsi que * Mise a jour : Ce paragraphe est utilisé pour suivre l'evolution des versions. La dernière version en
les options par defaut -h, -log, -hist, -cpt, -s et -dbg. Ces mots cle sont reserve et ne vigueur doit être reportée dans le premier paragraphe.
peuvent pas etre utilise par le script.
La declaration est realise dans le paragraphe "Liste des options et arguments". Chaque * Dependance : Permêt de définir la liste ainsi que la version des scripts qui sont appelés.
option est identifiee par l entete de ligne "# @OPT:" suivi de la description. Dans le cas d'un changement cela permêt de connaître les scripts qui sont impactés.
La description consiste en une liste de parametres separes par ":" Pour le moment aucun script n'exploite cette méta-donnée qui est presente pour un future usage.
<type>:<nom>:<var>:<nb_arg>:<def_val>:<OptE>:<OptI>:<ctl_val>
L ordre des parametre est fige et tous doivent etre presents. * Liste des options : La déclaration des options n'est pas obligatoire.
8 champs sont obligatoires, soit 7 caracteres ":" (on ne compte pas le caracatere ":" suivant @OPT).
Exemple de declaration valide :
# @OPT: fb:h::0:::
# @OPT: fb:s::0:::
# @OPT: f:dbg:SH_NIV_DEBUG:0/1:::
# @OPT: fb:log::0:::
# @OPT: f:hist:SH_ARG_HIST:0/1:10::
# @OPT: oM:i:G_INSTANCE:1/1:ALL:dbid:
# @OPT: oM:pr:G_PR_NOM:1/1:sq,t,l:
<type> : Propriete de l attribu defini par l agregation des lettres suivantes Si aucune déclaration n'est présente alors la bibliothèque params.lib ne fait aucune action.
f -> Option falcultative Dans ce cas les options par défaut -h, -log, -hist, -cpt, -s et -dbg ne seront pas disponible.
b -> Booleen
o -> Option obligatoire
M -> Argument transforme en majuscule
<nom> : nom de l option (sans le tiret) Attention le nom de l option est senssible a la casse. Si le script ne nécessite pas d'option mais que l'on souhaite disposer des options par défaut, il
faudra déclarer une option bidon. ex: "# @OPT: f:bidon::::::"
<var> : nom de la variable dans laquelle sera stockee le(s) argument(s) Si la déclaration existe alors le socle gèrera les paramètres en entrée du script, ainsi que
si plusieurs arguments alors un tableau sera initialise <var[n]> les options par défaut -h, -log, -hist, -cpt, -s et -dbg. Ces mots clé sont reservés et ne
L index [n] commence a zero. peuvent pas être utilisé par le script.
Le nombre d arguments effectivement passes a la commande est "${#<var>[*]}".
L valeur max de l index [n] est "${#<var>[*]} - 1".
<nb_arg> : nombre d arguments attendus de la forme "min/max", "min/", "max" ou "" La déclaration est réalisée dans le paragraphe "Liste des options et arguments". Chaque
si vide ou "0" alors l option est booleene. option est identifiée par l'entête de ligne "# @OPT:" suivi de la description.
la forme "min/" considere le nombre max non determine (infini)
<def_val>: Valeur par defaut assignee a <var> La description consiste en une liste de paramètres séparés par ":"
Fonctionne si <nb_arg> vaut 0/1 1/1 <type>:<nom>:<var>:<nb_arg>:<def_val>:<OptE>:<OptI>:<ctl_val>
<OptE> : Liste des options mutellement exclusives separees par une virgule. L'ordre des paramètre est figé et tous doivent etre présents.
<OptI> : Liste des options inclusives separees par une virgule. 8 champs sont obligatoires, soit 7 caracteres ":" (on ne compte pas le caracatere ":" suivant @OPT).
Exemple de déclaration valide :
# @OPT: fb:h::0:::
# @OPT: fb:s::0:::
# @OPT: f:dbg:SH_NIV_DEBUG:0/1:::
# @OPT: fb:log::0:::
# @OPT: f:hist:SH_ARG_HIST:0/1:10::
# @OPT: oM:i:G_INSTANCE:1/1:ALL:dbid:
# @OPT: oM:pr:G_PR_NOM:1/1:sq,t,l:
Lors de l initialisation les marqueurs "@OPT" sont lues et analysees. * <type> : Propriété de l'attribu défini par l'aggrégation des lettres suivantes:
Le resultat est compare aux arguments et options sousmis au script * f -> Option falcultative
et les variables suivantes son initialisees ... * b -> Booléen
* o -> Option obligatoire
* M -> Argument transformé en majuscule
- SH_OPTION_<nom> : Initialisee a "1" (Vrai) ou "0" (Faux) selon que l option est respectivement utilise ou non. * <nom> : nom de l'option (sans le tiret). Attention le nom de l'option est sensible à la casse.
Il existe toujours une variable par option declaree. Ceci concerne aussi les options par defaut
gere par la librairie params.lib
- SH_ARG_<nom> : Cette variable existe uniquement si le champ <var> est null et si le type n est pas booleen.
Par defaut elle est initialisee a null ou avec la valeur <def_val>
Si le champ <var> est renseigne, alors SH_ARG_<nom> est remplacee pas <var>.
Si l option associee peut prendre plusieurs arguments, alors les variables
SH_ARG_<nom> ou <var> sont des tableaux dont l index commence a zero.
La taille du tableau peut etre recuperee via ${#SH_ARG_<nom>[*]} ou ${#<var>[*]}.
Les option -h, -s, -log [id], -hist [N] et -dbg N * <var> : nom de la variable dans laquelle sera stockée le(s) argument(s)
sont prises en charge automatiquement. Ces noms sont donc reserves. si plusieurs arguments alors un tableau sera initialisé <var[n]>
L'index [n] commence à zero.
Le nombre d'arguments éffectivement passés a la commande est "${#<var>[*]}".
La valeur max de l'index [n] est "${#<var>[*]} - 1".
Les options par defaut realisent les actions suivantes : * <nb_arg> : nombre d'arguments attendus de la forme "min/max", "min/", "max" ou ""
si vide ou "0" alors l'option est booléene.
la forme "min/" considere le nombre max non determiné (infini)
-h : Affiche l aide du script (Ligne du cartouche qui commence par "##") * <def_val> : Valeur par défaut assignée à <var>
-s : Mode silence. Plus d'affichage sur le terminal. Fonctionne si <nb_arg> vaut 0/1 1/1
Initialise la variable SH_SILENCE a "oui"
-log [id] : Affiche le dernier journal ou le journal "id" (identifiant de session d'execution).
-cpt [id] : Affiche le dernier compte-rendu ou le Compte-rendu "id" (identifiant de session d'execution).
-hist [N] : Affiche l historique des "N" dernieres executions (N=10 par dafaut)
-dbg N : Activation du mode debug au niveau "N". Active les messages geres par la librairie fct_message
dont l'option -debug est utilisee.
- Arguments : La declaration des argument du script n est pas obligatoire * <OptE> : Liste des options mutellement exclusives séparées par une virgule.
Attention : Si aucune option "@OPT:" n est declaree alors il n y auras pas de prise en charge des arguments. * <OptI> : Liste des options inclusives séparées par une virgule.
Si votre script ne necessite pas d option, mais qu il presente des arguments, alors il faudras declarer
une option bidon :"# @OPT: f:bidon::::::"
La declaration est realise dans le paragraphe "Liste des options et arguments". Lors de l'initialisation les marqueurs "@OPT" sont lues et analysées.
Elle est identifiee par l entete de ligne "# @ARG:" suivi de la description. Le résultat est comparé aux arguments et options sousmis au script
Il ne peut y avoir qu une ligne de description pour les arguments. et les variables suivantes son initialisées ...
(Si plusieurs lignes avec le marqueur @ARG existe, alors seul la premiere et prise en compte)
La description consiste en une liste de parametres separes par ":" * SH_OPTION_<nom> : Initialisée à "1" (Vrai) ou "0" (Faux) selon que l'option est respectivement utilisée ou non.
<type>:<var>:<nb_arg>:<def_val>:<ctl_val> Il existe toujours une variable par option déclarée. Ceci concerne aussi les options par défaut géré par la bibliothèque params.lib
L ordre des parametres est fige et tous doivent etre presents. * SH_ARG_<nom> : Cette variable existe uniquement si le champ <var> est null et si le type n'est pas booleen.
Par défaut elle est initialisée à null ou avec la valeur <def_val>
Si le champ <var> est renseigné, alors SH_ARG_<nom> est remplacée pas <var>.
Si l'option associée peut prendre plusieurs arguments, alors les variables SH_ARG_<nom> ou <var> sont des tableaux dont l'index commence a zéro.
La taille du tableau peut etre récuperée via ${#SH_ARG_<nom>[*]} ou ${#<var>[*]}.
<type> : Propriete de l attribu defini par l agregation des lettres suivantes Les option -h, -s, -log [id], -hist [N] et -dbg N sont prises en charge automatiquement. Ces noms sont donc reservées.
f -> Argument falcultative
o -> Argument obligatoire
M -> Argument transforme en majuscule
<var> : nom de la variable dans laquelle sera stockee le(s) argument(s) Les options par défaut réalisent les actions suivantes :
si plusieurs arguments alors un tableau sera initialise <var[n]>
L index [n] commence a zero.
Le nombre d arguments effectivement passes a la commande est "${#<var>[*]}".
L valeur max de l index [n] est "${#<var>[*]} - 1".
Si <var> n est pas renseigne alors la variable SH_ARGS[] est initialisee -h : Affiche l aide du script (Ligne du cartouche qui commence par "##")
-s : Mode silence. Plus d'affichage sur le terminal.
Initialise la variable SH_SILENCE a "oui"
-log [id] : Affiche le dernier journal ou le journal "id" (identifiant de session d'execution).
-cpt [id] : Affiche le dernier compte-rendu ou le Compte-rendu "id" (identifiant de session d'execution).
-hist [N] : Affiche l historique des "N" dernieres executions (N=10 par dafaut)
-dbg N : Activation du mode debug au niveau "N". Active les messages geres par la librairie fct_message
dont l'option -debug est utilisee.
<nb_arg> : nombre d arguments attendus de la forme "min/max", "min/", "max" ou "". - Arguments : La declaration des argument du script n est pas obligatoire
si vide alors on considere que le nombre d arguments est a minima de 1.
la forme "min/" considere le nombre est a minima de "min".
<def_val>: Valeur par defaut assignee a <var> Attention : Si aucune option "@OPT:" n est declaree alors il n y auras pas de prise en charge des arguments.
Fonctionne si <nb_arg> vaut 0/1 1/1 Si votre script ne necessite pas d option, mais qu il presente des arguments, alors il faudras declarer
une option bidon :"# @OPT: f:bidon::::::"
ATTENTION La declaration est realise dans le paragraphe "Liste des options et arguments".
Si le caractere "&" est present dans la valeur d un argument, alors cette valeur doit etre encadree Elle est identifiee par l entete de ligne "# @ARG:" suivi de la description.
par une simple cote et le caractere "&" doit etre proteger par un anti-slash "\". Il ne peut y avoir qu une ligne de description pour les arguments.
(Si plusieurs lignes avec le marqueur @ARG existe, alors seul la premiere et prise en compte)
Le cas echeans le shell generera un fils qui tentera l execution d'un script portant le nom de la valeur de l argument. La description consiste en une liste de parametres separes par ":"
<type>:<var>:<nb_arg>:<def_val>:<ctl_val>
1.2 Versionnement semantique L ordre des parametres est fige et tous doivent etre presents.
1.2.1 Usage
L idee de l utilisation du versionnement semantique est de definir clairement les intentions
d un changement dans un code pour les clients de ce dernier. Ceci permet de fiabiliser la mise en
place de dependances et de determiner les impacts d un changement.
1.2.2 Format <type> : Propriete de l attribu defini par l agregation des lettres suivantes
Le format utilise est le suivant x.y.z f -> Argument falcultative
x est l identifiant de version majeure. o -> Argument obligatoire
y est l identifiant de version mineure. M -> Argument transforme en majuscule
z est l identifiant de version de correction.
1.2.3 Semantique <var> : nom de la variable dans laquelle sera stockee le(s) argument(s)
- Version majeure X : Il vaut "0" lors du developpement, le script est considere non valide et ne si plusieurs arguments alors un tableau sera initialise <var[n]>
devrait pas etre appele par d autre script. Une fois le script valide la version L index [n] commence a zero.
doit etre 1.0.0 (premiere version stable). Le nombre d arguments effectivement passes a la commande est "${#<var>[*]}".
Il doit etre incremente si des changements dans le code n assure plus la compatibilite L valeur max de l index [n] est "${#<var>[*]} - 1".
ascendante. Les identifiants de version mineure et de correction doivent etre remis
a zero quand l identifiant de version majeure est incremente.
- Version mineur y : Doit etre incremente lors de l ajout de nouvelle fonctionnalite ou d amelioration Si <var> n est pas renseigne alors la variable SH_ARGS[] est initialisee
du code qui n on t pas d impact sur la compatibilite ascendante. L identifiant de
version de correction doit être remis a zero lorsque l identifiant de version mineure
est incremente.
- Version de correction z : Doit être incremente si seules des corrections retro-compatibles sont introduites. <nb_arg> : nombre d arguments attendus de la forme "min/max", "min/", "max" ou "".
Une correction est definie comme un changement interne qui corrige un comportement incorrect. si vide alors on considere que le nombre d arguments est a minima de 1.
Il peut etre incremente lors de correction typographique ou grammaticale. la forme "min/" considere le nombre est a minima de "min".
<def_val>: Valeur par defaut assignee a <var>
Fonctionne si <nb_arg> vaut 0/1 1/1
ATTENTION
Si le caractere "&" est present dans la valeur d un argument, alors cette valeur doit etre encadree
par une simple cote et le caractere "&" doit etre proteger par un anti-slash "\".
Le cas echeans le shell generera un fils qui tentera l execution d'un script portant le nom de la valeur de l argument.
1.2 Versionnement semantique
1.2.1 Usage
L idee de l utilisation du versionnement semantique est de definir clairement les intentions
d un changement dans un code pour les clients de ce dernier. Ceci permet de fiabiliser la mise en
place de dependances et de determiner les impacts d un changement.
1.2.2 Format
Le format utilise est le suivant x.y.z
x est l identifiant de version majeure.
y est l identifiant de version mineure.
z est l identifiant de version de correction.
1.2.3 Semantique
- Version majeure X : Il vaut "0" lors du developpement, le script est considere non valide et ne
devrait pas etre appele par d autre script. Une fois le script valide la version
doit etre 1.0.0 (premiere version stable).
Il doit etre incremente si des changements dans le code n assure plus la compatibilite
ascendante. Les identifiants de version mineure et de correction doivent etre remis
a zero quand l identifiant de version majeure est incremente.
- Version mineur y : Doit etre incremente lors de l ajout de nouvelle fonctionnalite ou d amelioration
du code qui n on t pas d impact sur la compatibilite ascendante. L identifiant de
version de correction doit être remis a zero lorsque l identifiant de version mineure
est incremente.
- Version de correction z : Doit être incremente si seules des corrections retro-compatibles sont introduites.
Une correction est definie comme un changement interne qui corrige un comportement incorrect.
Il peut etre incremente lors de correction typographique ou grammaticale.
2 - Initialisation du socle. 2 - Initialisation du socle.