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,


------------------------------------------------------------------------------
Rapidly troubleshoot problems before they affect your business. Most IT 
organizations don't have a clear picture of how application performance 
affects their revenue. With AppDynamics, you get 100% visibility into your 
Java,.NET, & PHP application. Start your 15-day FREE TRIAL of AppDynamics Pro!
http://pubads.g.doubleclick.net/gampad/clk?id=84349831&iu=/4140/ostg.clktrk
_______________________________________________
Doxygen-users mailing list
Doxygen-users@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/doxygen-users

Reply via email to