Bug 122343

Summary:	c++ code generated without rdoc comments using new code generator
Product:	[Applications] umbrello	Reporter:	Christoph Hoeger <choeger>
Component:	general	Assignee:	Umbrello Development Group <umbrello-devel>
Status:	REPORTED ---
Severity:	normal	CC:	ralf.habacker
Priority:	NOR
Version:	unspecified
Target Milestone:	---
Platform:	Fedora RPMs
OS:	Linux
Latest Commit:		Version Fixed In:
Sentry Crash Report:

Description Christoph Hoeger 2006-02-20 13:45:38 UTC

Version:           1.5.0.2.2 (using KDE KDE 3.5.1)
Installed from:    Fedora RPMs
OS:                Linux

When I generate code out of the 1.5.0.2.2 umbrello graph, the comments for auto-generated methods (getter/setter) is correct using @param etc. but these comments do not appear for my own operations and their parameters.
I have tested it for java and c++ is this a bug, or a feature?

Comment 1 Christoph Hoeger 2006-02-21 15:45:04 UTC

Edit: It seems that umbrello does export rdoc comments, when there is no other comment defined for an operation.
I think it would be better to have both kinds of comments.

Comment 2 Romel Sandoval 2006-06-09 00:42:57 UTC

This bug its present at 1.5.2 version too. The comments of the parameters entered by the user are ignored by the code generator. I have tried with C++ and Doxygen not rdoc.

Comment 3 Antoine Dopffer 2007-05-26 09:48:42 UTC

I am a bit lost with this bug.
According to me, this doesn't still exist in 1.5.7.
The comments entered by the user are written by the code generator in Java, C++ and Ruby.

Comment 4 Oliver Kellogg 2007-06-01 20:41:18 UTC

> The comments entered by the user are written by the code generator in Java,
> C++ and Ruby.

It may be that the original poster was using the Advanced Code Generators
which have been disabled due to stability problems.

Also he mentions getter/setter methods autogenerated for attributes.
It may well be that no doc is generated on those - I haven't checked.
At any rate, IMHO the doc at the attribute itself should suffice, and
should not be replicated at the accessor methods.

Comment 5 Ralf Habacker 2015-02-26 20:27:44 UTC

> but these comments do not appear for my own operations and their parameters.
in 2.15.1 generated c++ code includes comments for operations but not for parameters

Comment 6 Justin Zobel 2021-03-09 07:00:31 UTC

Thank you for the bug report.

As this report hasn't seen any changes in 5 years or more, we ask if you can please confirm that the issue still persists.

If this bug is no longer persisting or relevant please change the status to resolved.