Замечания по оформлению комментариев и блоков в коде. - 1Cv7 ВСД в ГИС Меркурий - КБ99 Redmine

Проект

Общее

Профиль

Замечания по оформлению комментариев и блоков в коде.

Добавил(а) Анисимов Михаил около 7 лет назад

Многие разработчики на 1С 7.7 используют внешние доп модули в конфигураторе (OpenConf, Telepat, Colorer и т.д. - весьма удобный функционал) в которых используется конструкция по определению блока свертки кода вида

//{ - начало блока

Код программы

//} - конец блока

Если не соблюдать пары начало и окончание то сворачивается код некорректно ((.

Например код функции

Процедура ПриОткрытии()

    ИмяФайла="";
    КаталогОбработки="";    
    РасположениеФайла(КаталогОбработки, ИмяФайла);

   //Интеграционный модуль для переопределения функций, плюс несколько базовых функций
    глМеркурийИнтеграция         = СоздатьОбъект("МеркурийИнтеграция");
    ТестовыйРежимРаботыМодуля   = глМеркурийИнтеграция.ОпределитьРежимРаботыМодуля(ИмяФайла);        // определение режима работы модуля
    КаталогБиблиотек            = глМеркурийИнтеграция.КаталогБиблиотек();                             // путь к хранилищу стандартных библиотек DLL
    КаталогМодуля               = глМеркурийИнтеграция.КаталогМодуля(КаталогОбработки);                // путь к каталогу обработок модуля меркурий

    ГМ = СоздатьОбъект("Меркурий_ГлобальныйМодуль");
    ГМ.Инициализация(КаталогМодуля, КаталогБиблиотек, ТестовыйРежимРаботыМодуля);        
    ГМ.ЗагрузитьПараметры(Контекст);

    //Переопределение функций, если они определены в модуле
    глМеркурийИнтеграция.Инициализация(ГМ);    
    //}        

КонецПроцедуры

корректно будет так

Процедура ПриОткрытии()

    ИмяФайла="";
    КаталогОбработки="";    
    РасположениеФайла(КаталогОбработки, ИмяФайла);

   //{Интеграционный модуль для переопределения функций, плюс несколько базовых функций
    глМеркурийИнтеграция         = СоздатьОбъект("МеркурийИнтеграция");
    ТестовыйРежимРаботыМодуля   = глМеркурийИнтеграция.ОпределитьРежимРаботыМодуля(ИмяФайла);        // определение режима работы модуля
    КаталогБиблиотек            = глМеркурийИнтеграция.КаталогБиблиотек();                             // путь к хранилищу стандартных библиотек DLL
    КаталогМодуля               = глМеркурийИнтеграция.КаталогМодуля(КаталогОбработки);                // путь к каталогу обработок модуля меркурий

    ГМ = СоздатьОбъект("Меркурий_ГлобальныйМодуль");
    ГМ.Инициализация(КаталогМодуля, КаталогБиблиотек, ТестовыйРежимРаботыМодуля);        
    ГМ.ЗагрузитьПараметры(Контекст);

    //Переопределение функций, если они определены в модуле
    глМеркурийИнтеграция.Инициализация(ГМ);    
    //}        

КонецПроцедуры

или вообще тогда убрать все фигурные скобки из комментариев.


Ответы (1)

RE: Замечания по оформлению комментариев и блоков в коде. - Добавил(а) кб99 Синявский Филипп около 7 лет назад

спасибо, учту.
хотя я предпочитаю, чтобы весь код был открыт...

    (1-1/1)