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  -->