=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 do
+cs) a
way to add a label to an area like there is in HTML, so it doesn't see
+m like
there's a way to 'jump to' a random place in the POD, which was my fir
+st
hope for an answer.

The good news is that some POD parsers (at least pod2html) can be tric
+ked
into doing the right thing. pod2html seems to label items 'item_itemna
+me' in
the pages it generates, and in the case of function names, it leaves t
+he
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 thi
+s one:
L<args_function()|/item_args_function>.

Unfortunately, this only seems to work for pod2html. pod2latex produce
+s 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 lu
+ck 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 b
+etween
the args there... it does funny things to the formatting, at least wit
+h
pod2html.)

=item remaining()

remaining() is the last function mentioned here, mostly to exhibit
pod2html's behavior of linkifying mentions of function names when ment
+ioned
in text. This should also serve your purposes, but be aware that chara
+cters  
(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 f
+eature
either.

=back
[download]

--

Love justice; desire mercy.

---

---

Posts are HTML formatted. Put <p> </p> tags around your paragraphs. Put <code> </code> tags around your code and data!

Titles consisting of a single word are discouraged, and in most cases are disallowed outright.

Read Where should I post X? if you're not absolutely sure you're posting in the right place.

Please read these before you post! —

• How do I compose an effective node title?
• How do I post a question effectively?
• Markup in the Monastery

Posts may use any of the Perl Monks Approved HTML tags:

a, abbr, b, big, blockquote, br, caption, center, col, colgroup, dd, del, details, div, dl, dt, em, font, h1, h2, h3, h4, h5, h6, hr, i, ins, li, ol, p, pre, readmore, small, span, spoiler, strike, strong, sub, summary, sup, table, tbody, td, tfoot, th, thead, tr, tt, u, ul, wbr

You may need to use entities for some characters, as follows. (Exception: Within code tags, you can put the characters literally.)

	For:		Use:
	&		&
	<		&lt;
	>		&gt;
	[		&#91;
	]		&#93;

Link using PerlMonks shortcuts! What shortcuts can I use for linking?

See Writeup Formatting Tips and other pages linked from there for more info.