Wrong transform of eunit docs from edoc to html

Tuncer Ayaz <>
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