From 1d74d4c0d933fc69ed5cec838c73502584dead05 Mon Sep 17 00:00:00 2001 From: Dmitry Smirnov <onlyjob@member.fsf.org> Date: Wed, 19 Sep 2012 17:43:32 +1000 Subject: adding basic POD documentation: To allow generation of man page using "pod2man" as well as accessing embedded documentation with "perldoc" (best practice). --- git2cl | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) (limited to 'git2cl') diff --git a/git2cl b/git2cl index bc36f7e..5d9b90c 100755 --- a/git2cl +++ b/git2cl @@ -33,6 +33,41 @@ # Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA # 02110-1301 USA. +=head1 NAME + +git2cl - tool to convert git logs to GNU ChangeLog + +=head1 SYNOPSIS + +git2cl > ChangeLog + +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: + + git log --pretty --numstat --summary | git2cl > ChangeLog + +=head1 DESCRIPTION + +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: + +=head1 SEE ALSO + +Output format specification: + <http://www.gnu.org/prep/standards/html_node/Change-Logs.html> + +=head1 AUTHORS + +git2cl is developed by Simon Josefsson <simon@josefsson.org> + and Luis Mondesi <lemsx1@gmail.com> + +=cut + use strict; use POSIX qw(strftime); use Text::Wrap qw(wrap); -- cgit v1.1