特权同学

Testbench--关于注释

0
阅读(1948)

1.好的注释可以改善代码可维护性

注释的主要目的就是为了显著改善代码的可维护性。

2.过时或错误的注释带来了(代码查看者)思维的混乱,这远比没有注释更糟糕。

代码注释时一个最大的共同错误是,注释描述的只是代码本身所做的功能。

例如:addr <= addr+1’b1; //addr自增1

这句注释不会带来任何读者(代码查看者)需要的信息,我们应该在注释里告诉 别人一些他们不熟悉的设计中和该语句相关的信息。

例如:(我们假定该工程是FPGA与MCU通信)

addr <= addr+1’b1; //在MCU写入一个字节数据后,addr自增1,

//以供MCU读取下一个字节数据

3. 注释代码时,你应该假 定读者是一个有经验的工程师,他熟悉verilog语言本身,但是对于你的 工程并不熟悉。最理想的情况是,抛开你的源代码,单从你的注释就能明白你所要实现的功能。

Baidu
map