bsl-language-server
bsl-language-server copied to clipboard
[FP] Не определяются составные ссылки на типы в документирующих комментариях
Диагностика
MissingReturnedValueDescription MissingParameterDescription
Версия
v0.22.0
Описание ложного срабатывания диагностики
Парсер игнорирует составные ссылки на типы, (немного) описанные в стандарте #std453 [5.2.4] и предлагаемые к использованию в EDT, в секциях Параметры или Возвращаемое значение документирующего комментария. Т.е. выдает ошибку как будто тип не заполнен совсем
Пример кода
#Область ПрограммныйИнтерфейс
// Новая таблица
//
// Возвращаемое значение:
// ТаблицаЗначений:
// * Поле1 - Строка
//
Функция НоваяТаблица() Экспорт
Таблица = Новый ТаблицаЗначений;
Таблица.Колонки.Добавить("Поле1", Новый ОписаниеТипов("Строка"));
Возврат Таблица;
КонецФункции
// Проверка строки
//
// Параметры:
// СтрокаТаблицы - СтрокаТаблицыЗначений: см. НоваяТаблица
// Возвращаемое значение:
// СтрокаТаблицыЗначений: см. НоваяТаблица
//
Функция ПроверкаСтроки(СтрокаТаблицы) Экспорт
Возврат СтрокаТаблицы;
КонецФункции
#КонецОбласти
Скриншоты
Дополнительная информация
В EDT поддерживается (хотя не всегда полностью обрабатывается) практически любая комбинация вида ПримитивныйТип: см. СсылкаНаТип, даже те, которые явно не описаны в справке, например:
- ФиксированнаяСтруктура: см. ОписаниеСтруктуры
- СтрокаТаблицыЗначений: см. ОписаниеТаблицыЗначений
- СтрокаТабличнойЧасти: см. ПолноеИмяМетаданных.Табличной.Части
- ДанныеФормыЭлементКоллекции: см. ПолноеИмяМетаданных.Табличной.Части
- и т.д.