riscv-openocd-wch/tools/git2cl/README

46 lines
1.5 KiB
Plaintext

git2cl
======
This is a quick'n'dirty tool to convert git logs to GNU ChangeLog
format.
The tool invokes 'git log' internally unless you pipe a log to it.
Thus, typically you would use it as follows:
...........................................................................
jas@mocca:~/src/libtasn1$ git2cl > ChangeLog
jas@mocca:~/src/libtasn1$
...........................................................................
If you don't want git2cl to invoke git log internally, you can use it
as a pipe. It needs a git log generated with --pretty --numstat and
--summary. You can use it as follows:
...........................................................................
jas@mocca:~/src/libtasn1$ git log --pretty --numstat --summary | ~/src/git2cl/git2cl > ChangeLog
jas@mocca:~/src/libtasn1$
...........................................................................
The output format is specified by:
link:http://www.gnu.org/prep/standards/html_node/Change-Logs.html[]
My inspiration for writing this tool was the
link:http://www.red-bean.com/cvs2cl/[cvs2cl] tool, which I have been
using in several projects. Replacing it was necessary to seriously
consider switching from CVS to GIT for my projects.
The canonical home page for git2cl is:
link:http://josefsson.org/git2cl/[] and its repository can be found at
link:http://repo.or.cz/w/git2cl.git[].
Credits
-------
Luis Mondesi contributed several improvements.
Support
-------
Try talking to mailto:simon@josefsson.org[Simon Josefsson].