Еще дока

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

@@ -5,9 +5,9 @@
 // или методом установки значения.
 //
 // Параметры:
-//   Значение - Строка - Имя внедряемого желудя. Если не заполнено, используется имя параметра конструктора/поля класса
-//                       или часть имени метода для установки значения.
-//   Тип - Строка - Тип внедряемого желудя. В случае передачи значения "Желудь", будет внедрен желудь как таковой.
+//   Значение - Строка - Имя прилепляемого желудя. Если не заполнено, используется имя параметра конструктора/поля
+//                       класса или часть имени метода для установки значения.
+//   Тип - Строка - Тип прилепляемого желудя. В случае передачи значения "Желудь", будет внедрен желудь как таковой.
 //                  Так же может быть указан тип "Массив", "ТаблицаЗначений" и другие. Полный список доступных типов
 //                  см. в библиотеке [autumn-collections](https://github.com/autumn-library/autumn-collections).
 //   Блестяшка - Произвольный - Повторяемый параметр. Передаваемые в прилепляемый желудь произвольные значения.

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

@@ -3,7 +3,7 @@
 // Порядок, заданный аннотацией.
 //
 //  Возвращаемое значение:
-//   Число - Заданный порядок.
+//   Число
 //
 Функция Значение() Экспорт
 	Возврат _Значение;

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

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

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

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

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

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

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

@@ -1,7 +1,7 @@
 // Процедуры, помеченные аннотацией "ФинальныйШтрих" будут вызваны в конце инициализации желудя,
 // после отработки конструктора/метода завязи и всех напильников, применяемых на желуде.
-// Во время выполнения процедуры доступны все зависимости, внедренняемые как через конструктор, так и через поля класса
-// и методы-сеттеры.
+// Во время выполнения процедуры доступны все прилепляемые частицы, прилепленные как через конструктор,
+// так и через поля класса и методы-сеттеры.
 //
 // Желудь может содержать несколько процедур, помеченных аннотацией "ФинальныйШтрих".
 // Порядок их вызова не гарантируется.

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

@@ -15,8 +15,10 @@
 //   Значение - Строка - Характер желудя.
 //
 // Пример:
-//  1. &Характер("Одиночка")
-//  2. &Характер("Компанейский")
+//  &Характер("Компанейский")
+//  &Желудь
+//  Процедура ПриСозданииОбъекта()
+//  КонецПроцедуры
 //
 &Аннотация("Характер")
 Процедура ПриСозданииОбъекта(Значение)

src/internal/Классы/ПрилепляторЧастиц.os

@@ -89,7 +89,7 @@
 		ИначеЕсли УправляющийПрилепляемымиКоллекциями.ЕстьПрилепляемаяКоллекция(ТипЖелудя) Тогда
 			ПрилепляемаяЧастица = Поделка.НайтиЖелуди(ИмяЧастицы, ПрилепляемыеЧастицы, ТипЖелудя);
 		Иначе
-			ВызватьИсключение "Неизвестный тип внедряемого через &Пластилин значения";
+			ВызватьИсключение "Неизвестный тип прилепляемого через &Пластилин значения";
 		КонецЕсли;
 
 	ИначеЕсли ТипЧастицы = ТипыПрилепляемыхЧастиц.Деталька() Тогда

src/internal/Модули/СостоянияПриложения.os → src/Модули/СостоянияПриложения.os

@@ -1,20 +1,20 @@
-Перем Значения;
-
-Функция Инициализация() Экспорт
-	Возврат "Инициализация";
-КонецФункции
-
-Функция Выполнение() Экспорт
-	Возврат "Выполнение";
-КонецФункции
-
-Функция Значения() Экспорт
-	Возврат Значения;
-КонецФункции
-
-Значения = Новый Массив;
-
-Значения.Добавить(Инициализация());
-Значения.Добавить(Выполнение());
-
-Значения = Новый ФиксированныйМассив(Значения);
+Перем Значения;
+
+Функция Инициализация() Экспорт
+	Возврат "Инициализация";
+КонецФункции
+
+Функция Выполнение() Экспорт
+	Возврат "Выполнение";
+КонецФункции
+
+Функция Значения() Экспорт
+	Возврат Значения;
+КонецФункции
+
+Значения = Новый Массив;
+
+Значения.Добавить(Инициализация());
+Значения.Добавить(Выполнение());
+
+Значения = Новый ФиксированныйМассив(Значения);