Greg Ercolano wrote:
> This is kinda bad; doxygen and the pdf generators aren't
> warning us if our docs refer to images that don't exist :/
> [..]
> I'll sniff around tonight..
No flags or Doxybook settings seem to affect this.
We seem to have everything set correctly to warn about missing files.
I decided to download the source to doxygen to see how it
handles the \image tag.
Seems it might be a bug in doxygen; it seems to do a copy operation
on each image, and during the copy (using its qtools QFile class)
it seems to check for failure during the open and warn if the file
doesn't exist, but the check isn't working.
So either it's a bug in doxygen's use of its qtools QFile class,
or a problem in the class itself. (That QFile::open() method is
really complex..! Who knew opening a file would be so difficult ;)
Either way, doxygen isn't going to give us any error messages.
I made the following quick hack to check for missing \image's
in our docs. (Run from the documentation dir.) Based on this,
seems all our references to images exist:
#!/usr/bin/perl
# Check that all our '\image' references exist -erco 12/08/10
foreach my $line ( `egrep -r '\\image[ \t]*html|\\image[ \t]*latex' ../FL
../src` ) {
if ( $line =~ m%\\image\s+html\s+([a-za-z0-9...@~]*)% ) {
my $filename = "src/$1";
# print "Image: '$filename': "; # DEBUG
if ( ! -r $filename ) {
print "WARNING: $filename: $!\n";
} else {
# print "OK\n"; # DEBUG
}
}
}
Will follow up tomorrow.. too late to do anything else now
after debugging doxygen :/
_______________________________________________
fltk-dev mailing list
[email protected]
http://lists.easysw.com/mailman/listinfo/fltk-dev
