sane-project-website/cvs.html

155 wiersze
5.8 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>SANE - CVS Access</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<meta name="author" content="Henning Meier-Geinitz">
<meta name="keywords" content="sane, scanner, cvs, cvsweb, development, unstable">
<meta name="description" content="SANE CVS server">
<link href="mailto:hmg-guest@users.alioth.debian.org" rev="made">
<link rel="icon" href="favicon.ico" type="image/x-icon">
<link rel="shortcut icon" href="favicon.ico" type="image/x-icon">
</head>
<body bgcolor="#FFFFFF" text="#000000">
<center>
<a href="http://www.sane-project.org"><img src="images/sane.png"
alt="SANE" height="117" width="346" border="0"></a>
</center>
<center>
<h1><a
href="https://alioth.debian.org/scm/?group_id=1308"
target="_top">SANE - CVS Access</a></h1>
</center>
<hr>
<p>
CVS, the <a href="http://www.gnu.org/software/cvs/">Concurrent Versions
System</a>, is used to develop SANE. To get the latest SANE software
(sane-backends and sane-frontends) our CVS server can be used. But keep
in mind that the software in CVS is not tested so the risk of bugs is
much higher than with stable releases.
</p>
<p>
There is development and anonymous CVS access. If you are not a
developer, please use the anonymous access as mentioned below.
</p>
<h2>Anonymous CVS Access (Read-Only)</h2>
<p>
To use <em>anonymous</em>
CVS, use the following commands (just press enter when asked for the
password):
</p>
<pre>
cvs -d:pserver:anonymous@cvs.alioth.debian.org:/cvsroot/sane login
cvs -z3 -d:pserver:anonymous@cvs.alioth.debian.org:/cvsroot/sane co sane-backends
</pre>
<p>
Replace <em>sane-backends</em> by <em>sane-frontends</em> to get the
source code of sane-frontends. For more details on how to use CVS please
consult the man page <em>cvs(1)</em>.
</p>
<p>
If you just want to look at one file and don't want to download the
whole CVS tree, you can use cvsweb or any other of the methods mentioned
on the <a href="https://alioth.debian.org/scm/?group_id=1308"
target="_top">Alioth CVS page</a> to browse the tree.
</p>
<h2>Developer Access to CVS (Read-Write)</h2>
<p>
If you intend to use the <em>development</em> CVS server, <a
href="https://alioth.debian.org/account/register.php" target="_top">get
a login at Alioth</a> and <a
href="https://alioth.debian.org/projects/sane/" target="_top">contact
one of the SANE project managers</a> to get added to the project. Don't
be surprised that you get a "foo-guest" account, that's just the normal
naming scheme. After being added to the project, it can take some hours
until you get write access to CVS. Development CVS access is done by ssh
(version 1):
</p>
<pre>
export CVS_RSH=ssh
cvs -z3 -d:ext:developername@cvs.alioth.debian.org:/cvsroot/sane co sane-backends
</pre>
<p>
For getting access to SANE frontends, just replace
<em>sane-backends</em> by <em>sane-frontends</em> in the commands
above. To get access to the html pages, use module <em>html</em>. The
HTML pages are automatically updated when any change is done in module
<em>html</em>. Also, the HTML lists of scanners/backends supported by the
CVS version of SANE is automatically created when changing any .desc
file.
</p>
<p>
Make sure that you <strong>really use ssh</strong> to access the CVS
server. Have a look at the file <em>CVS/Root</em> in your local
repository. It should contain a line starting with <em>:ext:</em> and not
<em>:pserver:</em>. If you don't use ssh, your password is not encrypted
and CVS log messages won't work. You can use the usual ssh access
methods. E.g. you can upload your public key so you don't need to enter
the password every time.
</p>
<p>
The rules are pretty simple: If you change anything in your backend, do
whatever you want. Just don't break compilation :-). Don't change
backends of other active developers. For backends of non-active
developers or any other code you should either know what you are doing
or ask on sane-devel if the change is acceptable. Fixing spelling
mistakes or broken links in the HTML pages is appreciated. Before doing
major changes please ask on sane-devel.
</p>
<p>
When doing changes (commits) to sane-backends or sane-frontends, make sure
you remember to include an entry in the ChangeLog file. The format is
simple, with the date the change was committed to CVS, the name and email
address of the one doing the commit, the list of files changed (ignoring
ChangeLog itself), and a description of the change. Example:
</p>
<pre>
2000-03-06 Petter Reinholdtsen
* configure.in configure: New version is 1.0.2.
</pre>
<p>
You can use the same descriptions in the ChangeLog and the commit
messages. The ChangeLog file is used in addition to the commit messages
because it's available even when there is no access to the CVS server. If
you intend to change more than one file in CVS, it's ok to add all the
entries to the ChangeLog only once per day.
</p>
<h2>sane-commit Mailing list</h2>
<p>
If you are interested in the changes in the SANE CVS tree, subscribe to
the <a
href="http://lists.alioth.debian.org/mailman/listinfo/sane-commit"
target="_top">sane-commit mailing list</a>.
</p>
<hr>
<p>
<a href="/">SANE homepage</a><br>
<a href="imprint.html">Contact</a>
</p>
<p>
<font size="-1">$Date$ $Author$</font>
</p>
</body>
</html>
<!-- LocalWords: co
-->