Subject: | Documentation problems. |
The following in Maypole::Manual::Beer will fail if in module with the pragma use strict.
BeerDB::Pub->has_many(beers => [ BeerDB::Handpump => 'beer' ]);
BeerDB::Beer->has_many(pubs => [ BeerDB::Handpump => 'pub']);
should be something like
BeerDB::Pub->has_many(beers => [ 'BeerDB::Handpump' => 'beer' ]);
BeerDB::Beer->has_many(pubs => [ 'BeerDB::Handpump' => 'pub']);
as otherwise it will fail under some versions of perl (like 5.8.6). (althouh perlop(1) is ambiguous about whether those single quotes will be included in the string, so maybe it should be "'B::H', 'pub'"?)
Maybe a note to draw the readers attention to this as well, like:
Note the single quotes around BeerDB::Handpump are nescessary for some versions of perl when "use strict" is in effect.