papidave has asked for the wisdom of the Perl Monks concerning the following question:
Through perldoc, I get:#!/usr/bin/perl -w use strict; =head1 Foo Method Typical call syntax would be: =over 8 my $ret = $obj->foo( 'LITERAL STRING' ); =back =cut
I can workaround this by using double-quotes (for this example), or by inserting a literal ascii escape for the single quote (i think), but this stil bothers me, because the perldoc.perl.org/perlpod.html says "I wanted the translator to always leave the ' and ` and " quotes alone, in verbatim mode, so I could slurp in a working program, shift it over four spaces, and have it print out, er, verbatim. "foo(3) User Contributed Perl Documentation + foo(3) Foo Method Typical call syntax would be: my $ret = $obj->foo( ???LITERAL STRING??? ); perl v5.8.5 2007-08-07 + foo(3)
What am I missing, here?