BorlandTalk.com Forum Index BorlandTalk.com
Borland discussion newsgroups
 
Archives   FAQFAQ   SearchSearch   MemberlistMemberlist   UsergroupsUsergroups   RegisterRegister 
 ProfileProfile   Log in to check your private messagesLog in to check your private messages   Log inLog in 

how to use xml method document in Gexperts?

 
Post new topic   Reply to topic    BorlandTalk.com Forum Index -> Delphi Thirdparty Tools (General)
View previous topic :: View next topic  
Author Message
tamsun
Guest





PostPosted: Tue Dec 27, 2005 8:08 am    Post subject: how to use xml method document in Gexperts? Reply with quote



I use Delphi7 + Gexperts. There is xdoc(xml method document) macro template
in Gexperts. I know that we can export that comment format to help file
directly. But I don't know which tool can do this.

Can anyone tell me something? thanks first.


Back to top
Erik Berry
Guest





PostPosted: Wed Dec 28, 2005 3:21 am    Post subject: Re: how to use xml method document in Gexperts? Reply with quote



tamsun wrote:
Quote:
I use Delphi7 + Gexperts. There is xdoc(xml method document) macro template
in Gexperts. I know that we can export that comment format to help file
directly. But I don't know which tool can do this.

For the D8-D2006 command line compilers, "dcc32 --doc" should generate
an XML file. There is an equivalent IDE project option in the GUI. You
should be able to use http://ndoc.sourceforge.net/ or your own XSLT
transform to make a help file from the XML.

Good luck,
Erik

Back to top
tamsun
Guest





PostPosted: Wed Dec 28, 2005 7:26 am    Post subject: Re: how to use xml method document in Gexperts? Reply with quote



thank you for your reply.
I have downloaded NDoc. But I find it is for Vs.net project. I really don't
know how to use it on Delphi7 project.


"Erik Berry" <eb (AT) techie (DOT) ZZZcom> wrote

Quote:
tamsun wrote:
I use Delphi7 + Gexperts. There is xdoc(xml method document) macro
template in Gexperts. I know that we can export that comment format to
help file directly. But I don't know which tool can do this.

For the D8-D2006 command line compilers, "dcc32 --doc" should generate
an XML file. There is an equivalent IDE project option in the GUI. You
should be able to use http://ndoc.sourceforge.net/ or your own XSLT
transform to make a help file from the XML.

Good luck,
Erik



Back to top
Erik Berry
Guest





PostPosted: Wed Dec 28, 2005 7:16 pm    Post subject: Re: how to use xml method document in Gexperts? Reply with quote

tamsun wrote:
Quote:
thank you for your reply.
I have downloaded NDoc. But I find it is for Vs.net project. I really don't
know how to use it on Delphi7 project.

NDoc is not VS.Net specific, since it works with any .NET assembly, but
Delphi 7 does not support .NET or XML documentation, as I mentioned. You
need to upgrade to a newer Delphi release to get a new compiler that
generates the xml documentation, or use a tool like GenHelp Pro, which
might be able to read XML comments directly from the source.

Good luck,
Erik

Back to top
tamsun
Guest





PostPosted: Thu Dec 29, 2005 1:35 am    Post subject: Re: how to use xml method document in Gexperts? Reply with quote

I see.
you are so kind. thank you very much.

"Erik Berry" <eb (AT) techie (DOT) ZZZcom> wrote

Quote:
tamsun wrote:
thank you for your reply.
I have downloaded NDoc. But I find it is for Vs.net project. I really
don't know how to use it on Delphi7 project.

NDoc is not VS.Net specific, since it works with any .NET assembly, but
Delphi 7 does not support .NET or XML documentation, as I mentioned. You
need to upgrade to a newer Delphi release to get a new compiler that
generates the xml documentation, or use a tool like GenHelp Pro, which
might be able to read XML comments directly from the source.

Good luck,
Erik



Back to top
Nick Hodges [TeamB]
Guest





PostPosted: Wed Jan 04, 2006 2:50 pm    Post subject: Re: how to use xml method document in Gexperts? Reply with quote

Erik Berry wrote:

Quote:
You should be able to use http://ndoc.sourceforge.net/ or your own
XSLT transform to make a help file from the XML.

Sadly, this is not the case. The --doc switch produces XML that is not
compatible with nDoc. That's a real bummer.

--
Nick Hodges -- TeamB
Dunn Solutions Group -- http://www.dunnsolutions.com
Read my Blog -- http://www.lemanix.com/nickblog

Back to top
Nick Hodges [TeamB]
Guest





PostPosted: Wed Jan 04, 2006 10:46 pm    Post subject: Re: how to use xml method document in Gexperts? Reply with quote

Erik Berry wrote:

Quote:
GenHelp and similar tools might be the best option if one doesn't
want to transform the XML manually using XSLT, etc.

Yes, GenHelp does a a great job.

The better solution is to have the Delphi compiler produce compatible
XML, or for there to be an applet that transforms what the dccil
compiler does produce into something that NDoc can consume. There was
an effort afoot to do that latter, but I don't know it's status.

--
Nick Hodges -- TeamB
Dunn Solutions Group -- http://www.dunnsolutions.com
Read my Blog -- http://www.lemanix.com/nickblog

Back to top
Erik Berry
Guest





PostPosted: Wed Jan 04, 2006 11:30 pm    Post subject: Re: how to use xml method document in Gexperts? Reply with quote

Nick Hodges [TeamB] wrote:
Quote:
Sadly, this is not the case. The --doc switch produces XML that is not
compatible with nDoc. That's a real bummer.

You are probably right. The last time I used the XML feature with nDoc
was probably in C#Builder 1, which had a completely different XML
generation system, of course. GenHelp and similar tools might be the best
option if one doesn't want to transform the XML manually using XSLT, etc.

Erik

Back to top
Display posts from previous:   
Post new topic   Reply to topic    BorlandTalk.com Forum Index -> Delphi Thirdparty Tools (General) All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum


Powered by phpBB © 2001, 2006 phpBB Group
SEO toolkit © 2004-2006 webmedic.