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/">http://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>