--- Canary-Stability/Stability.pm	2015/06/04 23:49:11	1.3
+++ Canary-Stability/Stability.pm	2015/06/05 00:39:05	1.4
@@ -1,14 +1,22 @@
 =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.
+
+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.
 
 =over 4