[Ddmodd-developers] complete wincvs HOWTO (again)

[<ddm...@li...>]

well, here it is, complete. any errors, please report them to me, and
ill fix them:

-----------------------------------------------------------------------
--

Right, we've now gotten to the point where we cant really continue
without most people on the project using wincvs. to ease the setup
process, ive written the following report. 

the following people NEED to have wincvs working:
all artists and designers, aswell as the scripters.

the web developres dont need wincvs, but might want to set it up now, so
that we can answer any questions:

1.- install a CLEAN copy of dink smallwood, version 1.06. it can be
downloaded from:

http://prdownloads.sourceforge.net/ddmodd/dinksmallwood106.exe

2.- in the root folder of the dink install, make a new directory , and
call it something like "ddmodd1", or "dmod1". this is folder is also
referred to(in this guide) as the "local cvsroot"

3.- download wincvs, and install it in your default program files
directory.(for me, it was d:\program files\wincvs). wincvs can be
downloaded from:

http://thomi.imail.net.nz/WinCvs13b8.zip

NOTE: you need some newish dll's for wincvs to work properly. for more
info:

http://www.wincvs.org/faq.html

4.- run wincvs. at the first opportunity, exit out. if you have to fill
in any values, just make them rubbish values. it doesn't matter at this
point.^^^^^^^^^^^^^^^^^^^^^^this is really important. dont ask why :-)


5.- download sfsetup. you can get it from here:

http://prdownloads.sourceforge.net/sfsetup/sfsetup-v1.2.zip

6.- unpack and run sfsetup.exe. 
on the second screen, get it to install ssh aswell (its a checkbox you
have to tick).then fill in the values. the values you will need are:

i:   directory to install ssh to (mine was: d:\program files\ssh)

ii:  ssh setup directory (i used the same as above again)

iii: home directory (again, i used the same)

iv:  sourceforge username. that is, the name you signed up to
sourceforge     with. (mine is "tullisti")

v:   Project name. "ddmodd"

vi:  MAKE SURE YOU _UN_TICK THE "checkout read only"
     ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
     (also REALLY important)

vii: your sourceforge user name (again....)

viii: the directory you will be keeping the checked out sources. this is
the local cvsroot you made earlier (the dink root dir, plus "ddmodd1" or
something similar.

thats it. now click next, then the "start" button. then click finish.

we're not quite done yet though.now you have to reload wincvs, and fill
out the values there.

you should see a three pane window. ignore the bottom pane for now. the
left pane has a folder in it, called "ddmodd1" (or something).go to:

admin menu -> command line...

and enter into the box the following:

cvs -z9 -d:ext:dev...@cv...:/cvsroot/ddmodd
co modulename 

make sure you replace the "developername" with your sourceforge
username, and "modulename" with a "." (thats right, a single full stop) 

btw, the above is actually meant to be all one line, and thes a space
between 'co' and '.'

now click the check box on that page, and select your localcvsroot
folder again.

ok, when you're ready, click ok

a ssh msdos window will appear on your taskbar. pull it into focus, and
when it says "password:", enter in your password (that is, your
sourceforge password). YOU WONT SEE THE LETTERS AS YOU TYPE THEM. YOU
WONT EVEN SEE AN*******) and you cant use the backspace key...

hit enter once your password is in. now if you look at the bottom pane
in the wincvs window, it should say what its doing. as it downloads
files, it'll print their names on the bottom pane.

the dmods about 30 megs, so if you're on dialup, be prepared..

-- thats it. you now have the base dink game. however, just read this
next little bit..... --




okay, now. suppose you want to get work on the dmod. BEFORE you touch
anything, you need to get the latest files from the server. ok? so...

start wincvs. click on the local cvsroot folder icon, in the left hand
pane, and then click on the green downwards pointing arrow, on the
toolbar at the top.

check the box "make missing directories...", and under the globals tag,
make sure that the box "checkout read only" is UNTICKED. then set the
tcpip compression to nine.

click ok. enter your password as before, hit enter, and all that is
downloaded, are the files which have changed since you last downloaded
them. most likely, it'll be the map file, which is only a couple of
megs....

-- now go change some thing, do your stuff, develop the game etc. etc.
--

now, you have made changes. you need to upload your changes to the
server. simple.

click the local cvsroot folder in the left pane. click the other arrow.
the red one pointing upwards. enter a meaningfull log description. THIS
IS REALLY IMPORTANT. say the game breaks all of a sudden. we need to be
able to go back through the logs, and find oyt when, and then why.
something like"added the script for the common slayer enemy
(story\en-slay.c). fixed bug when char select screen froze, when the
midi stopped playing"

adding your name to the log might help aswell. (make sure that the word
wrap chackbox is ticked. it'll make life alot easier)

then click OK. you might want to do a sanity check on the other
checkboxes, but everything should be fine and dandy.

now enter your password, just like before, and wait while your changes
are uploaded. it is important that you upload frequently, so that other
people can download them, and know that they're getting the latest
versions of it.

-----------------------------------------------------------------------
----

so thats it. any probs, email me, ok?
-- 

Thomi Richards
th...@im...
http://www.sourceforge.net/projects/ddmodd/
want to get involved?? we're looking for artists!