8 use Text::Unaccent 1.02; # 1.01 won't compile on my platform,
13 use Fcntl; # for O_RDWR
19 $config_file =~ s/\.pl$/.conf/;
20 die "FATAL: can't find configuration file '$config_file'" if (! -e $config_file);
24 #use index_DBI; # default DBI module for index
25 use index_DBI_cache; # faster DBI module using memory cache
32 # -m multiple directories
36 getopts('d:m:qs', \%opts);
38 my $path; # this is name of database
40 Text::Iconv->raise_error(0); # Conversion errors don't raise exceptions
42 # this is encoding of all files on disk, including import_xml/*.xml file and
43 # filter/*.pm files! It will be used to store strings in perl internally!
44 my $codepage = 'ISO-8859-2';
46 my $utf2cp = Text::Iconv->new('UTF-8',$codepage);
47 # this function will convert data from XML files to local encoding
49 return $utf2cp->convert($_[0]);
52 # decode isis/excel or other import codepage
55 # outgoing xml must be in UTF-8
56 my $cp2utf = Text::Iconv->new($codepage,'UTF-8');
58 # mapping between data type and tag which specify
67 my $cache; # for cacheing
69 # lookup hash (tied to file)
71 # this option will cache all lookup entries in memory.
72 # if you are tight on memory, turn this off
73 my $use_lhash_cache = 1;
75 my $last_field_name; # cache to prevent repeated fields
83 my $add_xml = shift @_;
84 # needed to read values from configuration file
86 my $database = shift @_;
92 my $html = ""; # html formatted display output
94 my %field_usage; # counter for usage of each field
96 # sort subrouting using order="" attribute
98 my $va = $config->{indexer}->{$a}->{order} ||
99 $config->{indexer}->{$a};
100 my $vb = $config->{indexer}->{$b}->{order} ||
101 $config->{indexer}->{$b};
107 if ($cache->{tags_by_order}) {
108 @sorted_tags = @{$cache->{tags_by_order}};
110 @sorted_tags = sort by_order keys %{$config->{indexer}};
111 $cache->{tags_by_order} = \@sorted_tags;
117 # cache for field in pages
118 delete $cache->{display_data};
119 delete $cache->{swish_data};
120 delete $cache->{swish_exact_data};
121 delete $cache->{index_data};
122 delete $cache->{index_delimiter};
123 my @page_fields; # names of fields
126 # subs used to produce output
128 sub get_field_name($$$) {
129 my ($config,$field,$field_usage) = @_;
131 # find field name (signular, plural)
133 if ($config->{indexer}->{$field}->{name_singular} && $field_usage == 1) {
134 $field_name = $config->{indexer}->{$field}->{name_singular};
135 } elsif ($config->{indexer}->{$field}->{name_plural}) {
136 $field_name = $config->{indexer}->{$field}->{name_plural};
137 } elsif ($config->{indexer}->{$field}->{name}) {
138 $field_name = $config->{indexer}->{$field}->{name};
140 print STDERR "WARNING: field '$field' doesn't have 'name' attribute!";
143 if (! $last_field_name) {
144 $last_field_name = x($field_name);
145 return $last_field_name;
146 } elsif ($field_name ne $last_field_name) {
147 $last_field_name = x($field_name);
148 return $last_field_name;
154 # begin real work: go field by field
155 foreach my $field (@sorted_tags) {
158 $field_usage{$field}++;
161 my $swish_exact_data = "";
162 my $display_data = "";
166 my ($swish,$display);
168 my $tag = $type2tag{$type} || die "can't find which tag to use for type $type";
170 # is this field page-by-page?
171 my $iterate_by_page = $config->{indexer}->{$field}->{iterate_by_page};
172 push @page_fields,$field if ($iterate_by_page);
174 # default line_delimiter if using
175 my $page_line_delimiter = $config->{indexer}->{$field}->{page_line_delimiter} || '<br/>';
176 $cache->{index_delimiter}->{$field} = $config->{indexer}->{$field}->{index_delimiter};
178 my $format_name = $config->{indexer}->{$field}->{format_name};
179 my $format_delimiter = $config->{indexer}->{$field}->{format_delimiter};
180 if ($format_name && $format_delimiter) {
181 $cache->{format}->{$field}->{format_name} = $format_name;
182 $cache->{format}->{$field}->{format_delimiter} = $format_delimiter;
185 foreach my $x (@{$config->{indexer}->{$field}->{$tag}}) {
187 my $format = x($x->{content});
188 my $delimiter = x($x->{delimiter}) || ' ';
190 my $repeat_off = 0; # init repeatable offset
192 # swish, swish_exact, display, index, index_lookup
193 # swish and display defaults
194 my ($s,$se,$d,$i,$il) = (1,0,1,0,0);
195 $s = 0 if (lc($x->{type}) eq "display");
196 $d = 0 if (lc($x->{type}) eq "swish");
197 ($s,$se,$d,$i) = (0,1,0,1) if (lc($x->{type}) eq "index");
198 ($s,$se,$d,$i) = (0,1,0,0) if (lc($x->{type}) eq "swish_exact");
199 ($s,$se,$d,$i,$il) = (0,1,0,0,1) if (lc($x->{type}) =~ /^lookup/);
201 # what will separate last line from this one?
202 if ($display_data && $x->{append}) {
203 $line_delimiter = ' ';
204 } elsif ($display_data) {
205 $line_delimiter = '<br/>';
208 # init vars so that we go into while...
209 ($swish,$display) = (1,1);
211 # placeholder for all repeatable entries for index
215 if ($data =~ s/eval{([^}]+)}//) {
227 my $x = shift || die "mkformat needs tag reference";
228 my $data = shift || return;
229 my $format_name = x($x->{format_name}) || return chk_eval($data);
230 my $fmt = x($config->{format}->{$format_name}->{content}) || die "<format name=\"$format_name\"> is not defined!";
231 my $format_delimiter = x($x->{format_delimiter});
233 if ($format_delimiter) {
234 @data = split(/$format_delimiter/,$data);
240 my $nr = scalar $fmt =~ s/%s/%s/g;
241 if (($#data+1) == $nr) {
242 return chk_eval(sprintf($fmt,@data));
244 #print STDERR "mkformat: [$data] can't be split on [$format_delimiter] to $nr fields!\n";
245 return chk_eval($data);
248 print STDERR "usage of link '$format_name' without defined format (<link> tag)\n";
252 # while because of repeatable fields
253 while ($swish || $display) {
254 my $page = $repeat_off;
255 $page_max{$field} = $page if ($iterate_by_page && $page > ($page_max{$field} || 0));
256 ($swish,$display) = parse_format($type, $format,$row,$repeat_off++,$import2cp);
257 if ($repeat_off > 1000) {
258 print STDERR "loop (more than 1000 repeatable fields) deteced in $row, $format\n";
262 # is this field is lookup?
263 if ($display && $x->{lookup}) {
264 my $null = "<!-- null -->";
265 if ($use_lhash_cache) {
266 if (!defined($cache->{lhash}->{$display})) {
267 my $new_display = $lhash{$display};
268 if (defined($new_display)) {
269 #print STDERR "lookup cache store '$display' = '$new_display'\n";
270 $display = $new_display;
271 $cache->{lhash}->{$display} = $new_display;
273 print STDERR "WARNING: lookup for '$display' didn't find anything.\n";
275 $cache->{lhash}->{$display} = $null;
278 $display = $cache->{lhash}->{$display};
281 $display = $lhash{$display} || $null;
285 # filter="name" ; filter this field through
287 my $filter = $x->{filter};
288 if ($filter && !$cache->{filter_loaded}->{$filter}) {
289 require "filter/".$filter.".pm";
290 $cache->{filter_loaded}->{$filter}++;
292 # type="swish" ; field for swish
294 if ($filter && ($s || $se)) {
296 my $tmp = join(" ",&$filter($swish)) if ($s || $se);
297 $swish_data .= $tmp if ($s);
298 $swish_exact_data .= "xxbxx $tmp xxexx " if ($se && $tmp ne "");
301 $swish_data .= $swish if ($s);
302 $swish_exact_data .= "xxbxx $swish xxexx " if ($se && $swish ne "");
306 # type="display" ; field for display
307 if ($d && $display) {
308 my $ldel = $delimiter;
309 if ($line_delimiter && $display_data) {
310 $ldel = $line_delimiter;
315 foreach my $tmp (&$filter($display)) {
316 my $tmp2 = mkformat($x,$tmp);
317 push @arr,$tmp2 if ($tmp2);
319 $display_data .= $ldel if ($display_data && @arr);
320 $display_data .= join($delimiter,@arr);
322 $display_data .= $ldel if ($display_data);
323 my $tmp = mkformat($x,$display);
324 $display_data .= $tmp if ($tmp);
328 # type="index" ; insert into index
330 if ($i && $display) {
331 $idisplay = $display;
334 $idisplay = &$filter($idisplay);
336 push @index_data, $idisplay if (! $iterate_by_page);
339 # store fields in lookup
340 if ($il && $display) {
341 if (lc($x->{type}) eq "lookup_key") {
343 print STDERR "WARNING: try to redefine lookup_key (keys shouldn't be repeatable fields!)";
345 $lookup_key = $display;
347 } elsif (lc($x->{type}) eq "lookup_val") {
349 $lhash{$lookup_key} = $display;
351 print STDERR "WARNING: no lookup_key defined for '$display'?";
357 # store data for page-by-page repeatable fields
358 if ($iterate_by_page) {
359 sub iterate_fld($$$$$$) {
360 my ($cache,$what,$field,$page,$data,$append) = @_;
363 my $ldel = $page_line_delimiter;
364 $ldel = " " if ($append);
365 #print STDERR "line delimiter: ",Dumper($ldel) if ($ldel);
366 if (! $cache->{$what}->{$field}->[$page]) {
367 $cache->{$what}->{$field}->[$page] = $data;
369 $cache->{$what}->{$field}->[$page] .= $ldel.$data;
374 iterate_fld($cache,'display_data',$field,$page,$display_data,$x->{append});
378 iterate_fld($cache,'swish_data',$field,$page,$swish_data,$x->{append});
381 if ($swish_exact_data) {
382 iterate_fld($cache,'swish_exact_data',$field,$page,$swish_exact_data,$x->{append});
383 $swish_exact_data = "";
387 my $ldel=$page_line_delimiter;
389 if ($cache->{index_data}->{$field}->[$page]) {
391 @index_data = @{$cache->{index_data}->{$field}->[$page]};
395 $index_data[$#index_data] .= $idisplay;
397 push @index_data, $idisplay;
400 push @index_data, $idisplay;
403 @{$cache->{index_data}->{$field}->[$page]} = @index_data;
408 if (! $iterate_by_page) {
409 my $idel = $x->{index_delimiter};
411 foreach my $tmp (@index_data) {
413 if ($idel && $tmp =~ m/$idel/) {
414 ($i,$d) = split(/$idel/,$tmp);
416 $index->insert($field, $i, $d, $path);
422 # now try to parse variables from configuration file
423 foreach my $x (@{$config->{indexer}->{$field}->{'config'}}) {
425 my $delimiter = x($x->{delimiter}) || ' ';
426 my $val = $cfg->val($database, x($x->{content}));
428 my ($s,$d,$i) = (1,1,0); # swish, display default
429 $s = 0 if (lc($x->{type}) eq "display");
430 $d = 0 if (lc($x->{type}) eq "swish");
431 # no support for swish exact in config.
433 ($s,$d,$i) = (0,0,1) if (lc($x->{type}) eq "index");
436 $display_data .= $delimiter.$val if ($d);
437 $swish_data .= $val if ($s);
438 $index->insert($field, $val, $path) if ($i);
441 if ($iterate_by_page) {
442 # FIXME data from config tag will appear just
446 $cache->{display_data}->{$field}->[$page] = $display_data;
450 $cache->{swish_data}->{$field}->[$page] = $swish_data;
453 if ($swish_exact_data) {
454 $cache->{swish_exact_data}->{$field}->[$page] = $swish_exact_data;
455 $swish_exact_data = "";
460 # save data page-by-page
461 foreach my $field (@page_fields) {
462 my $nr_pages = $page_max{$field} || next;
463 #print STDERR "field '$field' iterate over ",($nr_pages || 0)," pages...\n";
464 #print STDERR Dumper($cache->{display_data});
465 for (my $page=0; $page <= $nr_pages; $page++) {
467 if ($cache->{format}->{$field}) {
468 my $tmp = mkformat($cache->{format}->{$field},$cache->{display_data}->{$field}->[$page]);
469 $display_data=$tmp if ($tmp);
471 $display_data = $cache->{display_data}->{$field}->[$page];
473 if ($display_data) { # default
474 if ($field eq "headline") {
475 $xml .= xmlify("headline", $display_data);
478 # fallback to empty field name if needed
479 $html .= get_field_name($config,$field,$field_usage{$field}) || '';
480 $html .= "#-#".$display_data."###\n";
484 my $swish_data = $cache->{swish_data}->{$field}->[$page];
486 # remove extra spaces
487 $swish_data =~ s/ +/ /g;
488 $swish_data =~ s/ +$//g;
490 $xml .= xmlify($field."_swish", unac_string($codepage,$swish_data));
493 my $swish_exact_data = $cache->{swish_exact_data}->{$field}->[$page];
494 if ($swish_exact_data) {
495 $swish_exact_data =~ s/ +/ /g;
496 $swish_exact_data =~ s/ +$//g;
498 # add delimiters before and after word.
499 # That is required to produce exact match
500 $xml .= xmlify($field."_swish_exact", unac_string($codepage,$swish_exact_data));
503 my $idel = $cache->{index_delimiter}->{$field};
504 foreach my $tmp (@{$cache->{index_data}->{$field}->[$page]}) {
507 if ($idel && $tmp =~ m/$idel/) {
508 ($i,$d) = split(/$idel/,$tmp);
510 $index->insert($field, $i, $d, $path);
511 #print STDERR "index [$idel] $field: $i --> $d [$path]\n";
517 if (! $iterate_by_page) {
519 if ($field eq "headline") {
520 $xml .= xmlify("headline", $display_data);
523 # fallback to empty field name if needed
524 $html .= get_field_name($config,$field,$field_usage{$field}) || '';
525 $html .= "#-#".$display_data."###\n";
529 # remove extra spaces
530 $swish_data =~ s/ +/ /g;
531 $swish_data =~ s/ +$//g;
533 $xml .= xmlify($field."_swish", unac_string($codepage,$swish_data));
536 if ($swish_exact_data) {
537 $swish_exact_data =~ s/ +/ /g;
538 $swish_exact_data =~ s/ +$//g;
540 # add delimiters before and after word.
541 # That is required to produce exact match
542 $xml .= xmlify($field."_swish_exact", unac_string($codepage,$swish_exact_data));
547 # dump formatted output in <html>
549 #$xml .= xmlify("html",$html);
550 $xml .= "<html><![CDATA[ $html ]]></html>";
554 $xml .= $add_xml if ($add_xml);
555 return "<xml>\n$xml</xml>\n";
561 ##########################################################################
563 # read configuration for this script
564 my $cfg = new Config::IniFiles( -file => $config_file );
566 # read global.conf configuration
567 my $cfg_global = new Config::IniFiles( -file => 'global.conf' );
570 $index = new index_DBI(
571 $cfg_global->val('global', 'dbi_dbd'),
572 $cfg_global->val('global', 'dbi_dsn'),
573 $cfg_global->val('global', 'dbi_user'),
574 $cfg_global->val('global', 'dbi_passwd') || '',
577 my $show_progress = $cfg_global->val('global', 'show_progress');
579 my $unac_filter = $cfg_global->val('global', 'unac_filter');
581 require $unac_filter;
584 foreach my $database ($cfg->Sections) {
586 my $type = lc($cfg -> val($database, 'type')) || die "$database doesn't have 'type' defined";
587 my $add_xml = $cfg -> val($database, 'xml'); # optional
589 # create new lookup file
590 my $lookup_file = $cfg -> val($database, 'lookup_newfile'); # optional
592 #tie %lhash, 'GDBM_File', $lookup_file, &GDBM_NEWDB, 0644;
593 tie %lhash, 'TDB_File', $lookup_file, TDB_CLEAR_IF_FIRST, O_RDWR, 0644;
594 print STDERR "creating lookup file '$lookup_file'\n";
597 # open existing lookup file
598 $lookup_file = $cfg -> val($database, 'lookup_open'); # optional
600 #tie %lhash, 'GDBM_File', $lookup_file, &GDBM_READER, 0644;
601 tie %lhash, 'TDB_File', $lookup_file, TDB_DEFAULT, O_RDWR, 0644;
602 print STDERR "opening lookup file '$lookup_file'\n";
605 print STDERR "reading ./import_xml/$type.xml\n";
607 # extract just type basic
608 my $type_base = $type;
609 $type_base =~ s/_.+$//g;
611 $config=XMLin("./import_xml/$type.xml", forcearray => [ $type2tag{$type_base}, 'config', 'format' ], forcecontent => 1);
613 # output current progress indicator
616 return if (! $show_progress);
618 my $total = shift || 1;
619 my $p = int($current * 100 / $total);
621 printf STDERR ("%5d / %5d [%-51s] %-2d %% \r",$current,$total,"=" x ($p/2).">", $p );
628 return if (! $show_progress);
629 my $current = shift @_;
631 my @ind = ('-','\\','|','/','-','\\','|','/', '-');
633 $last_p += $fake_dir;
634 $fake_dir = -$fake_dir if ($last_p > 1000 || $last_p < 0);
635 if ($last_p % 10 == 0) {
636 printf STDERR ("%5d / %5s [%-51s]\r",$current,"?"," " x ($last_p/20).$ind[($last_p/20) % $#ind]);
641 print STDERR "using: $type...\n";
643 # erase cache for tags by order in this database
644 delete $cache->{tags_by_order};
646 if ($type_base eq "isis") {
648 my $isis_db = $cfg -> val($database, 'isis_db') || die "$database doesn't have 'isis_db' defined!";
650 $import2cp = Text::Iconv->new($config->{isis_codepage},$codepage);
651 my $db = OpenIsis::open( $isis_db );
653 # check if .txt database for OpenIsis is zero length,
654 # if so, erase it and re-open database
656 my $isis_db = shift || die "need isis database name";
659 if (-e $isis_db.".TXT") {
660 print STDERR "WARNING: removing $isis_db.TXT OpenIsis database...\n";
661 unlink $isis_db.".TXT" || warn "FATAL: unlink error on '$isis_db.TXT': $!";
664 if (-e $isis_db.".PTR") {
665 print STDERR "WARNING: removing $isis_db.PTR OpenIsis database...\n";
666 unlink $isis_db.".PTR" || warn "FATAL: unlink error on '$isis_db.PTR': $!";
669 return OpenIsis::open( $isis_db ) if ($reopen);
674 $db = check_txt_db($isis_db);
676 print STDERR "FATAL: OpenIsis can't open zero size file $isis_db\n";
683 print STDERR "FATAL: OpenIsis can't find file $isis_db\n";
686 } elsif ($db == -5) {
687 print STDERR "FATAL: OpenIsis can't access file $isis_db\n";
690 print STDERR "FATAL: OpenIsis unknown error $db with file $isis_db\n";
694 my $max_rowid = OpenIsis::maxRowid( $db );
696 # if 0 records, try to rease isis .txt database
697 if ($max_rowid == 0) {
698 # force removal of database
699 $db = check_txt_db($isis_db);
700 $max_rowid = OpenIsis::maxRowid( $db );
703 print STDERR "Reading database: $isis_db [$max_rowid rows]\n";
705 my $path = $database;
707 for (my $row_id = 1; $row_id <= $max_rowid; $row_id++ ) {
708 my $row = OpenIsis::read( $db, $row_id );
709 if ($row && $row->{mfn}) {
711 progress($row->{mfn}, $max_rowid);
713 my $swishpath = $path."#".int($row->{mfn});
715 if (my $xml = data2xml($type_base,$row,$add_xml,$cfg,$database)) {
716 $xml = $cp2utf->convert($xml);
717 use bytes; # as opposed to chars
718 print "Path-Name: $swishpath\n";
719 print "Content-Length: ".(length($xml)+1)."\n";
720 print "Document-Type: XML\n\n$xml\n";
724 # for this to work with current version of OpenIsis (0.9.0)
725 # you might need my patch from
726 # http://www.rot13.org/~dpavlin/projects/openisis-0.9.0-perl_close.diff
727 OpenIsis::close($db);
730 } elsif ($type_base eq "excel") {
731 use Spreadsheet::ParseExcel;
732 use Spreadsheet::ParseExcel::Utility qw(int2col);
734 $import2cp = Text::Iconv->new($config->{excel_codepage},$codepage);
735 my $excel_file = $cfg -> val($database, 'excel_file') || die "$database doesn't have 'excel_file' defined!";
737 my $sheet = x($config->{sheet}) || die "no sheet in $type.xml";
738 my $start_row = x($config->{start_row}) - 1 || die "no start_row in $type.xml";
740 my $oBook = Spreadsheet::ParseExcel::Workbook->Parse($excel_file) || die "can't open Excel file '$excel_file'";
743 foreach my $oWks (@{$oBook->{Worksheet}}) {
744 #print STDERR "-- SHEET $sheet_nr:", $oWks->{Name}, "\n";
745 last if ($oWks->{Name} eq $sheet);
749 my $oWorksheet = $oBook->{Worksheet}[$sheet_nr];
751 print STDERR "using sheet: ",$oWorksheet->{Name},"\n";
752 defined ($oWorksheet) || die "can't find sheet '$sheet' in $excel_file";
753 my $end_row = x($config->{end_row}) || $oWorksheet->{MaxRow};
755 for(my $iR = $start_row ; defined $end_row && $iR <= $end_row ; $iR++) {
757 for(my $iC = $oWorksheet->{MinCol} ; defined $oWorksheet->{MaxCol} && $iC <= $oWorksheet->{MaxCol} ; $iC++) {
758 my $cell = $oWorksheet->{Cells}[$iR][$iC];
760 $row->{int2col($iC)} = $cell->Value;
764 progress($iR, $end_row);
766 # print "row[$iR/$end_row] ";
767 # foreach (keys %{$row}) {
768 # print "$_: ",$row->{$_},"\t";
772 my $swishpath = $database."#".$iR;
776 if (my $xml = data2xml($type_base,$row,$add_xml,$cfg,$database)) {
777 $xml = $cp2utf->convert($xml);
778 use bytes; # as opposed to chars
779 print "Path-Name: $swishpath\n";
780 print "Content-Length: ".(length($xml)+1)."\n";
781 print "Document-Type: XML\n\n$xml\n";
784 } elsif ($type_base eq "marc") {
788 $import2cp = Text::Iconv->new($config->{marc_codepage},$codepage);
789 my $marc_file = $cfg -> val($database, 'marc_file') || die "$database doesn't have 'marc_file' defined!";
791 # optional argument is format
792 my $format = x($config->{marc_format}) || 'usmarc';
794 print STDERR "Reading MARC file '$marc_file'\n";
797 my $nr = $marc->openmarc({
798 file=>$marc_file, format=>$format
799 }) || die "Can't open MARC file '$marc_file' with format '$format'";
801 # read MARC file in memory
804 my $max_rec = $marc->marc_count();
806 for(my $i=1; $i<=$max_rec; $i++) {
808 progress($i,$max_rec);
810 # store value for marc_sf.pm
811 $main::cache->{marc_record} = $i;
813 my $swishpath = $database."#".$i;
815 if (my $xml = data2xml($type_base,$marc,$add_xml,$cfg,$database)) {
816 $xml = $cp2utf->convert($xml);
817 use bytes; # as opposed to chars
818 print "Path-Name: $swishpath\n";
819 print "Content-Length: ".(length($xml)+1)."\n";
820 print "Document-Type: XML\n\n$xml\n";
826 } elsif ($type_base eq "feed") {
828 $import2cp = Text::Iconv->new($config->{feed_codepage},$codepage);
829 my $prog = x($config->{prog}) || die "$database doesn't have 'prog' defined!";
831 print STDERR "Reading feed from program '$prog'\n";
833 open(FEED,"feeds/$prog |") || die "can't start $prog: $!";
835 my $i=1; # record nr.
844 my $swishpath = $database."#".$i++;
846 if (my $xml = data2xml($type_base,$data,$add_xml,$cfg,$database)) {
847 $xml = $cp2utf->convert($xml);
848 use bytes; # as opposed to chars
849 print "Path-Name: $swishpath\n";
850 print "Content-Length: ".(length($xml)+1)."\n";
851 print "Document-Type: XML\n\n$xml\n";
858 $line = $1 if (s/^(\d+):\s*//);
859 $data->{$line++} = $_;
865 untie %lhash if (%lhash);
869 # call this to commit index
874 ##########################################################################
878 all2xml.pl - read various file formats and dump XML for SWISH-E
882 This command will read ISIS data file using OpenIsis perl module, MARC
883 records using MARC module and optionally Micro$oft Excel files to
884 create one XML file for usage with I<SWISH-E> indexer. Dispite it's name,
885 this script B<isn't general xml generator> from isis files (isis allready
886 has something like that). Output of this script is tailor-made for SWISH-E.
890 Documentation is really lacking. However, in true Open Source spirit, source
891 is best documentation. I even made considerable effort to comment parts
892 which are not intuitively clear, so...
896 Dobrica Pavlinusic <dpavlin@rot13.org>
900 GNU Public License (GPL) v2 or later
904 SWISH-E web site at http://www.swish-e.org