3 ms·
> You have to pay attention to include order! You have to write forward declarations! You have to write include guards, in 2018! Include order is a valid compl
by tjoff 8y ago
> You have to pay attention to include order! You have to write forward declarations! You have to write include guards, in 2018!
Include order is a valid complaint, the others truly are non issues.
I mean, we have other more pressing issues. Such as the fact that garbage collection is still a thing in 2018.
> ...but nowadays a proper documentation generator gives you better...
Examples of that?
> I like seeing function-level documentation alongside interface and implementation, but if I put the documentation in both the .cpp and the .h file it's duplicated in two places and easily gets out of date.
This is the only thing that I dislike about header files. And it is a constant reminder how bad IDEs are at handling this.
- omegote 8y agoDoxygen can generate a list of all class members, including those from all ancestors. If you wanna do that checking header files you'll have to keep jumping between files going from parent to parent class.
- tjoff 8y ago... doxygen, no. I'd rather take header files than doxygen. I hope he meant something else since he said "nowadays". Doxygen is ok if you haven't setup your build environment. But for when you actually are in the code (and somewhat familiar with it) I very much prefer just reading the header files than switching to a browser.