On Fri, Jan 26, 2001 at 02:29:38PM -0500, Uri Guttman wrote:
> check out the internal flag feature (?imsx). it is documented in
> perlre. it is meant for the very thing you are asking for.
>
> odd mistake in that doc (5.005_03):
>
> The letters between ? and : act as flags modifiers, see the
> (?imsx-imsx) manpage.
>
> what (?imsx-imsx) manpage?
That's an artifact of the poor design of the L<> pod construct.
The pod L<(?imsx-imsx)> is rendered as "the (?imsx-imsx) manpage" with a
link to a manpage named (?imsx-imsx).
In order to link to another section in the same document, one must write
L<"(?imsx-imsx)">. Or, with optional descriptive text,
L<the section on (?imsx-imsx)|"(?imsx-imsx)">.
Personally, I think it is very unfortunate that the default behavior of L<>
is to add the words 'the' and 'manpage' to the formatted text. I always
specify text to use instead.
See L<perlpod|perlpod> for more details.
> there is a section below which does cover this in more detail.
That's what the author meant to link to with the L<>.
Ronald