build/doc-defs

   1 #!/usr/bin/perl
   2 # Script for formatting documentation from definition lists
   3 # (they get out of extract-doc.pl as a side-product).
   4 # (c) 2008 Michal Vaner <vorner@ucw.cz>
   5 use strict;
   6 use warnings;
   7
   8 my $head = shift;
   9 my $out = shift;
  10
  11 open OUT, ">$out" or die "Could not write output $out ($!)\n";
  12 open HEAD, $head or die "Could not open head $head ($!)\n";
  13 print OUT foreach( <HEAD> );
  14 close HEAD;
  15
  16 my $dir = $out;
  17 $dir =~ s/\/[^\/]+$//;
  18
  19 my @dump;
  20
  21 while( defined( my $line = <> ) ) {
  22         chomp $line;
  23         push @dump, [ split /,/, $line, 5 ];
  24 }
  25
  26 foreach( sort { $a->[3] cmp $b->[3]; } @dump ) {
  27         my( $file, $num, $type, $name, $text ) = @{$_};
  28         my $dircp = $dir;
  29         while( shift @{[ $dircp =~ /([^\/]+)/, "//" ]} eq shift @{[ $file =~ /([^\/]+)/, "///" ]} ) {
  30                 $dircp =~ s/[^\/]+\/?//;
  31                 $file =~ s/[^\/]+\/?//;
  32         }
  33         $dircp =~ s/[^\/]+/../g;
  34         $file = $dircp."/".$file;
  35         $file =~ s/^\///;
  36         $file =~ s/\.[^.]+$//;
  37         $text =~ s/\(/!!PARENT_OPEN!!/g;
  38         print OUT "- <<$file:auto_$num,`$text`>>\n";
  39 }
  40
  41 close OUT;