Document mis à jour le   : 13/03/2014
version concernée du CDT : 4.9.4.4

+---------------------------------------------------------------+
| Technique utilisée pour la montée de version de l'application |
+---------------------------------------------------------------+

Voir la doc en ligne : http://dev-eole.ac-dijon.fr/projects/envole/wiki/GitMonteeVersion

UPSTREAM :
----------
- Télecharger la version 4944 de cdt sur le site.

- Se placer dans le dépot cdt sur la branche upstream.

- Copier dans src/cdt-4944 la version téléchargée de cdt 4944

PATCH :
-------
- Se placer sur la branche patch du dépôt cdt.

- Merger la branche upstream dans patch

- Nettoyer les fichiers en trop dans les sources :
	* on supprime le dossier "install"
	* on supprime le fichier de connexion "Connections/conn_cahier_de_texte.php" qui sera templatisé dans la master
	* on supprime tous les fichiers inutiles "Thumbs.db" (find . -name Thumbs.db -exec rm -f {} \;)
	* TODO: une commande pour supprimer tous les "^M" de windows présents dans les fichiers ?

- Pour prendre en compte les modifications à apporter à la branche patch de la version cdt 4944, on va lister les fichiers qui ont subit une mise à jour pour envole :
	* Identifier les 3 hash de l'historique git (git log--oneline) correspondant à :
		+ le hash de référence de la version antérieure de cdt téléchargée : 4937 (b40ac89)
		+ le hash de référence de la version antérieure de cdt patchée pour Envole (216e426)
		+ le hash de référence de la version nouvelle de cdt téléchargée : 4944 (en principe, le pointeur est sur uptream) (d43fe43)
	* Remarque : un petit caffouillit dans le dépôt fait que l'historique des branches upstream et patch est remplit de celui de dist/..... Ne pas en tenir compte, ne prendre en compte que les fichiers dans src/cdt-4937
	* Trouver les changements pour envole entre la branche upstream et patch pour la version précedente (dans src/cdt-4937) : 
		+ git diff b40ac89 216e426 --name-only .
 		
	* Trouver les changements entre les 2 versions sources de cdt (ancienne : 4937 et nouvelle : 4944) :
  		+ git diff b40ac89:src/cdt-4937/ d43fe43:src/cdt-4944/ --name-only

	* Dans un tableur par exemple, mettre en paralèlle la liste des fichiers du premier listing et la liste du second listing. Voir le fichier modifs-fichiers.xls joint
	* A partir de ce tableur, on trouve 3 cas :
		+ Lignes non surlignées : Le fichiers n'ont subit des modifications QUE dans les versions téléchargées : pas besoin d'y toucher
		+ Les lignes surlignées en vert : les fichiers n'ont pas subit de modifications entre les versions téléchargées MAIS ont été modifiées pour Envole : recopier ces fichiers de src/cdt-4937 (branche patch) vers src/cdt-4944 (branche patch)
		+ Les lignes surlignées en gris : les fichiers ont subit des modifications entre les versions téléchargées ET ont été modifiées pour Envole :
			--> 2 SOLUTIONS :
				** Faire un diff entre les branche upstream et patch pour la version précedente pour chaque fichier : git diff b40ac89 216e426 src/cdt-4937/administration/import-sconet.php pour faire ce qui avait été modifié en version antérieure et reporter les modification dans la branche patch courante (de la nouvelle version)
				** Si les modifs sont trop conséquentes avec la méthode ci-dessus (cas de authentification/auth.php et index.php) : recopier le fichier provenant de la version 4937 patchée pour envole vers la branche patch courant et modifier en prenant en compte les différences des versions téléchargées : git diff b40ac89:src/cdt-4937/authentification/auth.php d43fe43:src/cdt-4944/authentification/auth.php
		+ pour infos dans les lignes surlignés vertes, les fichiers suivant sont des ajouts Envole
			- "inc/cas_envole.inc.php"
			- "consultation.php"
			- "administration/misajour/maj_envole.php"
			- "erreur403.html"
			- ".htaccess" dans les répertoires "fichiers_joints", "fichiers_joints_message" et "exportation"
			- index2.php : fichier ayant disparu des sources de la version 4.9.3.7 car prise en charge du mode d'affichage dans "index.php" mais que l'on conserve
			- mobile/index2.php : fichier ayant disparu des sources de la version 4.9.3.7 car prise en charge du mode d'affichage dans "mobile/index.php" mais que l'on conserve
		+ Dans cette version 4944 :
			- le fichier fluxEnvole.php est récupéré de tmpl/ (master) et replacé dans src/cdt-4944 car ne nécessite pas de templatisation
			- le fichier widgetCdt.php est utilisé le widget posh.

MASTER : 
--------
- Se placer sur la branche master du dépôt cdt.

- Merger la branche patch dans master

----->	Différences de gestion par rapport à la version précédente de cdt dans envole :
	-------------------------------------------------------------------------------
	- Réalisation de la templetisation du fichier de configuration Connections/conn_cahier_de_texte.php
	- La création de la base de données n'est plus réalisée en postservice (via un script php dans sharenvole) mais directement
	- La mise à jour du cdt est réalisé par le script postservice 00_cdt qui lance un script web (maj_envole.php) php via curl

- Ne pas oublier de changer le numéro de version de cdt dans le Makefile



