From 461f44dd14317fcf2fe326d522b0402906ae70f9 Mon Sep 17 00:00:00 2001
From: Alex <alexkorochinskiy@gmail.com>
Date: Mon, 7 Sep 2026 12:48:59 +0300
Subject: [PATCH] docs: fix README - keyboard controls don't work for .AVI

show_avi() (src/main.c) never returns: its streaming loop is while (sz)
but sz is never decremented, so main_start()'s key-poll loop (which runs
after show_*() returns) is never reached for AVI files. PgDn/PgUp/Esc do
work for JPG/PNG/DLS/DXP, which return immediately. Documenting as a known
limitation rather than fixing it.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
---
 README.md | 14 ++++++++++++--
 1 file changed, 12 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 8419c3c..2d8781c 100644
--- a/README.md
+++ b/README.md
@@ -31,12 +31,21 @@
 
 ## Управление
 
+Работает для `.JPG`/`.PNG`/`.DLS`/`.DXP`:
+
 | Клавиша | Действие         |
 |---------|-------------------|
 | PgDn    | Следующий файл    |
 | PgUp    | Предыдущий файл   |
 | Esc     | Выйти             |
 
+> ⚠️ **Для `.AVI` управление не работает.** `show_avi()` (`src/main.c`)
+> запускает потоковую передачу видео в цикле `while (sz)`, где `sz`
+> нигде не уменьшается — функция не возвращает управление, и общий цикл
+> опроса клавиш (в `main_start()`, уже после вызова `show_*()`) для AVI
+> просто не достигается. Воспроизведение AVI зависает без возможности
+> выйти клавиатурой. Известное ограничение исходного кода, не исправлено.
+
 ## Установка
 
 Скопировать `ftview.wmf` в каталог плагинов Wild Commander. Плагин сам
@@ -58,5 +67,6 @@ build.bat
 
 ## Статус
 
-Проверено на реальном железе: просмотр JPG/PNG, воспроизведение DLS/AVI,
-навигация по файлам.
+Проверено на реальном железе: просмотр JPG/PNG, воспроизведение DLS,
+навигация по файлам (PgDn/PgUp/Esc). Известное ограничение — см.
+предупреждение про `.AVI` выше.