perlapi: Move macro defns to where defined

[khwilliamson]

This moves the API definitions of is_ascii_string, is_invariant_string, and is_utf8_invariant_string to the spots in the source code where each is #defined, thus making it easier to maintain

[khwilliamson]

This also silences the noise in blead from autodoc.pl