[svn:dbi] r14204 - dbi/trunk/lib/DBD/File

Author: REHSACK
Date: Wed Jun 30 03:38:53 2010
New Revision: 14204

Modified:
   dbi/trunk/lib/DBD/File/Developers.pod

Log:
add register_reset_on_modify documentation


Modified: dbi/trunk/lib/DBD/File/Developers.pod
==============================================================================
--- dbi/trunk/lib/DBD/File/Developers.pod	(original)
+++ dbi/trunk/lib/DBD/File/Developers.pod	Wed Jun 30 03:38:53 2010
@@ -475,6 +475,23 @@
 be overwritten when mapped attribute names shall be modified for
 compatibility reasons.
 
+If the modified attribute requires to reset a calculated attribute, the
+calculated attribute is reset (deleted from meta data structure) and
+the I<initialized> flag is removed, too.
+
+=item register_reset_on_modify
+
+Allows C<set_table_meta_attr> to reset meta attributes when special
+attributes are modified. For DBD::File modifying one of C<f_file>, C<f_dir>,
+C<f_ext> or C<f_lockfile> will reset C<f_fqfn>. DBD::DBM extends the
+list for C<dbm_type> and C<dbm_mldbm> to reset the value of C<dbm_tietype>.
+
+If you're DBD has calculated values in the meta data area, too - call
+C<register_reset_on_modify>:
+
+    my %reset_on_modify = ( "xxx_foo" => "xxx_bar" );
+    __PACKAGE__->register_reset_on_modify( \%reset_on_modify );
+
 =item open_file
 
 Is called to open the table's data file.