perldiag.pod: Fix broken link
pod/perlre: Italicize text to indicate non-literal

Also, changes a reference to the section into an actual link.
perldiag: Nits
pod/perldiag: Document new messages for qr/(?[ ])/
pod/perldiag: Document some regex messages