log output: Fix of a bug introduced during cleanups

[libucw.git] / build / doc-extract

diff --git a/build/doc-extract b/build/doc-extract
index e20e7a941ce3c9b3088764a5950341c88b4885c6..67fdd64cb070ab919fe7de69cc239c8bf39ccd2f 100755 (executable)
--- a/build/doc-extract
+++ b/build/doc-extract
@@ -22,21 +22,33 @@ if( defined $defdump ) {
        $hasdump = 1;
 }
 
+# Function to guess type of statement
 sub detect( $ ) {
        ( $_ ) = @_;
+       # typedef struct|enum { something } name;
        return( $1, 1, $2, "typedef $1 { ... } $2;" ) if /^\s*typedef\s+(struct|enum)\s*{.*}\s*(\w+)\s*;\s*$/s;
+       # struct|enum name { something };
        return( $1, 1, $2, $_ ) if /^\s*(struct|enum)\s+(\w+)\s*;\s*$/s;
        my $l = length;
        s/\n.*//s;
+       # struct|enum name {
+       #   something
+       # };
        return( $1, 0, $2, $_ ) if /(struct|enum)\s+(\w+)\s+{/;
        return( 'def', 0, $1, $_ ) if /#define\s+(\w+)/;
        if( $l > length ) {
                warn( "Unknown multiline statement $_\n" );
                return( '', 0, $_, $_ );
        }
+       # typedef type (*function_type)(params);
        return( 'type', 1, $2, $_ ) if /^\s*typedef[^()]+?(\(\s*?\*\s*?)?(\w+)(\s*\))?\s*\(.*\)/;
+       # type (*function_var)(params);
+       return( 'var', 1, $1, $_ ) if /^.*?\(\*(\w+)\)\(.*\)/;
+       # type function(name);
        return( 'fun', 1, $2, $1 ) if /^(.*?(\w+)\([^{]*\)[^{]*)/;
+       # typedef something name;
        return( 'type', 1, $1, $_ ) if /^\s*typedef.*?(\w+);/;
+       # type name;
        return( 'var', 1, $1, $_ ) if /\s\**(\w+);/;
        warn( "Unknown statement $_\n" );
        return( '', 0, $_, $_ );
@@ -52,24 +64,36 @@ sub formatNote( $$ ) {
        print OUT "''''\n";
        chomp $head;
        my( $type, $semicolon, $name, $oneline ) = detect( $head );
+       # Just few transformations of the result
        $oneline =~ s/\s+$//;
        $oneline =~ s/;?$/;/ if( $semicolon );
        $head =~ s/;?\s*$/;/ if( $semicolon );
-       $head =~ s/(\.\.\.)/\\$1/g;
+       $head =~ s/(\s|,|\()(\.\.\.)/$1\\$2/g; # Do not convert tripple dot into ellipsis
        print OUT "[[${type}_$name]]\n";
        $head = $oneline if $type eq 'fun';#Remove { from inline functions
+       # Remove the generic hack markup
+       $head =~ s/_OPEN_PAREN_/(/g;
+       $head =~ s/_CLOSE_PAREN_/)/g;
        print OUT "..................\n";
        print OUT "$head\n";
        print OUT "..................\n\n";
        if( $hasdump ) {
-               print DUMP "$outname,${type}_$name,$type,$name,$oneline\n";
+               $oneline =~ s/_OPEN_PAREN_/(/g;
+               $oneline =~ s/_CLOSE_PAREN_/)/g;
+               my $symname = $type.'_'.$name;
+               $name =~ s/_OPEN_PAREN_/(/g;
+               $name =~ s/_CLOSE_PAREN_/)/g;
+               print DUMP "$outname,$symname,$type,$name,$oneline\n";
                $id ++;
        }
+       $comment =~ s/_OPEN_PAREN_/(/g;
+       $comment =~ s/_CLOSE_PAREN_/)/g;
+       $comment =~ s/_GENERIC_LINK_\|([^|]+)\|([^|]+)\|/${1}_OPEN_PAREN_${2}_CLOSE_PAREN_/g;
        print OUT "$comment\n\n";
 }
 
-sub process( $ ) {
-       my $file = shift;
+sub process( $$ ) {
+       my( $file, $prefixes ) = @_;
        open FILE, $file or die "Could nod read $file ($!)\n";
        my $line;
        my $active;
@@ -78,8 +102,11 @@ sub process( $ ) {
        my $head;
        my $struct;
        my $def;
+       my $sdepth;
        while( defined( $line = <FILE> ) ) {
                chomp $line;
+               # Generic macro hack - replaces the parenthesis so it is valid identifier
+               $line =~ s/$_\(([^()]+)\)/${_}_OPEN_PAREN_${1}_CLOSE_PAREN_/g foreach @{$prefixes};
                if( $def ) {
                        $head .= "\n".$line;
                        $line =~ s/(\/\*.*?\*\/|\/\/.*)//g;
@@ -90,7 +117,10 @@ sub process( $ ) {
                        }
                } elsif( $struct ) {
                        $head .= "\n".$line;
-                       if( $line =~ /}/ ) {
+                       my $cp = $line;
+                       $sdepth += ($cp =~ tr/{//);
+                       $sdepth -= ($cp =~ tr/}//);
+                       if( !$sdepth ) {
                                formatNote( $head, $buff );
                                $struct = 0;
                                $buff = undef;
@@ -126,12 +156,15 @@ sub process( $ ) {
                                        $buff = undef;
                                } else {
                                        $head = $line;
-                                       $struct = 1;
+                                       $struct = $sdepth = 1;
                                }
                        } elsif( ( $buff ) = ( $line =~ /\/\*\*\*(.*)\*\*\*\// ) ) {
-                               $buff =~ s/\s?//;
+                               $buff =~ s/^\s?//;
                                print OUT "$buff\n\n";
                                $buff = undef;
+                       } elsif( ( $buff ) = ( $line =~ /^\s*\/\*\*(.*)\*\*\// ) ) {
+                               $buff =~ s/^\s*//;
+                               $buff .= "\n";
                        } elsif( ( $head, $buff ) = ( $line =~ /^(.*)\/\*\*(.*)\*\*\// ) ) {
                                $buff =~ s/^\s*//;
                                $buff =~ s/\s*$//;
@@ -142,7 +175,7 @@ sub process( $ ) {
                                        $head = undef;
                                        $buff = undef;
                                } else {
-                                       $struct = 1;
+                                       $struct = $sdepth = 1;
                                }
                        } elsif( $line =~ /\/\*\*\*/ ) {
                                $verbatim = 1;
@@ -157,9 +190,13 @@ sub process( $ ) {
 my $line;
 while( defined( $line = <IN> ) ) {
        chomp $line;
-       if( my( $fname ) = ( $line =~ /^!!\s*(.*\S)/ ) ) {
+       my $prefixes;
+       if( my( $fname, $prefixes ) = ( $line =~ /^!!\s*(\S+)(.*)/ ) ) {
                $fname = "$basedir/$fname" if( ( $fname !~ /^\// ) && defined $basedir );
-               process( $fname );
+               process( $fname, [ ( map( {
+                       my( $result ) = /^\s*(.*\S)\s*$/;
+                       $result;
+               } ( split /,/, $prefixes ) ) ) ] );
                push @deps, $fname;
        } else {
                print OUT "$line\n";