source insight 添加注释，添加环境变

        在写程序的时候有时候需要添加函数注释或者头文件注释，在source insight中可以通过宏定义快捷键一键添加注释模板。但是需要添加环境变量，这里一开始没有明白是什么意思，后来搜索到了。添加环境变量：就是在我们电脑里设置环境变量，之所以要添加是因为source insight 注释中要提取名字。这里是两个函数：

添加函数注释：

macro MyInsertHeader()
{
    // Get the owner's name from the environment variable: MYNAME.
    // If the variable doesn't exist, then the owner field is skipped.
    szMyName = getenv(MYNAME)

    // Get a handle to the current file buffer and the name
    // and location of the current symbol where the cursor is.
    hbuf = GetCurrentBuf()
    szFunc = GetCurSymbol()
    ln = GetSymbolLine(szFunc)

    InsBufLine(hbuf, ln, "/************************************************************");
    ln = ln +1

    // begin assembling the title string
    sz = "** 函数名称: " 

    /* convert symbol name to T E X T   L I K E   T H I S */
    cch = strlen(szFunc)
    ich = 0
    while (ich < cch)
    {
        ch = szFunc[ich]
        if (ich > 0)
            if (isupper(ch))
                sz = cat(sz, "   ")
            else
                sz = cat(sz, " ")
        sz = Cat(sz, toupper(ch))
        ich = ich + 1
    } 
    InsBufLine(hbuf, ln, sz)
    ln = ln + 1

    InsBufLine(hbuf, ln, "** 功能描述: ")
    ln = ln + 1

    InsBufLine(hbuf, ln, "** 输入参数:")
    ln = ln + 1

    InsBufLine(hbuf, ln, "** 输出参数: ")
    ln = ln + 1

    InsBufLine(hbuf, ln, "** 返 回 值    :")
    ln = ln + 1

    /* if owner variable exists, insert Owner: name */
    if (strlen(szMyName) > 0)
    {
        InsBufLine(hbuf, ln, "** 作    者       :  @szMyName@")                 
    }
    else
    {
        InsBufLine(hbuf, ln, "** 作    者       :  ")                 
    }
    ln = ln + 1

    // Get current time
    szTime  = GetSysTime(1)
    Day      = szTime.Day
    Month   = szTime.Month
    Year     = szTime.Year
    if (Day < 10)
        szDay = "0@Day@"
    else
        szDay = Day  

    InsBufLine(hbuf, ln, "** 日    期       :  @Year@年@Month@月@szDay@日")
    ln = ln + 1

    InsBufLine(hbuf, ln, "** 版    本       :  1.0")
    ln = ln + 1

    InsBufLine(hbuf, ln, "** 修改日期  版本号   修改人  修改内容")
    ln = ln + 1

    InsBufLine(hbuf, ln, "**************************************************************/")
}

以下是添加头文件注释宏：

macro MyInsertFileHeader()
{
    szMyName = getenv(MYNAME)

    hbuf = GetCurrentBuf()

    InsBufLine(hbuf, 0, "/***************************************************************************")
    InsBufLine(hbuf, 1, "** 版权所有:  Desay Copyright (c) 2016-2026  ********************             ")
    filename = GetBufName(hbuf)
    InsBufLine(hbuf, 2, "** 文件名称:  @filename@")
    InsBufLine(hbuf, 3, "** 文件标识: ")
    InsBufLine(hbuf, 4, "** 内容摘要:  ")
    InsBufLine(hbuf, 5, "** 当前版本:  v1.0")

    /* if owner variable exists, insert Owner: name */
    if (strlen(szMyName) > 0)
    {
        sz = "** 作      者     :  @szMyName@"
    }
    else
    {
        sz = "** 作      者     :"
    }

    InsBufLine(hbuf, 6, sz)

    // Get current time
    szTime  = GetSysTime(1)
    Day      = szTime.Day
    Month   = szTime.Month
    Year     = szTime.Year
    if (Day < 10)
        szDay = "0@Day@"
    else
        szDay = Day               

    InsBufLine(hbuf, 7,   "** 完成日期: @Year@年@Month@月@szDay@日")
    InsBufLine(hbuf, 8,   "** 修改记录: ")
    InsBufLine(hbuf, 9,   "** 修改记录: ")
    InsBufLine(hbuf, 10, "** 修改日期: ")
    InsBufLine(hbuf, 11, "** 版本号      : ")
    InsBufLine(hbuf, 12, "** 修改人      : ")
    InsBufLine(hbuf, 13, "** 修改内容: ")
    InsBufLine(hbuf, 14, "***************************************************************************/")
}

以上添加完就可以配置快捷方式，具体操作方式看另一篇文章就可以了。

添加环境变量：计算机->右键属性->（左上角）高级系统设置->环境变量->（在用户环境变量中）新建->变量名：MYNAME,变量值：XXX（你的名字）

需要注意：

       1、设置完成环境变量后，需要重启source insight ，以上配置才起作用，至少我的电脑是这样的。

       2、环境变量的具体位置，不同系统可能不同，我是w7,具体根据自己的实际系统找到即可。

       3、添加函数注释的时候首先要先写出函数的名字，再用快捷键添加函数注释，不然不报错。