Hi,
I have a Doxygen config already defined. If i generate html or straight xml, for a given function call, the brief and detailed description is included. When i try and generate DocBook xml from the same configuration, i get the function call, but i DONT get the brief or detailed description info. This also causes a broken link to references of this.
For Example i have the following first few lines, in the source .h file:
/**
* @brief Provides interface to run PSCON self tests
*
* @description contains the logic to place the PSCON diagnostic compare block in a self-test mode in order\n
* to test the * failsafe feature. Three diagnostic features are supported by this API.
In the html version of the _8h.html generated from the source api, i get the following:
<p>Provides interface to run PSCON self tests. </p>
<dl class="section user"><dt>Description:</dt><dd>contains the logic to place the PSCON diagnostic compare block in a self-test mode in order<br/>
to test the * failsafe feature. Three diagnostic features are supported by this API.<br/>
In the plain xml version i get the following:
<briefdescription>
<para>Provides interface to run PSCON self tests. </para> </briefdescription>
<detaileddescription>
<para><simplesect kind="par"><title>Description:</title><para>contains the logic to place the PSCON diagnostic compare block in a self-test mode in order<linebreak/>
to test the * failsafe feature. Three diagnostic features are supported by this API.<linebreak/>
In the DocBook xml generated version of this i only get the function call and its parameters. NO descriptions, brief or otherwise, are generated. I have double checked and i have both brief and detailed descriptions checked in my config.
This is my first time using doxygen to generate DocBook xml. Is this a known issue? Is there a setting i may have overlooked?
Any help is greatly appreciated!
Thanks,
|
