Code Generation> категория Comments включает параметры для конфигурирования комментариев в сгенерированном коде. Эти параметры требуют лицензии Simulink® Coder™. Дополнительные параметры, доступные с основанной на ERT целью, требуют лицензии Embedded Coder®.
Комментарии к коду сгенерированы автоматически, или можно добавить их в код.
Комментарии к коду имеют следующее использование:
Улучшите удобочитаемость и трассируемость кода
Сообщите среди пользователей
Улучшите поиск кода в кодовой базе
Комментарии к коду могут быть классифицированы в Автоматические сгенерированные и Пользовательские комментарии. Автоматические сгенерированные комментарии автоматически сгенерированы программным обеспечением во время генерации кода, и пользователь добавляет Пользовательские комментарии.
На диалоговом окне Configuration Parameters следующие параметры конфигурации находятся на Code Generation> панель Comments.
| Параметр | Описание |
|---|---|
Задайте, какие комментарии находятся в сгенерированных файлах. | |
Задайте, вставить ли комментарии блока Simulink. | |
Проследите до модели с помощью (Embedded Coder) | Задайте формат комментариев для блоков Simulink, элементов Stateflow® и функциональных блоков MATLAB®. |
Задайте, вставить ли комментарии объекта Stateflow. | |
Задайте, вставить ли исходный код MATLAB как комментарии. | |
Задайте, вставить ли комментарии устраненного блока. | |
Многословные комментарии для '' Класса памяти по умолчанию модели | Уменьшайте размер кода или улучшите трассируемость кода путем управления генерацией комментариев. |
Аннотации оператора (Embedded Coder) | Задайте, включать ли аннотации оператора для Polyspace® в сгенерированном коде как комментарии. |
| Параметр | Описание |
|---|---|
Описания блока Simulink (Embedded Coder) | Задайте, вставить ли описания блоков в сгенерированный код как комментарии. |
Описания объекта Stateflow (Embedded Coder) | Задайте, вставить ли описания объектов Stateflow в сгенерированный код как комментарии. |
Описания объекта данных Simulink (Embedded Coder) | Задайте, вставить ли описания объектов Симулинкдэты в сгенерированный код как комментарии. |
Требования в комментариях блока (Embedded Coder) | Задайте, включать ли описания требования, присвоенные блокам Simulink в сгенерированном коде как комментарии. |
Пользовательские комментарии (MPT возражает только) (Embedded Coder) | Задайте, включать ли пользовательские комментарии для сигнала модуля упаковочного инструмента (MPT) и объектов данных параметра в сгенерированном коде. |
Комментарии пользователя MATLAB (Embedded Coder) | Задайте, включать ли комментарии пользователя MATLAB как комментарии. |
Пользовательские комментарии функционируют (Embedded Coder) | Задайте файл, который содержит комментарии, которые будут включены в сгенерированный код для сигнала инструмента упаковки модуля (MPT) и объектов данных параметра. |
Следующие параметры конфигурации находятся под Advanced parameters.
| Параметр | Описание |
|---|---|
Прокомментируйте стиль (Embedded Coder) | Задайте стиль комментария многострочной или одной линии для сгенерированного кода C or C++. |
| Вставьте комментарии Polyspace (Embedded Coder) | Задайте, вставить ли комментарии к коду для аннотаций блока Polyspace. |
Программное обеспечение генерации кода автоматически вставляет комментарии в сгенерированный код для пользовательских блоков. Поэтому вы не должны включать комментарии блока в связанный файл TLC для пользовательского блока.
Если у вас есть существующие файлы TLC с вручную вставленными комментариями для описаний блока, процесс генерации кода испускает эти комментарии вместо автоматически сгенерированных комментариев. Рассмотрите удаляющие существующие комментарии блока из своих файлов TLC. Вручную вставленные комментарии могут быть плохо отформатированы в сгенерированном коде, и трассируемость кода к модели не может работать.
Для виртуальных блоков или блоков, которые были удалены должные блокировать сокращение, не сгенерированы комментарии.
Когда вы конфигурируете генератор кода, чтобы произвести код, который включает комментарии, генератор кода включает текст для параметров модели, имен блока, имен сигнала и имен объектов Stateflow в комментариях сгенерированного кода. Если текст включает символы, которые не представлены в кодировании набора символов для модели, генератор кода заменяет символы на escape-последовательности XML. Например, генератор кода заменяет японскую полноширинную букву Katakana ア на escape-последовательность ア. Для получения дополнительной информации смотрите Интернационализацию и Генерацию кода.