Re: Code Documentaton

Maarten Wiltink wrote:
"Marc" <marc@xxxxxxxxxxxxxxxxxxxxxxxxxx> wrote in message
news:1213532275.18605.0@xxxxxxxxxxxxxxxxxxxxxxxxx

Rad Studio, like Visual Studio generates XML files, although they are
different in structure. This means tools such as Sandcastle doesn't
seem to like the XML generated by Rad Studio.

Can I ask what do you use to convert these comments into a nice
document?

Real Programers don't document their code... although with the years I
find myself more sympathetic to the effort at least.

So I can't exactly say that I've done precisely this, but I've had to
transform XML to similar XML, and a judicious XSLT script is just the
thing for that.

It should be said that XSLT is not easy to learn, and definitely not
easy to maintain.

Groetjes,
Maarten Wiltink



lol. Documentation sucks. Then again, going back to
something I did 3 years ago for some wierd reason and
having to research a lot of crap so that I can support
a change sucks, too.
.

Relevant Pages

  • Re: Processing XSD Files
    ... "Maarten Wiltink" wrote in message ... >> create a delphi app that reads from these files, writing records into ... >> simple define the structure of how the data is stored in the XML files. ... > .xsd sounds like XML Schema files, which are indeed descriptions of the ...
    (alt.comp.lang.borland-delphi)
  • Re: Code Documentaton
    ... This means tools such as Sandcastle doesn't ... seem to like the XML generated by Rad Studio. ... and a judicious XSLT script is just the ...
    (alt.comp.lang.borland-delphi)
  • Re: Fast XML filtering
    ... On Friday 21 November 2003 14:01, Maarten Wiltink wrote: ... > XML, then? ... You'd rather use a TXMLDocument to ensure the ... well-formedness of the document? ...
    (comp.lang.pascal.delphi.misc)
  • Re: Store a BMP in a XML Node ?
    ... <encoding a bitmap as XML> ... But you asked for XML. ... Groetjes, ... Maarten Wiltink ...
    (alt.comp.lang.borland-delphi)