source: trunk/DOC/000-README-svn @ 151

Last change on this file since 151 was 151, checked in by aslmd, 14 years ago

DOC: An important modification to explain how to properly set you folder to download only a part of this SVN PLANETO's sources (which is the case for most users)

File size: 4.9 KB
Line 
1########################################
2##                                    ##
3##  BIENVENUE SUR LE SVN PLANETO !!!  ##
4##                                    ##
5##  PETIT MEMO                        ##
6##                                    ##
7##  -- AS 11/2010, 01/2011, 03/2011   ##
8##                                    ##
9########################################
10
11si vous lisez ceci, votre nom doit figurer sur 000-USERS.
12si ce n'est pas le cas, contacter la LMD team.
13
14##
15## OU CHERCHER DE L'AIDE ???
16##
17
18-- doc officielle [livre open source]
19        http://svnbook.red-bean.com/
20
21-- resume pratique des commandes
22        http://www.yolinux.com/TUTORIALS/Subversion.html
23
24-- page wikipedia pas mal
25        http://fr.wikipedia.org/wiki/Subversion_%28logiciel%29
26
27-- si vous etes perdus avec les commandes, faites
28                svn help
29
30##
31## VOUS ETES USER : COMMENT RECUPERER LES SOURCES SUR LE SERVEUR ?
32##
33
34-- pour faire descendre les sources il faut taper
35                svn co "http://svn.lmd.jussieu.fr/Planeto/trunk"
36                svn checkout "http://svn.lmd.jussieu.fr/Planeto/trunk"
37                svn checkout -r 67 "http://svn.lmd.jussieu.fr/Planeto/trunk" trunk.r67  [recuperer la version 67]
38[les fichiers relatifs au controle de version sont dans les repertoires caches .svn : ne pas effacer !!!]
39[la copie cachee, miroir de la derniere version sur le serveur, se trouve dans les repertoires .svn]
40
41-- pour faire descendre une partie des sources il faut d'abord taper
42                svn co "http://svn.lmd.jussieu.fr/Planeto/trunk" -N le_nom_de_mon_dossier
43   afin de creer un dossier racine 'le_nom_de_mon_dossier' qui contient les informations de l'arborescence
44   ... ensuite il suffit de faire
45                svn update DOC LMDZ.COMMON LMDZ.VENUS
46   pour ne recuperer qu'une partie des sources
47   ... toute commande 'svn update' et 'svn commit' ne porte alors que sur ces seuls dossiers descendus
48   [voir 000-MODELS pour plus de details sur l'arborescence]
49
50-- pour faire descendre les sources sans controle de version [utilise moins d'espace disque]
51                svn export "http://svn.lmd.jussieu.fr/Planeto/trunk"
52
53-- vous pouvez ne faire descendre qu'une partie des sources
54                svn co "http://svn.lmd.jussieu.fr/Planeto/trunk/mars" [GCM martien]
55                svn co "http://svn.lmd.jussieu.fr/Planeto/trunk/mesoscale" [Mesoscale martien]
56
57-- pour voir les changements effectues faire
58                svn log
59                svn log | more
60
61-- pour mettre a jour avec la derniere version sur le serveur
62                svn update
63[NB: svn update est une commande qui met a jour la copie cachee avec la derniere revision]
64                svn update *
65[si l'on n'a qu'une partie du trunk]
66
67-- pour afficher les infos du serveur, faites
68                svn info
69
70-- pour voir un fichier avec une historique des changements et des personnes "coupables" de ces changements
71                svn blame **fichier**
72
73-- pour ramener un fichier modifie localement a sa version sur le serveur
74                svn revert **fichier**
75[pratique quand on a teste des modifications que l'on veut annuler pour revenir a la version de reference]
76
77##
78## VOUS ETES en plus CONTRIBUTOR : COMMENT MODIFIER LES SOURCES SUR LE SERVEUR ?
79##
80
81-- pour propager les changements locaux au repertoire commun sur le serveur
82   ... meme pour un changement mineur il faut commenter
83                svn ci -m "bla bla bla bla"
84                svn commit -m "bla bla bla bla"
85                svn commit -F un_fichier_plein_de_remarques.txt
86                svn commit -m "commit seulement sur un fichier bla bla bla" **fichier**
87
88-- le mot de passe est demande au premier commit [il faut avoir modifie qqch sinon ca ne marche pas]
89
90-- au moment ou l'on commence a travailler dans le dossier, toujours faire
91                svn update
92SINON RISQUE DE TRAVAILLER SUR UNE VERSION ANCIENNE... voire RISQUE DE CONFLIT SVN
93
94-- refaire un
95                svn update
96avant de faire un commit pour les memes raisons [normalement on ne perd pas ses changements]
97
98-- pour verifier les changements effectues avant un commit, faire
99                svn diff
100                svn diff **fichier**
101qui permet de comparer les nouvelles versions locales avec la derniere revision officielle
102(non modifiee donc si vous n'avez pas fait commit)
103
104-- pour verifier les fichiers modifies, ajoutes, etc... avant un commit faire
105                svn status
106                svn status -qu  [pour enlever les cas "?"]
107
108-- pour ajouter un fichier (ou repertoire) a synchroniser avec le serveur, utiliser
109                svn add **fichier**
110NB: tant que le fichier n'est pas ajoute a la base des fichiers synchronises avec cette commande,
111svn ne le voit pas. pratique pour les fichiers locaux temporaires !
112
113-- similairement
114                svn delete **fichier**
115                svn mv **fichier** **ailleurs**
116                svn mkdir **directory**
117
118-- une fois le commit effectue, la copie locale peut etre entierement effacee (eventuellement);
119il suffit de faire redescendre les sources au prochain usage avec
120                svn co "http://svn.lmd.jussieu.fr/Planeto/trunk"
121NB: si on choisit de garder sa copie locale, penser au
122                svn update
123lorsqu'on revient y travailler apres quelque temps
Note: See TracBrowser for help on using the repository browser.