Documenter HTML labels

[smgl9]

TerosTechnology/vscode-terosHDL#46

[GlenNicholls]

@smgl9 @qarlosalberto Below is my test code for the documenter for HTML linking:

--! i_strobe: comment <a name="id1">name/nothing</a>
--! o_pulse: should display this not name <a name="id2">name/nothing</a>
entity PulseGen is
    generic (
        NumRegs : natural := 0
    );
    port (
        --! clock
        clk   : in std_logic;
        reset : in std_logic; --! reset

        i_strobe  : in  std_logic; --! [name](#id1)
        o_strobe  : out std_logic;
        --! [name](#id2)
        o_pulse   : out std_logic;
        o_rising  : out std_logic;
        o_falling : out std_logic
    );
end entity PulseGen;

This displays the following:

I believe that comment should be the description for i_strobe in Table 1.2 and should display this not name for o_pulse. As I mentioned in TerosTechnology/vscode-terosHDL#46, it would be nice to describe the port list above the entity to make large port maps readable in the code when descriptions are somewhat complicated.