Clearer documentation for DatabaseDumper

modules/Bio/EnsEMBL/Hive/RunnableDB/DatabaseDumper.pm

@@ -30,20 +30,27 @@ The following parameters are accepted:
 
  - output_file [string] : the file to write the dump to
 
-The following table describes how the various options combine:
-(T means table_list, EL exclude_list, EH exclude_ehive)
-(l+ is the list of included tables, l- of excluded tables)
-
-T EL EH      l+  l-
-
-+  1  0      0   T  = all except T
-+  0  0      TH  0  = T and H
-0  0  0      0   0  = all
-0  1  0      H   0  = H
-+  1  1      0   TH = all except T and H
-+  0  1      T   H  = T (minus H)
-0  0  1      0   H  = all except H
-0  1  1      0   0  = nothing
+
+If "table_list" is undefined or maps to an empty list, the list
+of tables to be dumped is decided accordingly to "exclude_list" (EL)
+and "exclude_ehive" (EH). "exclude_list" controls the whole list of
+non-eHive tables.
+
+EL EH    List of tables to dump
+
+0  0  => all the tables
+0  1  => all the tables, except the eHive ones
+1  0  => all the tables, except the non-eHive ones = only the eHive tables
+1  1  => both eHive and non-eHive tables are excluded = nothing is dumped
+
+If "table_list" is defined to non-empty list T, the table of decision is:
+
+EL EH    List of tables to dump
+
+0  0  => all the tables in T + the eHive tables
+0  1  => all the tables in T
+1  0  => all the tables, except the ones in T
+1  1  => all the tables, except the ones in T and the eHive ones
 
 =head1 LICENSE