Results 1 to 6 of 6

Thread: Clang Can Analyze Code Comments, Generate Docs

  1. #1
    Join Date
    Jan 2007
    Posts
    13,474

    Default Clang Can Analyze Code Comments, Generate Docs

    Phoronix: Clang Can Analyze Code Comments, Generate Docs

    Aside from why LLVM/Clang was ported to one of the fastest super computer's in the world and using Clang to implement Microsoft's C++ AMP, another interesting session at this month's LLVM Developers' Conference in San Jose was about using Clang to analyze code comments...

    http://www.phoronix.com/vr.php?view=MTIzMTE

  2. #2
    Join Date
    Feb 2008
    Location
    Linuxland
    Posts
    4,754

    Default

    Haha, I wonder what it thinks of ascii art?

    foo.c:46: warning: the bunny is badly drawn

  3. #3
    Join Date
    Feb 2012
    Posts
    64

    Default

    Quote Originally Posted by curaga View Post
    Haha, I wonder what it thinks of ascii art?
    foo.c:46: warning: the bunny is badly drawn
    foo.c.46: warning: Developer has too much time on their hands, recommend increasing workload

    Joke aside, from a purely semantic point of view, ASCII art is just a nonsensical collection of letters and symbols, so it might complain that your comment does not seem to match and/or describe the code in any way. But who knows, so long as I receive flak for even commenting my code, because obviously I've got too little to do if I've got the time to write "useless" comments, so long there'll be little need for such things.

  4. #4
    Join Date
    Oct 2009
    Posts
    845

    Default

    Quote Originally Posted by curaga View Post
    Haha, I wonder what it thinks of ascii art?

    foo.c:46: warning: the bunny is badly drawn
    Heh, yeah. bar.c:6 warning: possible ascii penis ! : silence this warning with --allow-obscenity

  5. #5
    Join Date
    Sep 2008
    Posts
    112

    Default

    A bit hard to follow the slides without commentary, but it looks very useful. The code I'm working on (which was an existing project) is sure to have LOTS of documentation errors and plenty of comment bitrot (happens easily with hundred of thousands of LOC)

  6. #6
    Join Date
    Aug 2010
    Posts
    1

    Default

    No one reminds the autodoc feature of amiga sdk reading this news ?

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •