added three recent frontends
[sane/website.git] / cvs.html
1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
2
3 <html>
4   <head>
5     <title>SANE - git Access</title>
6     <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
7     <meta name="author" content="Henning Meier-Geinitz">
8     <meta name="keywords" content="sane, scanner, git, gitweb, development, unstable">
9     <meta name="description" content="SANE git server">
10     <link href="mailto:hmg-guest@users.alioth.debian.org" rev="made">
11     <link rel="icon" href="favicon.ico" type="image/x-icon"> 
12     <link rel="shortcut icon" href="favicon.ico" type="image/x-icon">
13   </head>
14
15   <body bgcolor="#FFFFFF" text="#000000">    
16     <center>
17       <a href="http://www.sane-project.org"><img src="images/sane.png"
18           alt="SANE" height="117" width="346" border="0"></a>
19     </center>
20
21     <center>
22       <h1><a
23           href="https://alioth.debian.org/scm/?group_id=30186"
24           target="_top">SANE - git Access</a></h1>
25     </center>
26
27     <hr>
28
29     <p>
30         <a href="http://git-scm.com">git</a>, the version control
31         system invented by Linus Torvalds and used for the Linux
32         kernel among other things, is used to develop SANE. To get the
33         latest SANE software (sane-backends and sane-frontends) our
34         git server can be used. But keep in mind that the software in
35         git is not tested so the risk of bugs is much higher than with
36         stable releases.
37     </p>
38     <p>
39       There is development and anonymous git access. If you are not a
40       developer, please use the anonymous access methods as mentioned below.
41     </p>
42
43     <h2>Anonymous git Access (Read-Only)</h2>
44     <p>
45         The git trees are available anonymously either through the
46         HTTP access method or the git-specific git protocol.
47     </p>
48     <p>
49         The HTTP access method should be used only if you are
50         restricted by a firewall that won't let you use either the git
51         protocol nor SSH. HTTP is slower and requires more bandwidth
52         than any other access methods.
53     </p>
54     <p>
55         You can clone from the following URIs:
56         <ul>
57           <li>HTTP access method:
58             <ul>
59               <li>http://git.debian.org/git/sane/sane-backends.git</li>
60               <li>http://git.debian.org/git/sane/sane-frontends.git</li>
61               <li>http://git.debian.org/git/sane/website.git</li>
62             </ul>
63           </li>
64           <li>git protocol (preferred):
65             <ul>
66               <li>git://git.debian.org/sane/sane-backends.git</li>
67               <li>git://git.debian.org/sane/sane-frontends.git</li>
68               <li>git://git.debian.org/sane/website.git</li>
69             </ul>
70           </li>
71         </ul>
72     </p>
73
74     <p>
75       If you just want to look at one file and don't want to download the
76       whole git tree, you can use gitweb to browse the tree with your
77       web browser:
78         <ul>
79           <li><a href="http://git.debian.org/?p=sane/sane-backends.git">http://git.debian.org/?p=sane/sane-backends.git</a></li>
80           <li><a href="http://git.debian.org/?p=sane/sane-frontends.git">http://git.debian.org/?p=sane/sane-frontends.git</a></li>
81           <li><a href="http://git.debian.org/?p=sane/website.git">http://git.debian.org/?p=sane/website.git</a></li>
82         </ul>
83     </p>
84
85
86     <h2>Developer Access to git (Read-Write)</h2>
87     <p>
88       If you intend to use the <em>development</em> git server, <a
89       href="https://alioth.debian.org/account/register.php" target="_top">get
90       a login at Alioth</a> and <a
91       href="https://alioth.debian.org/projects/sane/" target="_top">contact
92       one of the SANE project managers</a> to get added to the project. Don't
93       be surprised that you get a "foo-guest" account, that's just the normal
94       naming scheme. After being added to the project, it can take some hours
95       until you get write access to the git trees. Development git
96       access is done by ssh:
97         <ul>
98           <li>ssh://yourlogin@git.debian.org/git/sane/sane-backends.git</li>
99           <li>ssh://yourlogin@git.debian.org/git/sane/sane-frontends.git</li>
100           <li>ssh://yourlogin@git.debian.org/git/sane/website.git</li>
101         </ul>
102     </p>
103     <p>
104         Available git trees:
105         <ul>
106           <li>
107             <em>sane-backends</em>: the main SANE package containing
108             the SANE libraries, all the backends and documentation.
109           </li>
110           <li>
111             <em>sane-frontends</em>: various frontends for SANE,
112             including graphical frontends.
113           </li>
114           <li>
115             <em>website</em>: Our web pages. Before changing anything,
116             be sure you know what you do. Ask sane-devel, if in doubt.
117             The HTML pages are automatically updated when any change
118             is done to the tree. Also, the HTML lists of
119             scanners/backends supported by the git version of SANE is
120             automatically created when changing any .desc file.
121           </li>
122         </ul>
123     </p>
124
125     <p>
126       The rules are pretty simple: If you change anything in your backend, do
127       whatever you want. Just don't break compilation :-). Don't change
128       backends of other active developers. For backends of non-active
129       developers or any other code you should either know what you are doing
130       or ask on sane-devel if the change is acceptable. Fixing spelling
131       mistakes or broken links in the HTML pages is appreciated. Before doing
132       major changes please ask on sane-devel.
133     </p>
134
135     <p>
136       When doing changes (commits) to sane-backends or sane-frontends, make sure
137       you remember to include an entry in the ChangeLog file. The format is
138       simple, with the date the change was committed to git, the name and email
139       address of the one doing the commit, the list of files changed (ignoring
140       ChangeLog itself), and a description of the change. Example:
141     </p>
142
143 <pre>
144 2000-03-06  Petter Reinholdtsen 
145         * configure.in configure: New version is 1.0.2.
146 </pre>
147
148     <p>
149       You can use the same descriptions in the ChangeLog and the commit
150       messages. The ChangeLog file is still used in addition to the
151       commit messages (CVS legacy). If you intend to change more than
152       one file, it's ok to add all the entries to the ChangeLog only
153       once per day.
154     </p>
155
156     <h2>sane-commit Mailing list</h2>
157     <p>
158       If you are interested in the changes to the SANE git trees, subscribe to
159       the <a
160       href="http://lists.alioth.debian.org/mailman/listinfo/sane-commit"
161       target="_top">sane-commit mailing list</a>.
162     </p>
163
164
165     <hr>
166     <p>
167       <a href="/">SANE homepage</a><br>
168       <a href="imprint.html">Contact</a>
169     </p>    
170     <p>
171       <font size="-1">$Date$ $Author$</font>
172     </p> 
173   </body>
174   
175 </html>
176
177 <!--  LocalWords:  co
178  -->