package SQL::Translator::Producer;
-#-----------------------------------------------------
-# $Id: Producer.pm,v 1.2 2002-03-21 18:50:53 dlc Exp $
-#-----------------------------------------------------
-# Copyright (C) 2002 Ken Y. Clark <kycl4rk@users.sourceforge.net>,
-# darren chamberlain <darren@cpan.org>
+# -------------------------------------------------------------------
+# $Id: Producer.pm,v 1.7 2004-02-09 23:04:26 kycl4rk Exp $
+# -------------------------------------------------------------------
+# Copyright (C) 2002-4 SQLFairy Authors
#
# This program is free software; you can redistribute it and/or
# modify it under the terms of the GNU General Public License as
use strict;
use vars qw($VERSION);
-$VERSION = sprintf "%d.%02d", q$Revision: 1.2 $ =~ /(\d+)\.(\d+)/;
+$VERSION = sprintf "%d.%02d", q$Revision: 1.7 $ =~ /(\d+)\.(\d+)/;
sub produce { "" }
1;
-#-----------------------------------------------------
+# -------------------------------------------------------------------
# A burnt child loves the fire.
# Oscar Wilde
-#-----------------------------------------------------
-
-=head1 NAME
+# -------------------------------------------------------------------
-SQL::Translator::Producer - base object for Producers
+=pod
-=head1 SYNOPSIS
+=head1 NAME
+SQL::Translator::Producer - describes how to write a producer
=head1 DESCRIPTION
Producer modules designed to be used with SQL::Translator need to
implement a single function, called B<produce>. B<produce> will be
-called with a data structure created by a SQL::Translator::Parser
-subclass. It is expected to return a string containing a valid SQL
-create statement.
+called with the SQL::Translator object from which it is expected to
+retrieve the SQL::Translator::Schema object which has been populated
+by the parser. It is expected to return a string.
-=head1 AUTHOR
+=head1 AUTHORS
-Ken Y. Clark, kclark@logsoft.com
+Darren Chamberlain E<lt>darren@cpan.orgE<gt>,
+Ken Y. Clark E<lt>kclark@cpan.orgE<gt>.
=head1 SEE ALSO
-perl(1).
+perl(1), SQL::Translator, SQL::Translator::Schema.
=cut