[Mono-list] Why doesn't mcs generate XML documentation?

[Jonathan Pryor]

The `-doc' compiler flag hasn't been implemented yet.  I remember some
patches posted to the list many months ago to start implementing it, but
XML Documentation functionality was never finished, IIRC.

It's not likely to get finished soon, either, as other things appear to
have higher priority.

I am also not aware of an hcc.exe equivalent for linux.  Sorry.

 - Jon

On Fri, 2003-07-11 at 11:35, Giuseppe Greco wrote:
> Hi all,
> 
> why doesn't mcs generate XML documentation?
> 
> The following command just generates mytest.dll:
> 
>   mcs -t:library -doc:mytest.xml *.cs -out:mytest.dll
> 
> I use standard documentation comments like these:
> /// <summary>
> /// bla bla
> /// </summary>
> /// <param name="param1">
> /// bla bla
> /// </param>
> /// <remarks>
> /// bla bla
> /// </remarks>
> 
> Then, another question: We are porting some .NET projects to 
> Mono on Linux (we intend to use Mono as our standard development
> framework), and I would like to know how can I generate
> documentation like the one generated by hcc.exe on Windows
> (hcc.exe generates either compiled or HTML documentation from
> the XML files generated by csc.exe when the "-doc" option is
> specified).
> 
> Is there something similar to hcc.exe (Help Compiler Workshop)
> for linux?
> 
> Thanks,
> 
> Gius_.