将一项链接到另一行

Question

我想把我所有关于文件内容的注释/文档放在它的末尾，并创建一些类似于引用/标记的东西来指向代码的一部分。

以下只是一个想法/示例：

我认为像//[reference_X]这样的东西可以工作(伪代码)：

module counter (clk,rst,enable,count);
input clk, rst, enable;
output [3:0] count; //[count]
reg [3:0] count;

always @ (posedge clk or posedge rst)
if (rst) begin
  count <= 0;
end else begin : COUNT
  while (enable) begin
    count <= count + 1;
    disable COUNT;
  end
end

endmodule
/**
* [count]: just an example, this register acts
* as something that explains what the asker is
* looking for.
*/

我的主要工具是Eclipse，但我启用了DVT Eclipse (找不到它的标签)。

目标语言是system-verilog。

Answer 1

从DVT 18.1.15开始，您可以在注释中使用超链接(https://dvteclipse.com/documentation/sv/Hyperlinks_in_Comments.html)

您只需编写@link元素或@see element，DVT将转到该元素的声明。要触发此操作，只需在将元素名称悬停在注释中的同时按住CTRL键即可。

有几种方法可以指定要引用的元素。如果DVT不能检测到唯一的元素，它将建议更多的超链接。