[svn:dbi] r14026 - dbi/trunk/lib/DBD

Author: REHSACK
Date: Mon May 24 08:00:26 2010
New Revision: 14026

Modified:
   dbi/trunk/lib/DBD/File.pm

Log:
document some private attributes

Modified: dbi/trunk/lib/DBD/File.pm
==============================================================================
--- dbi/trunk/lib/DBD/File.pm	(original)
+++ dbi/trunk/lib/DBD/File.pm	Mon May 24 08:00:26 2010
@@ -1010,7 +1010,7 @@
     LongTruncOk
 
 Additional to the DBI attributes, you can use the following dbh
-attribute:
+attributes to control the behaviour of DBD::File in the file system:
 
 =over 4
 
@@ -1114,8 +1114,39 @@
 With this attribute, you can set the encoding in which the file is opened.
 This is implemented using C<binmode $fh, ":encoding(<f_encoding>)">.
 
+=item f_meta
+
+Private data area which contains information about the tables this
+module handles.
+
+=back
+
+Internally private attributes to deal with SQL backends:
+
+=over 4
+
+=item sql_nano_version
+
+Conatins the version of loaded DBI::SQL::Nano
+
+=item sql_statement_version
+
+Contains the version of loaded SQL::Statement
+
+=item sql_handler
+
+Contains either 'SQL::Statement' or 'DBI::SQL::Nano'.
+
+=item sql_ram_tables
+
+Contains optionally temporary tables.
+
 =back
 
+Do not modify one of above private attributes, except you know exactly the
+implications. The behaviour of DBD::File and derived DBD's might be
+unpredictable when one or more of those attributes are modified.
+
 =head2 Driver private methods
 
 =over 4