bug#5568: Man-follow-manual-reference vs. perl man pages

[Juri Linkov]

> Many man pages have SEE ALSOs like
>
>   SEE ALSO
>          XML::Parser::Lite.
>   perl v5.10.0 2009-08-23 XML::Parser::Lite::Tree(3pm)
>
> However Man-follow-manual-reference can't figure out that kind of
> SEE ALSO item.

The references in this SEE ALSO section are in a non-standard format.
A reference should be a word followed by the section name in parentheses.
So these man pages should write references in the format
"XML::Parser::Lite(3pm)".

Of course, you can get what you want with the following patch:

=== modified file 'lisp/man.el'
--- lisp/man.el 2010-02-11 20:57:10 +0000
+++ lisp/man.el 2010-02-12 19:18:50 +0000
@@ -1135,7 +1135,7 @@ (defun Man-highlight-references (&option
        (Man-highlight-references0 nil Man-apropos-regexp 1
                                   'Man-default-man-entry
                                   (or xref-man-type 'Man-xref-man-page)))
-    (Man-highlight-references0 Man-see-also-regexp Man-reference-regexp 1
+    (Man-highlight-references0 Man-see-also-regexp 
Man-hyphenated-reference-regexp 1
                               'Man-default-man-entry
                               (or xref-man-type 'Man-xref-man-page))
     (Man-highlight-references0 Man-synopsis-regexp Man-header-regexp 0 2

But it will also highlight every word in those SEE ALSO sections
that have lengthy text in several paragraphs.  Look for example
`M-x man XML::Twig RET' - there are 60 lines in the SEE ALSO section
where all words will be highlighted as a reference!

-- 
Juri Linkov
http://www.jurta.org/emacs/