[Mono-docs-list] Translator from monodoc XML format to Microsoft XML format

[Kevin Downs]

At present, all I'm doing is knocking together a quick command-line utility
to convert MonoDoc->MS-XML. Eventually this will be rolled into Ndoc core;
MonoDocs will become a 'native' format and users will be able to freely mix
whichever format they have at hand :)

There are some complications. The most notable is that MS-XML covers a whole
assembly in one file whereas (from what I've seen) MonoDocs are split by
Type.

The MonoDoc format is less complex than the NDoc internal XML, so creating a
MonoDoc documenter should not be a major issue. The only part that would be
complex is the ILASM and C# signatures; This is one of the most complex
parts in the current documenters' xslt - for the next major release I am
looking to provide a much cleaner mechanism.

regards,
Kevin

---
"Never attribute to malice that which can be adequately explained by
stupidity"
  

> -----Original Message-----
> From: Gert Driesen [mailto:gert.driesen@pandora.be] 
> Sent: Thursday, 29 April 2004 11:57 PM
> To: Rodolfo Campero; mono-docs-list@lists.ximian.com
> Cc: kdowns@users.sourceforge.net
> Subject: Re: [Mono-docs-list] Translator from monodoc XML 
> format to Microsoft XML format
> 
> Hi,
> 
> Kevin Downs (NDoc team) has already started working on an 
> NDoc documenter that will convert MS XML format to Monodoc.  
> It would be great if the conversion from Monodoc (ECMA) to MS 
> XML format could be implemented as an NDoc documenter too.
> 
> Gert
> ----- Original Message -----
> From: "Rodolfo Campero" <rodolfocampero@hotmail.com>
> To: <mono-docs-list@lists.ximian.com>
> Sent: Thursday, April 29, 2004 3:45 PM
> Subject: [Mono-docs-list] Translator from monodoc XML format 
> to Microsoft XML format
> 
> 
> > FYI
> >
> >
> > >From: "Rodolfo Campero" <rodolfocampero@hotmail.com>
> > >To: tauberer@for.net
> > >CC: xiii29@free.fr, 
> > >mono-list@lists.ximian.com,gellyfish@gellyfish.com,
> > >mono-docs-lists@lists.ximian.com
> > >Subject: Re: [Mono-list] Question about attributes
> > >Date: Thu, 29 Apr 2004 13:37:28 +0000
> > >
> > >Hi Joshua,
> > >I already know XSLT, so I will give it a shot this afternoon (it's 
> > >10:30
> am
> > >here in Argentina, I will start working on it at 19:00).
> > >Also I will subscribe to mono-docs-list right now, so I will posts 
> > >questions there if I have to.
> > >I would like to know who should I refer to when I get something 
> > >usable,
> in
> > >order to make it part of mono or monodoc.
> > >Best regards,
> > >Rodolfo
> > >
> > >
> > >>From: Joshua Tauberer <tauberer@for.net>
> > >>To: Rodolfo Campero <rodolfocampero@hotmail.com>
> > >>CC: xiii29@free.fr, mono-list@lists.ximian.com, 
> > >>gellyfish@gellyfish.com
> > >>Subject: Re: [Mono-list] Question about attributes
> > >>Date: Thu, 29 Apr 2004 09:21:26 -0400
> > >>
> > >>Rodolfo Campero wrote:
> > >>>I don't know if there is some effort to create a translator from 
> > >>>monodoc XML format to Microsoft XML documentation format. That 
> > >>>would be nice, because one could use NDoc to generate files for 
> > >>>Windows users.
> > >>>
> > >>>Does anyone knows about such a tool?
> > >>
> > >>Since this has come up so many times, I'll work on it 
> when I get the 
> > >>chance.  (As I keep repeating on the docs list, the two 
> formats are 
> > >>so similar that it would be trivial for anyone to learn XSLT, if 
> > >>necessary, and write the conversion themselves if they 
> wanted it.  
> > >>It would also
> make
> > >>a nice project if someone is looking for a way to contribute to 
> > >>Mono.)
> > >>
> > >>--
> > >>- Joshua Tauberer
> > >>
> > >>http://taubz.for.net
> > >>
> > >>** Nothing Unreal Exists **
> > >
> > >_________________________________________________________________
> > >Protect your PC - get McAfee.com VirusScan Online
> > >http://clinic.mcafee.com/clinic/ibuy/campaign.asp?cid=3963
> > >
> > >_______________________________________________
> > >Mono-list maillist  -  Mono-list@lists.ximian.com 
> > >http://lists.ximian.com/mailman/listinfo/mono-list
> >
> > _________________________________________________________________
> > The new MSN 8: advanced junk mail protection and 2 months FREE* 
> > http://join.msn.com/?page=features/junkmail
> >
> > _______________________________________________
> > Mono-docs-list maillist  -  Mono-docs-list@lists.ximian.com 
> > http://lists.ximian.com/mailman/listinfo/mono-docs-list
> >
>