| ??? 05/20/10 10:18 Read: times |
#176063 - Good selection of symbol names helps a lot Responding to: ???'s previous message |
Andy Neil said:
Jez Smith said:
I don't need to be told that a clock signal is a clock. But how do you know it's a clock if you're not told?! I would have expected that the variable or port bit had been named in a way that it could be read from the source.
P2 |= 1 << CLOCK_BIT;
and I would have expected variables/constants in the source to match signal names on the schematics. |
| Topic | Author | Date |
| When comments go wrong | 01/01/70 00:00 | |
| Always document what the code is doing or the weather | 01/01/70 00:00 | |
| do you have some examples of that? | 01/01/70 00:00 | |
| I've never seen anything like that ... | 01/01/70 00:00 | |
| Do it like a pro. ;) | 01/01/70 00:00 | |
| the dubious value of comments | 01/01/70 00:00 | |
| RE: not subject to any scrutiny of the compiler | 01/01/70 00:00 | |
| limited vocabulary | 01/01/70 00:00 | |
| dubious | 01/01/70 00:00 | |
| Please remove baby from bathwater before disposal! | 01/01/70 00:00 | |
| Good selection of symbol names helps a lot | 01/01/70 00:00 | |
| variable/function names can be misleading too | 01/01/70 00:00 | |
| RE: the word Andy will be so kind to supply... | 01/01/70 00:00 | |
| Well | 01/01/70 00:00 | |
| Dodgy premise | 01/01/70 00:00 | |
That's no fun. | 01/01/70 00:00 |