Generated.
[git2cl.git] / README.html
blob848d4652922857b859f09a60e2217ac5922f1e60
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
2 "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
3 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
4 <head>
5 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
6 <meta name="generator" content="AsciiDoc 7.1.2" />
7 <style type="text/css">
8 /* Debug borders */
9 p, li, dt, dd, div, pre, h1, h2, h3, h4, h5, h6 {
10 /*
11 border: 1px solid red;
12 */
15 body {
16 margin: 1em 5% 1em 5%;
19 a {
20 color: blue;
21 text-decoration: underline;
23 a:visited {
24 color: fuchsia;
27 em {
28 font-style: italic;
31 strong {
32 font-weight: bold;
35 tt {
36 color: navy;
39 h1, h2, h3, h4, h5, h6 {
40 color: #527bbd;
41 font-family: sans-serif;
42 margin-top: 1.2em;
43 margin-bottom: 0.5em;
44 line-height: 1.3;
47 h1 {
48 border-bottom: 2px solid silver;
50 h2 {
51 border-bottom: 2px solid silver;
52 padding-top: 0.5em;
55 div.sectionbody {
56 font-family: serif;
57 margin-left: 0;
60 hr {
61 border: 1px solid silver;
64 p {
65 margin-top: 0.5em;
66 margin-bottom: 0.5em;
69 pre {
70 padding: 0;
71 margin: 0;
74 span#author {
75 color: #527bbd;
76 font-family: sans-serif;
77 font-weight: bold;
78 font-size: 1.2em;
80 span#email {
82 span#revision {
83 font-family: sans-serif;
86 div#footer {
87 font-family: sans-serif;
88 font-size: small;
89 border-top: 2px solid silver;
90 padding-top: 0.5em;
91 margin-top: 4.0em;
93 div#footer-text {
94 float: left;
95 padding-bottom: 0.5em;
97 div#footer-badges {
98 float: right;
99 padding-bottom: 0.5em;
102 div#preamble,
103 div.tableblock, div.imageblock, div.exampleblock, div.verseblock,
104 div.quoteblock, div.literalblock, div.listingblock, div.sidebarblock,
105 div.admonitionblock {
106 margin-right: 10%;
107 margin-top: 1.5em;
108 margin-bottom: 1.5em;
110 div.admonitionblock {
111 margin-top: 2.5em;
112 margin-bottom: 2.5em;
115 div.content { /* Block element content. */
116 padding: 0;
119 /* Block element titles. */
120 div.title, caption.title {
121 font-family: sans-serif;
122 font-weight: bold;
123 text-align: left;
124 margin-top: 1.0em;
125 margin-bottom: 0.5em;
127 div.title + * {
128 margin-top: 0;
131 td div.title:first-child {
132 margin-top: 0.0em;
134 div.content div.title:first-child {
135 margin-top: 0.0em;
137 div.content + div.title {
138 margin-top: 0.0em;
141 div.sidebarblock > div.content {
142 background: #ffffee;
143 border: 1px solid silver;
144 padding: 0.5em;
147 div.listingblock > div.content {
148 border: 1px solid silver;
149 background: #f4f4f4;
150 padding: 0.5em;
153 div.quoteblock > div.content {
154 padding-left: 2.0em;
157 div.attribution {
158 text-align: right;
160 div.verseblock + div.attribution {
161 text-align: left;
164 div.admonitionblock .icon {
165 vertical-align: top;
166 font-size: 1.1em;
167 font-weight: bold;
168 text-decoration: underline;
169 color: #527bbd;
170 padding-right: 0.5em;
172 div.admonitionblock td.content {
173 padding-left: 0.5em;
174 border-left: 2px solid silver;
177 div.exampleblock > div.content {
178 border-left: 2px solid silver;
179 padding: 0.5em;
182 div.verseblock div.content {
183 white-space: pre;
186 div.imageblock div.content { padding-left: 0; }
187 div.imageblock img { border: 1px solid silver; }
188 span.image img { border-style: none; }
190 dl {
191 margin-top: 0.8em;
192 margin-bottom: 0.8em;
194 dt {
195 margin-top: 0.5em;
196 margin-bottom: 0;
197 font-style: italic;
199 dd > *:first-child {
200 margin-top: 0;
203 ul, ol {
204 list-style-position: outside;
206 ol.olist2 {
207 list-style-type: lower-alpha;
210 div.tableblock > table {
211 border: 3px solid #527bbd;
213 thead {
214 font-family: sans-serif;
215 font-weight: bold;
217 tfoot {
218 font-weight: bold;
221 div.hlist {
222 margin-top: 0.8em;
223 margin-bottom: 0.8em;
225 td.hlist1 {
226 vertical-align: top;
227 font-style: italic;
228 padding-right: 0.8em;
230 td.hlist2 {
231 vertical-align: top;
234 @media print {
235 div#footer-badges { display: none; }
237 /* Workarounds for IE6's broken and incomplete CSS2. */
239 div.sidebar-content {
240 background: #ffffee;
241 border: 1px solid silver;
242 padding: 0.5em;
244 div.sidebar-title, div.image-title {
245 font-family: sans-serif;
246 font-weight: bold;
247 margin-top: 0.0em;
248 margin-bottom: 0.5em;
251 div.listingblock div.content {
252 border: 1px solid silver;
253 background: #f4f4f4;
254 padding: 0.5em;
257 div.quoteblock-content {
258 padding-left: 2.0em;
261 div.exampleblock-content {
262 border-left: 2px solid silver;
263 padding-left: 0.5em;
265 </style>
266 <title>git2cl</title>
267 </head>
268 <body>
269 <div id="header">
270 <h1>git2cl</h1>
271 </div>
272 <div id="preamble">
273 <div class="sectionbody">
274 <p>This is a quick'n'dirty tool to convert git logs to GNU ChangeLog
275 format.</p>
276 <p>The tool expects output from <em>git &#8212;pretty &#8212;numstat &#8212;summary</em> on
277 stdin. Thus, typically you would use it as follows:</p>
278 <div class="literalblock">
279 <div class="content">
280 <pre><tt>jas@mocca:~/src/libtasn1$ git log --pretty --numstat --summary | ~/src/git2cl/git2cl &gt; ChangeLog
281 jas@mocca:~/src/libtasn1$</tt></pre>
282 </div></div>
283 <p>The output format is specified by:</p>
284 <p><a href="http://www.gnu.org/prep/standards/html_node/Change-Logs.html">http://www.gnu.org/prep/standards/html_node/Change-Logs.html</a></p>
285 <p>In the future, git2cl may be modified to run this command itself,
286 similar to how cvs2cl works.</p>
287 <p>My inspiration for writing this tool was the
288 <a href="http://www.red-bean.com/cvs2cl/">cvs2cl</a> tool, which I am using in
289 several projects. Replacing it is a necessary condition for me to
290 seriously consider switching from CVS to GIT for my projects.</p>
291 <p>Currently, git2cl lacks much of the flexibility in git2cl. Sheesh,
292 git2cl doesn't even have command line parameters!</p>
293 <p>The canonical home page for git2cl is:
294 <a href="http://josefsson.org/git2cl/">http://josefsson.org/git2cl/</a> and its repository can be found at
295 <a href="http://repo.or.cz/w/git2cl.git">http://repo.or.cz/w/git2cl.git</a>.</p>
296 </div>
297 </div>
298 <h2>Support</h2>
299 <div class="sectionbody">
300 <p>Try talking to <a href="mailto:simon@josefsson.org">Simon Josefsson</a>.</p>
301 </div>
302 <div id="footer">
303 <div id="footer-text">
304 Last updated 02-Mar-2007 09:54:25 CEST
305 </div>
306 </div>
307 </body>
308 </html>