Google Git
Sign in
chromium / external / gitster / git-htmldocs / cb119ab9d01a5ead330e94756b310ca384219570 / . / git-cvsserver.html
blob: a675dc4cac61d7c385a38d5e449f41b66d922599 [file] [log] [blame]
Junio C Hamanob9d9d902018-05-23 07:07:42[diff] [blame]1<?xml version="1.0" encoding="UTF-8"?>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
3 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
4<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
5<head>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]6<meta http-equiv="Content-Type" content="application/xhtml+xml; charset=UTF-8" />
Junio C Hamanoa85030a2022-07-27 16:48:21[diff] [blame]7<meta name="generator" content="AsciiDoc 10.2.0" />
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]8<title>git-cvsserver(1)</title>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]9<style type="text/css">
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]10/* Shared CSS for AsciiDoc xhtml11 and html5 backends */
11
12/* Default font. */
13body {
14 font-family: Georgia,serif;
15}
16
17/* Title font. */
18h1, h2, h3, h4, h5, h6,
19div.title, caption.title,
20thead, p.table.header,
21#toctitle,
22#author, #revnumber, #revdate, #revremark,
23#footer {
24 font-family: Arial,Helvetica,sans-serif;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]25}
26
27body {
28 margin: 1em 5% 1em 5%;
29}
30
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]31a {
32 color: blue;
33 text-decoration: underline;
34}
35a:visited {
36 color: fuchsia;
37}
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]38
39em {
40 font-style: italic;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]41 color: navy;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]42}
43
44strong {
45 font-weight: bold;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]46 color: #083194;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]47}
48
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]49h1, h2, h3, h4, h5, h6 {
50 color: #527bbd;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]51 margin-top: 1.2em;
52 margin-bottom: 0.5em;
53 line-height: 1.3;
54}
55
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]56h1, h2, h3 {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]57 border-bottom: 2px solid silver;
58}
59h2 {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]60 padding-top: 0.5em;
61}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]62h3 {
63 float: left;
64}
65h3 + * {
66 clear: left;
67}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]68h5 {
69 font-size: 1.0em;
70}
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]71
72div.sectionbody {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]73 margin-left: 0;
74}
75
76hr {
77 border: 1px solid silver;
78}
79
80p {
81 margin-top: 0.5em;
82 margin-bottom: 0.5em;
83}
84
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]85ul, ol, li > p {
86 margin-top: 0;
87}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]88ul > li { color: #aaa; }
89ul > li > * { color: black; }
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]90
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]91.monospaced, code, pre {
92 font-family: "Courier New", Courier, monospace;
93 font-size: inherit;
94 color: navy;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]95 padding: 0;
96 margin: 0;
97}
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]98pre {
99 white-space: pre-wrap;
100}
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]101
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]102#author {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]103 color: #527bbd;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]104 font-weight: bold;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]105 font-size: 1.1em;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]106}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]107#email {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]108}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]109#revnumber, #revdate, #revremark {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]110}
111
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]112#footer {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]113 font-size: small;
114 border-top: 2px solid silver;
115 padding-top: 0.5em;
116 margin-top: 4.0em;
117}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]118#footer-text {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]119 float: left;
120 padding-bottom: 0.5em;
121}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]122#footer-badges {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]123 float: right;
124 padding-bottom: 0.5em;
125}
126
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]127#preamble {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]128 margin-top: 1.5em;
129 margin-bottom: 1.5em;
130}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]131div.imageblock, div.exampleblock, div.verseblock,
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]132div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
133div.admonitionblock {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]134 margin-top: 1.0em;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]135 margin-bottom: 1.5em;
136}
137div.admonitionblock {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]138 margin-top: 2.0em;
139 margin-bottom: 2.0em;
140 margin-right: 10%;
141 color: #606060;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]142}
143
144div.content { /* Block element content. */
145 padding: 0;
146}
147
148/* Block element titles. */
149div.title, caption.title {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]150 color: #527bbd;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]151 font-weight: bold;
152 text-align: left;
153 margin-top: 1.0em;
154 margin-bottom: 0.5em;
155}
156div.title + * {
157 margin-top: 0;
158}
159
160td div.title:first-child {
161 margin-top: 0.0em;
162}
163div.content div.title:first-child {
164 margin-top: 0.0em;
165}
166div.content + div.title {
167 margin-top: 0.0em;
168}
169
170div.sidebarblock > div.content {
171 background: #ffffee;
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]172 border: 1px solid #dddddd;
173 border-left: 4px solid #f0f0f0;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]174 padding: 0.5em;
175}
176
177div.listingblock > div.content {
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]178 border: 1px solid #dddddd;
179 border-left: 5px solid #f0f0f0;
180 background: #f8f8f8;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]181 padding: 0.5em;
182}
183
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]184div.quoteblock, div.verseblock {
185 padding-left: 1.0em;
186 margin-left: 1.0em;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]187 margin-right: 10%;
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]188 border-left: 5px solid #f0f0f0;
189 color: #888;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]190}
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]191
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]192div.quoteblock > div.attribution {
193 padding-top: 0.5em;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]194 text-align: right;
195}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]196
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]197div.verseblock > pre.content {
198 font-family: inherit;
199 font-size: inherit;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]200}
201div.verseblock > div.attribution {
202 padding-top: 0.75em;
203 text-align: left;
204}
205/* DEPRECATED: Pre version 8.2.7 verse style literal block. */
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]206div.verseblock + div.attribution {
207 text-align: left;
208}
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]209
210div.admonitionblock .icon {
211 vertical-align: top;
212 font-size: 1.1em;
213 font-weight: bold;
214 text-decoration: underline;
215 color: #527bbd;
216 padding-right: 0.5em;
217}
218div.admonitionblock td.content {
219 padding-left: 0.5em;
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]220 border-left: 3px solid #dddddd;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]221}
222
223div.exampleblock > div.content {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]224 border-left: 3px solid #dddddd;
225 padding-left: 0.5em;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]226}
227
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]228div.imageblock div.content { padding-left: 0; }
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]229span.image img { border-style: none; vertical-align: text-bottom; }
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]230a.image:visited { color: white; }
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]231
232dl {
233 margin-top: 0.8em;
234 margin-bottom: 0.8em;
235}
236dt {
237 margin-top: 0.5em;
238 margin-bottom: 0;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]239 font-style: normal;
240 color: navy;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]241}
242dd > *:first-child {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]243 margin-top: 0.1em;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]244}
245
246ul, ol {
247 list-style-position: outside;
248}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]249ol.arabic {
250 list-style-type: decimal;
251}
252ol.loweralpha {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]253 list-style-type: lower-alpha;
254}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]255ol.upperalpha {
256 list-style-type: upper-alpha;
257}
258ol.lowerroman {
259 list-style-type: lower-roman;
260}
261ol.upperroman {
262 list-style-type: upper-roman;
263}
264
265div.compact ul, div.compact ol,
266div.compact p, div.compact p,
267div.compact div, div.compact div {
268 margin-top: 0.1em;
269 margin-bottom: 0.1em;
270}
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]271
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]272tfoot {
273 font-weight: bold;
274}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]275td > div.verse {
276 white-space: pre;
277}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]278
279div.hdlist {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]280 margin-top: 0.8em;
281 margin-bottom: 0.8em;
282}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]283div.hdlist tr {
284 padding-bottom: 15px;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]285}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]286dt.hdlist1.strong, td.hdlist1.strong {
287 font-weight: bold;
288}
289td.hdlist1 {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]290 vertical-align: top;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]291 font-style: normal;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]292 padding-right: 0.8em;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]293 color: navy;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]294}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]295td.hdlist2 {
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]296 vertical-align: top;
297}
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]298div.hdlist.compact tr {
299 margin: 0;
300 padding-bottom: 0;
301}
302
303.comment {
304 background: yellow;
305}
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]306
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]307.footnote, .footnoteref {
308 font-size: 0.8em;
309}
310
311span.footnote, span.footnoteref {
312 vertical-align: super;
313}
314
315#footnotes {
316 margin: 20px 0 20px 0;
317 padding: 7px 0 0 0;
318}
319
320#footnotes div.footnote {
321 margin: 0 0 5px 0;
322}
323
324#footnotes hr {
325 border: none;
326 border-top: 1px solid silver;
327 height: 1px;
328 text-align: left;
329 margin-left: 0;
330 width: 20%;
331 min-width: 100px;
332}
333
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]334div.colist td {
335 padding-right: 0.5em;
336 padding-bottom: 0.3em;
337 vertical-align: top;
338}
339div.colist td img {
340 margin-top: 0.3em;
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]341}
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]342
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]343@media print {
344 #footer-badges { display: none; }
345}
346
347#toc {
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]348 margin-bottom: 2.5em;
349}
350
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]351#toctitle {
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]352 color: #527bbd;
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]353 font-size: 1.1em;
354 font-weight: bold;
355 margin-top: 1.0em;
356 margin-bottom: 0.1em;
357}
358
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]359div.toclevel0, div.toclevel1, div.toclevel2, div.toclevel3, div.toclevel4 {
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]360 margin-top: 0;
361 margin-bottom: 0;
362}
363div.toclevel2 {
364 margin-left: 2em;
365 font-size: 0.9em;
366}
367div.toclevel3 {
368 margin-left: 4em;
369 font-size: 0.9em;
370}
371div.toclevel4 {
372 margin-left: 6em;
373 font-size: 0.9em;
374}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]375
376span.aqua { color: aqua; }
377span.black { color: black; }
378span.blue { color: blue; }
379span.fuchsia { color: fuchsia; }
380span.gray { color: gray; }
381span.green { color: green; }
382span.lime { color: lime; }
383span.maroon { color: maroon; }
384span.navy { color: navy; }
385span.olive { color: olive; }
386span.purple { color: purple; }
387span.red { color: red; }
388span.silver { color: silver; }
389span.teal { color: teal; }
390span.white { color: white; }
391span.yellow { color: yellow; }
392
393span.aqua-background { background: aqua; }
394span.black-background { background: black; }
395span.blue-background { background: blue; }
396span.fuchsia-background { background: fuchsia; }
397span.gray-background { background: gray; }
398span.green-background { background: green; }
399span.lime-background { background: lime; }
400span.maroon-background { background: maroon; }
401span.navy-background { background: navy; }
402span.olive-background { background: olive; }
403span.purple-background { background: purple; }
404span.red-background { background: red; }
405span.silver-background { background: silver; }
406span.teal-background { background: teal; }
407span.white-background { background: white; }
408span.yellow-background { background: yellow; }
409
410span.big { font-size: 2em; }
411span.small { font-size: 0.6em; }
412
413span.underline { text-decoration: underline; }
414span.overline { text-decoration: overline; }
415span.line-through { text-decoration: line-through; }
416
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]417div.unbreakable { page-break-inside: avoid; }
418
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]419
420/*
421 * xhtml11 specific
422 *
423 * */
424
425div.tableblock {
426 margin-top: 1.0em;
427 margin-bottom: 1.5em;
428}
429div.tableblock > table {
430 border: 3px solid #527bbd;
431}
432thead, p.table.header {
433 font-weight: bold;
434 color: #527bbd;
435}
436p.table {
437 margin-top: 0;
438}
Junio C Hamano725b0da2020-01-22 22:02:40[diff] [blame]439/* Because the table frame attribute is overridden by CSS in most browsers. */
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]440div.tableblock > table[frame="void"] {
441 border-style: none;
442}
443div.tableblock > table[frame="hsides"] {
444 border-left-style: none;
445 border-right-style: none;
446}
447div.tableblock > table[frame="vsides"] {
448 border-top-style: none;
449 border-bottom-style: none;
450}
451
452
453/*
454 * html5 specific
455 *
456 * */
457
458table.tableblock {
459 margin-top: 1.0em;
460 margin-bottom: 1.5em;
461}
462thead, p.tableblock.header {
463 font-weight: bold;
464 color: #527bbd;
465}
466p.tableblock {
467 margin-top: 0;
468}
469table.tableblock {
470 border-width: 3px;
471 border-spacing: 0px;
472 border-style: solid;
473 border-color: #527bbd;
474 border-collapse: collapse;
475}
476th.tableblock, td.tableblock {
477 border-width: 1px;
478 padding: 4px;
479 border-style: solid;
480 border-color: #527bbd;
481}
482
483table.tableblock.frame-topbot {
484 border-left-style: hidden;
485 border-right-style: hidden;
486}
487table.tableblock.frame-sides {
488 border-top-style: hidden;
489 border-bottom-style: hidden;
490}
491table.tableblock.frame-none {
492 border-style: hidden;
493}
494
495th.tableblock.halign-left, td.tableblock.halign-left {
496 text-align: left;
497}
498th.tableblock.halign-center, td.tableblock.halign-center {
499 text-align: center;
500}
501th.tableblock.halign-right, td.tableblock.halign-right {
502 text-align: right;
503}
504
505th.tableblock.valign-top, td.tableblock.valign-top {
506 vertical-align: top;
507}
508th.tableblock.valign-middle, td.tableblock.valign-middle {
509 vertical-align: middle;
510}
511th.tableblock.valign-bottom, td.tableblock.valign-bottom {
512 vertical-align: bottom;
513}
514
515
516/*
517 * manpage specific
518 *
519 * */
520
521body.manpage h1 {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]522 padding-top: 0.5em;
523 padding-bottom: 0.5em;
524 border-top: 2px solid silver;
525 border-bottom: 2px solid silver;
526}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]527body.manpage h2 {
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]528 border-style: none;
529}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]530body.manpage div.sectionbody {
531 margin-left: 3em;
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]532}
533
534@media print {
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]535 body.manpage div#toc { display: none; }
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]536}
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]537
538
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]539</style>
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]540<script type="text/javascript">
541/*<![CDATA[*/
Junio C Hamano2b153182021-12-15 21:00:31[diff] [blame]542var asciidoc = { // Namespace.
543
544/////////////////////////////////////////////////////////////////////
545// Table Of Contents generator
546/////////////////////////////////////////////////////////////////////
547
548/* Author: Mihai Bazon, September 2002
549 * http://students.infoiasi.ro/~mishoo
550 *
551 * Table Of Content generator
552 * Version: 0.4
553 *
554 * Feel free to use this script under the terms of the GNU General Public
555 * License, as long as you do not remove or alter this notice.
556 */
557
558 /* modified by Troy D. Hanson, September 2006. License: GPL */
559 /* modified by Stuart Rackham, 2006, 2009. License: GPL */
560
561// toclevels = 1..4.
562toc: function (toclevels) {
563
564 function getText(el) {
565 var text = "";
566 for (var i = el.firstChild; i != null; i = i.nextSibling) {
567 if (i.nodeType == 3 /* Node.TEXT_NODE */) // IE doesn't speak constants.
568 text += i.data;
569 else if (i.firstChild != null)
570 text += getText(i);
571 }
572 return text;
573 }
574
575 function TocEntry(el, text, toclevel) {
576 this.element = el;
577 this.text = text;
578 this.toclevel = toclevel;
579 }
580
581 function tocEntries(el, toclevels) {
582 var result = new Array;
583 var re = new RegExp('[hH]([1-'+(toclevels+1)+'])');
584 // Function that scans the DOM tree for header elements (the DOM2
585 // nodeIterator API would be a better technique but not supported by all
586 // browsers).
587 var iterate = function (el) {
588 for (var i = el.firstChild; i != null; i = i.nextSibling) {
589 if (i.nodeType == 1 /* Node.ELEMENT_NODE */) {
590 var mo = re.exec(i.tagName);
591 if (mo && (i.getAttribute("class") || i.getAttribute("className")) != "float") {
592 result[result.length] = new TocEntry(i, getText(i), mo[1]-1);
593 }
594 iterate(i);
595 }
596 }
597 }
598 iterate(el);
599 return result;
600 }
601
602 var toc = document.getElementById("toc");
603 if (!toc) {
604 return;
605 }
606
607 // Delete existing TOC entries in case we're reloading the TOC.
608 var tocEntriesToRemove = [];
609 var i;
610 for (i = 0; i < toc.childNodes.length; i++) {
611 var entry = toc.childNodes[i];
612 if (entry.nodeName.toLowerCase() == 'div'
613 && entry.getAttribute("class")
614 && entry.getAttribute("class").match(/^toclevel/))
615 tocEntriesToRemove.push(entry);
616 }
617 for (i = 0; i < tocEntriesToRemove.length; i++) {
618 toc.removeChild(tocEntriesToRemove[i]);
619 }
620
621 // Rebuild TOC entries.
622 var entries = tocEntries(document.getElementById("content"), toclevels);
623 for (var i = 0; i < entries.length; ++i) {
624 var entry = entries[i];
625 if (entry.element.id == "")
626 entry.element.id = "_toc_" + i;
627 var a = document.createElement("a");
628 a.href = "#" + entry.element.id;
629 a.appendChild(document.createTextNode(entry.text));
630 var div = document.createElement("div");
631 div.appendChild(a);
632 div.className = "toclevel" + entry.toclevel;
633 toc.appendChild(div);
634 }
635 if (entries.length == 0)
636 toc.parentNode.removeChild(toc);
637},
638
639
640/////////////////////////////////////////////////////////////////////
641// Footnotes generator
642/////////////////////////////////////////////////////////////////////
643
644/* Based on footnote generation code from:
645 * http://www.brandspankingnew.net/archive/2005/07/format_footnote.html
646 */
647
648footnotes: function () {
649 // Delete existing footnote entries in case we're reloading the footnodes.
650 var i;
651 var noteholder = document.getElementById("footnotes");
652 if (!noteholder) {
653 return;
654 }
655 var entriesToRemove = [];
656 for (i = 0; i < noteholder.childNodes.length; i++) {
657 var entry = noteholder.childNodes[i];
658 if (entry.nodeName.toLowerCase() == 'div' && entry.getAttribute("class") == "footnote")
659 entriesToRemove.push(entry);
660 }
661 for (i = 0; i < entriesToRemove.length; i++) {
662 noteholder.removeChild(entriesToRemove[i]);
663 }
664
665 // Rebuild footnote entries.
666 var cont = document.getElementById("content");
667 var spans = cont.getElementsByTagName("span");
668 var refs = {};
669 var n = 0;
670 for (i=0; i<spans.length; i++) {
671 if (spans[i].className == "footnote") {
672 n++;
673 var note = spans[i].getAttribute("data-note");
674 if (!note) {
675 // Use [\s\S] in place of . so multi-line matches work.
676 // Because JavaScript has no s (dotall) regex flag.
677 note = spans[i].innerHTML.match(/\s*\[([\s\S]*)]\s*/)[1];
678 spans[i].innerHTML =
679 "[<a id='_footnoteref_" + n + "' href='#_footnote_" + n +
680 "' title='View footnote' class='footnote'>" + n + "</a>]";
681 spans[i].setAttribute("data-note", note);
682 }
683 noteholder.innerHTML +=
684 "<div class='footnote' id='_footnote_" + n + "'>" +
685 "<a href='#_footnoteref_" + n + "' title='Return to text'>" +
686 n + "</a>. " + note + "</div>";
687 var id =spans[i].getAttribute("id");
688 if (id != null) refs["#"+id] = n;
689 }
690 }
691 if (n == 0)
692 noteholder.parentNode.removeChild(noteholder);
693 else {
694 // Process footnoterefs.
695 for (i=0; i<spans.length; i++) {
696 if (spans[i].className == "footnoteref") {
697 var href = spans[i].getElementsByTagName("a")[0].getAttribute("href");
698 href = href.match(/#.*/)[0]; // Because IE return full URL.
699 n = refs[href];
700 spans[i].innerHTML =
701 "[<a href='#_footnote_" + n +
702 "' title='View footnote' class='footnote'>" + n + "</a>]";
703 }
704 }
705 }
706},
707
708install: function(toclevels) {
709 var timerId;
710
711 function reinstall() {
712 asciidoc.footnotes();
713 if (toclevels) {
714 asciidoc.toc(toclevels);
715 }
716 }
717
718 function reinstallAndRemoveTimer() {
719 clearInterval(timerId);
720 reinstall();
721 }
722
723 timerId = setInterval(reinstall, 500);
724 if (document.addEventListener)
725 document.addEventListener("DOMContentLoaded", reinstallAndRemoveTimer, false);
726 else
727 window.onload = reinstallAndRemoveTimer;
728}
729
730}
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]731asciidoc.install();
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]732/*]]>*/
733</script>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]734</head>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]735<body class="manpage">
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]736<div id="header">
737<h1>
738git-cvsserver(1) Manual Page
739</h1>
740<h2>NAME</h2>
741<div class="sectionbody">
742<p>git-cvsserver -
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]743 A CVS server emulator for Git
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]744</p>
745</div>
746</div>
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]747<div id="content">
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]748<div class="sect1">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]749<h2 id="_synopsis">SYNOPSIS</h2>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]750<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]751<div class="paragraph"><p>SSH:</p></div>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]752<div class="verseblock">
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]753<pre class="content">export CVS_SERVER="git cvsserver"
754<em>cvs</em> -d :ext:user@server/path/repo.git co &lt;HEAD_name&gt;</pre>
755<div class="attribution">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]756</div></div>
757<div class="paragraph"><p>pserver (/etc/inetd.conf):</p></div>
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]758<div class="verseblock">
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]759<pre class="content">cvspserver stream tcp nowait nobody /usr/bin/git-cvsserver git-cvsserver pserver</pre>
760<div class="attribution">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]761</div></div>
762<div class="paragraph"><p>Usage:</p></div>
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]763<div class="verseblock">
Junio C Hamanoc9cb5172018-06-01 07:13:44[diff] [blame]764<pre class="content"><em>git-cvsserver</em> [&lt;options&gt;] [pserver|server] [&lt;directory&gt; &#8230;]</pre>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]765<div class="attribution">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]766</div></div>
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]767</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]768</div>
769<div class="sect1">
Junio C Hamanobe601db2021-05-07 04:20:28[diff] [blame]770<h2 id="_description">DESCRIPTION</h2>
771<div class="sectionbody">
772<div class="paragraph"><p>This application is a CVS emulation layer for Git.</p></div>
773<div class="paragraph"><p>It is highly functional. However, not all methods are implemented,
774and for those methods that are implemented,
775not all switches are implemented.</p></div>
776<div class="paragraph"><p>Testing has been done using both the CLI CVS client, and the Eclipse CVS
777plugin. Most functionality works fine with both of these clients.</p></div>
778</div>
779</div>
780<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]781<h2 id="_options">OPTIONS</h2>
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]782<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]783<div class="paragraph"><p>All these options obviously only make sense if enforced by the server side.
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]784They have been implemented to resemble the <a href="git-daemon.html">git-daemon(1)</a> options as
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]785closely as possible.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]786<div class="dlist"><dl>
787<dt class="hdlist1">
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]788--base-path &lt;path&gt;
789</dt>
790<dd>
791<p>
792Prepend <em>path</em> to requested CVSROOT
793</p>
794</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]795<dt class="hdlist1">
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]796--strict-paths
797</dt>
798<dd>
799<p>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]800Don&#8217;t allow recursing into subdirectories
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]801</p>
802</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]803<dt class="hdlist1">
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]804--export-all
805</dt>
806<dd>
807<p>
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]808Don&#8217;t check for <code>gitcvs.enabled</code> in config. You also have to specify a list
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]809of allowed directories (see below) if you want to use this option.
810</p>
811</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]812<dt class="hdlist1">
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]813-V
814</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]815<dt class="hdlist1">
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]816--version
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]817</dt>
818<dd>
819<p>
820Print version information and exit
821</p>
822</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]823<dt class="hdlist1">
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]824-h
825</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]826<dt class="hdlist1">
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]827-H
828</dt>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]829<dt class="hdlist1">
Junio C Hamanoeb415992008-06-08 22:49:47[diff] [blame]830--help
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]831</dt>
832<dd>
833<p>
834Print usage information and exit
835</p>
836</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]837<dt class="hdlist1">
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]838&lt;directory&gt;
839</dt>
840<dd>
841<p>
Junio C Hamanoa85030a2022-07-27 16:48:21[diff] [blame]842The remaining arguments provide a list of directories. If no directories
843are given, then all are allowed. Repositories within these directories
844still require the <code>gitcvs.enabled</code> config option, unless <code>--export-all</code>
845is specified.
Junio C Hamano6926bef2007-06-16 09:54:05[diff] [blame]846</p>
847</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]848</dl></div>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]849</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]850</div>
851<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]852<h2 id="_limitations">LIMITATIONS</h2>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]853<div class="sectionbody">
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]854<div class="paragraph"><p>CVS clients cannot tag, branch or perform Git merges.</p></div>
855<div class="paragraph"><p><em>git-cvsserver</em> maps Git branches to CVS modules. This is very different
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]856from what most CVS users would expect since in CVS modules usually represent
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]857one or more directories.</p></div>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]858</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]859</div>
860<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]861<h2 id="_installation">INSTALLATION</h2>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]862<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]863<div class="olist arabic"><ol class="arabic">
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]864<li>
865<p>
Junio C Hamanoa574a092010-06-13 19:57:10[diff] [blame]866If you are going to offer CVS access via pserver, add a line in
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]867 /etc/inetd.conf like
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]868</p>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]869<div class="openblock">
870<div class="content">
Junio C Hamanof1d14802006-06-08 00:48:17[diff] [blame]871<div class="listingblock">
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]872<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]873<pre><code> cvspserver stream tcp nowait nobody git-cvsserver pserver</code></pre>
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]874</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]875<div class="paragraph"><p>Note: Some inetd servers let you specify the name of the executable
Junio C Hamano591dc6a2007-05-29 09:18:19[diff] [blame]876independently of the value of argv[0] (i.e. the name the program assumes
877it was executed with). In this case the correct line in /etc/inetd.conf
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]878looks like</p></div>
Junio C Hamanof1d14802006-06-08 00:48:17[diff] [blame]879<div class="listingblock">
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]880<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]881<pre><code> cvspserver stream tcp nowait nobody /usr/bin/git-cvsserver git-cvsserver pserver</code></pre>
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]882</div></div>
Junio C Hamano6a7e2632021-10-04 19:53:05[diff] [blame]883<div class="paragraph"><p>Only anonymous access is provided by pserver by default. To commit you
Junio C Hamanoa574a092010-06-13 19:57:10[diff] [blame]884will have to create pserver accounts, simply add a gitcvs.authdb
885setting in the config file of the repositories you want the cvsserver
886to allow writes to, for example:</p></div>
887<div class="listingblock">
888<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]889<pre><code> [gitcvs]
890 authdb = /etc/cvsserver/passwd</code></pre>
Junio C Hamanoa574a092010-06-13 19:57:10[diff] [blame]891</div></div>
Junio C Hamanofb5ffde2014-11-04 22:38:56[diff] [blame]892<div class="paragraph"><p>The format of these files is username followed by the encrypted password,
Junio C Hamanoa574a092010-06-13 19:57:10[diff] [blame]893for example:</p></div>
894<div class="listingblock">
895<div class="content">
Junio C Hamano6a7e2632021-10-04 19:53:05[diff] [blame]896<pre><code> myuser:sqkNi8zPf01HI
897 myuser:$1$9K7FzU28$VfF6EoPYCJEYcVQwATgOP/
898 myuser:$5$.NqmNH1vwfzGpV8B$znZIcumu1tNLATgV2l6e1/mY8RzhUDHMOaVOeL1cxV3</code></pre>
Junio C Hamanoa574a092010-06-13 19:57:10[diff] [blame]899</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]900<div class="paragraph"><p>You can use the <em>htpasswd</em> facility that comes with Apache to make these
Junio C Hamano9469c132023-06-23 20:26:29[diff] [blame]901files, but only with the -d option (or -B if your system supports it).</p></div>
Junio C Hamano6a7e2632021-10-04 19:53:05[diff] [blame]902<div class="paragraph"><p>Preferably use the system specific utility that manages password hash
903creation in your platform (e.g. mkpasswd in Linux, encrypt in OpenBSD or
904pwhash in NetBSD) and paste it in the right location.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]905<div class="paragraph"><p>Then provide your password via the pserver method, for example:</p></div>
Junio C Hamanoa574a092010-06-13 19:57:10[diff] [blame]906<div class="listingblock">
907<div class="content">
Junio C Hamano6a7e2632021-10-04 19:53:05[diff] [blame]908<pre><code> cvs -d:pserver:someuser:somepassword@server:/path/repo.git co &lt;HEAD_name&gt;</code></pre>
Junio C Hamanoa574a092010-06-13 19:57:10[diff] [blame]909</div></div>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]910<div class="paragraph"><p>No special setup is needed for SSH access, other than having Git tools
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]911in the PATH. If you have clients that do not accept the CVS_SERVER
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]912environment variable, you can rename <em>git-cvsserver</em> to <code>cvs</code>.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]913<div class="paragraph"><p>Note: Newer CVS versions (&gt;= 1.12.11) also support specifying
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]914CVS_SERVER directly in CVSROOT like</p></div>
Junio C Hamano591dc6a2007-05-29 09:18:19[diff] [blame]915<div class="listingblock">
916<div class="content">
Junio C Hamano6a7e2632021-10-04 19:53:05[diff] [blame]917<pre><code> cvs -d ":ext;CVS_SERVER=git cvsserver:user@server/path/repo.git" co &lt;HEAD_name&gt;</code></pre>
Junio C Hamano591dc6a2007-05-29 09:18:19[diff] [blame]918</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]919<div class="paragraph"><p>This has the advantage that it will be saved in your <em>CVS/Root</em> files and
920you don&#8217;t need to worry about always setting the correct environment
921variable. SSH users restricted to <em>git-shell</em> don&#8217;t need to override the default
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]922with CVS_SERVER (and shouldn&#8217;t) as <em>git-shell</em> understands <code>cvs</code> to mean
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]923<em>git-cvsserver</em> and pretends that the other end runs the real <em>cvs</em> better.</p></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]924</div></div>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]925</li>
926<li>
927<p>
928For each repo that you want accessible from CVS you need to edit config in
929 the repo and add the following section.
930</p>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]931<div class="openblock">
932<div class="content">
Junio C Hamanof1d14802006-06-08 00:48:17[diff] [blame]933<div class="listingblock">
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]934<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]935<pre><code> [gitcvs]
Junio C Hamanof1d14802006-06-08 00:48:17[diff] [blame]936 enabled=1
937 # optional for debugging
Junio C Hamano322c6242015-03-23 21:32:46[diff] [blame]938 logFile=/path/to/logfile</code></pre>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]939</div></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]940<div class="paragraph"><p>Note: you need to ensure each user that is going to invoke <em>git-cvsserver</em> has
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]941write access to the log file and to the database (see
942<a href="#dbbackend">Database Backend</a>. If you want to offer write access over
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]943SSH, the users of course also need write access to the Git repository itself.</p></div>
944<div class="paragraph"><p>You also need to ensure that each repository is "bare" (without a Git index
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]945file) for <code>cvs commit</code> to work. See <a href="gitcvs-migration.html">gitcvs-migration(7)</a>.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]946<div class="paragraph" id="configaccessmethod"><p>All configuration variables can also be overridden for a specific method of
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]947access. Valid method names are "ext" (for SSH access) and "pserver". The
948following example configuration would disable pserver access while still
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]949allowing access over SSH.</p></div>
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]950<div class="listingblock">
951<div class="content">
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]952<pre><code> [gitcvs]
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]953 enabled=0
954
955 [gitcvs "ext"]
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]956 enabled=1</code></pre>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]957</div></div>
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]958</div></div>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]959</li>
960<li>
961<p>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]962If you didn&#8217;t specify the CVSROOT/CVS_SERVER directly in the checkout command,
Junio C Hamano33f98432008-04-16 09:10:05[diff] [blame]963 automatically saving it in your <em>CVS/Root</em> files, then you need to set them
964 explicitly in your environment. CVSROOT should be set as per normal, but the
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]965 directory should point at the appropriate Git repo. As above, for SSH clients
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]966 <em>not</em> restricted to <em>git-shell</em>, CVS_SERVER should be set to <em>git-cvsserver</em>.
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]967</p>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]968<div class="openblock">
969<div class="content">
Junio C Hamanof1d14802006-06-08 00:48:17[diff] [blame]970<div class="listingblock">
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]971<div class="content">
Junio C Hamano6a7e2632021-10-04 19:53:05[diff] [blame]972<pre><code> export CVSROOT=:ext:user@server:/var/git/project.git
973 export CVS_SERVER="git cvsserver"</code></pre>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]974</div></div>
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]975</div></div>
976</li>
977<li>
978<p>
Junio C Hamano33f98432008-04-16 09:10:05[diff] [blame]979For SSH clients that will make commits, make sure their server-side
980 .ssh/environment files (or .bashrc, etc., according to their specific shell)
981 export appropriate values for GIT_AUTHOR_NAME, GIT_AUTHOR_EMAIL,
982 GIT_COMMITTER_NAME, and GIT_COMMITTER_EMAIL. For SSH clients whose login
983 shell is bash, .bashrc may be a reasonable alternative.
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]984</p>
985</li>
986<li>
987<p>
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]988Clients should now be able to check out the project. Use the CVS <em>module</em>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]989 name to indicate what Git <em>head</em> you want to check out. This also sets the
Junio C Hamano33f98432008-04-16 09:10:05[diff] [blame]990 name of your newly checked-out directory, unless you tell it otherwise with
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]991 <code>-d &lt;dir_name&gt;</code>. For example, this checks out <em>master</em> branch to the
992 <code>project-master</code> directory:
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]993</p>
Junio C Hamanof1d14802006-06-08 00:48:17[diff] [blame]994<div class="listingblock">
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]995<div class="content">
Junio C Hamano6a7e2632021-10-04 19:53:05[diff] [blame]996<pre><code> cvs co -d project-master master</code></pre>
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]997</div></div>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]998</li>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]999</ol></div>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]1000</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1001</div>
1002<div class="sect1">
Junio C Hamanob9d9d902018-05-23 07:07:42[diff] [blame]1003<h2 id="dbbackend">DATABASE BACKEND</h2>
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1004<div class="sectionbody">
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1005<div class="paragraph"><p><em>git-cvsserver</em> uses one database per Git head (i.e. CVS module) to
Junio C Hamano9df0c662009-11-23 11:09:27[diff] [blame]1006store information about the repository to maintain consistent
1007CVS revision numbers. The database needs to be
1008updated (i.e. written to) after every commit.</p></div>
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1009<div class="paragraph"><p>If the commit is done directly by using <code>git</code> (as opposed to
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1010using <em>git-cvsserver</em>) the update will need to happen on the
1011next repository access by <em>git-cvsserver</em>, independent of
1012access method and requested operation.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1013<div class="paragraph"><p>That means that even if you offer only read access (e.g. by using
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1014the pserver method), <em>git-cvsserver</em> should have write access to
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1015the database to work reliably (otherwise you need to make sure
Junio C Hamano88bf5712017-09-10 08:39:23[diff] [blame]1016that the database is up to date any time <em>git-cvsserver</em> is executed).</p></div>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1017<div class="paragraph"><p>By default it uses SQLite databases in the Git directory, named
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1018<code>gitcvs.&lt;module_name&gt;.sqlite</code>. Note that the SQLite backend creates
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1019temporary files in the same directory as the database file on
1020write so it might not be enough to grant the users using
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1021<em>git-cvsserver</em> write access to the database file without granting
1022them write access to the directory, too.</p></div>
Junio C Hamano2aba1012019-08-08 21:46:11[diff] [blame]1023<div class="paragraph"><p>The database cannot be reliably regenerated in a
Junio C Hamano9df0c662009-11-23 11:09:27[diff] [blame]1024consistent form after the branch it is tracking has changed.
1025Example: For merged branches, <em>git-cvsserver</em> only tracks
Junio C Hamano1aa40d22010-01-21 17:46:43[diff] [blame]1026one branch of development, and after a <em>git merge</em> an
Junio C Hamano9df0c662009-11-23 11:09:27[diff] [blame]1027incrementally updated database may track a different branch
1028than a database regenerated from scratch, causing inconsistent
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1029CVS revision numbers. <code>git-cvsserver</code> has no way of knowing which
Junio C Hamano9df0c662009-11-23 11:09:27[diff] [blame]1030branch it would have picked if it had been run incrementally
1031pre-merge. So if you have to fully or partially (from old
1032backup) regenerate the database, you should be suspicious
1033of pre-existing CVS sandboxes.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1034<div class="paragraph"><p>You can configure the database backend with the following
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1035configuration variables:</p></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1036<div class="sect2">
1037<h3 id="_configuring_database_backend">Configuring database backend</h3>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1038<div class="paragraph"><p><em>git-cvsserver</em> uses the Perl DBI module. Please also read
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1039its documentation if changing these variables, especially
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1040about <code>DBI-&gt;connect()</code>.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1041<div class="dlist"><dl>
1042<dt class="hdlist1">
Junio C Hamano322c6242015-03-23 21:32:46[diff] [blame]1043gitcvs.dbName
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1044</dt>
1045<dd>
1046<p>
1047 Database name. The exact meaning depends on the
Junio C Hamano1f511962008-01-30 08:28:52[diff] [blame]1048 selected database driver, for SQLite this is a filename.
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1049 Supports variable substitution (see below). May
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1050 not contain semicolons (<code>;</code>).
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1051 Default: <em>%Ggitcvs.%m.sqlite</em>
1052</p>
1053</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1054<dt class="hdlist1">
Junio C Hamano322c6242015-03-23 21:32:46[diff] [blame]1055gitcvs.dbDriver
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1056</dt>
1057<dd>
1058<p>
1059 Used DBI driver. You can specify any available driver
1060 for this here, but it might not work. cvsserver is tested
1061 with <em>DBD::SQLite</em>, reported to work with
1062 <em>DBD::Pg</em>, and reported <strong>not</strong> to work with <em>DBD::mysql</em>.
1063 Please regard this as an experimental feature. May not
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1064 contain colons (<code>:</code>).
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1065 Default: <em>SQLite</em>
1066</p>
1067</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1068<dt class="hdlist1">
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1069gitcvs.dbuser
1070</dt>
1071<dd>
1072<p>
Junio C Hamano322c6242015-03-23 21:32:46[diff] [blame]1073 Database user. Only useful if setting <code>dbDriver</code>, since
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1074 SQLite has no concept of database users. Supports variable
1075 substitution (see below).
1076</p>
1077</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1078<dt class="hdlist1">
Junio C Hamano322c6242015-03-23 21:32:46[diff] [blame]1079gitcvs.dbPass
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1080</dt>
1081<dd>
1082<p>
Junio C Hamano322c6242015-03-23 21:32:46[diff] [blame]1083 Database password. Only useful if setting <code>dbDriver</code>, since
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1084 SQLite has no concept of database passwords.
1085</p>
1086</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1087<dt class="hdlist1">
Junio C Hamanoa74efce2008-04-02 08:39:08[diff] [blame]1088gitcvs.dbTableNamePrefix
1089</dt>
1090<dd>
1091<p>
1092 Database table name prefix. Supports variable substitution
1093 (see below). Any non-alphabetic characters will be replaced
1094 with underscores.
1095</p>
1096</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1097</dl></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1098<div class="paragraph"><p>All variables can also be set per access method, see <a href="#configaccessmethod">above</a>.</p></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1099<div class="sect3">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1100<h4 id="_variable_substitution">Variable substitution</h4>
Junio C Hamano322c6242015-03-23 21:32:46[diff] [blame]1101<div class="paragraph"><p>In <code>dbDriver</code> and <code>dbUser</code> you can use the following variables:</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1102<div class="dlist"><dl>
1103<dt class="hdlist1">
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1104%G
1105</dt>
1106<dd>
1107<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1108 Git directory name
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1109</p>
1110</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1111<dt class="hdlist1">
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1112%g
1113</dt>
1114<dd>
1115<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1116 Git directory name, where all characters except for
Junio C Hamano8ef91f32019-12-01 22:58:27[diff] [blame]1117 alphanumeric ones, <code>.</code>, and <code>-</code> are replaced with
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1118 <code>_</code> (this should make it easier to use the directory
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1119 name in a filename if wanted)
1120</p>
1121</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1122<dt class="hdlist1">
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1123%m
1124</dt>
1125<dd>
1126<p>
Junio C Hamano076ffcc2013-02-06 05:13:21[diff] [blame]1127 CVS module/Git head name
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1128</p>
1129</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1130<dt class="hdlist1">
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1131%a
1132</dt>
1133<dd>
1134<p>
1135 access method (one of "ext" or "pserver")
1136</p>
1137</dd>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1138<dt class="hdlist1">
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1139%u
1140</dt>
1141<dd>
1142<p>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1143 Name of the user running <em>git-cvsserver</em>.
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1144 If no name can be determined, the
1145 numeric uid is used.
1146</p>
1147</dd>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1148</dl></div>
Junio C Hamanoa2ad99e2007-04-18 09:57:04[diff] [blame]1149</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1150</div>
1151</div>
1152</div>
1153<div class="sect1">
Junio C Hamanob141a922010-01-10 19:55:14[diff] [blame]1154<h2 id="_environment">ENVIRONMENT</h2>
1155<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1156<div class="paragraph"><p>These variables obviate the need for command-line options in some
Junio C Hamanob141a922010-01-10 19:55:14[diff] [blame]1157circumstances, allowing easier restricted usage through git-shell.</p></div>
Junio C Hamanoa85030a2022-07-27 16:48:21[diff] [blame]1158<div class="dlist"><dl>
1159<dt class="hdlist1">
1160GIT_CVSSERVER_BASE_PATH
1161</dt>
1162<dd>
1163<p>
1164 This variable replaces the argument to --base-path.
1165</p>
1166</dd>
1167<dt class="hdlist1">
1168GIT_CVSSERVER_ROOT
1169</dt>
1170<dd>
1171<p>
1172 This variable specifies a single directory, replacing the
1173 <code>&lt;directory&gt;...</code> argument list. The repository still requires the
1174 <code>gitcvs.enabled</code> config option, unless <code>--export-all</code> is specified.
1175</p>
1176</dd>
1177</dl></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1178<div class="paragraph"><p>When these environment variables are set, the corresponding
Junio C Hamanob141a922010-01-10 19:55:14[diff] [blame]1179command-line arguments may not be used.</p></div>
1180</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1181</div>
1182<div class="sect1">
Junio C Hamanob9d9d902018-05-23 07:07:42[diff] [blame]1183<h2 id="_eclipse_cvs_client_notes">ECLIPSE CVS CLIENT NOTES</h2>
Junio C Hamano9512fcf2006-03-01 12:05:14[diff] [blame]1184<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1185<div class="paragraph"><p>To get a checkout with the Eclipse CVS client:</p></div>
1186<div class="olist arabic"><ol class="arabic">
Junio C Hamano9512fcf2006-03-01 12:05:14[diff] [blame]1187<li>
1188<p>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1189Select "Create a new project &#8594; From CVS checkout"
Junio C Hamano9512fcf2006-03-01 12:05:14[diff] [blame]1190</p>
1191</li>
1192<li>
1193<p>
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]1194Create a new location. See the notes below for details on how to choose the
1195 right protocol.
Junio C Hamano9512fcf2006-03-01 12:05:14[diff] [blame]1196</p>
1197</li>
1198<li>
1199<p>
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]1200Browse the <em>modules</em> available. It will give you a list of the heads in
1201 the repository. You will not be able to browse the tree from there. Only
1202 the heads.
Junio C Hamano9512fcf2006-03-01 12:05:14[diff] [blame]1203</p>
1204</li>
1205<li>
1206<p>
Junio C Hamano92d80372016-07-13 22:00:05[diff] [blame]1207Pick <code>HEAD</code> when it asks what branch/tag to check out. Untick the
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]1208 "launch commit wizard" to avoid committing the .project file.
Junio C Hamano9512fcf2006-03-01 12:05:14[diff] [blame]1209</p>
1210</li>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1211</ol></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1212<div class="paragraph"><p>Protocol notes: If you are using anonymous access via pserver, just select that.
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]1213Those using SSH access should choose the <em>ext</em> protocol, and configure <em>ext</em>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1214access on the Preferences&#8594;Team&#8594;CVS&#8594;ExtConnection pane. Set CVS_SERVER to
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1215"<code>git cvsserver</code>". Note that password support is not good when using <em>ext</em>,
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1216you will definitely want to have SSH keys setup.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1217<div class="paragraph"><p>Alternatively, you can just use the non-standard extssh protocol that Eclipse
Junio C Hamanodecf50e2006-03-05 10:51:14[diff] [blame]1218offer. In that case CVS_SERVER is ignored, and you will have to replace
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1219the cvs utility on the server with <em>git-cvsserver</em> or manipulate your <code>.bashrc</code>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1220so that calling <em>cvs</em> effectively calls <em>git-cvsserver</em>.</p></div>
Junio C Hamano9512fcf2006-03-01 12:05:14[diff] [blame]1221</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1222</div>
1223<div class="sect1">
Junio C Hamanob9d9d902018-05-23 07:07:42[diff] [blame]1224<h2 id="_clients_known_to_work">CLIENTS KNOWN TO WORK</h2>
Junio C Hamano9512fcf2006-03-01 12:05:14[diff] [blame]1225<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1226<div class="ulist"><ul>
Junio C Hamano103ad7f2007-03-14 11:19:26[diff] [blame]1227<li>
1228<p>
1229CVS 1.12.9 on Debian
1230</p>
1231</li>
1232<li>
1233<p>
Junio C Hamano9512fcf2006-03-01 12:05:14[diff] [blame]1234CVS 1.11.17 on MacOSX (from Fink package)
Junio C Hamano103ad7f2007-03-14 11:19:26[diff] [blame]1235</p>
1236</li>
1237<li>
1238<p>
Junio C Hamano9512fcf2006-03-01 12:05:14[diff] [blame]1239Eclipse 3.0, 3.1.2 on MacOSX (see Eclipse CVS Client Notes)
Junio C Hamano103ad7f2007-03-14 11:19:26[diff] [blame]1240</p>
1241</li>
1242<li>
1243<p>
1244TortoiseCVS
1245</p>
1246</li>
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1247</ul></div>
Junio C Hamano9512fcf2006-03-01 12:05:14[diff] [blame]1248</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1249</div>
1250<div class="sect1">
Junio C Hamanob9d9d902018-05-23 07:07:42[diff] [blame]1251<h2 id="_operations_supported">OPERATIONS SUPPORTED</h2>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]1252<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1253<div class="paragraph"><p>All the operations required for normal use are supported, including
Junio C Hamano36d52292013-01-25 21:32:36[diff] [blame]1254checkout, diff, status, update, log, add, remove, commit.</p></div>
1255<div class="paragraph"><p>Most CVS command arguments that read CVS tags or revision numbers
1256(typically -r) work, and also support any git refspec
1257(tag, branch, commit ID, etc).
1258However, CVS revision numbers for non-default branches are not well
1259emulated, and cvs log does not show tags or branches at
1260all. (Non-main-branch CVS revision numbers superficially resemble CVS
1261revision numbers, but they actually encode a git commit ID directly,
1262rather than represent the number of revisions since the branch point.)</p></div>
1263<div class="paragraph"><p>Note that there are two ways to checkout a particular branch.
1264As described elsewhere on this page, the "module" parameter
1265of cvs checkout is interpreted as a branch name, and it becomes
1266the main branch. It remains the main branch for a given sandbox
1267even if you temporarily make another branch sticky with
1268cvs update -r. Alternatively, the -r argument can indicate
1269some other branch to actually checkout, even though the module
1270is still the "main" branch. Tradeoffs (as currently
1271implemented): Each new "module" creates a new database on disk with
1272a history for the given module, and after the database is created,
1273operations against that main branch are fast. Or alternatively,
1274-r doesn&#8217;t take any extra disk space, but may be significantly slower for
1275many operations, like cvs update.</p></div>
1276<div class="paragraph"><p>If you want to refer to a git refspec that has characters that are
1277not allowed by CVS, you have two options. First, it may just work
1278to supply the git refspec directly to the appropriate CVS -r argument;
1279some CVS clients don&#8217;t seem to do much sanity checking of the argument.
1280Second, if that fails, you can use a special character escape mechanism
1281that only uses characters that are valid in CVS tags. A sequence
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1282of 4 or 5 characters of the form (underscore (<code>"_"</code>), dash (<code>"-"</code>),
1283one or two characters, and dash (<code>"-"</code>)) can encode various characters based
1284on the one or two letters: <code>"s"</code> for slash (<code>"/"</code>), <code>"p"</code> for
1285period (<code>"."</code>), <code>"u"</code> for underscore (<code>"_"</code>), or two hexadecimal digits
Junio C Hamano36d52292013-01-25 21:32:36[diff] [blame]1286for any byte value at all (typically an ASCII number, or perhaps a part
1287of a UTF-8 encoded character).</p></div>
1288<div class="paragraph"><p>Legacy monitoring operations are not supported (edit, watch and related).
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1289Exports and tagging (tags and branches) are not supported at this stage.</p></div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1290<div class="sect2">
1291<h3 id="_crlf_line_ending_conversions">CRLF Line Ending Conversions</h3>
Junio C Hamano92d80372016-07-13 22:00:05[diff] [blame]1292<div class="paragraph"><p>By default the server leaves the <code>-k</code> mode blank for all files,
Junio C Hamano619596a2010-08-18 22:15:35[diff] [blame]1293which causes the CVS client to treat them as a text files, subject
1294to end-of-line conversion on some platforms.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1295<div class="paragraph"><p>You can make the server use the end-of-line conversion attributes to
Junio C Hamano92d80372016-07-13 22:00:05[diff] [blame]1296set the <code>-k</code> modes for files by setting the <code>gitcvs.usecrlfattr</code>
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1297config variable. See <a href="gitattributes.html">gitattributes(5)</a> for more information
Junio C Hamanobb88cf42010-06-21 15:23:55[diff] [blame]1298about end-of-line conversion.</p></div>
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1299<div class="paragraph"><p>Alternatively, if <code>gitcvs.usecrlfattr</code> config is not enabled
Junio C Hamanobb88cf42010-06-21 15:23:55[diff] [blame]1300or the attributes do not allow automatic detection for a filename, then
Junio C Hamano322c6242015-03-23 21:32:46[diff] [blame]1301the server uses the <code>gitcvs.allBinary</code> config for the default setting.
1302If <code>gitcvs.allBinary</code> is set, then file not otherwise
Junio C Hamano92d80372016-07-13 22:00:05[diff] [blame]1303specified will default to <em>-kb</em> mode. Otherwise the <code>-k</code> mode
Junio C Hamano322c6242015-03-23 21:32:46[diff] [blame]1304is left blank. But if <code>gitcvs.allBinary</code> is set to "guess", then
Junio C Hamano92d80372016-07-13 22:00:05[diff] [blame]1305the correct <code>-k</code> mode will be guessed based on the contents of
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1306the file.</p></div>
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1307<div class="paragraph"><p>For best consistency with <em>cvs</em>, it is probably best to override the
Junio C Hamanoc14e6ad2014-10-31 20:25:53[diff] [blame]1308defaults by setting <code>gitcvs.usecrlfattr</code> to true,
Junio C Hamano322c6242015-03-23 21:32:46[diff] [blame]1309and <code>gitcvs.allBinary</code> to "guess".</p></div>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]1310</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1311</div>
1312</div>
1313<div class="sect1">
Junio C Hamanob9d9d902018-05-23 07:07:42[diff] [blame]1314<h2 id="_dependencies">DEPENDENCIES</h2>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]1315<div class="sectionbody">
Junio C Hamano68cf15a2010-11-06 01:01:59[diff] [blame]1316<div class="paragraph"><p><em>git-cvsserver</em> depends on DBD::SQLite.</p></div>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]1317</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1318</div>
1319<div class="sect1">
Junio C Hamanoba4b9282008-07-06 05:20:31[diff] [blame]1320<h2 id="_git">GIT</h2>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]1321<div class="sectionbody">
Junio C Hamanoa28a9202012-06-21 07:08:23[diff] [blame]1322<div class="paragraph"><p>Part of the <a href="git.html">git(1)</a> suite</p></div>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]1323</div>
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]1324</div>
Junio C Hamano9d971152012-12-19 00:43:11[diff] [blame]1325</div>
Junio C Hamano7bd050f2011-09-22 06:32:22[diff] [blame]1326<div id="footnotes"><hr /></div>
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]1327<div id="footer">
1328<div id="footer-text">
Junio C Hamano2ef0ba32018-01-26 23:13:53[diff] [blame]1329Last updated
Junio C Hamano918a6972023-10-29 23:44:11[diff] [blame]1330 2023-06-24 05:24:09 JST
Junio C Hamano34b18112006-02-23 11:21:40[diff] [blame]1331</div>
1332</div>
1333</body>
1334</html>