I agree with this and just wanted to add a note: One of the POD to HTML converters (I forget which one) always turned a link like L<File::Spec> into something that looked like this: "the File::Spec manpage" (or something to that effect), which of course wasn't very helpful when inserted into various sentences, so I had to take to writing things like "the L<File::Spec|File::Spec> documentation". A little annoying but I guess it's better to be explicit.