This is trivial, but very annoying for beginners.
In the synopsis, the example goes:
...
# Add some text to the page
$text = $pdf->text();
...
But should be
...
# Add some text to the page
$text = $page->text();
...
So the synopsis code doesn't actually work.
While this may be unimportant for most, this is not the case for
beginners. It's just a bad first impression, so beginners might be
fooled into thinking PDF::API2 is bad quality.