As per the discussion in https://bugs.webkit.org/show_bug.cgi?id=69325, it would be nice to have build-webkit script show warnings (if any) while generating documentation using gtk-doc. I would help to achieve 0 warning goal in generating documentation.
Immediate question which comes onto my mind, a). This would mean that 'enable-gtk-doc' will be enabled by default, and it might increase the build time. b). Should this be supported for both WebKit1-GTK and WebKit2-GTK? WebKit1 seems to be having lots of warnings already, I guess for now we should have it only for WebKit2-GTK?
(In reply to comment #1) > Immediate question which comes onto my mind, > a). This would mean that 'enable-gtk-doc' will be enabled by default, and it might increase the build time. > b). Should this be supported for both WebKit1-GTK and WebKit2-GTK? WebKit1 seems to be having lots of warnings already, I guess for now we should have it only for WebKit2-GTK? a. Yes. I think so, but perhaps we should figure out a way to not actually generate the documentation, simply report any warnings. We should take a look at what effect this has on build speed. b. Just WebKit2 for now. The WebKit1 documentaiton is full of warnings.
Created attachment 110160 [details] Doc generation logic added