[Padre-dev] Fixing the Padre::DB documentation problem

[Adam Kennedy]

I'm gradually coming to the realisation that having a great
lightweight internal ORM around a SQLite database is of only limited
use to us at present.

While it may be technically neat to build up the ORM one line of code,
this means we end up with an entire API (and a fairly critical one)
without any documentation whatsoever.

To resolve this, I've started work on a documentation auto-generator
add-on for ORLite, and I've committed the documentation produced by
the first version of it that doesn't crash.

You can find the documentation in a tree (currently only
lib/Padre/Pod.pod) of POD files that will be generated parallel to any
.pm modules for the database layer.

I'll be expanding the breadth and quality of this generated
documentation over the next few days. Any comments or suggestions
would be welcome.

Adam K