style: оформление по стандарту, описания классов над конструкторами

Описания классов `ПулСоединенийСБД` и `СоединениеСБД` перенесены из шапки
файла над `ПриСозданииОбъекта`: большая шапка с текстом уместна у модуля, а
у класса описание принадлежит конструктору. Заголовки конструкторов слились
с перенесенным текстом, дублирующая первая строка убрана.

Прочее оформление: области `#Область` в `КонтекстИсполнения`, пустые строки
между объявлениями переменных, `@internal` без обертки BSLLS, параметры
конструктора менеджера без удвоенных первых букв.

Описание параметра `РазмерПулаСоединений` заодно приведено в соответствие с
поведением - ожидание ограничено по времени, - и то же описание обновлено в
`docs/МенеджерСущностей.md`, который его зеркалит.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AGG5hA6ksvzxJcdWASuc35

Author: nixel2007

docs/МенеджерСущностей.md

@@ -8,17 +8,17 @@
 // Параметры:
 //   ТипКоннектора - Тип - Тип класса, реализующего интерфейс Коннектор.
 //   СтрокаСоединения - Строка - Строка соединения к БД, к которой подключается коннектор.
-//   ППараметрыКоннектора - Массив - Массив дополнительных параметров коннектора. Содержимое произвольное.
-//   РРазмерПулаСоединений - Число - Предел одновременно живущих соединений, то есть предел
-//     параллельной работы с БД: когда все заняты, следующий контекст ждет освобождения. Нулевой
-//     размер снимает предел, но постоянно живущих соединений не держит - каждое обращение к БД
-//     открывает свое соединение и закрывает его по завершении.
+//   ПараметрыКоннектора - Массив - Массив дополнительных параметров коннектора. Содержимое произвольное.
+//   РазмерПулаСоединений - Число - Предел параллельной работы с БД: когда все места заняты,
+//     следующий контекст ждет освобождения, но не дольше предела ожидания - иначе получает ошибку.
+//     Нулевой размер снимает предел, но постоянно живущих соединений не держит - каждое обращение
+//     к БД открывает свое соединение и закрывает его по завершении.
 //
 Процедура ПриСозданииОбъекта(
 	Знач ТипКоннектора,
 	Знач СтрокаСоединения = "",
-	Знач ППараметрыКоннектора = Неопределено,
-	Знач РРазмерПулаСоединений = 10
+	Знач ПараметрыКоннектора = Неопределено,
+	Знач РазмерПулаСоединений = 10
 )
 ```
 

src/internal/concurrent/Модули/КонтекстИсполнения.os

@@ -8,19 +8,25 @@
 //   - код, запущенный в потоках в обход "ФоновыеЗадания", между собой не различается;
 //   - "ФоновыеЗадания.Очистить()" очищает список заданий, после чего работающее задание
 //     перестает опознаваться и сливается с кодом вне заданий.
-//
+
 // Строка - Ключ контекста, в котором выполняется код вне фоновых заданий.
 Перем КлючВнеФоновогоЗадания;
+
 // Число - Сколько раз повторяется обращение к списку заданий, сорванное параллельным изменением
 // списка.
 Перем ПределПовторов;
+
 // Число - Пауза между повторами в миллисекундах.
 Перем ПаузаПовтора;
+
 // Действие - Обращение к движку за текущим заданием.
 Перем ОбращениеЗаТекущимЗаданием;
+
 // Действие - Обращение к движку за списком заданий.
 Перем ОбращениеЗаВсемиЗаданиями;
 
+#Область ПрограммныйИнтерфейс
+
 // Возвращает ключ текущего контекста исполнения.
 //
 // Возвращаемое значение:
@@ -67,9 +73,12 @@
 
 КонецФункции
 
-// BSLLS:UsingServiceTag-off
+#КонецОбласти
+
+#Область СлужебныйПрограммныйИнтерфейс
+
 // @internal
-// BSLLS:UsingServiceTag-on
+//
 // Для служебного пользования.
 //
 // Выполняет обращение к списку фоновых заданий, повторяя его при срыве перебора.
@@ -105,48 +114,58 @@
 
 КонецФункции
 
-// Возвращает текущее фоновое задание.
+// Обращается к движку за текущим заданием. Вызывается только через ВыполнитьСПовтором.
 //
 // Возвращаемое значение:
 //   ФоновоеЗадание - Задание, в котором выполняется код.
 //   Неопределено - Код выполняется вне фоновых заданий.
 //
-Функция ТекущееЗадание()
-	Возврат ВыполнитьСПовтором(ОбращениеЗаТекущимЗаданием);
+Функция ПолучитьТекущееЗадание() Экспорт
+	Возврат ФоновыеЗадания.ПолучитьТекущее();
 КонецФункции
 
-// Возвращает список известных менеджеру фоновых заданий.
+// Обращается к движку за списком заданий. Вызывается только через ВыполнитьСПовтором.
 //
 // Возвращаемое значение:
 //   Массив - Фоновые задания.
 //
-Функция ВсеЗадания()
-	Возврат ВыполнитьСПовтором(ОбращениеЗаВсемиЗаданиями);
+Функция ПолучитьВсеЗадания() Экспорт
+	Возврат ФоновыеЗадания.ПолучитьФоновыеЗадания();
 КонецФункции
 
-// Обращается к движку за текущим заданием. Вызывается только через ВыполнитьСПовтором.
+#КонецОбласти
+
+#Область СлужебныеПроцедурыИФункции
+
+// Возвращает текущее фоновое задание.
 //
 // Возвращаемое значение:
 //   ФоновоеЗадание - Задание, в котором выполняется код.
 //   Неопределено - Код выполняется вне фоновых заданий.
 //
-Функция ПолучитьТекущееЗадание() Экспорт
-	Возврат ФоновыеЗадания.ПолучитьТекущее();
+Функция ТекущееЗадание()
+	Возврат ВыполнитьСПовтором(ОбращениеЗаТекущимЗаданием);
 КонецФункции
 
-// Обращается к движку за списком заданий. Вызывается только через ВыполнитьСПовтором.
+// Возвращает список известных менеджеру фоновых заданий.
 //
 // Возвращаемое значение:
 //   Массив - Фоновые задания.
 //
-Функция ПолучитьВсеЗадания() Экспорт
-	Возврат ФоновыеЗадания.ПолучитьФоновыеЗадания();
+Функция ВсеЗадания()
+	Возврат ВыполнитьСПовтором(ОбращениеЗаВсемиЗаданиями);
 КонецФункции
 
+#КонецОбласти
+
+#Область Инициализация
+
 КлючВнеФоновогоЗадания = "*";
 ПределПовторов = 100;
 ПаузаПовтора = 1;
 
 // Обращения строятся один раз: они на пути каждого захвата соединения.
 ОбращениеЗаТекущимЗаданием = Новый Действие(ЭтотОбъект, "ПолучитьТекущееЗадание");
 ОбращениеЗаВсемиЗаданиями = Новый Действие(ЭтотОбъект, "ПолучитьВсеЗадания");
+
+#КонецОбласти

src/internal/Классы/ПулСоединенийСБД.os

@@ -1,26 +1,3 @@
-// Пул соединений с базой данных.
-//
-// Через пул идут все обращения к БД. Соединение выдается контексту исполнения на время операции
-// или транзакции и не разделяется с другими контекстами: у драйверов СУБД соединение не
-// потокобезопасно, и параллельные запросы по одному соединению рвут протокол обмена.
-//
-// Захват реентерабельный. Операция внутри транзакции получает то же соединение, что и сама
-// транзакция, поэтому попадает в нее, а не идет мимо. Соединение возвращается в пул, когда
-// контекст освободил его столько же раз, сколько занимал.
-//
-// Размер пула - это предел одновременно живущих соединений. Когда все заняты, контекст встает в
-// очередь ожидающих, и освобожденное соединение достается тому, кто ждет дольше всех. Нулевой
-// размер снимает предел и отключает постоянно живущие соединения: каждый захват открывает
-// соединение, каждое освобождение его закрывает, ждать при таком размере некого.
-//
-// Ожидание в очереди ограничено по времени: не дождавшийся контекст получает ошибку, а не висит
-// бесконечно. Соединение мог не освободить живой контекст, а у живого пул его не отбирает.
-//
-// Свободные соединения лежат в приоритетной очереди: первым выдается то, которое вернули
-// последним. Так рабочий набор соединений остается малым, а простаивающие стареют.
-//
-// Пул разделяется всеми потоками, поэтому его состояние защищено блокировкой чтения-записи.
-//
 #Использовать "../concurrent"
 
 #Использовать collectionos
@@ -63,7 +40,28 @@
 // Массив - Дополнительные параметры коннекторов пула.
 Перем ПараметрыКоннектора;
 
-// Создает пул с заданным пределом одновременно живущих соединений.
+// Пул соединений с базой данных.
+//
+// Через пул идут все обращения к БД. Соединение выдается контексту исполнения на время операции
+// или транзакции и не разделяется с другими контекстами: у драйверов СУБД соединение не
+// потокобезопасно, и параллельные запросы по одному соединению рвут протокол обмена.
+//
+// Захват реентерабельный. Операция внутри транзакции получает то же соединение, что и сама
+// транзакция, поэтому попадает в нее, а не идет мимо. Соединение возвращается в пул, когда
+// контекст освободил его столько же раз, сколько занимал.
+//
+// Размер пула - это предел параллельной работы с БД. Когда все места заняты, контекст встает в
+// очередь ожидающих, и освобожденное соединение достается тому, кто ждет дольше всех. Нулевой
+// размер снимает предел и отключает постоянно живущие соединения: каждый захват открывает
+// соединение, каждое освобождение его закрывает, ждать при таком размере некого.
+//
+// Ожидание в очереди ограничено по времени: не дождавшийся контекст получает ошибку, а не висит
+// бесконечно. Соединение мог не освободить живой контекст, а у живого пул его не отбирает.
+//
+// Свободные соединения лежат в приоритетной очереди: первым выдается то, которое вернули
+// последним. Так рабочий набор соединений остается малым, а простаивающие стареют.
+//
+// Пул разделяется всеми потоками, поэтому его состояние защищено блокировкой чтения-записи.
 //
 // Параметры:
 //   ПРазмерПула - Число - Предел одновременно живущих соединений. Ноль снимает предел и отключает

src/internal/Классы/СоединениеСБД.os

@@ -1,12 +1,3 @@
-// Соединение с базой данных, выданное из пула соединений.
-//
-// Содержит собственный экземпляр коннектора и состояние транзакции. Соединение выдается одному
-// контексту исполнения и не разделяется: именно поэтому транзакция одного фонового задания не
-// может быть зафиксирована или отменена другим.
-//
-// Создается пулом соединений, напрямую конструировать не следует.
-//
-
 // АбстрактныйКоннектор - Коннектор, которым выполняются операции этого соединения.
 Перем Коннектор;
 // Булево - Признак начатой и еще не завершенной транзакции.
@@ -17,7 +8,14 @@
 // соединение выдать следующим.
 Перем МоментВозврата;
 
-// Открывает соединение с базой данных.
+// Соединение с базой данных, выданное из пула соединений.
+//
+// Содержит собственный экземпляр коннектора и состояние транзакции. Соединение выдается одному
+// контексту исполнения и не разделяется: именно поэтому транзакция одного фонового задания не
+// может быть зафиксирована или отменена другим.
+//
+// Создается пулом соединений, напрямую конструировать не следует. Конструктор открывает
+// соединение с базой данных.
 //
 // Параметры:
 //   ТипКоннектора - Тип - Тип класса, реализующего интерфейс коннектора.