Шаблон комментария

[blitzkrieg]

Часто в коде приходится вручную добавлять комментарии начала и конца вносимого изменения, а также дату и свой логин.
Неужели в Аксе нет специального шаблона?

[kvg6]

Попробуйте правой кнопкой мыши Scripts/VCS/Checkin и проч. Оно?

[blitzkrieg]

Ага
А как эти скрипты редактировать?

[Dron AKA andy]

См. класс EditorScripts.

[kashperuk]

Вот такой скрипт использую я:

//<EditorExtensions_ikash date=2007-01-20 txt='Inserts a comment with current date, userId and comments on the modification'>
#define.StartComment("//<\%1_\%2 date=\%3 txt='\%4'>\n")
#define.EndComment  ("//</\%1_\%2>\n")
#define.CurrentVersion(1)
void comments_projectTxt(Editor e)
{
    Dialog          dialog = new Dialog("Вставка комментариев", this);
    DialogField     dlgFieldMod = dialog.addField(typeId(FreeText), "Введите код модификации");
    DialogField     dlgFieldTxt = dialog.addField(typeId(SourceLine), "Введите комментарий к коду");
    int             start, end, firstSym;
    container       packedData;
    SourceLine      projectDescription;
    FreeText        projectCode;
    int             version;
    ;
    packedData = xSysLastValue::getValue(curExt(), curUserId(), UtilElementType::Class, classId2Name(classIdGet(this)), funcName());
    try
    {
        if (conLen(packedData) && conPeek(packedData, 1) == #CurrentVersion)
            [version, projectCode, projectDescription] = packedData;
    }
    catch
    {
        projectCode = '';
        projectDescription = '';
    }
    dlgFieldMod.value(projectCode);
    dlgFieldTxt.value(projectDescription);
    if (dialog.run())
    {
        projectCode         = dlgFieldMod.value();
        projectDescription  = dlgFieldTxt.value();
        start = e.selectionStartLine();
        end   = e.selectionEndLine();
        e.gotoLine(start);
        firstSym = strnfind(e.currentLine(), " ", 1, strlen(e.currentLine()));
        e.unmark();
        if (start > 1)
        {
            e.gotoLine(end + 1);
            e.gotoCol(1);
            e.insertLines(strrep(" ", firstSym - 1) + strfmt(#EndComment, projectCode, curUserId()));
        }
        e.gotoLine(start);
        e.gotoCol(1);
        e.insertLines(strrep(" ", firstSym - 1) + strfmt(#StartComment, projectCode, curUserId(),
                                                                        date2str(SystemDateGet(),321,2,3,2,3,4), projectDescription));
        xSysLastValue::putValue([#CurrentVersion, projectCode, projectDescription], curExt(), curUserId(), UtilElementType::Class,
                                classId2Name(classIdGet(this)), funcName());
    }
}

[blokva]

Цитата:

Сообщение от blitzkrieg

Ага
А как эти скрипты редактировать?

Простите за банальность но как часто говорят на форумах "Поиск рулит"
собственно вся ветка
ссылка на себя любимого

[player]

Пользуясь на версии 2009 "в лоб" столкнулся с "уплыванием" строк после вставляемых комментариев, вида
было:

    InventSum inventSum;
    InventDim inventDim;
    InventTable inventTable;

стало:

    //<-- begin
        InventSum inventSum;
    //--> end
        InventDim inventDim;
    InventTable inventTable;

Исправляю это так:

/// <summary>
/// Обрамляет выделенную область в тексте комментарием об авторстве и дате изменения данного блока текста
/// </summary>
/// <param name="e">
/// текущий редактор
/// </param>
/// <remarks>
/// Для версии 2009
/// </remarks>
#define.StartComment("//--> \%1, \%2")
#define.EndComment("//<-- \%1, \%2")
public void comments_insertDevComment(Editor e)
{
    int start = e.selectionStartLine();
    int end   = e.selectionEndLine();
    int firstSym;
    str tmpLine;
    ;

    e.gotoLine(start);
    firstSym = strnfind(e.currentLine(), " ", 1, strlen(e.currentLine()));
    e.unmark();
    //Нижний комментарий
    e.gotoLine(end + 1);
    e.gotoCol(0);
    e.insertLines("\n");
    e.gotoLine(end +1);
    e.gotoCol(0);
    e.insertLines(strrep(" ", firstSym - 1) +
                  strfmt(#EndComment,
                            strupr(curUserId()),
                            date2str(today(),123,2,1,3,1,4, DateFlags::FormatAll )));
    //Верхний комментарий
    e.gotoCol(0);
    e.gotoLine(start);
    e.gotoCol(0);
    e.insertLines("\n");
    e.gotoLine(start);
    e.gotoCol(0);
    e.insertLines(strrep(" ", firstSym - 1) +
                  strfmt(#StartComment,
                            strupr(curUserId()),
                            date2str(today(),123,2,1,3,1,4, DateFlags::FormatAll )));
    e.gotoLine(end + 3);
    e.gotoCol(firstSym);
}