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

Reply via email to