Managed C++/CLI documentation - doxygen/javadoc-like tagged comments ?

[Ivan Vecerina]

What tagged comment syntax do you use to document C++/CLI code ?

As far as I know, doxygen does not currently support C++/CLI.
Are there other/similar tools?
Does Microsoft provide an equivalent solution?
(the more XML-like syntax used in C#?)

Thanks -Ivan
--
http://ivan.vecerina.com/contact/?subject=NG_POST <- email contact form

[Carl Daniel [VC++ MVP]]

Ivan Vecerina wrote:

What tagged comment syntax do you use to document C++/CLI code ?

As far as I know, doxygen does not currently support C++/CLI.
Are there other/similar tools?
Does Microsoft provide an equivalent solution?
(the more XML-like syntax used in C#?)

You can use C#-style xml comments in C++ as well. See the /doc command line
option for the C++ compiler. I'm not sure what tools you'd use to process
the output. I don't think NDoc can handle it (and I've heard several times
that NDoc has been abandoned by it's creators). There's a new documenter
known as "Sand castle" that MSFT is working on - I think it's on gotdotnet
or something - try a quick Google search and I'm sure you'll find it.

-cd

[Tamas Demjen]

Ivan Vecerina wrote:

As far as I know, doxygen does not currently support C++/CLI.

Doc-O-Matic does (the Professional and the C++ editions support C++/CLI):
http://www.doc-o-matic.com/featurematrix.html

So far I'm very satisfied with the product, although I haven't used it
with C++/CLI extensively.

Tom

[Ben Voigt]

"Tamas Demjen" <td*****@yahoo. comwrote in message
news:uI******** ******@TK2MSFTN GP05.phx.gbl...

Ivan Vecerina wrote:

>As far as I know, doxygen does not currently support C++/CLI.

I've developed patches to doxygen for C++/CLI. I e-mailed them to the
developer before with no response, so yesterday I submitted them as a bug
report.

http://bugzilla.gnome.org/show_bug.cgi?id=364536
http://bugzilla.gnome.org/show_bug.cgi?id=364541

>
Doc-O-Matic does (the Professional and the C++ editions support C++/CLI):
http://www.doc-o-matic.com/featurematrix.html

So far I'm very satisfied with the product, although I haven't used it
with C++/CLI extensively.

Tom

[Ivan Vecerina]

"Ben Voigt" <rb*@nospam.nos pamwrote in message
news:eM******** ******@TK2MSFTN GP03.phx.gbl...
:
: "Tamas Demjen" <td*****@yahoo. comwrote in message
: news:uI******** ******@TK2MSFTN GP05.phx.gbl...
: Ivan Vecerina wrote:
: >
: >As far as I know, doxygen does not currently support C++/CLI.
:
: I've developed patches to doxygen for C++/CLI. I e-mailed them to the
: developer before with no response, so yesterday I submitted them as a
bug
: report.
:
: http://bugzilla.gnome.org/show_bug.cgi?id=364536
: http://bugzilla.gnome.org/show_bug.cgi?id=364541

This is great.
Not sure this is appropriate, but I added a comment to support
the importance of this patch. I hope it will be integrated...

Best regards,
Ivan

[Ben Voigt]

"Ivan Vecerina" <IN************ *****@ivan.vece rina.comwrote in message
news:ev******** ********@TK2MSF TNGP05.phx.gbl. ..

"Ben Voigt" <rb*@nospam.nos pamwrote in message
news:eM******** ******@TK2MSFTN GP03.phx.gbl...
:
: "Tamas Demjen" <td*****@yahoo. comwrote in message
: news:uI******** ******@TK2MSFTN GP05.phx.gbl...
: Ivan Vecerina wrote:
: >
: >As far as I know, doxygen does not currently support C++/CLI.
:
: I've developed patches to doxygen for C++/CLI. I e-mailed them to the
: developer before with no response, so yesterday I submitted them as a
bug
: report.
:
: http://bugzilla.gnome.org/show_bug.cgi?id=364536
: http://bugzilla.gnome.org/show_bug.cgi?id=364541

This is great.
Not sure this is appropriate, but I added a comment to support
the importance of this patch. I hope it will be integrated...

Well Dimitri has accepted two of my patches already, although much smaller
and not related to C++/CLI. I'm pretty hopeful though, seeing that C# is
partially supported there obviously in interest in .NET, and these patches
additionally improve treatment of ANSI C++ keywords such as static_cast.

Will you be able to recompile doxygen yourself to use the patches?

>
Best regards,
Ivan

[Ivan Vecerina]

"Ben Voigt" <rb*@nospam.nos pamwrote in message
news:eQ******** ********@TK2MSF TNGP02.phx.gbl. ..
: "Ivan Vecerina" <IN************ *****@ivan.vece rina.comwrote in
message
: news:ev******** ********@TK2MSF TNGP05.phx.gbl. ..
: "Ben Voigt" <rb*@nospam.nos pamwrote in message
: news:eM******** ******@TK2MSFTN GP03.phx.gbl...
: : I've developed patches to doxygen for C++/CLI. I e-mailed them to
the
: : developer before with no response, so yesterday I submitted them
as a
: : bug report.
: :
: : http://bugzilla.gnome.org/show_bug.cgi?id=364536
: : http://bugzilla.gnome.org/show_bug.cgi?id=364541
: >
: This is great.
: Not sure this is appropriate, but I added a comment to support
: the importance of this patch. I hope it will be integrated...
:
: Well Dimitri has accepted two of my patches already, although much
smaller
: and not related to C++/CLI. I'm pretty hopeful though, seeing that C#
is
: partially supported there obviously in interest in .NET, and these
patches
: additionally improve treatment of ANSI C++ keywords such as
static_cast.
:
: Will you be able to recompile doxygen yourself to use the patches?

I believe I would be able.
But right now I am in an early (rush) phase of a project, and it is
more a matter for me to decide/choose which documentation approach
to use. The choice of C++/CLI (mainly to be able to replace the
antiquated MFC with the more convenient/modern/supported Forms) is
itself still being debated...
As I have come to rely on doxygen in my other (pure) C++ projects,
I'm very happy to know that support for C++/CLI is happening.
But (regretfully) it is still early for me to build & test these
improvements...

I will keep an eye on this though...
--
http://ivan.vecerina.com/contact/?subject=NG_POST <- email contact form