X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/bac023bb1c1ebfc6909be7f4c1fd4927949eda1c..9db05dd3962f9900e071710579fea38c5acd4d2e:/tools/doxygen/xbt_log_extract_hierarchy.pl diff --git a/tools/doxygen/xbt_log_extract_hierarchy.pl b/tools/doxygen/xbt_log_extract_hierarchy.pl index f61b020ed3..01447433f5 100755 --- a/tools/doxygen/xbt_log_extract_hierarchy.pl +++ b/tools/doxygen/xbt_log_extract_hierarchy.pl @@ -1,4 +1,10 @@ -#!/usr/bin/perl +#!/usr/bin/env perl + +# Copyright (c) 2008, 2010, 2012-2014. The SimGrid Team. +# All rights reserved. + +# This program is free software; you can redistribute it and/or modify it +# under the terms of the license (GNU LGPL) which comes with this package. use strict; use warnings; @@ -12,15 +18,12 @@ print " \@{\n"; # Search for calls to macros defining new channels, and prepare the tree representation my %ancestor; my %desc; -# $ancestor{"toto"} is the ancestor of the toto channel -# as declared by XBT_LOG_NEW_SUBCATEGORY and XBT_LOG_NEW_DEFAULT_SUBCATEGORY -# ie, when the channel toto is initialized (does not work under windows) +# $ancestor{"toto"} is the ancestor of the toto channel as declared by XBT_LOG_NEW_SUBCATEGORY and +# XBT_LOG_NEW_DEFAULT_SUBCATEGORY ie, when the channel toto is initialized (does not work under windows) # $desc{"toto"} is its description -my %c_ancestor; -# $c_ancestor{"toto"} is the ancestor of the toto channel, as declared by XBT_LOG_CONNECT -# ie, in a initialization function (only way to do so under windows) -# we want $ancestor{"toto"} == $c_ancestor{"toto"} for each toto, or bad things will happen under windows +my %connected; +# $connected{"toto"} is defined if XBT_LOG_CONNECT("toto") is used sub cleanup_ctn { my $ctn = shift; # cleanup the content of a macro call @@ -44,12 +47,11 @@ sub cleanup_ctn { return @elms; } - sub parse_file { my $filename = shift; - + my $data = ""; - + print "Parse $filename\n" if $debug; open IN, "$filename" || die "Cannot read $filename: $!\n"; while () { @@ -65,45 +67,39 @@ sub parse_file { my $connect_data = $data; # save a copy for second parsing phase while ($data =~ s/^.*?XBT_LOG_NEW(_DEFAULT)?_(SUB)?CATEGORY\(//s) { - $data =~ s/([^"]*"[^"]*")\)//s || die "unparsable macro: $data"; # ]]); - + $data =~ s/([^"]*"[^"]*")\)//s || die "unparsable macro: $data"; + my ($name,$anc,$desc) = cleanup_ctn($1); - + # build the tree, checking for name conflict die "ERROR: Category name conflict: $name used several times (in $ancestor{$name} and $anc, last time in $filename)\n" - if defined ($ancestor{$name}) && $ancestor{$name} ne $anc && - defined ($desc{$name}) && $desc{$name} ne $desc; + if defined ($ancestor{$name}) && $ancestor{$name} ne $anc && defined ($desc{$name}) && $desc{$name} ne $desc; $ancestor{$name}=$anc; $desc{$name}=$desc; - + print " $name -> $anc\n" if $debug; } # Now, look for XBT_LOG_CONNECT calls $data = $connect_data; while ($data =~ s/^.*?XBT_LOG_CONNECT\(//s) { - - $data =~ s/([^\)]*)\)//s || die "unparsable macro: $data"; # ]]); - my ($name, $ignoreme, $anc) = cleanup_ctn($1); - - # build the tree, checking for name conflict - $c_ancestor{$name}=$anc; - - print STDERR " $name -> $anc\n" if $debug; + $data =~ s/\s*(\w+)\s*\)//s || die "unparsable macro: $data"; + $connected{$1} = 1; } } # Retrieve all the file names, and add their content to $data my $data; -open FILES, "find src/ tools/ include/ -name '*.c'|" || die "Cannot search for the source file names: $!\n"; +open FILES, "find ../src/ ../tools/ ../include/ -name '*.c' -o -name '*.cpp' |" || die "Cannot search for the source file names: $!\n"; while (my $file=) { chomp $file; parse_file($file); } +parse_file("../include/xbt/sysdep.h"); close FILES; # Display the tree, looking for disconnected elems my %used; - + sub display_subtree { my $name=shift; my $indent=shift; @@ -116,23 +112,14 @@ sub display_subtree { display_subtree($cat,"$indent "); } } - + display_subtree("XBT_LOG_ROOT_CAT",""); -sub check_connection { - my $name=shift; - - foreach my $cat (grep {$ancestor{$_} eq $name} sort keys %ancestor) { - unless ($ancestor{$cat} eq "XBT_LOG_ROOT_CAT" || (defined($c_ancestor{$cat}) && $c_ancestor{$cat} eq $name)) { - warn "Category $cat will be disconnected under windows. Add the following to an initialization function:\n XBT_LOG_CONNECT($cat, $ancestor{$cat});\n"; - } else { - warn "Correctly connected, even under windows: Category $cat.\n" if $debug; - } - check_connection($cat); - } -} -check_connection("XBT_LOG_ROOT_CAT"); -map {warn "Category $_ does not seem to be connected to the root (anc=$ancestor{$_})\n";} grep {!defined $used{$_}} sort keys %ancestor; +map { + warn "Category $_ does not seem to be connected. Use XBT_LOG_CONNECT($_).\n"; +} grep {!defined $connected{$_}} sort keys %ancestor; +map { + warn "Category $_ does not seem to be connected to the root (anc=$ancestor{$_})\n"; +} grep {!defined $used{$_}} sort keys %ancestor; - -print "@}*/"; +print "@}*/\n";