[PATCH] Better support for Doxygen

[Ding Zhaojie]

I improved the Doxygen support in SE v13 tonight. The patch has not been fully tested and I'm still working on it. So use it at your own risk.

Here are some screen shots showing the improvements:

Display the svn doxygen comments:

BEFORE: UNREADABLE!
AFTER: MUCH better now 

[UPDATED]: Merged @param[in, out] support by MRawlings (Thanks!)

[Clark]

I'd like to checkout your changes.  Can you post this file either in uncompressed or in .zip or .jar format.

Thanks

[Ding Zhaojie]

I'd like to checkout your changes.  Can you post this file either in uncompressed or in .zip or .jar format.

Thanks

Uploaded, and here is a header file from svn source for testing.

[Clark]

Thanks for some very useful changes.

I've looked over the code but I'm not quite finished.  What does the following line do/Why is it needed/Give an example.

res = stranslate(res, '', '\*/', 'R');

Wouldn't */ teminate the comment?

Thanks

[Ding Zhaojie]

Thanks for some very useful changes.

I've looked over the code but I'm not quite finished.  What does the following line do/Why is it needed/Give an example.

res = stranslate(res, '', '\*/', 'R');

Wouldn't */ teminate the comment?

Thanks

Here is an example:

Code: [Select]

struct tipc_portid {
    __u32 ref;      /**< Port Reference */
    __u32 node;     /**< Node Address */
};
In the original SE it will be displayed as "< Port Reference */".

[Clark]

Ok, now I see why I was confused.  There seems to be a parsing issue which occurs before this function is ever called.  The trailing "*/" should have already been stripped.  I'm going to checkout out what's going on.

Thanks