| Subject: | ":all" export tag should be documented less prominently |
The SYNOPSIS suggests to write "use UUID ':all'". This is problematic, as functions with rather unspecific names are imported this way, for example generate(), parse(), compare() (clashes with File::Compare's compare()) and copy() (clashes with File::Copy's copy()).
Maybe it would be better to just document the import of the uuid() function on top of the SYNOPSIS, and have another block with all other functions, or to fully-qualify the other function calls. Something like this:
use UUID 'uuid';
$string = uuid(); # generate stringified UUID
UUID::generate($uuid); # generate binary UUID, prefer random
etc.