Ticket #69 (closed defect: fixed)

Opened 2 years ago

Last modified 2 years ago

FieldContainer documentation from .fcd file doesn't get into the generated code

Reported by: allenb Assigned to: cneumann
Priority: blocker Milestone: 2.0 Beta
Component: Documentation Version: 2.0
Keywords: Cc:
Completion: 2006/12/31

Description

The documentation for the field container as a whole does not ever make it into the generated code.

Change History

11/29/06 09:30:52 changed by cneumann

  • estimated_completion changed.

The version of fcdProces in trunk, seems to do "The Right Thing", but note that normally for Foo.fcd only FooBase.{h,cpp,inl} and FooFields.h are generated to avoid overwriting user code in the none-Base files.

If nobody objects I'll close this ticket by the end of the week - 2006/12/01.

(follow-up: ↓ 3 ) 11/29/06 19:04:09 changed by dirk

Just a quick comment: my idea was to move the documentation out of the Foo.cpp file and into the FooBase.cpp file. doxygen allows you to document anything anywhere, so documenting Foo in FooBase.cpp is not a problem. We will have to remove the docs from the existing source files, but for testing doing that in just one should be fine.

(in reply to: ↑ 2 ; follow-up: ↓ 4 ) 11/30/06 05:51:43 changed by cneumann

Replying to dirk:

Just a quick comment: my idea was to move the documentation out of the Foo.cpp file and into the FooBase.cpp file. doxygen allows you to document anything anywhere, so documenting Foo in FooBase.cpp is not a problem. We will have to remove the docs from the existing source files, but for testing doing that in just one should be fine.

Ok. Is it possible to document a class in multiple places, i.e. can I do:

In FooBase.cpp:

/*! \class Foo <doc from the .fcd file>

 */

and in Foo.cpp:

/*! \class Foo <doc about the user code in Foo>

 */

and get the concatenation of both ?

If not and since the non-base files will have to be touched anyways I would prefer to keep the doc in Foo.cpp to allow extensions of it.

(in reply to: ↑ 3 ; follow-up: ↓ 5 ) 11/30/06 07:50:51 changed by dirk

Replying to cneumann:

Ok. Is it possible to document a class in multiple places, i.e. can I do:

and get the concatenation of both ?

If not and since the non-base files will have to be touched anyways I would prefer to keep the doc in Foo.cpp to allow extensions of it.

For changing the docs you would have to change the .fcd and regenerate the Base. The disadvantage is having the docs in a separate file (but there is a lot of information in that one anyway), the advantage is that the docs can be made available to the runtime, if needed.

(in reply to: ↑ 4 ) 11/30/06 08:26:35 changed by cneumann

Replying to dirk:

Replying to cneumann:

Ok. Is it possible to document a class in multiple places, i.e. can I do:

and get the concatenation of both ?

If not and since the non-base files will have to be touched anyways I would prefer to keep the doc in Foo.cpp to allow extensions of it.

For changing the docs you would have to change the .fcd and regenerate the Base. The disadvantage is having the docs in a separate file (but there is a lot of information in that one anyway), the advantage is that the docs can be made available to the runtime, if needed.

Ah ok, I agree this is best, since it keeps the doc in on place (the .fcd).

I'll work on this, unless you'd like to do it yourself, of course ;)

12/01/06 07:11:50 changed by cneumann

  • owner changed from dirk to cneumann.
  • estimated_completion set to 2006/12/31.

12/04/06 12:34:31 changed by cneumann

  • status changed from new to closed.
  • resolution set to fixed.

completed with r439