view release on metacpan or  search on metacpan

bin/grindperl  view on Meta::CPAN

is C<< /tmp >>.  This needs to be a directory for which you have write
permissions.

=head2 --debugging

Boolean flag.  Sets C<< -DDEBUGGING >>.  Default is true.

=head2 --threads

Boolean flag.  Sets C<< -Dusethreads >>.  Default is true.

=head2 --cache

Boolean flag.  When true, C<< grindperl >> will save your C<< config.sh >>
and C<< Policy.sh >> files to a hidden cache file.  If these files
exist, it will restore them and run C<< Configure >> with the C<< -r >> option.

Using cached config files from a different commit can break things
and is not recommended.

Defaults to false.

=head2 --man

Boolean flag.  When false, C<< grindperl >> will disable man directories
and man files will not be generated or installed.  Defaults to false.

=head2 --verbose or -v

Outputs some extra progress messages and warnings.

=head2 --define KEY=VALUE or -D KEY=VALUE

=head2 --undefine KEY or -U KEY

=head2 --additions KEY=VALUE or -A KEY=VALUE

May be specified multiple times with different values of KEY.  These set
the C<< -D >>, C<< -U >> and C<< -A >> options for C<< Configure >>.  Note
that unlike C<< Configure >>, these require a space between the option and
the key or key/value pair.

=head2 --32 (EXPERIMENTAL)

This experimental flag tries to force as much 32-bitness as possible, even on
a 64 bit operating system.  It's very hacky, messes with compiler and linker
flags and is not guaranteed on all platforms.

=head1 CONFIGURATION FILE

You can put command line options into a configuration file, one per line,
and they will be prepended to C<< @ARGV >> before options are processed.  For
example, here is what I have in my config file.

    --install_root=/opt/perl
    -D cc='ccache gcc'
    -D cf_by=dagolden
    -D cf_email='dagolden@cpan.org'
    -D perladmin='dagolden@cpan.org'
    -D optimize=-g
    -A ccflags=-DPERL_USE_SAFE_PUTENV

To edit the config file, be sure your C<< EDITOR >> environment variable is set
and then run C<< grindperl --edit >>.

=head1 CAVEATS

=over 4

=item *

You must have git installed and in your path

=item *

This depends on certain shell redirection constructs and is unlikely to work on non-POSIX systems

=back

=head1 AUTHOR

David Golden <dagolden@cpan.org>

=head1 COPYRIGHT AND LICENSE

This software is Copyright (c) 2011 by David Golden.

This is free software, licensed under:

  The Apache License, Version 2.0, January 2004

=cut

__END__


# vim: ts=2 sts=2 sw=2 et: