improve outline by introducing synopsis subheadings

diff --git a/lib/DBIx/Class.pm b/lib/DBIx/Class.pm
index 760a2af..6edb0f5 100644 (file)
--- a/lib/DBIx/Class.pm
+++ b/lib/DBIx/Class.pm
@@ -137,6 +137,8 @@ list below is sorted by "fastest response time":
 
 =head1 SYNOPSIS
 
+=head2 Schema classes preparation
+
 Create a schema class called F<MyApp/Schema.pm>:
 
   package MyApp::Schema;
@@ -175,6 +177,8 @@ F<MyApp/Schema/Result/CD.pm>:
 
   1;
 
+=head2 API usage
+
 Then you can use these classes in your application's code:
 
   # Connect to your database.