News for hackers. Stuff that matters.

A comment on Programming Languages Are Simply Not Powerful Enough. Parent comment

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.

[ Parent | on HN ]
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?
[ Parent | on HN ]
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.)
[ Parent | on HN ]
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 . . .
[ Parent | on HN ]