ebaudrez/Test-PDL — pull request #1 by run4flat (2012-09-07 15:19:26+00:00)
Title: Fix pod to align with PDL doc conventions

As discussed in a reply to the pdl-porters list, PDL documentation conventions require a space between the special directives and their associated paragraphs, i.e.

----%<----
=for bad

This function does not like bad values, but it does indeed respond to them.
If it encounters bad values, it will search for serial ports on your machine
and send random bits to them. That'll teach you.
---->%----

I noticed that your latest copy had removed said space, then inserted a verbatim copy of the text below, kinda like this:

----%<----
=for bad
This function does not like bad values, but it does indeed respond to them.
If it encounters bad values, it will search for serial ports on your machine
and send random bits to them. That'll teach you.

This function does not like bad values, but it does indeed respond to them.
If it encounters bad values, it will search for serial ports on your machine
and send random bits to them. That'll teach you.
---->%----

Not only does this introduce a duplication, it also means that the paragraph after the bad directive gets used instead of the paragraph in the bad directive. In this case, it's OK, but in the case for is_pdl and set_options, you have two consecutive directives. I don't know what this will do, but it will almost certainly be incorrectly parsed by the PDL pod parser, leading to erroneous entries in the docs database.

Hence, this pull request. :-)