Commandes Git de tous les jours

Get VLE

 * To download the development branch of VLE:


 * To download the current stable branch of VLE:


 * To download a tagged version of VLE

Création d'un patch
La création d'un patch se déroule en trois étapes, le téléchargement des sources ou de la dernière branche, la création du patch et l'envoi au mainteneur officiel.


 * Développer dans VLE :
 * Si vos patchs demandent des modifications, la procédure classique est la suivante :
 * Modification du commit le plus récent :
 * Fusion de commits :
 * Modification d'un commit dans un ensemble de commits :
 * De temps en temps, il est nécessaire de mettre votre dépôt à jour par rapport au dépôt public de VLE :

Syntaxe pour les patchs
Un patch possède une syntaxe bien définie. Elle est composée de deux partie. Une première qui indique de manière succincte le rôle du patch et la deuxième de plus complète. À noter que la description complète peut inclure des références sur les identifiants des bogues et autres fonctionnalités du bugtracker. Dans ce cas, il faut ajouter (closes: #xxx, #yyy). bibliothèque: libre jusqu'au 53e caractère
 * Le format du message est le suivant :

Une description plus complète du patchs, avec l'utilisation d'item si nécessaire. Comment ? Pourquoi ? La taille ne doit pas dépasser 72 caractères * On peut également ajouter des listes pour bien montrer les différentes parties du patch. * etc. gvle: fix crash when move cursor
 * Des exemples simples à éviter :

vle: add get function in condition class

Add a copy constructor to the external event
 * Un exemple plus complet :

* Add new swap functions to the devs::Event and devs::ExternalEvent (closes: #321654987). * Add a copy constructor to build easyly new external events (closes: #321,#654).

Création d'un dépôt distant
La création d'un nouveau dépôt commence par la création du dépôt local avant la création du dépôt distant (dans notre cas sur le serveur vle).


 * Création du dépôt local

Il faut se placer à la racine de son projet et initialiser le dépôt local. Un répertoire .git est créé à la racine de votre projet.


 * Configuration du dépôt local

Avant d'aller plus loin il s'agit de configurer votre environnement Git avec vos nom et prénom ainsi que votre adresse mail.

git config --global user.name "Gauthier Quesnel" git config --global user.email quesnel@users.sourceforge.net git config --global color.diff auto git config --global color.status auto git config --global color.branch auto


 * Ajout des fichiers du projet au dépôt local

L'ensemble des fichiers du projet doivent être ajoutés au dépôt local. Attention de bien vérifier que tous les fichiers doivent être rattachés au projet. Si ce n'est pas le cas, il faut ajouter individuellement chaque fichier.

Si un fichier a été ajouté accidentellement, la commande git rm supprime le fichier du dépôt.

Il faut maintenant procéder au commit initial. Un éditeur de texte s'ouvre afin de spécifier le texte du commit initial.

Votre dépôt local est maintenant prêt à être publié sur un dépôt distant.


 * Création du dépôt distant

Il faut se connecter sur le serveur distant (en l'occurrence vle-project.org) en ssh.

Dans votre compte (sur vle-project.org), on crée au préalable un répertoire git pour tous vos dépôts distants si ce n'est pas déjà fait.

Nous allons maintenant créer un dépôt vide en initialisant un dépôt vide et autoriser les push sur ce serveur (vle-project.org).

Depuis la machine locale, il faut alors placer le contenu du dépôt local sur le dépôt distant.


 * Accès en gitweb

Nous allons publier son contenu sur gitweb (attention, il faut être root).

Utilisation des tag

 * Poser un drapeau :
 * git tag X</tt> : poste le drapeau X sur le commit courant.
 * git tag</tt> : liste l'ensemble des drapeaux.
 * git checkout -b nouvellebranche X</tt> : crée une nouvelle branche nouvellebranche dont le dernier commit pointe sur le drapeau X.
 * Par exemple, pour poser un tag sur un projet et l'envoyer sur le serveur, il suffit de faire :
 * Créer une branche distante à partir tag
 * Il peut être nécessaire, après la création d'un drapeau, de créer une branche à partir de ce drapeau et ainsi de proposer facilement à l'utilisateur un moyen de contribuer à n'importe qu'elle branche. VLE emploie ce système. Pour créer une nouvelle branche à partir d'un tag :