Page d'aide à l'utilisation de l'interface bzr-gtk

bzr-gtk est une interface "facilitant l'usage de bazaar", cependant avant d'utiliser cette interface il est préférable de se familiariser à la gestion de projet et plus particulièrement à l'usage de la commande bzr.

L'interface actuellement est encore en phase beta, quelques bugs peuvent exister.

Vous devrez installer certains outils pour pouvoir travailler sur un projet

sudo apt-get install bzr bzr-gtk

Pour plus d'informations sur la commande bzr veuillez consulter la documentation Bazaar User Guide (en)

bzr help
bzr help commands # Liste des commandes
bzr help xxx # Aide sur la commande xxx

Définissez votre identité

bzr whoami "Votre Nom <email@exemple.com>"

La configuration de votre bazaar se trouve dans $HOME/.bazaar

• bazaar.conf options de configuration
• locations.conf options de configuration des branches
• authentication.conf configuration des serveurs distants

Bien qu'il soit bien plus rapide et fiable d'utiliser la ligne de commande, il existe une interface pour gérer votre bazaar.

L'interface bzr-gtk se présente comme suit :

• Liste à puce
• Une barre de menu regroupant les actions possibles en fonction du contexte.
• Une barre d'outils des actions coutantes.
• 1 → L'emplacement dans votre arborescence, permet également de changer d'emplacement.
• 2 → Le contenu du répertoire courant.
• 3 → La fenêtre des marques pages, correspondant à des emplacements définis dans votre arborescence.

La première action consistera à aller dans le menu Fichiers/File et d'ajouter un marque page du répertoire courant (~/Projets)/Bookmark current directory

Sélectionner dans le menu Branch/Initialize, une boite de dialogue apparaît, entrez les informations comme ci-dessous.

Revient au même que :

mkdir MonProjet && cd MonProjet && bzr init

Vous pouvez voir votre dossier MonProjet dans la partie de droite de bzr-gtk, Vous pouvez entrer dedans en double-cliquant sur l'icône du dossier. Afin de pouvoir accéder plus rapidement à votre projet, vous pouvez ajouter un marque page comme expliqué plus haut.

L'interface bzr-gtk, n'étant pas vraiment un gestionnaire de fichiers, nous allons créer 3 fichiers en ligne de commande.

cd ~/Projets/MonProjet && touch fichier1 fichier2 fichier3

Pour marquer les nouveaux fichiers à ajouter menu File/Add

Pour valider l'ajout et/ou la modification de fichiers cliquez sur le Bouton Commit ou menu Branche/Commit.

Pour consulter l'historique de votre projet. Cliquez sur le bouton Log ou menu Statistics/Log

Pour consulter les différences entre la version encours non "commitée" et la dernière de version du fichier. Cliquez sur le bouton Diff ou menu Statistics/Diff.

• Le - devant la ligne indique que la ligne à été supprimée
• Le + devant la ligne indique que la ligne a été ajoutée

Pour créer un sous dossier dans votre projet menu File/Make directory. Indiquer un nom de répertoire et cliquez sur Versioned directory. Ceci revient au même que :

mkdir SousDossier && bzr add SousDossier

Sélectionner le fichier ou le dossier à renommer et menu File/Rename

Sélectionner le ou les fichiers que vous souhaitez supprimer et menu File/Remove

Si vous êtes seul à travailler sur votre projet, vous n'avez pas à vous soucier des mises à jours effectués pas d'autres personnes.

Cependant en équipe vous devez avant d'effectuer des modifications vérifier que des modifications n'ont pas été effectuées par d'autres. Première chose vous devez faire un pull du serveur launchpad vers votre répertoire projet. Cliquez sur le bouton Pull

Néanmoins si vous aviez fait des modifications avant de faire le pull et que quelqu'un d'autre avait modifié les même fichiers, dans de cas vous devrez faire un merge.