Testbench--关于注释
0赞
发表于 2010/6/4 14:17:28
阅读(1948)
1.好的注释可以改善代码可维护性。
注释的主要目的就是为了显著改善代码的可维护性。
2.过时或错误的注释带来了(代码查看者)思维的混乱,这远比没有注释更糟糕。
代码注释时一个最大的共同错误是,注释描述的只是代码本身所做的功能。
例如:addr <= addr+1’b1; //addr自增1
这句注释不会带来任何读者(代码查看者)需要的信息,我们应该在注释里告诉 别人一些他们不熟悉的设计中和该语句相关的信息。
例如:(我们假定该工程是FPGA与MCU通信)
addr <= addr+1’b1; //在MCU写入一个字节数据后,addr自增1,
//以供MCU读取下一个字节数据
3. 注释代码时,你应该假 定读者是一个有经验的工程师,他熟悉verilog语言本身,但是对于你的 工程并不熟悉。最理想的情况是,抛开你的源代码,单从你的注释就能明白你所要实现的功能。