Еще дока

src/internal/Классы/АннотацияДуб.os

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

src/internal/Классы/АннотацияЖелудь.os

@@ -3,8 +3,13 @@
 // Размещается над конструктором класса.
 //
 // Параметры:
-//   Значение - Строка- Имя желудя. По умолчанию будет использовано имя типа объекта,
-//                      как оно возвращается функцией `ТипЗнч`.
+//   Значение - Строка - Имя желудя. По умолчанию будет использовано имя типа объекта,
+//                       как оно возвращается функцией `ТипЗнч`.
+//
+// Пример:
+// &Желудь
+// Процедура ПриСозданииОбъекта()
+// КонецПроцедуры
 //
 &Аннотация("Желудь")
 Процедура ПриСозданииОбъекта(Значение = "")

src/internal/Классы/АннотацияЗавязь.os

@@ -1,3 +1,21 @@
+// Помечает функцию как функцию, создающую желудь.
+//
+// Может иметь параметры, каждый из которых должен быть промаркирован как &Пластилин, &Деталька или &Блестяшка.
+// В указанные параметры автоматически будут прилеплены соответствующие частицы при создании желудя.
+//
+// Размещается над экспортной функцией в классе, проаннотированном как `&Дуб`.
+//
+// Параметры:
+//   Значение - Строка - Имя создаваемого желудя. По умолчанию будет использовано имя метода.
+//   Тип - Строка - Тип создаваемого желудя. 
+//                  Требуется если по имени желудя не получается однозначного определить его тип.
+//
+// Пример:
+// &Завязь
+// Функция ПользовательскийЖелудь(&Пластилин Зависимость, &Деталька ВажнаяНастройка) Экспорт
+// .   Возврат Новый ПользовательскийЖелудь(Зависимость, ВажнаяНастройка);
+// КонецФункции
+//
 &Аннотация("Завязь")
 Процедура ПриСозданииОбъекта(Значение = "", Тип = "")
 

src/internal/Классы/АннотацияОсобоеОбращение.os

@@ -4,6 +4,14 @@
 Перем _ПрименятьТолькоНапильники;
 Перем _НеПрименятьНапильники;
 
+// Проверяет, может ли указанный напильник применяться над желудем, помеченным аннотацией `&ОсобоеОбращение`.
+//
+// Параметры:
+//   ИмяНапильника - Строка - Имя напильника для проверки применимости.
+//
+//  Возвращаемое значение:
+//   Булево - Истина, если напильник может применяться на текущем желуде, иначе Ложь.
+//
 Функция НапильникМожетПрименяться(ИмяНапильника) Экспорт
 
 	Если _ОтключитьВсеНапильники Тогда
@@ -24,6 +32,8 @@
 // применение конкретных напильников или отключение конкретных напильников. Если задано ограничение на применение только
 // конкретных напильников, то нельзя задавать ограничение на отключение конкретных напильников (и наоборот).
 //
+// Размещается над конструктором класса или над методом `&Завязи`.
+//
 // Параметры:
 //   ОтключитьВсеНапильники - Булево - Не применять на желуде никакие напильники.
 //   ПрименятьТолькоНапильник - Строка - Повторяемый параметр. Применять на желуде только напильник с указанным именем.

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

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

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

@@ -3,6 +3,8 @@
 //
 // Может быть использовано, например, для группировки желудей и получении их в виде массива.
 //
+// Размещается над конструктором класса или над методом `&Завязи`.
+//
 // Параметры:
 //   Значение - Строка - Задаваемое прозвище.
 //

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

@@ -21,11 +21,16 @@
 
 // Специальный тип желудя, автоматически выполняемый при запуске приложения (`Поделка.ЗапуститьПриложение()`).
 //
-// Класс, помеченный аннотацией `&Рогатка`, должен реализовать следующий интерфейс:
+// Желудь, помеченный аннотацией `&Рогатка`, должен реализовать следующий интерфейс:
 // * `Процедура ПриЗапускеПриложения() Экспорт`
 //
 // Каждая `&Рогатка` дополнительно имеет `&Прозвище("Рогатка")`.
 //
+// `&Рогатка` сама по себе тоже является желудем, то есть может запрашивать прилепление частиц,
+// является объектом для обработки `&Напильник`ом, может иметь `&Спецификация` и так далее.
+//
+// Размещается над конструктором класса или над методом `&Завязи`.
+//
 // Параметры:
 //   Значение - Строка - Имя желудя, под которым рогатка добавляется в контекст Поделки.
 //   ЗапускатьВФоне - Булево - Если Истина, то рогатка будет запущена в фоновом задании.

src/internal/Классы/АннотацияСпецификация.os

@@ -18,6 +18,8 @@
 //
 // К желудям со специкацией "Инициализация" не применяются напильники.
 //
+// Размещается над конструктором класса или над методом `&Завязи`.
+//
 // Параметры:
 //   Значение - Строка - Состояние приложения, на котором разрешено создавать желудь. См. СостоянияПриложения.
 //