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