my $iter = Git::Repository::Log::Iterator->new( @args );
Create a new <B>git logB> stream from the parameter list in @args
and return a iterator on it.
new() will happily accept any parameters, but note that
Git::Repository::Log::Iterator expects the output to look like that
of --pretty=raw, and so will force the the --pretty option
(in case format.pretty is defined in the Git configuration).
It will also forcibly remove colored output (using --color=never).
Extra output (like patches) will be stored in the extra parameter of
the Git::Repository::Log object. Decorations will be lost.
When unsupported options are recognized in the parameter list, new()
will croak() with a message advising to use run( log => ... )
to parse the output yourself.
The object is really a blessed hash reference, with only two keys:
The Git::Repository::Command object running the actual <B>git logB>
command. It might not be defined in some cases (see below new_from_fh
The filehandle from which the output of <B>git logB> is actually read.
This is the only attribute needed to run the next method.