I wrote:

> The following example, is taken from the rdoc documentation.
> For the long options, it converts -- into  — (a long hyphen)
> instead of two separate hyphens with some whitespace in between.
> (see www.servalys.nl/ doc/index.html for the output)
> 
> =begin rdoc
> 
> <tt>--output</tt> <i>name [, name]</i>::
>     specify the name of one or more output files. If multiple
>     files are present, the first is used as the index.
> 
> <tt>--quiet:</tt>:: do not output the names, sizes, byte counts,
>                     index areas, or bit ratios of units as
>                     they are processed.
> 
> =end

now if one runs rdoc on a file containing only the range of lines 
between =begin and =end, this generates html as expected. But anything 
other than a shebang line in front spoils this. In this case, the 
following text produces an empty html-page:

puts "this is a test"

=begin rdoc

<tt>--output</tt> <i>name [, name]</i>::
     specify the name of one or more output files. If multiple
     files are present, the first is used as the index.

<tt>--quiet:</tt>:: do not output the names, sizes, byte counts,
                     index areas, or bit ratios of units as
                     they are processed.

=end


-- 
Wybo