qt-creatordoxygenkate

kate editor: highlighting configuration for doxygen files


Kate editor (and QtCreator too) uses the same xml configs for the highlighting a syntax of the files. e.g. doxygen

however ,it looks oddly for me because of:

  1. The file under the link above - doxygen.xml, does this refer to doxygen sources (I mean c++ source files where doxygen notation is used) or to doxygen configuration? I believe second because of line in the file:

extensions=".dox;.doxygen"

however .dox files have a different syntax, similar to plain config files

  1. If previous question's reply is to doxygen source files, how does it work ?

======================================================================= an update:

the processing a piece like this:

EXTENSION_MAPPING      = hpp=c++ \ #lkfjglkfdjglfdkjgl
                         cpp=c++ \ #lkdjfglkdfjlgdfkjgld
                         h=c++     #gfjkdlgkjfdlgkjdlfk

this context processes this case:

 <context name="Value" attribute="UntypedValue" lineEndContext="#pop" >
  <Float attribute="Float" />
  <Int attribute="Int" />
  <keyword attribute="Value" String="values" />
  <RegExpr attribute="Comment" context="#pop" String="#.*$" />
  <LineContinue />
 </context>

however you see this only can process lineContinue if the line doesn't contain a comment. Looking for a fix


Solution

  • I'm the original author of doxygen.xml.

    Kate's Doxygen highlighting (and therewith also Qt Creator's) requires you to first step into the Doxygen context: That is, you need to start a Doxygen comment first by either /**, ///, or //!.

    Then, you get proper highlighting for all Doxygen commands.

    So this is not for Doxygen configuration itself, if I understand you correctly.