From: Jess Robinson <castaway@desert-island.me.uk>
Date: Sat, 18 Feb 2006 00:07:53 +0000 (+0000)
Subject: Create glossary
X-Git-Tag: v0.06000~98
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=24105556eee32e782f369b46846e547a87f3b934;p=dbsrgits%2FDBIx-Class.git

Create glossary
---

diff --git a/lib/DBIx/Class/Manual/Glossary.pod b/lib/DBIx/Class/Manual/Glossary.pod
new file mode 100644
index 0000000..4e97234
--- /dev/null
+++ b/lib/DBIx/Class/Manual/Glossary.pod
@@ -0,0 +1,45 @@
+=head1 NAME
+
+DBIx::Class::Manual::Glossary - Deconfusion of terms used
+
+=head1 INTRODUCTION
+
+This document lists various terms used in DBIx::Class and attempts to explain them.
+
+=head1 TERMS
+
+=head2 ORM
+
+=head2 ResultSet
+
+This is an object representing a set of data. It can either be an
+entire table, or the results of a query. The actual data is not held
+in the ResultSet, it is only a description of how to fetch the data.
+
+See also: L<DBIx::Class::ResultSet/METHODS>
+
+=head2 ResultSource
+
+ResultSource objects represent the source of your data, they are also known as
+a table objects. 
+
+See also: L<DBIx::Class::ResultSource/METHODS>
+
+=head2 Record
+
+See Row.
+
+=head2 Row
+
+Row objects contain your actual data. They are returned from ResultSet objects.
+
+=head2 Object
+
+See Row.
+
+=head2 Schema
+
+A Schema object represents your entire table collection, plus the
+connection to the database. You can create one or more schema objects,
+connected to various databases, with various users, using the same set
+of table (ResultSource) definitions.