Craig Ringer wrote:

> > +=pod
> > +
> > +=head2 Set up a node
> > pod format... Do we really want that? Considering that those modules
> > are only aimed at being dedicated for in-core testing, I would say no.
> If it's plain comments you have to scan through massive piles of verbose
> Perl to find what you want. If it's pod you can just perldoc
> /path/to/module it and get a nice summary of the functions etc.
> If these are intended to become usable facilities for people to write tests
> with then I think it's important that the docs be reasonably accessible.

Yes, I think adding POD here is a good idea.  I considered doing it
myself back when I was messing with PostgresNode ...

Álvaro Herrera      
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services

Sent via pgsql-hackers mailing list (
To make changes to your subscription:

Reply via email to