Read-only release history for Test-Smoke
Perl C
Switch branches/tags
stable gitpan_version/1.61_03 gitpan_version/1.59 gitpan_version/1.53 gitpan_version/1.52 gitpan_version/1.50 gitpan_version/1.47 gitpan_version/1.46 gitpan_version/1.44 gitpan_version/1.43 gitpan_version/1.42 gitpan_version/1.40 gitpan_version/1.39 gitpan_version/1.37 gitpan_version/1.36 gitpan_version/1.35 gitpan_version/1.34 gitpan_version/1.33 gitpan_version/1.32 gitpan_version/1.31 gitpan_version/1.29_60 gitpan_version/1.20.07 gitpan_version/1.20.05 gitpan_version/1.20.04 gitpan_version/1.20.03 gitpan_version/1.20 gitpan_version/1.19_83 gitpan_version/1.19_81 gitpan_version/1.19_76 gitpan_version/1.19_72 gitpan_version/1.19_71 gitpan_version/1.19 gitpan_version/1.19-RC1 gitpan_version/1.18.10 gitpan_version/1.18.09 gitpan_version/1.18.06 gitpan_version/1.18.02 gitpan_version/1.18 gitpan_version/1.17_62 gitpan_version/1.17_60 gitpan_version/1.17.06 gitpan_version/1.17.02 gitpan_version/1.17 gitpan_version/1.16_30 gitpan_version/1.16_24 gitpan_version/1.16_22 gitpan_version/1.16_21 gitpan_version/1.16_20 gitpan_version/1.16_15 gitpan_version/1.16 gitpan_version/1.15 gitpan_version/1.13 gitpan_version/1.12 gitpan_version/1.11 gitpan_version/1.10 gitpan_version/1.08 gitpan_version/1.07 gitpan_version/1.06 gitpan_version/1.6 cpan_version/1.61_03 cpan_version/1.59 cpan_version/1.53 cpan_version/1.52 cpan_version/1.50 cpan_version/1.47 cpan_version/1.46 cpan_version/1.44 cpan_version/1.43 cpan_version/1.42 cpan_version/1.40 cpan_version/1.39 cpan_version/1.37 cpan_version/1.36 cpan_version/1.35 cpan_version/1.34 cpan_version/1.33 cpan_version/1.32 cpan_version/1.31 cpan_version/1.29_60 cpan_version/1.20.07 cpan_version/1.20.05 cpan_version/1.20.04 cpan_version/1.20.03 cpan_version/1.20 cpan_version/1.19_83 cpan_version/1.19_81 cpan_version/1.19_76 cpan_version/1.19_72 cpan_version/1.19_71 cpan_version/1.19 cpan_version/1.19-RC1 cpan_version/1.18.10 cpan_version/1.18.09 cpan_version/1.18.06 cpan_version/1.18.02 cpan_version/1.18 cpan_version/1.17_62 cpan_version/1.17_60 cpan_version/1.17.06 cpan_version/1.17.02
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


=head1 NAME

README - Perl Core Test Smoke Suite (1.62)


  $ perl      # will generate
  $ sh

or on windows:

    C:\smoke>configsmoke     # will generate smokecurrent.bat

For the impatient: see the section L</"GETTING STARTED">


The perl core test smoke suite is a set of scripts and modules that try to
run the perl core tests on as many configurations as possible and combine
the results into an easy to read report.

The basic cycle looks like:

    foreach $config ( @configurations ) {
        make distclean
        ./Configure $config
        make test (and log failures)

Before you start "smoking" we expect you have tried to build some of
the configurations "by hand" to check if your environment is okay.


The Test::Smoke suite has been designed to be installed outside of the
normal Perl library-tree. It will also run from the directory in which
it was un-tar-gzipped, but if you like to keep up to date with
Test::Smoke releases, it might be useful to use the standard
perl-module installation commands:

    $ perl Makefile.PL
    $ make test
    $ make install

The F<Makefile.PL> program will ask for a directory in which
Test::Smoke should be installed (this will set I<PREFIX>,
I<INSTALLSCRIPT> and I<LIB> all to that directory).

I<If you want to automate the Makefile.PL step you need to set two
environment variables: $ENV{SMOKE_INSTDIR}='../p5smoke' and


You are now ready to run the F<> configuration program:

    $ perl

You will have to answer some questions that help create a
configuration file for the Test::Smoke suite.

You should check the F<perlcurrent.cfg> (or F<w32current.cfg> on MSWin32)
build-configurations file and remove options that are not supported for your

Now you are set to go:

    $ sh

If something useful happens, do it every night using a scheduler.


=over 4

=item Test::Smoke configuration

You can create configurations by running the F<>
program. Please see its L<documentation|>.

=item Build configurations

At the moment there are no guidelines of how to change the
build-configuration best to fit the needs of perl5-porters while still
getting as much smoke out of the test as possible, simply because the
needs of perl5-porters change over time:).

This also makes Test::Smoke somewhat volatile, as we aim to please the
perl5-porters as much as possible, to help make perl even better, more
stable and as thoroughly tested as possible.


=head1 Note to MSWin32 users

To make it clear, the perl core test smoke suite treats B<cygwin> and
B<DJGPP> as unixy platforms and not as true MSWin32.

To keep in sync with the source-tree, it is recommended you use L<git>. As long
as you use a version that also comes with a command-line tool.

Some problems have been reported with older versions of cygwin and the
patch program during the C<< S<[nd]make test> >> stage of
Test::Smoke. Don't worry about it if you do not intend to use patch.

During smoke testing stuff might crash and give a popup. You'll want to disable Windows error reporting:

    Action Center (from Control Panel)
      -> Maintenance
          -> Settings
              -> Never check for solutions

For more information see:

In "older" Windows versions (before 7) we have found some problems with the default
windows debugger B<Dr.Watson>. By default Dr.Watson will pop-up when the moral
equivalent of a segmentation fault happens, this will make the smoke wait for
user input. You can disable this by starting F<drwtsn32.exe> and un-check the
B<Visual Notification> and B<Sound Notification> check-boxes and press B<OK>.

=head1 Slow Systems

It can happen that your system is not able to pursue all the tests, either
because it is too slow or because some of the configurations are not
supported by the system. At first, don't worry, they are detected by the
report creation script and shown as such.

After the first run gave you some idea of how long the smoke will run on
your system,  you can create your own copy of smoke.cfg where you either
add new combinations and/or test levels, or delete lines to speed up the
run time of Test::Smoke.

=head1 Availability and references

=over 4

=item B<Distribution>

=item B<Archives>

=over 4

=item B<Reports>

        [subscribe: <>]

=item B<Smokers>

        [subscribe: <>]

=item B<Others>

  Perl general QA:

=item B<CoreSmokeDB>

We also keep a database of smokereports that are created by Test::Smoke
1.58 or higher.




Copyright (C) 2001-2014

  * H.Merijn Brand
  * Abe Timmerman

This suite is free software; you can redistribute it and/or modify it
under the same terms as Perl itself, without consulting the author.

(Future) Co-Authors and or contributors should agree to this before
submitting patches.


=over 4

=item *

=item *


This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of

=head1 AUTHOR

The perl core test smoke suite is maintained by Abe Timmerman

H.Merijn Brand <> in dialogue and consultation with
Michael Schwern <>, the Perl QA pumpkin.

Contributors and/or co-authors:

    Configurations and
      nuts and bolts    Nicholas Clark <>            Jarkko Hietaniemi
    Portability issues  Will Coleda - IMG <>
    Safety              Richard Soderberg
    Win32/MSC5/dmake    Mattia Barbon
                        Abe Timmerman <>
                        Christian Walde <> *
    Cygwin              John Peacock <>
    Sharing issues      Blair Zajac
    Good ideas          Jos Boumans <>
    VMS                 Craig Berry *
    SysInfo             Alain Barbet
                        Merijn Brand *
                        Alan Burlison
                        Allen Smith
                        David Woolger
                        Campo Wijerman

and all the people having useful suggestions and nits, starting at
YAPC::Europe-2.0.01, where Michael talked Merijn into simplifying his own
test-suite and sharing it with the community.

The Test::Smoke team.

=head1 MISC

As always, have the appropriate amount of fun!

=head1 SEE ALSO

L<ReleaseNotes>, L<FAQ>

=head1 TODO

=over 4

=item * More test-suite

=item * VMS?