]> i-scream Git - www.i-scream.org.git/blob - www/cvs.xhtml
1797d68c0c6ed7a74734230f64ee3c8b28421f1c
[www.i-scream.org.git] / www / cvs.xhtml
1 <!--#include virtual="/doctype.inc" -->
2   <head>
3     <title>
4       i-scream cvs repository
5     </title>
6 <!--#include virtual="/style.inc" -->
7   </head>
8   <body>
9     <div id="container">
10       <div id="main">
11 <!--#include virtual="/header.inc" -->
12         <div id="contents">
13           <h1 class="top">
14             i-scream CVS Repository
15           </h1>
16           <p>
17             The i-scream CVS Repository contains all code,
18             documentation, and other files pertaining to all i-scream
19             projects.
20           </p>
21           <p>
22             All code available in the CVS Repository is
23             <a href= "/license.xhtml">licensed</a> under the GPL.
24           </p>
25           <h3>
26             Web Access
27           </h3>
28           <p>
29             We use <a href="http://viewcvs.sourceforge.net/">viewcvs</a>
30             to provide a visual frontend to the CVS Repository. It
31             allows you to browse around the repository, viewing any
32             version of a file, and the differences between different
33             versions. There is also a link to download the latest
34             version of any section.
35           </p>
36           <p>
37             <a href="http://cvs.i-scream.org/">http://cvs.i-scream.org/</a>
38           </p>
39           <p>
40             We also have a facility to allow people to keep tabs on
41             what's changed recently. The following are available:
42           </p>
43           <ul>
44             <li><a href="/cgi-bin/cvslog.cgi?period=today">Commits today</a></li>
45             <li><a href="/cgi-bin/cvslog.cgi?period=thisweek">Commits this week</a></li>
46             <li><a href="/cgi-bin/cvslog.cgi?period=days&amp;days=7">Commits in the past 7 days</a></li>
47             <li><a href="/cgi-bin/cvslog.cgi?period=since&amp;date=2001/03/29">Commits made since 29/03/2001</a></li>
48           </ul>
49           <h3>
50             Anonymous CVS Access (read-only)
51           </h3>
52           <p>
53             Anyone can access the i-scream CVS repository in anonymous
54             mode read-only mode. The following commands will allow you
55             to check out a portion of the CVS repository. To see what
56             is available it is recommended that you first look at the
57             web frontend.
58           </p>
59           <pre>
60 cvs -d :pserver:anonymous@cvs.i-scream.org:/cvs/i-scream login
61 cvs -d :pserver:anonymous@cvs.i-scream.org:/cvs/i-scream checkout [module]
62 </pre>
63           <p>
64             When asked for a password, simply press enter. Replace
65             [module] with the section you wish to checkout.
66           </p>
67           <h3>
68             Developer CVS Access (write)
69           </h3>
70           <p>
71             The i-scream development team have full write access to the
72             CVS repository. This is only available over SSH, and can be
73             done on most clients. First the following environment
74             variables need to be set.
75           </p>
76           <pre>
77 CVS_RSH = ssh
78 CVSROOT = :ext:username@cvs.i-scream.org:/cvs/i-scream
79 </pre>
80           <p>
81             You should know your username and password already. After
82             setting these you will need to enter your password each
83             time you use a CVS command. Obviously this is a time
84             wasting event, so an RSA key can be generated and placed on
85             the server for you. Please view the relevant ssh manpages
86             on how to generate an RSA key pair.
87           </p>
88           <p>
89             After this you will be able to work with CVS as normal.
90           </p>
91           <h3>
92             Other means of accessing CVS
93           </h3>
94           <p>
95             We currently provide <a href="http://www.cvsup.org/">CVSup</a>
96             access to the repository, either for mirroring or for
97             maintaining an up-to-date local copy. You will probably
98             want to create a supfile that looks something like this;
99           </p>
100           <pre>
101 *default host=cvsup.i-scream.org
102 *default base=/home/user/sup
103 *default prefix=/home/user/i-scream
104 *default release=cvs
105 *default delete use-rel-suffix
106 *default compress
107 i-scream.cms.source tag=.
108 </pre>
109           <p>
110             The last item in that list is the collection you which to
111             get. The collection "i-scream" is simply the whole
112             repository, and is best used with no tag specified for
113             mirroring. It is most likely that you will want to do that
114             given above, which gets the latest copy of the i-scream
115             source code.
116           </p>
117           <h3>
118             CVS Statistics
119           </h3>
120           <p>
121             There are some statistics available on the cms module
122             of the CVS repository, generated by
123             <a href="http://cvsplot.sourceforge.net/">cvsplot</a>,
124             that allow you to see the progress of development.
125             They're not that exciting, but do show when the work
126             was done.
127           </p>
128           <p>
129             <a href="/cvsplot/">http://www.i-scream.org/cvsplot/</a>
130           </p>
131         </div>
132 <!--#include virtual="/footer.inc" -->
133       </div>
134 <!--#include virtual="/menu.inc" -->
135     </div>
136   </body>
137 </html>