On 08.12.2010 00:17, Greg Ercolano wrote: > I can leave IMAGEFILES, but it might not be accurate, > because I don't think it's automatically generated.
Yes, but it's the best we can do. Let's do one step after the other. I'm aware that we don't have dependencies on all the source files with doxygen comments as well, but I wouldn't want to edit /these/ manually - and I don't think it's worth the effort to try to generate them somehow. > I imagine the macro is handy for detecting if an image > is in the IMAGEFILES macro but is not on disk, so 'make' > could fail with an error. > > Thing is, I just tried removing all the src/*.gif images, > and then ran "doxygen".. no errors! Also, "make pdf-dist" > made no complaints either. 'make html' does complain though, > but only due to the missing dependency it seems. Hmm, maybe after you changed the image sources to the png files? Did the images show in the pdf file? I had this after I deleted all png files in my test environment where I had only modified fluid.dox to use png files: $ make clean pdf Generating PDF documentation ... .../fluid.dox:48: Warning: image file fluid-org.png is not found in IMAGE_PATH: assuming external image. .../fluid.dox:156: Warning: image file cubeview.png is not found in IMAGE_PATH: assuming external image. .../fluid.dox:385: Warning: image file fluid1.png is not found in IMAGE_PATH: assuming external image. .../fluid.dox:413: Warning: image file fluid2.png is not found in IMAGE_PATH: assuming external image. .../fluid.dox:441: Warning: image file fluid3-cxx.png is not found in IMAGE_PATH: assuming external image. .../fluid.dox:478: Warning: image file fluid4.png is not found in IMAGE_PATH: assuming external image. .../fluid.dox:741: Warning: image file fluid_prefs.png is not found in IMAGE_PATH: assuming external image. .../fluid.dox:891: Warning: image file fluid_widget_gui.png is not found in IMAGE_PATH: assuming external image. .../fluid.dox:1004: Warning: image file fluid_widget_style.png is not found in IMAGE_PATH: assuming external image. .../fluid.dox:1075: Warning: image file fluid_widget_cxx.png is not found in IMAGE_PATH: assuming external image. .../fluid.dox:1430: Warning: image file fluid-gettext.png is not found in IMAGE_PATH: assuming external image. .../fluid.dox:1455: Warning: image file fluid-catgets.png is not found in IMAGE_PATH: assuming external image. This is makeindex, version 2.14 [02-Oct-2002] (kpathsea + Thai support). Scanning input file refman.idx...done (0 entries accepted, 0 rejected). Nothing written in refman.ind. Transcript written in refman.ilg. Note that I shortened the lines, but they may still wrap. > This is kinda bad; doxygen and the pdf generators aren't > warning us if our docs refer to images that don't exist :/ > > We may have a few then, because we can't know if the > IMAGEFILES macro is complete unless we trawl the source > for \image commands. (I could write a perl script > that does this, but would be nice if doxygen complained) See above. This was generated using doxygen 1.5.8 on Ubuntu, BTW, but I'm still using 1.5.7 to generate the 'official' docs on the web site and in the distribution files. I intend to do another run when the images are fixed and the docs are somewhat stable, because the uploaded docs are long outdated. This will probably be the last run /before/ the 1.3.0 release (that will get another update). Which doxygen version are you using? Albrecht _______________________________________________ fltk-dev mailing list [email protected] http://lists.easysw.com/mailman/listinfo/fltk-dev
