Clarify memory pool counters and strbuf error documentation

lib/memory_pool.h

@@ -25,9 +25,9 @@ struct memory_pool {
     void* free_head;            // Голова linked list свободных блоков (next хранится в начале каждого блока)
     int free_count;             // Количество свободных блоков
     size_t object_size;         // Размер объектов в пуле (пользовательские данные)
-    size_t allocations;         // Общее количество аллокаций (включая новые malloc)
+    size_t allocations;         // Попытки выделить новый блок, включая неудачные; выдачи из кеша не учитываются
     size_t reuse_count;         // Количество повторных использований из пула
-    uint8_t alloc_tag_counter;  // монотонный счётчик для детекции double-free (1 байт)
+    uint8_t alloc_tag_counter;  // Не используется; init устанавливает 1. Double-free проверяется по метке в хвосте блока
     const char* name;           // Имя пула для диагностики (напр. "data_pool", "pkt_pool")
 };
 

lib/strbuf.h

@@ -37,7 +37,7 @@ char  *strbuf_detach(struct strbuf *sb);
 /* reset len=0, keep allocation */
 void   strbuf_reset(struct strbuf *sb);
 
-/* printf-like append. auto-grows. returns written bytes or -1 on OOM */
+/* printf-добавление с ростом буфера: число байтов без NUL или < 0 при ошибке форматирования/роста. */
 int    strbuf_addf(struct strbuf *sb, const char *fmt, ...)
        __attribute__((format(printf, 2, 3)));