in reply to Text::PDF documentation???
You're right, the documentation for Text::PDF is a bit terse. Word has it that it doesn't do as well writing PDF's as it does reading them. If you wanted to try, there were two modules build on top of Text::PDF -- Text::PDF::API and PDF::API2. Unfortunatly, the docs for both of them aren't much better, but one of those might "click" better for you.
However, after searching through some previous posts on the subject, here is a post by perlmonkey explaining that he had a lot of luck with PDF::Create. While it's version is 0.01, it seemed to work quite well for him. Also, the docs for that module on CPAN seem to be a bit better, they give some decent examples of how you'd write a pdf out.. and if those aren't enough, the post by perlmonkey I linked to above also contains an example of how you'd write a PDF document with PDF::Create.
Hope that helps!