--- Canary-Stability/Stability.pm	2015/06/04 23:49:11	1.3
+++ Canary-Stability/Stability.pm	2015/06/29 00:02:01	1.7
@@ -1,28 +1,35 @@
 =head1 NAME
 
-Canary::Stability - to be done
+Canary::Stability - canary to check perl compatibility for schmorp's modules
 
 =head1 SYNOPSIS
 
- use Canary::Stability;
+ # in Makefile.PL
+ use Canary::Stability DISTNAME => 2001, MINIMUM_PERL_VERSION;
 
 =head1 DESCRIPTION
 
-This is just a placeholder module, to be filled in later.
+This module is used by Schmorp's modules during configuration stage to
+test the installed perl for compatibility with his modules.
 
-=over 4
+It's not, at this stage, meant as a tool for other module authors,
+although in principle nothing prevents them from subscribing to the same
+ideas.
+
+See the F<Makefile.PL> in L<Coro> or L<AnyEvent> for usage examples.
 
 =cut
 
 package Canary::Stability;
 
 BEGIN {
-   $VERSION = 2001;
+   $VERSION = 2006;
 }
 
 sub sgr {
    # we just assume ANSI almost everywhere
    # red 31, yellow 33, green 32
+   local $| = 1;
 
    $ENV{PERL_CANARY_STABILITY_COLOUR} ne 0
    and ((-t STDOUT and length $ENV{TERM}) or $ENV{PERL_CANARY_STABILITY_COLOUR})
@@ -85,7 +92,7 @@
 ***
 
 EOF
-   } elsif ($] <= 5.020) {
+   } elsif ($] < 5.021) {
       #sgr 32;
       print <<EOF;
 
@@ -138,8 +145,8 @@
 ***    Set PERL_CANARY_STABILITY_NOPROMPT=1 in your environment.
 ***    More info is in the Canary::Stability manpage.
 ***
-*** Long version of this FAQ: http://stabilityperl.schmorp.de/faq.html
-*** Stability Branch homepage: http://stabilityperl.schmorp.de/
+*** Long version of this FAQ: http://stableperl.schmorp.de/faq.html
+*** Stability Branch homepage: http://stableperl.schmorp.de/
 ***
 
 EOF
@@ -180,7 +187,7 @@
 =head1 AUTHOR
 
  Marc Lehmann <schmorp@schmorp.de>
- http://home.schmorp.de/
+ http://software.schmorp.de/pkg/Canary-Stability.html
 
 =cut