[Fwd: Re: [xsd-users] Using Doxygen on the generated code]

[Kroizman Guy]

I get a lot of messages of that sort for example:

C:/hdx/HyperRoll-Application.hxx:1122: Warning: Found ';' while parsing
initializer list! (doxygen could be confused by a macro call without
semicolon)

C:/hdx/hdx.h:76: Warning: Member ColumnTypes (enumeration) of class
hdxns::Hdx is not documented.

C:/hdx/HyperRoll-Application.hxx:79: Warning: Member simple_type
(typedef) of namespace xml_schema is not documented.


What gets generated is my namespace (hdxns) with a lot of functions of
type:
void operator<<( all sort of things )

no sign for all the elements/classes defined in my scheme.
no class diagram but probably cause nothing much gets generated.

when I run Doxygen on one of the code synthesis examples everything look
good.

On Wed, 2007-08-29 at 12:01 +0200, Boris Kolpackov wrote:
> Hi Guy,
> 
> Kroizman Guy <kroiz at hyperroll.com> writes:
> 
> > Has anybody had any success creating documentation using Doxygen?
> 
> Yes, I've generated documentation for several fairly large schemas.
> There is also sample documentation for the hello example:
> 
> http://www.codesynthesis.com/projects/xsd/documentation/cxx/tree/guide/doxygen/classhello__t.html
> 
> > I get a lot of warning and in the end not much gets generated.
> 
> Warnings are expected since some internal functions are left
> undocumented. We will try to get rid of the warning for the
> next version of XSD. What do you mean by "not much gets
> generated"? Does your documentation look similar to the sample
> above?
> 
> 
> > I am especially interested in creating classes diagram.
> 
> I believe you need to install graphviz[1] and enable graph drawing
> by setting HAVE_DOT to yes in your Doxygen configuration file.
> 
> [1] http://www.graphviz.org/
> 
> See the Doxygen documentation for more information on all this.
> 
> 
> -Boris