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

Kevin Downs kevin@kdowns.com
Fri, 30 Apr 2004 11:45:44 +1000


Hold on to your enthusiasm guys...

I'm only writing a quick-and-dirty hack utility to let Mono users produce
docs using NDoc - It's not meant to be a 'production-quality' piece of
coding!

regards,
Kevin

---
"Make it idiot-proof, and someone will make a better idiot..."
   

> -----Original Message-----
> From: Rodolfo Campero [mailto:rodolfocampero@hotmail.com] 
> Sent: Friday, 30 April 2004 3:21 AM
> To: kevin@kdowns.com; gert.driesen@pandora.be; tauberer@for.net
> Cc: mono-docs-list@lists.ximian.com
> Subject: RE: [Mono-docs-list] Translator from monodoc XML 
> format to Microsoft XML format
> 
> Hello everybody,
> 
> Given the fact that Kevin is working on a command-line 
> utility to convert 
> MonoDoc->MS-XML, I consider that it will be a waste of effort 
> if I start
> coding such a tool from scratch. So in my opinion the best 
> thing to do now is just wait untill Kevin finishes its work.
> 
> Do you agree?
> 
> 
> >From: "Kevin Downs" <kdowns@optusnet.com.au>
> >Reply-To: <kevin@kdowns.com>
> >To: "'Gert Driesen'" <gert.driesen@pandora.be>,   "'Rodolfo 
> Campero'" 
> ><rodolfocampero@hotmail.com>
> >CC: <mono-docs-list@lists.ximian.com>
> >Subject: RE: [Mono-docs-list] Translator from monodoc XML format to 
> >Microsoft XML format
> >Date: Fri, 30 Apr 2004 02:24:55 +1000
> >
> >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
> > > >
> > >
> >
> 
> _________________________________________________________________
> Help STOP SPAM with the new MSN 8 and get 2 months FREE* 
> http://join.msn.com/?page=features/junkmail
>