add tests for vsearch prior to surgery upon it
fix sf.net bug #361 (fix searching of reverse sorted input piddles)

The cleanup code (after the search) didn't properly correct things
for reverse sorted lists.

The variable names were renamed to be clearer and more consistent with
the binary search routines available on the 'net, rather than
Numerical Recipes, as those are more readily available for code
validation.  Additional binary search routines will use that
terminology.
fix example RedoDimsCode so it compiles

* signature had incomplete specification for y output piddle
* double rather than single quotes were used, causing bogus string interpolation
* end semicolon and parens were flipped
Merge commit '65df59f2e55173e967818b3b8f6eae2577aca20f'
Fix pdl('nan') giving 0 problem

This uses get_datatype() to determine the correct datatype value
to use for the NaN piddle value.  NOTE: we need to review all the
pdl source tree for hardwired usages of datatype and fix.
Fix some POD errors

Helpfully, one can grep -R 'POD ERROR' in the HtmlDocs directory
and find these errors.  Most just needed an encoding specified
for documents with non-ASCII characters.