Возможность указывать в документирующих комментариях наборы свойств и методов (программные интерфейсы)

[tormozit]

Описание проблемы

В метод передается параметр МойСправочник типа СправочникМенеджер, который одновременно должен иметь программные интерфейсы (контракты):

1. Набор методов, описанных в общем модуле инМенеджерСправочника
2. Набор методов и метасвойств (определяемых в конфигурации или коде), описанных в справочнике "Шаблон"

Нужно описать такой параметр и научить анализатор кода его понимать.

Описание решения проблемы

Предлагаю описывать такой параметр так:

//Параметры:
// МойСправочник - СправочникМенеджер - ...:
// * см. инМенеджерСправочника - общий модуль
// * см. Справочники.Шаблон - справочник-шаблон

В самОм модуле, соблюдающем эти контракты, в сАмом начале модуля (хотя бы для информации) указывать комментарий
// Реализует см. инМенеджерСправочника
// Реализует см. Справочники.Шаблон

Соблюдение контрактов можно проверять новой проверкой.

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

Прошу сначала утвердить синтаксис таких описаний, чтобы я мог параллельно решать аналогичную задачу в своем анализаторе кода для конфигуратора https://www.hostedredmine.com/issues/1000518