==========================================================
Tutorial - Getting Direct Access to the OJP CVS Repository
==========================================================
Note:  This tutorial is only for Windows OSes and TortoiseCVS 1.8.17.

1.  Go to https://www.freepository.com/ and sign up for an account.  Do NOT use spaces in your username.

2.  go to http://www.tortoisecvs.org/ and download the tortoiseCVS program.  We used version 1.8.17 for this tutorial.

3.  Install tortoiseCVS.  You might have to reset your computer to get all the Windows Explorer extensions to work.

4.  Log onto freepository with your new account.

5.  Click on "join a freepository".

6.  Sign up for the OJP repository
	freepository name = OpenJediProject
	freepository pass-code = openjedisource

7.  Using the pulldown tab on the Top Menu, select OpenJediProject

8.  Click on Secure ID entries.  This will send you an email.

9.  Check your email for that email.  The email will have something like
	:sserver:razorace@freepository.com:3025/mnt/usbhd/fp/fp1/222yx9P6fFHQYOpenJediProject 
	This is your CVSROOT (<yourCVSROOTHERE>).  You'll need this later.
	Note: if you don't get the email, you can still get your CVSROOT by clicking on the Secure ID entries button again.  DO NOT CUT/PASTE the example CVSROOTS, they will NOT WORK.

10. Grab the lastest SSH security certificate from the Downloads->Freepository Certificate on the freepository website.

11. Cut and paste the certificate into your .cvsSSLkeys (which should be in your tortoiseCVS directory).  You might have to create this file if you don't have it.  I did mine by using notepad.

12. You now need to modify your CVSROOT by adding a ";version=1" next to the ":sserver"
	This...
	:sserver:razorace@freepository.com:3025/mnt/usbhd/fp/fp1/222yx9P6fFHQYOpenJediProject
	would become this...
	:sserver;version=1:razorace@freepository.com:3664/mnt/usbhd/fp/fp1/222yx9P6fFHQYOpenJediProject

	But remember that you need to use YOUR CVSROOT, not the one used here.

13.  Open Windows Explore and right click on the folder where you want to place the repository files.

14.  Select CVS Checkout.  Cut/paste your modified CVSROOT into the CVSROOT field.

15.  Place a period (".") in the Module field.

16.  Click Ok.

17.  The program will now attempt to log into the repository.  If everything goes correctly, the program will give you a "Empty password Used" error and then give you a password prompt.

18.  Enter your password.  This is your personal freepository password and not the password you used to join our repository.

At this point the program should spend a long time downloading the repository to your system.  You now have access to the repository.  

I highly recommend that you install a "diff" program, which will handle all your comparision needs for when you want to compare the changes between files on the repository.

I personally suggest you use ExamDiff or ExamDiff Pro (which I use).  ExamDiff is free and can be found at...
	http://www.prestosoft.com/ps.asp?page=edp_examdiff

19.  Install Diff program.

20.  In Windows Explore, right click and then go to CVS->Preferences.

21.  Under the Tools Tab, Use the Diff Application field to direct TortoiseCVS to your diff program.

22.  You're done!



==================================
Getting to OJP Basic's Source Code
==================================

Basically, the source code for OJP Basic is in a different "branch" off the OJP Enhanced code, which is in the /Basic folder on the repository.  I know this is pretty confusing, but this allows us to easily merge changes between OJP Basic and OJP Enhanced.  (I was a huge newbie when I first set it up so that's why the folder names are so weird).

1. To get OJP Basic's branch, right click on the /OJP/Basic folder, and go to CVS->Update Special.  2. Select "Get tag/branch/revision"
3. Type in "OJP_BASIC" into the text field.
4. Click on "Create missing subfolders"
5. Then click ok.

This should make Tortiose make all the files in /OJP/Basic be of the Basic distro.  

Keep in mind that you can copy/move/rename CVS enabled folders without affecting where they are on the repository, as long as you keep the /cvs subfolders intact.  I personally use this ability to have seperate folders for each distro on my system.



==============================================
Tutorial for the Older Versions of tortoiseCVS and FreePository
==============================================

1.  Go to https://www.freepository.com/ and sign up for an account.  Do NOT use spaces in your username.

2.  go to http://www.tortoisecvs.org/ and download the tortoiseCVS program.  You can use a stable or beta version, whatever works best for you.

3.  Install tortoiseCVS.  You might have to reset your computer to get all the Windows Explorer extensions to work.

4.  Log onto freepository with your new account.

5.  Click on "join a freepository".

6.  Sign up for the OJP repository
	freepository name = OpenJediProject
	freepository pass-code = openjedisource

7.  Using the pulldown tab on the left, select OpenJediProject

8.  Click on Secure ID entries.  This will send you an email.

9.  Check your email for that email.  The email will have something like
	:sserver:razorace@freepository.com:3025/mnt/usbhd/fp/fp1/222yx9P6fFHQYOpenJediProject 
	This is your CVSROOT (<yourCVSROOTHERE>).  You'll need this later.
	Note: if you don't get the email, you can still get your CVSROOT by clicking on the Secure ID entries button again.  DO NOT CUT/PASTE the example CVSROOTS, they will NOT WORK.

10. Here comes the fun part.  You need now need to log your tortoiseCVS into the repository so that the program will know what your password is.  Download this file...
	http://ojp.jediknight.net/files/CVS1.zip

11. Unzip CVS1.zip to where ever you installed tortoiseCVS.

12. Open up login.bat with a text editor.

13. You now need to modify your CVSROOT by adding a ";version=1" next to the ":sserver"
	This...
	:sserver:razorace@freepository.com:3025/mnt/usbhd/fp/fp1/222yx9P6fFHQYOpenJediProject
	would become this...
	:sserver;version=1:razorace@freepository.com:3664/mnt/usbhd/fp/fp1/222yx9P6fFHQYOpenJediProject

	But remember that you need to use your own original CVSROOT, not the one used here.

14. Replace the example CVSROOT in the login.bat with your newly modifed CVSROOT.
	set CVSROOT=:sserver;version=1:razorace@freepository.com:3664/mnt/usbhd/fp/fp1/222yx9P6fFHQYOpenJediProject
	will be
	set CVSROOT=<yourCVSROOTHERE>

NOTE: you place your own CVSROOT (from step 13) where the <yourCVSROOTHERE> is.  Do not actually type in <yourCVSROOTHERE>.


15.  Save the file and then run it.  I recommend that you run it from the command prompt so that you'll see everything that goes on.  If you don't know how to run the command prompt, use Google to look up some DOS tutorials.

NOTE:  If you do run it from the command prompt, you need to be in the same directory as the bat file or you will get a file not found error for the cvs.exe.

16.  The program will prompt you for your password (use your freepository account password, not the one used for the repository as a whole).  If it worked, your .cvspass file in your tortiose directory will have some stuff in it (use a text editor).  Otherwise, you have a problem.  You can't use backspace or delete while typing in your password or it will not work.  Be careful.

At this point the program should spend a long time downloading the repository to your system.

