I've many times had difficulty in Pod writing method docs when you want to type:
Call the method C<Foo->constructor($parameter)> to get a C<Foo> thing back.
The problem with that is the C<> section that the parser sees is just C<Foo->.
What I used to do is play tricks with E<> to try and get it to all work. But there's an easier way. In pod you can use multiple brackets followed by whitespace as delimiters, so the above becomes:
Call the method C<< Foo->constructor($parameter) >> to get a C<Foo> thing back.
Hopefully this will help someone else out in authoring their Pod API docs.