Fixed syntactic errors in Onis::Plugins::Core, Onis::Data::Persistent::None, Onis...
[onis.git] / lib / Onis / Plugins / Core.pm
index ab7ae60..3f01666 100644 (file)
@@ -3,20 +3,53 @@ package Onis::Plugins::Core;
 use strict;
 use warnings;
 
+use Carp (qw(confess));
+
+=head1 NAME
+
+Onis::Plugins::Core
+
+=head1 DESCRIPTION
+
+Plugin for the main table and the hourly-statistics. This is the most
+complicated plugin so far.
+
+=cut
+
 use Onis::Config qw/get_config/;
 use Onis::Html qw/html_escape get_filehandle/;
 use Onis::Language qw/translate/;
-use Onis::Users qw/get_name get_link get_image nick_to_username/;
-use Onis::Data::Core qw#all_nicks nick_to_ident ident_to_nick get_main_nick register_plugin#;
-use Onis::Data::Persistent qw#init#;
-
-our $DATA;
-our $QUOTE_CACHE = init ('$QUOTE_CACHE', 'hash');
+use Onis::Users (qw(get_realname get_link get_image ident_to_name));
+use Onis::Data::Core qw#get_all_nicks nick_to_ident ident_to_nick get_main_nick register_plugin#;
+use Onis::Data::Persistent;
+
+our $NickLinesCounter = Onis::Data::Persistent->new ('NickLinesCounter', 'nick',
+       qw(
+               lines00 lines01 lines02 lines03 lines04 lines05 lines06 lines07 lines08 lines09 lines10 lines11
+               lines12 lines13 lines14 lines15 lines16 lines17 lines18 lines19 lines20 lines21 lines22 lines23
+       )
+);
+our $NickWordsCounter = Onis::Data::Persistent->new ('NickWordsCounter', 'nick',
+       qw(
+               words00 words01 words02 words03 words04 words05 words06 words07 words08 words09 words10 words11
+               words12 words13 words14 words15 words16 words17 words18 words19 words20 words21 words22 words23
+       )
+);
+our $NickCharsCounter = Onis::Data::Persistent->new ('NickCharsCounter', 'nick',
+       qw(
+               chars00 chars01 chars02 chars03 chars04 chars05 chars06 chars07 chars08 chars09 chars10 chars11
+               chars12 chars13 chars14 chars15 chars16 chars17 chars18 chars19 chars20 chars21 chars22 chars23
+       )
+);
+
+our $QuoteCache = {}; # Saves per-nick information without any modification
+our $QuoteData = {};  # Is generated before output. Nicks are merged according to Data::Core.
+our $NickData = {};  # Same as above, but for nicks rather than quotes.
 
 our @H_IMAGES = qw#dark-theme/h-red.png dark-theme/h-blue.png dark-theme/h-yellow.png dark-theme/h-green.png#;
-our $QUOTE_CACHE_SIZE = 10;
-our $QUOTE_MIN = 30;
-our $QUOTE_MAX = 80;
+our $QuoteCacheSize = 10;
+our $QuoteMin = 30;
+our $QuoteMax = 80;
 our $WORD_LENGTH = 5;
 our $SORT_BY = 'LINES';
 our $DISPLAY_LINES = 'BOTH';
@@ -27,26 +60,26 @@ our $DISPLAY_IMAGES = 0;
 our $DEFAULT_IMAGE = '';
 our $BAR_HEIGHT = 130;
 our $BAR_WIDTH  = 100;
-our $LONGLINES  = 50;
-our $SHORTLINES = 10;
+our $LongLines  = 50;
+our $ShortLines = 10;
 
 if (get_config ('quote_cache_size'))
 {
        my $tmp = get_config ('quote_cache_size');
        $tmp =~ s/\D//g;
-       $QUOTE_CACHE_SIZE = $tmp if ($tmp);
+       $QuoteCacheSize = $tmp if ($tmp);
 }
 if (get_config ('quote_min'))
 {
        my $tmp = get_config ('quote_min');
        $tmp =~ s/\D//g;
-       $QUOTE_MIN = $tmp if ($tmp);
+       $QuoteMin = $tmp if ($tmp);
 }
 if (get_config ('quote_max'))
 {
        my $tmp = get_config ('quote_max');
        $tmp =~ s/\D//g;
-       $QUOTE_MAX = $tmp if ($tmp);
+       $QuoteMax = $tmp if ($tmp);
 }
 if (get_config ('min_word_length'))
 {
@@ -194,7 +227,7 @@ if (get_config ('longlines'))
 {
        my $tmp = get_config ('longlines');
        $tmp =~ s/\D//g;
-       $LONGLINES = $tmp if ($tmp);
+       $LongLines = $tmp if ($tmp);
 }
 if (get_config ('shortlines'))
 {
@@ -202,20 +235,15 @@ if (get_config ('shortlines'))
        $tmp =~ s/\D//g;
        if ($tmp or ($tmp == 0))
        {
-               $SHORTLINES = $tmp;
+               $ShortLines = $tmp;
        }
 }
 
-$DATA = register_plugin ('TEXT', \&add);
-$DATA = register_plugin ('ACTION', \&add);
-$DATA = register_plugin ('OUTPUT', \&output);
+register_plugin ('TEXT', \&add);
+register_plugin ('ACTION', \&add);
+register_plugin ('OUTPUT', \&output);
 
-if (!defined ($DATA->{'byhour'}))
-{
-       $DATA->{'byhour'} = [];
-}
-
-my $VERSION = '$Id: Core.pm,v 1.12 2004/04/30 06:56:13 octo Exp $';
+my $VERSION = '$Id$';
 print STDERR $/, __FILE__, ": $VERSION" if ($::DEBUG);
 
 return (1);
@@ -230,61 +258,144 @@ sub add
        my $host = $data->{'host'};
        my $text = $data->{'text'};
        my $type = $data->{'type'};
+       my $time = $data->{'epoch'};
 
        my $words = scalar (@{$data->{'words'}});
        my $chars = length ($text);
+
        if ($type eq 'ACTION')
        {
                $chars -= (length ($nick) + 3);
        }
 
-       $DATA->{'byident'}{$ident}{'lines'}++;
-       $DATA->{'byident'}{$ident}{'words'} += $words;
-       $DATA->{'byident'}{$ident}{'chars'} += $chars;
-       $DATA->{'byident'}{$ident}{'lines_time'}{$hour}++;
-       $DATA->{'byident'}{$ident}{'words_time'}{$hour} += $words;
-       $DATA->{'byident'}{$ident}{'chars_time'}{$hour} += $chars;
-       
-       $DATA->{'byhour'}[$hour] += $chars;
-       
-       if ((length ($text) >= $QUOTE_MIN)
-                               and (length ($text) <= $QUOTE_MAX))
+       my @counter = $NickLinesCounter->get ($nick);
+       if (!@counter)
        {
-               if (!defined ($QUOTE_CACHE->{$nick}))
+               @counter = qw(0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0);
+       }
+       $counter[$hour]++;
+       $NickLinesCounter->put ($nick, @counter);
+
+       @counter = $NickWordsCounter->get ($nick);
+       if (!@counter)
+       {
+               @counter = qw(0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0);
+       }
+       $counter[$hour] += $words;
+       $NickWordsCounter->put ($nick, @counter);
+
+       @counter = $NickCharsCounter->get ($nick);
+       if (!@counter)
+       {
+               @counter = qw(0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0);
+       }
+       $counter[$hour] += $chars;
+       $NickCharsCounter->put ($nick, @counter);
+
+       if ((length ($text) >= $QuoteMin)
+                               and (length ($text) <= $QuoteMax))
+       {
+               if (!defined ($QuoteCache->{$nick}))
                {
-                       $QUOTE_CACHE->{$nick} = [];
+                       $QuoteCache->{$nick} = [];
                }
-               push (@{$QUOTE_CACHE->{$nick}}, $text);
+               push (@{$QuoteCache->{$nick}}, [$time, $text]);
        }
 
-       if (defined ($QUOTE_CACHE->{$nick}))
+       if (defined ($QuoteCache->{$nick}))
        {
-               while (scalar (@{$QUOTE_CACHE->{$nick}}) > $QUOTE_CACHE_SIZE)
+               while (scalar (@{$QuoteCache->{$nick}}) > $QuoteCacheSize)
                {
-                       shift (@{$QUOTE_CACHE->{$nick}});
+                       shift (@{$QuoteCache->{$nick}});
                }
        }
 
        return (1);
 }
 
+sub calculate
+{
+       for (get_all_nicks ())
+       {
+               my $nick = $_;
+               my $main = get_main_nick ($nick);
+
+               if (!defined ($NickData->{$main}))
+               {
+                       $NickData->{$main} =
+                       {
+                               lines => [qw(0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0)],
+                               words => [qw(0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0)],
+                               chars => [qw(0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0)],
+                               lines_total => 0,
+                               words_total => 0,
+                               chars_total => 0
+                       };
+               }
+
+               my @counter = $NickLinesCounter->get ($nick);
+               if (@counter)
+               {
+                       my $sum = 0;
+                       for (my $i = 0; $i < 24; $i++)
+                       {
+                               $NickData->{$main}{'lines'}[$i] += $counter[$i];
+                               $sum += $counter[$i];
+                       }
+                       $NickData->{$main}{'lines_total'} = $sum;
+               }
+
+               @counter = $NickWordsCounter->get ($nick);
+               if (@counter)
+               {
+                       my $sum = 0;
+                       for (my $i = 0; $i < 24; $i++)
+                       {
+                               $NickData->{$main}{'words'}[$i] += $counter[$i];
+                               $sum += $counter[$i];
+                       }
+                       $NickData->{$main}{'words_total'} = $sum;
+               }
+
+               @counter = $NickWordsCounter->get ($nick);
+               if (@counter)
+               {
+                       my $sum = 0;
+                       for (my $i = 0; $i < 24; $i++)
+                       {
+                               $NickData->{$main}{'words'}[$i] += $counter[$i];
+                               $sum += $counter[$i];
+                       }
+                       $NickData->{$main}{'chars_total'} = $sum;
+               }
+
+               if (!defined ($QuoteData->{$main}))
+               {
+                       $QuoteData->{$main} = [];
+               }
+               if (defined ($QuoteCache->{$nick}))
+               {
+                       my @new = sort (sub { $b->[0] <=> $a->[0] }, @{$QuoteCache->{$nick}}, @{$QuoteData->{$main}});
+                       splice (@new, $QuoteCacheSize) if (scalar (@new) > $QuoteCacheSize);
+                       $QuoteData->{$main} = \@new;
+               }
+       }
+}
+
 sub output
 {
+       calculate ();
        activetimes ();
        ranking ();
 }
        
-# this subroutines doesn't take any arguments either (stupid me). It prints the
-# daily usage to the file.
 sub activetimes
 {
        my $max = 0;            # the most lines that were written in one hour..
        my $total = 0;          # the total amount of lines we wrote..
-       my ($i, $j);            # used in for-loops
        my $factor = 0;         # used to find a bar's height
-       my $newline = '';       # buffer variable..
 
-       my @data = @{$DATA->{'byhour'}};
+       my @data = qw(0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0);
 
        my @img_urls = get_config ('vertical_images');
        if (!@img_urls)
@@ -296,19 +407,20 @@ sub activetimes
        
 # this for loop looks for the most amount of lines in one hour and sets
 # $most_lines
-       for ($i = 0; $i < 24; $i++)
+       for (keys %$NickData)
        {
-               if (!defined ($data[$i]))
+               my $nick = shift;
+
+               for (my $i = 0; $i < 24; $i++)
                {
-                       next;
+                       $data[$i] += $NickData->{$nick}{'chars'}[$i];
                }
+       }
 
+       for (my $i = 0; $i < 24; $i++)
+       {
+               $max = $data[$i] if ($max < $data[$i]);
                $total += $data[$i];
-
-               if ($data[$i] > $max)
-               {
-                       $max = $data[$i];
-               }
        }
 
        if (!$total)
@@ -326,9 +438,9 @@ sub activetimes
 
 # this for circles through the four colors. Each color represents six hours.
 # (4 * 6 hours = 24 hours)
-       for ($i = 0; $i <= 3; $i++)
+       for (my $i = 0; $i <= 3; $i++)
        {
-               for ($j = 0; $j <= 5; $j++)
+               for (my $j = 0; $j <= 5; $j++)
                {
                        my $hour = (($i * 6) + $j);
                        if (!defined ($data[$hour]))
@@ -357,10 +469,9 @@ sub ranking
 {
        my $count = 0;
 
-       my @names = grep
-       {
-               defined ($DATA->{'byname'}{$_}{'words'})
-       } (keys (%{$DATA->{'byname'}}));
+       my @nicks = keys (%$NickData);
+
+       return unless (@nicks);
        
        my $max_lines = 1;
        my $max_words = 1;
@@ -375,15 +486,15 @@ sub ranking
        my $trans;
 
        my $tmp;
-       ($tmp) = sort { $DATA->{'byname'}{$b}{'lines'} <=> $DATA->{'byname'}{$a}{'lines'} } (@names);
-       $max_lines = $DATA->{'byname'}{$tmp}{'lines'} || 0;
+       ($tmp) = sort { $NickData->{$b}{'lines_total'} <=> $NickData->{$a}{'lines_total'} } (@nicks);
+       $max_lines = $NickData->{$tmp}{'lines_total'} || 0;
        
-       ($tmp) = sort { $DATA->{'byname'}{$b}{'words'} <=> $DATA->{'byname'}{$a}{'words'} } (@names);
-       $max_words = $DATA->{'byname'}{$tmp}{'words'} || 0;
+       ($tmp) = sort { $NickData->{$b}{'words_total'} <=> $NickData->{$a}{'words_total'} } (@nicks);
+       $max_words = $NickData->{$tmp}{'words_total'} || 0;
+       
+       ($tmp) = sort { $NickData->{$b}{'chars_total'} <=> $NickData->{$a}{'chars_total'} } (@nicks);
+       $max_chars = $NickData->{$tmp}{'chars_total'} || 0;
        
-       ($tmp) = sort { $DATA->{'byname'}{$b}{'chars'} <=> $DATA->{'byname'}{$a}{'chars'} } (@names);
-       $max_chars = $DATA->{'byname'}{$tmp}{'chars'} || 0;
-
        $trans = translate ('Most active nicks');
        
        print $fh "<h2>$trans</h2>\n";
@@ -444,46 +555,37 @@ EOF
 
        for (sort
        {
-               $DATA->{'byname'}{$b}{$sort_field} <=> $DATA->{'byname'}{$a}{$sort_field}
-       } (@names))
+               $NickData->{$b}{"${sort_field}_total"} <=> $NickData->{$a}{"${sort_field}_total"}
+       } (@nicks))
        {
-               my $name = $_;
-               my $ident = $name;
-               my $nick = $name;
+               my $nick = $_;
+               my $ident = nick_to_ident ($nick);
+               my $name  = ident_to_name ($ident);
 
-               if (ident_to_nick ($name))
-               {
-                       $nick = ident_to_nick ($name);
-               }
-               else
-               {
-                       $ident = nick_to_ident ($name);
-               }
-               
                $linescount++;
 
                # As long as we didn't hit the 
-               # $LONGLINES-limit we continue
+               # $LongLines-limit we continue
                # our table..
-               if ($linescount <= $LONGLINES)
+               if ($linescount <= $LongLines)
                {
                        my $quote = translate ('-- no quote available --');
 
-                       if (defined ($QUOTE_CACHE->{$nick}))
+                       if (defined ($QuoteData->{$nick}))
                        {
-                               my $num = scalar (@{$QUOTE_CACHE->{$nick}});
+                               my $num = scalar (@{$QuoteData->{$nick}});
                                my $rand = int (rand ($num));
-                               $quote = html_escape ($QUOTE_CACHE->{$nick}[$rand]);
+                               $quote = html_escape ($QuoteData->{$nick}[$rand]);
                        }
 
                        my $link = '';
                        my $image = '';
-                       my $title = '';
-                       if ($name eq $ident)
+                       my $realname = '';
+                       if ($name)
                        {
-                               $link = get_link ($name);
-                               $image = get_image ($name);
-                               $title = get_name ($name);
+                               $link     = get_link ($name);
+                               $image    = get_image ($name);
+                               $realname = get_realname ($name);
                        }
                        
                        print $fh "  <tr>\n",
@@ -516,9 +618,11 @@ EOF
                                print $fh "</td>\n";
                        }
                        
+                       my $title = $realname;
                        if (!$title)
                        {
-                               $title = "Ident: $ident";
+                               $title = "User: $name; " if ($name);
+                               $title .= "Ident: $ident";
                        }
                        print $fh qq#    <td class="nick" title="$title">#;
 
@@ -536,13 +640,13 @@ EOF
                                print $fh qq#    <td class="bar">#;
                                if (($DISPLAY_LINES eq 'BOTH') or ($DISPLAY_LINES eq 'BAR'))
                                {
-                                       my $code = bar ($max_lines, $DATA->{'byname'}{$name}{'lines_time'});
+                                       my $code = bar ($max_lines, $NickData->{$nick}{'lines'});
                                        print $fh $code;
                                }
                                print $fh '&nbsp;' if ($DISPLAY_LINES eq 'BOTH');
                                if (($DISPLAY_LINES eq 'BOTH') or ($DISPLAY_LINES eq 'NUMBER'))
                                {
-                                       print $fh $DATA->{'byname'}{$name}{'lines'};
+                                       print $fh $NickData->{$nick}{'lines_total'};
                                }
                                print $fh "</td>\n";
                        }
@@ -552,13 +656,13 @@ EOF
                                print $fh qq#    <td class="bar">#;
                                if (($DISPLAY_WORDS eq 'BOTH') or ($DISPLAY_WORDS eq 'BAR'))
                                {
-                                       my $code = bar ($max_words, $DATA->{'byname'}{$name}{'words_time'});
+                                       my $code = bar ($max_words, $NickData->{$nick}{'words'});
                                        print $fh $code;
                                }
                                print $fh '&nbsp;' if ($DISPLAY_WORDS eq 'BOTH');
                                if (($DISPLAY_WORDS eq 'BOTH') or ($DISPLAY_WORDS eq 'NUMBER'))
                                {
-                                       print $fh $DATA->{'byname'}{$name}{'words'};
+                                       print $fh $NickData->{$nick}{'words_total'};
                                }
                                print $fh "</td>\n";
                        }
@@ -568,29 +672,27 @@ EOF
                                print $fh qq#    <td class="bar">#;
                                if (($DISPLAY_CHARS eq 'BOTH') or ($DISPLAY_CHARS eq 'BAR'))
                                {
-                                       my $code = bar ($max_chars, $DATA->{'byname'}{$name}{'chars_time'});
+                                       my $code = bar ($max_chars, $NickData->{$nick}{'chars'});
                                        print $fh $code;
                                }
                                print $fh '&nbsp;' if ($DISPLAY_CHARS eq 'BOTH');
                                if (($DISPLAY_CHARS eq 'BOTH') or ($DISPLAY_CHARS eq 'NUMBER'))
                                {
-                                       print $fh $DATA->{'byname'}{$name}{'chars'};
+                                       print $fh $NickData->{$nick}{'chars_total'};
                                }
                                print $fh "</td>\n";
                        }
 
                        if ($DISPLAY_TIMES)
                        {
-                               my $chars = $DATA->{'byname'}{$name}{'chars'};
-                               my $code = bar ($chars, $DATA->{'byname'}{$name}{'chars_time'});
-                               
+                               my $code = bar ($NickData->{$nick}{'chars_total'}, $NickData->{$nick}{'chars'});
                                print $fh qq#    <td class="bar">$code</td>\n#;
                        }
 
                        print $fh qq#    <td class="quote">$quote</td>\n#,
                        qq#  </tr>\n#;
                        
-                       if ($linescount == $LONGLINES)
+                       if ($linescount == $LongLines)
                        {
                                print $fh "</table>\n\n";
                        }
@@ -600,23 +702,30 @@ EOF
                # list them all so we start a
                # smaller table and just list the
                # names.. (Six names per line..)
-               elsif ($linescount <= ($LONGLINES + 6 * $SHORTLINES))
+               elsif ($linescount <= ($LongLines + 6 * $ShortLines))
                {
-                       my $row_in_this_table = int (($linescount - $LONGLINES - 1) / 6);
-                       my $col_in_this_table = ($linescount - $LONGLINES - 1) % 6;
+                       my $row_in_this_table = int (($linescount - $LongLines - 1) / 6);
+                       my $col_in_this_table = ($linescount - $LongLines - 1) % 6;
 
                        my $total = 0;
                        if ($SORT_BY eq 'LINES')
                        {
-                               $total = $DATA->{'byname'}{$name}{'lines'};
+                               $total = $NickData->{$nick}{'lines_total'};
                        }
                        elsif ($SORT_BY eq 'WORDS')
                        {
-                               $total = $DATA->{'byname'}{$name}{'words'};
+                               $total = $NickData->{$nick}{'words_total'};
                        }
                        else # ($SORT_BY eq 'CHARS')
                        {
-                               $total = $DATA->{'byname'}{$name}{'chars'};
+                               $total = $NickData->{$nick}{'chars_total'};
+                       }
+
+                       my $title = $name ? get_realname ($name) : '';
+                       if (!$title)
+                       {
+                               $title = "User: $name; " if ($name);
+                               $title .= "Ident: $ident";
                        }
                        
                        if ($row_in_this_table == 0 and $col_in_this_table == 0)
@@ -633,9 +742,9 @@ EOF
                                qq#  <tr>\n#;
                        }
                        
-                       print $fh "    <td>$name ($total)</td>\n";
+                       print $fh qq#    <td title="$title">$name ($total)</td>\n#;
                        
-                       if ($row_in_this_table == $SHORTLINES and $col_in_this_table == 5)
+                       if ($row_in_this_table == $ShortLines and $col_in_this_table == 5)
                        {
                                print $fh "  </tr>\n",
                                qq#</table>\n\n#;
@@ -648,10 +757,10 @@ EOF
                # unmentioned nicks"-line..
        }
 
-       if (($linescount > $LONGLINES)
-                       and ($linescount <= ($LONGLINES + 6 * $SHORTLINES)))
+       if (($linescount > $LongLines)
+                       and ($linescount <= ($LongLines + 6 * $ShortLines)))
        {
-               my $col = ($linescount - $LONGLINES - 1) % 6;
+               my $col = ($linescount - $LongLines - 1) % 6;
 
                while ($col < 5)
                {
@@ -662,7 +771,7 @@ EOF
                print $fh "  </tr>\n";
        }
 
-       if ($linescount != $LONGLINES)
+       if ($linescount != $LongLines)
        {
                print $fh "</table>\n\n";
        }
@@ -676,6 +785,8 @@ sub bar
 
        my $source = shift;
 
+       confess unless (ref ($source eq 'ARRAY'));
+
        # BAR_WIDTH is a least 10
        my $max_width = $BAR_WIDTH - 4;
        my $factor = 1;
@@ -696,11 +807,7 @@ sub bar
                for ($j = 0; $j < 6; $j++)
                {
                        my $hour = ($i * 6) + $j;
-
-                       if (defined ($source->{$hour}))
-                       {
-                               $sum += $source->{$hour};
-                       }
+                       $sum += $source->[$hour];
                }
 
                $width += int (0.5 + ($sum * $factor));
@@ -714,47 +821,8 @@ sub bar
        return ($retval);
 }
 
-sub merge_hashes
-{
-       my $target = shift;
-       my $source = shift;
-
-       my @keys = keys (%$source);
+=head1 AUTHOR
 
-       for (@keys)
-       {
-               my $key = $_;
-               my $val = $source->{$key};
+Florian octo Forster, E<lt>octo at verplant.orgE<gt>
 
-               if (!defined ($target->{$key}))
-               {
-                       $target->{$key} = $val;
-               }
-               elsif (!ref ($val))
-               {
-                       if ($val =~ m/\D/)
-                       {
-                               # FIXME
-                               print STDERR $/, __FILE__, ": ``$key'' = ``$val''" if ($::DEBUG);
-                       }
-                       else
-                       {
-                               $target->{$key} += $val;
-                       }
-               }
-               elsif (ref ($val) eq "HASH")
-               {
-                       merge_hashes ($target->{$key}, $val);
-               }
-               elsif (ref ($val) eq "ARRAY")
-               {
-                       print STDERR $/, __FILE__, ": There is an array ``$key''";
-                       push (@{$target->{$key}}, @$val);
-               }
-               else
-               {
-                       my $type = ref ($val);
-                       print STDERR $/, __FILE__, ": Reference type ``$type'' is not supported!", $/;
-               }
-       }
-}
+=cut