Example conventions

Hello All, I probably missed it but, what is the general convention on adding examples in the pear manual ? e.g. I wrote 2 examples and named the first example.xml and the second example2.xml is this acceptable ? Regards,

David Costa, PHP-PostgreSQL Advocacy team     http://dotgeek.org
david at postgresql ddoot org                 gurugeek att php dot net

$dsn = 'pgsql://world:most_advanced@localhost/open_source_database';