Wrong transform of eunit docs from edoc to html
Tuncer Ayaz
tuncer.ayaz@REDACTED
Sun Jul 25 16:14:06 CEST 2010
Part of lib/eunit/doc/overview.edoc happens to be transformed into
mis-formatted html. Is this a problem in the edoc source or the
transformation process?
Is this a problem in xsltproc, edoc, or the edoc sources?
The following source from lib/eunit/doc/overview.edoc
--->8---
To make the descriptions simpler, we first list some definitions:
<center>
<table border="0" cellspacing="4">
<tr>
<td>`Setup'</td><td>`() -> (R::any())'</td>
</tr>
<tr>
<td>`SetupX'</td><td>`(X::any()) -> (R::any())'</td>
</tr>
<tr>
<td>`Cleanup'</td><td>`(R::any()) -> any()'</td>
</tr>
<tr>
<td>`CleanupX'</td><td>`(X::any(), R::any()) -> any()'</td>
</tr>
<tr>
<td>`Instantiator'</td><td>`((R::any()) -> Tests) | {with,
[AbstractTestFun::((any()) -> any())]}'</td>
</tr>
<tr>
<td>`Where'</td><td>`local | spawn | {spawn, Node::atom()}'</td>
</tr>
</table>
</center>
(these are explained in more detail further below.)
--->8---
is transformed into the ill-formatted HTML
---8<---
<p>To make the descriptions simpler, we first list some definitions:
<strong>
Setup() -> (R::any())
SetupX(X::any()) -> (R::any())
Cleanup(R::any()) -> any()
CleanupX(X::any(), R::any()) -> any()
Instantiator((R::any()) -> Tests) | {with,
[AbstractTestFun::((any()) -> any())]}
Wherelocal | spawn | {spawn, Node::atom()}
</strong>
(these are explained in more detail further below.)</p>
--->8---
This is harder to read and also contains the faulty string 'Wherelocal'.
I think it should be rather transformed into something like:
---8<---
<p>To make the descriptions simpler, we first list some definitions:
<pre>
Setup() -> (R::any())
SetupX(X::any()) -> (R::any())
Cleanup(R::any()) -> any()
CleanupX(X::any(), R::any()) -> any()
Instantiator((R::any()) -> Tests | {with,
[AbstractTestFun::((any()) -> any())]}
Where local | spawn | {spawn, Node::atom()}
</pre>
(these are explained in more detail further below.)</p>
--->8---
More information about the erlang-bugs
mailing list