On 12/27/2015 06:29 PM, Gerald Nunn wrote:

On Fri, 25 Dec 2015 11:29:03 +0100, Mike Wey wrote:

ddox also hangs when you are using serve-html and try to access
gdk.Window.Window.

One problem seems to be the “ and ” characters in the comments, but
there are more issues it hangs on.

The problem appears to be unicode in general, ddox does a lot of character parsing of the comments in order to create links between various entities and I suspect that the multi-byte unicode characters in UTF-8 are screwing it up. I updated the script to convert unicode double and single quotes to their ASCII equivalents and then run the rest through iconv for everything else to generate an ASCII docs.json. This then works fine with ddox and it can successfully generate documentation for all classes. A quick look through the generated docs look fine to me from a readability point of view, I don't see any obvious problems but I suspect Mike you'd be in a better position to know where the problem areas are likely to be.

The updated script is below. Mike I'd be willing to put some additional effort into modifying the ddox diet templates that generate the pages to try to optimize them for GtkD but is using ddox something the project would be willing to consider? I don't want to invest a bunch of effort in this if it's a non-starter for GtkD.

I've added some sed commands to fix the documentation for gtk.Widget and
gtk.Builder. And added the script to the GtkD repository.