И еще

autumn-library · Nov 18, 2024 · 7a44094 · 7a44094
1 parent 8bdf122
commit 7a44094
Show file tree

Hide file tree

Showing 3 changed files with 31 additions and 2 deletions.
diff --git a/src/internal/Классы/АннотацияНапильник.os b/src/internal/Классы/АннотацияНапильник.os
@@ -3,6 +3,15 @@
 
 Перем _ПрименяетсяТолькоНа;
 
+// Проверить, может ли текущий напильник применяться на указанном желуде.
+//
+// Параметры:
+//   ОпределениеЖелудя - ОпределениеЖелудя - Определение желудя, для которого проверяется
+//                                           применимость текущего напильника.
+//
+//  Возвращаемое значение:
+//   Булево - Истина, если напильник может применяться на указанном желуде, иначе Ложь.
+//
 Функция МожетПрименятьсяНа(ОпределениеЖелудя) Экспорт
 
 	НапильникМожетПрименяться = Ложь;
@@ -24,6 +33,26 @@
 
 КонецФункции
 
+// Специальный тип желудя для дополнительной обработки других желудей в процессе их создания.
+//
+// Может использоваться для добавления дополнительных действий или свойств создаваемым желудям. Метод `ОбработатьЖелудь`
+// **может** возвращать другой объект, который подменит текущий желудь, или обертку-декоратор над текущим желудем.
+//
+// Каждый `&Напильник` дополнительно имеет `&Прозвище("Напильник")`.
+//
+// Напильник сам по себе является желудем, однако в силу своей специфики он может запрашивать прилепление только
+// &Деталек и Поделки.
+//
+// Желудь, помеченный аннотацией `&Напильник`, должен реализовать следующий интерфейс:
+// * `Функция ОбработатьЖелудь(Желудь, ОпределениеЖелудя) Экспорт`
+//
+// Размещается над конструктором класса.
+//
+// Параметры:
+//   Значение - Строка - Имя желудя, под которым напильник добавляется в контекст Поделки.
+//   ПрименяетсяТолькоНа - Строка - Повторяемый параметр. Ограничивает применение напильника только на желудях
+//                                  с указанными именами.
+//
 &Аннотация("Напильник")
 &Прозвище("Напильник")
 Процедура ПриСозданииОбъекта(Значение = "", &Повторяемый ПрименяетсяТолькоНа = Неопределено)

diff --git a/src/internal/Классы/АннотацияПриемка.os b/src/internal/Классы/АннотацияПриемка.os
@@ -9,7 +9,7 @@
 //
 // Каждая `&Приемка` так же имеет `&Характер("Компанейский")`, `&Прозвище("Приемка")` и `&Спецификация("Инициализация")`
 //
-// Размещается над конструктором класса или над методом `&Завязи`.
+// Размещается над конструктором класса.
 //
 // Параметры:
 //   Значение - Строка - Имя желудя, под которым приемка добавляется в контекст Поделки.

diff --git a/src/internal/Классы/АннотацияРогатка.os b/src/internal/Классы/АннотацияРогатка.os
@@ -29,7 +29,7 @@
 // `&Рогатка` сама по себе тоже является желудем, то есть может запрашивать прилепление частиц,
 // является объектом для обработки `&Напильник`ом, может иметь `&Спецификация` и так далее.
 //
-// Размещается над конструктором класса или над методом `&Завязи`.
+// Размещается над конструктором класса.
 //
 // Параметры:
 //   Значение - Строка - Имя желудя, под которым рогатка добавляется в контекст Поделки.