bsl-language-server icon indicating copy to clipboard operation
bsl-language-server copied to clipboard

[FP] Не определяются составные ссылки на типы в документирующих комментариях

Open anatox opened this issue 1 year ago • 0 comments

Диагностика

MissingReturnedValueDescription MissingParameterDescription

Версия

v0.22.0

Описание ложного срабатывания диагностики

Парсер игнорирует составные ссылки на типы, (немного) описанные в стандарте #std453 [5.2.4] и предлагаемые к использованию в EDT, в секциях Параметры или Возвращаемое значение документирующего комментария. Т.е. выдает ошибку как будто тип не заполнен совсем

Пример кода

#Область ПрограммныйИнтерфейс

// Новая таблица
//
// Возвращаемое значение:
//  ТаблицаЗначений:
// * Поле1 - Строка
//
Функция НоваяТаблица() Экспорт
	Таблица = Новый ТаблицаЗначений;
	Таблица.Колонки.Добавить("Поле1", Новый ОписаниеТипов("Строка"));
	Возврат Таблица;
КонецФункции

// Проверка строки
//
// Параметры:
//  СтрокаТаблицы - СтрокаТаблицыЗначений: см. НоваяТаблица
// Возвращаемое значение:
//  СтрокаТаблицыЗначений: см. НоваяТаблица
//
Функция ПроверкаСтроки(СтрокаТаблицы) Экспорт
	Возврат СтрокаТаблицы;
КонецФункции

#КонецОбласти

Скриншоты

image

Дополнительная информация

В EDT поддерживается (хотя не всегда полностью обрабатывается) практически любая комбинация вида ПримитивныйТип: см. СсылкаНаТип, даже те, которые явно не описаны в справке, например:

  • ФиксированнаяСтруктура: см. ОписаниеСтруктуры
  • СтрокаТаблицыЗначений: см. ОписаниеТаблицыЗначений
  • СтрокаТабличнойЧасти: см. ПолноеИмяМетаданных.Табличной.Части
  • ДанныеФормыЭлементКоллекции: см. ПолноеИмяМетаданных.Табличной.Части
  • и т.д.

anatox avatar Mar 04 '24 15:03 anatox