X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;ds=inline;f=build%2Fdoc-extract;h=b8751f903e88b000f21ba691e353a9c6b3270d32;hb=6cbd32307057f98fc793eaf9dc97c99c62a85a43;hp=db713095563e2b6069001871df130f1a73f0307b;hpb=c0ea84a3f0d6891bb1d0c7610de122fe4fb00cc3;p=libucw.git diff --git a/build/doc-extract b/build/doc-extract index db713095..b8751f90 100755 --- a/build/doc-extract +++ b/build/doc-extract @@ -23,22 +23,23 @@ if( defined $defdump ) { } sub detect( $ ) { - ( $_ ) = @_; - return( 'struct', 1, $1, "typedef struct { ... } $1;" ) if( /^\s*typedef\s+struct\s*{.*}\s*(\w+)\s*;\s*$/s ); - return( 'enum', 1, $1, "typedef enum { ... } $1;" ) if( /^\s*typedef\s+enum\s*{.*}\s*(\w+)\s*;\s*$/s ); - my $l = length; - s/\n.*//s; - return( 'struct', 0, $1, $_ ) if( /struct\s+(\w+)\s+{/ ); - return( 'enum', 0, $1, $_ ) if( /enum\s+(\w+)\s+{/ ); - if( $l > length ) { - warn( "Unknown statement $_\n" ); - return( '', 0, $_, $_ ); - } - return( 'def', 0, $1, $_ ) if( /#define\s+(\w+)/ ); - return( 'fun', 1, $2, $1 ) if( /^(.*?(\w+)\([^{]*\)[^{]*)/ ); - return( 'var', 1, $1, $_ ) if( /\s(\w+);/ ); - warn( "Unknown statement $_\n" ); - return( '', 0, $_, $_ ); + ( $_ ) = @_; + return( $1, 1, $2, "typedef $1 { ... } $2;" ) if /^\s*typedef\s+(struct|enum)\s*{.*}\s*(\w+)\s*;\s*$/s; + return( $1, 1, $2, $_ ) if /^\s*(struct|enum)\s+(\w+)\s*;\s*$/s; + my $l = length; + s/\n.*//s; + 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, $_, $_ ); + } + return( 'type', 1, $2, $_ ) if /^\s*typedef[^()]+?(\(\s*?\*\s*?)?(\w+)(\s*\))?\s*\(.*\)/; + return( 'fun', 1, $2, $1 ) if /^(.*?(\w+)\([^{]*\)[^{]*)/; + return( 'type', 1, $1, $_ ) if /^\s*typedef.*?(\w+);/; + return( 'var', 1, $1, $_ ) if /\s\**(\w+);/; + warn( "Unknown statement $_\n" ); + return( '', 0, $_, $_ ); } my @deps; @@ -50,25 +51,35 @@ sub formatNote( $$ ) { print OUT "\n"; print OUT "''''\n"; chomp $head; - my( $type, $semicolon, $name, $oneline ) = detect( $head ); + my( $type, $semicolon, $name, $oneline ) = detect( $head ); $oneline =~ s/\s+$//; $oneline =~ s/;?$/;/ if( $semicolon ); - $head =~ s/;?\s*$/;/ if( $semicolon ); + $head =~ s/;?\s*$/;/ if( $semicolon ); $head =~ s/(\.\.\.)/\\$1/g; print OUT "[[${type}_$name]]\n"; $head = $oneline if $type eq 'fun';#Remove { from inline functions + $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; @@ -76,9 +87,19 @@ sub process( $ ) { my $buff; my $head; my $struct; + my $def; while( defined( $line = ) ) { chomp $line; - if( $struct ) { + $line =~ s/$_\(([^()]+)\)/${_}_OPEN_PAREN_${1}_CLOSE_PAREN_/g foreach @{$prefixes}; + if( $def ) { + $head .= "\n".$line; + $line =~ s/(\/\*.*?\*\/|\/\/.*)//g; + if( $line !~ /\\\s*$/ ) { + formatNote( $head, $buff ); + $def = 0; + $buff = $head = undef; + } + } elsif( $struct ) { $head .= "\n".$line; if( $line =~ /}/ ) { formatNote( $head, $buff ); @@ -103,7 +124,10 @@ sub process( $ ) { } } else { if( ( $line =~ /\S/ ) && ( defined $buff ) ) { - if( $line =~ /\(/ || $line !~ /{/ ) { + if( $line =~ /^\s*#define.*\\(\s*(\/\/.*|\/\*.*?\*\/|))*/ ) { + $head = $line; + $def = 1; + } elsif( $line =~ /\(/ || $line !~ /{/ || $line =~ /^\s*#define/ ) { $_ = $line; s/^\s*\s?//; s/\/\/.*//; @@ -122,7 +146,7 @@ sub process( $ ) { } elsif( ( $head, $buff ) = ( $line =~ /^(.*)\/\*\*(.*)\*\*\// ) ) { $buff =~ s/^\s*//; $buff =~ s/\s*$//; - if( $head =~ /\(/ || $head !~ /{/ ) { + if( $head =~ /\(/ || $head !~ /{/ || $head =~/}/ ) { $head =~ s/^\s*//; $head =~ s/\/\*.*?\*\///gs; formatNote( $head, $buff ); @@ -144,9 +168,13 @@ sub process( $ ) { my $line; while( defined( $line = ) ) { 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";