RE: Problems with templates ???

Hi Serge,

> From: Serge Iovleff [mailto:[email protected]]

> Hi Stefan,
> All the class appears now in the documentation but...

good, so we are getting closer...

> not the JavaComments nor the Previous comments,

I'm afraid you have to understand a little what those comment
processors are doing. They are not idempotent, as they modify
the text. Some are even mutually exclusive, so using them
together will leave nothing. For example 'JavaComments' searches
for '/** ... */', stripping off the beginning '/**' as well as 
the ending '*/'. 'SSComments', in contrast, selects comments
that start with '//' and strips that off. If you use both of them
you obviously won't see *any* comments, unless you use '/** // ... */'

As you already use a split into parse, link, and formatting, I'd
suggest you only apply the comment processors to the link stage.
In particular, I'd suggest you use a line such as

synopsis -l JavaComments,Previous,CommentStripper,Summarizer,JavaTags -o
$(STK_TCONT_SYNDOC) $(INC_DOCS)

for the linker.

Another problem is with your code. You generally use
javacomment style, but the members use 'ss' style, i.e. '//< the docs',
instead of '/**< the docs */'.

Also, if you use multiple comment blocks, as in

/* one */
/* second */
class Foo;

only the last block ('second') will be used.

> the Inheritance Graph is wrong,
> 
> and the path of the files too...

could you be a bit more specific ?

Regards,
		Stefan