| * ''/Reset'': an asynchronous, active-low reset line | | * ''/Reset'': an asynchronous, active-low reset line |
− | The library use statements and port list for the DAC emulator are shown here. Note the terribly non descriptive comments for the input lines. This kind of comment is not only useless (as it merely repeats the signal name), but is mocking the pain of later engineers who have to figure out what a signal like ''invSYNC'' might do. This will result in ninjas attacking your home. To avoid this fate, I recommend better comments such as, "an active-low flag to being transmission," for ''invSYNC'' or, "serial clock line," for ''SCLK''. | + | The library use statements and port list for the DAC emulator are shown here. Note the terribly non descriptive comments for the input lines. This kind of comment is not only useless (as it merely repeats the signal name), but is mocking the pain of later engineers who have to figure out what a signal like ''invSYNC'' might do. This will result in ninjas attacking your home. To avoid this fate, I recommend better comments such as, "an active-low flag to begin transmission," for ''invSYNC'' or, "serial clock line," for ''SCLK''. |