Re:Programming Languages Are Simply Not Powerful Enough
by anthonyb on Friday March 01, 2013 @05:06AM
(#5303599)
Spec? For an in-house framework? Luxury!
Re:Programming Languages Are Simply Not Powerful Enough
by limmeau on Friday March 01, 2013 @05:37AM
(#5303666)
Did I say Spec? I meant the doxygen output of hundreds of classes with sparse one-line doccumments.
Plus one outdated sequence diagram.
Re:Programming Languages Are Simply Not Powerful Enough
by masklinn on Friday March 01, 2013 @07:02AM
(#5303838)
One-line comment? What are you, a writer-librarian?
Re:Programming Languages Are Simply Not Powerful Enough
by limmeau on Friday March 01, 2013 @07:57AM
(#5303989)
It can be learned. Observe:
//! \brief Transport diagnostic wrapper
class TransportDiagnosticWrapper {
(Actually, meaningful one-line comments are a lyric discipline of their own, related to haikus.)
Re:Programming Languages Are Simply Not Powerful Enough
by npsimons on Friday March 01, 2013 @09:05AM
(#5304247)
You joke, but a tool I have seen lauded for being really "smart" at automatically generating doxygen comments does exactly that. I guess it at least saves the time of a human doing it by hand . . .
"and here is the 1M LOC codebase, which was carefully crafted to avoid using any of the complicated frameworks; all you gotta know is the C standard library".