Представьте себе операционную систему, в которой критически важный интерфейс шесть лет жил по принципу «кто понял — тот молодец». Нет, это не подпольный стартап, это взрослый серьёзный Linux. Видимо, всерьёз решили проверить, насколько девопсы любят квесты с поиском артефактов в исходниках ядра.

В 2019 году в Linux появился новый файловый mount‑API — аккуратная замена древнему монолитному вызову mount. Вместо одной всёделающей функции ядро получило три: fsopen, fsconfig и fsmount. Логичнее структура, лучше обработка ошибок, возможность выдавать человеку понятные сообщения, а не сакральное «mount failed». Красота, архитектура, современность.

Но был нюанс: официальной документации для этого богатства почти не существовало. Разработчикам, захотевшим использовать новые вызовы, приходилось:

  • лезть в довольно мрачный файл в исходниках ядра;
  • выкапывать нужные письма в рассылке LKML;
  • перелопачивать пачки патчей и внешние статьи, вроде материала на LWN.net.

Черновики man‑страниц разработчик David Howells написал ещё в 2020‑м. Однако мейнтейнеры не хотели включать в пакет man‑pages что‑то потенциально неточным или незавершённым, а довести текст до блеска автор, судя по всему, не успел. В итоге шесть лет подряд код жил, а нормального «мануала» так и не было.

Отдельный слой абсурда добавлял формат документации: классический Groff, которому уже 35 лет. Он настолько не дружит с человеческими глазами, что, кажется, первые главы писал лично Ктулху. Неудивительно, что желающих «просто дописать пару абзацев» не находилось.

В 2024 году у мастера документации Christian Brauner терпение закончилось. С фразой уровня «годы, проведённые в Groff, меня утомили» он завёл отдельный репозиторий с man‑страницами в Markdown:
https://github.com/brauner/man-pages-md

Там появились аккуратные описания нового mount‑API, и наконец‑то разработчики получили понятный, централизованный источник знаний. В октябре 2025‑го эти страницы были интегрированы в официальный пакет man‑pages — так что история с «невидимой» документацией формально завершилась.

Можно предположить, что именно это затянуло переход файловых систем на новый API: Ext4 добралась до него в 2022‑м, CIFS — в 2023‑м, Btrfs — в 2024‑м, а поддержка F2FS всё ещё допиливается. Пока свежие man‑страницы есть в основном в rolling‑дистрибутивах, но дальше они дойдут и до более консервативных систем — в том числе популярных в России серверных дистрибутивов.

Мораль простая и очень по‑русски понятная: сколько ни говори «хороший код сам себя документирует», без нормального описания жить всё равно неудобно. Новый mount‑API у Linux получился действительно мощным и перспективным — и теперь у него, наконец, есть шанс быть не только «для избранных, читающих ядро на ночь», но и для обычных разработчиков, которые хотят просто открыть man‑страницу и… работать.