Еще дока

src/internal/Классы/АннотацияПриемка.os

@@ -1,15 +1,27 @@
+// Специальный тип желудя для обработки определений желудей.
+//
 // Аналог &Напильника для `ОпределениеЖелудя`. Срабатывает каждый раз, когда в контекст добавляется новое
 // определение желудя. При добавлении самой Приемки в контекст, все ранее добавленные определения желудей
 // передаются в Приемку для проверки.
 //
-// Класс, помеченный аннотацией `&Приемка` должен реализовать следующий интерфейс:
+// Класс, помеченный аннотацией `&Приемка`, должен реализовать следующий интерфейс:
 // * `Процедура ПриДобавленииОпределенияЖелудя(ОпределениеЖелудя) Экспорт`
 //
 // Каждая `&Приемка` так же имеет `&Характер("Компанейский")`, `&Прозвище("Приемка")` и `&Спецификация("Инициализация")`
 //
 // Параметры:
 //   Значение - Строка - Имя желудя, под которым приемка добавляется в контекст Поделки.
 //
+// Пример:
+//
+// Процедура ПриДобавленииОпределенияЖелудя(ОпределениеЖелудя) Экспорт
+// .   Сообщить("Определение желудя: " + ОпределениеЖелудя.Имя());
+// КонецПроцедуры
+// .
+// &Приемка
+// Процедура ПриСозданииОбъекта()
+// КонецПроцедуры
+//
 &Аннотация("Приемка")
 &Прозвище("Приемка")
 &Характер("Компанейский")

src/internal/Классы/АннотацияРогатка.os

@@ -1,14 +1,46 @@
 Перем _ЗапускатьВФоне;
 Перем _ОжидатьЗавершения;
 
+// Флаг необходимости запуска рогатки в фоновом задании.
+//
+//  Возвращаемое значение:
+//   Булево
+//
 Функция ЗапускатьВФоне() Экспорт
 	Возврат _ЗапускатьВФоне;
 КонецФункции
 
+// Флаг необходимости ожидания завершения рогатки при ее запуске в фоновом задании.
+//
+//  Возвращаемое значение:
+//   Булево
+//
 Функция ОжидатьЗавершения() Экспорт
 	Возврат _ОжидатьЗавершения;
 КонецФункции
 
+// Специальный тип желудя, автоматически выполняемый при запуске приложения (`Поделка.ЗапуститьПриложение()`).
+//
+// Класс, помеченный аннотацией `&Рогатка`, должен реализовать следующий интерфейс:
+// * `Процедура ПриЗапускеПриложения() Экспорт`
+//
+// Каждая `&Рогатка` дополнительно имеет `&Прозвище("Рогатка")`.
+//
+// Параметры:
+//   Значение - Строка - Имя желудя, под которым рогатка добавляется в контекст Поделки.
+//   ЗапускатьВФоне - Булево - Если Истина, то рогатка будет запущена в фоновом задании.
+//                             Если Ложь, то рогатка будет запущена в текущем потоке.
+//   ОжидатьЗавершения - Булево - Если Истина и `ЗапускатьВФоне` = Истина,
+//                                то после запуска рогатки будет ожидаться её завершение.
+// Пример:
+// Процедура ПриЗапускеПриложения() Экспорт
+// .   Сообщить("Привет из рогатки!");
+// КонецПроцедуры
+// .
+// &Рогатка
+// Процедура ПриСозданииОбъекта()
+// КонецПроцедуры
+//
 &Аннотация("Рогатка")
 &Прозвище("Рогатка")
 Процедура ПриСозданииОбъекта(Значение = "", ЗапускатьВФоне = Истина, ОжидатьЗавершения = Истина)

src/internal/Классы/АннотацияФинальныйШтрих.os

@@ -8,6 +8,17 @@
 //
 // Процедура должна быть помечена `Экспорт`ная.
 //
+// Пример:
+// 
+// &ФинальныйШтрих
+// Процедура ПостИнициализация() Экспорт
+// .   Сообщить("Я выполнилась после конструктора объекта");
+// КонецПроцедуры
+// .
+// &Желудь
+// Процедура ПриСозданииОбъекта()
+// КонецПроцедуры
+//
 &Аннотация("ФинальныйШтрих")
 Процедура ПриСозданииОбъекта()