analogdevicesinc / doctools

Central repository to host tooling for automated documentation builds
Eclipse Public License 2.0
4 stars 3 forks source link

Two hdl-interfaces in the same rst file cannot share interface names #3

Closed caosjr closed 9 months ago

caosjr commented 9 months ago

Currently, a single rst file cannot have two or more hdl-interfaces with conflicting names. It affects the collapsible content.

How to reproduce it:

.. hdl-interfaces::
    :path: library/jesd204/axi_jesd204_tx

.. hdl-interfaces::
    :path: library/jesd204/jesd204_tx

You will notice that only the first hdl-interface can show the "tx_cfg", "tx_ilas_config Enabled if LINK_MODE = 1.", "tx_event", "tx_status", "tx_ctrl Enabled if LINK_MODE = 1.", and "Ports" interfaces.

gastmaier commented 9 months ago

Solved in 7f7e73955b7d05aa8a3663889fe6876a26577a0c by appending the interface name to the sha1 method, which generated the hyperrefs.