README.html

   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 */
  13 }
  14
  15 body {
  16   margin: 1em 5% 1em 5%;
  17 }
  18
  19 a {
  20   color: blue;
  21   text-decoration: underline;
  22 }
  23 a:visited {
  24   color: fuchsia;
  25 }
  26
  27 em {
  28   font-style: italic;
  29 }
  30
  31 strong {
  32   font-weight: bold;
  33 }
  34
  35 tt {
  36   color: navy;
  37 }
  38
  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;
  45 }
  46
  47 h1 {
  48   border-bottom: 2px solid silver;
  49 }
  50 h2 {
  51   border-bottom: 2px solid silver;
  52   padding-top: 0.5em;
  53 }
  54
  55 div.sectionbody {
  56   font-family: serif;
  57   margin-left: 0;
  58 }
  59
  60 hr {
  61   border: 1px solid silver;
  62 }
  63
  64 p {
  65   margin-top: 0.5em;
  66   margin-bottom: 0.5em;
  67 }
  68
  69 pre {
  70   padding: 0;
  71   margin: 0;
  72 }
  73
  74 span#author {
  75   color: #527bbd;
  76   font-family: sans-serif;
  77   font-weight: bold;
  78   font-size: 1.2em;
  79 }
  80 span#email {
  81 }
  82 span#revision {
  83   font-family: sans-serif;
  84 }
  85
  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;
  92 }
  93 div#footer-text {
  94   float: left;
  95   padding-bottom: 0.5em;
  96 }
  97 div#footer-badges {
  98   float: right;
  99   padding-bottom: 0.5em;
 100 }
 101
 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;
 109 }
 110 div.admonitionblock {
 111   margin-top: 2.5em;
 112   margin-bottom: 2.5em;
 113 }
 114
 115 div.content { /* Block element content. */
 116   padding: 0;
 117 }
 118
 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;
 126 }
 127 div.title + * {
 128   margin-top: 0;
 129 }
 130
 131 td div.title:first-child {
 132   margin-top: 0.0em;
 133 }
 134 div.content div.title:first-child {
 135   margin-top: 0.0em;
 136 }
 137 div.content + div.title {
 138   margin-top: 0.0em;
 139 }
 140
 141 div.sidebarblock > div.content {
 142   background: #ffffee;
 143   border: 1px solid silver;
 144   padding: 0.5em;
 145 }
 146
 147 div.listingblock > div.content {
 148   border: 1px solid silver;
 149   background: #f4f4f4;
 150   padding: 0.5em;
 151 }
 152
 153 div.quoteblock > div.content {
 154   padding-left: 2.0em;
 155 }
 156
 157 div.attribution {
 158   text-align: right;
 159 }
 160 div.verseblock + div.attribution {
 161   text-align: left;
 162 }
 163
 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;
 171 }
 172 div.admonitionblock td.content {
 173   padding-left: 0.5em;
 174   border-left: 2px solid silver;
 175 }
 176
 177 div.exampleblock > div.content {
 178   border-left: 2px solid silver;
 179   padding: 0.5em;
 180 }
 181
 182 div.verseblock div.content {
 183   white-space: pre;
 184 }
 185
 186 div.imageblock div.content { padding-left: 0; }
 187 div.imageblock img { border: 1px solid silver; }
 188 span.image img { border-style: none; }
 189
 190 dl {
 191   margin-top: 0.8em;
 192   margin-bottom: 0.8em;
 193 }
 194 dt {
 195   margin-top: 0.5em;
 196   margin-bottom: 0;
 197   font-style: italic;
 198 }
 199 dd > *:first-child {
 200   margin-top: 0;
 201 }
 202
 203 ul, ol {
 204     list-style-position: outside;
 205 }
 206 ol.olist2 {
 207   list-style-type: lower-alpha;
 208 }
 209
 210 div.tableblock > table {
 211   border: 3px solid #527bbd;
 212 }
 213 thead {
 214   font-family: sans-serif;
 215   font-weight: bold;
 216 }
 217 tfoot {
 218   font-weight: bold;
 219 }
 220
 221 div.hlist {
 222   margin-top: 0.8em;
 223   margin-bottom: 0.8em;
 224 }
 225 td.hlist1 {
 226   vertical-align: top;
 227   font-style: italic;
 228   padding-right: 0.8em;
 229 }
 230 td.hlist2 {
 231   vertical-align: top;
 232 }
 233
 234 @media print {
 235   div#footer-badges { display: none; }
 236 }
 237 /* Workarounds for IE6's broken and incomplete CSS2. */
 238
 239 div.sidebar-content {
 240   background: #ffffee;
 241   border: 1px solid silver;
 242   padding: 0.5em;
 243 }
 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;
 249 }
 250
 251 div.listingblock div.content {
 252   border: 1px solid silver;
 253   background: #f4f4f4;
 254   padding: 0.5em;
 255 }
 256
 257 div.quoteblock-content {
 258   padding-left: 2.0em;
 259 }
 260
 261 div.exampleblock-content {
 262   border-left: 2px solid silver;
 263   padding-left: 0.5em;
 264 }
 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>