my $val = $obj->get_column($col);
-Fetches a column value
+Gets a column value from a row object. Currently, does not do
+any queries; the column must have already been fetched from
+the database and stored in the object.
=cut
my %data = $obj->get_columns;
-Fetch all column values at once.
+Does C<get_column>, for all column values at once.
=cut
$obj->set_column($col => $val);
-Sets a column value; if the new value is different to the old the column
-is marked as dirty for when you next call $obj->update
+Sets a column value. If the new value is different from the old one,
+the column is marked as dirty for when you next call $obj->update.
=cut
my $copy = $orig->set_columns({ $col => $val, ... });
-Set more than one column value at once.
+Sets more than one column value at once.
=cut
my $copy = $orig->copy({ change => $to, ... });
-Insert a new row with the specified changes.
+Inserts a new row with the specified changes.
=cut
$obj->store_column($col => $val);
-Sets a column value without marking it as dirty
+Sets a column value without marking it as dirty.
=cut
$obj->insert_or_update
-Updates the object if it's already in the db, else inserts it
+Updates the object if it's already in the db, else inserts it.
=cut