Petit manuel de SVN Express

Cette introduction est honteusement pompée, la licence me le permet :D

Utilisation et description des principales commandes

La première abbréviation à connaître est svn, pour subversion. Entre parenthèses se trouve l’abbréviation ou nom court de la sous-commande.

Toutes les commandes doivent être lancées à partir de votre copie de travail, par exemple /home/toto/N/nasgaia. Pour connaître les commandes, tapez :



Attention, Utilisez toujours les commandes Subversion (svn copy, svn move, svn delete, ...) pour manipuler les fichiers et non celles du système (cp, mv, ...), sinon Subversion ne pourra pas suivre l’évolution de votre copie de travail. Mais, vous pouvez éditer tous vos fichiers avec l’outil de votre choix.


checkout télécharge en local une copie de travail du projet, un répertoire mirabellug sera créé. C’est la première chose à faire pour travailler sur un projet. si vous voulez donner un autre nom, comme depot dans un répertoire nasgaia mirabellug, placez vous dans ce répertoire et faite le checkout en spécifiant depot à la place de nasgaia en dernier paramètre.

Toutes les commandes svn devront être éxecutées à partir de ce répertoire. Avec un accès anonyme, tapez :



ou avec le protocole http :



astuce : il est utile de se créer un alias pour éviter de taper votre commande
Qu'est ce que le répertoire .svn ??

Chaque répertoire d’une copie de travail locale contient une zone d’administration, un sous-répertoire nommé .svn. Quoi que vous fassiez ne le supprimez pas et ne le modifiez pas, il est nécessaire à Subversion pour gérer votre copie de travail.


Récupére les dernières modifications des autres membres, à utiliser systématiquement avant toute modification :



Ajouter une ressource dans la liste des ressources qui appartiendront au référentiel. L’opération ne sera effective qu’au moment du commit. Le fichier doit exister avant de l’ajouter.





Supprimer une ressource de la copie de travail avec effet immédiat sur celle-ci. Par contre, il faudra confirmer par commit cette modification pour modifier le référentiel.





Recopie une ressource d’un endroit du référentiel vers un autre endroit avec effet immédiat sur les ressources locales. Il faudra confirmer par commit cette modification pour modifer le référentiel. Pour copie le fichier dans le répertoire rep/





Déplace des ressources dans la copie de travail avec effet immédiat sur celle-ci. Par contre, il faudra confirmer par commit cette modification pour impacter le référentiel. Sert également à renommer une ressource. Pour renommer fichier1 en fichier2 :



déplacer fichier dans le répertoire rep/ :





Permet de savoir si vous avez des fichiers différents de ce qu’il y a dans le référentiel.





Annule les modifications locales non encore commitées. Revenir sur la version du référentiel de fichier :





Suit l’évolution d’une ressource du référentiel ou de la copie de travail.





Confirme tous les changements effectués sur votre copie de travail et les envoie sur le référentiel.



Quand vous commitez une modification, vous devez fournir un message la décrivant. Ce message sera attaché à la nouvelle révision créée. Un éditeur s’ouvre vous proposant de saisir un commentaire qui sera assigné à vos modifications.

--This line, and those below, will be ignored--
A fichier

Il faut alors saisir un commentaire au dessus de la ligne avec les deux tirets.
Je vais finalement aller me promener !
--This line, and those below, will be ignored--
A fichier

Après avoir sauvegardé et quitté l’éditeur, le commit sera effectivement effectué sur le référentiel. Si vous quittez l’éditeur sans sauver, Subversion vous demandera s’il faut quitter sans sauver (et ne pas commiter) ou s’il faut revenir à l’éditeur.

Si le message est court, vous pouvez utiliser l’option en ligne de commande –message (-m) :



Troisième possibilité, le message peut aussi être fourni par un fichier, dans ce cas utilisez l’option – file :

Ressources

Voici de quoi approfondir vos connaissances :-)

- Le manuel officiel en anglais, la référence
- Un excellent tutoriel en français, très utile
- Encore un excellent tutoriel en français très bien fait, et la source en LaTex est disponible \o/

GUI

Ceux qui sont allergiques à la ligne de commande ou qui préfèrent simplement un frontend graphique peuvent utiliser

- RapidSVN (dépendance avec wxWidgets)
- SmartSVN (en java, et non libre, mais vraiment bien foutu)

---