#!/usr/bin/perl
-# $Id: filter2docs.pl,v 1.3 2008/05/11 12:31:29 fabiankeil Exp $
+# $Id: filter2docs.pl,v 1.5 2008/05/12 09:31:36 fabiankeil Exp $
# $Source: /cvsroot/ijbswa/current/utils/filter2docs.pl,v $
# Parse the filter names and descriptions from a filter file and
use strict;
use warnings;
-die "Usage: $0 filter-file\n" unless (@ARGV == 1) ;
-open(INPUT, "< $ARGV[0]") or die "Coudln't open input file $ARGV[0] because $!\n";
+my (%comment_lines, %action_lines, %sgml_source_1, %sgml_source_2);
-my ($comment_lines, $action_lines, $sgml_source_1, $sgml_source_2);
+sub main() {
-while (<INPUT>) {
- if (/^(FILTER): ([-\w]+) (.*)$/) {
- my $type_uc = $1;
- my $name = $2;
- my $description = $3;
- my $type = lc($type_uc);
+ die "Usage: $0 filter-file\n" unless (@ARGV == 1) ;
+ open(INPUT, "< $ARGV[0]") or die "Coudln't open input file $ARGV[0] because $!\n";
- $comment_lines .= "# $name:" . (" " x (20-length($name))) . "$description\n";
- $action_lines .= "+$type" . "{$name} \\\n";
- $sgml_source_1 .= " <para>\n <anchor id=\"$type-$name\">\n <screen>+" . $type . "{$name}" .
- (" " x (20-length($name))) . "# $description</screen>\n </para>\n";
- $sgml_source_2 .= " -<link linkend=\"" . $type_uc . "-" . uc($name) . "\">$type" . "{$name}</link> \\\n";
- }
+ parse_file();
+ print_markup();
}
-print <<DOCMARKUP;
+sub parse_file() {
+ while (<INPUT>) {
+ if (/^((?:(?:SERVER|CLIENT)-HEADER-)?(?:FILTER|TAGGER)): ([-\w]+) (.*)$/) {
+ my $type_uc = $1;
+ my $name = $2;
+ my $description = $3;
+ my $type = lc($type_uc);
+
+ my $white_space = ' ' x (($type eq 'filter' ? 20 : 27) - length($name));
+
+ $comment_lines{$type} .= "# $name:" . $white_space . "$description\n";
+ $action_lines{$type} .= "+$type" . "{$name} \\\n";
+ $sgml_source_1{$type} .= " <para>\n <anchor id=\"$type-$name\">\n" .
+ " <screen>+$type" . "{$name}" . $white_space .
+ "# $description</screen>\n </para>\n";
+ $sgml_source_2{$type} .= ' -<link linkend="' . $type_uc . "-" .
+ uc($name) . "\">$type" . "{$name}</link> \\\n";
+ }
+ }
+}
-Comment lines for default.action:
+sub print_markup() {
-$comment_lines
+ my @filter_types = (
+ 'filter',
+ 'server-header-filter',
+ 'client-header-filter',
+ 'server-header-tagger',
+ 'client-header-tagger'
+ );
-Block of filter actions for standard.action:
+ foreach my $type (@filter_types) {
-$action_lines
+ next unless defined $action_lines{$type};
-SGML Source for AF chapter in U-M:
+ print "=" x 90;
+
+ print <<" DOCMARKUP";
+
+Producing $type markup:
+
+Comment lines for default.action:
+
+$comment_lines{$type}
+Block of $type actions for default.action:
-$sgml_source_1
+$action_lines{$type}
+SGML Source for AF chapter in U-M:
+$sgml_source_1{$type}
SGML Source for AF Tutorial chapter in U-M:
-$sgml_source_2
-DOCMARKUP
+$sgml_source_2{$type}
+ DOCMARKUP
+ }
+}
+
+main();