使用source insight 宏来插入doxygen可处理的注释

宏文件如下。



设置快捷键后，双击高亮要注释的内容，使用快捷键触发即可。



可自动识别

普通：在头部添加

宏：在末尾添加注释

变量：在末尾添加

函数：在头部添加，并自动识别函数个数

类：在头部添加



代码如下：保存为m.em即可加入source insight



macro insert_func_header_comment()
{
hbuf = GetCurrentBuf()
if( hbuf == 0 ) stop

// Get current time
szTime = GetSysTime(1)
Day = szTime.Day
Month = szTime.Month
Year = szTime.Year

chTab = CharFromAscii(9)
chComma = CharFromAscii(44)

ln = GetBufLnCur( hbuf )
start_ln = ln;
symbol = GetCurSymbol()
if( symbol == nil )
{//没有找到符号
  InsBufLine(hbuf, ln, "")
  SetBufIns(hbuf, start_ln, 10)
  stop
}

text = GetBufLine( hbuf, ln )
slen = strlen(text)

sbi = GetSymbolLocation( symbol )
if( sbi == nil )
{//无法得到符号记录，直接加一个简单记录了事
  PutBufLine( hbuf, ln, cat(text," //!< " )
  SetBufIns( hbuf, ln, slen + 6)
  stop
}

if( sbi.Type == "Function" || sbi.Type == "Method" || sbi.Type == "Function Prototype" )
{// function
  ich = 0
  while( text[ich] == " " || text[ich] == chTab )
  {
   ich = ich + 1
  }
  szPrefix = strmid(text, 0, ich)
  InsBufLine(hbuf, ln, cat( szPrefix, ""))
  SetBufIns(hbuf, start_ln, strlen(szPrefix) + 10) 
}
else if( sbi.Type == "Class" )
{// class
  if( (start_ln == sbi.lnFirst) )
  {//整个类注释
   InsBufLine(hbuf, ln, "")
   SetBufIns(hbuf, start_ln, 10)
  }
  else
  {//类成员
   PutBufLine( hbuf, ln, cat(text," //!< " )
   SetBufIns( hbuf, ln, slen + 6)
  }
}
else if( sbi.Type == "Structure" )
{// struct
  if( (start_ln == sbi.lnFirst) )
  {//整个结构体注释
   InsBufLine(hbuf, ln, "")
   SetBufIns(hbuf, start_ln, 10)
  }
  else
  {//结构体成员
   PutBufLine( hbuf, ln, cat(text," //!< " )
   SetBufIns( hbuf, ln, slen + 6)
  }
}
else if( sbi.Type == "Constant" )
{// macro
  PutBufLine( hbuf, ln, cat(text," //!< " )
  SetBufIns( hbuf, ln, slen + 6)
}
else if( sbi.Type == "Variable" )
{// variable
  PutBufLine( hbuf, ln, cat(text," //!< " )
  SetBufIns( hbuf, ln, slen + 6)
}
   
}