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