This Bugzilla instance is a read-only archive of historic NetBeans bug reports. To report a bug in NetBeans please follow the project's instructions for reporting issues.

Bug 193960 - C struct/enum member documentation functioning incorrectly
Summary: C struct/enum member documentation functioning incorrectly
Status: REOPENED
Alias: None
Product: cnd
Classification: Unclassified
Component: Code Completion (show other bugs)
Version: 8.1
Hardware: PC Windows 7 x64
: P1 normal (vote)
Assignee: Vladimir Voskresensky
URL:
Keywords: USABILITY
Depends on:
Blocks:
 
Reported: 2011-01-01 16:08 UTC by serious
Modified: 2018-07-04 20:43 UTC (History)
0 users

See Also:
Issue Type: DEFECT
Exception Reporter:


Attachments
screen shots of doxygen c struct netbeans problem (35.04 KB, image/png)
2011-01-05 13:35 UTC, serious
Details

Note You need to log in before you can comment on or make changes to this bug.
Description serious 2011-01-01 16:08:15 UTC
According to the Doxygen docs, you should be able to document a structure like this:

/**
 * A simple structure to demonstrate the netbeans 6.9.1/doxygen problem in
 * documenting structure members.
 *
 * This type is used blah blah.  Lots of detail here about why this structure
 * solves world hunger, clean water, and brings world peace.
 */
struct Foobar {
    int x; /**< member x description */
    int y; /**< member y description */
};


However, when done like this, the popups in netbeans 6.9.1 incorrectly associate the "x" description with member y, and say that "y" has no documentation. There is also some funkiness that when you use a variable instance of this type, for instance

struct Foobar myfoobar;
myfoobar.[user pauses for docs to pop up here]

then the struct definition should pop up with the list of members, and it doesn't quite work that way.  See the attached screen shots.
Comment 1 Vladimir Voskresensky 2011-01-04 21:39:01 UTC
thanks for the report,
btw there is no attached screen shot
Comment 2 serious 2011-01-05 13:35:25 UTC
Created attachment 104728 [details]
screen shots of doxygen c struct netbeans problem
Comment 3 Vladimir Voskresensky 2011-01-08 00:45:12 UTC
thanks
Comment 4 Vladimir Voskresensky 2011-01-08 00:48:34 UTC
http://hg.netbeans.org/cnd-main/rev/8f00ec2ab6d7
Comment 5 Quality Engineering 2011-01-09 06:18:35 UTC
Integrated into 'main-golden', will be available in build *201101090000* on http://bits.netbeans.org/dev/nightly/ (upload may still be in progress)
Changeset: http://hg.netbeans.org/main/rev/8f00ec2ab6d7
User: Vladimir Voskresensky <vv159170@netbeans.org>
Log: fixed #193960 -  C struct/enum member documentation functioning incorrectly
-- check doxygen on the same line after declaration
-- stop on "{" when traverse backward to not analyzer outer scope
Comment 6 ppesci 2018-07-04 20:43:07 UTC
The problem exists in NB 8.1 :(.

That happen to me documenting enums.