[Doxygen-users] VHDL Hierarchy

[Larry <la...@co...>]

Hello.  I'm new to Doxygen and have spent many hours trying to find this
answer on my own.  I will apologize ahead of time if I should have been able
to find this without bothering the mailing list .

 

Is there any way to specify the "Top-Level" entity of set of VHDL code, and
have Doxygen ignore any entities which it finds in the doxygen search path
which are *not* in the hierarchy below the top-level entity?  

 

The reason I ask is because I have VHDL designs which instantiate entities
from a pool of VHDL utilities.  If I put the utilities libraries in the
Doxygen search path, the resulting Doxygen documentation accurately
describes the complete hierarchy, but also includes a ton of confusing
extraneous stuff that is not relevant to the design being documented.   If I
don't include the libraries, the documentation of the relevant hierarchy is
not complete.  

 

If this feature is not currently supported, can anyone give me advice on how
one might go about adding it?  I have the all the doxygen sourcecode
downloaded and running in Eclipse.  I have also been able to successfully
rebuild the VHDL parser using javacc.  I'm having a little trouble getting
up to speed on all the code and determining which features are supported
and/or how to add features.  Or, is there anyone out there willing to add
features for hire? (I hope that ok to ask on the mailing list.)

 

Btw, I did enhance the VHDL parser to accept underscores inside hex literals
by modifying this line in the jj file:

<BASED_LITERAL: <INTEGER>["#"]<BASED_INTEGER> ((["_"])? <BASED_INTEGER>)*
(["."] <BASED_INTEGER>)? ["#"] (<EXPONENT>)? >  /*Gary Pratt added ((["_"])?
<BASED_INTEGER>)* */

 

I can provide the modified vhdlparser.jj file.  

 

Thanks in advance.  And, thanks to Dimitri and everyone who has helped build
a fantastic tool.

 

Gary

 

Gary L. Pratt, P.E.

President

ControlSphere Engineering