Moodle Docs: How to use CVS

From d391e3b1eedd1651ab7a49d713e4f881019fcef9 Mon Sep 17 00:00:00 2001 From: moodler Date: Thu, 28 Nov 2002 03:05:24 +0000 Subject: [PATCH] First quick version of help on CVS --- doc/cvs.html | 87 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 87 insertions(+) create mode 100755 doc/cvs.html diff --git a/doc/cvs.html b/doc/cvs.html new file mode 100755 index 0000000000..0c91aeffc3 --- /dev/null +++ b/doc/cvs.html @@ -0,0 +1,87 @@ + + + + Moodle Docs: How to use CVS + + + + +

How to use CVS

+
CVS is the Concurrent Versioning System. It's a commonly used way +of storing source code because it keeps versions of all files so +that nothing is ever lost, and usage by different people is tracked.
+ +
To use Moodle's CVS archive (as a developer) from a Unix machine, you first + need to have an account on Sourceforge. For + the example, let's assume your username is myusername and your + password is mypassword. Secondly, you need to contact <A + HREF="http://dougiamas.com/">Martin</A> to get write access + to particular directories.
+
With that done, you should have all the permissions you need, so you just need + to set up your machine and download the current sources so you can start working + on them.
+
Sourceforge CVS uses ssh as a transport layer for security, so you will have + to set this CVS_RSH environment variable in your Unix shell:
+
+
setenv CVS_RSH ssh (for csh, tcsh etc)
+ +
export CVS_RSH=ssh (for sh, bash etc)
+ +
+
It's best to put this in your .bashrc or .cshrc so you don't have to type it + all the time. Then, check out Moodle using this (all one line):
+
+
cvs -z3 -d:ext:myusername@cvs.moodle.sourceforge.net:/cvsroot/moodle co moodle
+ +
+
Don't try to do run this first CVS command into an existing moodle directory + - start fresh with a new directory.
+
Note that you will be prompted for mypassword with each CVS + command. To avoid this, follow the Sourceforge + directions about using authorized keys.
+
Now, you should have a new 'moodle' directory. You can rename it and move it + around if you like. Go into it:
+
+
cd moodle 
+ +
+
All the latest Moodle files should be in there. You can now change files in + your copy. To compare your files against the main CVS copy on the server use + cvs diff, eg:
+
+
cvs diff -c config-dist.php
+cvs diff -c lang
+ +
+
To fetch the latest updates from the server use:
+
+
cvs update -dP 
+ +
+
To copy your new files back to the server you would do:
+
+
cd lang/ca 
+cvs commit 
+ +
+
You will be prompted to add some comments (depends on your default text editor) + ... add a comment and close the editor ... the files will be sent to Sourceforge + and stored. Done!
+
To save more time you can put default arguments into a file called .cvsrc in + your home directory. For example, mine contains:
+
+
diff -c 
+update -dP 
+ +
+
Try 'cvs help' for more details ...
+

+ +

Moodle Documentation

Version: $Id: features.html,v 1.2 2001/12/09 + 10:34:19 martin Exp $

+ + + -- 2.39.5