6 use DBIx::Class::_Util; # load early in case any shims are needed
9 my $pod_dir = 'maint/.Generated_Pod';
11 my $result_metapod_fn = "$lib_dir/DBIx/Class/Manual/ResultClass.pod";
13 die "POD generator must be executed from the dist root\n"
14 unless -d $lib_dir and -d $pod_dir;
18 "$result_metapod_fn.proto",
20 ) or die "Copying ResultClass proto pod ($result_metapod_fn) failed: $!";
25 unlink $result_metapod_fn;
31 input_files => $lib_dir,
32 out_dir => "$pod_dir/lib",
33 force_permissions => 1,
35 "DBIx::Class::Relationship::HasMany" => "DBIx::Class::Relationship",
36 "DBIx::Class::Relationship::HasOne" => "DBIx::Class::Relationship",
37 "DBIx::Class::Relationship::BelongsTo" => "DBIx::Class::Relationship",
38 "DBIx::Class::Relationship::ManyToMany" => "DBIx::Class::Relationship",
39 "DBIx::Class::ResultSourceProxy" => "DBIx::Class::ResultSource",
41 # skip the deprecated classes that give out *DEPRECATED* warnings
43 lib/DBIx/Class/Storage/DBI/Sybase/MSSQL.pm
44 lib/DBIx/Class/Serialize/Storable.pm
45 lib/DBIx/Class/ResultSetManager.pm
46 lib/DBIx/Class/InflateColumn/File.pm
48 lib/DBIx/Class/CDBICompat/
49 lib/DBIx/Class/CDBICompat.pm
51 # skip the ::Storage:: family for now
53 lib/DBIx/Class/Storage/
54 lib/DBIx/Class/Storage.pm
56 'lib/DBIx/Class/Storage/DBI/Replicated/Pool.pm', # this one just errors out with: The 'add_attribute' method cannot be called on an immutable instance
57 'lib/DBIx/Class/Relationship.pm', # it already documents its own inheritors
58 'lib/DBIx/Class/Core.pm', # we actually don't want this populated in favor of redirecting users to the ResultClass docs
59 'lib/DBIx/Class/Optional/Dependencies.pm' # the POD is already auto-generated
61 # these appear everywhere, and are typically lower-level methods not used by the general user
62 skip_inherits => [ qw/
64 DBIx::Class::Componentised
65 Class::C3::Componentised
66 DBIx::Class::AccessorGroup
67 Class::Accessor::Grouped
72 'DBIx::Class::Manual::ResultClass' => 'DBIx::Class::Core', # this forces the contents of ::Core to be dumped into the POD doc for ::ResultClass
75 method_format => 'L<%m|%c/%m>',
79 # important - write_pod returns undef >.<