From a2db9d2bbf06718de5a195d4e306b982279a629f Mon Sep 17 00:00:00 2001
From: Nikita Fedkin <nixel2007@gmail.com>
Date: Fri, 15 Nov 2024 17:31:14 +0000
Subject: [PATCH] =?UTF-8?q?=D0=95=D1=89=D0=B5=20=D0=B4=D0=BE=D0=BA=D0=B0?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ...20\270\320\265\320\274\320\272\320\260.os" | 14 +++++++-
 ...20\263\320\260\321\202\320\272\320\260.os" | 32 +++++++++++++++++++
 ...20\250\321\202\321\200\320\270\321\205.os" | 11 +++++++
 3 files changed, 56 insertions(+), 1 deletion(-)

diff --git "a/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\237\321\200\320\270\320\265\320\274\320\272\320\260.os" "b/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\237\321\200\320\270\320\265\320\274\320\272\320\260.os"
index 2167e22..2b8f0c9 100644
--- "a/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\237\321\200\320\270\320\265\320\274\320\272\320\260.os"
+++ "b/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\237\321\200\320\270\320\265\320\274\320\272\320\260.os"
@@ -1,8 +1,10 @@
+// Специальный тип желудя для обработки определений желудей.
+//
 // Аналог &Напильника для `ОпределениеЖелудя`. Срабатывает каждый раз, когда в контекст добавляется новое
 // определение желудя. При добавлении самой Приемки в контекст, все ранее добавленные определения желудей
 // передаются в Приемку для проверки.
 //
-// Класс, помеченный аннотацией `&Приемка` должен реализовать следующий интерфейс:
+// Класс, помеченный аннотацией `&Приемка`, должен реализовать следующий интерфейс:
 // * `Процедура ПриДобавленииОпределенияЖелудя(ОпределениеЖелудя) Экспорт`
 //
 // Каждая `&Приемка` так же имеет `&Характер("Компанейский")`, `&Прозвище("Приемка")` и `&Спецификация("Инициализация")`
@@ -10,6 +12,16 @@
 // Параметры:
 //   Значение - Строка - Имя желудя, под которым приемка добавляется в контекст Поделки.
 //
+// Пример:
+//
+// Процедура ПриДобавленииОпределенияЖелудя(ОпределениеЖелудя) Экспорт
+// .   Сообщить("Определение желудя: " + ОпределениеЖелудя.Имя());
+// КонецПроцедуры
+// .
+// &Приемка
+// Процедура ПриСозданииОбъекта()
+// КонецПроцедуры
+//
 &Аннотация("Приемка")
 &Прозвище("Приемка")
 &Характер("Компанейский")
diff --git "a/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\240\320\276\320\263\320\260\321\202\320\272\320\260.os" "b/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\240\320\276\320\263\320\260\321\202\320\272\320\260.os"
index 7d1d483..1df0970 100644
--- "a/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\240\320\276\320\263\320\260\321\202\320\272\320\260.os"
+++ "b/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\240\320\276\320\263\320\260\321\202\320\272\320\260.os"
@@ -1,14 +1,46 @@
 Перем _ЗапускатьВФоне;
 Перем _ОжидатьЗавершения;
 
+// Флаг необходимости запуска рогатки в фоновом задании.
+//
+//  Возвращаемое значение:
+//   Булево
+//
 Функция ЗапускатьВФоне() Экспорт
 	Возврат _ЗапускатьВФоне;
 КонецФункции
 
+// Флаг необходимости ожидания завершения рогатки при ее запуске в фоновом задании.
+//
+//  Возвращаемое значение:
+//   Булево
+//
 Функция ОжидатьЗавершения() Экспорт
 	Возврат _ОжидатьЗавершения;
 КонецФункции
 
+// Специальный тип желудя, автоматически выполняемый при запуске приложения (`Поделка.ЗапуститьПриложение()`).
+//
+// Класс, помеченный аннотацией `&Рогатка`, должен реализовать следующий интерфейс:
+// * `Процедура ПриЗапускеПриложения() Экспорт`
+//
+// Каждая `&Рогатка` дополнительно имеет `&Прозвище("Рогатка")`.
+//
+// Параметры:
+//   Значение - Строка - Имя желудя, под которым рогатка добавляется в контекст Поделки.
+//   ЗапускатьВФоне - Булево - Если Истина, то рогатка будет запущена в фоновом задании.
+//                             Если Ложь, то рогатка будет запущена в текущем потоке.
+//   ОжидатьЗавершения - Булево - Если Истина и `ЗапускатьВФоне` = Истина,
+//                                то после запуска рогатки будет ожидаться её завершение.
+// Пример:
+// Процедура ПриЗапускеПриложения() Экспорт
+// .   Сообщить("Привет из рогатки!");
+// КонецПроцедуры
+// .
+// &Рогатка
+// Процедура ПриСозданииОбъекта()
+// КонецПроцедуры
+//
 &Аннотация("Рогатка")
 &Прозвище("Рогатка")
 Процедура ПриСозданииОбъекта(Значение = "", ЗапускатьВФоне = Истина, ОжидатьЗавершения = Истина)
diff --git "a/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\244\320\270\320\275\320\260\320\273\321\214\320\275\321\213\320\271\320\250\321\202\321\200\320\270\321\205.os" "b/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\244\320\270\320\275\320\260\320\273\321\214\320\275\321\213\320\271\320\250\321\202\321\200\320\270\321\205.os"
index 8963a3c..cd7afad 100644
--- "a/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\244\320\270\320\275\320\260\320\273\321\214\320\275\321\213\320\271\320\250\321\202\321\200\320\270\321\205.os"
+++ "b/src/internal/\320\232\320\273\320\260\321\201\321\201\321\213/\320\220\320\275\320\275\320\276\321\202\320\260\321\206\320\270\321\217\320\244\320\270\320\275\320\260\320\273\321\214\320\275\321\213\320\271\320\250\321\202\321\200\320\270\321\205.os"
@@ -8,6 +8,17 @@
 //
 // Процедура должна быть помечена `Экспорт`ная.
 //
+// Пример:
+// 
+// &ФинальныйШтрих
+// Процедура ПостИнициализация() Экспорт
+// .   Сообщить("Я выполнилась после конструктора объекта");
+// КонецПроцедуры
+// .
+// &Желудь
+// Процедура ПриСозданииОбъекта()
+// КонецПроцедуры
+//
 &Аннотация("ФинальныйШтрих")
 Процедура ПриСозданииОбъекта()