[Webkit-unassigned] [Bug 54822] Web Inspector: generate protocol documentation based on IDL.

[bugzilla-daemon at webkit.org]

https://bugs.webkit.org/show_bug.cgi?id=54822





--- Comment #6 from Pavel Feldman <pfeldman at chromium.org>  2011-02-20 11:12:49 PST ---
(In reply to comment #5)
> I generate "protocol docs" for weine as well - I have some of my own IDL as well as (obviously) reuse Inspector.idl.  Rather than generate HTML, I generate JSON.  I then have some JS code which generates HTML for the protocol doc.  I reuse the same JSON in weinre as well - to generate proxies, etc.
> 
> Current version, which I think matches the current IDL, is here:
> 
>     https://github.com/pmuellr/weinre/blob/develop/weinre.build/scripts/simple-idl2json.py

IDL is extremely limited in terms of markup for documentation generation. I'd much rather have JSON as a source for both generated code and the documentation. We only use IDL for historical reasons + IDLParser is a part of the build on all ports. If we figure out how to run JavaScript in the build, we will be able to use JSON source.

-- 
Configure bugmail: https://bugs.webkit.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.