Еще дока

autumn-library · Nov 16, 2024 · b9b4ca4 · b9b4ca4
1 parent a2db9d2
commit b9b4ca4
Show file tree

Hide file tree

Showing 3 changed files with 40 additions and 0 deletions.
diff --git a/src/internal/Классы/АннотацияВерховный.os b/src/internal/Классы/АннотацияВерховный.os
@@ -8,6 +8,19 @@
 //
 // Размещается над определением желудя - конструктором или методом &Завязи.
 //
+// Пример:
+// 1.
+// &Верховный
+// &Желудь("ПереопределяемыйЖелудь")
+// Процедура ПриСозданииОбъекта()
+// КонецПроцедуры
+// .
+// 2.
+// &Верховный
+// &Завязь
+// Функция ПереопределяемыйЖелудь() Экспорт
+// КонецФункции
+//
 &Аннотация("Верховный")
 Процедура ПриСозданииОбъекта()
 

diff --git a/src/internal/Классы/АннотацияОсобоеОбращение.os b/src/internal/Классы/АннотацияОсобоеОбращение.os
@@ -18,6 +18,17 @@
 
 КонецФункции
 
+// Маркерная аннотация, показывающая, что желудь требует изменений в процессе своего создания.
+//
+// Параметры аннотации конфликтуют между собой. Если отключаются все напильники, то нельзя задавать ограничения на
+// применение конкретных напильников или отключение конкретных напильников. Если задано ограничение на применение только
+// конкретных напильников, то нельзя задавать ограничение на отключение конкретных напильников (и наоборот).
+//
+// Параметры:
+//   ОтключитьВсеНапильники - Булево - Не применять на желуде никакие напильники.
+//   ПрименятьТолькоНапильник - Строка - Повторяемый параметр. Применять на желуде только напильник с указанным именем.
+//   НеПрименятьНапильник - Строка - Повторяемый параметр. Не применять на желуде напильник с указанным именем.
+//
 &Аннотация("ОсобоеОбращение")
 Процедура ПриСозданииОбъекта(
 	ОтключитьВсеНапильники = Ложь,

diff --git a/src/internal/Классы/АннотацияПрозвище.os b/src/internal/Классы/АннотацияПрозвище.os
@@ -1,3 +1,19 @@
+// Добавляет к желудю дополнительный идентификатор, по которому его можно в последствии доставать из Поделки.
+// Желудь может иметь несколько прозвищ. Одно и то же прозвище может использоваться для нескольких желудей.
+//
+// Может быть использовано, например, для группировки желудей и получении их в виде массива.
+//
+// Параметры:
+//   Значение - Строка - Задаваемое прозвище.
+//
+// Пример:
+//
+// &Прозвище("ПодписчикНаСобытие")
+// &Прозвище("ПользовательскийЖелудь")
+// &Желудь("МойЖелудь")
+// Процедура ПриСозданииОбъекта()
+// КонецПроцедуры
+//
 &Аннотация("Прозвище")
 Процедура ПриСозданииОбъекта(Значение)