Svn 1uLorlal for Wlndows users

uownload and lnsLall Svn CllenL

uownload Lhe 1orLolse Svn cllenL from
hup://LorLolsesvn.neL/
uependlng on your operaung sysLem, you mlghL choose Lhe
32-blL or 64-blL verslons.
lnsLall, resLarL.
8lghL cllck on Lhe SLarL buuon (x users) or cllck on Lhe
Lxplore lcon on Lhe Laskbar (Wlndows 7 users)
CreaLe a local reposlLory
CreaLe a new dlrecLoy somewhere (perhaps under My
uocumenLs). l called mlne Svn_8epo.
8lghL-cllck on Lhe Svn_8epo folder. 1he menu LhaL pops up wlll
have a couple of new lLems: Lhe Svn CheckouL. and
1orLolseSvn. Choose 1orLolseSvn.
Cllck on CreaLe reposlLory here from Lhe menu LhaL pops up.
uo Lhe rsL Check CuL
Cnce Lhe reposlLory ls successfully
creaLed, rlghL-cllck on Lhe Svn_8epo
dlrecLory agaln, and choose Svn
CheckouL.
1he program wlll ask you for Lhe repo
address. lor Lhe LA-SlCMA pro[ecL, lL ls
hups://svn.ccL.lsu.edu/repos/proposals/
epscor09
LnLer Lhe user-ld and password provlded
by CC1.
1he checkouL process now sLarLs, and
creaLes an exacL repllca of Lhe Svn le
sysLem on your local drlve. ?ou should do
Lhls sLep whlle connecLed Lo a fasL
connecuon, because our repo has become
qulLe large.
?ou should allow a falr amouL of ume. [l
dld Lhls aL home, on a 34 Mbps wlreless,
and lL Look abouL 2.3 hours.]
ulrecLory SLrucLure
Aer a successful checkouL, you wlll see LhaL
several folders have appeared under
Svn_8epo. Mlne ls shown on le.
noLe Lhe red ! (exclamauon) and Lhe green
check marks appearlng on Lhe dlrecLory
lcons.
1he red symbol on Lhe Lop level dlrecLory
(epscor09) means LhaL one or more of Lhe
subdlrecLorles conLaln a le LhaL l have
changed, maklng my local verslon dlerenL
from Lhe copy on Lhe Svn.
1he green check marks lndlcaLe LhaL all Lhe
les ln Lhose folders have noL been changed
locally slnce Lhe lasL updaLe.
Worklng wlLh Lhe Svn: updaLe and CommlL
When worklng wlLh Lhe Svn on a
dally basls, Lhere are [usL Lwo Lhlngs
Lo remember: updaLe, and commlL.
8efore you sLarL worklng on any le
ln Lhe Svn, lL ls lmporLanL Lo make
sure you have Lhe mosL up-Lo-daLe
verslons of all les. lor Lhls, you
would do an updaLe from Lhe Svn
menu: rlghL cllck on Lhe dlrecLory
lcon, and choose Svn updaLe.
1he updaLe process coples only Lhe
les LhaL have changed slnce Lhe lasL
updaLe.
1he commlL process coples les you
may have changed locally Lo Lhe
cenLral Svn (so LhaL oLhers can geL lL
by updaung).
1he screen-shoL of an updaLe process
I had deliberately deleted four files from my local SVN repository prior to this
update. You can see that the update process restored those files from the
central SVN. Note that we are now at revision # 1049.
Commlmng changes - 1
lf you make changes Lo a le, or lf
you creaLe a new le, lL needs Lo be
commlued (noL ln Lhe psychlaLrlc
sense ln mosL cases) so LhaL oLhers
can see lL.
ln Lhe screen shoL Lo Lhe rlghL, l
have dellberaLely modled one of
Lhe les. noLe LhaL lL ls marked by a
red exclamauon mark all Lhe way
up Lhe dlrecLory Lree Lo Lhe Lop
level.
noLe LhaL all Lhe oLher les (and
sub-folder) have green check
marks, lndlcaung LhaL Lhelr
conLenLs are conslsLenL wlLh Lhe
cenLral Svn.
lf you creaLe a new le, lL wlll noL
have any mark on lL, whlch ls a clue
LhaL Lhe cenLral Svn knows noLhlng
abouL LhaL les exlsLence.
Commlmng Changes - 2
1he screen shoL shows LhaL l
am abouL Lo commlL Lhe le
LhaL l changed.
Commlmng
Changes - 3
When you choose Lhe Svn
CommlL menu, a wlndow pops up
ln whlch you can Lype a noLe LhaL
explalns whaL you have changed.
1hls noLe wlll become parL of Lhe
Svn change log and, lf Lhe Svn ls
e-mall enabled, an auLomauc e-
mall ls generaLed Lo all auLhorlzed
users alerung Lhem of your
change.
Now we are at revision #
1050.
Cne more sllde on commlL
lf all goes well wlLh Lhe commlL,
when l refresh my dlrecLory, Lhe red
exclamauon mark wlll change Lo a
green check mark, Lelllng me LhaL l
have achleved a harmonlous unlon
wlLh Lhe greaL moLher Svn.

?ou may noLe LhaL Lhere ls sull a red
exclamauon mark on Lhe hlgh level
dlrecLory epscor09. 1hls never
goes away on my deskLop machlne.
l Lhlnk lL ls an arufacL of my 64-blL
cllenL noL lnLeracung wlLh Lhe
cenLral Svn. l run Lhe 32-blL cllenL
appllcauon on my lapLop and lL does
noL have Lhls problem.
Clean up
Someumes, Lhlngs go wrong, and
conlcLs arlse.
Cne way Lo resolve Lhe conlcL ls
Lo use Lhe Clean up menu from
1orLolseSvn.
lf LhaL does noL work, you should
copy Lhe conlcLed les (noLe Lhe
yellow Lrlangle marks) Lo anoLher
dlrecLory, deleLe Lhem from Lhe
local Svn 8epo, and do an
updaLe.
1haLs lL! Pave fun.