[preface]
== Об этом документе

Перед вами полное справочное руководство к *bootchain + altboot*.
Исходные материалы данного руководства в формате
link:https://docs.asciidoctor.org/asciidoc/latest/[asciidoc]
доступны в подкаталоге проекта
link:https://github.com/klark973/make-initrd-bootchain/tree/sisyphus/bootchain-doc[bootchain-doc].
Для сборки PDF из исходников запустите скрипт `build-pdf.sh`, который
находится в корне проекта. Краткое руководство опубликовано на ВиКи:
https://www.altlinux.org/Installer/common/altboot.

NOTE: На момент написания (версия *0.1.6-alt1*) весь проект представляет
собой 13 пакетов noarch, один SRPM, более 175 исходных файлов на bash и
make или более 9600 строк кода, включая README в подпакетах, но исключая
данное руководство. Суммарный объём всей документации: ещё более 3000 строк.

=== История изменений

`4.4 / 27.10.2026`:: Актуализировано до версии *0.1.6-alt1*: раздел по
_<<_диагностика,диагностике и отладке>>_ расширен и перенесён в конец
пользовательской части справочника, добавлено описание модуля и параметра
_<<_проверка_дистрибутивного_носителя,mediacheck>>_, расширены разделы
_<<_интерактивный_режим_работы>>_, _<<_постоянное_хранилище_сеансов_livecd>>_,
подразделы с описаниями «шагов» _<<_fg>>_, _<<_localdev>>_, _<<_liveboot>>_
и многие другие, внесены множественные изменения в связи с переименованием
агрумента «шага» liveboot (squash), исправлены ошибки и добавлены уточнения,
в частности, по работе параметров console, curlopts, stagename (squash),
флагов forensic, lowmem, live, live_rw и rescue, добавлен подраздел
с описанием библиотеки _<<_localdev_sh_functions,localdev-sh-functions>>_,
добавлены новые переменные и функции в описания других библиотек, добавлены
или заменены некоторые скриншоты, введён новый принцип заполнения истории
изменений.

`4.3 / 18.05.2025`:: Актуализировано до версии *0.1.5-alt30*: агрумент
fuid больше не используется внутренне в altboot, добавлен и документирован
аргумент squash.

`4.2 / 13.12.2024`:: Актуализировано до версии *0.1.5-alt27*:
_<<_propagator_init_bottom_bootchain_altboot,добавлен>>_ параметр live,
_<<_аргументы_параметра_automatic,добавлен>>_ аргумент reserve и
_<<_модуль_make_initrd_bootchain_core,добавлен>>_ параметр конфигурации
BC_TMPFS_SIZE.

`4.1 / 16.09.2024`:: _<<_постоянное_хранилище_сеансов_livecd,Добавлена>>_
ссылка на баг link:https://bugzilla.altlinux.org/51479[ALT #51479].

`4.0 / 01.09.2024`:: Четвёртая редакция в формате asciidoc. Выполнена
финальная вёрстка и синхронизация с кратким руководством на ВиКи, расставлены
перекрёстные ссылки, добавлены описания шагов ping и wait-resume, добавлена
история изменений.

`3.1 / 11.08.2024`:: Третья редакция в формате asciidoc без изменений по
тексту, но с учётом правок от Антона Мидюкова <antohami@altlinux.org> к
редакции 2.0.

`2.1 / 08.08.2024`:: Вторая редакция в формате asciidoc. Выполнено
конвертирование документа редакции 2.0 из ODT в формат asciidoc без
изменений по тексту, добавлены стилевые файлы, документация перенесена
в дерево проекта.

`3.0 / 28.07.2024`:: Третья редакция в формате ODT (revision 186) от
Антона Мидюкова <antohami@altlinux.org>.

`2.0 / 22.07.2024`:: Вторая редакция в формате ODT (revision 183), в
которой выполнена актуализация документации до версии make-initrd-bootchain
*0.1.5-alt23*.

`1.0 / 02.07.2021`:: Первоначальная редакция в формате ODT (revision 141),
созданная сразу после публикации в репозитории make-initrd-bootchain
*0.1.0-alt1*.

