[svn:dbi] r15576 - dbi/trunk

[ti...@cvs.perl.org]

Author: timbo
Date: Thu Feb 28 02:24:18 2013
New Revision: 15576

Modified:
dbi/trunk/DBI.pm

Log:
polish up the GETTING HELP section of the docs

Modified: dbi/trunk/DBI.pm
==============================================================================
--- dbi/trunk/DBI.pm (original)
+++ dbi/trunk/DBI.pm Thu Feb 28 02:24:18 2013
@@ -84,45 +84,57 @@

=head2 GETTING HELP

-If you have questions about DBI, or DBD driver modules, you can get
-help from the I<dbi-...@perl.org> mailing list. You don't have to subscribe
-to the list in order to post, though I'd recommend it. You can get help on
-subscribing and using the list by emailing I<dbi-use...@perl.org>.
-
-I don't recommend the DBI cpanforum (at http://www.cpanforum.com/dist/DBI)
-because relatively few people read it compared with dbi-...@perl.org.
-
-To help you make the best use of the dbi-users mailing list,
-and any other lists or forums you may use, I recommend that you read
-"Getting Answers" by Mike Ash: L<http://mikeash.com/getting_answers.html>.
-
-If you think you've found a bug then please also read
-"How to Report Bugs Effectively" by Simon Tatham:
-L<http://www.chiark.greenend.org.uk/~sgtatham/bugs.html>.
-
-The DBI home page at L<http://dbi.perl.org/> and the DBI FAQ
-at L<http://faq.dbi-support.com/> may be worth a visit.
-They include links to other resources, but are rather out-dated.
+=head3 General

Before asking any questions, reread this document, consult the
archives and read the DBI FAQ. The archives are listed
-at the end of this document and on the DBI home page.
+at the end of this document and on the DBI home page L<http://dbi.perl.org/support/>

You might also like to read the Advanced DBI Tutorial at
L<http://www.slideshare.net/Tim.Bunce/dbi-advanced-tutorial-2007>

-This document often uses terms like I<references>, I<objects>,
-I<methods>. If you're not familiar with those terms then it would
-be a good idea to read at least the following perl manuals first:
-L<perlreftut>, L<perldsc>, L<perllol>, and L<perlboot>.
+To help you make the best use of the dbi-users mailing list,
+and any other lists or forums you may use, I recommend that you read
+"Getting Answers" by Mike Ash: L<http://mikeash.com/getting_answers.html>.
+
+=head3 Mailing Lists
+
+If you have questions about DBI, or DBD driver modules, you can get
+help from the I<dbi-...@perl.org> mailing list. This is the best way to get
+help. You don't have to subscribe to the list in order to post, though I'd
+recommend it. You can get help on subscribing and using the list by emailing
+I<dbi-use...@perl.org>.

Please note that Tim Bunce does not maintain the mailing lists or the
-web page (generous volunteers do that). So please don't send mail
+web pages (generous volunteers do that). So please don't send mail
directly to him; he just doesn't have the time to answer questions
personally. The I<dbi-users> mailing list has lots of experienced
people who should be able to help you if you need it. If you do email
Tim he is very likely to just forward it to the mailing list.

+=head3 Online
+
+StackOverflow has a DBI tag L<http://stackoverflow.com/questions/tagged/dbi>
+with over 400 questions.
+
+The DBI home page at L<http://dbi.perl.org/> and the DBI FAQ
+at L<http://faq.dbi-support.com/> may be worth a visit.
+They include links to other resources, but I<are rather out-dated>.
+
+I don't recommend the DBI cpanforum (at http://www.cpanforum.com/dist/DBI)
+because relatively few people read it compared with dbi-...@perl.org.
+
+=head3 Reporting a Bug
+
+If you think you've found a bug then please read
+"How to Report Bugs Effectively" by Simon Tatham:
+L<http://www.chiark.greenend.org.uk/~sgtatham/bugs.html>.
+
+Your problem is most likely related to the specific DBD driver module you're
+using. If that's the case then click on the 'Bugs' link on the L<http://metacpan.org>
+page for your driver. Only submit a bug report against the DBI itself if you're
+sure that your issue isn't related to the driver you're using.
+
=head2 NOTES

This is the DBI specification that corresponds to DBI version 1.623
@@ -2137,6 +2149,11 @@
provides a standard interface and framework for the drivers to operate
within.

+This document often uses terms like I<references>, I<objects>,
+I<methods>. If you're not familiar with those terms then it would
+be a good idea to read at least the following perl manuals first:
+L<perlreftut>, L<perldsc>, L<perllol>, and L<perlboot>.
+

=head2 Architecture of a DBI Application