From ebe5006a1b9b53718261d0bd8d2796ef680e1086 Mon Sep 17 00:00:00 2001 From: Nikita Fedkin Date: Tue, 19 Nov 2024 20:04:11 +0100 Subject: [PATCH] Apply code review suggestions --- ...\265\321\201\321\202\321\217\321\210\320\272\320\260.os" | 2 +- ...\200\321\205\320\276\320\262\320\275\321\213\320\271.os" | 2 +- ...\260\321\206\320\270\321\217\320\224\321\203\320\261.os" | 3 ++- ...\217\320\227\320\260\320\262\321\217\320\267\321\214.os" | 3 ++- ...\260\321\201\321\202\320\270\320\273\320\270\320\275.os" | 5 +++-- ...\204\320\270\320\272\320\260\321\206\320\270\321\217.os" | 6 ++---- ...\261\320\260\320\272\320\265\321\200\320\272\320\260.os" | 2 +- 7 files changed, 12 insertions(+), 11 deletions(-) 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\221\320\273\320\265\321\201\321\202\321\217\321\210\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\221\320\273\320\265\321\201\321\202\321\217\321\210\320\272\320\260.os" index d902e86..986ef69 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\221\320\273\320\265\321\201\321\202\321\217\321\210\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\221\320\273\320\265\321\201\321\202\321\217\321\210\320\272\320\260.os" @@ -1,5 +1,5 @@ // Маркерная аннотация для указания, что прилепляемая частица -// является произвольным значением, передавамым кодом. +// является произвольным значением, передаваемым в конструктор желудя. // // Может быть использована только над параметром конструктора/метода завязи желудя. // 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\222\320\265\321\200\321\205\320\276\320\262\320\275\321\213\320\271.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\222\320\265\321\200\321\205\320\276\320\262\320\275\321\213\320\271.os" index 28ed147..d5e62d7 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\222\320\265\321\200\321\205\320\276\320\262\320\275\321\213\320\271.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\222\320\265\321\200\321\205\320\276\320\262\320\275\321\213\320\271.os" @@ -2,7 +2,7 @@ // В случае конфликта имен при получении желудей или их регистрации, будет использован желудь с аннотацией `&Верховный`. // // При наличии нескольких желудей с одним и тем же прозвищем позволяет определить, какой из них следует возвращать -// при поиске единственного желудя по его прозвищу. +// при поиске конкретного желудя по его прозвищу. // // Если несколько желудей с одним и тем же именем/прозвищем имеют аннотацию `&Верховный`, будет вызвано исключение. // 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\224\321\203\320\261.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\224\321\203\320\261.os" index e242400..6ae61eb 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\224\321\203\320\261.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\224\321\203\320\261.os" @@ -2,7 +2,8 @@ // `&Дуб` сам по себе тоже является желудем, то есть может запрашивать прилепление частиц, // является объектом для обработки `&Напильник`ом, может иметь `&Спецификация` и так далее. // -// Дуб содержит методы, помеченные аннотацией `&Завязь`, которые возвращают желуди. +// Дуб обычно содержит методы, помеченные аннотацией `&Завязь`, которые возвращают желуди, но +// может содержать и другие методы, не связанные непосредственно с созданием желудей. // // Размещается над конструктором класса. // 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\227\320\260\320\262\321\217\320\267\321\214.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\227\320\260\320\262\321\217\320\267\321\214.os" index d7b0ac4..53eb4df 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\227\320\260\320\262\321\217\320\267\321\214.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\227\320\260\320\262\321\217\320\267\321\214.os" @@ -3,7 +3,8 @@ // Может иметь параметры, каждый из которых должен быть промаркирован как &Пластилин, &Деталька или &Блестяшка. // В указанные параметры автоматически будут прилеплены соответствующие частицы при создании желудя. // -// Размещается над экспортной функцией в классе, проаннотированном как `&Дуб`. +// Может размещаться над экспортной функцией в классе, проаннотированном как `&Дуб`, или над методом-лямбдой, +// передаваемой в качестве параметра в `Поделка.ДобавитьЗавязь()`. // // Параметры: // Значение - Строка - Имя создаваемого желудя. По умолчанию будет использовано имя метода. 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\320\273\320\260\321\201\321\202\320\270\320\273\320\270\320\275.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\320\273\320\260\321\201\321\202\320\270\320\273\320\270\320\275.os" index bb7254c..360a41a 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\320\273\320\260\321\201\321\202\320\270\320\273\320\270\320\275.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\320\273\320\260\321\201\321\202\320\270\320\273\320\270\320\275.os" @@ -8,8 +8,9 @@ // Значение - Строка - Имя прилепляемого желудя. Если не заполнено, используется имя параметра конструктора/поля // класса или часть имени метода для установки значения. // Тип - Строка - Тип прилепляемого желудя. В случае передачи значения "Желудь", будет внедрен желудь как таковой. -// Так же может быть указан тип "Массив", "ТаблицаЗначений" и другие. Полный список доступных типов -// см. в библиотеке [autumn-collections](https://github.com/autumn-library/autumn-collections). +// Так же может быть указан тип-коллекция: "Массив", "ТаблицаЗначений" и другие. Полный список +// доступных типов см. в библиотеке +// [autumn-collections](https://github.com/autumn-library/autumn-collections). // Блестяшка - Произвольный - Повторяемый параметр. Передаваемые в прилепляемый желудь произвольные значения. // // Пример: 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\241\320\277\320\265\321\206\320\270\321\204\320\270\320\272\320\260\321\206\320\270\321\217.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\241\320\277\320\265\321\206\320\270\321\204\320\270\320\272\320\260\321\206\320\270\321\217.os" index a58e769..1b8da2f 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\241\320\277\320\265\321\206\320\270\321\204\320\270\320\272\320\260\321\206\320\270\321\217.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\241\320\277\320\265\321\206\320\270\321\204\320\270\320\272\320\260\321\206\320\270\321\217.os" @@ -9,14 +9,12 @@ Возврат _Значение; КонецФункции -// `@unstable` -// -// Аннотация для указания жизненого цикла приложения, начиная с которого разрешено создавать желудь. +// Аннотация для указания жизненного цикла приложения, начиная с которого разрешено создавать желудь. // // По умолчанию все желуди имеют спецификацию "Выполнение", означающую, что желудь может быть создан только после вызова // `Поделка.ЗапуститьПриложение()`. // -// К желудям со специкацией "Инициализация" не применяются напильники. +// К желудям со спецификацией "Инициализация" не применяются напильники. // // Размещается над конструктором класса или над методом `&Завязи`. // 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\242\320\260\320\261\320\260\320\272\320\265\321\200\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\242\320\260\320\261\320\260\320\272\320\265\321\200\320\272\320\260.os" index c5e9bfc..aa08c8a 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\242\320\260\320\261\320\260\320\272\320\265\321\200\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\242\320\260\320\261\320\260\320\272\320\265\321\200\320\272\320\260.os" @@ -1,5 +1,5 @@ // Пометка, что прилепляемая частица прилепляется не непосредственно, а через специальный объект -// типа `Табакерка`, который позволяет получить частицу программно. +// типа `Табакерка`, который позволяет получить частицу программно и отложенно. // // Может использоваться для внедрения компанейских желудей, внедрения желудя самого в себя, // для разрыва циклических зависимостей, для передачи дополнительных параметров прилепляемого желудя и т.п.