18 |
|
|
19 |
my $config; |
my $config; |
20 |
|
|
21 |
use index_DBI; # there is no other, right now ;-) |
#use index_DBI; # default DBI module for index |
22 |
|
use index_DBI_cache; # faster DBI module using memory cache |
23 |
my $index; |
my $index; |
24 |
|
|
25 |
my %opts; |
my %opts; |
34 |
|
|
35 |
my $path; # this is name of database |
my $path; # this is name of database |
36 |
|
|
37 |
Text::Iconv->raise_error(1); # Conversion errors raise exceptions |
Text::Iconv->raise_error(0); # Conversion errors don't raise exceptions |
38 |
|
|
39 |
# this is encoding of all files on disk, including import_xml/*.xml file and |
# this is encoding of all files on disk, including import_xml/*.xml file and |
40 |
# filter/*.pm files! It will be used to store strings in perl internally! |
# filter/*.pm files! It will be used to store strings in perl internally! |
56 |
# format in XML file |
# format in XML file |
57 |
my %type2tag = ( |
my %type2tag = ( |
58 |
'isis' => 'isis', |
'isis' => 'isis', |
59 |
'excel' => 'column' |
'excel' => 'column', |
60 |
|
'marc' => 'marc', |
61 |
|
'feed' => 'feed' |
62 |
); |
); |
63 |
|
|
64 |
sub data2xml { |
sub data2xml { |
68 |
my $type = shift @_; |
my $type = shift @_; |
69 |
my $row = shift @_; |
my $row = shift @_; |
70 |
my $add_xml = shift @_; |
my $add_xml = shift @_; |
71 |
|
# needed to read values from configuration file |
72 |
|
my $cfg = shift @_; |
73 |
|
my $database = shift @_; |
74 |
|
|
75 |
my $xml; |
my $xml; |
76 |
|
|
82 |
|
|
83 |
# sort subrouting using order="" attribute |
# sort subrouting using order="" attribute |
84 |
sub by_order { |
sub by_order { |
85 |
return 0 if (! $config->{indexer}->{$a}->{order}); |
my $va = $config->{indexer}->{$a}->{order} || |
86 |
return 0 if (! $config->{indexer}->{$b}->{order}); |
$config->{indexer}->{$a}; |
87 |
|
my $vb = $config->{indexer}->{$b}->{order} || |
88 |
|
$config->{indexer}->{$b}; |
89 |
|
|
90 |
return $config->{indexer}->{$a}->{order} <=> |
return $va <=> $vb; |
|
$config->{indexer}->{$b}->{order} ; |
|
91 |
} |
} |
92 |
|
|
93 |
foreach my $field (sort by_order keys %{$config->{indexer}}) { |
foreach my $field (sort by_order keys %{$config->{indexer}}) { |
94 |
|
|
95 |
$field=x($field); |
$field=x($field); |
|
|
|
96 |
$field_usage{$field}++; |
$field_usage{$field}++; |
97 |
|
|
98 |
my $swish_data = ""; |
my $swish_data = ""; |
99 |
|
my $swish_exact_data = ""; |
100 |
my $display_data = ""; |
my $display_data = ""; |
101 |
my $line_delimiter; |
my $line_delimiter; |
102 |
|
|
110 |
|
|
111 |
my $repeat_off = 0; # repeatable offset |
my $repeat_off = 0; # repeatable offset |
112 |
|
|
113 |
my ($s,$d,$i) = (1,1,0); # swish, display default |
my ($s,$se,$d,$i) = (1,0,1,0); # swish, display default |
114 |
$s = 0 if (lc($x->{type}) eq "display"); |
$s = 0 if (lc($x->{type}) eq "display"); |
115 |
$d = 0 if (lc($x->{type}) eq "swish"); |
$d = 0 if (lc($x->{type}) eq "swish"); |
116 |
|
$se = 1 if (lc($x->{type}) eq "swish_exact"); |
117 |
($s,$d,$i) = (0,0,1) if (lc($x->{type}) eq "index"); |
($s,$d,$i) = (0,0,1) if (lc($x->{type}) eq "index"); |
118 |
|
|
119 |
# what will separate last line from this one? |
# what will separate last line from this one? |
126 |
# init vars so that we go into while... |
# init vars so that we go into while... |
127 |
($swish,$display) = (1,1); |
($swish,$display) = (1,1); |
128 |
|
|
129 |
if ($swish || $display) { |
# placeholder for all repeatable entries for index |
130 |
|
my @index_data; |
131 |
|
my $index_filter; |
132 |
|
|
133 |
|
sub mkformat { |
134 |
|
my $x = shift || die "mkformat needs tag reference"; |
135 |
|
my $data = shift || return; |
136 |
|
my $format_name = x($x->{format_name}) || return $data; |
137 |
|
my $fmt = x($config->{format}->{$format_name}->{content}) || die "<format name=\"$format_name\"> is not defined!"; |
138 |
|
my $format_delimiter = x($x->{format_delimiter}); |
139 |
|
my @data; |
140 |
|
if ($format_delimiter) { |
141 |
|
@data = split(/$format_delimiter/,$data); |
142 |
|
} else { |
143 |
|
push @data,$data; |
144 |
|
} |
145 |
|
|
146 |
|
if ($fmt) { |
147 |
|
my $nr = scalar $fmt =~ s/%s/%s/g; |
148 |
|
if (($#data+1) == $nr) { |
149 |
|
return sprintf($fmt,@data); |
150 |
|
} else { |
151 |
|
print STDERR "mkformat: [$data] can't be split on [$format_delimiter] to $nr fields!\n"; |
152 |
|
return $data; |
153 |
|
} |
154 |
|
} else { |
155 |
|
print STDERR "usage of link '$format_name' without defined format (<link> tag)\n"; |
156 |
|
} |
157 |
|
} |
158 |
|
|
159 |
|
# while because of repeatable fields |
160 |
|
while ($swish || $display) { |
161 |
($swish,$display) = parse_format($type, $format,$row,$repeat_off++,$import2cp); |
($swish,$display) = parse_format($type, $format,$row,$repeat_off++,$import2cp); |
162 |
|
if ($repeat_off > 1000) { |
163 |
|
print STDERR "loop (more than 1000 repeatable fields) deteced in $row, $format\n"; |
164 |
|
last; |
165 |
|
} |
166 |
|
|
167 |
# filter="name" ; filter this field through |
# filter="name" ; filter this field through |
168 |
# filter/[name].pm |
# filter/[name].pm |
169 |
my $filter = $x->{filter}; |
my $filter = $x->{filter}; |
171 |
require "filter/".$filter.".pm"; |
require "filter/".$filter.".pm"; |
172 |
} |
} |
173 |
# type="swish" ; field for swish |
# type="swish" ; field for swish |
174 |
if ($s && $swish) { |
if ($swish) { |
175 |
if ($filter) { |
if ($filter && ($s || $se)) { |
176 |
no strict 'refs'; |
no strict 'refs'; |
177 |
$swish_data .= join(" ",&$filter($swish)); |
my $tmp = join(" ",&$filter($swish)) if ($s || $se); |
178 |
|
$swish_data .= $tmp if ($s); |
179 |
|
$swish_exact_data .= $tmp if ($se); |
180 |
|
|
181 |
} else { |
} else { |
182 |
$swish_data .= $swish; |
$swish_data .= $swish if ($s); |
183 |
|
$swish_exact_data .= $swish if ($se); |
184 |
} |
} |
185 |
} |
} |
186 |
|
|
192 |
} |
} |
193 |
if ($filter) { |
if ($filter) { |
194 |
no strict 'refs'; |
no strict 'refs'; |
195 |
$display_data .= join($delimiter,&$filter($display)); |
if ($display_data) { |
196 |
|
$display_data .= $delimiter.join($delimiter,mkformat($x,&$filter($display))); |
197 |
|
} else { |
198 |
|
$display_data = join($delimiter,mkformat($x,&$filter($display))); |
199 |
|
} |
200 |
} else { |
} else { |
201 |
if ($display_data) { |
if ($display_data) { |
202 |
$display_data .= $delimiter.$display; |
$display_data .= $delimiter.mkformat($x,$display); |
203 |
} else { |
} else { |
204 |
$display_data .= $display; |
$display_data = mkformat($x,$display); |
205 |
} |
} |
206 |
} |
} |
207 |
} |
} |
208 |
|
|
209 |
# type="index" ; insert into index |
# type="index" ; insert into index |
210 |
if ($i && $display) { |
if ($i && $display) { |
211 |
my $index_data = $display; |
push @index_data, $display; |
212 |
if ($filter) { |
$index_filter = $filter if ($filter); |
213 |
no strict 'refs'; |
} |
214 |
foreach my $d (&$filter($index_data)) { |
} |
215 |
$index->insert($field, $d, $path); |
|
216 |
} |
# fill data in index |
217 |
} else { |
if (@index_data) { |
218 |
$index->insert($field, $index_data, $path); |
if ($index_filter) { |
219 |
|
no strict 'refs'; |
220 |
|
foreach my $d (@index_data) { |
221 |
|
$index->insert($field, &$index_filter($d), $path); |
222 |
|
} |
223 |
|
} else { |
224 |
|
foreach my $d (@index_data) { |
225 |
|
$index->insert($field, $d, $path); |
226 |
} |
} |
227 |
} |
} |
228 |
} |
} |
229 |
} |
} |
230 |
|
|
231 |
|
# now try to parse variables from configuration file |
232 |
|
foreach my $x (@{$config->{indexer}->{$field}->{'config'}}) { |
233 |
|
|
234 |
|
my $delimiter = x($x->{delimiter}) || ' '; |
235 |
|
my $val = $cfg->val($database, x($x->{content})); |
236 |
|
|
237 |
|
my ($s,$d,$i) = (1,1,0); # swish, display default |
238 |
|
$s = 0 if (lc($x->{type}) eq "display"); |
239 |
|
$d = 0 if (lc($x->{type}) eq "swish"); |
240 |
|
# no support for swish exact in config. |
241 |
|
# IMHO, it's useless |
242 |
|
($s,$d,$i) = (0,0,1) if (lc($x->{type}) eq "index"); |
243 |
|
|
244 |
|
if ($val) { |
245 |
|
$display_data .= $delimiter.$val if ($d); |
246 |
|
$swish_data .= $val if ($s); |
247 |
|
$index->insert($field, $val, $path) if ($i); |
248 |
|
} |
249 |
|
|
250 |
|
} |
251 |
|
|
252 |
|
|
253 |
if ($display_data) { |
if ($display_data) { |
254 |
|
|
281 |
$xml .= xmlify($field."_swish", unac_string($codepage,$swish_data)); |
$xml .= xmlify($field."_swish", unac_string($codepage,$swish_data)); |
282 |
} |
} |
283 |
|
|
284 |
|
if ($swish_exact_data) { |
285 |
|
$swish_exact_data =~ s/ +/ /g; |
286 |
|
$swish_exact_data =~ s/ +$//g; |
287 |
|
|
288 |
|
# add delimiters before and after word. |
289 |
|
# That is required to produce exact match |
290 |
|
$xml .= xmlify($field."_swish_exact", unac_string($codepage,'xxbxx '.$swish_exact_data.' xxexx')); |
291 |
|
} |
292 |
|
|
293 |
|
|
294 |
} |
} |
295 |
|
|
296 |
# dump formatted output in <html> |
# dump formatted output in <html> |
297 |
if ($html) { |
if ($html) { |
298 |
$xml .= xmlify("html",$html); |
#$xml .= xmlify("html",$html); |
299 |
|
$xml .= "<html><![CDATA[ $html ]]></html>"; |
300 |
} |
} |
301 |
|
|
302 |
if ($xml) { |
if ($xml) { |
323 |
$cfg_global->val('global', 'dbi_passwd') || '', |
$cfg_global->val('global', 'dbi_passwd') || '', |
324 |
); |
); |
325 |
|
|
326 |
|
my $show_progress = $cfg_global->val('global', 'show_progress'); |
327 |
|
|
328 |
|
my $unac_filter = $cfg_global->val('global', 'unac_filter'); |
329 |
|
if ($unac_filter) { |
330 |
|
require $unac_filter; |
331 |
|
} |
332 |
|
|
333 |
foreach my $database ($cfg->Sections) { |
foreach my $database ($cfg->Sections) { |
334 |
|
|
335 |
my $type = lc($cfg -> val($database, 'type')) || die "$database doesn't have 'type' defined"; |
my $type = lc($cfg -> val($database, 'type')) || die "$database doesn't have 'type' defined"; |
337 |
|
|
338 |
print STDERR "reading ./import_xml/$type.xml\n"; |
print STDERR "reading ./import_xml/$type.xml\n"; |
339 |
|
|
340 |
$config=XMLin("./import_xml/$type.xml", forcearray => [ $type2tag{$type} ], forcecontent => 1); |
# extract just type basic |
341 |
|
my $type_base = $type; |
342 |
|
$type_base =~ s/_.+$//g; |
343 |
|
|
344 |
|
$config=XMLin("./import_xml/$type.xml", forcearray => [ $type2tag{$type_base}, 'config', 'format' ], forcecontent => 1); |
345 |
|
|
346 |
# output current progress indicator |
# output current progress indicator |
347 |
my $last_p = 0; |
my $last_p = 0; |
348 |
sub progress { |
sub progress { |
349 |
#return if (! $opts{q}); # FIXME |
return if (! $show_progress); |
350 |
my $current = shift; |
my $current = shift; |
351 |
my $total = shift; |
my $total = shift || 1; |
352 |
my $p = int($current * 100 / $total); |
my $p = int($current * 100 / $total); |
353 |
if ($p != $last_p) { |
if ($p != $last_p) { |
354 |
printf STDERR ("%5d / %5d [%-51s] %-2d %% \r",$current,$total,"=" x ($p/2).">", $p ); |
printf STDERR ("%5d / %5d [%-51s] %-2d %% \r",$current,$total,"=" x ($p/2).">", $p ); |
356 |
} |
} |
357 |
} |
} |
358 |
|
|
359 |
|
my $fake_dir = 1; |
360 |
|
sub fakeprogress { |
361 |
|
return if (! $show_progress); |
362 |
|
my $current = shift @_; |
363 |
|
|
364 |
|
my @ind = ('-','\\','|','/','-','\\','|','/', '-'); |
365 |
|
|
366 |
|
$last_p += $fake_dir; |
367 |
|
$fake_dir = -$fake_dir if ($last_p > 1000 || $last_p < 0); |
368 |
|
if ($last_p % 10 == 0) { |
369 |
|
printf STDERR ("%5d / %5s [%-51s]\r",$current,"?"," " x ($last_p/20).$ind[($last_p/20) % $#ind]); |
370 |
|
} |
371 |
|
} |
372 |
|
|
373 |
# now read database |
# now read database |
374 |
print STDERR "using: $type...\n"; |
print STDERR "using: $type...\n"; |
375 |
|
|
376 |
if ($type eq "isis") { |
if ($type_base eq "isis") { |
377 |
|
|
378 |
my $isis_db = $cfg -> val($database, 'isis_db') || die "$database doesn't have 'isis_db' defined!"; |
my $isis_db = $cfg -> val($database, 'isis_db') || die "$database doesn't have 'isis_db' defined!"; |
379 |
|
|
380 |
$import2cp = Text::Iconv->new($config->{isis_codepage},$codepage); |
$import2cp = Text::Iconv->new($config->{isis_codepage},$codepage); |
381 |
my $db = OpenIsis::open( $isis_db ); |
my $db = OpenIsis::open( $isis_db ); |
382 |
|
|
383 |
|
# check if .txt database for OpenIsis is zero length, |
384 |
|
# if so, erase it and re-open database |
385 |
|
sub check_txt_db { |
386 |
|
my $isis_db = shift || die "need isis database name"; |
387 |
|
my $reopen = 0; |
388 |
|
|
389 |
|
if (-e $isis_db.".TXT") { |
390 |
|
print STDERR "WARNING: removing $isis_db.TXT OpenIsis database...\n"; |
391 |
|
unlink $isis_db.".TXT" || warn "FATAL: unlink error on '$isis_db.TXT': $!"; |
392 |
|
$reopen++; |
393 |
|
} |
394 |
|
if (-e $isis_db.".PTR") { |
395 |
|
print STDERR "WARNING: removing $isis_db.PTR OpenIsis database...\n"; |
396 |
|
unlink $isis_db.".PTR" || warn "FATAL: unlink error on '$isis_db.PTR': $!"; |
397 |
|
$reopen++; |
398 |
|
} |
399 |
|
return OpenIsis::open( $isis_db ) if ($reopen); |
400 |
|
} |
401 |
|
|
402 |
|
# EOF error |
403 |
|
if ($db == -1) { |
404 |
|
$db = check_txt_db($isis_db); |
405 |
|
if ($db == -1) { |
406 |
|
print STDERR "FATAL: OpenIsis can't open zero size file $isis_db\n"; |
407 |
|
next; |
408 |
|
} |
409 |
|
} |
410 |
|
|
411 |
|
# OpenIsis::ERR_BADF |
412 |
|
if ($db == -4) { |
413 |
|
print STDERR "FATAL: OpenIsis can't find file $isis_db\n"; |
414 |
|
next; |
415 |
|
# OpenIsis::ERR_IO |
416 |
|
} elsif ($db == -5) { |
417 |
|
print STDERR "FATAL: OpenIsis can't access file $isis_db\n"; |
418 |
|
next; |
419 |
|
} elsif ($db < 0) { |
420 |
|
print STDERR "FATAL: OpenIsis unknown error $db with file $isis_db\n"; |
421 |
|
next; |
422 |
|
} |
423 |
|
|
424 |
my $max_rowid = OpenIsis::maxRowid( $db ); |
my $max_rowid = OpenIsis::maxRowid( $db ); |
425 |
|
|
426 |
|
# if 0 records, try to rease isis .txt database |
427 |
|
if ($max_rowid == 0) { |
428 |
|
# force removal of database |
429 |
|
$db = check_txt_db($isis_db); |
430 |
|
$max_rowid = OpenIsis::maxRowid( $db ); |
431 |
|
} |
432 |
|
|
433 |
print STDERR "Reading database: $isis_db [$max_rowid rows]\n"; |
print STDERR "Reading database: $isis_db [$max_rowid rows]\n"; |
434 |
|
|
435 |
my $path = $database; |
my $path = $database; |
442 |
|
|
443 |
my $swishpath = $path."#".int($row->{mfn}); |
my $swishpath = $path."#".int($row->{mfn}); |
444 |
|
|
445 |
if (my $xml = data2xml($type,$row,$add_xml)) { |
if (my $xml = data2xml($type_base,$row,$add_xml,$cfg,$database)) { |
446 |
$xml = $cp2utf->convert($xml); |
$xml = $cp2utf->convert($xml); |
447 |
use bytes; # as opposed to chars |
use bytes; # as opposed to chars |
448 |
print "Path-Name: $swishpath\n"; |
print "Path-Name: $swishpath\n"; |
451 |
} |
} |
452 |
} |
} |
453 |
} |
} |
454 |
|
# for this to work with current version of OpenIsis (0.9.0) |
455 |
|
# you might need my patch from |
456 |
|
# http://www.rot13.org/~dpavlin/projects/openisis-0.9.0-perl_close.diff |
457 |
|
OpenIsis::close($db); |
458 |
print STDERR "\n"; |
print STDERR "\n"; |
459 |
|
|
460 |
} elsif ($type eq "excel") { |
} elsif ($type_base eq "excel") { |
461 |
use Spreadsheet::ParseExcel; |
use Spreadsheet::ParseExcel; |
462 |
use Spreadsheet::ParseExcel::Utility qw(int2col); |
use Spreadsheet::ParseExcel::Utility qw(int2col); |
463 |
|
|
503 |
|
|
504 |
next if (! $row); |
next if (! $row); |
505 |
|
|
506 |
if (my $xml = data2xml($type,$row,$add_xml)) { |
if (my $xml = data2xml($type_base,$row,$add_xml,$cfg,$database)) { |
507 |
|
$xml = $cp2utf->convert($xml); |
508 |
|
use bytes; # as opposed to chars |
509 |
|
print "Path-Name: $swishpath\n"; |
510 |
|
print "Content-Length: ".(length($xml)+1)."\n"; |
511 |
|
print "Document-Type: XML\n\n$xml\n"; |
512 |
|
} |
513 |
|
} |
514 |
|
} elsif ($type_base eq "marc") { |
515 |
|
|
516 |
|
use MARC; |
517 |
|
|
518 |
|
$import2cp = Text::Iconv->new($config->{marc_codepage},$codepage); |
519 |
|
my $marc_file = $cfg -> val($database, 'marc_file') || die "$database doesn't have 'marc_file' defined!"; |
520 |
|
|
521 |
|
# optional argument is format |
522 |
|
my $format = x($config->{format}) || 'usmarc'; |
523 |
|
|
524 |
|
print STDERR "Reading MARC file '$marc_file'\n"; |
525 |
|
|
526 |
|
my $marc = new MARC; |
527 |
|
my $nr = $marc->openmarc({ |
528 |
|
file=>$marc_file, format=>$format |
529 |
|
}) || die "Can't open MARC file '$marc_file'"; |
530 |
|
|
531 |
|
my $i=0; # record nr. |
532 |
|
|
533 |
|
my $rec; |
534 |
|
|
535 |
|
while ($marc->nextmarc(1)) { |
536 |
|
|
537 |
|
# XXX |
538 |
|
fakeprogress($i++); |
539 |
|
|
540 |
|
my $swishpath = $database."#".$i; |
541 |
|
|
542 |
|
if (my $xml = data2xml($type_base,$marc,$add_xml,$cfg,$database)) { |
543 |
$xml = $cp2utf->convert($xml); |
$xml = $cp2utf->convert($xml); |
544 |
use bytes; # as opposed to chars |
use bytes; # as opposed to chars |
545 |
print "Path-Name: $swishpath\n"; |
print "Path-Name: $swishpath\n"; |
547 |
print "Document-Type: XML\n\n$xml\n"; |
print "Document-Type: XML\n\n$xml\n"; |
548 |
} |
} |
549 |
} |
} |
550 |
|
} elsif ($type_base eq "feed") { |
551 |
|
|
552 |
|
$import2cp = Text::Iconv->new($config->{feed_codepage},$codepage); |
553 |
|
my $prog = x($config->{prog}) || die "$database doesn't have 'prog' defined!"; |
554 |
|
|
555 |
|
print STDERR "Reading feed from program '$prog'\n"; |
556 |
|
|
557 |
|
open(FEED,"feeds/$prog |") || die "can't start $prog: $!"; |
558 |
|
|
559 |
|
my $i=1; # record nr. |
560 |
|
|
561 |
|
my $data; |
562 |
|
my $line=1; |
563 |
|
|
564 |
|
while (<FEED>) { |
565 |
|
chomp; |
566 |
|
|
567 |
|
if (/^$/) { |
568 |
|
my $swishpath = $database."#".$i++; |
569 |
|
|
570 |
|
if (my $xml = data2xml($type_base,$data,$add_xml,$cfg,$database)) { |
571 |
|
$xml = $cp2utf->convert($xml); |
572 |
|
use bytes; # as opposed to chars |
573 |
|
print "Path-Name: $swishpath\n"; |
574 |
|
print "Content-Length: ".(length($xml)+1)."\n"; |
575 |
|
print "Document-Type: XML\n\n$xml\n"; |
576 |
|
} |
577 |
|
$line = 1; |
578 |
|
$data = {}; |
579 |
|
next; |
580 |
|
} |
581 |
|
|
582 |
|
$line = $1 if (s/^(\d+):\s*//); |
583 |
|
$data->{$line++} = $_; |
584 |
|
|
585 |
|
fakeprogress($i); |
586 |
|
|
587 |
|
} |
588 |
} |
} |
589 |
} |
} |
590 |
|
|
597 |
|
|
598 |
=head1 NAME |
=head1 NAME |
599 |
|
|
600 |
isis2xml.pl - read isis file and dump XML |
all2xml.pl - read various file formats and dump XML for SWISH-E |
601 |
|
|
602 |
=head1 DESCRIPTION |
=head1 DESCRIPTION |
603 |
|
|
604 |
This command will read ISIS data file using OpenIsis perl module and |
This command will read ISIS data file using OpenIsis perl module, MARC |
605 |
create XML file for usage with I<SWISH-E> |
records using MARC module and optionally Micro$oft Excel files to |
606 |
indexer. Dispite it's name, this script B<isn't general xml generator> |
create one XML file for usage with I<SWISH-E> indexer. Dispite it's name, |
607 |
from isis files (isis allready has something like that). Output of this |
this script B<isn't general xml generator> from isis files (isis allready |
608 |
script is tailor-made for SWISH-E. |
has something like that). Output of this script is tailor-made for SWISH-E. |
609 |
|
|
610 |
|
=head1 BUGS |
611 |
|
|
612 |
|
Documentation is really lacking. However, in true Open Source spirit, source |
613 |
|
is best documentation. I even made considerable effort to comment parts |
614 |
|
which are not intuitively clear, so... |
615 |
|
|
616 |
=head1 AUTHOR |
=head1 AUTHOR |
617 |
|
|