Ah, but the best way to learn (IMO) is to copy and tweak. Yes, it spawns a lot of cargo-cult, but not everyone has the time, the effort and the inclination to devour every word of a man page, especially poorly written ones! So, let's work at tweaking this one:

sub wanted {
  -l && !-e && print "bogus link: $File::Find::name\n";
}
[download]

perldoc perlfunc will show you a list of all the file test functions available. -l means 'is a symlink' and -e means 'file exists'. What File::Find does is apply the 'wanted' sub (or any other sub-ref passed) to every file it finds (with $_ locally set as the filename, having chdir-ed to any directory it finds), so in this case it checks first of all if the file is a symlink (-l), and then if the file doesn't actually exist (-e). If this is true then it tells you that that link is broken (using $File::Find::name which is the fully qualified file name, relative to where you are) So, say we actually wanted to find all .mp3 files. We'd use something like:

sub wanted {
  return unless -f && /\.mp3$/;
  print $File::Find::name, "\n";
}
[download]

Or, you could push them to an array, or whatever. Then you just call this as: find (\&wanted, $BASEDIR)

Tony