I've never used PDF::API2::Outline, but it does have some example code in its tests. For example, http://cpansearch.perl.org/src/SSIMMS/PDF-API2-2.031/t/outline.t

You can always wade through the source code to see what it's doing.

Also: supersearch