- From: Eliot Graff <Eliot.Graff@microsoft.com>
- Date: Fri, 26 Oct 2012 18:23:49 +0000
- To: "spec-prod@w3.org" <spec-prod@w3.org>
- Message-ID: <CE3A5BFD1228D84A8D9C158EEC195FD53D9CE138@TK5EX14MBXW602.wingroup.windeploy.ntde>
Hi All.
I am having a heck of a time getting exceptions to render using ReSpec.
I see some content about exceptions in Robin's documentation [1], but I don't see any examples that actually generate a name and description on an exception that is on a method, say. I am trying to replicate something along the lines of the exception table for IndexedDB's cmp() method [2].
If I use the sample from the earlier documentation [3]:
<dl class="idl" title="interface EliotReader : EventTarget">
<dt>void raising ()</dt>
<dd>
This is an example of a method that raises an exception.
<div class='exception' title='BoomBoomBoomBoom'>
This is an exception that is raised as a whole, for a reason but without specific codes
being mentioned.
</div>
</dd>
<dt>void raising2 ()</dt>
<dd>
This is an example of a method that raises another exception.
<dl class='exception' title='ImSoExceptional'>
<dt>TOO_SEXY_ERR</dt>
<dd>
Raised whenever I walk out the door.
</dd>
<dt>COOL_FROOD_ERR</dt>
<dd>
Not a club you can buy your way into.
</dd>
</dl>
</dd>
<dt>void complexRaising2 ()</dt>
<dd>
This is an example of a method that does a bunch of things.
<dl class='exception' title='ImSoExceptional'>
<dt>TOO_SEXY_ERR</dt>
<dd>
Raised whenever I walk out the door.
</dd>
<dt>COOL_FROOD_ERR</dt>
<dd>
Not a club you can buy your way into.
And we add a lot of text to see it all wrap. And we add a lot of text to see it all wrap.
And we add a lot of text to see it all wrap. And we add a lot of text to see it all wrap.
</dd>
</dl>
<dl class='parameters'>
<dt>[Optional, TreastAsNull] unsigned short another</dt>
<dd>
This is another parameter, more complex. And we add a lot of text to see it all wrap.
And we add a lot of text to see it all wrap. And we add a lot of text to see it all wrap.
And we add a lot of text to see it all wrap. And we add a lot of text to see it all wrap.
</dd>
</dl>
<div class='exception' title='JustForYouException'>
This is an exception that is raised as a whole, for a reason but without specific codes
being mentioned.
And we add a lot of text to see it all wrap. And we add a lot of text to see it all wrap.
And we add a lot of text to see it all wrap. And we add a lot of text to see it all wrap.
</div>
</dd>
</dl>
The words show up, but they're plain text, in <dt><dd> pairs, rather than in a table as the parameters in the same methods get generated into tables. Is this a known issue, am I doing something wrong?
Thanks,
Eliot
[1] http://darobin.github.com/respec/docs
[2] http://dvcs.w3.org/hg/IndexedDB/raw-file/tip/Overview.html#widl-IDBFactory-cmp-short-any-first-any-second
[3] http://dev.w3.org/2009/dap/ReSpec.js/test-spec/webidl.html#exception-raising
Received on Friday, 26 October 2012 18:25:02 UTC