Menu

Documentation comment

2008-09-04
2012-11-13
  • Deatzo Seol

    Deatzo Seol - 2008-09-04

    Hello all!
    I have certain languages (HTML, Lua, PHP, ...) where I would want to differentiate between block comments (e.g. '/* some text */') and documentation comments (e.g. '/** some text */'). However, I see no way to add this to those languages... (I didn't find how C/C++ did this, maybe it's built-in?)
    Any help is greatly appreciated!

     
    • Deatzo Seol

      Deatzo Seol - 2008-09-13

      bumpity bumpity bump

       
    • Airdrik

      Airdrik - 2008-09-15

      I don't think the PHP interpreter distinguishes between block comments and documentation comments--the only difference is that the developer put one more '*' on the 'doc comment'. 

      In order to change it, I believe you would have to go into the source code and figure out how C/C++ handles it.  (Try searching the forums and the trackers, because I believe I saw something similar discussed--custom lexers--somewhere else). 

       
    • Harry

      Harry - 2008-09-15

      You need to rewrite lexers. Java and C++ share the same one, using different colors and keywords, thus both can handle the document comments. PHP is a whole new story (and is mostly run by the HTML lexer) so its pretty hard to implement that.