[Mono-list] Monodoc -- Can we use this to document our application?

Giuseppe Greco giuseppe.greco@agamura.com
Fri, 1 Oct 2004 07:40:19 +0200 (CEST)


Here's a discussion I had with Miguel some time ago:
http://lists.ximian.com/archives/public/mono-list/2003-July/014938.html

I personally use monodoc to produce documentation, and since there is
no support for monodoc in NAnt, I actually relay on a <exec> task that
invokes assembler.exe...

j3d.

>
> ----- Original Message -----
> From: "Ian MacLean" <ianm@ActiveState.com>
> To: "Joshua Tauberer" <tauberer@for.net>
> Cc: "rus" <rus@forgecom.co.uk>; <mono-list@lists.ximian.com>
> Sent: Friday, October 01, 2004 8:06 AM
> Subject: Re: [Mono-list] Monodoc -- Can we use this to document our
> application?
>
>
>> Joshua Tauberer wrote:
>>
>>> rus wrote:
>>>
>>>> On a related note, I was just wondering.. is there any way of using
>>>> NDoc
>>>> to generate monodoc documentation?
>>>
>>>
>>> No, but as I often say, the documentation formats are pretty close.  If
>>> you want that functionality, making a converter should be possible, and
>>> not too difficult.
>>>
>> This is probably better implemented as an ndoc Documenter [1]. These are
>> plugin classes that generate a given output format from ndocs xml format
>> ( which is basically MS's xml format - the one that gets generated by
>> the
>> /doc argument to csc ). Current documenters include:
>> - plain xml
>> - MSDN format
>> - javadoc format
>> - LaTex
>>
>> writing a documenter that generates monodoc format woudl be fairly easy
>> -
>> and may even be as easy as hosting an xslt transform. THe documenter
>> implementation is also quite straight forward - we wrote one for NAnt to
>> auto-generate the end user doc for tasks.
>>
>> However the other thing thats missing is the implementation of the /doc
>> arg for mcs.exe. Otherwise there will be no input for ndoc to use. I
>> know
>> Atsushi submitted a patch a while back - did that ever get committed ?
>
> Nope, it caused some regressions, and Atsushi didn't have time to create a
> new patch yet.
>
> Regardless of that, it would also be useful to support the Monodoc/ECMA
> format as input in NDoc (and not just the MS /doc format).
>
> Gert
>
> _______________________________________________
> Mono-list maillist  -  Mono-list@lists.ximian.com
> http://lists.ximian.com/mailman/listinfo/mono-list
>


----------------------------------------
Giuseppe Greco

::agamura::

phone:  +41 (0)91 604 67 65
mobile: +41 (0)76 390 60 32
email:  giuseppe.greco@agamura.com
web:    www.agamura.com
----------------------------------------