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