GNOME Bugzilla – Bug 136396
Patching docs/reference/Makefile.am
Last modified: 2004-12-22 21:47:04 UTC
This patch tries to improve the behavior of "make doxygen-warnings". The target doxygen-warnings now builds upon the standard procedure so that it uses advanced techniques too. Theses are: IMAGE_PATH - to support stock-images in the documentation installdox - to support glibmm documentation inside beautify_docs - to align '*'s and '&'s to the type With this patch it should be possible to compare standard documentation and documentation build with doxygen-warnings using diff. Additionally it splits the output of doxygen into output and warnings, which saves you from searching errors in the doxygen-warnings.txt file. Now, there are ONLY warnings/errors. The patch adds two targets (using the same technnique): "doxygen-silent" - to allow a completely muted build of the documentation. "doxygen-no-warnings" - to allow a build of the documentation without any errors or warnings in the output These are just to demonstrate the technique. They have no practical use atm.
Created attachment 25271 [details] [review] docs/reference/Makefile.am update.
I don't see the value of this because the extra steps don't produce any useful information, but it's harmless. I have removed the useless targets. Of course, I'd prefer to just have this output saved every time we build the docs, without building the docs twice. > With this patch it should be possible to compare standard documentation and > documentation build with doxygen-warnings using diff. If they now use the same commands, won't the output be exactly the same? Committed. Thanks. Please use a more information bug title in future.
Created attachment 25282 [details] [review] updated version including .cvsignore
tee has a bit of strange behavior: it buffers. This makes the output jumpy, consider this before commiting. But as you say: only a few ppl will see this and I don't know if they care.
This is really good. Now people will always have the list of warnings too look at. Well done and thanks.