The @copybrief, @copydetails and @copydocs are no longer working as expected
in v1.8.4
Problems:
- When used inside of a table (html or markdown) the commands break
the table (ie: the table is not completed and the rest of the data is displayed
as a line)
- Output from @copybrief and @copydetails are MERGED when used in the
same section, even if they are called in different places.
- @copy* commands no longer work for methods (on Windows, it does on
Linux)
The problems can be duplicated with the following code sample (using default
doxyfile configuration):
/**
* MyClass brief.
* MyClass details.
*/
class MyClass
{
public:
/**
* Brief desc for doSomething().
* The details for doSomething().
*/
void doSomething();
/**
* Brief desc for doSomethingElse().
* The details for doSomethingElse().
*/
void doSomethingElse();
};
/**
* @mainpage Main Page
*
* @section SEC0 Testing \@copy*
*
* Brief:
* @copybrief MyClass
*
* Details:
* @copydetails MyClass
*
* Full Doc:
* @copydoc MyClass
*
* Brief for a method.
* @copybrief MyClass::doSomething()
*
* <br>
* @section SEC1 Tables using markdown.
*
* Normal markdown table
* | Method | Brief Description
* | :---------------------------- | :-------------------------------------
* | @ref MyClass::doSomething | Do Something
* | @ref MyClass::doSomethingElse | Do Something Else
*
* <br>
* Same markdown table but using the <b> \@copybrief </b> command.
* | Method | Brief Description
* | :---------------------------- | :-------------------------------------
* | @ref MyClass::doSomething | @copybrief MyClass::doSomething()
* | @ref MyClass::doSomethingElse | @copybrief MyClass::doSomethingElse()
*
* <br><hr><br>
*
* @section SEC2 Tables using HTML
*
* Normal HTML table
* <table>
* <tr><th> Method </th> <th> Brief Description </th></tr>
* <tr><td> MyClass::doSomething </td> <td> Do Something </td> </tr>
* <tr><td> MyClass::doSomethingElse </td><td> Do Something Else </td></tr>
* </table>
*
* <br>
* Same HTML table but using the <b> \@copybrief </b> command.
* <table>
* <tr><th> Method </th> <th> Brief Description </th>
</tr>
* <tr><td> @ref MyClass::doSomething </td> <td> @copybrief
MyClass::doSomething() </td> </tr>
* <tr><td> @ref MyClass::doSomethingElse </td><td> @copybrief
MyClass::doSomethingElse() </td></tr>
* </table>
*
* <br>
*/
------------------------------------------------------------------------------
Get 100% visibility into Java/.NET code with AppDynamics Lite!
It's a free troubleshooting tool designed for production.
Get down to code-level detail for bottlenecks, with <2% overhead.
Download for free and get started troubleshooting in minutes.
http://pubads.g.doubleclick.net/gampad/clk?id=48897031&iu=/4140/ostg.clktrk
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users
