From: Eric Hodel <drbrain@...7.net>
Date: 2009-01-30T12:29:54+09:00
Subject: Re: RDoc plain text docs with command to create an HTML table?

On Jan 29, 2009, at 08:11 AM, Martin Bernd Schmeil wrote:

> Hi all,
>
> for quite some time I'm trying to get RDoc to display an HTML table
> populated with data provided by a ruby method without success. I have
> been upgrading RDoc to 2.3.0.
>
> The doc file is a plain text file (.rb), that should describe some
> concepts (a la rails guides).
>
> While I played around with using '#'or '=begin rdoc' I neither find a
> way to get my method that provides the data evaluated nor an HTML  
> table
> displayed. Is this possible at all?
>
> Thanks in advance for any hints / references.

For a text file, a raw table is included straight up:

$ echo "<table><tr><td>1<td>2<tr><td>3<td>4</table>" > blah.txt
$ rdoc blah.txt
[...]
$ grep -A4 documentation doc/blah.txt.html
	<div id="documentation">
		<p>
<table><tr><td>1<td>2<tr><td>3<td>4</table>
</p>

For a .rb file, this should do what you want:

$ cat blah.rb
# <table>
# <tr><td>1<td>2
# <tr><td>3<td>4
# </table>
class X
end