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 http://www.2ndQuadrant.com/ PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services -- Sent via pgsql-hackers mailing list (firstname.lastname@example.org) To make changes to your subscription: http://www.postgresql.org/mailpref/pgsql-hackers