| View previous topic :: View next topic |
| Author |
Message |
tamsun Guest
|
Posted: Tue Dec 27, 2005 8:08 am Post subject: how to use xml method document in Gexperts? |
|
|
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
|
Posted: Wed Dec 28, 2005 3:21 am Post subject: Re: how to use xml method document in Gexperts? |
|
|
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
|
Posted: Wed Dec 28, 2005 7:26 am Post subject: Re: how to use xml method document in Gexperts? |
|
|
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
|
Posted: Wed Dec 28, 2005 7:16 pm Post subject: Re: how to use xml method document in Gexperts? |
|
|
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
|
Posted: Thu Dec 29, 2005 1:35 am Post subject: Re: how to use xml method document in Gexperts? |
|
|
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
|
Posted: Wed Jan 04, 2006 2:50 pm Post subject: Re: how to use xml method document in Gexperts? |
|
|
Erik Berry wrote:
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
|
Posted: Wed Jan 04, 2006 10:46 pm Post subject: Re: how to use xml method document in Gexperts? |
|
|
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
|
Posted: Wed Jan 04, 2006 11:30 pm Post subject: Re: how to use xml method document in Gexperts? |
|
|
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 |
|
 |
|