1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
\r
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
\r
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
\r
5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
\r
6 <meta name="generator" content="AsciiDoc 7.0.2" />
\r
7 <style type="text/css">
\r
9 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
\r
11 border: 1px solid red;
\r
16 margin: 1em 5% 1em 5%;
\r
20 a:visited { color: fuchsia; }
\r
34 h1, h2, h3, h4, h5, h6 {
\r
36 font-family: sans-serif;
\r
38 margin-bottom: 0.5em;
\r
43 border-bottom: 2px solid silver;
\r
46 border-bottom: 2px solid silver;
\r
56 border: 1px solid silver;
\r
61 margin-bottom: 0.5em;
\r
71 font-family: sans-serif;
\r
78 font-family: sans-serif;
\r
82 font-family: sans-serif;
\r
84 border-top: 2px solid silver;
\r
90 padding-bottom: 0.5em;
\r
94 padding-bottom: 0.5em;
\r
98 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
\r
99 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
\r
100 div.admonitionblock {
\r
103 margin-bottom: 1.5em;
\r
105 div.admonitionblock {
\r
107 margin-bottom: 2.5em;
\r
110 div.content { /* Block element content. */
\r
114 /* Block element titles. */
\r
115 div.title, caption.title {
\r
116 font-family: sans-serif;
\r
120 margin-bottom: 0.5em;
\r
126 td div.title:first-child {
\r
129 div.content div.title:first-child {
\r
132 div.content + div.title {
\r
136 div.sidebarblock > div.content {
\r
137 background: #ffffee;
\r
138 border: 1px solid silver;
\r
142 div.listingblock > div.content {
\r
143 border: 1px solid silver;
\r
144 background: #f4f4f4;
\r
148 div.quoteblock > div.content {
\r
149 padding-left: 2.0em;
\r
151 div.quoteblock .attribution {
\r
155 div.admonitionblock .icon {
\r
156 vertical-align: top;
\r
159 text-decoration: underline;
\r
161 padding-right: 0.5em;
\r
163 div.admonitionblock td.content {
\r
164 padding-left: 0.5em;
\r
165 border-left: 2px solid silver;
\r
168 div.exampleblock > div.content {
\r
169 border-left: 2px solid silver;
\r
173 div.verseblock div.content {
\r
177 div.imageblock div.content { padding-left: 0; }
\r
178 div.imageblock img { border: 1px solid silver; }
\r
179 span.image img { border-style: none; }
\r
183 margin-bottom: 0.8em;
\r
188 font-style: italic;
\r
190 dd > *:first-child {
\r
195 list-style-position: outside;
\r
198 list-style-type: lower-alpha;
\r
201 div.tableblock > table {
\r
202 border-color: #527bbd;
\r
206 font-family: sans-serif;
\r
215 margin-bottom: 0.8em;
\r
218 vertical-align: top;
\r
219 font-style: italic;
\r
220 padding-right: 0.8em;
\r
223 vertical-align: top;
\r
227 div#footer-badges { display: none; }
\r
229 include::./stylesheets/xhtml11-manpage.css[]
\r
230 /* Workarounds for IE6's broken and incomplete CSS2. */
\r
232 div.sidebar-content {
\r
233 background: #ffffee;
\r
234 border: 1px solid silver;
\r
237 div.sidebar-title, div.image-title {
\r
238 font-family: sans-serif;
\r
241 margin-bottom: 0.5em;
\r
244 div.listingblock div.content {
\r
245 border: 1px solid silver;
\r
246 background: #f4f4f4;
\r
250 div.quoteblock-content {
\r
251 padding-left: 2.0em;
\r
254 div.exampleblock-content {
\r
255 border-left: 2px solid silver;
\r
256 padding-left: 0.5em;
\r
259 <title>git-cvsserver(1)</title>
\r
264 git-cvsserver(1) Manual Page
\r
267 <div class="sectionbody">
\r
269 A CVS server emulator for git
\r
274 <div class="sectionbody">
\r
275 <div class="verseblock">
\r
276 <div class="content">export CVS_SERVER=git-cvsserver
\r
277 <em>cvs</em> -d :ext:user@server/path/repo.git co <HEAD_name></div></div>
\r
279 <h2>DESCRIPTION</h2>
\r
280 <div class="sectionbody">
\r
281 <p>This application is a CVS emulation layer for git.</p>
\r
282 <p>It is highly functional. However, not all methods are implemented,
\r
283 and for those methods that are implemented,
\r
284 not all switches are implemented.</p>
\r
285 <p>Testing has been done using both the CLI CVS client, and the Eclipse CVS
\r
286 plugin. Most functionality works fine with both of these clients.</p>
\r
288 <h2>LIMITATIONS</h2>
\r
289 <div class="sectionbody">
\r
290 <p>Currently gitcvs only works over ssh connections.</p>
\r
292 <h2>INSTALLATION</h2>
\r
293 <div class="sectionbody">
\r
297 Put server.pl somewhere useful on the same machine that is hosting your git repos
\r
302 For each repo that you want accessible from CVS you need to edit config in
\r
303 the repo and add the following section.
\r
305 <div class="literalblock">
\r
306 <div class="content">
\r
309 logfile=/path/to/logfile</tt></pre>
\r
311 <div class="literalblock">
\r
312 <div class="content">
\r
313 <pre><tt>n.b. you need to ensure each user that is going to invoke server.pl has
\r
314 write access to the log file.</tt></pre>
\r
319 On each client machine you need to set the following variables.
\r
320 CVSROOT should be set as per normal, but the directory should point at the
\r
321 appropriate git repo.
\r
322 CVS_SERVER should be set to the server.pl script that has been put on the
\r
328 Clients should now be able to check out modules (where modules are the names
\r
329 of branches in git).
\r
330 $ cvs co -d mylocaldir master
\r
335 <h2>Eclipse CVS Client Notes</h2>
\r
336 <div class="sectionbody">
\r
337 <p>To get a checkout with the Eclipse CVS client:</p>
\r
341 Create a new project from CVS checkout, giving it repository and module
\r
346 Context Menu->Team->Share Project…
\r
351 Enter the repository and module information again and click Finish
\r
356 The Synchronize view appears. Untick "launch commit wizard" to avoid
\r
357 committing the .project file, and select HEAD as the tag to synchronize to.
\r
358 Update all incoming changes.
\r
362 <p>Note that most versions of Eclipse ignore CVS_SERVER (which you can set in
\r
363 the Preferences->Team->CVS->ExtConnection pane), so you may have to
\r
364 rename, alias or symlink git-cvsserver to <em>cvs</em> on the server.</p>
\r
366 <h2>Clients known to work</h2>
\r
367 <div class="sectionbody">
\r
368 <p>CVS 1.12.9 on Debian
\r
369 CVS 1.11.17 on MacOSX (from Fink package)
\r
370 Eclipse 3.0, 3.1.2 on MacOSX (see Eclipse CVS Client Notes)
\r
373 <h2>Operations supported</h2>
\r
374 <div class="sectionbody">
\r
375 <p>All the operations required for normal use are supported, including
\r
376 checkout, diff, status, update, log, add, remove, commit.
\r
377 Legacy monitoring operations are not supported (edit, watch and related).
\r
378 Exports and tagging (tags and branches) are not supported at this stage.</p>
\r
379 <p>The server will set the -k mode to binary when relevant. In proper GIT
\r
380 tradition, the contents of the files are always respected.
\r
381 No keyword expansion or newline munging is supported.</p>
\r
383 <h2>Dependencies</h2>
\r
384 <div class="sectionbody">
\r
385 <p>git-cvsserver depends on DBD::SQLite.</p>
\r
387 <h2>Copyright and Authors</h2>
\r
388 <div class="sectionbody">
\r
389 <p>This program is copyright The Open University UK - 2006.</p>
\r
390 <p>Authors: Martyn Smith <martyn@catalyst.net.nz>
\r
391 Martin Langhoff <martin@catalyst.net.nz>
\r
392 with ideas and patches from participants of the git-list <git@vger.kernel.org>.</p>
\r
394 <h2>Documentation</h2>
\r
395 <div class="sectionbody">
\r
396 <p>Documentation by Martyn Smith <martyn@catalyst.net.nz> and Martin Langhoff <martin@catalyst.net.nz>Matthias Urlichs <smurf@smurf.noris.de>.</p>
\r
399 <div class="sectionbody">
\r
400 <p>Part of the <a href="git.html">git(7)</a> suite</p>
\r
403 <div id="footer-text">
\r
404 Last updated 01-Mar-2006 12:05:10 UTC
\r