=head1 NAME
   
Test - Test POD for PerlMonks question

=head1 SYNOPSIS

  # download this code from PerlMonks, then
  perldoc test.pod

  # or, probably better...
  pod2html test.pod

=head1 ABSTRACT

Test POD for PerlMonks question

=head1 DESCRIPTION

Your question is a tough one. There isn't (according to the perlpod docs) a
way to add a label to an area like there is in HTML, so it doesn't seem like
there's a way to 'jump to' a random place in the POD, which was my first
hope for an answer.

The good news is that some POD parsers (at least pod2html) can be tricked
into doing the right thing. pod2html seems to label items 'item_itemname' in
the pages it generates, and in the case of function names, it leaves the
arguments out. So, to generate a link to such a function, just add
LE<lt>args_function()|/item_args_functionE<gt> to make a link like this one:
L<args_function()|/item_args_function>.

Unfortunately, this only seems to work for pod2html. pod2latex produces a
link to the function with all of its arguments, so if you're planning to use
that (or to make a POD doc that can be used with it), you're out of luck as 
far as I can tell.

See the documentation for the remaining() function for Another Way To Do It.

=head1 FUNCTIONS

=over 4

=item noargs_function()

Text describing the noargs_function().

=item args_function($arg1,$arg2)

Text describing the args_function() . (Make sure there are no spaces between
the args there... it does funny things to the formatting, at least with
pod2html.)

=item remaining()

remaining() is the last function mentioned here, mostly to exhibit
pod2html's behavior of linkifying mentions of function names when mentioned
in text. This should also serve your purposes, but be aware that characters  
(like the period in the noargs_function() item) touching the function name
may cause this not to work. pod2latex doesn't appear to support this feature
either.

=back