dontcallmedom / widlproc Goto Github PK

widlproc parses Web IDL and converts it into an XML format

License: Apache License 2.0

Makefile 4.07% XSLT 14.55% C 81.38%

widlproc's Introduction

Uses

widlproc can be used to validate WebIDL in W3C specifications. It serves as the basis for the W3C Web IDL on-line checker.

widlproc's generated XML is used to generate webinos JavaScript APIs specifications.

License

widlproc is licensed under the Apache 2 License.

Others

See also webidl2.js, a JavaScript-based Web IDL parser used by various tools in W3C.

Credits

Most of the work on widlproc was done by Tim Renouf and Paddy Byers. Aplix corporation owns the copyright of the code up to June 2011.

The tool is kept up to date with the changes in the spec by Dominique Hazael-Massieux, through funding from the webinos project since June 2011.

Documentation

See doc/widlproc.html in the tree.

Build Instructions

Windows

Install requirements

Cygwin - must install must install libs/libxslt
Visual Studio express 2012 or 2010 (see difference below)

makefile uses cygwin make. References are coded in the make file to detect teh current version of visual studio

Future work

windows build could be improved to handle multipe versions with vcvars.bat http://stackoverflow.com/questions/62029/vs2008-command-prompt-cygwin

widlproc's People

Contributors

Stargazers

Watchers

Forkers

paddybyers mlasak nallott zivchang imclab kleopatra999 fluffy eugene70

widlproc's Issues

Unescape _-prefixed identifiers

when an identifier matches a WebIDL keyword, it needs to be prefixed by an "_" in the IDL representation; that prefix should be removed in the XML serialization

Problem validating a WebIDL that uses 'object' as an attribute name.

The following WebIDL fragment, when validated using the W3C's WebIDL checker generates an error:

[NoInterfaceObject]
interface Triple {
    readonly attribute RDFNode subject;
    readonly attribute RDFNode predicate;
    readonly attribute RDFNode object;

    stringifier DOMString toString ();
    boolean               equals (Triple otherTriple);
};

Results of checking .

The following errors were found in the extracted WebIDLs:

at 'object': expected identifier

If I change the 'object' attribute's name to something other than 'object', e.g. 'smobject' the problem goes away.

I have only recently started looking at WebIDL so I don't know if this is a problem with the definition or the validator. Is 'object' a reserved keyword?

Should validate extended attributes

I'm using http://www.w3.org/2009/07/webidl-check for checking for errors when editing specs. I noticed that it doesn't complain about extended attributes. WebIDL uses extended attributes for various features, and has requirements for how they are to be used, but this doesn't appear to be checked for in the checker.

For example, this is without errors in the checker:

interface A { [LOL] attribute any foo; };

cygwin 32bit, and through cygwin:
GNU make 3.82.90
gcc 4.7.3